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

Hologres:PrepareUpgrade

最終更新日:May 21, 2026

アップグレード前の評価を実行し、インスタンスのアップグレードを準備します。評価に合格した場合にのみ、インスタンスをアップグレードできます。失敗した場合は、テクニカルサポートに連絡して手動アップグレードを依頼してください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエスト構文

POST /api/v1/instances/{instanceId}/upgrade/prepare HTTP/1.1

パスパラメータ

パラメーター

必須 / 任意

説明

instanceId

string

任意

インスタンスの ID。

hgpostcn-cn-nwy3e6yxxx

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId

string

任意

リージョン ID。

cn-shenzhen

body

object

任意

リクエストボディ。

version

string

任意

アップグレードのターゲットバージョン。ListUpgradeReleaseVersion API を呼び出すと、利用可能なバージョンのリストを取得できます。

r5.0.0

dryRun

boolean

任意

このパラメーターは非推奨です。

true

レスポンスフィールド

フィールド

説明

object

レスポンスのデータ構造。

RequestId

string

リクエストの ID。

77B97AFB-7C9D-50FF-A72D-F13FD73E49D8

Data

object

レスポンスパラメーター。

Success

boolean

準備タスクが正常に開始されたかどうかを示します。

true

FailReason

string

準備タスクが失敗した理由。

null

ReasonKey

string

失敗の理由を識別するキー。

null

Success

boolean

API 呼び出しが成功したかどうかを示します。これはアップグレードの準備の結果を示すものではありません。

true

ErrorCode

string

リクエストが失敗した場合に返されるエラーコード。

null

ErrorMessage

string

リクエストが失敗した場合に返されるエラーメッセージ。

null

HttpStatusCode

string

HTTP ステータスコード。

200

成功レスポンス

JSONJSON

{
  "RequestId": "77B97AFB-7C9D-50FF-A72D-F13FD73E49D8",
  "Data": {
    "Success": true,
    "FailReason": "null\n",
    "ReasonKey": "null"
  },
  "Success": true,
  "ErrorCode": "null",
  "ErrorMessage": "null",
  "HttpStatusCode": "200"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。