Skip to main content

Renovar assentos

Renove uma assinatura de assentos como um todo.

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 o BssOpenApi. Recomendamos definir 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. Você tem uma assinatura de assentos do Token Plan edição equipe válida e obteve ProductCode, ProductType e SubscriptionType chamando QueryProductList.

Descrição da solicitação

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

    Região

    Endpoint

    Singapura

    POST https://business.ap-southeast-1.aliyuncs.com/

  • Autenticação Esta operação pertence ao BssOpenApi (versão 2023-09-30) e usa assinaturas RPC de AccessKey (HMAC-SHA1). O esquema Authorization: Bearer {API_KEY} não é compatível. Recomendamos chamar esta operação com a classe CommonRequest de um SDK da Alibaba Cloud. O SDK gera os parâmetros comuns e calcula a assinatura automaticamente.

Parâmetros da solicitação

Todos os parâmetros são passados como dados de formulário ou na string de consulta. Parâmetros de matriz usam o formato Flat: Configs.1.Code e Configs.1.Value, com o índice começando em 1.

Parâmetro

Tipo

Obrigatório

Descrição

ProductCode

string

Sim

Código do produto. Obtenha-o chamando QueryProductList. Exemplo: sfm.

ProductType

string

Sim

Tipo de produto. Obtenha-o chamando QueryProductList. Exemplo: sfm_tokenplanteams_dp_intl.

SubscriptionType

string

Sim

Tipo de assinatura. Obtenha-o chamando QueryProductList. Exemplo: Subscription.

ClientToken

string

Sim

Token de idempotência. Gere-o no cliente e mantenha-o exclusivo entre solicitações. Comprimento máximo: 64 caracteres ASCII.

Period

integer

Sim

Período de assinatura. Valor mínimo: 1.

PeriodUnit

string

Sim

Unidade do período. Valores válidos: Year e Month.

AutoRenew

boolean

Não

Especifica se a renovação automática está habilitada.

Parâmetros de resposta

Parâmetro

Tipo

Descrição

RequestId

string

ID da solicitação.

Success

boolean

Indica se a solicitação foi bem-sucedida.

Code

string

Código de resultado. O valor é Success quando a solicitação é bem-sucedida.

Message

string

Mensagem de resultado.

Data

object

Dados de negócio.

Data.OrderId

long

ID do pedido.

Data.HostId

string

Identificador do site. Este campo pode ser omitido em algumas respostas.

AccessDeniedDetail

string

Informações detalhadas do erro retornadas quando as permissões RAM são negadas.

Exemplo de solicitação

Esta operação usa assinaturas RPC do BssOpenApi. No exemplo a seguir, ${SIGNATURE} deve ser calculado com o algoritmo de assinatura, e SignatureNonce e Timestamp devem ser substituídos por valores reais. Um SDK da Alibaba Cloud trata os parâmetros comuns e a assinatura automaticamente.
curl -X POST "https://business.ap-southeast-1.aliyuncs.com/" \
    --data-urlencode "Action=RenewCreditSeat" \
    --data-urlencode "Version=2023-09-30" \
    --data-urlencode "Format=JSON" \
    --data-urlencode "AccessKeyId=${ALIBABA_CLOUD_ACCESS_KEY_ID}" \
    --data-urlencode "SignatureMethod=HMAC-SHA1" \
    --data-urlencode "SignatureVersion=1.0" \
    --data-urlencode "SignatureNonce=${SIGNATURE_NONCE}" \
    --data-urlencode "Timestamp=2026-01-01T12:00:00Z" \
    --data-urlencode "Signature=${SIGNATURE}" \
    --data-urlencode "ProductCode=sfm" \
    --data-urlencode "ProductType=sfm_tokenplanteams_dp_intl" \
    --data-urlencode "SubscriptionType=Subscription" \
    --data-urlencode "ClientToken=example-client-token-001" \
    --data-urlencode "Period=1" \
    --data-urlencode "PeriodUnit=Month" \
    --data-urlencode "AutoRenew=false"

Exemplo de resposta

{
  "RequestId": "request-id-example",
  "Success": true,
  "Code": "Success",
  "Message": "Successful!",
  "Data": {
    "OrderId": 1234567890123459
  }
}

Códigos de erro

Códigos de erro comuns para renovação: INSTANCE_HOLDING_LIMIT_EXCEEDED, MissingParameter e ResourceNotExists. Se a chamada falhar, uma mensagem de erro será retornada. Para mais códigos de erro e soluções, consulte Códigos de erro do BssOpenApi.