インスタンスをデプロイメントセットに追加するか、インスタンスをあるデプロイメントセットから別のデプロイメントセットに移動します。

リクエストパラメーター

名前 型 必須かどうか 説明
Action String  はい このインターフェイスの名前。値：ModifyInstanceDeployment。
RegionId String はい デプロイメントセットとインスタンスが配置されているリージョン ID。 詳細については、 DescribeRegions を呼び出して最新のリージョンリストを取得してください。
DeploymentSetId String はい デプロイメントセット ID。
InstanceId String はい インスタンス ID。インスタンスは Stopped ステータスまたは Running ステータスでなければなりません。
Force Boolean いいえ インスタンスが存在するホストを強制的に変更するかどうか。
  • True： インスタンスが新しいホストに移動することを許可します。実行中のインスタンス、 停止済みサブスクリプションインスタンス、停止済み 従量課金インスタンスを再起動できます。
  • False (デフォルト) ：インスタンスのホストは変更できません。システムはデプロイメントセットを現在のホストにのみ接続します。これにより、デプロイメントセットの置き換えが失敗する可能性があります。

レスポンスパラメーター

すべてが共通のレスポンスパラメーターです。「共通レスポンスパラメーター」 をご参照ください。

例

リクエストの例 
  1. https://ecs.aliyuncs.com/?Action=ModifyInstanceDeployment&RegionId=cn-hangzhou&DeploymentSetId=ds-bp13v7bjnj9gisnlo1&<共通リクエストパラメーター>
レスポンスの例

XML 形式

  1. <ModifyInstanceDeploymentResponse>    <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId></ModifyInstanceDeploymentResponse>
JSON 形式 
  1. {    “RequestId”: “04F0F334-1335-436C-A1D7-6C044FE73368”}

エラーコード

このインターフェイスに固有のエラーコードは次の通りです。詳しくは、 「API Error Center」 をご参照ください。

エラーコード エラーメッセージ HTTP ステータスコード 説明
DeploymentSet.InvalidId The specified Deployment Set id doesn’t exist. 400 指定された DeploymentSetId が存在しません。
DeploymentSet.InstanceLimitExceeded The number of instances on the specified Deployment Set has reached the limit. 403 指定されたデプロイメントセット内のインスタンス数が最大数に達しました。
IncorrectInstanceStatus The current status of the resource does not support this operation. 403 リソースの現在のステータスはこの操作をサポートしていません。
DeploymentSet.ModificationFailed The modification of deployment set is currently impossible. 403 デプロイメントセットは調整できません。