Skip to main content

Definir configuração de convite

Defina a configuração de convite de membros do TokenPlan.

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/invite/config/set

  • 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: SetTokenPlanOrgInviteConfig, 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

DefaultRoleId

string

Sim

ID da função organizacional atribuída por padrão
SYSTEM_ROLE_ORG_ADMIN
SYSTEM_ROLE_ORG_MEMBER

SeatAssignStrategy

string

Sim

Estratégia padrão de atribuição de assentos
HIGH_TO_LOW
LOW_TO_HIGH
NONE

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.

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/invite/config/set?DefaultRoleId=ORG_MEMBER&SeatAssignStrategy=NONE" \
    --header "x-acs-action: SetTokenPlanOrgInviteConfig" \
    --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
}

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.