セキュリティグループからインバウンドルールを削除します。このアクションは、指定されたセキュリティグループ内のインスタンスから他のデバイスへのインバウンドトラフィックのアクセスポリシーを取り消します。
セキュリティグループからインバウンドルールを削除します。このアクションは、指定されたセキュリティグループ内のインスタンスから他のデバイスへのインバウンドトラフィックのアクセスポリシーを取り消します。トラフィックの開始点を送信元、トラフィックの終点を宛先と定義します。詳細については、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 は存在しません。
|