本文へジャンプします。

ニフクラ ユーザーガイド

クラウド トップ>API> NAS> 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 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>

  
  • ※本ページ記載の金額は、すべて税抜表示です。
  • ※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
  • ※本ページの内容は、2021年9月13日時点の情報です。

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