UpdateLogstashSettings - Elasticsearch - Centre de documentation Alibaba Cloud

Avant d'appeler cette opération, tenez compte des points suivants :

Il est impossible de mettre à jour la configuration si l'instance se trouve dans l'état Active (en cours d'activation), Invalid (invalide) ou Inactive (inactive).

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. Vous pouvez utiliser OpenAPI Explorer pour rechercher des opérations API, les appeler et générer dynamiquement des exemples de code SDK.

Paramètres de requête

Cette opération utilise uniquement les en-têtes de requête communs. Pour plus d'informations, consultez la rubrique Paramètres de requête communs.

Structure de la requête

PATCH|POST /openapi/logstashes/[InstanceId]/instance-settings HTTP/1.1

Paramètres de requête

Paramètre

Type

Emplacement

Obligatoire

Exemple

Description

InstanceId

String

Path

Oui

ls-cn-2r42btxr****

ID de l'instance Logstash.

clientToken

String

Query

Non

5A2CFF0E-5718-45B5-9D4D-70B3FF****

Jeton client utilisé pour garantir l'idempotence de la requête. Générez la valeur via le client, en veillant à son unicité pour chaque requête. Le jeton ne doit contenir que des caractères ASCII et ne pas dépasser 64 caractères.

RequestBody

Spécifiez les paramètres suivants dans RequestBody pour mettre à jour la configuration de l'instance Logstash.

**

Champ

**

Type

**

Obligatoire

**

Exemple

**

Description

**

config

Map

Non

{"thread_pool.bulk.queue_size":500}

Configuration YML de l'instance.

Paramètres de réponse

Paramètre

Type

Exemple

Description

RequestId

String

71D0D1DA-B22F-58CB-AF5B-D1657A6A****

ID de la requête.

La réponse contient également le paramètre Result. Pour plus d'informations, consultez la rubrique ListLogstash.

Exemples

Exemples de requêtes

PATCH /openapi/logstashes/ls-cn-2r42btxr****/instance-settings HTTP/1.1
Common request headers

Exemples de réponses réussies

JSON format

{
    "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****"
}

Codes d'erreur

HttpCode	Code d'erreur	Message d'erreur	Description
400	InstanceActivating	Instance is activating.	L'instance est en cours d'activation.
400	InstanceNotFound	The instanceId provided does not exist.	L'instance spécifiée n'existe pas. Vérifiez l'ID de l'instance.

Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs API.