Skip to main content

Atualizar Organização

Atualizar informações básicas, como o nome de uma organização especificada.

Pré-requisitos

Você obteve o AccessKey de uma conta Alibaba Cloud ou de um usuário RAM, e a identidade recebeu as permissões RAM necessárias para chamar esta operação. Recomendamos que você defina o AccessKey como as variáveis de ambiente ALIBABA_CLOUD_ACCESS_KEY_ID e ALIBABA_CLOUD_ACCESS_KEY_SECRET em vez de codificá-lo diretamente.

Descrição da solicitação

  • Método HTTP: POST
  • URL da solicitação

    Região

    Endpoint

    Singapura

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

  • Autenticação Esta operação é uma operação da OpenAPI da Alibaba Cloud que utiliza assinaturas baseadas em AccessKey (o algoritmo ACS3-HMAC-SHA256). O esquema Authorization: Bearer {API_KEY} não é suportado. Uma solicitação deve incluir os cabeçalhos comuns x-acs-action: UpdateOrganization, x-acs-version: 2026-02-10, x-acs-date, x-acs-content-sha256, x-acs-signature-nonce e Authorization. Recomendamos que você chame esta operação com um SDK da Alibaba Cloud ou o OpenAPI Explorer para que não seja necessário calcular a assinatura manualmente.

Parâmetros da solicitação

Todos os parâmetros são passados na string de consulta.

Parâmetro

Tipo

Obrigatório

Descrição

Name

string

Não

Nome da organização.

Description

string

Não

Descrição da organização.

Parâmetros de resposta

Parâmetro

Tipo

Descrição

Success

boolean

Se a chamada de API foi bem-sucedida:
true: sucesso
false: falha

Code

string

Código de status da resposta.

Message

string

Mensagem de resposta.

Data

object

Dados comerciais.

OrgId

string

ID da Organização.

NamespaceId

string

ID do namespace do produto.

Name

string

Nome da organização.

Description

string

Descrição da organização.

Status

string

Status
ACTIVE
FROZEN

OwnerId

string

ID da conta UAC do proprietário da organização.

OwnerBizAccountId

string

Identificador da conta comercial do proprietário da organização (tipo ALIYUN: aliyunUid, tipo SSO: userIdentifier).

GmtCreate

string

Hora de criação.

GmtModified

string

Hora de modificação.

HttpStatusCode

integer

Código de status HTTP.

RequestId

string

ID único da solicitação.

Exemplo de solicitação

Esta operação utiliza assinaturas da OpenAPI da Alibaba Cloud. No exemplo a seguir, ${SIGNATURE} deve ser calculado com o algoritmo ACS3-HMAC-SHA256, e x-acs-date e x-acs-signature-nonce devem ser substituídos pelos valores reais.
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}"

Exemplo de resposta

{
  "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 erro

Se a chamada falhar, uma mensagem de erro será retornada. Para mais códigos de erro e soluções, consulte Códigos de erro.