本文へジャンプします。

ニフティクラウド APIリファレンス

クラウド トップ>API>RDB>RevokeDBSecurityGroupIngress

RDB:RevokeDBSecurityGroupIngress

処理概要

接続を許可したIP範囲またはニフティクラウドのファイアウォールグループ名の設定を取り消します。

このAPIアクションではCIDRIP(IP帯)またはEC2SecurityGroupName(ニフティクラウドのファイアウォールグループ名)を必ず指定する必要があります。

リクエストパラメーター

要素名 説明 必須 最大値 デフォルト値 備考
CIDRIP 取り消すIP帯   文字列  
DBSecurityGroupName DBファイアウォールグループ名 文字列  
EC2SecurityGroupId
  • ※指定不可
  文字列  
EC2SecurityGroupName 取り消すニフティクラウドのファイアウォールグループ名   文字列  
EC2SecurityGroupOwnerId
  • ※指定不可
  文字列  

レスポンス

XML

status

statusは共通の応答メッセージを返却します。

result
要素名 説明 備考
RevokeDBSecurityGroupIngressResponse ルート  
RevokeDBSecurityGroupIngressResult 結果  
DBSecurityGroup DBファイアウォールグループ情報  
DBSecurityGroupDescription DBファイアウォールグループの説明 文字列  
DBSecurityGroupName DBファイアウォールグループ名 文字列  
EC2SecurityGroups ニフティクラウドのファイアウォールグループ要素リスト リスト  
EC2SecurityGroup ニフティクラウドのファイアウォールグループ要素  
EC2SecurityGroupName ニフティクラウドのファイアウォールグループ名 文字列  
EC2SecurityGroupOwnerId ニフティクラウドのファイアウォールグループを所有している @nifty ID 文字列  
Status ニフティクラウドのファイアウォールグループのステータス
値:authorized(有効)|authorizing(追加中)|revoking(削除中)|auth-failed(追加エラー)|revoke-failed(削除エラー)|not-exists(追加エラー(グループが存在しません))
文字列  
IPRanges IP 帯リスト リスト  
IPRange IP帯  
CIDRIP CIDR 文字列  
Status IP帯のステータス
値:authorized(有効)|authorizing(追加中)|revoking(削除中)|auth-failed(追加エラー)|revoke-failed(削除エラー)|not-exists(追加エラー(グループが存在しません))
文字列  
OwnerId DBファイアウォールグループを所有している @nifty ID 文字列  
NiftyAvailabilityZone DBファイアウォールグループのゾーン 文字列 ニフティクラウド独自仕様
ResponseMetadata 共通メタ情報  

エラー

コード メッセージ タイプ HTTP
ステータスコード
説明
AuthorizationNotFound 58.1.226.16/32 hasn't been authorized Sender 404 DBファイアウォールグループに設定されていないCIDRIPまたはニフティクラウドのファイアウォールグループを指定した場合
DBSecurityGroupNotFound DBSecurityGroup not found: aaaa Sender 404 DBSecurityGroupNameに存在しない名前を指定した場合
InvalidDBSecurityGroupState The state of the DB Security Group does not allow deletion. Sender 400 指定したDBファイアウォールグループが有効な状態でない場合
InvalidParameterValue DBSecurityGroupName is required Sender 400 必須のDBSecurityGroupNameを指定しなかった場合
DBSecurityGroupName can be no longer than 255 characters Sender 400 DBSecurityGroupNameに255文字以上指定した場合
DBSecurityGroupName must not contain leading or trailing spaces Sender 400 DBSecurityGroupNameの最初か最後に " " を入力した場合
Invalid security group: group?-05
Invalid security group: group@-05
Sender 400 DBSecurityGroupNameに無効な値(全角文字、@など)を指定した場合
InvalidParameterCombination If CIDRIP is specified, EC2SecurityGroupName must be omitted. Sender 400 このAPIを使うための条件を満たすパラメーターを指定していない場合
InvalidDBSecurityGroupState Cannot authorize the DBSecurityGroup because DBInstance using the DBSecurityGroup is creating. Sender 400 指定されたDBファイアウォールグループを使用しているDBサーバーのステータスが「creating」のとき
Cannot authorize the DBSecurityGroup because DBInstance using the DBSecurityGroup is modifying. Sender 400 指定されたDBファイアウォールグループを使用しているDBサーバーのステータスが「modifying」のとき

サンプル

リクエストサンプル
https://rdb.jp-east-1.api.cloud.nifty.com/
  ?Action=RevokeDBSecurityGroupIngress
  &DBSecurityGroupName=mydbsecuritygroup
  &CIDRIP=0.0.0.0%2F0
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &Timestamp=2013-12-09T00%3A00%3A00.000Z
  &AWSAccessKeyId=<Nifty Cloud Access Key ID>
  &Signature=<Signature>
レスポンスサンプル
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<RevokeDBSecurityGroupIngressResponse>
    <RevokeDBSecurityGroupIngressResult>
      <DBSecurityGroup>
        <DBSecurityGroupDescription>My new db security group</DBSecurityGroupDescription>
        <DBSecurityGroupName>mydbsecuritygroup</DBSecurityGroupName>
        <EC2SecurityGroups/>
        <IPRanges>
            <IPRange>
                <CIDRIP>0.0.0.0/0</CIDRIP>
                <Status>revoking</Status>
            </IPRange>
        </IPRanges>
        <OwnerId>abc01234</OwnerId>
        <NiftyAvailabilityZone>east-13</NiftyAvailabilityZone>
      </DBSecurityGroup>
    </RevokeDBSecurityGroupIngressResult>
    <ResponseMetadata>
      <RequestId>1e5095fe-33eb-4dc0-9be2-a0dc638c00d1</RequestId>
    </ResponseMetadata>
</RevokeDBSecurityGroupIngressResponse>

推奨画面サイズ 1024×768 以上