全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件
云服务器 ECS

DescribeSecurityGroups

更新时间:2018-03-23 08:28:37

描述

查询您创建的安全组的基本信息,例如安全组 ID 和安全组描述等。返回列表按照安全组 ID 降序排列。

请求参数

名称 类型 是否必需 描述
Action String 系统规定参数。取值:DescribeSecurityGroups
RegionId String 地域 ID。更多详情,请参阅 地域与可用区,或者调用 DescribeRegions 查看最新的阿里云地域列表。
VpcId String 安全组所在的专有网络 ID。
Tag.n.Key String 安全组的标签键。n 的取值范围:[1, 5]。
一旦传入该值,则不允许为空字符串。
Tag.n.Value String 安全组的标签值。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. }

错误码

全是公共错误码。参阅 公共错误码

本文导读目录