1. 创建安置组
1.1. 描述
创建安置组。
安置组通过安置策略决定了组内的云服务器如何在物理节点上进行安置。用户可以通过创建合适关系的安置策略,从而将一组实例按部署到合适的物理节点上,来提高资源的使用性能,或保证业务的可用性和连续性。
安置策略有以下两种:
分散,安置组内的云服务器趋向于部署/迁移到【不同】的物理节点上
集中,安置组内的云服务器趋向于部署/迁移到【相同】的物理节点上
1.2. 请求地址
请求地址的格式如下:
https://<区域服务地址>/v1/pg/create
1.3. 请求参数
参数名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
projectId | String | 是 | 所属项目ID |
name | String | 是 | 安置组名称 |
policy | String | 是 | 安置策略,可选值[分散:disperse,集中:affinity] |
azSn | String | 否 | 安置策略选集中时,需要指定azSn |
desc | String | 否 | 安置组描述信息 |
1.4. 请求示例
1.4.1. 请求地址
POST https://cn-east-1.api.yovole.com/v1/pg/create HTTP/1.1
x-ycs-timestamp: 2019-06-19T14:26:26Z
x-ycs-requestid: 2a49cfa2-925b-11e9-bb3a-6c96cfdcd6b9
x-ycs-security-authorization: Authorization: YCS1-HMAC-SHA1 Credential=08e206fb-7b41-45b7-8076-8d43e8aeea89,SignedHeaders=content-type;x-ycs-requestid;x-ycs-timestamp,Signature=2RFjU7C9gICCrQfpAIfAJHqRRlQ=
1.4.2. 接口请求参数
{
"projectId":"8a83a0966a681da5016a874df50b10ce",
"name":"分散型安置组",
"policy":"disperse",
"desc":"安置组描述"
}
1.5. 返回结果示例
1.5.1. 返回正确结果示例
{
"requestId": "2a49cfa2-925b-11e9-bb3a-6c96cfdcd6b9",
"success": true,
"code": 200,
"message": null,
"model": null
}
1.5.2. 返回错误结果示例
{
"requestId": "2a49cfa2-925b-11e9-bb3a-6c96cfdcd6b9",
"success": false,
"code": 400,
"message": "Required attribute 'projectId' not specified",
"errorCode": "Invalid argument"
}
1.6. 错误码
可以通过错误返回结果中的code、errorCode和message字段了解错误分类和具体的错误原因。
该接口没有特殊错误码,错误码信息和简单的错误分析方法可以参考公共错误码。