DescribeScalingActivities
通過(guò)API DescribeScalingActivities查看伸縮活動(dòng)的詳情,了解通過(guò)定時(shí)任務(wù)、報(bào)警任務(wù)或手動(dòng)執(zhí)行伸縮規(guī)則等方式觸發(fā)伸縮活動(dòng)的結(jié)果。例如,您可以在伸縮活動(dòng)詳情頁(yè)查看到伸縮活動(dòng)的狀態(tài)、活動(dòng)起因、變化后總實(shí)例數(shù)等信息。
接口說(shuō)明
- 查詢(xún)時(shí)可以指定伸縮組ID來(lái)查詢(xún)?cè)撋炜s組下的所有伸縮活動(dòng)。
- 查詢(xún)時(shí)可以通過(guò)伸縮活動(dòng)的狀態(tài)來(lái)過(guò)濾查詢(xún)結(jié)果。
- 可以查詢(xún)30日內(nèi)的伸縮活動(dòng)。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
請(qǐng)求參數(shù)
名稱(chēng) |
類(lèi)型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | DescribeScalingActivities | 系統(tǒng)規(guī)定參數(shù)。取值:DescribeScalingActivities。 |
RegionId | String | 是 | cn-hangzhou | 伸縮活動(dòng)所屬伸縮組的地域ID。 |
PageNumber | Integer | 否 | 1 | 伸縮活動(dòng)列表的頁(yè)碼,起始值:1。 默認(rèn)值:1。 |
PageSize | Integer | 否 | 10 | 分頁(yè)查詢(xún)時(shí)設(shè)置的每頁(yè)行數(shù),最大值:50。 默認(rèn)值:10。 |
ScalingGroupId | String | 否 | asg-bp18p2yfxow2dloq**** | 伸縮組的ID。 說(shuō)明 調(diào)用該API時(shí), ScalingGroupId 和ScalingActivityId.N 參數(shù)必須二選一進(jìn)行配置,如果兩個(gè)參數(shù)同時(shí)都不配置,則會(huì)報(bào)錯(cuò)。 |
StatusCode | String | 否 | Successful | 伸縮活動(dòng)的狀態(tài)。取值范圍:
|
ScalingActivityId.N | String | 否 | asa-bp161xudmuxdzofe**** | 待查詢(xún)伸縮活動(dòng)的ID。 說(shuō)明 調(diào)用該API時(shí), ScalingGroupId 和ScalingActivityId.N 參數(shù)必須二選一進(jìn)行配置,如果兩個(gè)參數(shù)同時(shí)都不配置,則會(huì)報(bào)錯(cuò)。 |
返回?cái)?shù)據(jù)
名稱(chēng) |
類(lèi)型 |
示例值 |
描述 |
RequestId | String | CC107349-57B7-4405-B1BF-9BF5AF7F**** | 請(qǐng)求ID。 |
PageNumber | Integer | 1 | 當(dāng)前頁(yè)碼。 |
PageSize | Integer | 10 | 每頁(yè)行數(shù)。 |
TotalCount | Integer | 1 | 伸縮活動(dòng)總數(shù)。 |
ScalingActivities | Array of ScalingActivity | 伸縮活動(dòng)信息組成的集合。 |
|
ScalingActivity | |||
Progress | Integer | 100 | 伸縮活動(dòng)的運(yùn)行進(jìn)度。 |
ScalingInstanceNumber | Integer | 1 |
|
AttachedCapacity | String | 0 | 執(zhí)行完伸縮活動(dòng)后,伸縮組中用戶(hù)手動(dòng)添加的實(shí)例的總數(shù)。 |
TotalCapacity | String | 2 | 執(zhí)行完伸縮活動(dòng)后,伸縮組中實(shí)例的總數(shù)。 |
ScalingGroupId | String | asg-bp18p2yfxow2dloq**** | 伸縮組的ID。 |
AutoCreatedCapacity | String | 2 | 執(zhí)行完伸縮活動(dòng)后,伸縮組中由伸縮組負(fù)責(zé)自動(dòng)創(chuàng)建的實(shí)例的總數(shù)。 |
EndTime | String | 2020-09-10T09:54Z | 伸縮活動(dòng)的結(jié)束時(shí)間。 |
StartTime | String | 2020-09-10T09:54Z | 伸縮活動(dòng)的開(kāi)始時(shí)間。 |
Description | String | Add \"1\" ECS instance | 伸縮活動(dòng)的描述信息。 |
StatusCode | String | Successful | 伸縮活動(dòng)的狀態(tài)。可能值:
|
Cause | String | A user requests to execute scaling rule \"asr-bp12tcnol686y1ik****\", changing the Total Capacity from \"1\" to \"2\". | 觸發(fā)伸縮活動(dòng)的原因。 |
ScalingActivityId | String | asa-bp161xudmuxdzofe**** | 伸縮活動(dòng)的ID。 |
StatusMessage | String | \"1\" ECS instances are added | 伸縮活動(dòng)的狀態(tài)信息。 |
CreatedCapacity | Integer | 1 | 當(dāng)前伸縮活動(dòng)新建的實(shí)例數(shù)量。 |
DestroyedCapacity | Integer | 1 | 當(dāng)前伸縮活動(dòng)釋放的實(shí)例數(shù)量。 |
StartedCapacity | Integer | 1 | 當(dāng)前伸縮活動(dòng)從停機(jī)不收費(fèi)狀態(tài)啟動(dòng)的實(shí)例數(shù)量。 |
StoppedCapacity | Integer | 1 | 當(dāng)前伸縮活動(dòng)進(jìn)入停機(jī)不收費(fèi)狀態(tài)的實(shí)例數(shù)量。 |
CreatedInstances | Array of String | [ "i-abc1", "i-abc2" ] | 當(dāng)前伸縮活動(dòng)新建實(shí)例列表。 |
DestroyedInstances | Array of String | [ "i-abc1", "i-abc2" ] | 當(dāng)前伸縮活動(dòng)釋放實(shí)例列表。 |
StartedInstances | Array of String | [ "i-abc1", "i-abc2" ] | 當(dāng)前伸縮活動(dòng)啟動(dòng)的停機(jī)不收費(fèi)實(shí)例列表。 |
StoppedInstances | Array of String | [ "i-abc1", "i-abc2" ] | 當(dāng)前伸縮活動(dòng)進(jìn)入停機(jī)不收費(fèi)狀態(tài)實(shí)例列表。 |
ErrorCode | String | OperationDenied.NoStock | 伸縮活動(dòng)失敗時(shí)的錯(cuò)誤碼。 |
ErrorMessage | String | The specified ECS resource is out of stock in this region. Please try again later. | 伸縮活動(dòng)失敗時(shí)的錯(cuò)誤信息。 |
Detail | String | "new ECS instances "i-j6c8ilerw, i-j6c8iler4mx" are created." | 伸縮活動(dòng)詳細(xì)信息。 |
TriggerSourceType | String | Api | 伸縮活動(dòng)觸發(fā)源類(lèi)型。可能值:
|
TriggerSourceId | String | 2346366580***** | 伸縮活動(dòng)觸發(fā)源ID。可能值:
|
LifecycleHookContext | Object | 生命周期掛鉤上下文信息。 |
|
DisableLifecycleHook | Boolean | false | 伸縮活動(dòng)是否禁用所有生命周期掛鉤。可能值:
|
IgnoredLifecycleHookIds | Array of String | ash-bp14zolna43z266bq*** | 伸縮活動(dòng)禁用的生命周期掛鉤ID列表。 |
ActivityMetadata | String | {\"goatscaler.io/managed\":\"true\"} | 伸縮活動(dòng)的元數(shù)據(jù)。 |
示例
請(qǐng)求示例
http(s)://ess.aliyuncs.com/?Action=DescribeScalingActivities
&RegionId=cn-hangzhou
&PageNumber=1
&PageSize=10
&ScalingGroupId=asg-bp18p2yfxow2dloq****
&StatusCode=Successful
&ScalingActivityId=["asa-bp161xudmuxdzofe****"]
&公共請(qǐng)求參數(shù)
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeScalingActivitiesResponse>
<RequestId>CC107349-57B7-4405-B1BF-9BF5AF7F****</RequestId>
<PageNumber>1</PageNumber>
<PageSize>10</PageSize>
<TotalCount>1</TotalCount>
<ScalingActivities>
<Progress>100</Progress>
<ScalingInstanceNumber>1</ScalingInstanceNumber>
<AttachedCapacity>0</AttachedCapacity>
<TotalCapacity>2</TotalCapacity>
<ScalingGroupId>asg-bp18p2yfxow2dloq****</ScalingGroupId>
<AutoCreatedCapacity>2</AutoCreatedCapacity>
<EndTime>2020-09-10T09:54Z</EndTime>
<StartTime>2020-09-10T09:54Z</StartTime>
<Description>Add \"1\" ECS instance</Description>
<StatusCode>Successful</StatusCode>
<Cause>A user requests to execute scaling rule \"asr-bp12tcnol686y1ik****\", changing the Total Capacity from \"1\" to \"2\".</Cause>
<ScalingActivityId>asa-bp161xudmuxdzofe****</ScalingActivityId>
<StatusMessage>\"1\" ECS instances are added</StatusMessage>
<CreatedCapacity>1</CreatedCapacity>
<DestroyedCapacity>1</DestroyedCapacity>
<StartedCapacity>1</StartedCapacity>
<StoppedCapacity>1</StoppedCapacity>
<CreatedInstances>[ "i-abc1", "i-abc2" ]</CreatedInstances>
<DestroyedInstances>[ "i-abc1", "i-abc2" ]</DestroyedInstances>
<StartedInstances>[ "i-abc1", "i-abc2" ]</StartedInstances>
<StoppedInstances>[ "i-abc1", "i-abc2" ]</StoppedInstances>
<ErrorCode>OperationDenied.NoStock</ErrorCode>
<ErrorMessage>The specified ECS resource is out of stock in this region. Please try again later.</ErrorMessage>
<Detail>"new ECS instances "i-j6c8ilerw, i-j6c8iler4mx" are created."</Detail>
<TriggerSourceType>Api</TriggerSourceType>
<TriggerSourceId>2346366580*****</TriggerSourceId>
<LifecycleHookContext>
<DisableLifecycleHook>false</DisableLifecycleHook>
<IgnoredLifecycleHookIds>ash-bp14zolna43z266bq***</IgnoredLifecycleHookIds>
</LifecycleHookContext>
<ActivityMetadata>{\"goatscaler.io/managed\":\"true\"}</ActivityMetadata>
</ScalingActivities>
</DescribeScalingActivitiesResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "CC107349-57B7-4405-B1BF-9BF5AF7F****",
"PageNumber" : 1,
"PageSize" : 10,
"TotalCount" : 1,
"ScalingActivities" : [ {
"Progress" : 100,
"ScalingInstanceNumber" : 1,
"AttachedCapacity" : "0",
"TotalCapacity" : "2",
"ScalingGroupId" : "asg-bp18p2yfxow2dloq****",
"AutoCreatedCapacity" : "2",
"EndTime" : "2020-09-10T09:54Z",
"StartTime" : "2020-09-10T09:54Z",
"Description" : "Add \\\"1\\\" ECS instance",
"StatusCode" : "Successful",
"Cause" : "A user requests to execute scaling rule \\\"asr-bp12tcnol686y1ik****\\\", changing the Total Capacity from \\\"1\\\" to \\\"2\\\".",
"ScalingActivityId" : "asa-bp161xudmuxdzofe****",
"StatusMessage" : "\\\"1\\\" ECS instances are added",
"CreatedCapacity" : 1,
"DestroyedCapacity" : 1,
"StartedCapacity" : 1,
"StoppedCapacity" : 1,
"CreatedInstances" : [ "[ \"i-abc1\", \"i-abc2\" ]" ],
"DestroyedInstances" : [ "[ \"i-abc1\", \"i-abc2\" ]" ],
"StartedInstances" : [ "[ \"i-abc1\", \"i-abc2\" ]" ],
"StoppedInstances" : [ "[ \"i-abc1\", \"i-abc2\" ]" ],
"ErrorCode" : "OperationDenied.NoStock",
"ErrorMessage" : "The specified ECS resource is out of stock in this region. Please try again later.",
"Detail" : "\"new ECS instances \"i-j6c8ilerw, i-j6c8iler4mx\" are created.\"",
"TriggerSourceType" : "Api",
"TriggerSourceId" : "2346366580*****",
"LifecycleHookContext" : {
"DisableLifecycleHook" : false,
"IgnoredLifecycleHookIds" : [ "ash-bp14zolna43z266bq***" ]
},
"ActivityMetadata" : "{\\\"goatscaler.io/managed\\\":\\\"true\\\"}"
} ]
}
錯(cuò)誤碼
訪(fǎng)問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。