Reinicia um cluster Logstash especificado. Após a reinicialização, o cluster assume o estado de ativação.
Depuração
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âmetro | Tipo | Posição | Obrigatório | Exemplo | Descrição |
| InstanceId | String | Path | Sim | ls-cn-v0h1kzca**** | ID da instância. |
| force | Boolean | Query | Não | true | Indica se a reinicialização é forçada:
|
| clientToken | String | Query | Não | 5A2CFF0E-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. |
| Object | Body | Não | Corpo da requisição. | ||
| batchCount | double | Body | Não | 20% | Concorrência da reinicialização forçada. Em reinicializações blue-green, essa opção é inaplicável e dispensa configuração. |
| restartType | String | Body | Não | instance | Tipo de reinicialização. Valores válidos:
|
| nodes | Array of String | Body | Não | ["192.168.1.1"] | Lista de endereços IP dos nós a reiniciar, em formato de array JSON. |
| nodeTypes | Array of String | Body | Não | kibana | Tipo do nó de função a reiniciar. Parâmetro sem suporte. |
| blueGreenDep | Boolean | Body | Não | false | 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 |
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.