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

:UpdateInstanceImage

最終更新日:Mar 21, 2026

クラウドフォンマトリックスインスタンスのイメージを変更します。インスタンスのイメージは、インスタンスが 実行中停止済み、またはイメージ更新失敗状態の場合にのみ変更できます。ターゲットイメージの GPU ベンダーは、インスタンスが実行されているサーバーの GPU ベンダーと一致している必要があります。例えば、Android 10 から Android 12 のように、メジャーバージョンをまたいでイメージを変更する場合、システムはインスタンス上のすべてのユーザーデータを自動的にクリアします。この場合、この操作は、イメージの変更後にインスタンスをリセットする操作と同等です。

操作説明

この機能は Alibaba Cloud 国際サイト (www.alibabacloud.com) では利用できません。

今すぐお試しください

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

テスト

RAM 認証

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

リクエスト構文

POST  HTTP/1.1

リクエストパラメーター

パラメーター

必須 / 任意

説明

InstanceIdList

array

任意

インスタンス ID のリスト。

string

任意

インスタンスの ID。

acp-dvbhknfasf123****

ImageId

string

任意

ターゲットイメージの ID。DescribeImageList を呼び出して、クラウドフォンで利用可能なイメージのリストをクエリできます。

imgc-075cllfeuazh0****

Reset

boolean

任意

インスタンスをリセットするかどうかを指定します。このパラメーターを true に設定すると、システムはインスタンス上のすべてのユーザーデータをクリアします。

false

IgnoreParamValidation

boolean

任意

レスポンスフィールド

フィールド

説明

object

返されるデータ。

RequestId

string

リクエスト ID。

1A923337-44D9-5CAD-9A53-95084BD4****

Tasks

object

ParentTaskId

string

t-xxxx

ChildTasks

array<object>

object

InstanceId

string

acp-xxxx

TaskId

string

t-xxxx

TaskId

string

タスク ID。

t-1ljew7on6ay0j****

成功レスポンス

JSONJSON

{
  "RequestId": "1A923337-44D9-5CAD-9A53-95084BD4****",
  "Tasks": {
    "ParentTaskId": "t-xxxx",
    "ChildTasks": [
      {
        "InstanceId": "acp-xxxx",
        "TaskId": "t-xxxx"
      }
    ]
  },
  "TaskId": "t-1ljew7on6ay0j****"
}

エラーコード

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

変更履歴

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