指定したセキュリティグループが他のセキュリティグループによって承認されているかどうかを照会し、関連するセキュリティグループが返されるかどうかを問い合わせます。このインターフェイスを呼び出すときは、次の点を考慮してください。
-
セキュリティグループを承認するには、インバウンドルールの承認とアウトバウンドルールの承認が含まれます。
-
呼び出しごとに最大 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は存在しません。
|