Todos os produtos
Search
Central de documentação

Elasticsearch:RenewLogstash

Última atualização: Jun 27, 2026

Chame a API RenewLogstash para renovar uma instância.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. Use o OpenAPI Explorer para pesquisar operações de API, chamá-las e gerar dinamicamente códigos de exemplo do SDK.

Cabeçalho da requisição

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

Sintaxe da requisição

POST /openapi/logstashes/[InstanceId]/actions/renew HTTPS|HTTP

Parâmetros da requisição

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

InstanceId

String

Sim

ls-cn-n6w1o5jq****

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. Esse valor deve ser único entre diferentes requisições e ter no máximo 64 caracteres ASCII.

RequestBody

Insira os seguintes parâmetros no RequestBody.

Campo

Tipo

Obrigatório

Exemplo

Descrição

duration

Integer

Sim

1

Duração da renovação do cluster por assinatura.

Se pricingCycle for Year, valores válidos: 1 a 3.

Se pricingCycle for Month, valores válidos: 1 a 9.

pricingCycle

String

Sim

Year

Ciclo de faturamento da renovação. Valores válidos: Year e Month.

Código de exemplo:

{
    "duration":1,
    "pricingCycle":"Year"
}

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
RequestId String F99407AB-2FA9-489E-A259-40CF6DC****

ID da requisição.

Result Boolean true

Resultados retornados:

  • true: renovação bem-sucedida
  • false: falha na renovação

Exemplos

Exemplos de requisição

POST /openapi/logstashes/ls-cn-n6w1o5jq****/actions/renew HTTP/1.1
common request header
{
    "duration":1,
    "pricingCycle":"Year"
}

Exemplos de resposta de sucesso

JSON Sintaxe

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

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