全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
云服务器 ECS

DescribeSecurityGroups

更新时间:2017-09-13 14:33:37

描述

分页查询用户定义的所有安全组基本信息。每页的数量默认为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 组成的集合

错误码

参考公共错误码

示例

请求示例

  1. https://ecs.aliyuncs.com/?Action=DescribeSecurityGroups
  2. &RegionId=cn-hangzhou
  3. &<公共请求参数>

返回示例

XML格式

  1. <DescribeSecurityGroupsResponse>
  2. <RequestId>94D38899-626D-434A-891F-7E1F77A81525</RequestId>
  3. <TotalCount>4</TotalCount>
  4. <PageNumber>1</PageNumber>
  5. <PageSize>10</PageSize>
  6. <RegionId>cn-hangzhou</RegionId>
  7. <SecurityGroups>
  8. <SecurityGroup>
  9. <SecurityGroupId>sg-F876FF7BA</SecurityGroupId>
  10. <Description>Test</Description>
  11. </SecurityGroup>
  12. <SecurityGroup>
  13. <SecurityGroupId>sg-086FFC27A</SecurityGroupId>
  14. <Description>test00212</Description>
  15. </SecurityGroup>
  16. <SecurityGroup>
  17. <SecurityGroupId>sg-BA4B7975B</SecurityGroupId>
  18. <Description>cn-hangzhou test group</Description>
  19. </SecurityGroup>
  20. <SecurityGroup>
  21. <SecurityGroupId>sg-35F20777C</SecurityGroupId>
  22. <Description>cn-hangzhou test group</Description>
  23. </SecurityGroup>
  24. </SecurityGroups>
  25. </DescribeSecurityGroupsResponse>

JSON格式

  1. {
  2. "RequestId": "94D38899-626D-434A-891F-7E1F77A81525",
  3. "TotalCount": 4,
  4. "PageSize": "10",
  5. "RegionId": "cn-hangzhou",
  6. "PageNumber": "1",
  7. "SecurityGroups": {
  8. "SecurityGroup": [{
  9. "SecurityGroupId": "sg-F876FF7BA",
  10. "Description": "TestByXcf"
  11. },
  12. {
  13. "SecurityGroupId": "sg-086FFC27A",
  14. "Description": "test00212"
  15. },
  16. {
  17. "SecurityGroupId": "sg-BA4B7975B",
  18. "Description": "cn-hangzhou test group"
  19. },
  20. {
  21. "SecurityGroupId": "sg-35F20777C",
  22. "Description": "cn-hangzhou test group"
  23. }]
  24. }
  25. }
本文导读目录