1. 创建安全组
1.1. 描述
创建安全组。
1.2. 请求地址
请求地址的格式如下:
https://<区域服务地址>/v1/sg/create
1.3. 请求参数
参数名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
projectId | String | 是 | 所属项目ID |
name | String | 是 | 安全组名称 |
description | String | 否 | 安全组描述信息 |
1.4. 请求示例
以创建华东一区名称为"test"的安全组为例:
1.4.1. 请求地址
POST https://cn-east-1.api.yovole.com/v1/sg/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":"test",
"description": "这是通过API创建的安全组"
}
1.5. 返回结果示例
1.5.1. 返回正确结果示例
{
"requestId":"cc23747e-dd2f-4325-b482-0307c37694de",
"success":true,
"code":200,
"model":{
"id":"3fd80ead-4b12-4467-8d83-9fb8db741e91",
"name":"test",
"sn":"SG-218KP4Q",
"regionSn":"CN-EAST-1",
"description":"这是通过API创建的安全组",
"created":"2019-06-14 19:27:50"
}
}
#### 注:当项目在该region下第一次创建资源时,因异步创建,model节点为空
1.5.2. 返回错误结果示例
{
"requestId": "4416235a-e9c0-453f-823a-ad491ebd74ab",
"success": false,
"code": 403,
"message": "permission denied"
}
1.6. 错误码
可以通过错误返回结果中的code、errorCode和message字段了解错误分类和具体的错误原因。
该接口没有特殊错误码,错误码信息和简单的错误分析方法可以参考公共错误码。