すべてのプロダクト
Search

このプロダクト

    Auto Scaling:DescribeElasticStrength

    ドキュメントセンター

    Auto Scaling:DescribeElasticStrength

    最終更新日:May 21, 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：Ultra クラウドディスク。

    • cloud_ssd：標準 SSD。

    • cloud_essd：ESSD。

    説明

    ScalingGroupId が指定されていない場合、このパラメーターは必須です。

    string

    任意

    システムディスクのカテゴリ。有効な値：

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

    • cloud_efficiency：Ultra クラウドディスク。

    • cloud_ssd：標準 SSD。

    • cloud_essd：ESSD。

    cloud
    ScalingGroupIds

    array

    任意

    バッチ操作で照会する、1 つ以上のスケーリンググループの ID。

    string

    任意

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

    asg-bp14wlu85wrpchm0****
    SpotStrategy

    string

    任意

    インスタンスのスポット戦略。有効な値：

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

    • SpotWithPriceLimit：上限価格を指定するスポットインスタンス。

    • SpotAsPriceGo：システムが現在の市場価格で自動的に入札するスポットインスタンス。

    デフォルト値： NoSpot。

    NoSpot
    VSwitchIds

    array

    任意

    VSwitch ID のリスト。

    説明

    ScalingGroupId が指定されていない場合、このパラメーターは必須です。

    string

    任意

    VSwitch ID。

    vsw-bp1whw2u46cn8zubm****
    ImageId

    string

    任意

    インスタンスの作成に使用されるイメージの ID。

    説明

    ScalingGroupId が指定されていない場合は、ImageId、ImageName、ImageFamily のうち、少なくとも 1 つを指定する必要があります。

    centos6u5_64_20G_aliaegis****.vhd
    ImageName

    string

    任意

    イメージの名前。名前はリージョン内で一意である必要があります。ImageId を指定した場合、このパラメーターは無視されます。

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

    説明

    ScalingGroupId が指定されていない場合は、ImageId、ImageName、ImageFamily のうち、少なくとも 1 つを指定する必要があります。

    ubuntu_18_04_x64_20G_alibase_20231225.vhd
    ImageFamily

    string

    任意

    イメージファミリーの名前。このパラメーターを設定して、指定したイメージファミリーから利用可能な最新のイメージを使用してインスタンスを作成できます。ImageId を指定した場合、このパラメーターは無視されます。

    説明

    ScalingGroupId が指定されていない場合は、ImageId、ImageName、ImageFamily のうち、少なくとも 1 つを指定する必要があります。

    CentOS7
    DataDiskCategories

    array

    任意

    伸縮性強度を評価するために使用されるデータディスクカテゴリのリスト。互換性のないカテゴリがある場合、レスポンスでは不一致のカテゴリが示されます。

    説明

    ScalingGroupId が指定されていない場合に、このパラメーターを指定できます。

    string

    任意

    データディスクのカテゴリ。有効な値：

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

    • cloud_efficiency：Ultra クラウドディスク。

    • cloud_ssd：標準 SSD。

    • cloud_essd：ESSD。

    • ephemeral_ssd：ローカル SSD。

    cloud_essd
    Ipv6AddressCount

    integer

    任意

    各インスタンスに設定する IPv6 アドレスの数。指定された数の IPv6 アドレスをサポートしないインスタンスタイプでは、伸縮性強度が低下します。

    説明

    ScalingGroupId が指定されていない場合に、このパラメーターを指定できます。

    1

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答スキーマ。

    RequestId

    string

    リクエスト ID。

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

    number

    スケーリンググループの合計エラスティック強度。強度は、設定済みのすべてのインスタンスタイプとゾーンの組み合わせのスコアの合計です。各組み合わせは、リソースの可用性に基づいて 0 (低い強度) から 1 (高い強度) でスコアリングされます。

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

    1.5
    ElasticStrength

    string

    現在のスケーリンググループのエラスティック強度。有効な値：

    • Strong： エラスティック強度が高い。

    • Medium： エラスティック強度が中程度。

    • Weak： エラスティック強度が低い。

    Strong
    ResourcePools

    array<object>

    リソースプールの配列。このパラメーターは、API 呼び出しが単一のスケーリンググループを対象とする場合に返されます。

    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 の場合に返されるエラーコード。

    IMG_NOT_SUPPORTED
    Msg

    string

    エラスティック強度が 0 の場合に返されるエラーメッセージ。

    The instanceType does not support the image in the configuration.
    Status

    string

    リソースプールの可用性。有効な値：

    • Available： リソースプールを利用できます。

    • Unavailable： リソースプールを利用できません。インスタンスタイプがゾーンにデプロイされていない、在庫が不足している、またはその他の制約を満たしていない場合に発生する可能性があります。

    Available
    InventoryHealth

    object

    在庫の健全性。

    HealthScore

    integer

    ヘルススコア。

    • スコアが 5～6 の場合、供給の信頼度が高いことを示します。

    • スコアが 1～4 の場合、供給が保証されないことを示します。オンデマンド予約の作成を検討してください。

    • スコアが -3～0 の場合、供給健全性アラートを示します。別のインスタンスタイプの使用を検討してください。

    ヘルススコアは、次の式で算出されます： HealthScore = AdequacyScore + SupplyScore - HotScore。

    3
    AdequacyScore

    integer

    十分性スコア。

    有効な値： 0～3。

    3
    SupplyScore

    integer

    供給スコア。

    有効な値： 0～3。

    3
    HotScore

    integer

    ホットスコア。

    有効な値： 0～3。

    3
    ElasticStrength

    string

    リソースプールのエラスティック強度。在庫の健全性と現在の在庫状況に基づきます。有効な値：

    • Strong： エラスティック強度が高い。

    • Medium： エラスティック強度が中程度。

    • Weak： エラスティック強度が低い。

    Medium
    ElasticStrengthModels

    array<object>

    エラスティック強度の詳細の配列。このパラメーターは、API 呼び出しが複数のスケーリンググループを対象とする場合に返されます。

    array<object>

    ScalingGroupId

    string

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

    asg-wz98mnj7nblv9gc****
    ElasticStrength

    string

    現在のスケーリンググループのエラスティック強度。有効な値：

    • Strong： エラスティック強度が高い。

    • Medium： エラスティック強度が中程度。

    • Weak： エラスティック強度が低い。

    Strong
    TotalStrength

    number

    スケーリンググループの合計エラスティック強度。強度は、設定済みのすべてのインスタンスタイプとゾーンの組み合わせのスコアの合計です。各組み合わせは、リソースの可用性に基づいて 0 (低い強度) から 1 (高い強度) でスコアリングされます。

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

    1.5
    ResourcePools

    array<object>

    スケーリンググループ内のリソースプールの詳細。

    array<object>

    InstanceType

    string

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

    ecs.r7.large
    Strength

    number

    リソースプールのエラスティック強度。

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

    0.6
    ZoneId

    string

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

    cn-hangzhou-g
    VSwitchIds

    array

    リソースプールのゾーン内にある VSwitch。

    string

    VSwitch ID。

    vsw-2ze6e8p4******
    Code

    string

    エラスティック強度が 0 の場合に返されるエラーコード。

    InstanceTypesOrDiskTypesNotSupported
    Msg

    string

    エラスティック強度が 0 の場合に返されるエラーメッセージ。

    The instanceTypes or diskTypes are not supported.
    Status

    string

    リソースプールの可用性。有効な値：

    • Available： リソースプールを利用できます。

    • Unavailable： リソースプールを利用できません。インスタンスタイプがゾーンにデプロイされていない、在庫が不足している、またはその他の制約を満たしていない場合に発生する可能性があります。

    Available
    InventoryHealth

    object

    在庫の健全性。

    HealthScore

    integer

    ヘルススコア。

    • スコアが 5～6 の場合、供給の信頼度が高いことを示します。

    • スコアが 1～4 の場合、供給が保証されないことを示します。オンデマンド予約の作成を検討してください。

    • スコアが -3～0 の場合、供給健全性アラートを示します。別のインスタンスタイプの使用を検討してください。

    ヘルススコアは、次の式で算出されます： HealthScore = AdequacyScore + SupplyScore - HotScore。

    3
    AdequacyScore

    integer

    十分性スコア。

    有効な値： 0～3。

    3
    SupplyScore

    integer

    供給スコア。

    有効な値： 0～3。

    2
    HotScore

    integer

    ホットスコア。

    有効な値： 0～3。

    0
    ElasticStrength

    string

    リソースプールのエラスティック強度。在庫の健全性と現在の在庫状況に基づきます。有効な値：

    • Strong： エラスティック強度が高い。

    • Medium： エラスティック強度が中程度。

    • Weak： エラスティック強度が低い。

    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": "IMG_NOT_SUPPORTED",
      "Msg": "The instanceType does not support the image in the configuration.",
      "Status": "Available",
      "InventoryHealth": {
        "HealthScore": 3,
        "AdequacyScore": 3,
        "SupplyScore": 3,
        "HotScore": 3
      },
      "ElasticStrength": "Medium"
    }
  ],
  "ElasticStrengthModels": [
    {
      "ScalingGroupId": "asg-wz98mnj7nblv9gc****",
      "ElasticStrength": "Strong",
      "TotalStrength": 1.5,
      "ResourcePools": [
        {
          "InstanceType": "ecs.r7.large",
          "Strength": 0.6,
          "ZoneId": "cn-hangzhou-g",
          "VSwitchIds": [
            "vsw-2ze6e8p4******"
          ],
          "Code": "InstanceTypesOrDiskTypesNotSupported",
          "Msg": "The instanceTypes or diskTypes are not supported.",
          "Status": "Available",
          "InventoryHealth": {
            "HealthScore": 3,
            "AdequacyScore": 3,
            "SupplyScore": 2,
            "HotScore": 0
          },
          "ElasticStrength": "Strong"
        }
      ]
    }
  ]
}

    エラーコード

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

    変更履歴

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