DescribeAutoProvisioningGroups - API Reference| Alibaba Cloud Documentation Center

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	DescribeAutoProvisioningGroups	The operation that you want to perform. Set the value to DescribeAutoProvisioningGroups.
RegionId	String	Yes	cn-hangzhou	The region ID of the auto provisioning group.
AutoProvisioningGroupId.N	RepeatList	No	apg-sn54avj8htgvtyh8****	The ID of auto provisioning group N. Valid values of N: 1 to 20.
AutoProvisioningGroupName	String	No	testAutoProvisioningGroupName	The name of the auto provisioning group.
PageSize	Integer	No	2	The number of entries to return on each page. Maximum value: 100. Default value: 10.
PageNumber	Integer	No	1	The number of the page to return. Pages start from page 1. Default value: 1.
AutoProvisioningGroupStatus.N	RepeatList	No	active	The status of auto provisioning group N. Valid values: submitted: The auto provisioning group is created and has not started to execute scheduling tasks. active: The auto provisioning group is executing scheduling tasks. deleted: The auto provisioning group is deleted. deleted-running: The auto provisioning group is being deleted. modifying: The auto provisioning group is being modified.

Response parameters


Parameter	Type	Example	Description
AutoProvisioningGroups	Array of AutoProvisioningGroup		Details about the auto provisioning groups.
AutoProvisioningGroup
AutoProvisioningGroupId	String	apg-sn54avj8htgvtyh8****	The ID of the auto provisioning group.
AutoProvisioningGroupName	String	EcsDocTest	The name of the auto provisioning group.
AutoProvisioningGroupType	String	maintain	The delivery type of the auto provisioning group. Valid values: request: one-time delivery.After the auto provisioning group is started, it attempts to deliver an instance cluster once. If the cluster fails to be delivered, the group does not retry the operation. maintain: continuous delivery.After the auto provisioning group is started, it continuously attempts to deliver an instance cluster. The auto provisioning group compares the real-time capacity and the target cluster capacity. If the cluster does not meet the target capacity, the group creates instances until the cluster meets the target capacity.
CreationTime	String	2019-04-01T15:10:20Z	The time when the auto provisioning group was created.
ExcessCapacityTerminationPolicy	String	termination	Indicates whether to release the scaled-in instances when the real-time capacity exceeds the target capacity and the group is triggered to scale in. Valid values: termination: releases the scaled-in instances. no-termination: removes the scaled-in instances from the auto provisioning group but not releases the instances.
LaunchTemplateConfigs	Array of LaunchTemplateConfig		Details about the extended configurations.
LaunchTemplateConfig
InstanceType	String	ecs.g5.large	The instance type specified in the extended configurations.
MaxPrice	Float	3	The maximum price of the instance type specified in the extended configurations.
Priority	Float	1	The priority of the instance type specified in the extended configurations. A value of 0 indicates the highest priority.
VSwitchId	String	vsw-sn5bsitu4lfzgc5o7****	The ID of the vSwitch specified in the extended configurations.
WeightedCapacity	Float	2	The weight of the instance type specified in the extended configurations.
LaunchTemplateId	String	lt-bp1fgzds4bdogu03****	The ID of the launch template associated with the auto provisioning group.
LaunchTemplateVersion	String	1	The version of the launch template associated with the auto provisioning group.
MaxSpotPrice	Float	2	The maximum price for preemptible instances in the auto provisioning group. Note If both the MaxSpotPrice and LaunchTemplateConfig.N.MaxPrice parameters are specified, the maximum price is the lower value of the two parameters. The LaunchTemplateConfig.N.MaxPrice parameter is set when the auto provisioning group is created, and cannot be modified.
PayAsYouGoOptions	Struct		The policies related to pay-as-you-go instances.
AllocationStrategy	String	prioritized	The provisioning policy for pay-as-you-go instances. Valid values: lowest-price: the cost optimization policy. This policy indicates that instance types of the lowest cost are used to create instances. prioritized: the priority-based policy. This policy indicates that instances are created based on the priority specified by the LaunchTemplateConfig.N.Priority parameter. Note The LaunchTemplateConfig.N.Priority parameter is set when the auto provisioning group is created, and cannot be modified.
RegionId	String	cn-hangzhou	The region ID of the auto provisioning group.
SpotOptions	Struct		The policy related to preemptible instances.
AllocationStrategy	String	diversified	The provisioning policy for preemptible instances. Valid values: lowest-price: the cost optimization policy. This policy indicates that instance types of the lowest cost are used to create instances. diversified: balanced distribution policy. This policy indicates that instances are created evenly across multiple zones specified in the extended configurations.
InstanceInterruptionBehavior	String	stop	The action to be performed after the extra preemptible instances are stopped. Valid values: stop: retains the extra preemptible instances in the stopped state. terminate: releases the extra preemptible instances.
InstancePoolsToUseCount	Integer	2	The number of instances that the auto provisioning group used the instance type of the lowest cost to create. Note This parameter is set when the auto provisioning group is created, and cannot be modified.
State	String	fulfilled	The overall status of instance scheduling of the auto provisioning group. Valid values: fulfilled: Scheduling is complete and the instance cluster is delivered. pending-fulfillment: The instances are being created. pending-termination: The instances are being removed. error: An exception has occurred during scheduling and the instance cluster was not delivered.
Status	String	submitted	The status of the auto provisioning group. Valid values: submitted: The auto provisioning group is created and has not started to execute scheduling tasks. active: The auto provisioning group is executing scheduling tasks. deleted: The auto provisioning group is deleted. deleted-running: The auto provisioning group is being deleted. modifying: The auto provisioning group is being modified.
TargetCapacitySpecification	Struct		The settings of the target capacity of the auto provisioning group.
DefaultTargetCapacityType	String	Spot	The billing method of supplemental instances. The target capacity of the auto provisioning group must be at least the sum of the pay-as-you-go instance capacity specified by the PayAsYouGoTargetCapacity parameter and the preemptible instance capacity specified by the SpotTargetCapacity parameter. Valid values: PayAsYouGo: pay-as-you-go Spot: preemptible instance
PayAsYouGoTargetCapacity	Float	30	The target capacity of pay-as-you-go instances in the auto provisioning group.
SpotTargetCapacity	Float	20	The target capacity of preemptible instances in the auto provisioning group.
TotalTargetCapacity	Float	60	The target capacity of the auto provisioning group. The capacity consists of the following three parts: PayAsYouGoTargetCapacity SpotTargetCapacity The supplemental capacity besides instance capacities specified by the PayAsYouGoTargetCapacity and SpotTargetCapacity parameters
TerminateInstances	Boolean	false	Indicates whether to release the instances in the auto provisioning group when the auto provisioning group is deleted. Valid values: true: releases the instances. false: retains the instances.
TerminateInstancesWithExpiration	Boolean	true	Indicates whether to release instances in the auto provisioning group when the auto provisioning group expires. Valid values: true: releases the instances. false: removes the instances in the group from the auto provisioning group but not releases the instances.
ValidFrom	String	2019-04-01T15:10:20Z	The time when the auto provisioning group was started. The period of time between this point in time and the point in time specified by the ValidUntil parameter is the effective time period of the auto provisioning group.
ValidUntil	String	2019-06-01T15:10:20Z	The time when the auto provisioning group expires. The period of time between this point in time and the point in time specified by the ValidFrom parameter is the effective time period of the auto provisioning group.
PageNumber	Integer	1	The page number of the returned page.
PageSize	Integer	10	The number of entries returned per page.
RequestId	String	745CEC9F-0DD7-4451-9FE7-8B752F39****	The ID of the request.
TotalCount	Integer	10	The number of queried auto provisioning groups.

