Skip to main content

組織の更新

指定された組織の名前などの基本情報を更新します。

前提条件

Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey を取得しており、その ID にこの操作を呼び出すために必要な RAM 権限が付与されていること。AccessKey をハードコーディングするのではなく、環境変数 ALIBABA_CLOUD_ACCESS_KEY_ID および ALIBABA_CLOUD_ACCESS_KEY_SECRET として設定することを推奨します。

リクエストの説明

  • HTTP メソッド:POST
  • リクエスト URL

    リージョン

    エンドポイント

    シンガポール

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

  • 認証 この操作は、AccessKey ベースの署名(ACS3-HMAC-SHA256 アルゴリズム)を使用する Alibaba Cloud OpenAPI 操作です。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 を含める必要があります。 署名を自分で計算する必要がないよう、Alibaba Cloud SDK または OpenAPI Explorer を使用してこの操作を呼び出すことを推奨します。

リクエストパラメーター

すべてのパラメーターはクエリ文字列で渡されます。

パラメーター

タイプ

必須

説明

Name

string

いいえ

組織名です。

Description

string

いいえ

組織の説明です。

レスポンスパラメーター

パラメーター

タイプ

説明

Success

boolean

API呼び出しが成功したかどうか:
true:成功
false:失敗

Code

string

レスポンスステータスコード。

Message

string

レスポンスメッセージ。

Data

object

ビジネスデータ。

OrgId

string

組織IDです。

NamespaceId

string

プロダクト名前空間IDです。

Name

string

組織名です。

Description

string

組織の説明です。

Status

string

ステータス
ACTIVE
FROZEN

OwnerId

string

組織オーナーのUACアカウントIDです。

OwnerBizAccountId

string

組織オーナーのビジネスアカウント識別子(ALIYUNタイプ:aliyunUid、SSOタイプ:userIdentifier)です。

GmtCreate

string

作成時刻です。

GmtModified

string

更新時刻です。

HttpStatusCode

integer

HTTP ステータスコード。

RequestId

string

一意のリクエスト ID。

リクエスト例

この操作では Alibaba Cloud OpenAPI の署名を使用します。以下の例では、${SIGNATURE} を ACS3-HMAC-SHA256 アルゴリズムで計算する必要があり、x-acs-date および x-acs-signature-nonce を実際の値に置き換える必要があります。
curl -X POST "https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/organization?Name=New%20organization%20name&Description=New%20organization%20description" \
    --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: ${SIGNATURE_NONCE}" \
    --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"
  }
}

エラーコード

呼び出しに失敗した場合、エラーメッセージが返されます。その他のエラーコードと解決策については、エラーコードを参照してください。