CreateDeploymentSet_部署集_API参考_云服务器 ECS

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	CreateDeploymentSet	系统规定参数。取值：CreateDeploymentSet
RegionId	String	是	cn-hangzhou	部署集所属地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。
OnUnableToRedeployFailedInstance	String	否	CancelMembershipAndStart	部署集内实例宕机迁移后，缺乏可供打散的实例库存的紧急处理方案。取值范围： CancelMembershipAndStart（默认）：将实例移出部署集，宕机迁移后即刻启动实例。 KeepStopped：保持异常状态等待补货充足后再启动实例。
Description	String	否	testDescription	部署集描述信息。长度为2~256个英文或中文字符，不能以http://和https://开头。
ClientToken	String	否	123e4567-e89b-12d3-a456-426655440000	保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。更多详情，请参见如何保证幂等性。
DeploymentSetName	String	否	testDeploymentSetName	部署集名称。长度为2~128个英文或中文字符。必须以大小字母或中文开头，不能以http://和https://开头。可以包含数字、半角冒号（:）、下划线（_）或者连字符（-）。
Domain	String	否	null	部署域。说明为提高兼容性，请尽量使用其他参数。
Granularity	String	否	null	部署粒度。说明为提高兼容性，请尽量使用其他参数。
Strategy	String	否	null	部署策略。说明为提高兼容性，请尽量使用其他参数。

返回数据


名称	类型	示例值	描述
DeploymentSetId	String	ds-bp1frxuzdg87zh4pzq****	部署集ID。
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	请求ID。

示例

请求示例

https://ecs.aliyuncs.com/?Action=CreateDeploymentSet
&RegionId=cn-hangzhou
&DeploymentSetName=testDeploymentSetName
&<公共请求参数>

正常返回示例

XML 格式

<CreateDeploymentSetResponse>
	  <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
	  <DeploymentSetId>ds-bp1frxuzdg87zh4pzq****</DeploymentSetId>
</CreateDeploymentSetResponse>

JSON 格式

{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
    "DeploymentSetId": "ds-bp1frxuzdg87zh4pzq****"
}

错误码


HttpCode	错误码	错误信息	描述
400	MissingParameter	The input parameter RegionId that is mandatory for processing this request is not supplied.	参数RegionId不得为空。
400	InvalidDeploymentSetName.Malformed	Specified deployment set name is not valid.	指定的参数DeploymentSetName不合法。
400	InvalidDescription.Malformed	The specified parameter Description is not valid.	指定的资源描述格式不合法。长度为2-256个字符，不能以http://和https://开头。
400	InvalidParameter.Domain	The specified parameter Domain is not valid.	指定的Domain参数不合法。
400	InvalidParameter.Strategy	The specified parameter Strategy is not valid	指定的Strategy不合法。
400	InvalidParameter.granularity	The specified parameter Granularity is not valid.	指定的Granularity参数不合法。
400	DependencyViolation.domain.granularity	The DeploymentSet domain and granularity is violation.	部署集域与数据粒度冲突。
400	DependencyViolation.strategy.granularity	The DeploymentSet strategy and granularity is violation.	部署集策略与数据粒度冲突。
400	DEPLOYMENTSET.QUOTA_FULL	The deploymentSet quota is full	部署集配额已满，请您减少部署集数量。

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