指定したセキュリティグループが他のセキュリティグループによって承認されているかどうかを照会し、関連するセキュリティグループが返されるかどうかを問い合わせます。このインターフェイスを呼び出すときは、次の点を考慮してください。
-
セキュリティグループを承認するには、インバウンドルールの承認とアウトバウンドルールの承認が含まれます。
-
呼び出しごとに最大 100 個の許可レコードが照会できます。
-
DeleteSecurityGroup に失敗した場合、このインターフェイスを呼び出して、指定したセキュリティグループが他のセキュリティグループによって承認されているかどうかを確認できます。削除するセキュリティグループが別のセキュリティグループによって承認されている場合は、削除操作の前に承認を取り消す必要があります。
リクエストパラメータ
名前 | 型 | 必須かどうか | 説明 |
---|---|---|---|
Action | String | はい | このインタフェースの名前。値: DescribeSecurityGroupReferences. |
SecurityGroupId.n | String | はい | セキュリティグループの ID。n の値の範囲は[1, 10]です。
|
RegionId | String | はい | セキュリティグループが属するリージョン。詳細は、DescribeRegionsを参照してください。 |
レスポンスパラメータ
名前 | 型 | 説明 |
---|---|---|
SecurityGroupReferences | SecurityGroupReference | セキュリティグループ認可の情報。 |
例
リクエストの例
https://ecs.aliyuncs.com/?Action=DescribeSecurityGroupReferences
&RegionId=cn-hangzhou
&SecurityGroupId.1=sg-1133aa
&<Common Request Parameters>
レスポンスの例
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 | 指定されたSecurityGroupId は存在しません。
|
InvalidRegionId.NotFound | The specified RegionId does not exist. | 404 | 指定されたRegionId は存在しません。
|