ニフクラAPI (NAS: RevokeNASSecurityGroupIngress)

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

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

ニフクラユーザーガイド

クラウドトップ>NAS> API> RevokeNASSecurityGroupIngress

RevokeNASSecurityGroupIngress

処理概要

接続を許可したIP範囲またはニフクラのファイアウォールグループ名の設定を取り消します。
このAPIアクションではCIDRIP（IP帯）またはSecurityGroupName（ニフクラのファイアウォールグループ名）を必ず指定する必要があります。

指定するパラメーター

パラメーター	型	説明	必須
NASSecurityGroupName	string	NASファイアウォールグループ名	○
SecurityGroupName	string	取り消すニフクラのファイアウォールグループ名	○ (CIDRIPを指定しない場合)
CIDRIP	string	取り消すIP帯	○ (SecurityGroupNameを指定しない場合)

応答フィールド

フィールド (項目)	型	説明
RevokeNASSecurityGroupIngressResponse	structure	ルート
␣RevokeNASSecurityGroupIngressResult	structure	結果
␣␣NASSecurityGroup	structure	NASファイアウォールグループ備考: NASSecurityGroupの子要素はDescribeNASSecurityGroupsで返却される要素をすべて記載しているためAPIによっては返却されない要素もあります。実際のレスポンスはレスポンスサンプルを参照してください。
␣␣␣NASSecurityGroupDescription	string	NASファイアウォールグループの説明
␣␣␣NASSecurityGroupName	string	NASファイアウォールグループ名
␣␣␣SecurityGroups	list	ニフクラファイアウォールグループ要素リスト
␣␣␣␣SecurityGroup	structure	ニフクラファイアウォールグループ要素
␣␣␣␣␣SecurityGroupName	string	ニフクラファイアウォールグループ名
␣␣␣␣␣SecurityGroupOwnerId	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(削除エラー))
␣␣␣OwnerId	string	NASファイアウォールグループを所有しているニフクラID
␣␣␣AvailabilityZone	string	NASファイアウォールグループのゾーン
␣ResponseMetadata	structure	共通メタ情報
␣␣RequestId	string	リクエスト識別子

エラー

コード	メッセージ	タイプ	HTTPステータスコード	説明
Client.InvalidParameter.NotFound.SecurityGroupName	SecurityGroup aaaa hasn’t been authorized	Sender	404	ファイアウォールグループに設定されていないニフクラファイアウォールグループを指定した場合
Client.InvalidParameter.NotFound.CIDRIP	CIDRIP xxx.xxx.xxx.xxx/xx hasn’t been authorized	Sender	404	ファイアウォールグループに設定されていないCIDRIPを指定した場合
Client.InvalidParameter.NotFound.NASSecurityGroupName	NASSecurityGroup aaaa not found.	Sender	404	NASSecurityGroupNameに存在しない名前を指定した場合
Client.Resource.IncorrectState.NASSecurityGroup	The state of the NAS Security Group does not allow deletion.	Sender	400	指定したファイアウォールグループのステータスが有効な状態でない場合
Client.InvalidParameter.MisMatch.SecurityGroupName	If CIDRIP is specified, SecurityGroupName must be omitted.	Sender	400	このAPIを使うための条件を満たすパラメータを指定していない場合
Client.InvalidParameter.Required.NASSecurityGroupName	The parameter NASSecurityGroupName must be provided and must not be blank.	Sender	400	必須のNASSecurityGroupNameを指定しなかった場合
Client.InvalidParameter.TooLong.NASSecurityGroupName	NASSecurityGroupName can be no longer than 255 characters.	Sender	400	NASSecurityGroupNameに255文字以上指定した場合
Client.InvalidParameter.Format.NASSecurityGroupName	NASSecurityGroupName must not contain leading or trailing spaces.	Sender	400	NASSecurityGroupNameの最初か最後に " "（半角スペース）を入力した場合
Client.InvalidParameter.NotAllowed.NASSecurityGroupName	NASSecurityGroupName can contain only lowercase ASCII letters and digits, spaces, underscores, and hyphens.	Sender	400	NASSecurityGroupNameに無効な値（全角文字、@など）を指定した場合
Client.InvalidParameter.TooLong.SecurityGroupName	SecurityGroupName can be no longer than 15 characters.	Sender	400	SecurityGroupNameに15文字を超える値を入力した場合
Client.Resource.IncorrectState.RevokeNASSecurityGroup	Cannot revoke the NASSecurityGroup because NASInstance using the NASSecurityGroup is {unavailable status}.	Sender	400	指定されたNASファイアウォールグループを使用しているNASのステータスが「creating」もしくは「modifying」のとき

リクエストサンプル

    https://jp-east-1.nas.api.nifcloud.com/
  ?Action=RevokeNASSecurityGroupIngress
  &NASSecurityGroupName=exsample-securitygroup
  &CIDRIP=xxx.xxx.xxx.xxx/xx
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &Timestamp=2016-02-24T00:00:00.000Z
  &AWSAccessKeyId=<NIFCLOUD Access Key ID>
  &Signature=<Signature>

応答サンプル

    <RevokeNASSecurityGroupIngressResponse>
  <RevokeNASSecurityGroupIngressResult>
    <NASSecurityGroup>
      <NASSecurityGroupName>exsample-securitygroup</NASSecurityGroupName>
      <SecurityGroups/>
      <IPRanges>
        <IPRange>
          <CIDRIP>xxx.xxx.xxx.xxx/xx</CIDRIP>
          <Status>revoking</Status>
        </IPRange>
      </IPRanges>
      <OwnerId>ABC01234</OwnerId>
      <AvailabilityZone>east-21</AvailabilityZone>
    </NASSecurityGroup>
  </RevokeNASSecurityGroupIngressResult>
  <ResponseMetadata>
    <RequestId>9f95fa37-ae66-4c24-a557-affa62797f52</RequestId>
  </ResponseMetadata>
</RevokeNASSecurityGroupIngressResponse>