ECS (Elastic Compute Service) インスタンスのプライベートプールの属性を変更します。

説明

プライベートプールは、弾力性保証または容量予約が作成された後に生成される。 The private pool is associated with information about instances that are created by using the private pool. ECSインスタンスの作成時にプライベートプールを使用するかどうかを設定して、インスタンスが柔軟性保証または容量予約に一致するようにすることができます。

  • このAPIを呼び出してインスタンスのプライベートプールの属性を変更した後、インスタンスを再起動する必要はありません。
  • 次の操作を呼び出すと、システムはインスタンスとプライベートプールを再照合します。 インスタンスがすでに指定されたプライベートプールと一致している場合、プライベートプールの容量が使い果たされているか、プライベートプールが無効であるため、操作の呼び出しが失敗する可能性があります。 呼び出しが失敗した場合は、ModifyInstanceAttachmentAttributes操作を呼び出して、プライベートプールの一致モードを [開く] に変更します。
    • StartInstance: この操作を呼び出して、停止したインスタンスをエコノミーモードで再起動します。
    • ReActivateInstances
    • ModifyInstanceChargeType
    • ModifyPrepayInstanceSpec
    • ReplaceSystemDisk

デバッグ

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

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 ModifyInstanceAttachmentAttributes

実行する操作です。 値をModifyInstanceAttachmentAttributesに設定します。

RegionId String 必須 cn-hangzhou

プライベートプールのリージョンID。 DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。

InstanceId String 必須 i-bp67acfmxazb4 ****

プライベートプールの属性を変更するインスタンスのID。

PrivatePoolOptions.MatchCriteria String 必須 オープン

プライベートプールのマッチモード。 設定可能な値は以下のとおりです。

  • オープン: オープンプライベートプール。 システムは、開いているプライベートプールとインスタンスを照合します。
  • Target: 指定されたプライベートプール。 You must use PrivatePoolOptions.Id to specify the ID of a private pool.
  • なし: プライベートプールはありません。 インスタンスは通常、プライベートプールを使用せずに起動します。
PrivatePoolOptions.Id String 任意 eap-bp67acfmxazb4 ****

プライベートプールのID。 プライベートプールを生成する弾力性保証または容量予約のIDに値を設定します。

  • This parameter is required when PrivatePoolOptions.MatchCriteria is set to Target.
  • PrivatePoolOptions.MatchCriteriaがOpenまたはNoneに設定されている場合、このパラメーターは空である必要があります。

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

リクエストの ID です。

例

リクエストの例

https://ecs.aliyuncs.com/?Action=ModifyInstanceAttachmentAttributes
&RegionId=cn-hangzhou
&InstanceId=i-bp67acfmxazb4 ****
&PrivatePoolOptions。MatchCriteria=オープン
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

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

<ModifyInstanceAttachmentAttributesResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</ModifyInstanceAttachmentAttributesResponse>

JSON 形式 

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
400 MissingParameter.RegionId 指定されたRegionIdはnullではありません。 必要なRegionIdパラメーターが指定されていない場合に返されるエラーメッセージ。
500 InternalError The request processing has failed due to some unknown error, exception or failure. 内部エラーが発生した場合に返されるエラーメッセージです。 しばらくしてから再試行します。 エラーが解決しない場合は、チケットを起票してください。

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