查询SG列表
2019年08月12日

接口描述

请求路径:https://open.didiyunapi.com/dicloud/i/network/sg/list

请求方法:POST

输入参数

参数名称 必选 类型 描述
regionId string 地域id
start int 查询SG列表起始index,从0开始
limit int 查询SG列表元素数量
condition SGCondition 查询SG条件

SGCondition:

参数名称 必选 类型 描述
sgUuids array<string> 查询此uuid集合的SG
vpcUuid string 查询此uuid对应的VPC下的SG
dc2Uuid string 查询此uuid对应的DC2相关的SG
dc2Exclude bool 与dc2Uuid配合使用,不传或传false,表示查询此DC2所绑定的SG列表,传true表示查询此DC2未绑定的SG列表

输出参数

参数名称 类型 描述
errno int 错误码
errmsg string 请求错误说明
requestId string 请求唯一标识
data array<SGResponse> 请求返回数据

SGResponse:

参数名称 类型 描述
job Job 此SG正在进行的任务,若无任务则没有此字段
sgUuid string SG唯一标识
name string SG名称
createTime int64 SG创建时间
updateTime int64 SG更新时间
isDefault bool 是否为当前VPC下的默认SG
dc2Cnt int SG绑定的DC2数量
sgRuleCnt int SG中的规则数量
region Region region信息
vpc VPCOutput 此SG所在的VPC信息

VPCOutput:

参数名称 类型 描述
vpcUuid string VPC唯一标识
name string VPC名称
createTime int64 VPC创建时间
updateTime int64 VPC更新时间
isDefault bool VPC是否是当前region的默认VPC
desc string VPC描述信息
cidr string VPC的网段
region Region region信息

错误码

错误码 说明
0 请求成功
41052 查询SG信息失败

示例

请求:
curl -X POST \
  https://open.didiyunapi.com/dicloud/i/network/sg/list \
  -H 'authorization: Bearer 9a609744ad675e8fbfcdbf14511b24e6ddd6b427b4d256969534a81d0773f4d7' \
  -H 'content-type: application/json' \
  -d '{
    "regionId": "gz",
    "start": 0,
    "limit": 10,
    "condition": {}
}'
输出:
{
    "errno": 0,
    "errmsg": "ok",
    "data": [{
        "category": "DEFAULT",
        "createTime": 1539767815000,
        "dc2Cnt": 1,
        "isDefault": true,
        "name": "sg-default-vpc",
        "region": {
            "id": "gz",
            "name": "广州"
        },
        "sgId": "sg-9riujc66",
        "sgRuleCnt": 10,
        "sgTags": [],
        "sgUuid": "db1a4d0fa0e14d1a93c18fadf97b3065",
        "updateTime": 1539767815000,
        "vpc": {
            "cidr": "10.0.0.0/8",
            "createTime": 1539767814000,
            "desc": "default l2 network",
            "isDefault": true,
            "name": "default-vpc",
            "updateTime": 1539767815000,
            "vpcId": "vpc-94hgk1oe",
            "vpcTags": [],
            "vpcUuid": "e32a224660824af1ba84ca7eeebd93ff"
        }
    }],
    "requestId": "0a60538a5bc6f9cf946d43f5b7f569b0"
}

项搜索结果

    空空如也
    没有找到您要搜索的内容,请直接拨打服务热线400-0590-666