Todos os produtos
Search
Central de documentação

Elasticsearch:RestartLogstash

Última atualização: Jun 27, 2026

Reinicia um cluster Logstash especificado. Após a reinicialização, o cluster assume o estado de ativação.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Cabeçalhos da requisição

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

Sintaxe da requisição

POST /openapi/logstashes/{InstanceId}/actions/restart HTTP/1.1

Parâmetros da requisição

ParâmetroTipoPosiçãoObrigatórioExemploDescrição
InstanceIdStringPathSimls-cn-v0h1kzca****

ID da instância.

forceBooleanQueryNãotrue

Indica se a reinicialização é forçada:

  • true: obrigatória,
  • false (padrão): não forçada
clientTokenStringQueryNão5A2CFF0E-5718-45B5-9D4D-70B3FF****

Token do cliente usado para garantir a idempotência da requisição. Gere o valor pelo cliente, mas garanta sua unicidade entre requisições distintas. O token aceita apenas caracteres ASCII e limita-se a 64 caracteres.

ObjectBodyNão

Corpo da requisição.

batchCountdoubleBodyNão20%

Concorrência da reinicialização forçada. Em reinicializações blue-green, essa opção é inaplicável e dispensa configuração.

restartTypeStringBodyNãoinstance

Tipo de reinicialização. Valores válidos:

  • instance: reinicia a instância
  • nodeIp: reinicia o nó
nodesArray of StringBodyNão["192.168.1.1"]

Lista de endereços IP dos nós a reiniciar, em formato de array JSON.

nodeTypesArray of StringBodyNãokibana

Tipo do nó de função a reiniciar. Parâmetro sem suporte.

blueGreenDepBooleanBodyNãofalse

Define se ocorre uma reinicialização blue-green. Valor padrão: false.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

F99407AB-2FA9-489E-A259-40CF6DCC****

ID da requisição.

Result

Logstash

Detalhes da instância atual.

Os dados retornados também incluem o parâmetro Result. Para mais informações sobre os parâmetros, consulte ListLogstash.

Exemplos

Exemplos de requisições

POST /openapi/logstashes/ls-cn-v0h1kzca****/actions/restart?force=true&clientToken=5A2CFF0E-5718-45B5-9D4D-70B3FF**** HTTP/1.1
Host:elasticsearch.aliyuncs.com
Content-Type:application/json

{
  "restartType" : "instance"
}

Exemplos de respostas

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Result" : {
    "instanceId" : "ls-cn-v0h1kzca****",
    "version" : "7.4.0_with_X-Pack",
    "description" : "es-74-keepit",
    "nodeAmount" : 1,
    "paymentType" : "prepaid",
    "status" : "active",
    "enablePublic" : false,
    "nodeSpec" : {
      "spec" : "elasticsearch.sn1ne.large",
      "disk" : 20,
      "diskType" : "cloud_ssd"
    },
    "networkConfig" : {
      "vpcId" : "vpc-bp12nu14urf0upaf4****",
      "vswitchId" : "vsw-bp131d5ag0vjd5ja3****",
      "vsArea" : "cn-hangzhou-h",
      "type" : "vpc"
    },
    "createdAt" : "2020-03-26T09:23:06.575Z",
    "updatedAt" : "2020-05-12T11:06:14.132Z",
    "commodityCode" : "elasticsearch_logstash_pre",
    "extendConfigs" : [ ],
    "endTime" : 1619884800000,
    "clusterTasks" : [ ],
    "resourceGroupId" : "rg-acfm2h5vbzd****",
    "zoneCount" : 1,
    "protocol" : "HTTP",
    "zoneInfos" : [ {
      "zoneId" : "cn-hangzhou-h",
      "status" : "NORMAL"
    } ],
    "instanceType" : "logstash",
    "inited" : true,
    "tags" : [ ],
    "config" : {
      "slowlog.threshold.warn" : "2s",
      "slowlog.threshold.info" : "1s",
      "slowlog.threshold.debug" : "500ms",
      "slowlog.threshold.trace" : "100ms"
    },
    "endpointList" : [ {
      "host" : "10.7.**.**",
      "port" : 9600,
      "zoneId" : "cn-hangzhou-h"
    } ]
  },
  "RequestId" : "831AD23B-175F-47F1-8314-AFBB9947****"
}

Códigos de erro

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