Skip to main content

修改組織資訊

修改指定組織的名稱等基本資訊。

前提條件

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

請求說明

  • HTTP 方法：POST
  • 請求地址

    地域

    Endpoint

    新加坡

    POST https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/organization

  • 驗證方式 此 API 為阿里雲 OpenAPI，採用 AccessKey 簽名（簽名演算法 ACS3-HMAC-SHA256），不支援 Authorization: Bearer {API_KEY} 方式。請求需攜帶公用請求標頭 x-acs-action: UpdateOrganization、x-acs-version: 2026-02-10、x-acs-date、x-acs-content-sha256、x-acs-signature-nonce 以及 Authorization。 建議使用阿里雲 SDK 或 OpenAPI Explorer 發起呼叫，可免去自行計算簽名。

請求參數

所有參數均透過 Query String 傳遞。

參數

類型

必選

描述

Name

string

否

組織名稱

Description

string

否

組織描述

返回參數

參數

類型

描述

Success

boolean

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

Code

string

回應狀態碼。

Message

string

回應訊息。

Data

object

業務資料

OrgId

string

組織 ID

NamespaceId

string

產品命名空間 ID

Name

string

組織名稱

Description

string

組織描述

Status

string

狀態
ACTIVE
FROZEN

OwnerId

string

組織 Owner 的 UAC 帳號 ID

OwnerBizAccountId

string

組織 Owner 的業務帳號識別碼（ALIYUN 類型為 aliyunUid，SSO 類型為 userIdentifier）

GmtCreate

string

建立時間

GmtModified

string

修改時間

HttpStatusCode

integer

HTTP 狀態碼

RequestId

string

請求唯一識別碼

請求範例

此 API 使用阿里雲 OpenAPI 簽名，下列範例中的 ${SIGNATURE} 需按 ACS3-HMAC-SHA256 演算法計算得出，x-acs-date、x-acs-signature-nonce 需替換為實際值。範例 URL 中的中文取值為便於閱讀未做編碼；實際計算簽名時，規範化請求（CanonicalRequest）的 Query String 需按 RFC 3986 對鍵和取值進行百分比編碼，否則會返回 SignatureDoesNotMatch。使用阿里雲 SDK 時會自動處理。 
curl -X POST "https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/organization?Name=新的组织名称&Description=新的组织描述" \
    --header "x-acs-action: UpdateOrganization" \
    --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": {
    "OrgId": "org_123456789",
    "NamespaceId": "namespace-1",
    "Name": "组织名称",
    "Description": "组织描述",
    "Status": "ACTIVE",
    "OwnerId": "acc_123456789",
    "OwnerBizAccountId": "1269388320468566",
    "GmtCreate": "2025-12-11T02:19:27Z",
    "GmtModified": "2025-07-08 13:59:11"
  }
}

錯誤碼

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