すべてのプロダクト
Search
ドキュメントセンター

Elasticsearch:DeactivateZones

最終更新日:Mar 17, 2025

複数のゾーンが使用可能な場合、deactivatezones を呼び出してゾーンの一部をオフラインにします。オフラインゾーンのノードを他のゾーンに移行する必要があります。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。 OpenAPI Explorer は、さまざまな SDK の操作のサンプルコードを動的に生成します。

リクエストヘッダー

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

リクエスト構文

POST /openapi/instances/[InstanceId]/actions/down-zones HTTPS|HTTP

リクエストパラメータ

パラメータタイプ必須説明
InstanceIdStringはいes-cn-n6w1o1x0w001c****

インスタンス ID。

clientTokenStringいいえ5A2CFF0E-5718-45B5-9D4D-70B3FF****

リクエストの冪等性を保証するためにクライアントによって生成された一意のトークン。クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。

RequestBody

RequestBody フィールドにゾーンの ID も指定する必要があります。 例:

["cn-hangzhou-i","cn-hangzhou-f"]

レスポンスパラメータ

パラメータタイプ説明
RequestIdStringF99407AB-2FA9-489E-A259-40CF6DCC****

リクエスト ID。

Resultブール値true

戻り値:

  • true: ゾーンのオフライン化に成功しました
  • false: ゾーンのオフライン化に失敗しました

リクエストの例

POST /openapi/instances/es-cn-n6w1o1x0w001c****/actions/down-zones HTTP/1.1
共通リクエストパラメータ
["cn-hangzhou-i","cn-hangzhou-f"]

成功レスポンスの例

JSON 形式

{
    "Result": true,
    "RequestId": "5A5D8E74-565C-43DC-B031-29289FA****"
}

エラーコード

HttpCodeエラーコードエラーメッセージ説明
400InstanceNotFound指定された instanceId が存在しません。指定されたインスタンスが見つからないため返されたエラーメッセージ。 インスタンスの状態を確認してください。

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