阿里云如何使用安全组相关接口(3)

查询安全组列表

描述

分页查询用户定义的所有安全组基本信息。每页的数量默认为10条，数据按照安全组ID降序排列。

请求参数

名称 类型 是否必须 描述 Action String 是 系统规定参数，取值：DescribeSecurityGroups RegionId String 是 地域 VpcId String 否 安全组所在的专有网络 Tag.n.Key String 否 标签 key，n 从 1 开始，最大为 5。

不允许为空字符串。 Tag.n.Value String 否 标签 value，n 从 1 开始，最大为 5。

允许为空字符串。 PageNumber Integer 否 当前页码，起始值为 1，默认值为 1 PageSize Integer 否 分页查询时设置的每页行数，最大值 50，默认值为 10

返回参数

名称 类型 描述 TotalCount Integer 安全组的总数 PageNumber Integer 当前页码 PageSize Integer 每页行数 RegionId String 安全组所属地域 Id SecurityGroups SecurityGroupItemType 安全组信息，由 SecurityGroupItemType 组成的集合

错误码

错误代码 描述 Http 状态码 语义 MissingParameter The input parameter "RegionId" that is mandatory for processing this request is not supplied. 400 RegionId 参数未指定 InvalidParameter The specified parameter "PageNumber" is not valid. 400 指定的 PageNumber 参数不合法 InvalidParameter The specified parameter "PageSize" is not valid. 400 指定的 PageSize 参数不合法

示例

请求示例

https://ecs.aliyuncs.com/?Action=DescribeSecurityGroups

&RegionId=cn-hangzhou

&<公共请求参数>

返回示例

JSON格式

{

"RequestId": "94D38899-626D-434A-891F-7E1F77A81525",

"TotalCount": 4,

"PageSize": "10",

"RegionId": "cn-hangzhou",

"PageNumber": "1",

"SecurityGroups": {

"SecurityGroup": [{

"SecurityGroupId": "sg-F876FF7BA",

"Description": "TestByXcf"

},

{

"SecurityGroupId": "sg-086FFC27A",

"Description": "test00212"

},

{

"SecurityGroupId": "sg-BA4B7975B",

"Description": "cn-hangzhou test group"

},

{

"SecurityGroupId": "sg-35F20777C",

"Description": "cn-hangzhou test group"

}]

}

}

所属专题:

如果您觉得本文或图片不错，请把它分享给您的朋友吧！