UpdateLogstashSettings - Elasticsearch - Alibaba Cloud ドキュメントセンター

指定された Logstash クラスタの構成を更新します。

この操作を呼び出すときは、次の項目に注意してください。

インスタンスが Active（アクティブ化中）、Invalid（無効）、および Inactive（非アクティブ）状態の場合、情報は更新できません。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。 OpenAPI Explorer を使用すると、API 操作の検索、API 操作の呼び出し、SDK サンプルコードの動的生成を行うことができます。

リクエストパラメータ

この操作では、共通リクエストヘッダーのみを使用します。詳細については、「共通リクエストパラメータ」をご参照ください。

リクエスト構造

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

リクエストパラメータ

パラメータ	タイプ	場所	必須	例	説明
InstanceId	String	Path	Yes	ls-cn-2r42btxr****	インスタンス ID。
clientToken	String	Query	No	5A2CFF0E-5718-45B5-9D4D-70B3FF****	このパラメータは、リクエストのべき等性を確保するために使用されます。クライアントで値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。

RequestBody

指定された Logstash インスタンスの構成を更新するには、RequestBody で次のパラメータを指定する必要があります。

フィールド	タイプ	必須	例	説明
config	Map	No	{"thread_pool.bulk.queue_size":500}	インスタンスの YML 構成情報を更新するために使用されます。

レスポンスパラメータ

パラメータ	タイプ	例	説明
RequestId	String	71D0D1DA-B22F-58CB-AF5B-D1657A6A****	リクエスト ID。

返されるデータには、Result パラメータも含まれています。パラメータの詳細については、「ListLogstash」をご参照ください。

例

リクエストの例

PATCH /openapi/logstashes/ls-cn-2r42btxr****/instance-settings HTTP/1.1
共通リクエストヘッダー

正常なレスポンスの例

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

エラーコード

HttpCode	エラーコード	エラーメッセージ	説明
400	InstanceActivating	Instance is activating.	インスタンスは現在有効になっています。
400	InstanceNotFound	The instanceId provided does not exist.	インスタンスが見つかりません。インスタンスの状態を確認してください。

エラーコードのリストについては、API エラーセンターをご覧ください。