开发者社区 问答 正文

伸缩组:查询伸缩活动



描述


查询伸缩活动的信息。

  • 查询时可以指定伸缩组 ID 来查询该伸缩组下的所有伸缩活动。
  • 查询时可以通过伸缩活动的状态来过滤查询结果。
  • 最多只能返回 30 日前的伸缩活动。


请求参数

名称类型是否必须描述
ActionString操作接口名,系统规定参数,取值:DescribeScalingActivities。
RegionIdString伸缩活动所在的地域。
ScalingGroupIdString伸缩组的 ID。
ScalingActivityId.NString伸缩活动的 ID,最多可以输入 10 个。返回查询结果时忽略失效的伸缩活动 ID,并且不报错。
StatusCodeString伸缩活动的状态。可选值:- Successful:执行成功的伸缩活动。- Warning:部分执行成功的伸缩活动。- Failed:执行失败的伸缩活动。- InProgress:正在执行的伸缩活动。- Rejected:执行伸缩活动请求被拒绝。
PageNumberInteger伸缩活动列表的页码,起始值为 1,默认值为 1 。
PageSizeInteger分页查询时设置的每页行数,最大值 50 行,默认值为 10 。


返回参数

名称类型描述
TotalCountInteger伸缩活动总数
PageNumberInteger当前页码
PageSizeInteger每页行数
ScalingActivitiesScalingActivitySetType伸缩活动信息组成的集合

ScalingActivitySetType 是由 ScalingActivityItemType 类型组成的集合:
名称类型描述
ScalingActivityScalingActivityItemType伸缩活动信息

ScalingActivityItemType类型的属性如下:
名称类型描述
ScalingActivityIdString伸缩活动的 ID
ScalingGroupIdString伸缩组的 ID
DescriptionString伸缩活动的描述信息
CauseString触发伸缩活动的原因
StartTimeString伸缩活动的开始时间
EndTimeString伸缩活动的结束时间
ProgressInteger伸缩活动的运行进度
StatusCodeString伸缩活动的当前状态
StatusMessageString伸缩活动的状态信息


错误码


关于所有接口的通用性错误,请参考 客户端错误表服务器端错误表

示例



请求示例


http://ess.aliyuncs.com/?Action=DescribeScalingActivities
&RegionId=cn-qingdao
&PageSize=50
&<公共请求参数>



返回示例


XML格式:
<DescribeScalingActivitiesResponse>
    <RequestId>8FAAE99E-EB43-4838-85AD-93F62454904C</RequestId>
    <TotalCount>1</TotalCount>
    <PageNumber>1</PageNumber>
    <PageSize>10</PageSize>
    <ScalingActivities>
        <ScalingActivity>
            <Cause>A scheduled task excuete scaling rule "srtest",changing the Total Capacity from "0" to "1".</Cause>
            <Description>Add "1" ECS instance</Description>
            <EndTime>2014-08-17T12:39Z</EndTime>
            <Progress>100</Progress>
            <ScalingActivityId>ebta5WbUzC8gcwUWvfchyT4U</ScalingActivityId>
            <ScalingGroupId>AG6CQdPU8OKdwLjgZcJ2eaQ</ScalingGroupId>
            <StartTime>2014-08-17T12:39Z</StartTime>
            <StatusCode>Successful</StatusCode>
            <StatusMessage>"1" ECS instances is added. </StatusMessage>
        </ScalingActivity>
    </ScalingActivities>
</DescribeScalingActivitiesResponse>



JSON格式:
{
"RequestId":"0A016AD6-A91F-4210-9DEE-D5BBD4270F45",
"TotalCount":2582,
"PageNumber":1,
"PageSize":1,
"ScalingActivities":{
"ScalingActivity":[
{
   "ScalingActivityId":"bBxOR5dhKFoccGkbTrcyHE2g",
   "StartTime":"2014-08-18T20:49Z",
"EndTime":"2014-08-18T20:49Z",
"Cause":" A scheduled task excuete scaling rule \"srtest\",changing the Total Capacity from \"0\" to \"1\".",
"Description":" Add \"1\" ECS instance ",
"Progress":100,
"ScalingGroupId":"c7acXJbAJmpPcGE7G3bwwbS9",
"StatusCode":"Successful",
"StatusMessage":"\"1\" ECS instances is added. "
}
]
}
}


展开
收起
青蛙跳 2018-08-17 13:35:47 1136 分享
分享
版权
举报
阿里云 AI 助理回答

查询伸缩活动的信息

通过调用 DescribeScalingActivities 接口,您可以查询阿里云弹性伸缩服务中的伸缩活动详情。此接口支持按指定条件筛选查询结果,并返回最近 30 天内的伸缩活动记录。


