Atualiza a configuração de uma instância do Logstash.
Antes de chamar esta operação, observe os seguintes pontos:
Não é possível atualizar a configuração da instância se ela estiver no estado Active (activating), Invalid (invalid) ou Inactive (inactive).
Depuração
Parâmetros da solicitação
Esta operação utiliza apenas cabeçalhos de solicitação comuns. Para mais informações, consulte Parâmetros de solicitação comuns.
Estrutura da solicitação
PATCH|POST /openapi/logstashes/[InstanceId]/instance-settings HTTP/1.1
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Localização |
Obrigatório |
Exemplo |
Descrição |
|
InstanceId |
String |
Path |
Sim |
ls-cn-2r42btxr**** |
O ID da instância do Logstash. |
|
clientToken |
String |
Query |
Não |
5A2CFF0E-5718-45B5-9D4D-70B3FF**** |
Token de cliente usado para garantir a idempotência da solicitação. Gere o valor com o cliente, mas garanta que ele seja único entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não deve exceder 64 caracteres. |
RequestBody
Especifique os seguintes parâmetros no RequestBody para atualizar a configuração da instância do Logstash.
|
** Campo ** |
** Tipo ** |
** Obrigatório ** |
** Exemplo ** |
** Descrição ** |
|
config |
Map |
Não |
{"thread_pool.bulk.queue_size":500} |
A configuração YML da instância. |
Parâmetros de resposta
|
Parâmetro |
Tipo |
Exemplo |
Descrição |
|
RequestId |
String |
71D0D1DA-B22F-58CB-AF5B-D1657A6A**** |
O ID da solicitação. |
A resposta também contém o parâmetro Result. Para mais informações, consulte ListLogstash.
Exemplos
Exemplos de solicitações
PATCH /openapi/logstashes/ls-cn-2r42btxr****/instance-settings HTTP/1.1
Common request headers
Exemplos de respostas de sucesso
Formato JSON
{
"Result": {
"instanceId": "ls-cn-2r42btxr****",
"version": "7.4.0_with_X-Pack",
"description": "lrr",
"nodeAmount": 1,
"paymentType": "postpaid",
"status": "active",
"enablePublic": false,
"nodeSpec": {
"spec": "elasticsearch.sn1ne.large",
"disk": 20,
"diskType": "cloud_efficiency"
},
"dataNode": true,
"networkConfig": {
"vpcId": "vpc-bp1jy348ibzulk6hn****",
"vswitchId": "vsw-bp1a0mifpletdd1da****",
"vsArea": "cn-hangzhou-h",
"whiteIpGroupList": [],
"type": "vpc"
},
"createdAt": "2021-08-30T08:28:21.976Z",
"updatedAt": "2021-08-30T08:59:06.371Z",
"commodityCode": "elasticsearch_logstash_post",
"extendConfigs": [],
"endTime": 4786012800000,
"clusterTasks": [],
"resourceGroupId": "rg-acfmxxkk2p7****",
"zoneCount": 1,
"protocol": "HTTP",
"zoneInfos": [
{
"zoneId": "cn-hangzhou-h",
"status": "NORMAL"
}
],
"instanceType": "logstash",
"inited": true,
"tags": [
{
"tagKey": "acs:rm:rgId",
"tagValue": "rg-acfmxxkk2p7****"
}
],
"serviceVpc": false,
"isNewDeployment": false,
"config": {
"xpack.monitoring.enabled": "true",
"xpack.monitoring.elasticsearch.username": "elastic",
"slowlog.threshold.debug": "500ms",
"xpack.monitoring.elasticsearch.hosts": "[\"http://es-cn-7pp2bvb75005u****.elasticsearch.aliyuncs.com:9200\"]",
"xpack.monitoring.elasticsearch.password": "*******",
"slowlog.threshold.warn": "2s",
"slowlog.threshold.info": "1s",
"slowlog.threshold.trace": "100ms"
},
"endpointList": [
{
"host": "172.29.XX.XX",
"port": 9600,
"zoneId": "cn-hangzhou-h"
}
]
},
"RequestId": "71D0D1DA-B22F-58CB-AF5B-D1657A6A****"
}
Códigos de erro
|
HttpCode |
Código de erro |
Mensagem de erro |
Descrição |
|
400 |
InstanceActivating |
Instance is activating. |
A instância está sendo ativada. |
|
400 |
InstanceNotFound |
The instanceId provided does not exist. |
A instância especificada não existe. Verifique o ID da instância. |
Para obter uma lista de códigos de erro, visite a Central de Erros de API.