Actualizar información básica, como el nombre de una organización específica.
Requisitos previos
Ha obtenido la AccessKey de una cuenta de Alibaba Cloud o de un usuario RAM, y a la identidad se le han otorgado los permisos RAM necesarios para invocar esta operación. Le recomendamos que configure la AccessKey como las variables de entorno ALIBABA_CLOUD_ACCESS_KEY_ID y ALIBABA_CLOUD_ACCESS_KEY_SECRET en lugar de codificarla directamente.
Descripción de la solicitud
-
Método HTTP: POST
-
URL de solicitud
Región
Endpoint
Singapur
POST https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/organization -
Autenticación
Esta operación es una operación de OpenAPI de Alibaba Cloud que utiliza firmas basadas en AccessKey (el algoritmo
ACS3-HMAC-SHA256). No se admite el esquemaAuthorization: Bearer {API_KEY}. Una solicitud debe llevar los encabezados comunesx-acs-action: UpdateOrganization,x-acs-version: 2026-02-10,x-acs-date,x-acs-content-sha256,x-acs-signature-nonceyAuthorization.Le recomendamos que invoque esta operación con un SDK de Alibaba Cloud o OpenAPI Explorer para no tener que calcular la firma usted mismo.
Parámetros de solicitud
Todos los parámetros se pasan en la cadena de consulta.
Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
Name | string | No | Nombre de la organización. |
Description | string | No | Descripción de la organización. |
Parámetros de respuesta
Parámetro | Tipo | Descripción |
|---|---|---|
Success | boolean | Indica si la llamada a la API fue exitosa: |
Code | string | Código de estado de la respuesta. |
Message | string | Mensaje de respuesta. |
Data | object | Datos comerciales. |
OrgId | string | ID de organización. |
NamespaceId | string | ID del espacio de nombres del producto. |
Name | string | Nombre de la organización. |
Description | string | Descripción de la organización. |
Status | string | Status |
OwnerId | string | ID de cuenta UAC del propietario de la organización. |
OwnerBizAccountId | string | Identificador de cuenta comercial del propietario de la organización (tipo ALIYUN: aliyunUid, tipo SSO: userIdentifier). |
GmtCreate | string | Hora de creación. |
GmtModified | string | Hora de modificación. |
HttpStatusCode | integer | Código de estado HTTP. |
RequestId | string | ID único de solicitud. |
Ejemplo de solicitud
Esta operación utiliza firmas de OpenAPI de Alibaba Cloud. En el siguiente ejemplo, ${SIGNATURE} debe calcularse con el algoritmo ACS3-HMAC-SHA256, y x-acs-date y x-acs-signature-nonce deben reemplazarse con valores reales.
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}"
Ejemplo de respuesta
{
"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"
}
}
Códigos de error
Si la llamada falla, se devuelve un mensaje de error. Para obtener más códigos de error y soluciones, consulte Códigos de error.