请求参数

以下是请求参数的详细说明:

参数名称类型是否必须描述
ActionString操作接口名,系统规定参数,取值为 DescribeScalingActivities
RegionIdString伸缩活动所在的地域 ID。
ScalingGroupIdString伸缩组的 ID。如果指定,则仅返回该伸缩组下的所有伸缩活动。
ScalingActivityId.NString伸缩活动的 ID,最多可以输入 10 个。失效的 ID 会被忽略且不报错。
StatusCodeString伸缩活动的状态,用于过滤查询结果。可选值包括:
- Successful:执行成功的伸缩活动。
- Warning:部分执行成功的伸缩活动。
- Failed:执行失败的伸缩活动。
- InProgress:正在执行的伸缩活动。
- Rejected:执行伸缩活动请求被拒绝。
PageNumberInteger伸缩活动列表的页码,起始值为 1,默认值为 1。
PageSizeInteger分页查询时设置的每页行数,最大值为 50 行,默认值为 10。

返回参数

以下是返回参数的详细说明:

参数名称类型描述
TotalCountInteger符合查询条件的伸缩活动总数。
PageNumberInteger当前页码。
PageSizeInteger每页行数。
ScalingActivitiesScalingActivitySetType伸缩活动信息组成的集合。

ScalingActivitySetType

ScalingActivitySetType 是由 ScalingActivityItemType 类型组成的集合。

ScalingActivityItemType

ScalingActivityItemType 的属性如下:

参数名称类型描述
ScalingActivityIdString伸缩活动的唯一标识符。
ScalingGroupIdString伸缩组的唯一标识符。
DescriptionString伸缩活动的描述信息。
CauseString触发伸缩活动的原因。
StartTimeString伸缩活动的开始时间,格式为 ISO 8601。
EndTimeString伸缩活动的结束时间,格式为 ISO 8601。
ProgressInteger伸缩活动的运行进度,范围为 0 到 100。
StatusCodeString伸缩活动的当前状态,可能值包括:
- Successful:成功。
- Warning:警告。
- Failed:失败。
- InProgress:执行中。
- Rejected:被拒绝。
StatusMessageString伸缩活动的状态信息,通常包含错误或警告的详细描述。

错误码

在调用 DescribeScalingActivities 接口时,可能会遇到以下错误码:

HTTP 状态码错误码错误信息描述
400InvalidParameterThe input parameter "ScalingActivityId" that is mandatory for processing this request is not supplied.请求中未提供必填参数 ScalingActivityId
400InvalidRegionIdThe specified RegionId does not exist.指定的地域 ID 不存在。
403ForbiddenUser not authorized to operate on the specified resource.用户无权限操作指定资源。
500InternalErrorThe request processing has failed due to an unknown error, exception or failure.请求处理失败,可能是由于未知错误、异常或故障导致。

更多通用性错误,请参考 客户端错误表 或 服务器端错误表。


示例

请求示例

http(s)://ess.aliyuncs.com/?Action=DescribeScalingActivities
&RegionId=cn-hangzhou
&ScalingGroupId=asg-bp1j23456789abcdef0123
&StatusCode=Successful
&PageNumber=1
&PageSize=10
&公共请求参数

正常返回示例(JSON 格式)

{
  "TotalCount": 50,
  "PageNumber": 1,
  "PageSize": 10,
  "ScalingActivities": {
    "ScalingActivity": [
      {
        "ScalingActivityId": "asa-bp1c9djwrgxjyk31****",
        "ScalingGroupId": "asg-bp1j23456789abcdef0123",
        "Description": "new ECS instances are created.",
        "Cause": "A user requests to execute scaling rule.",
        "StartTime": "2023-10-01T10:00:00Z",
        "EndTime": "2023-10-01T10:05:00Z",
        "Progress": 100,
        "StatusCode": "Successful",
        "StatusMessage": "The scaling activity was executed successfully."
      }
    ]
  },
  "RequestId": "B13527BF-1FBD-4334-A512-20F5E9D3FB4D"
}

注意事项

  • 查询时间范围限制:该接口仅支持查询最近 30 天内的伸缩活动记录。
  • 分页查询:当查询结果较多时,建议使用 PageNumberPageSize 参数进行分页查询,以避免单次返回数据过多导致性能问题。
  • 状态过滤:通过 StatusCode 参数可以精确筛选特定状态的伸缩活动,便于快速定位问题或分析执行效果。

希望以上内容能够帮助您高效地查询伸缩活动信息!您可以复制页面截图提供更多信息,我可以进一步帮您分析问题原因。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答
AI助理

你好,我是AI助理

可以解答问题、推荐解决方案等