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
-
Autenticação
Esta operação pertence ao BssOpenApi (versão
2023-09-30) e usa assinaturas RPC de AccessKey (HMAC-SHA1). O esquemaAuthorization: Bearer {API_KEY}não é compatível. Recomendamos chamar esta operação com a classeCommonRequestde 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 |
ProductType | string | Sim | Tipo de produto. Obtenha-o chamando |
SubscriptionType | string | Sim | Tipo de assinatura. Obtenha-o chamando |
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: |
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 é |
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.
Exemplo de resposta
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.