查询您创建的安全组的基本信息,例如安全组ID和安全组描述等。返回列表按照安全组ID降序排列。
请求参数
名称 | 类型 | 是否必需 | 描述 |
---|---|---|---|
Action | String | 是 | 系统规定参数。取值:DescribeSecurityGroups |
RegionId | String | 是 | 地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。 |
VpcId | String | 否 | 安全组所在的专有网络ID。 |
SecurityGroupIds | Array | 否 | 安全组ID列表。一次最多支持100个安全组ID,ID之间用半角逗号(,)隔开,格式为JSON数组,示例["sg-id1", "sg-id2", "sg-id2",....]。 |
Tag.n.Key | String | 否 | 安全组的标签键。n的取值范围:[1, 20]。一旦传入该值,则不允许为空字符串。最多支持64个字符,不能以aliyun、acs:、http://或者https://开头。 |
Tag.n.Value | String | 否 | 安全组的标签值。n的取值范围:[1, 20]。一旦传入该值,可以为空字符串。最多支持128个字符,不能以aliyun、acs:、http://或者https://开头。 |
PageNumber | Integer | 否 | 安全组列表的页码。起始值:1 默认值:1 |
PageSize | Integer | 否 | 分页查询时设置的每页行数。最大值:50 默认值:10 |
DryRun | Boolean | 否 | 是否只预检此次请求。
默认值:false |
返回参数
名称 | 类型 | 描述 |
---|---|---|
TotalCount | Integer | 安全组的总数 |
PageNumber | Integer | 当前页码 |
PageSize | Integer | 每页行数 |
RegionId | String | 安全组所属地域ID |
SecurityGroups | SecurityGroupItemType | 安全组信息集合 |
示例
请求示例
https://ecs.aliyuncs.com/?Action=DescribeSecurityGroups
&RegionId=cn-hangzhou
&<公共请求参数>
返回示例
XML格式
<DescribeSecurityGroupsResponse>
<RequestId>94D38899-626D-434A-891F-7E1F77A81525</RequestId>
<TotalCount>4</TotalCount>
<PageNumber>1</PageNumber>
<PageSize>10</PageSize>
<RegionId>cn-hangzhou</RegionId>
<SecurityGroups>
<SecurityGroup>
<SecurityGroupId>sg-F876FF7BA</SecurityGroupId>
<Description>Test</Description>
</SecurityGroup>
<SecurityGroup>
<SecurityGroupId>sg-086FFC27A</SecurityGroupId>
<Description>test00212</Description>
</SecurityGroup>
<SecurityGroup>
<SecurityGroupId>sg-BA4B7975B</SecurityGroupId>
<Description>cn-hangzhou test group</Description>
</SecurityGroup>
<SecurityGroup>
<SecurityGroupId>sg-35F20777C</SecurityGroupId>
<Description>cn-hangzhou test group</Description>
</SecurityGroup>
</SecurityGroups>
</DescribeSecurityGroupsResponse>
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"
}]
}
}
错误码
全是公共错误码。更多错误码,请访问API错误中心。