Skip to main content

Cancelar assentos

Cancele um único assento não utilizado.

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ê obteve o InstanceId do assento que deseja cancelar. Você pode obtê-lo no InstanceCode retornado por Obter detalhes dos assentos da assinatura. Apenas assentos que não usaram Credits podem ser cancelados.

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.

InstanceId

string

Sim

ID da instância de assento a ser cancelada. Apenas assentos que não usaram Credits são suportados.

O Success externo indica se a solicitação foi aceita. Use Data.Success para determinar o resultado do reembolso. Se falhar, verifique Data.ErrorInfo e Data.ErrorCode.

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.InstanceId

string

ID da instância.

Data.Success

boolean

Indica se o reembolso foi bem-sucedido.

Data.ErrorInfo

string

Informações de erro retornadas quando o reembolso falha.

Data.ErrorCode

string

Código de erro retornado quando o reembolso falha.

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=ReduceCreditSeats" \
    --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 "InstanceId=subs-example0000000004"

Exemplo de resposta

{
  "RequestId": "request-id-example",
  "Success": true,
  "Code": "Success",
  "Message": "Successful!",
  "Data": {
    "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 do BssOpenApi.