edit-icon download-icon

DescribeSecurityGroupReferences

最終更新日: Jun 26, 2018

説明

指定したセキュリティグループが他のセキュリティグループによって承認されているかどうかを照会し、関連するセキュリティグループが返されるかどうかを問い合わせます。このインターフェイスを呼び出すときは、次の点を考慮してください。

  • セキュリティグループを承認するには、インバウンドルールの承認とアウトバウンドルールの承認が含まれます。

  • 呼び出しごとに最大 100 個の許可レコードが照会できます。

  • DeleteSecurityGroup に失敗した場合、このインターフェイスを呼び出して、指定したセキュリティグループが他のセキュリティグループによって承認されているかどうかを確認できます。削除するセキュリティグループが別のセキュリティグループによって承認されている場合は、削除操作の前に承認を取り消す必要があります。

リクエストパラメータ

名前 必須かどうか 説明
Action String はい このインタフェースの名前。値: DescribeSecurityGroupReferences.
SecurityGroupId.n String はい セキュリティグループの ID。nの値の範囲は[1, 10]です。
RegionId String はい セキュリティグループが属するリージョン。詳細は、DescribeRegionsを参照してください。

レスポンスパラメータ

名前 説明
SecurityGroupReferences SecurityGroupReference セキュリティグループ認可の情報。

リクエストの例

  1. https://ecs.aliyuncs.com/?Action=DescribeSecurityGroupReferences
  2. &RegionId=cn-hangzhou
  3. &SecurityGroupId.1=sg-1133aa
  4. &<Common Request Parameters>

レスポンスの例

XML 形式

  1. <DescribeSecurityGroupReferencesResponse>
  2. <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
  3. <SecurityGroupReferences>
  4. <SecurityGroupReference>
  5. <SecurityGroupId>sg-1133aa</SecurityGroupId>
  6. <ReferencingSecurityGroups>
  7. <ReferencingSecurityGroup>
  8. <SecurityGroupId>sg-2255cc</SecurityGroupId>
  9. <AliUid>123</AliUid>
  10. </ReferencingSecurityGroup>
  11. <ReferencingSecurityGroup>
  12. <SecurityGroupId>sg-2255dd</SecurityGroupId>
  13. <AliUid>123</AliUid>
  14. </ReferencingSecurityGroup>
  15. </ReferencingSecurityGroups>
  16. </SecurityGroupReference>
  17. </SecurityGroupReferences>
  18. </DescribeSecurityGroupReferencesResponse>

JSON 形式

  1. {
  2. "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
  3. "SecurityGroupReferences":[
  4. {
  5. "SecurityGroupId":"sg-1133aa",
  6. "SecurityReferencingGroups":[
  7. {
  8. "AliUid":123,
  9. "SecurityGroupId":"sg-2255cc"
  10. },
  11. {
  12. "AliUid":123,
  13. "SecurityGroupId":"sg-2255dd"
  14. }
  15. ]
  16. }
  17. ]
  18. }

エラーコード

インタフェースに固有のエラーコードは次のとおりです。詳細については、API エラー・センターを参照してください。

エラーコード エラーメッセージ HTTP ステータスコード 意味
Abs.GroupNos.Malformed The specified parameter SecurityGroupId is essential and size should less than 10. 400 SecurityGroupId.nパラメータを指定する必要があります。またはSecurityGroupId.nnは 10 を超えることはできません。
InvalidSecurityGroupId.NotFound The specified SecurityGroupId does not exist. 400 指定されたSecurityGroupIdは存在しません。
InvalidRegionId.NotFound The specified RegionId does not exist. 404 指定されたRegionIdは存在しません。