Examples

Sample requests

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

Sample success responses

XML format

<DescribeAutoProvisioningGroups>
    <PageNumber>1</PageNumber>
    <TotalCount>1</TotalCount>
    <PageSize>10</PageSize>
    <RequestId>85331AC9-82C0-4604-9A14-048865BE****</RequestId>
    <AutoProvisioningGroups>
        <AutoProvisioningGroup>
            <TerminateInstancesWithExpiration>false</TerminateInstancesWithExpiration>
            <TerminateInstances>false</TerminateInstances>
            <ValidFrom>2019-06-17T15:22Z</ValidFrom>
            <AutoProvisioningGroupType>maintain</AutoProvisioningGroupType>
            <PayAsYouGoOptions>
                <AllocationStrategy>lowest-price</AllocationStrategy>
            </PayAsYouGoOptions>
            <AutoProvisioningGroupName>test61****</AutoProvisioningGroupName>
            <CreationTime></CreationTime>
            <ExcessCapacityTerminationPolicy>no-termination</ExcessCapacityTerminationPolicy>
            <Status>active</Status>
            <MaxSpotPrice>5</MaxSpotPrice>
            <LaunchTemplateVersion>1</LaunchTemplateVersion>
            <ValidUntil>2100-01-01T07:59Z</ValidUntil>
            <TargetCapacitySpecification>
                <SpotTargetCapacity>180</SpotTargetCapacity>
                <TotalTargetCapacity>300</TotalTargetCapacity>
                <PayAsYouGoTargetCapacity>120</PayAsYouGoTargetCapacity>
                <DefaultTargetCapacityType>PayAsYouGo</DefaultTargetCapacityType>
            </TargetCapacitySpecification>
            <State>fulfilled</State>
            <LaunchTemplateId>lt-uf657o6auob6aivd****</LaunchTemplateId>
            <RegionId>cn-shanghai</RegionId>
            <AutoProvisioningGroupId>apg-uf6c7pl7b30t4m98****</AutoProvisioningGroupId>
            <SpotOptions>
                <InstancePoolsToUseCount>1</InstancePoolsToUseCount>
                <InstanceInterruptionBehavior>terminate</InstanceInterruptionBehavior>
                <AllocationStrategy>lowest-price</AllocationStrategy>
            </SpotOptions>
            <LaunchTemplateConfigs>
                <LaunchTemplateConfig>
                    <MaxPrice>3</MaxPrice>
                    <WeightedCapacity>1</WeightedCapacity>
                    <VSwitchId>vsw-uf6qbjwokzl67uqqf****</VSwitchId>
                    <Priority>1</Priority>
                    <InstanceType>ecs.c5.xlarge</InstanceType>
                </LaunchTemplateConfig>
                <LaunchTemplateConfig>
                    <MaxPrice>2</MaxPrice>
                    <WeightedCapacity>2</WeightedCapacity>
                    <VSwitchId>vsw-uf6n6iy1ib39eqvph****</VSwitchId>
                    <Priority>1</Priority>
                    <InstanceType>ecs.g5.large</InstanceType>
                </LaunchTemplateConfig>
                <LaunchTemplateConfig>
                    <MaxPrice>1</MaxPrice>
                    <WeightedCapacity>3</WeightedCapacity>
                    <VSwitchId>vsw-uf6gs8uerj5osels4****</VSwitchId>
                    <Priority>1</Priority>
                    <InstanceType>ecs.hfc5.large</InstanceType>
                </LaunchTemplateConfig>
            </LaunchTemplateConfigs>
        </AutoProvisioningGroup>
    </AutoProvisioningGroups>
