Todos os produtos
Search
Central de documentação

Elasticsearch:AtualizeLogstashSettings

Última atualização: Jun 27, 2026

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

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. Use o OpenAPI Explorer para pesquisar operações de API, chamá-las e gerar dinamicamente códigos de exemplo de SDK.

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.