セキュリティグループのいずれかを記述します。

リクエストパラメータ

名前必須かどうか説明
ActionStringはいこのインターフェイスの名前。値:DescribeSecurityGroupAttribute
RegionId Stringはいセキュリティグループが属するリージョンの ID 。DescribeRegions API を呼び出してください。
SecurityGroupId Stringはいセキュリティグループ ID。
NicType Stringいいえネットワークインターフェイス型 。オプションの値:
  • Internet:インターネット
  • Intranet:イントラネット
デフォルト値:Internet
DirectionStringいいえ 型ルールのオプションの値:
  • Egress:アウトバウンドの認可ルール。
  • Ingress:インバウンドの認可ルール。
  • ALL:アウトバウンドとインバウンドの許可規則の両方。
デフォルト値:ALL

リターンパラメータ

説明
SecurityGroupId Stringターゲットセキュリティグループ ID
SecurityGroupName Stringセキュリティグループ名。
RegionId Stringリージョンの ID。
DescriptionStringセキュリティグループの説明。
InnerAccessPolicy String指定されたクライアントまたはセキュリティグループからのリクエストが許可されているかどうか。オプションの値:
  • Accept:要求が許可されています。
  • Drop:要求が拒否されています。
Permissions PermissionType PermissionType の集まりで構成されるセキュリティグループに許可ルールを示します。
VpcId String VPC ID 。 VpcId が返された場合は、セキュリティグループは、VPC 接続されています。そうでない場合、それはクラシックネットワークに接続されたセキュリティグループです。

リクエスト例
  1. https://ecs.aliyuncs.com/?Action=DescribeSecurityGroupAttribute&RegionId=cn-hangzhou&SecurityGroupId=sg-F876FF7BA&<Common Request Parameters>
レスポンス例

XML 形式

  1. <DescribeSecurityGroupAttributeResponse> <RequestId>1651FBB6-4FBF-49FF-A9F5-DF5D696C7EC6</RequestId> <RegionId>cn-hangzhou</RegionId> <SecurityGroupId>C0003E8B-B930-4F59-ADC0-0E209A9012B0</SecurityGroupId> <Description>for demo</Description> <InnerAccessPolicy>Accept</InnerAccessPolicy> <Permissions> <Permission> <IpProtocol>ALL</IpProtocol> <PortRange>-1/-1</PortRange> <SourceGroupId>8dsmf982</SourceGroupId> <SourceGroupOwnerAccount>test@aliyun.com</SourceGroupOwnerAccount> <Policy>Accept</Policy> <NicType>intranet</NicType> </Permission> <Permission> <IpProtocol>tcp</IpProtocol> <PortRange>1/65535</PortRange> <SourceCidrIp>0.0.0.0/0</SourceCidrIp> <Policy>accept</Policy> <NicType>internet</NicType> </Permission> </Permissions></DescribeSecurityGroupAttributeResponse>
JSON 形式
  1. RequestId”: 1651FBB6-4FBF-49FF-A9F5-DF5D696C7EC6”, RegionId”: cn-hangzhou”, SecurityGroupId”: C0003E8B-B930-4F59-ADC0-0E209A9012B0”, Description”: for demo”, Permissions”: { Permission”: [{ IpProtocol”: ALL”, PortRange”: “-1/-1”, SourceGroupId”: 8dsmf982”, SourceGroupOwnerAccount”: test@aliyun.com Policy”: Accept”, NicType”: intranet IpProtocol”: tcp”, PortRange”: 1/65535”, SourceCidrIp”: 0.0.0.0/0”, Policy”: accept”, Nictype”: Internet }

エラーコード

次のように、このインターフェイスに固有のエラーコードがあります。詳細については APIのエラーセンター

エラーコードエラー情報 HTTP ステータスコード説明
InvalidNicType.ValueNotSupported The specified NicType does not exist. 400 指定された NicType 存在しません。
InvalidRegionId.NotFound The specified RegionId does not exist. 404 指定された RegionId 存在しません。
InvalidSecurityGroupId.NotFound The specified SecurityGroupId does not exist. 404 指定された SecurityGroupId 存在しません。