Skip to main content

取得帳號詳情

取得 TokenPlan 帳號詳情及組織資訊

前提條件

已取得阿里雲帳號或 RAM 使用者的 AccessKey，並已為其授予呼叫此 API 所需的 RAM 權限。建議將 AccessKey 設定為環境變數 ALIBABA_CLOUD_ACCESS_KEY_ID 和 ALIBABA_CLOUD_ACCESS_KEY_SECRET，避免以明文寫入程式碼。

請求說明

  • HTTP 方法：GET
  • 請求地址

    地域

    Endpoint

    新加坡

    GET https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/account

  • 驗證方式 此 API 為阿里雲 OpenAPI，採用 AccessKey 簽名（簽名演算法 ACS3-HMAC-SHA256），不支援 Authorization: Bearer {API_KEY} 方式。請求需攜帶公用請求標頭 x-acs-action: GetTokenPlanAccountDetail、x-acs-version: 2026-02-10、x-acs-date、x-acs-content-sha256、x-acs-signature-nonce 以及 Authorization。 建議使用阿里雲 SDK 或 OpenAPI Explorer 發起呼叫，可免去自行計算簽名。
在登入狀態下，取得 TokenPlan 管理平台的帳號資訊

請求參數

此介面無請求參數。

返回參數

參數

類型

描述

Success

boolean

呼叫介面是否成功：
true：成功
false：失敗

Code

string

回應狀態碼。

Message

string

回應訊息。

Data

object

業務資料

AccountId

string

帳號 ID

AccountType

string

帳號類型：
ALIYUN
SSO
SA

IsDeleted

boolean

帳號全域狀態：0=正常，1=已凍結

Name

string

帳號顯示名稱

AliyunUid

string

阿里雲 UID（ALIYUN 類型帳號）

Email

string

電子郵件（SSO 類型帳號）

CreatedAt

string

建立時間

OrgMemberships

Array[Object]

組織成員關係清單（樹狀結構，組織 → 工作空間）

Array[Object]

OrgId

string

組織 ID

MemberStatus

string

組織成員狀態
ACTIVE
INITIAL
FROZEN

RoleId

string

組織角色 ID

RoleCode

string

組織角色編碼
ORG_OWNER
ORG_ADMIN
ORG_MEMBER

Workspaces

Array[Object]

該組織下帳號已加入的工作空間清單

object

工作空間清單。

WorkspaceId

string

工作空間 ID

MemberStatus

string

成員狀態
ACTIVE
FROZEN

RoleId

string

工作空間角色 ID

RoleCode

string

工作空間角色編碼
WS_ADMIN
WS_MEMBER

HttpStatusCode

integer

HTTP 狀態碼

RequestId

string

請求唯一識別碼

請求範例

本介面使用阿里雲 OpenAPI 簽章，下例中 ${SIGNATURE} 需按 ACS3-HMAC-SHA256 演算法計算得出，x-acs-date、x-acs-signature-nonce 需替換為實際值。 
curl -X GET "https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/account" \
    --header "x-acs-action: GetTokenPlanAccountDetail" \
    --header "x-acs-version: 2026-02-10" \
    --header "x-acs-date: 2026-01-01T12:00:00Z" \
    --header "x-acs-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" \
    --header "x-acs-signature-nonce: 3e3b2a9f0c7d4f8e9a1b2c3d4e5f6a7b" \
    --header "Authorization: ACS3-HMAC-SHA256 Credential=${ALIBABA_CLOUD_ACCESS_KEY_ID},SignedHeaders=host;x-acs-action;x-acs-content-sha256;x-acs-date;x-acs-signature-nonce;x-acs-version,Signature=${SIGNATURE}"

返回範例 

{
  "Success": true,
  "Data": {
    "AccountId": "acc_123456789",
    "AccountType": "ALIYUN",
    "IsDeleted": true,
    "Name": "test_name",
    "AliyunUid": "1122334455",
    "Email": "test@email.com",
    "CreatedAt": "Thu May 28 14:33:52 CST 2026",
    "OrgMemberships": [
      {
        "OrgId": "org_123456789",
        "MemberStatus": "ENABLE",
        "RoleId": "SYSTEM_ROLE_ORG_OWNER",
        "RoleCode": "ORG_MEMBER",
        "Workspaces": [
          {
            "WorkspaceId": "ws_123456789",
            "MemberStatus": "ACTIVE",
            "RoleId": "SYSTEM_ROLE_WS_ADMIN",
            "RoleCode": "WS_ADMIN"
          }
        ]
      }
    ]
  }
}

錯誤碼

如果呼叫失敗，會返回錯誤訊息。更多錯誤碼及解決方法，請參閱錯誤訊息。