セキュリティグループからインバウンドルールを削除します。このアクションは、指定されたセキュリティグループ内のインスタンスから他のデバイスへのインバウンドトラフィックのアクセスポリシーを取り消します。
セキュリティグループからインバウンドルールを削除します。このアクションは、指定されたセキュリティグループ内のインスタンスから他のデバイスへのインバウンドトラフィックのアクセスポリシーを取り消します。トラフィックの開始点を送信元、トラフィックの終点を宛先と定義します。詳細については、AuthorizeSecurityGroup を参照してください。
セキュリティグループルールを削除するには、次の 2 つのパラメータセットを使用します。これらの 2 つのパラメータセットに基づいて 1 つのルールが存在しない場合、RevokeSecurityGroup は失敗します。
-
例えば、IP アドレス範囲のアクセスポリシーを撤回するには:
IpProtocol、PortRange、(オプション)SourcePortRange、NicType、Policy、DestCiderIp、(オプション)SourceCidrIp。 -
別のセキュリティグループに属しているインスタンスのアクセスポリシーを撤回するには:
IpProtocol、PortRange、(オプション)SourcePortRange、NicType、Policy、(オプション)DestCiderIp、DestGroupOwnerAccount、DestGroupIdです。
リクエストパラメータ
| Action | String | はい | このインタフェースの名前。値:RevokeSecurityGroup。 |
| RegionId | String | はい | ソースセキュリティグループが属するリージョンの ID 。詳細については、
DescribeRegions
を呼び出して最新のリージョンリストを取得してください。
|
| SecurityGroupId | String | はい | 宛先セキュリティグループ ID 。 |
| IpProtocol | String | はい | トランスポート層プロトコル。オプションの値:
|
| PortRange | String | はい | トランスポート層プロトコルに関連する宛先ポートの範囲。オプションの値:
|
| SourcePortRange | String | はい | トランスポート層プロトコルに関連する送信元ポートの範囲。オプションの値:
|
| NicType | String | いいえ | ネットワーク型 。オプションの値:
DestCidrIpが指定されていない間、DestGroupId が指定されていればNicTypeをintranetとして指定する必要があります。 デフォルト値:internet 。
|
| Policy | String | いいえ | アクセス許可。オプションの値:
|
| SourceCidrIp | String | いいえ | 送信元 IP アドレスの範囲。 CIDR と IPv4 形式のみがサポートされています。 デフォルト値:0.0.0.0/0 。 |
| DestCidrIp | String | いいえ | 宛先 IP アドレスの範囲。 CIDR と IPv4 形式のみがサポートされています。 デフォルト値:0.0.0.0/0 。 |
| SourceGroupId | String | いいえ | ソースセキュリティグループ ID 。SourceGroupIdまたはDestCidrIpパラメータのいずれかを設定する必要があります。両方が設定されている場合、SourceCidrIpはデフォルトで許可されます。SourceGroupIdが指定され、SourceCidrIpが指定されていない場合、NicTypeはintranetに設定されなければなりません。
|
| SourceGroupOwnerId | String | いいえ | ソースセキュリティグループの Alibaba Cloud アカウント。SourceGroupOwnerAccountとSourceGroupOwnerIdが設定されていない場合、アクセスポリシーの取り消しは、同じアカウントのセキュリティグループに対して実行されます。SourceCidrIpが既に設定されている場合、SourceGroupOwnerAccountは無効です。
|
| SourceGroupOwnerId | String | いいえ | ソースセキュリティグループの Alibaba Cloud アカウント ID 。SourceGroupOwnerAccountとSourceGroupOwnerIdが設定されていない場合、アクセスポリシーの取り消しは、同じアカウントのセキュリティグループに対して実行されます。SourceCidrIpが既に設定されている場合、SourceGroupOwnerIdは無効です。
|
| Priority | String | いいえ | インバウンドルールの優先順位。値の範囲:[1,100] デフォルト値:1 |
レスポンスパラメータ
全て共通のレスポンスパラメータです。詳細については、共通パラメータを参照してください。
例
リクエストの例
https://ecs.aliyuncs.com/?Action=RevokeSecurityGroup
&SecurityGroupId=C0003E8B-B930-4F59-ADC0-0E209A9012B0
&SourceGroupId=sg-F876FF7BA
&SourceGroupOwnerAccount=test@aliyun.com
&IpProtocol=tcp
&PortRange=1/65535
&Priority=1
&<Common Request Parameters>
レスポンスの例
XML形式
<RevokeSecurityGroupResponse>
<RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
</RevokeSecurityGroupResponse>
JSON形式
{
"RequestId":"CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}
エラーコード
このインタフェースに固有のエラーコードは次のとおりです。 その他のエラーコードについては、API エラーコードセンターをご参照ください。
| InvalidIpPortRange.Malformed | The specified parameter “PortRange” is not valid. | 400 | 指定されたPortRangeは無効です。
|
| InvalidIpProtocol.ValueNotSupported | The specified IpProtocol does not exist. | 400 | 指定されたIpProtocolは存在しません。
|
| InvalidNicType.ValueNotSupported | The specified NicType does not exist. | 400 | 指定されたNicTypeは存在しません。
|
| InvalidPolicy.Malformed | The specified parameter “Policy” is not valid. | 400 | 指定されたPolicyは無効です。
|
| InvalidSourceCidrIp.Malformed | The specified parameter “SourceCidrIp” is not valid. | 400 | 指定されたSourceCidrIpは無効です。
|
| InvalidSourceGroupId.Mismatch | Specified security group and source group are not in the same VPC. | 400 | 指定された宛先セキュリティグループのネットワーク型は VPC なので、送信元セキュリティグループは VPC に接続する必要があります。 |
| MissingParameter | The input parameter “SourceGroupId” or “SourceCidrIp” cannot be both blank. | 400 |
SourceGroupIdまたはSourceCidrIpのいずれかを指定する必要があります。
|
| InvalidGroupAuthItem.NotFound | Specified group authorized item does not exist in our records. | 403 | 指定された受信セキュリティグループルールは存在しません。 |
| InvalidNicType.Mismatch | Specified nic type conflicts with the authorization record. | 403 | 指定されたNicTypeは無効です。
|
| InvalidRegionId.NotFound | The specified RegionId does not exist. | 404 | 指定されたRegionIdは存在しません。
|
| InvalidSecurityGroupId.NotFound | The specified SecurityGroupId does not exist. | 404 | 指定されたSecurityGroupIdは存在しません。
|
| InvalidSourceGroupId.NotFound | The SourceGroupId provided does not exist in our records. | 404 | 指定されたSourceGroupIdは存在しません。
|