All Products
Search
Document Center

:DescribeAutoProvisioningGroupHistory

更新時間:Dec 18, 2023

Queries the scheduling tasks of an auto provisioning group.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter

Type

Required

Example

Description

Action String Yes DescribeAutoProvisioningGroupHistory

The operation that you want to perform. Set the value to DescribeAutoProvisioningGroupHistory.

RegionId String Yes cn-hangzhou

The region ID of the auto provisioning group.

PageNumber Integer No 1

The page number. Pages start from page 1.

Default value: 1.

PageSize Integer No 5

The number of entries per page. Valid values: 1 to 100.

Default value: 10.

AutoProvisioningGroupId String Yes apg-bp67acfmxazb4p****

The ID of the auto provisioning group.

StartTime String No 2019-04-01T15:10:20Z

The beginning of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.

EndTime String No 2019-06-20T15:10:20Z

The end of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.

Response parameters

Parameter

Type

Example

Description

PageSize Integer 10

The number of entries per page.

RequestId String B48A12CD-1295-4A38-A8F0-0E92C937****

The ID of the request.

PageNumber Integer 1

The page number.

TotalCount Integer 10

The number of queried scheduling tasks of the auto provisioning group.

AutoProvisioningGroupHistories Array of AutoProvisioningGroupHistory

The information about the scheduling tasks of the auto provisioning group.

AutoProvisioningGroupHistory
Status String success

The execution status of the one-time scheduling task. Valid values:

  • prepare: The scheduling task was being executed.
  • success: The scheduling task was completed.
  • failed: The scheduling task failed to be executed.
StartTime String 2019-04-01T15:10:20Z

The time when the one-time scheduling task was executed.

TaskId String apg-task-bp67acfmxazb4p****

The ID of the one-time scheduling task.

LastEventTime String 2019-04-01T15:10:20Z

The execution time of the last instance creation performed by the one-time scheduling task.

ActivityDetails Array of ActivityDetail

The details of the one-time scheduling task.

ActivityDetail
Status String Successful

The execution status of instance creation performed by the one-time scheduling task. Valid values:

  • Successful: Instances were created.
  • Failed: Instances failed to be created.
  • InProgress: Instances were being created.
  • Warning: Some instances were created.
Detail String New ECS instances "i-bp67acfmxazb4p****, i-bp67acfmxazb5p****" created.

The execution details of instance creation performed by the one-time scheduling task.

Examples

Sample requests

https://ecs.aliyuncs.com/?Action=DescribeAutoProvisioningGroupHistory
&AutoProvisioningGroupId=apg-bp67acfmxazb4p****
&RegionId=cn-hangzhou
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeAutoProvisioningGroupsResponse>
    <PageNumber>1</PageNumber>
    <TotalCount>1</TotalCount>
    <PageSize>10</PageSize>
    <RequestId>BA55349F-6E36-4E64-964B-419515D1****</RequestId>
    <AutoProvisioningGroupHistories>
        <AutoProvisioningGroupHistory>
            <Status>success</Status>
            <ActivityDetails>
                <ActivityDetail>
                    <Detail>New ECS instances i-bp67acfmxazb4ph***, i-bp67acfmxazb4pi*** created.</Detail>
                    <Status>Successful</Status>
                </ActivityDetail>
            </ActivityDetails>
            <LastEventTime>2019-06-17T08:48:00Z</LastEventTime>
            <StartTime>2019-06-17T08:47:52Z</StartTime>
            <TaskId>apg-task-uf66bqtabg10wcf6****</TaskId>
        </AutoProvisioningGroupHistory>
    </AutoProvisioningGroupHistories>
</DescribeAutoProvisioningGroupsResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "PageNumber" : 1,
  "TotalCount" : 1,
  "PageSize" : 10,
  "RequestId" : "BA55349F-6E36-4E64-964B-419515D1****",
  "AutoProvisioningGroupHistories" : {
    "AutoProvisioningGroupHistory" : [ {
      "Status" : "success",
      "ActivityDetails" : {
        "ActivityDetail" : [ {
          "Detail" : "New ECS instances i-bp67acfmxazb4ph***, i-bp67acfmxazb4pi*** created.",
          "Status" : "Successful"
        } ]
      },
      "LastEventTime" : "2019-06-17T08:48:00Z",
      "StartTime" : "2019-06-17T08:47:52Z",
      "TaskId" : "apg-task-uf66bqtabg10wcf6****"
    } ]
  }
}

Error codes

HTTP status code

Error code

Error message

Description

400 MissingParamter.RegionId The regionId should not be null. RegionId is required.

For a list of error codes, see Service error codes.