Skip to main content

Obtener organización

Obtiene información 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: GET
  • URL de solicitud

    Región

    Endpoint

    Singapur

    GET 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 esquema Authorization: Bearer {API_KEY}. Una solicitud debe llevar los encabezados comunes x-acs-action: GetOrganization, x-acs-version: 2026-02-10, x-acs-date, x-acs-content-sha256, x-acs-signature-nonce y Authorization. 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.
Obtiene información de una organización específica mediante OrgId.

Parámetros de solicitud

Esta API no tiene parámetros de solicitud.

Parámetros de respuesta

Parámetro

Tipo

Descripción

Success

boolean

Indica si la llamada a la API fue exitosa:
true: éxito
false: fallo

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

Estado (ACTIVE/FROZEN).

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 GET "https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/organization" \
    --header "x-acs-action: GetOrganization" \
    --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": "1543686331379464",
    "GmtCreate": "2025-11-20T02:26:35Z",
    "GmtModified": "2025-11-13T02:11:56Z"
  }
}

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.