Elastic Compute Service (ECS) のセキュリティグループに 1 つ以上のインバウンドルールを追加します。この操作では、セキュリティグループのインバウンドアクセス権限を指定し、他のデバイスからセキュリティグループ内のインスタンスへのインバウンドトラフィックを許可または拒否することで、きめ細かなネットワークアクセスの制御を実現します。
操作説明
事前準備
クォータ制限: 単一の Elastic Network Interface (ENI) に関連付けられているすべてのセキュリティグループにおけるルールの合計数 (インバウンドルールとアウトバウンドルールを含む) は、1,000 を超えることはできません。制限の詳細については、「セキュリティグループの使用制限」をご参照ください。
優先度の設定: インバウンドルールの優先度の有効値は 1 から 100 です。値が小さいほど優先度が高くなります。優先度が同じセキュリティグループルールの場合、アクセスを拒否する (drop) ルールが優先されます。
注意事項
指定されたセキュリティグループルールがすでに存在する場合、呼び出しは成功しますが、新しいルールは追加されません。
ルールの定義
インバウンドルールを定義するには、次のパラメーターが必須です。
ソース設定: 次のいずれかのパラメーターを指定します。SourceCidrIp (IPv4 アドレス)、Ipv6SourceCidrIp (IPv6 アドレス)、SourcePrefixListId (プレフィックスリスト ID)、または SourceGroupId (ソースセキュリティグループ)。
宛先ポート範囲: PortRange。
プロトコルの種類: IpProtocol。
アクセスポリシー: Policy。
高度なセキュリティグループでは、他のセキュリティグループからのアクセスに対する権限付与はサポートされていません。基本セキュリティグループでは、最大 20 個のセキュリティグループに対する権限付与がサポートされています。
リクエストの例
次の例は、中国 (杭州) リージョンの指定されたセキュリティグループに、異なるソースを持つインバウンドルールを追加する方法を示しています。
-
指定された IP アドレス範囲のアクセス権限を追加します。
"RegionId":"cn-hangzhou", // リージョン ID を指定します。 "SecurityGroupId":"sg-bp67acfmxazb4p****", // セキュリティグループ ID を指定します。 "Permissions":[ { "SourceCidrIp":"10.0.0.0/8", // ソース IPv4 アドレスを指定します。 "PortRange":"22/22", // ポート範囲を指定します。 "IpProtocol":"TCP", // プロトコルの種類を指定します。 "Policy":"Accept" // アクセスポリシーを指定します。 } ] -
別のセキュリティグループおよびプレフィックスリストのアクセス権限を追加します。
"RegionId":"cn-hangzhou", "SecurityGroupId":"sg-bp67acfmxazb4p****", "Permissions":[ { "SourceGroupId":"sg-bp17vs63txqxbd****", // ソースセキュリティグループ ID を指定します。 "PortRange":"22/22", "IpProtocol":"TCP", "Policy":"Drop" },{ "SourcePrefixListId":"pl-x1j1k5ykzqlixdcy****", // ソースプレフィックスリスト ID を指定します。 "PortRange":"22/22", "IpProtocol":"TCP", "Policy":"Drop" } ]
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
ecs:AuthorizeSecurityGroup |
create |
*All resources
|
|
なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
必須 |
セキュリティグループのリージョン ID。 DescribeRegions 操作を呼び出して、最新のリージョンリストをクエリできます。 |
cn-hangzhou |
| RegionId |
string |
必須 |
リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。トークンには ASCII 文字のみを使用でき、長さは 64 文字を超えることはできません。詳細については、「べき等性を確保する方法」をご参照ください。 |
123e4567-e89b-12d3-a456-426655440000 |
| RegionId |
string |
必須 |
セキュリティグループ ID。 |
sg-bp67acfmxazb4p**** |
| ClientToken |
string |
任意 |
セキュリティグループルール。配列の長さ: 1 から 100。 |
123e4567-e89b-12d3-a456-426655440000 |
| ClientToken |
string |
任意 |
[非推奨] アクセスポリシーを設定するには、Permissions.N.Policy を使用します。 |
accept |
| SecurityGroupId |
string |
必須 |
[非推奨] セキュリティグループルールの優先度を指定するには、Permissions.N.Priority を使用します。 |
1 |
| SecurityGroupId |
string |
必須 |
[非推奨] プロトコルの種類を指定するには、Permissions.N.IpProtocol を使用します。 |
ALL |
| Permissions |
array<object> |
任意 |
[非推奨] ソース IPv4 CIDR ブロックを指定するには、Permissions.N.SourceCidrIp を使用します。 |
10.0.0.0/8 |
|
object |
任意 |
セキュリティグループルール。 |
||
| Policy |
string |
任意 |
アクセス権限の設定項目。有効な値:
デフォルト値: accept。 |
accept |
| Priority |
string |
任意 |
セキュリティグループルールの優先度。値が小さいほど優先度が高くなります。有効な値: 1~100。 デフォルト値: 1。 |
1 |
| IpProtocol |
string |
任意 |
ネットワーク層またはトランスポート層のプロトコル。2 種類の値がサポートされています。
|
ALL |
| SourceCidrIp |
string |
任意 |
アクセス権限を設定するソース IPv4 CIDR ブロック。CIDR 形式および IPv4 形式のアドレス有効値がサポートされています。 |
10.0.0.0/8 |
| Ipv6SourceCidrIp |
string |
任意 |
アクセス権限を設定するソース IPv6 CIDR ブロック。CIDR 形式および IPv6 形式のアドレス有効値がサポートされています。 説明
このパラメーターは、IPv6 をサポートする VPC 接続の ECS インスタンスに対してのみ効果があります。このパラメーターと |
2001:250:6000::*** |
| SourceGroupId |
string |
任意 |
アクセス権限を設定するソースセキュリティグループの ID。
|
sg-bp67acfmxazb4p**** |
| SourcePrefixListId |
string |
任意 |
アクセス権限を設定するソースプレフィックスリストの ID。 DescribePrefixLists を呼び出して利用可能なプレフィックスリスト ID をクエリできます。 使用上の注意:
詳細については、「セキュリティグループの使用制限」を参照してください。 |
pl-x1j1k5ykzqlixdcy**** |
| PortRange |
string |
任意 |
セキュリティグループのプロトコルに対応する宛先ポートの範囲。有効値:
ポートの適用シナリオの詳細については、「一般的なポート」を参照してください。 |
80/80 |
| DestCidrIp |
string |
任意 |
宛先 IPv4 CIDR ブロック。CIDR ブロックおよび IPv4 アドレス有効値がサポートされています。 このパラメーターは 5 タプルルールをサポートするために使用されます。詳細については、「セキュリティグループの 5 タプルルール」を参照してください。 |
10.0.0.0/8 |
| Ipv6DestCidrIp |
string |
任意 |
宛先 IPv6 CIDR ブロック。CIDR 形式および IPv6 形式のアドレス有効値がサポートされています。 このパラメーターは 5 タプルルールをサポートするために使用されます。詳細については、「セキュリティグループの 5 タプルルール」を参照してください。 説明
このパラメーターは、IPv6 をサポートする VPC 接続の ECS インスタンスに対してのみ効果があります。このパラメーターと |
2001:250:6000::*** |
| SourcePortRange |
string |
任意 |
セキュリティグループのプロトコルに対応する送信元ポートの範囲。有効値:
このパラメーターは 5 タプルルールをサポートするために使用されます。詳細については、「セキュリティグループの 5 タプルルール」を参照してください。 |
7000/8000 |
| SourceGroupOwnerAccount |
string |
任意 |
クロスアカウントセキュリティグループルールを設定する際の、ソースセキュリティグループを所有する Alibaba Cloud アカウント。設定項目は以下の通りです。
|
test@aliyun.com |
| SourceGroupOwnerId |
integer |
任意 |
クロスアカウントセキュリティグループルールを設定する際の、ソースセキュリティグループを所有する Alibaba Cloud アカウントの ID。設定項目は以下の通りです。
|
1234567890 |
| NicType |
string |
任意 |
クラシックネットワークセキュリティグループルールのネットワークインターフェースコントローラー (NIC) タイプ。設定項目には以下の有効な値が含まれます。
VPC セキュリティグループルールの場合、ネットワークインターフェースコントローラー (NIC) タイプを設定する必要はありません。デフォルト値は intranet であり、intranet のみがサポートされています。 セキュリティグループ間の相互アクセスを設定する場合、つまり DestGroupId パラメーターのみが指定されている場合は、intranet のみがサポートされます。 デフォルト値: internet。 |
intranet |
| Description |
string |
任意 |
セキュリティグループルールの説明。説明の長さは 1~512 文字である必要があります。 |
This is description. |
| PortRangeListId |
string |
任意 |
ポートアドレス帳の ID。
|
prl-2ze9743**** |
Policy
deprecated
|
string |
任意 |
[非推奨] ソース IPv6 CIDR ブロックを指定するには、Permissions.N.Ipv6SourceCidrIp を使用します。 |
2001:250:6000::*** |
Priority
deprecated
|
string |
任意 |
[非推奨] ソースセキュリティグループ ID を指定するには、Permissions.N.SourceGroupId を使用します。 |
sg-bp67acfmxazb4p**** |
IpProtocol
deprecated
|
string |
任意 |
[非推奨] ソースプレフィックスリスト ID を指定するには、Permissions.N.SourcePrefixListId を使用します。 |
pl-x1j1k5ykzqlixdcy**** |
SourceCidrIp
deprecated
|
string |
任意 |
[非推奨] ポート範囲を指定するには、Permissions.N.PortRange を使用します。 |
22/22 |
Ipv6SourceCidrIp
deprecated
|
string |
任意 |
[非推奨] 送信先 IPv4 CIDR ブロックを指定するには、Permissions.N.DestCidrIp を使用します。 |
10.0.0.0/8 |
SourceGroupId
deprecated
|
string |
任意 |
[非推奨] 送信先 IPv6 CIDR ブロックを指定するには、Permissions.N.Ipv6DestCidrIp を使用します。 |
null |
SourcePrefixListId
deprecated
|
string |
任意 |
[非推奨] 送信元ポート範囲を指定するには、Permissions.N.SourcePortRange を使用します。 |
22/22 |
PortRange
deprecated
|
string |
任意 |
[非推奨] ソースセキュリティグループが属する Alibaba Cloud アカウントを指定するには、Permissions.N.SourceGroupOwnerAccount を使用します。 |
test@aliyun.com |
DestCidrIp
deprecated
|
string |
任意 |
[非推奨] ソースセキュリティグループが属する Alibaba Cloud アカウントの ID を指定するには、Permissions.N.SourceGroupOwnerId を使用します。 |
1234567890 |
Ipv6DestCidrIp
deprecated
|
string |
任意 |
[非推奨] NIC タイプを指定するには、Permissions.N.NicType を使用します。 |
intranet |
SourcePortRange
deprecated
|
string |
任意 |
[非推奨] セキュリティグループルールの説明を指定するには、Permissions.N.Description を使用します。 |
This is description. |
SourceGroupOwnerAccount
deprecated
|
string |
任意 |
非推奨。ソースセキュリティグループを所有する Alibaba Cloud アカウントを指定するには |
test@aliyun.com |
SourceGroupOwnerId
deprecated
|
integer |
任意 |
非推奨。ソースセキュリティグループを所有する Alibaba Cloud アカウントの ID を指定するには |
1234567890 |
NicType
deprecated
|
string |
任意 |
非推奨。NIC タイプを指定するには |
intranet |
Description
deprecated
|
string |
任意 |
非推奨。セキュリティグループルールの説明を指定するには |
This is description. |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| RequestId |
string |
リクエスト ID |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
例
成功レスポンス
JSONJSON
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | OperationDenied | The specified IpProtocol does not exist or IpProtocol and PortRange do not match. | 指定されたスナップショットではデータボリュームの作成が許可されていません。 |
| 400 | InvalidIpProtocol.Malformed | The specified parameter PortRange is not valid. | IP プロトコルパラメーターの形式が正しくなく、PortRange パラメーターは無効です。 |
| 400 | InvalidSourceCidrIp.Malformed | The specified parameter SourceCidrIp is not valid. | ソース IP アドレスの有効値パラメーターの形式が無効です。 |
| 400 | InvalidPolicy.Malformed | The specified parameter Policy is not valid. | 指定されたパラメーターは無効です。パラメーターが正しいかどうかを確認してください。 |
| 400 | InvalidNicType.ValueNotSupported | The specified NicType does not exist. | 指定されたネットワークタイプは存在しません。ネットワークタイプが正しいかどうかを確認してください。 |
| 400 | InvalidNicType.Mismatch | The specified NicType conflicts with the authorization record. | 指定された NIC タイプはルール情報と競合しています。 |
| 400 | InvalidSourceGroupId.Mismatch | Specified security group and source group are not in the same VPC. | 指定されたセキュリティグループとソースセキュリティグループが同じ VPC 内にありません。 |
| 400 | InvalidSourceGroup.NotFound | Specified source security group does not exist. | 指定されたインバウンドセキュリティグループルールが存在しないか、関連パラメーターが不足しています。 |
| 400 | InvalidPriority.Malformed | The parameter Priority is invalid. | 指定された Priority パラメーターが無効です。 |
| 400 | InvalidPriority.ValueNotSupported | The specified parameter %s is invalid. | セキュリティグループルールの優先度が無効です。有効な値: 1~100。 |
| 400 | InvalidSecurityGroupDiscription.Malformed | The specified security group rule description parameter %s is not valid. | 指定されたセキュリティグループの説明は無効です。 |
| 400 | InvalidSecurityGroup.InvalidNetworkType | The specified security group network type is not support this operation, please check the security group network types. For VPC security groups, ClassicLink must be enabled. | 指定されたセキュリティグループのネットワークタイプはこの操作をサポートしていません。 |
| 400 | MissingParameter.Source | One of the parameters SourceCidrIp, Ipv6SourceCidrIp, SourceGroupId or SourcePrefixListId in %s must be specified. | SourceCidrIp パラメーターと SourceGroupId パラメーターの両方を空にすることはできません。 |
| 400 | InvalidParam.PortRange | The specified parameter %s is not valid. It should be two integers less than 65535 in ?/? format. | 宛先ポート範囲または送信元ポート範囲を指定してください。ポート番号は 65535 未満である必要があります。ポート範囲を指定する場合は、区切り文字としてスラッシュ (/) を使用してください。 |
| 400 | InvalidIpProtocol.ValueNotSupported | The parameter %s must be specified with case insensitive TCP, UDP, ICMP, GRE or All. | IP プロトコルパラメーターに指定された値はサポートされていません。 |
| 400 | InvalidSecurityGroupId.Malformed | The specified parameter SecurityGroupId is not valid. | 指定された SecurityGroupId は無効です。 |
| 400 | InvalidParamter.Conflict | The specified SourceCidrIp should be different from the DestCidrIp. | 権限を付与されるセキュリティグループと権限を付与するセキュリティグループは異なる必要があります。 |
| 400 | InvalidSourcePortRange.Malformed | The specified parameter SourcePortRange is not valid. | 指定された SourcePortRange パラメーターは無効です。 |
| 400 | InvalidPortRange.Malformed | The specified parameter PortRange must set. | PortRange パラメーターは必須です。 |
| 400 | InvalidParam.SourceIp | The Parameters SourceCidrIp and Ipv6SourceCidrIp in %s cannot be set at the same time. | 指定された SourceIp パラメーターは無効です。 |
| 400 | InvalidParam.DestIp | The Parameters DestCidrIp and Ipv6DestCidrIp in %s cannot be set at the same time. | 指定された DestIp パラメーターは無効です。 |
| 400 | InvalidParam.Ipv6DestCidrIp | The specified parameter %s is not valid. | 指定されたパラメーターは無効です。 |
| 400 | InvalidParam.Ipv6SourceCidrIp | The specified parameter %s is not valid. | 指定されたパラメーターは無効です。 |
| 400 | InvalidParam.Ipv4ProtocolConflictWithIpv6Address | IPv6 address cannot be specified for IPv4-specific protocol. | 指定されたパラメーターは無効です。IPv4 プロトコルに IPv6 アドレスが指定されていないか確認してください。 |
| 400 | InvalidParam.Ipv6ProtocolConflictWithIpv4Address | IPv4 address cannot be specified for IPv6-specific protocol. | 指定されたパラメーターは無効です。IPv6 プロトコルに IPv4 アドレスが指定されていないか確認してください。 |
| 400 | InvalidParameter.Ipv6CidrIp | The specified Ipv6CidrIp is not valid. | 指定された Ipv6CidrIp パラメーターは無効です。 |
| 400 | InvalidGroupAuthParameter.OperationDenied | The security group can not authorize to enterprise level security group. | セキュリティグループをアドバンストセキュリティグループに権限付与することはできません。 |
| 400 | InvalidDestCidrIp.Malformed | The specified parameter DestCidrIp is not valid. | 指定された DestCidrIp は無効です。このパラメーターが正しいかどうかを確認してください。 |
| 400 | InvalidParameter.Conflict | IPv6 and IPv4 addresses cannot exist at the same time. | パラメーターが競合しています。 |
| 400 | InvalidParam.PrefixListAddressFamilyMismatch | The address family of the specified prefix list does not match the specified CidrIp. | 指定されたプレフィックスリストのアドレスファミリが、指定された CidrIP のアドレスファミリと一致しません。 |
| 400 | NotSupported.ClassicNetworkPrefixList | The prefix list is not supported when the network type of security group is classic. | このセキュリティグループはクラシックネットワークタイプを使用しているため、プレフィックスリストはサポートされていません。 |
| 400 | AuthorizedGroupRule.LimitExceed | You have reached the limit on the number of group authorization rules that you can add to a security group.When authorization object of rule is security group, the limit is 20. | 基本セキュリティグループには、他のセキュリティグループを権限付与オブジェクトとして参照するルールを最大 20 個まで設定できます。 |
| 400 | InvalidParam.SourceCidrIp | The specified parameter %s is not valid. | SourceCidrIp パラメーターは無効です。 |
| 400 | InvalidParam.DestCidrIp | The specified parameter %s is not valid. | 指定された DestCidrIp パラメーターは無効です。 |
| 400 | MissingParameter | %s | 必須パラメーターが指定されていません。 |
| 400 | InvalidParam.Permissions | The specified parameter Permissions cannot coexist with other parameters. | 指定された Permissions パラメーターは、他のパラメーターと同時に指定できません。 |
| 400 | InvalidParam.DuplicatePermissions | There are duplicate permissions in the specified parameter Permissions. | 指定された Permissions パラメーターに重複するルールが含まれています。 |
| 400 | InvalidGroupParameter.OperationDenied | The attributes Policy, SourceGroupId, DestGroupId of enterprise level security groups are not allowed to be set or modified. | アドバンスドセキュリティグループの Priority、Policy、SourceGroupId、および DestGroupId 属性は設定または変更できません。 |
| 400 | InvalidParam.ProtocolNotSupportPortRangeList | The specified protocol does not support the port range list. | 指定されたプロトコルはポートリストをサポートしていません。 |
| 400 | InvalidPortRangeListId.NotFound | The specified port range list was not found. | 指定されたポートアドレス帳が見つかりませんでした。 |
| 401 | InvalidOperation.SecurityGroupNotAuthorized | The specified security group is not authorized to operate. | 指定されたセキュリティグループに対して操作を実行する権限がありません。 |
| 500 | InternalError | The request processing has failed due to some unknown error. | |
| 403 | InvalidSourceGroupId.Mismatch | NicType is required or NicType expects intranet. | 指定されたセキュリティグループとソースセキュリティグループが同じ VPC 内にありません。 |
| 403 | MissingParameter | The input parameter SourceGroupId or SourceCidrIp cannot be both blank. | 必須パラメーターが指定されていません。 |
| 403 | AuthorizationLimitExceed | The limit of authorization records in the security group reaches. | |
| 403 | InvalidParamter.Conflict | The specified SecurityGroupId should be different from the SourceGroupId. | 権限を付与されるセキュリティグループと権限を付与するセキュリティグループは異なる必要があります。 |
| 403 | InvalidNetworkType.Mismatch | The specified SecurityGroup network type should be same with SourceGroup network type (vpc or classic). | 指定されたネットワーク課金メソッドは、インスタンスのネットワークタイプではサポートされていません。 |
| 403 | InvalidNetworkType.Conflict | The specified SecurityGroup network type should be same with SourceGroup network type (vpc or classic). | 指定されたセキュリティグループのネットワークタイプは、ソースセキュリティグループのネットワークタイプと同じである必要があります。 |
| 403 | InvalidOperation.ResourceManagedByCloudProduct | %s | クラウドサービスのマネージドセキュリティグループは変更操作をサポートしていません。 |
| 403 | LimitExceed.PrefixListAssociationResource | The number of resources associated with the prefix list exceeds the limit. | プレフィックスリストに関連付けられているリソース数が上限を超えています。 |
| 404 | InvalidSecurityGroupId.NotFound | The specified SecurityGroupId does not exist. | 指定されたセキュリティグループはアカウント配下に存在しません。セキュリティグループ ID が正しいかどうかを確認してください。 |
| 404 | InvalidSourceGroupId.NotFound | The SourceGroupId provided does not exist in our records. | 指定された送信元セキュリティグループは存在しません。 |
| 404 | InvalidPrefixListId.NotFound | The specified prefix list was not found. | プレフィックスリストが存在しません。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。