指定されたセキュリティグループの詳細を照会します。セキュリティグループルールのリストを含みます。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
ecs:DescribeSecurityGroupAttribute |
get |
*SecurityGroup
|
|
なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| SecurityGroupId |
string |
必須 |
セキュリティグループ ID。 |
sg-bp1gxw6bznjjvhu3**** |
| RegionId |
string |
必須 |
セキュリティグループのリージョン ID。 DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。 |
cn-hangzhou |
| NicType |
string |
任意 |
セキュリティグループルールのネットワークタイプ。
|
intranet |
| Direction |
string |
任意 |
セキュリティグループルールの方向。有効な値:
デフォルト値: all。 |
all |
| NextToken |
string |
任意 |
ページネーショントークン。このパラメーターには前回の呼び出しで返された NextToken 値をセットします。最初のリクエストではこのパラメーターをセットする必要はありません。 |
AAAAAdDWBF2**** |
| MaxResults |
integer |
任意 |
ページングクエリの 1 ページあたりの最大エントリ数。
デフォルト値: 500。 |
500 |
| Attribute |
string |
任意 |
セキュリティグループの属性。有効な値:
|
snapshotPolicyIds |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| VpcId |
string |
VPC ID。VPC ID が返された場合、セキュリティグループのネットワークタイプは VPC です。それ以外の場合、セキュリティグループはクラシックネットワークに属します。 説明
クラシックネットワーク機能はオフラインになりました。詳細については、廃止のお知らせ を参照してください。 |
vpc-bp1opxu1zkhn00gzv**** |
| RequestId |
string |
リクエスト ID |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
| InnerAccessPolicy |
string |
セキュリティグループの内部ネットワーク接続性ポリシー。有効な値:
|
Accept |
| Description |
string |
セキュリティグループの説明。 |
This is description. |
| SecurityGroupId |
string |
セキュリティグループ ID。 |
sg-bp1gxw6bznjjvhu3**** |
| SecurityGroupName |
string |
セキュリティグループの名前。 |
SecurityGroupName Sample |
| RegionId |
string |
リージョン ID。 |
cn-hangzhou |
| Permissions |
object |
||
| Permission |
array<object> |
セキュリティグループルールのコレクション。 |
|
|
object |
|||
| SecurityGroupRuleId |
string |
セキュリティグループルールの ID。 |
sgr-bp12kewq32dfwrdi**** |
| Direction |
string |
セキュリティグループルールのトラフィックの方向。 |
ingress |
| SourceGroupId |
string |
インバウンドルールの送信元セキュリティグループの ID。 |
sg-bp12kc4rqohaf2js**** |
| DestGroupOwnerAccount |
string |
送信先セキュリティグループを所有する Alibaba Cloud アカウントの ID。 |
1234567890 |
| DestPrefixListId |
string |
アウトバウンドルールの送信先プレフィックスリストの ID。 |
pl-x1j1k5ykzqlixabc**** |
| DestPrefixListName |
string |
送信先プレフィックスリストの名前。 |
DestPrefixListName Sample |
| SourceCidrIp |
string |
インバウンドルールの送信元 IPv4 CIDR ブロック。 |
0.0.0.0/0 |
| Ipv6DestCidrIp |
string |
アウトバウンドルールの送信先 IPv6 CIDR ブロック。 |
2001:db8:1233:1a00::*** |
| CreateTime |
string |
ルールが作成された時刻 (協定世界時 (UTC))。 |
2018-12-12T07:28:38Z |
| Ipv6SourceCidrIp |
string |
インバウンドルールの送信元 IPv6 CIDR ブロック。 |
2001:db8:1234:1a00::*** |
| DestGroupId |
string |
アウトバウンドルールの送信先セキュリティグループの ID。 |
sg-bp1czdx84jd88i7v**** |
| DestCidrIp |
string |
アウトバウンドルールの送信先 IPv4 CIDR ブロック。 |
0.0.0.0/0 |
| IpProtocol |
string |
IP プロトコル。 |
TCP |
| Priority |
string |
ルールの優先度。 |
1 |
| DestGroupName |
string |
送信先セキュリティグループの名前。 |
testDestGroupName |
| NicType |
string |
ネットワークタイプ。 |
intranet |
| Policy |
string |
ポリシー。 |
Accept |
| Description |
string |
セキュリティグループルールの説明。 |
Description Sample 01 |
| PortRange |
string |
ポート範囲。 |
80/80 |
| SourcePrefixListName |
string |
送信元プレフィックスリストの名前。 |
SourcePrefixListName Sample |
| SourcePrefixListId |
string |
インバウンドルールの送信元プレフィックスリストの ID。 |
pl-x1j1k5ykzqlixdcy**** |
| SourceGroupOwnerAccount |
string |
送信元セキュリティグループを所有する Alibaba Cloud アカウントの ID。 |
1234567890 |
| SourceGroupName |
string |
送信元セキュリティグループの名前。 |
testSourceGroupName1 |
| SourcePortRange |
string |
送信元ポート範囲。 |
80/80 |
| PortRangeListId |
string |
ポートリストの ID。 |
prl-2ze9743**** |
| PortRangeListName |
string |
ポートリストの名前。 |
PortRangeListNameSample |
| NextToken |
string |
この呼び出しで返されたページングトークン。 |
AAAAAdDWBF2**** |
| SnapshotPolicyIds |
object |
||
| SnapshotPolicyId |
array |
セキュリティグループに関連付けられたスナップショットポリシー ID のリスト。 |
|
|
string |
セキュリティグループに関連付けられたスナップショットポリシー ID。 |
sgsp-mj74**** |
例
成功レスポンス
JSONJSON
{
"VpcId": "vpc-bp1opxu1zkhn00gzv****",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"InnerAccessPolicy": "Accept",
"Description": "This is description.",
"SecurityGroupId": "sg-bp1gxw6bznjjvhu3****",
"SecurityGroupName": "SecurityGroupName Sample",
"RegionId": "cn-hangzhou",
"Permissions": {
"Permission": [
{
"SecurityGroupRuleId": "sgr-bp12kewq32dfwrdi****",
"Direction": "ingress",
"SourceGroupId": "sg-bp12kc4rqohaf2js****",
"DestGroupOwnerAccount": "1234567890",
"DestPrefixListId": "pl-x1j1k5ykzqlixabc****",
"DestPrefixListName": "DestPrefixListName Sample",
"SourceCidrIp": "0.0.0.0/0",
"Ipv6DestCidrIp": "2001:db8:1233:1a00::***",
"CreateTime": "2018-12-12T07:28:38Z",
"Ipv6SourceCidrIp": "2001:db8:1234:1a00::***",
"DestGroupId": "sg-bp1czdx84jd88i7v****",
"DestCidrIp": "0.0.0.0/0",
"IpProtocol": "TCP",
"Priority": "1",
"DestGroupName": "testDestGroupName",
"NicType": "intranet",
"Policy": "Accept",
"Description": "Description Sample 01",
"PortRange": "80/80",
"SourcePrefixListName": "SourcePrefixListName Sample",
"SourcePrefixListId": "pl-x1j1k5ykzqlixdcy****",
"SourceGroupOwnerAccount": "1234567890",
"SourceGroupName": "testSourceGroupName1",
"SourcePortRange": "80/80",
"PortRangeListId": "prl-2ze9743****",
"PortRangeListName": "PortRangeListNameSample"
}
]
},
"NextToken": "AAAAAdDWBF2****",
"SnapshotPolicyIds": {
"SnapshotPolicyId": [
"sgsp-mj74****"
]
}
}エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | InvalidNicType.ValueNotSupported | The specified NicType does not exist. | |
| 400 | InvalidParamter | Invalid Parameter. | |
| 400 | InvalidSecurityGroupId.Malformed | The specified parameter "SecurityGroupId" is not valid. | |
| 400 | MissingParameter.RegionId | The parameter RegionId is missing. | |
| 400 | InvalidParameter.AttributeNotSupported | The specified value for parameter Attribute is not supported. Valid values: snapshotPolicyIds. | |
| 500 | InternalError | The request processing has failed due to some unknown error. | |
| 500 | ServiceUnavailable | The service is unavailable, please try again later. | |
| 404 | InvalidRegionId.NotFound | The specified RegionId does not exist. | |
| 404 | InvalidSecurityGroupId.NotFound | The specified SecurityGroupId does not exist. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。