查詢您建立的安全性群組的基本資料，例如安全性群組ID和安全性群組描述等。返回列表按照安全性群組ID降序排列。

請求參數

名稱 類型 是否必需 描述
Action String 是 系統規定參數。取值：DescribeSecurityGroups
RegionId String 是 地域ID。您可以調用DescribeRegions查看最新的阿里雲地域列表。
VpcId String 否 安全性群組所在的專有網路ID。
Tag.n.Key String 否 安全性群組的標籤鍵。n的取值範圍：[1, 5]。一旦傳入該值，則不允許為Null 字元串。
Tag.n.Value String 否 安全性群組的標籤值。n的取值範圍：[1, 5]。一旦傳入該值，可以為Null 字元串。
PageNumber Integer 否 安全性群組列表的頁碼。起始值：1

預設值：1
PageSize Integer 否 分頁查詢時設定的每頁行數。最大值：50

預設值：10
DryRun Boolean 否 是否只預檢此次請求。
  • true：發送檢查請求，不會查詢資源狀況。檢查項包括AccessKey是否有效、RAM使用者的授權情況和是否填寫了必需參數。如果檢查不通過，則返回對應錯誤。如果檢查通過，會返回錯誤碼 DryRunOperation。
  • false：發送正常請求，通過檢查後返回2XX HTTP狀態碼並直接查詢資源狀況。

預設值：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錯誤中心。