Mettre à jour les informations de base telles que le nom d'une organisation spécifiée.
Prérequis
Vous avez obtenu l'AccessKey d'un compte Alibaba Cloud ou d'un utilisateur RAM, et l'identité s'est vu accorder les autorisations RAM nécessaires pour appeler cette opération. Nous vous recommandons de définir l'AccessKey comme variables d'environnement ALIBABA_CLOUD_ACCESS_KEY_ID et ALIBABA_CLOUD_ACCESS_KEY_SECRET plutôt que de le coder en dur.
Description de la requête
-
Méthode HTTP : POST
-
URL de la requête
Région
Point de terminaison
Singapour
POST https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/organization -
Authentification
Cette opération est une opération OpenAPI Alibaba Cloud qui utilise des signatures basées sur AccessKey (l'algorithme
ACS3-HMAC-SHA256). Le schémaAuthorization: Bearer {API_KEY}n'est pas pris en charge. Une requête doit comporter les en-têtes communsx-acs-action: UpdateOrganization,x-acs-version: 2026-02-10,x-acs-date,x-acs-content-sha256,x-acs-signature-nonceetAuthorization.Nous vous recommandons d'appeler cette opération avec un SDK Alibaba Cloud ou OpenAPI Explorer afin de ne pas avoir à calculer la signature vous-même.
Paramètres de la requête
Tous les paramètres sont transmis dans la chaîne de requête.
Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
Name | string | Non | Nom de l'organisation. |
Description | string | Non | Description de l'organisation. |
Paramètres de réponse
Paramètre | Type | Description |
|---|---|---|
Success | boolean | Indique si l'appel API a réussi : |
Code | string | Code d'état de la réponse. |
Message | string | Message de réponse. |
Data | object | Données métier. |
OrgId | string | ID de l'organisation. |
NamespaceId | string | ID de l'espace de noms du produit. |
Name | string | Nom de l'organisation. |
Description | string | Description de l'organisation. |
Status | string | Statut |
OwnerId | string | ID du compte UAC du propriétaire de l'organisation. |
OwnerBizAccountId | string | Identifiant du compte professionnel du propriétaire de l'organisation (type ALIYUN : aliyunUid, type SSO : userIdentifier). |
GmtCreate | string | Heure de création. |
GmtModified | string | Heure de modification. |
HttpStatusCode | integer | Code d'état HTTP. |
RequestId | string | ID unique de la requête. |
Exemple de requête
Cette opération utilise les signatures OpenAPI d'Alibaba Cloud. Dans l'exemple suivant, ${SIGNATURE} doit être calculé avec l'algorithme ACS3-HMAC-SHA256, et x-acs-date ainsi que x-acs-signature-nonce doivent être remplacés par des valeurs réelles.
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}"
Exemple de réponse
{
"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"
}
}
Codes d'erreur
Si l'appel échoue, un message d'erreur est renvoyé. Pour plus de codes d'erreur et de solutions, consultez Codes d'erreur.