</DescribeAutoProvisioningGroups>

JSON format

{
    "PageNumber": 1,
    "TotalCount": 1,
    "PageSize": 10,
    "RequestId": "85331AC9-82C0-4604-9A14-048865BE****",
    "AutoProvisioningGroups": {
        "AutoProvisioningGroup": {
            "TerminateInstancesWithExpiration": false,
            "TerminateInstances": false,
            "ValidFrom": "2019-06-17T15:22Z",
            "AutoProvisioningGroupType": "maintain",
            "PayAsYouGoOptions": {
                "AllocationStrategy": "lowest-price"
            },
            "AutoProvisioningGroupName": "test61****",
            "CreationTime": "",
            "ExcessCapacityTerminationPolicy": "no-termination",
            "Status": "active",
            "MaxSpotPrice": 5,
            "LaunchTemplateVersion": 1,
            "ValidUntil": "2100-01-01T07:59Z",
            "TargetCapacitySpecification": {
                "SpotTargetCapacity": 180,
                "TotalTargetCapacity": 300,
                "PayAsYouGoTargetCapacity": 120,
                "DefaultTargetCapacityType": "PayAsYouGo"
            },
            "State": "fulfilled",
            "LaunchTemplateId": "lt-uf657o6auob6aivd****",
            "RegionId": "cn-shanghai",
            "AutoProvisioningGroupId": "apg-uf6c7pl7b30t4m98****",
            "SpotOptions": {
                "InstancePoolsToUseCount": 1,
                "InstanceInterruptionBehavior": "terminate",
                "AllocationStrategy": "lowest-price"
            },
            "LaunchTemplateConfigs": {
                "LaunchTemplateConfig": [
                    {
                        "MaxPrice": 3,
                        "WeightedCapacity": 1,
                        "VSwitchId": "vsw-uf6qbjwokzl67uqqf****",
                        "Priority": 1,
                        "InstanceType": "ecs.c5.xlarge"
                    },
                    {
                        "MaxPrice": 2,
                        "WeightedCapacity": 2,
                        "VSwitchId": "vsw-uf6n6iy1ib39eqvph****",
                        "Priority": 1,
                        "InstanceType": "ecs.g5.large"
                    },
                    {
                        "MaxPrice": 1,
                        "WeightedCapacity": 3,
                        "VSwitchId": "vsw-uf6gs8uerj5osels4****",
                        "Priority": 1,
                        "InstanceType": "ecs.hfc5.large"
                    }
                ]
            }
        }
    }
}

Error codes


HTTP status code	Error code	Error message	Description
400	MissingParamter.RegionId	The regionId should not be null.	The error message returned because the RegionId parameter is not specified.

For a list of error codes, visit the API Error Center.