Skip to main content

Atualizar assento

Atualize um único assento.

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 atualizar. Você pode obtê-lo no InstanceCode retornado por Obter detalhes dos assentos da assinatura.

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

Configs

Array

Sim

Propriedades do módulo.

Configs.N.Code

string

Não

Código da propriedade do módulo. Exemplo: plan_type.

Configs.N.Value

string

Não

Valor da propriedade do módulo. Exemplos: standard, pro e max.

Code e Value em Configs devem ser especificados em par. Os valores suportados dependem do produto. Para uma atualização, especifique o nível de destino em Configs, por exemplo, plan_type=pro.

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

Array[string]

IDs de instância.

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=UpgradeCreditSeat" \
    --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-example0000000003" \
    --data-urlencode "Configs.1.Code=plan_type" \
    --data-urlencode "Configs.1.Value=pro"

Exemplo de resposta

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

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.