Todos os produtos
Search
Central de documentação

Elasticsearch:UpdateInstanceChargeType

Última atualização: Jun 27, 2026

Chame a API UpdateInstanceChargeType para alterar o método de faturamento de uma instância com pagamento conforme o uso para assinatura.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer, que também gera dinamicamente códigos de exemplo para diferentes SDKs.

Cabeçalho da requisição

Esta operação utiliza apenas parâmetros de requisição comuns. Para mais informações, consulte Parâmetros comuns.

Sintaxe da requisição

POST /openapi/instances/[InstanceId]/actions/convert-pay-type HTTPS|HTTP

Parâmetros da requisição

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

InstanceId

String

Sim

es-cn-0pp1jxvcl000z****

ID da instância.

clientToken

String

Não

5A2CFF0E-5718-45B5-9D4D-70B3FF****

Token exclusivo gerado pelo cliente para garantir a idempotência da requisição. Gere o valor no cliente e assegure sua unicidade entre requisições distintas. O token deve conter apenas caracteres ASCII e ter no máximo 64 caracteres.

RequestBody

Especifique também os seguintes parâmetros no RequestBody para definir as informações de faturamento da instância após a conversão para assinatura.

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

paymentInfo

Array

Sim

Informações de faturamento da instância após a conversão.

└duration

Integer

Sim

1

Duração do pagamento da instância. De 1 a 3 se o parâmetro pricingCycle for Year. De 1 a 9 se o parâmetro pricingCycle for Month.

└pricingCycle

String

Sim

Year

Ciclo de faturamento da instância. Valores válidos: Year e Month.

paymentType

String

Sim

prepaid

Método de faturamento da instância. Como apenas instâncias com pagamento conforme o uso podem ser convertidas para assinatura, defina este parâmetro como prepaid.

Nota

└ indica um parâmetro filho.

Exemplo:


{
  "paymentInfo":{ 
       "duration":1,
       "pricingCycle":"Month"
    },
  "paymentType":"prepaid"
}
            

Parâmetros de resposta

ParâmetroTipoExemploDescrição
RequestIdString5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1D****

ID da requisição.

ResultBooleantrue

Resultados retornados:

  • true: conversão bem-sucedida
  • false: falha na conversão

Exemplos

Requisições de exemplo

POST /openapi/instances/es-cn-0pp1jxvcl000z****/actions/convert-pay-type HTTP/1.1
Common request parameters
{
  "paymentInfo":{ 
       "duration":1,
       "pricingCycle":"Month"
    },
  "paymentType":"prepaid"
}

Respostas de sucesso de exemplo

Formato JSON

{
    "Result":true,
    "RequestId":"3760F67B-691D-4663-B4E5-6783554F****"
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

400

InstanceNotFound

The instanceId provided does not exist.

A instância especificada não foi encontrada. Verifique o status da instância.

Para obter uma lista de códigos de erro, visite a Central de Erros de API.