すべてのプロダクト
Search
ドキュメントセンター

Elastic Compute Service:ModifySecurityGroupEgressRule

最終更新日:Jun 29, 2026

アウトバウンドセキュリティグループルールを変更します。

操作説明

セキュリティグループルール ID を指定してセキュリティグループルールを変更する場合、以下の使用制限に注意してください:

  • セキュリティグループルールの権限付与オブジェクトには、IPv4 CIDR ブロック(または IP アドレス)、IPv6 CIDR ブロック(または IP アドレス)、セキュリティグループ、またはプレフィックスリストを指定できます。この操作を使用して、既存のセキュリティグループルールの権限付与オブジェクトのタイプを変更することはできません。たとえば、元の権限付与オブジェクトタイプが IPv4 CIDR ブロックの場合、別の IPv4 CIDR ブロック(または IP アドレス)に変更できますが、IPv6 CIDR ブロック(または IP アドレス)、セキュリティグループ、またはプレフィックスリストに変更することはできません。

  • フィールド値を空でない値から空の値に変更することはできません。この場合にセキュリティグループルールを変更するには、新しいルールを追加してから現在のルールを削除してください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ecs:ModifySecurityGroupEgressRule

update

*All Resource

*

  • ecs:tag
  • ecs:tag
  • ecs:SecurityGroupIpProtocols
  • ecs:SecurityGroupSourceCidrIps
なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId

string

必須

ソースセキュリティグループのリージョン ID。 DescribeRegions を呼び出して最新のリージョンリストをクエリできます。

cn-hangzhou

RegionId

string

必須

ソースセキュリティグループのリージョン ID。 DescribeRegions を呼び出して最新のリージョンリストをクエリできます。

cn-hangzhou

ClientToken

string

任意

リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認してください。ClientToken の値には ASCII 文字のみを含めることができ、64 文字を超えることはできません。詳細については、べき等性の確保方法 を参照してください。

123e4567-e89b-12d3-a456-426655440000

SecurityGroupId

string

必須

セキュリティグループ ID。

sg-bp67acfmxazb4p****

SecurityGroupRuleId

string

任意

セキュリティグループルール ID。 DescribeSecurityGroupAttribute を呼び出してセキュリティグループルール ID をクエリできます。

sgr-bp67acfmxazb4q****

Policy

string

任意

アクセス権限。有効な値:

  • accept: アクセスを許可します。

  • drop: アクセスを拒否し、拒否応答を返しません。

デフォルト値: accept。

accept

Priority

string

任意

セキュリティグループルールの優先度。有効な値: 1~100。

デフォルト値: 1。

1

IpProtocol

string

任意

ネットワーク層またはトランスポートレイヤープロトコル。2 種類の値がサポートされています:

  1. 大文字小文字を区別しないプロトコル名。有効な値:

  • ICMP

  • GRE

  • TCP

  • UDP

  • ALL: すべてのプロトコルがサポートされます。

  1. IANA 仕様に準拠するプロトコル番号(0~255 の整数)。現在この特徴をサポートしているリージョン:

  • フィリピン

  • 英国(ロンドン)

  • マレーシア

  • 中国(フフホト)

  • 中国(青島)

  • 米国(バージニア)

  • シンガポール

tcp

DestCidrIp

string

任意

送信先 IPv4 CIDR ブロック。CIDR 形式および IPv4 形式の IP アドレス範囲がサポートされています。

デフォルト値: null。

10.0.0.0/8

Ipv6DestCidrIp

string

任意

送信先 IPv6 CIDR ブロック。CIDR 形式および IPv6 形式の IP アドレス範囲がサポートされています。

説明

VPC タイプの IP アドレスのみがサポートされています。このパラメーターと DestCidrIp を同時に指定することはできません。両方のパラメーターを同時に設定することは許可されていません。

デフォルト値: null。

2001:db8:1233:1a00::***

DestGroupId

