ニフクラAPI (RDB: RevokeDBSecurityGroupIngress)

【重要なお知らせ】サービス統合に基づくサービス名称の読み替えのお願い（2024年4月1日）

2024年4月1日をもって、「ニフクラ」は、「FJcloud-V」に統合し、名称を変更しました。
「ニフクラ」「NIFCLOUD」「nifcloud」は、「FJcloud-V」に読み替えていただきますようお願いいたします。

ニフクラユーザーガイド

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

RevokeDBSecurityGroupIngress

処理概要

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

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

指定するパラメーター

パラメーター	型	説明	必須
CIDRIP	string	取り消すIP帯	○ (EC2SecurityGroupNameを指定しない場合)
DBSecurityGroupName	string	DBファイアウォールグループ名	○
EC2SecurityGroupId	string	※指定不可	○ (CIDRIPを指定しない場合)
EC2SecurityGroupName	string	取り消すニフクラのファイアウォールグループ名
EC2SecurityGroupOwnerId	string	※指定不可

応答フィールド

フィールド (項目)	型	説明
RevokeDBSecurityGroupIngressResponse	structure	ルート
␣RevokeDBSecurityGroupIngressResult	structure	結果
␣␣DBSecurityGroup	structure	DBファイアウォールグループ情報備考: DBSecurityGroupの子要素はDescribeDBSecurityGroupsで返却される要素をすべて記載しているためAPIによっては返却されない要素もあります。実際のレスポンスはレスポンスサンプルを参照してください。
␣␣␣DBSecurityGroupDescription	string	DBファイアウォールグループの説明
␣␣␣DBSecurityGroupName	string	DBファイアウォールグループ名
␣␣␣EC2SecurityGroups	list	ニフクラのファイアウォールグループ要素リスト
␣␣␣␣EC2SecurityGroup	structure	ニフクラのファイアウォールグループ要素
␣␣␣␣␣EC2SecurityGroupName	string	ニフクラのファイアウォールグループ名
␣␣␣␣␣EC2SecurityGroupOwnerId	string	ニフクラのファイアウォールグループを所有しているニフクラID
␣␣␣␣␣Status	string	ニフクラのファイアウォールグループのステータス値：authorized(有効)\|authorizing(追加中)\|revoking(削除中)\|auth-failed(追加エラー)\|revoke-failed(削除エラー)\|not-exists(追加エラー(グループが存在しません))
␣␣␣IPRanges	list	IP帯リスト
␣␣␣␣IPRange	structure	IP帯
␣␣␣␣␣CIDRIP	string	CIDR
␣␣␣␣␣Status	string	IP帯のステータス値：authorized(有効)\|authorizing(追加中)\|revoking(削除中)\|auth-failed(追加エラー)\|revoke-failed(削除エラー)\|not-exists(追加エラー(グループが存在しません))
␣␣␣OwnerId	string	DB ファイアウォールグループを所有しているニフクラID
␣␣␣NiftyAvailabilityZone	string	DB ファイアウォールグループのゾーン備考: ニフクラ独自仕様
␣ResponseMetadata	structure	共通メタ情報
␣␣RequestId	string	リクエスト識別子

エラー

コード	メッセージ	タイプ	HTTPステータスコード	説明
Client.InvalidParameterCannotSpecify.DBSecurityGroupName	DBSecurityGroupName must not contain leading or trailing spaces.	Sender	400	DBSecurityGroupNameの最初または最後にスペースを入力した場合
Client.InvalidParameterCombination.CidrIp.and.SecurityGroupName	If CIDRIP is specified, EC2SecurityGroupName must be omitted.	Sender	400	CIDRIPとEC2SecurityGroupNameの両方に値を指定した場合 CIDRIPとEC2SecurityGroupNameの両方に値を指定しなかった場合
Client.InvalidParameterFormat.CidrIp	Invalid CIDR format. Format must be B. B. B. B/M, where B is a number between 0 and 255, and M is a number between 0 and 32. For example: To authorize only the source address of this request (and no other address), pass 192.168.1.1 as the CIDRIP parameter.	Sender	400	CIDRIPの形式が無効な場合
Client.InvalidParameterFormat.DBSecurityGroupName	DBSecurityGroupName can contain only lowercase ASCII letters and digits, spaces, underscores, and hyphens.	Sender	400	DBSecurityGroupNameに無効な値(ハイフンから始まる等)を指定した場合
Client.InvalidParameterNotFound.DBSecurityGroup	DBSecurityGroup not found: aaa	Sender	404	存在しないDBSecurityGroupNameを指定した場合
Client.InvalidParameterNotFound.DBSecurityGroupRule	192.168.1.2/32 hasn’t been authorized	Sender	404	設定されていないCIDRIPを指定した場合 EC2SecurityGroupNameに設定されていないニフクラのファイアウォールグループを指定した場合
Client.InvalidParameterRequired.DBSecurityGroupName	DBSecurityGroupName is required	Sender	400	必須のDBSecurityGroupNameを指定しなかった場合
Client.InvalidParameterTooLong.DBSecurityGroupName	DBSecurityGroupName can be no longer than 255 characters	Sender	400	DBSecurityGroupNameに255文字を超える値を指定した場合
Client.InvalidParameterTooLong.SecurityGroupName	SecurityGroupName can not be greater than 15 characters.	Sender	400	SecurityGroupNameに15文字を超える値を指定した場合
Client.InvalidParameterTooLong.SecurityGroupName	EC2SecurityGroupName can not be greater than 15 characters.	Sender	400	EC2SecurityGroupNameに15文字を超える値を指定した場合
Client.ResourceIncorrectState.DBInstance.Creating	Cannot revoke the DBSecurityGroup because DBInstance using the DBSecurityGroup is creating.	Sender	400	DBファイアウォールグループを使用しているDBサーバーのステータスが「creating」の場合
Client.ResourceIncorrectState.DBInstance.Processing	Cannot revoke the DBSecurityGroup because DBInstance using the DBSecurityGroup is modifying.	Sender	400	DBファイアウォールグループを使用しているDBサーバーのステータスが「modifying」の場合
Client.ResourceIncorrectState.DBInstanceUpgradeStatus.Processing	Cannot revoke the DBSecurityGroup because DB Instance upgrade status using the DBSecurityGroup is processing.	Sender	400	DBファイアウォールグループを使用しているDBサーバーの基盤アップグレードステータスが処理中（「required」、「latest」以外）の場合
Client.ResourceIncorrectState.DBSecurityGroup.Unavailable	The state of the DB Security Group does not allow deletion.	Sender	400	DBファイアウォールグループのステータスが有効な状態でない場合

リクエストサンプル

    https://jp-east-1.rdb.api.nifcloud.com/
  ?Action=RevokeDBSecurityGroupIngress
  &DBSecurityGroupName=mydbsecuritygroup
  &CIDRIP=0.0.0.0/0
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &Timestamp=2013-12-09T00:00:00.000Z
  &AWSAccessKeyId=<NIFCLOUD Access Key ID>
  &Signature=<Signature>

応答サンプル

    <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>