调用DescribeDeploymentSets查询一个或多个部署集的属性列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
RegionId String 是 cn-hangzhou

部署集所属地域ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

Action String 否 DescribeDeploymentSets

系统规定参数。取值：DescribeDeploymentSets
PageNumber Integer 否 1

部署集列表的页码。

起始值：1。

默认值：1。
PageSize Integer 否 10

分页查询时设置的每页行数。

最大值：50。

默认值：10。
DeploymentSetIds String 否 ["ds-bp67acfmxazb4ph***", "ds-bp67acfmxazb4pi***", … "ds-bp67acfmxazb4pj***"]

部署集ID列表。取值可以由多个部署集ID组成一个JSON数组，最多支持100个ID，ID之间用半角逗号（,）隔开。

DeploymentSetName String 否 FinanceJoshua

部署集名称。
Strategy String 否 Availability

部署策略。取值：Availability

默认值：空。

NetworkType String 否 null

部署集内实例的网络类型。

说明 为提高兼容性，请尽量使用其他参数。
Granularity String 否 null

部署粒度。

说明 为提高兼容性，请尽量使用其他参数。
Domain String 否 null

部署域。

说明 为提高兼容性，请尽量使用其他参数。

返回数据

名称 类型 示例值 描述
DeploymentSets Array

由DeploymentSet组成的数组格式，返回部署集详细信息。
DeploymentSet

由DeploymentSet组成的数组格式，返回部署集详细信息。
CreationTime String 2017-12-05T22:40:00Z

部署集的创建时间。
DeploymentSetDescription String FinanceDeptHighAvailability

部署集的描述信息。
DeploymentSetId String ds-deploymentsetid1

部署集ID。
DeploymentSetName String FinanceJoshua

部署集名称。
DeploymentStrategy String Availability

部署策略。
Domain String Default

部署域。
Granularity String Host

部署粒度。
InstanceAmount Integer 1

部署集内的实例数量。
InstanceIds List ["i-instanceid1"]

部署集内的实例ID列表。
InstanceId

部署集内的实例ID列表。
Strategy String StrictDispersion

部署策略。
PageNumber Integer 1

部署集列表的页数。
PageSize Integer 10

设置的每页行数。
RegionId String cn-hangzhou

部署集所处的地域 ID。
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求 ID。
TotalCount Integer 1

查询到的部署集总数。

示例

请求示例

https://ecs.aliyuncs.com/?Action=DescribeDeploymentSets
&RegionId=cn-hangzhou
&PageSize=1
&<公共请求参数>

正常返回示例

XML 格式 

<DescribeDeploymentSetsResponse>
      <DeploymentSets>
            <DeploymentSet>
                  <CreationTime>Tue Jul 23 17:24:33 CST 2019</CreationTime>
                  <Granularity>switch</Granularity>
                  <DeploymentSetDescription>autogen deploymentset, do not delete</DeploymentSetDescription>
                  <Domain>default</Domain>
                  <InstanceIds>
                        <InstanceId>i-bp67acfmxazb4ph***</InstanceId>
                        <InstanceId>i-bp67acfmxazb4pi***</InstanceId>
                        <InstanceId>i-bp67acfmxazb4pj***</InstanceId>
                  </InstanceIds>
                  <InstanceAmount>0</InstanceAmount>
                  <Strategy>LooseAggregation</Strategy>
                  <DeploymentSetName>hpc-null-deploymentset</DeploymentSetName>
                  <DeploymentStrategy>Availability</DeploymentStrategy>
                  <DeploymentSetId>ds-bp120c8htdzx3869****</DeploymentSetId>
            </DeploymentSet>
      </DeploymentSets>
      <PageNumber>1</PageNumber>
      <TotalCount>5</TotalCount>
      <PageSize>1</PageSize>
      <RegionId>cn-hangzhou</RegionId>
      <RequestId>FB5EF912-FD87-4CF7-91D9-9204974A63F3</RequestId>
</DescribeDeploymentSetsResponse>

JSON 格式 

{
	"DeploymentSets":{
		"DeploymentSet":[
			{
				"CreationTime":"Tue Jul 23 17:24:33 CST 2019",
				"Granularity":"switch",
				"DeploymentSetDescription":"autogen deploymentset, do not delete",
				"Domain":"default",
				"InstanceIds":{
					"InstanceId":[
						"i-bp67acfmxazb4ph***",
						"i-bp67acfmxazb4pi***",
						"i-bp67acfmxazb4pj***"
					]
				},
				"InstanceAmount":0,
				"Strategy":"LooseAggregation",
				"DeploymentSetName":"hpc-null-deploymentset",
				"DeploymentStrategy":"Availability",
				"DeploymentSetId":"ds-bp120c8htdzx3869****"
			}
		]
	},
	"PageNumber":1,
	"TotalCount":5,
	"PageSize":1,
	"RequestId":"FB5EF912-FD87-4CF7-91D9-9204974A63F3",
	"RegionId":"cn-hangzhou"
}

错误码

HttpCode 错误码 错误信息 描述
403 InvalidDeploymentSetIds.TooManyInput The parameter DeploymentSets size should less than 100. 指定的 DeploymentSets 数量大于 100。

访问错误中心查看更多错误码。