string

任意

アクセス権限を付与する送信先セキュリティグループの ID。DestGroupIdDestCidrIp のうち少なくとも 1 つを指定してください。

  • DestGroupId、DestCidrIp、Ipv6DestCidrIp、DestPrefixListId のうち少なくとも 1 つを指定してください。

  • DestGroupId が指定され、DestCidrIp が指定されていない場合、NicType パラメーターは intranet のみに設定できます。

  • DestGroupId と DestCidrIp の両方が指定された場合、DestCidrIp が優先されます。

sg-bp67acfmxa123b****

DestPrefixListId

string

任意

送信先プレフィックスリストの ID。 DescribePrefixLists を呼び出して使用可能なプレフィックスリスト ID をクエリできます。

DestCidrIpIpv6DestCidrIp、または DestGroupId のいずれかを指定した場合、このパラメーターは無視されます。

pl-x1j1k5ykzqlixdcy****

PortRange

string

任意

トランスポートレイヤープロトコルに対応する送信先ポート範囲。有効な値:

  • TCP/UDP の場合: 有効な値は 1~65535 です。開始ポートと終了ポートをスラッシュ(/)で区切ります。例: 1/200。

  • ICMP の場合: -1/-1。

  • GRE の場合: -1/-1。

  • ALL の場合: -1/-1。

80/80

SourceCidrIp

string

任意

ソース IPv4 CIDR ブロック。CIDR 形式および IPv4 形式の IP アドレス範囲がサポートされています。

デフォルト値: null。

10.0.0.0/8

Ipv6SourceCidrIp

string

任意

ソース IPv6 CIDR ブロック。CIDR 形式および IPv6 形式の IP アドレス範囲がサポートされています。

説明

VPC タイプの IP アドレスのみがサポートされています。このパラメーターと SourceCidrIp を同時に指定することはできません。両方のパラメーターを同時に設定することは許可されていません。

デフォルト値: null。

2001:db8:1234:1a00::***

SourcePortRange

string

任意

トランスポートレイヤープロトコルに対応するソースポート範囲。有効な値:

  • TCP/UDP の場合: 有効な値は 1~65535 です。開始ポートと終了ポートをスラッシュ(/)で区切ります。例: 1/200。

  • ICMP の場合: -1/-1。

  • GRE の場合: -1/-1。

  • ALL の場合: -1/-1。

80/80

DestGroupOwnerAccount

string

任意

クロスアカウントセキュリティグループルールを設定する場合の、送信先セキュリティグループを所有する Alibaba Cloud アカウント。

EcsforCloud@Alibaba.com

DestGroupOwnerId

integer

任意

クロスアカウントセキュリティグループルールを設定する場合の、送信先セキュリティグループを所有する Alibaba Cloud アカウントの ID。

1234567890

NicType

string

任意

ネットワークインターフェースタイプ。

説明

セキュリティグループルール ID を指定してルールを変更する場合、このパラメーターは変更できません。このような変更を行うには、新しいルールを追加してから現在のルールを削除してください。

intranet

Description

string

任意

セキュリティグループルールの説明。説明は 1~512 文字である必要があります。

This is a new securitygroup rule.

PortRangeListId

string

任意

ポートアドレス帳 ID。 DescribePortRangeLists を呼び出して使用可能なポートアドレス帳 ID をクエリできます。

PortRange パラメーターを指定した場合、このパラメーターは無視されます。

詳細については、セキュリティグループの使用制限 を参照してください。

prl-2ze9743****

レスポンスフィールド

フィールド

説明

object

RequestId

string

リクエスト ID

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

成功レスポンス

JSONJSON

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

