すべてのプロダクト
Search

このプロダクト

    Auto Scaling:StartInstanceRefresh

    ドキュメントセンター

    Auto Scaling:StartInstanceRefresh

    最終更新日:Mar 25, 2025

    インスタンスリフレッシュタスクを開始します。スケーリンググループに新しいスケーリング設定を適用する場合、またはスケーリング設定で指定されたイメージを更新する場合は、StartInstanceRefresh 操作を呼び出すことができます。

    使用方法

    • スケーリンググループでは、一度に 1 つのインスタンスリフレッシュタスクしか開始できません。

    • スケーリングポリシーとして優先ポリシーを使用するスケーリンググループの Elastic Compute Service (ECS) インスタンスに対してインスタンスリフレッシュタスクを開始できます。容量が vCPU の数に基づいて測定されるスケーリンググループ、およびインスタンスの再利用モードが節約モードまたは強制リサイクルであるスケーリンググループは、StartInstanceRefresh 操作をサポートしていません。

    • インスタンスリフレッシュタスクを開始すると、スケーリングイベントは想定どおりに完了できます。スケールアウトされたインスタンスは、インスタンスリフレッシュタスクで指定された構成を使用することに注意してください。

    • StartInstanceRefresh 操作は、手動で追加されたインスタンス、およびスタンバイ状態と保護状態のインスタンスには影響しません。

    デバッグ

    OpenAPI エクスプローラーは、署名値を自動的に計算します。便宜上、OpenAPI エクスプローラーでこの操作を呼び出すことをお勧めします。 OpenAPI エクスプローラーは、さまざまな SDK の操作のサンプルコードを動的に生成します。

    リクエストパラメーター

    パラメーター

    タイプ

    必須

    例

    説明

    Action

    String

    はい

    StartInstanceRefresh

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

    RegionId

    String

    はい

    cn-hangzhou

    スケーリンググループのリージョン ID。

    ClientToken

    String

    いいえ

    123e4567-e89b-12d3-a456-42665544****

    リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。詳細については、「べき等性を確保する」をご参照ください。

    ScalingGroupId

    String

    はい

    asg-bp18p2yfxow2dloq****

    スケーリンググループの ID。

    MinHealthyPercentage

    Integer

    いいえ

    80

    インスタンスリフレッシュ中に、スケーリンググループのすべてのインスタンスに対する稼働状態のインスタンスの割合。有効な値: 0 ～ 100。デフォルト値: 80。

    MaxHealthyPercentage

    Integer

    いいえ

    100

    インスタンスリフレッシュ中に、スケーリンググループの容量の上限を超えることができるインスタンスの割合（スケーリンググループのすべてのインスタンスに対する割合）。有効な値: 100 ～ 200。デフォルト値: 120。

    説明

    MinHealthyPercentage と MaxHealthyPercentage を 100 に設定すると、Auto Scaling はインスタンスリフレッシュタスクが開始されるたびに 1 つのインスタンスの構成をリフレッシュします。

    DesiredConfiguration.ImageId

    String

    いいえ

    m-2ze8cqacj7opnf***

    イメージ ID。

    説明

    • インスタンスリフレッシュタスクが完了すると、アクティブなスケーリング設定はこのパラメーターで指定されたイメージを使用します。

    • スケーリンググループのインスタンス構成情報ソースが起動テンプレートの場合、このパラメーターを指定することはできません。

    DesiredConfiguration.ScalingConfigurationId

    String

    いいえ

    asc-2zed7lqn4ts4****

    スケーリング設定の ID。

    説明

    インスタンスリフレッシュタスクが完了すると、スケーリンググループはこのパラメーターで指定されたスケーリング設定を使用します。

    レスポンスパラメーター

    パラメーター

    タイプ

    例

    説明

    RequestId

    String

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

    リクエスト ID。

    InstanceRefreshTaskId

    String

    ir-a12ds234fasd*****

    インスタンスリフレッシュタスクの ID。

    例

    リクエストの例

    http(s)://ess.aliyuncs.com/?Action=StartInstanceRefresh
&RegionId=cn-hangzhou
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&ScalingGroupId=asg-bp18p2yfxow2dloq****
&MinHealthyPercentage=80
&MaxHealthyPercentage=100
&DesiredConfiguration={"ImageId":"m-2ze8cqacj7opnf***","ScalingConfigurationId":"asc-2zed7lqn4ts4****"}
&<共通リクエストパラメーター>

    正常なレスポンスの例

    XML 形式

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

<StartInstanceRefreshResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
    <InstanceRefreshTaskId>ir-a12ds234fasd*****</InstanceRefreshTaskId>
</StartInstanceRefreshResponse>

    JSON 形式

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "InstanceRefreshTaskId" : "ir-a12ds234fasd*****"
}

    エラーコード

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