调用DescribeSecurityGroups查询您创建的安全组的基本信息。

安全组的基本信息包括安全组ID和安全组描述等。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeSecurityGroups

系统参数,取值:

DescribeSecurityGroups。

Version String 2017-11-10

2017-11-10

SecurityGroupId String sg-bp67acfmxazb4ph***

安全组ID。

SecurityGroupName String DocTest

安全组名称。

PageNumber Integer 1

安全组列表的页码。

起始值:1

默认值:1

PageSize Integer 10

分页查询时设置的每页行数。

最大值:50

默认值:10

返回数据

名称 类型 示例值 描述
PageNumber Integer 1

安全组列表的页码。

PageSize Integer 10

分页查询时设置的每页行数。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

SecurityGroups Array

安全组。

SecurityGroup
CreationTime String 2019-11-01T06:08:46Z

创建时间。

SecurityGroupId String sg-bp67acfmxazb4ph***

安全组ID。

SecurityGroupName String DocTest

安全组名称。

TotalCount Integer 49

分页查询时分页总页数。

示例

请求示例

https://ens.aliyuncs.com/?Action=DescribeSecurityGroups
&<公共请求参数>

正常返回示例

XML 格式

<DescribeSecurityGroupsResponse>
  <PageNumber>1</PageNumber>
  <TotalCount>49</TotalCount>
  <PageSize>1</PageSize>
  <RequestId>A1707FC0-430C-423A-B624-284046B20399</RequestId>
  <SecurityGroups>
        <SecurityGroup>
              <CreationTime>2019-11-01T06:08:46Z</CreationTime>
              <SecurityGroupId>sg-bp67acfmxazb4ph***</SecurityGroupId>
              <SecurityGroupName>DocTest</SecurityGroupName>
        </SecurityGroup>
  </SecurityGroups>
</DescribeSecurityGroupsResponse>

JSON 格式

{
  "PageNumber":1,
  "TotalCount":49,
  "PageSize":1,
  "RequestId":"A1707FC0-430C-423A-B624-284046B20399",
  "SecurityGroups":{
    "SecurityGroup":[
      {
        "CreationTime":"2019-11-01T06:08:46Z",
        "SecurityGroupId":"sg-bp67acfmxazb4ph***",
        "SecurityGroupName":"DocTest"
      }
    ]
  }
}

错误码

HttpCode 错误码 错误信息 描述
400 NoPermission Permission denied. 没有足够的权限,请联系云账号管理员授予您相应权限。

访问错误中心查看更多错误码。