调用CreateDeploymentSet在指定的地域内创建一个部署集。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | CreateDeploymentSet | 系统规定参数。取值：CreateDeploymentSet |
| RegionId | String | 是 | cn-hangzhou | 部署集所属地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。 |
| OnUnableToRedeployFailedInstance | String | 否 | CancelMembershipAndStart | 部署集内实例宕机迁移后，缺乏可供打散的实例库存的紧急处理方案。取值范围：
|
| Description | String | 否 | testDescription | 部署集描述信息。长度为2~256个英文或中文字符，不能以http://和https://开头。 |
| ClientToken | String | 否 | 123e4567-e89b-12d3-a456-426655440000 | 保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。更多详情，请参见如何保证幂等性。 |
| DeploymentSetName | String | 否 | testDeploymentSetName | 部署集名称。长度为2~128个英文或中文字符。必须以大小字母或中文开头，不能以http://和https://开头。可以包含数字、半角冒号（:）、下划线（_）或者连字符（-）。 |
| Strategy | String | 否 | Availability | 部署策略。仅支持设置高可用策略。取值：Availability |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| 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 | 部署集配额已满，请您减少部署集数量。 |
访问错误中心查看更多错误码。