すべてのプロダクト
Search

このプロダクト

    Auto Scaling:DescribeElasticStrength

    ドキュメントセンター

    Auto Scaling:DescribeElasticStrength

    最終更新日:Sep 10, 2026

    スケーリンググループ構成の有効性は、スケールアウトオペレーションの成功レートを大きく左右します。Auto Scaling は弾力性強度を使用してスケーリング設定の有効性を記述し、構成品質を定量化して、スケーリング設定の最適化を支援します。

    今すぐお試しください

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

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    ess:DescribeElasticStrength

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

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

    cn-qingdao
    ScalingGroupId

    string

    任意

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

    asg-bp18p2yfxow2dloq****
    InstanceTypes

    array

    任意

    ECS インスタンスのインスタンスタイプのコレクション。指定した場合、このパラメーターはスケーリング設定のインスタンスタイプを上書きします。

    string

    任意

    ECS インスタンスのインスタンスタイプ。

    ecs.g6.large
    PriorityStrategy

    string

    任意

    説明

    このパラメーターは非推奨です。代わりに SpotStrategy を使用してください。

    従量課金インスタンスのプリエンプションポリシー。指定した場合、このパラメーターはスケーリンググループに設定されたプリエンプションポリシーを上書きします。有効な値:

    • NoSpot: 通常の従量課金インスタンス。

    • SpotWithPriceLimit: 最大値幅制限付きのスポットインスタンス。

    • SpotAsPriceGo: 現在の市場レートで課金されるスポットインスタンス。

    デフォルト値: NoSpot。

    NoSpot
    SystemDiskCategories

    array

    任意

    システムクラウドディスクタイプ。指定した場合、このパラメーターはスケーリング設定のシステムクラウドディスクタイプを上書きします。有効な値:

    • cloud: ベーシッククラウドディスク。

    • cloud_efficiency: ウルトラクラウドディスク。

    • cloud_ssd: 標準 SSD。

    • cloud_essd: ESSD (エンタープライズ SSD)。

    説明

    スケーリンググループ ID を指定しない場合、このパラメーターを指定する必要があります。

    string

    任意

    システムクラウドディスクタイプ。有効な値:

    • cloud: ベーシッククラウドディスク。

    • cloud_efficiency: ウルトラクラウドディスク。

    • cloud_ssd: 標準 SSD。

    • cloud_essd: ESSD (エンタープライズ SSD)。

    cloud
    ScalingGroupIds

    array

    任意

    バッチクエリ用のスケーリンググループの ID。

    string

    任意

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

    asg-bp14wlu85wrpchm0****
    SpotStrategy

    string

    任意

    インスタンスのプリエンプションポリシー。有効な値:

    • NoSpot: 通常の従量課金インスタンス。

    • SpotWithPriceLimit: 最大値幅制限付きのスポットインスタンス。

    • SpotAsPriceGo: 現在の市場レートで課金されるスポットインスタンス。

    デフォルト値: NoSpot。

    NoSpot
    VSwitchIds

    array

    任意

    複数の vSwitch の ID。

    説明

    スケーリンググループ ID を指定しない場合、このパラメーターを指定する必要があります。

    string

    任意

    複数の vSwitch の ID。

    説明

    スケーリンググループ ID を指定しない場合、このパラメーターを指定する必要があります。

    vsw-bp1whw2u46cn8zubm****
    ImageId

    string

    任意

    イメージの ID。イメージリソースはインスタンスの自動作成に使用されます。

    説明

    スケーリンググループ ID を指定しない場合、ImageId、ImageName、ImageFamily のいずれか 1 つ以上を指定する必要があります。

    centos6u5_64_20G_aliaegis****.vhd
    ImageName

    string

    任意

    イメージの名前。イメージ名はリージョン内で一意です。ImageId が指定されている場合、ImageName は無視されます。

    ImageName を使用して Alibaba Cloud マーケットプレイスのイメージを指定することはできません。

    説明

    スケーリンググループ ID を指定しない場合、ImageId、ImageName、ImageFamily のいずれか 1 つ以上を指定する必要があります。

    ubuntu_18_04_x64_20G_alibase_20231225.vhd
    ImageFamily

    string

    任意

    イメージ ファミリーの名前。このパラメーターを指定すると、指定されたイメージ ファミリー内の最新の利用可能なイメージがインスタンスの作成に使用されます。ImageId が既に指定されている場合、このパラメーターは指定できません。

    説明

    スケーリンググループ ID を指定しない場合、ImageId、ImageName、ImageFamily のいずれか 1 つ以上を指定する必要があります。

    CentOS7
    DataDiskCategories

    array

    任意

    複数のデータクラウドディスクタイプが指定された場合の弾力性強度。データクラウドディスクタイプが一致しない場合、一致しなかった特定のディスクタイプがクエリ結果に返されます。

    説明

    スケーリンググループ ID を指定しない場合、このパラメーターを指定できます。

    string

    任意

    データクラウドディスクタイプ。有効な値:

    • cloud: ベーシッククラウドディスク

    • cloud_efficiency: ウルトラクラウドディスク

    • cloud_ssd: 標準 SSD

    • cloud_essd: ESSD (エンタープライズ SSD)

    • ephemeral_ssd: ローカル SSD。

    cloud_essd
    Ipv6AddressCount

    integer

    任意

    IPv6 アドレスの数。インスタンスタイプが IPv6 アドレス数の要件を満たさない場合、弾力性強度が低下します。

    説明

    スケーリンググループ ID を指定しない場合、このパラメーターを指定できます。

    1

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスのスキーマ。

    RequestId

    string

    リクエスト ID。

    73469C7-AA6F-4DC5-B3DB-A3DC0DE3****
    TotalStrength

    number

    スケーリンググループの弾力性強度。インスタンスタイプとゾーンの各組み合わせは、供給状況に基づいて 0 から 1 のスコアが付けられます。0 は弾力性強度が低いことを示し、1 は弾力性強度が高いことを示します。すべてのインスタンスタイプとゾーンの組み合わせのスコアの合計が、スケーリンググループの弾力性強度を表します。

    警告 このパラメーターは非推奨です。

    1.5
    ElasticStrength

    string

    現在のスケーリンググループの弾力性強度。有効な値:

    • Strong: 弾力性強度が高い。

    • Medium: 弾力性強度が中間。

    • Weak: 弾力性強度が低い。

    Strong
    ResourcePools

    array<object>

    単一のスケーリンググループをクエリする場合の弾力性強度。

    array<object>

    Strength

    number

    リソースプールの弾力性強度。

    0.6
    InstanceType

    string

    リソースプールのインスタンスタイプ。

    ecs.c7t.xlarge
    ZoneId

    string

    リソースプールのゾーン ID。

    cn-hangzhou-g
    VSwitchIds

    array

    リソースプールのゾーン内の vSwitch。

    string

    vSwitch ID。

    vsw-2ze0uc933kantv******
    Code

    string

    弾力性強度が 0 の場合の理由 (エラーコード)。

    InstanceTypesOrDiskTypesNotSupported
    Msg

    string

    弾力性強度が 0 の場合の理由 (エラーの説明)。

    The instanceTypes or diskTypes are not supported.
    Status

    string

    リソースプールが利用可能かどうかを示します。有効な値:

    • Available: 利用可能。

    • Unavailable: 利用不可。制約違反、未デプロイのインスタンスタイプ、または在庫切れのインスタンスタイプにより、インスタンスタイプが利用不可になる場合があります。

    Available
    InventoryHealth

    object

    在庫ヘルス情報。

    HealthScore

    integer

    Inventory health score.

    • Scores of 5–6 indicate very high supply certainty.

    • Scores of 1–4 indicate uncertain supply; on-demand reservation is recommended.

    • Scores of -3–0 indicate a warning for inventory health; changing the instance type is recommended.

    Calculation Formula: HealthScore (Inventory Health Score) = AdequacyScore (Adequacy) + SupplyScore (Replenishment Capability) - HotScore (Popularity).

    3
    AdequacyScore

    integer

    Adequacy.

    Possible values: 0–3.

    3
    SupplyScore

    integer

    Replenishment capability.

    Possible values: 0–3.

    3
    HotScore

    integer

    Popularity.

    Possible values: 0–3.

    3
    ElasticStrength

    string

    現在のリソースプールの弾力性強度。リソースプールの在庫ヘルスと現在の在庫状況の両方を考慮しています。有効な値:

    • Strong: 弾力性強度が高い。

    • Medium: 弾力性強度が中間。

    • Weak: 弾力性強度が低い。

    Medium
    ElasticStrengthModels

    array<object>

    スケーリンググループをバッチでクエリする場合の弾力性強度。

    array<object>

    ScalingGroupId

    string

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

    asg-wz98mnj7nblv9gc****
    ElasticStrength

    string

    現在のスケーリンググループの弾力性強度。有効な値:

    • Strong: 弾力性強度が高い。

    • Medium: 弾力性強度が中間。

    • Weak: 弾力性強度が低い。

    Strong
    TotalStrength

    number

    現在のスケーリンググループの弾力性強度。インスタンスタイプとゾーンの各組み合わせは、供給状況に基づいて 0 から 1 のスコアが付けられます。0 は弾力性強度が低いことを示し、1 は弾力性強度が高いことを示します。すべてのインスタンスタイプとゾーンの組み合わせのスコアの合計が、スケーリンググループの弾力性強度を表します。

    警告 このパラメーターは非推奨です。

    5
    ResourcePools

    array<object>

    各リソースプールの弾力性強度情報。

    array<object>

    InstanceType

    string

    Instance type of the resource pool.

    ecs.r7.large
    Strength

    number

    The elasticity strength of the resource pool.

    警告 This field is deprecated.

    0.6
    ZoneId

    string

    The zone ID of the resource pool.

    cn-hangzhou-g
    VSwitchIds

    array

    The vSwitches in the zone of the resource pool.

    string

    The vSwitch ID.

    vsw-2ze6e8p4aid08lymlsguv
    Code

    string

    Reason (error code) when elasticity strength is 0.

    InstanceTypesOrDiskTypesNotSupported
    Msg

    string

    The reason (fault description) when the elasticity strength is 0.

    The instanceTypes or diskTypes are not supported.
    Status

    string

    Whether the resource pool is active. Possible values:

    • Available: active.

    • Unavailable: not active. A constraint may have failed, the specification may not be deployed, or the specification may have no inventory.

    Available
    InventoryHealth

    object

    Inventory health degree.

    HealthScore

    integer

    Inventory health score.

    • 5–6 points: Indicates very high supply certainty.

    • 1–4 points: Indicates uncertain supply; on-demand reservation is recommended.

    • -3–0 points: Indicates a warning in supply health; changing the instance type is recommended.

    Calculation Formula: HealthScore (inventory health score) = AdequacyScore (adequacy degree) + SupplyScore (supply capability) – HotScore (hotness degree).

    3
    AdequacyScore

    integer

    Adequacy degree.

    Possible values: 0–3.

    3
    SupplyScore

    integer

    Supply capability.

    Possible values: 0–3.

    2
    HotScore

    integer

    Hotness degree.

    Possible values: 0–3.

    0
    ElasticStrength

    string

    Strong

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "73469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "TotalStrength": 1.5,
  "ElasticStrength": "Strong",
  "ResourcePools": [
    {
      "Strength": 0.6,
      "InstanceType": "ecs.c7t.xlarge",
      "ZoneId": "cn-hangzhou-g",
      "VSwitchIds": [
        "vsw-2ze0uc933kantv******"
      ],
      "Code": "InstanceTypesOrDiskTypesNotSupported",
      "Msg": "The instanceTypes or diskTypes are not supported.",
      "Status": "Available",
      "InventoryHealth": {
        "HealthScore": 3,
        "AdequacyScore": 3,
        "SupplyScore": 3,
        "HotScore": 3
      },
      "ElasticStrength": "Medium"
    }
  ],
  "ElasticStrengthModels": [
    {
      "ScalingGroupId": "asg-wz98mnj7nblv9gc****",
      "ElasticStrength": "Strong",
      "TotalStrength": 5,
      "ResourcePools": [
        {
          "InstanceType": "ecs.r7.large",
          "Strength": 0.6,
          "ZoneId": "cn-hangzhou-g",
          "VSwitchIds": [
            "vsw-2ze6e8p4aid08lymlsguv"
          ],
          "Code": "InstanceTypesOrDiskTypesNotSupported",
          "Msg": "The instanceTypes or diskTypes are not supported.",
          "Status": "Available",
          "InventoryHealth": {
            "HealthScore": 3,
            "AdequacyScore": 3,
            "SupplyScore": 2,
            "HotScore": 0
          },
          "ElasticStrength": "Strong"
        }
      ]
    }
  ]
}

    エラーコード

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

    変更履歴

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