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

Elasticsearch クラスターのバージョンまたはカーネルをアップグレードします。

説明インスタンスバージョンは、バージョン 5.5.3 からバージョン 5.6.16、バージョン 5.6.16 からバージョン 6.3.2、バージョン 6.3.2 からバージョン 6.7.0 にのみアップグレードできます。詳細については、「バージョンのアップグレード」をご参照ください。

デバッグ

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

リクエストヘッダー

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

リクエスト構文

POST /openapi/instances/{InstanceId}/actions/upgrade-version HTTP/1.1

リクエストパラメーター

パラメーター	タイプ	位置	必須	例	説明
InstanceId	String	Path	はい	es-cn-n6w1o1x0w001c****	インスタンス ID。
clientToken	String	Query	いいえ	5A2CFF0E-5718-45B5-9D4D-70B3FF****	リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用して値を生成できますが、異なるリクエスト間で値が一意であることを確認する必要があります。トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。
dryRun	Boolean	Query	いいえ	false	アップグレード前の検証を実行するかどうかを示します。 true: 検証 false (デフォルト): 検証しない警告バージョンのアップグレード検証には、クラスター YML、プラグイン構成、クラスターの状態、インデックス、およびリソースの確認が含まれます。アップグレード前に事前検証を実行することを強くお勧めします。そうしないと、アップグレードの問題が発生する可能性があります。
	Object	Body	いいえ		リクエストの本文。
version	String	Body	いいえ	6.7	最新バージョン。 type が engineVersion に設定されている場合、値はインスタンスバージョンです (例: 6.7)。 type が aliVersion に設定されている場合、値はカーネルバージョンです (例: ali1.2.0)。
type	String	Body	いいえ	engineVersion	アップグレードのタイプ。有効な値: engineVersion (デフォルト): メジャーバージョンアップグレード aliVersion: カーネルバージョンアップグレード

レスポンスパラメーター

パラメーター	タイプ	例	説明
RequestId	String	F99407AB-2FA9-489E-A259-40CF6DC*****	リクエスト ID。
Result	Result の配列		モデレーション結果。
validateType	String	checkClusterHealth	モニタリングタイプ。有効な値: checkClusterHealth: クラスタヘルスステータス checkConfigCompatible: 構成の互換性ステータス checkClusterResource: リソーススペースステータス checkClusterSnapshot: スナップショットが存在するかどうか
validateResult	validateResult の配列		検証情報。
errorType	String	clusterStatus	エラーのタイプ。有効な値: clusterStatus: クラスタのヘルスステータス。 clusterConfigYml: クラスタ YML ファイル clusterConfigPlugins: クラスタ構成ファイル clusterResource: クラスタリソース clusterSnapshot: クラスタスナップショット
errorCode	String	ClusterStatusNotHealth	リクエストが失敗した場合に返されるエラーコード。
errorMsg	String	The cluster status is not health	返されたエラーメッセージ。
status	String	success	検証に合格しました。有効な値: success: 成功 failed: 失敗

例

リクエストの例

POST /openapi/instances/es-cn-n6w1o1x0w001c****/actions/upgrade-version?clientToken=5A2CFF0E-5718-45B5-9D4D-70B3FF****&dryRun=false HTTP/1.1
Host:elasticsearch.aliyuncs.com
Content-Type:application/json

{
  "version" : "6.7",
  "type" : "engineVersion"
}

成功レスポンスの例

JSON 形式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Result" : [ {
    "validateType" : "checkClusterHealth",
    "status" : "failed",
    "validateResult" : [ {
      "errorType" : "clusterStatus",
      "errorCode" : "ClusterStatusNotHealth",
      "errorMsg" : "ClusterStatusNotHealth"
    } ]
  }, {
    "validateType" : "checkConfigCompatible",
    "status" : "failed",
    "validateResult" : [ {
      "errorType" : "clusterConfigYml",
      "errorCode" : "ClusterYamlNotCompatible",
      "errorMsg" : "ClusterYamlNotCompatible"
    }, {
      "errorType" : "clusterConfigPlugins",
      "errorCode" : "ClusterPluginsNotSupport",
      "errorMsg" : "ClusterPluginsNotSupport"
    } ]
  }, {
    "validateType" : "checkClusterResource",
    "status" : "failed",
    "validateResult" : [ {
      "errorType" : "clusterResource",
      "errorCode" : "ClusterResourceNotEnough",
      "errorMsg" : "ClusterResourceNotEnough"
    } ]
  }, {
    "validateType" : "checkClusterSnapshot",
    "status" : "failed",
    "validateResult" : [ {
      "errorType" : "clusterSnapshot",
      "errorCode" : "ClusterSnapshotNotAvaild",
      "errorMsg" : "ClusterSnapshotNotAvaild"
    } ]
  } ],
  "RequestId" : "F99407AB-2FA9-489E-A259-40CF6DC****"
}

エラーコード

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