この操作を呼び出して、自動プロビジョニンググループの設定を変更できます。

この操作を呼び出す前に、次の点に注意してください。

  • 自動プロビジョニンググループの容量、または容量関連の設定を変更した場合、変更後、グループはスケジューリングタスクを 1 回実行します。
  • グループの削除中は、自動プロビジョニンググループを変更できません。

デバッグ

API の使用を簡単にするため、Alibaba Cloud では、OpenAPI Explorer を提供しています。 OpenAPI Explorer を使用して、API の検索、API の呼び出し、および SDK サンプルコードの動的な生成を行うことができます。

リクエストパラメーター

パラメーター データ型 必須/任意 例 説明
RegionId String 必須 cn-hangzhou

変更する自動プロビジョニンググループのリージョン ID。
Action String 任意 ModifyAutoProvisioningGroup

実行する操作。 このパラメーターを ModifyAutoProvisioningGroup に設定します。

AutoProvisioningGroupId String 任意 apg-uf6jel2bbl62wh13****

変更する自動プロビジョニンググループの ID。
DefaultTargetCapacityType String 任意 PayAsYouGo

補足インスタンスのタイプ。 PayAsYouGoTargetCapacity と SpotTargetCapacity の合計値が TotalTargetCapacity の値より小さい場合、自動プロビジョニンググループは、容量要件を満たすために、指定されたタイプのインスタンスを作成します。 有効な値：

  • PayAsYouGo：従量課金インスタンス。
  • Spot：プリエンプティブルインスタンス。
ExcessCapacityTerminationPolicy String 任意 no-termination

ターゲット容量を超えた場合の、過剰なプリエンプティブルインスタンスの自動プロビジョニンググループのシャットダウンポリシー。 有効な値：

  • no-termination：過剰なプリエンプティブルインスタンスはシャットダウンされません。
  • termination： 過剰なプリエンプティブルインスタンスはシャットダウンされます。 これらのシャットダウンインスタンスで実行されるアクションは、SpotInstanceInterruptionBehavior パラメーターで指定されます。
注 SpotInstanceInterruptionBehavior パラメーターは、自動プロビジョニンググループの作成プロセス中に設定され、変更できません。 詳細については、「CreateAutoProvisioningGroup」をご参照ください。
MaxSpotPrice Float 任意 8

自動プロビジョニンググループのプリエンプティブルインスタンスのグローバル最高価格。 MaxSpotPrice と LaunchTemplateConfig.N.MaxPrice パラメータが両方とも指定されている場合、最高価格は、2 つのうちの低い値です。

注 LaunchTemplateConfig.N.MaxPrice パラメーターは、自動プロビジョニンググループの作成プロセス中に設定され、変更できません。 詳細については、 「CreateAutoProvisioningGroup」をご参照ください。
PayAsYouGoTargetCapacity String 任意 5

自動プロビジョニンググループの従量課金インスタンスのターゲット容量。
SpotTargetCapacity String 任意 5

自動プロビジョニンググループのプリエンプティブルインスタンスのターゲット容量。
TerminateInstancesWithExpiration Boolean 任意 false

自動プロビジョニンググループの有効期限が切れた場合のプリエンプティブルインスタンスのシャットダウンポリシー。 有効な値：

  • true： プリエンプティブルインスタンスをシャットダウンします。 これらのシャットダウンインスタンスで実行される操作は、SpotInstanceInterruptionBehavior パラメーターで指定されます。
  • false： プリエンプティブルインスタンスをシャットダウンしません。
注 SpotInstanceInterruptionBehavior パラメーターは、自動プロビジョニンググループの作成プロセス中に設定され、変更できません。 詳細については、「CreateAutoProvisioningGroup」をご参照ください。
TotalTargetCapacity String 任意 10

自動プロビジョニンググループの合計容量。 容量は、次の 3 つから構成されます。

  • PayAsYouGoTargetCapacity パラメーターで指定された従量課金インスタンスのターゲット容量
  • SpotTargetCapacity パラメーターで指定されたプリエンプティブルインスタンスのターゲット容量
  • PayAsYouGoTargetCapacity および SpotTargetCapacity 以外の追加の容量

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String B48A12CD-1295-4A38-A8F0-0E92C937****

リクエストの ID。

例

リクエストの例


http(s)://ecs.aliyuncs.com/? Action=ModifyAutoProvisioningGroup
&RegionId=cn-hangzhou
&AutoProvisioningGroupId=apg-uf6jel2bbl62wh13****
&<Common request parameters>

レスポンスの成功例

XML 形式 

<ModifyAutoProvisioningGroupResponse>
  <RequestId>928E2273-5715-46B9-A730-238DC996****</RequestId>
</ModifyAutoProvisioningGroupResponse>

JSON 形式 

{
	"RequestId":"B48A12CD-1295-4A38-A8F0-0E92C937****"
}

エラーコード

HTTP ステータスコード エラーコード 説明 エラーメッセージ
403 Forbidden.RAM User not authorized to operate on the specified resource, or this API doesn't support RAM. RAM ユーザーが許可されていない場合に返されるエラーメッセージ。

エラーコードの表示