エラーコード

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.
400 InvalidDestCidrIp.Malformed The specified parameter DestCidrIp is not valid.
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.
400 InvalidDestGroupId.Mismatch Specified security group and destination group are not in the same VPC.
400 InvalidDestGroup.NotFound Specified destination security group does not exist.
400 InvalidPriority.Malformed The specified parameter Priority is not valid.
400 InvalidPriority.ValueNotSupported The specified Priority is invalid.
400 InvalidSecurityGroupDiscription.Malformed The specified security group rule description 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.Dest One of the parameters DestCidrIp, DestGroupId or DestPrefixListId must be specified.
400 InvalidParam.PortRange The specified parameter %s is not valid. It should be two integers less than 65535 in ?/? format.
400 InvalidIpProtocol.ValueNotSupported The specified parameter IpProtocol should not be null and only tcp, udp, icmp, gre or all is supported. Ignore case.
400 InvalidParam.SourceIp The Parameters SourceCidrIp and Ipv6SourceCidrIp in %s cannot be set at the same time.
400 InvalidParam.DestIp The Parameters DestCidrIp and Ipv6DestCidrIp in %s cannot be set at the same time.
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.
400 InvalidParam.Ipv6ProtocolConflictWithIpv4Address IPv4 address cannot be specified for IPv6-specific protocol.
400 InvalidParameter.Ipv6CidrIp The specified Ipv6CidrIp is not valid.
400 InvalidSourcePortRange.Malformed The specified parameter SourcePortRange is not valid.
400 InvalidParam.SourceCidrIp The specified param SourceCidrIp is not valid.
400 InvalidParam.DestCidrIp The specified param DestCidrIp is not valid.
400 InvalidParameter.Conflict IPv6 and IPv4 addresses cannot exist at the same time.
400 InvalidParam.SecurityGroupRuleId The specified parameter SecurityGroupRuleId is not valid.
400 InvalidOperation.ModifySgRuleEntityType The source or destination type of the rules cannot be modified.
400 AuthorizationLimitExceed The limit of authorization records in the security group reaches.
400 InvalidPrefixListId.NotFound The specified prefix list was not found.
400 InvalidParam.ProtocolAndPortRangeMismatch The specified Protocol and PortRange do not match.
400 InvalidParam.ProtocolAndAddressFamilyMismatch The specified Protocol and address family do not match.
400 InvalidParam.PrefixListAddressFamilyMismatch The address family of the prefix list does not match the rule.
400 InvalidParam.InvalidModifyRuleRequest The request parameters are illegal.
400 InvalidOperation.ModifyNicType NicType is not allowed to modify.
400 InvalidParamter.Conflict The specified SourceCidrIp should be different from the DestCidrIp.
400 InvalidOperation.RuleDuplicate %s.
400 InvalidParam.ProtocolNotSupportPortRangeList The specified protocol does not support the port range list.
400 InvalidSourceOrDestGroupId.DirectionMissmatch The specified SourceGroupId or DestGroupId does not match the direction of the rule.
400 InvalidOperation.ModifyPortRangeType The PortRange type is not allowed to be modified. You cannot modify a rule from using the port list to not using it, and vice versa.
400 InvalidPortRangeListId.NotFound The specified port range list was not found.
500 InternalError The request processing has failed due to some unknown error.
403 InvalidDestGroupId.Mismatch NicType is required or NicType expects intranet.
403 MissingParameter The input parameter DestGroupId or DestCidrIp 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.Conflict The specified SecurityGroup network type should be same with SourceGroup network type (vpc or classic).
403 InvalidSecurityGroup.IsSame The authorized SecurityGroupId should be different from the DestGroupId.
403 InvalidOperation.ResourceManagedByCloudProduct %s
404 InvalidSecurityGroupId.NotFound The specified SecurityGroupId does not exist.
404 InvalidDestGroupId.NotFound The DestGroupId provided does not exist in our records.
404 SecurityGroupRule.NotFound The target security group rule do not exist.
404 InvalidPrefixListId.NotFound The specified prefix list was not found.
404 InvalidSecurityGroupRuleId.NotFound The specified SecurityGroupRuleId is not exists.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。