查詢一個安全性群組和其他哪些安全性群組有安全性群組等級的授權行為。
描述
調用該介面時,您需要注意:
-
授權行為包括入方向授權和出方向授權。
-
該介面單次最多返回 100 條記錄。
-
當您無法刪除某一安全性群組(DeleteSecurityGroup)時,可以調用該介面查看指定的安全性群組是否已被其他安全性群組授權。如果指定的安全性群組已被授權,您需要在刪除該安全性群組之前解除授權行為。
請求參數
名稱 | 類型 | 是否必需 | 描述 |
---|---|---|---|
Action | String | 是 | 系統規定參數。取值:DescribeSecurityGroupReferences |
SecurityGroupId.n | String | 是 | 要查詢的第 n 個 SecurityGroupId ,n 的取值範圍為 [1, 10]。 |
RegionId | String | 是 | 安全性群組所屬地域。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。 |
返回參數
名稱 | 類型 | 描述 |
---|---|---|
SecurityGroupReferences | SecurityGroupReference | 所有使用者指定的安全性群組被引用的完整資訊 |
樣本
請求樣本
https://ecs.aliyuncs.com/?Action=DescribeSecurityGroupReferences
&RegionId=cn-hangzhou
&SecurityGroupId.1=sg-1133aa
&<公共請求參數>
返回樣本
XML 格式
<DescribeSecurityGroupReferencesResponse>
<RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
<SecurityGroupReferences>
<SecurityGroupReference>
<SecurityGroupId>sg-1133aa</SecurityGroupId>
<ReferencingSecurityGroups>
<ReferencingSecurityGroup>
<SecurityGroupId>sg-2255cc</SecurityGroupId>
<AliUid>123</AliUid>
</ReferencingSecurityGroup>
<ReferencingSecurityGroup>
<SecurityGroupId>sg-2255dd</SecurityGroupId>
<AliUid>123</AliUid>
</ReferencingSecurityGroup>
</ReferencingSecurityGroups>
</SecurityGroupReference>
</SecurityGroupReferences>
</DescribeSecurityGroupReferencesResponse>
JSON 格式
{
"RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
"SecurityGroupReferences":[
{
"SecurityGroupId":"sg-1133aa",
"SecurityReferencingGroups":[
{
"AliUid":123,
"SecurityGroupId":"sg-2255cc"
},
{
"AliUid":123,
"SecurityGroupId":"sg-2255dd"
}
]
}
]
}
錯誤碼
以下為本介面特有的錯誤碼。更多錯誤碼,請訪問 API 錯誤中心。
錯誤碼 | 錯誤資訊 | HTTP 狀態碼 | 說明 |
---|---|---|---|
Abs.GroupNos.Malformed | The specified parameter SecurityGroupId is essential and size should less than 10. | 400 | 您必須輸入參數 SecurityGroupId.n 。或者 SecurityGroupId.n 中 n 不能超過 10。 |
InvalidSecurityGroupId.NotFound | The specified SecurityGroupId does not exist. | 400 | 指定的安全性群組 ID 不存在。 |
InvalidRegionId.NotFound | The specified RegionId does not exist. | 404 | 指定的 RegionId 不存在。 |