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

调试

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

请求参数

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

系统规定参数。取值:DescribeSecurityGroups

Version String 2017-11-10

版本号。

SecurityGroupId String sg-bp67acfmxazb4ph***

安全组ID。

PageNumber Integer 1

安全组列表的页码。

  • 起始值:1。
  • 默认值:1。
PageSize Integer 10

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

  • 最大值:50。
  • 默认值:10。
SecurityGroupName String DocTest

安全组名称。

返回数据

名称 类型 示例值 描述
PageSize Integer 10

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

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

请求ID。

PageNumber Integer 1

安全组列表的页码。

TotalCount Integer 49

分页查询时分页总页数。

SecurityGroups Array of SecurityGroup

安全组。

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

创建时间。按照ISO8601标准表示,并需要使用UTC时间。格式为:yyyy-MM-ddThh:mmZ。

InstanceCount Integer 5

关联实例数量。

Description String TestDescription

安全组描述信息。

SecurityGroupId String sg-bp67acfmxazb4ph***

安全组ID。

SecurityGroupName String DocTest

安全组名称。

示例

请求示例

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

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/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>
            <Description/>
            <InstanceCount>5</InstanceCount>
        </SecurityGroup>
    </SecurityGroups>
</DescribeSecurityGroupsResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/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",
      "Description" : "",
      "InstanceCount" : 5
    } ]
  }
}

错误码

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

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