本文へジャンプします。

ニフクラ APIリファレンス

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

NAS:RevokeNASSecurityGroupIngress

処理概要

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

リクエストパラメーター

要素名 説明 必須 最大値 デフォルト値 備考
NASSecurityGroupName NASファイアウォールグループ名 文字列  
SecurityGroupName 取り消すニフクラのファイアウォールグループ名 ○(CIDRIPを指定しない場合) 文字列  
CIDRIP 取り消すIP帯 ○(SecurityGroupNameを指定しない場合) 文字列  

レスポンス

XML

status

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

result
要素名 説明 備考
RevokeNASSecurityGroupIngressResponse ルート  
RevokeNASSecurityGroupIngressResult 結果  
NASSecurityGroup NASファイアウォールグループ  
NASSecurityGroupDescription NASファイアウォールグループの説明 文字列  
NASSecurityGroupName NASファイアウォールグループ名 文字列  
SecurityGroups ニフクラファイアウォールグループ要素リスト リスト  
SecurityGroup ニフクラファイアウォールグループ要素  
SecurityGroupName ニフクラファイアウォールグループ名 文字列  
SecurityGroupOwnerId ニフクラのファイアウォールグループを所有している @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(削除エラー))
文字列  
OwnerId NASファイアウォールグループを所有している @nifty ID 文字列  
AvailabilityZone NASファイアウォールグループのゾーン 文字列  
ResponseMetadata 共通メタ情報  

エラー

コード メッセージ タイプ 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.Reqiured.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 {unavailabe status}. Sender 400 指定されたNASファイアウォールグループを使用しているNASのステータスが「creating」もしくは「modifyng」のとき

リクエストサンプル

https://nas.jp-east-2.api.cloud.nifty.com/
    ?Action=RevokeNASSecurityGroupIngress
    &NASSecurityGroupName=exsample-securitygroup
    &CIDRIP=xxx.xxx.xxx.xxx/xx
    &SignatureVersion=2
    &SignatureMethod=HmacSHA256
    &Timestamp=2016-02-24T00%3A00%3A00.000Z
    &AWSAccessKeyId=<Nifty Cloud 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>

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