DescribeElasticStrength - 查詢伸縮組的彈性強度

更新時間:
Copy as MD

伸縮組配置的有效性很大程度決定了擴容過程的成功率。Auto Scaling通過彈性強度描述伸縮配置的有效性,讓配置的優良程度量化,協助使用者針對性的最佳化伸縮配置。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ess:DescribeElasticStrength

get

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

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 雲端硬碟。

說明

當不指定伸縮組 ID 時,需要傳入此參數。

string

系統硬碟的多磁碟類型。取值範圍:

  • cloud:普通雲端硬碟。

  • cloud_efficiency:高效雲端硬碟。

  • cloud_ssd:SSD 雲端硬碟。

  • cloud_essd:ESSD 雲端硬碟。

cloud

ScalingGroupIds

array

批量查詢時的查詢伸縮組的 ID 列表。

string

伸縮組的 ID。

asg-bp14wlu85wrpchm0****

SpotStrategy

string

執行個體的搶佔策略。取值範圍:

  • NoSpot:正常隨用隨付執行個體。

  • SpotWithPriceLimit:設定上限價格的搶佔式執行個體。

  • SpotAsPriceGo:系統自動出價,跟隨當前市場實際價格的搶佔式執行個體。

預設值:NoSpot。

NoSpot

VSwitchIds

array

指定多個交換器 ID。

說明

當不指定伸縮組 ID 時,需要傳入此參數。

string

交換器 ID。

vsw-bp1whw2u46cn8zubm****

ImageId

string

鏡像檔案 ID,自動建立執行個體時使用的鏡像資源。

說明

當不指定伸縮組 ID 時,需要至少指定 ImageId、ImageName、ImageFamily 中的一個。

centos6u5_64_20G_aliaegis****.vhd

ImageName

string

鏡像檔案名稱,同一個地區內鏡像名稱唯一。如果設定了 ImageId,ImageName 將被忽略。

不支援通過 ImageName 設定鏡像市場鏡像。

說明

當不指定伸縮組 ID 時,需要至少指定 ImageId、ImageName、ImageFamily 中的一個。

ubuntu_18_04_x64_20G_alibase_20231225.vhd

ImageFamily

string

鏡像族系名稱,通過設定該參數來擷取當前鏡像族系內最新的可用鏡像,用於建立執行個體。如果已經設定了參數 ImageId,則不能設定該參數。

說明

當不指定伸縮組 ID 時,需要至少指定 ImageId、ImageName、ImageFamily 中的一個。

CentOS7

DataDiskCategories

array

查詢指定了多種資料盤類型時的彈性強度,當存在資料盤類型不符時,查詢結果中會返回具體的不匹配磁碟類型。

說明

當不指定伸縮組 ID 時,可以傳入此參數。

string

資料盤類型。可能值:

  • cloud:普通雲端硬碟

  • cloud_efficiency:高效雲端硬碟

  • cloud_ssd:SSD 雲端硬碟

  • cloud_essd:ESSD 雲端硬碟

  • ephemeral_ssd:本地 SSD 盤

cloud_essd

Ipv6AddressCount

integer

IPv6 地址數。當執行個體規格不滿足 IPv6 地址數量要求時,會導致彈性強度差。

說明

當不指定伸縮組 ID 時,可以傳入此參數。

1

返回參數

名稱

類型

描述

樣本值

object

Schema of Response

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

資源集區的可用性區域中的交換器。

string

交換器 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>

批量查詢伸縮組時的彈性強度。

array<object>

ScalingGroupId

string

伸縮組 ID。

asg-wz98mnj7nblv9gc****

ElasticStrength

string

當前伸縮組的彈性強度。可能值:

  • Strong:彈性強度高。

  • Medium:彈性強度中。

  • Weak:彈性強度弱。

Strong

TotalStrength

number

當前伸縮組的彈性強度。每個執行個體規格+可用性區域的組合根據供應情況得分為 0 到 1 分,其中 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

資源集區的可用性區域中的交換器。

string

交換器 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

樣本

正常返回樣本

JSON格式

{
  "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"
        }
      ]
    }
  ]
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情