本文へジャンプします。

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

専有エンドポイント:RevokeDEPSecurityGroupIngress

処理概要

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

リクエストパラメーター

要素名 説明 必須 最大値 デフォルト値 備考
DEPSecurityGroupName アクセスを無効にする専有エンドポイントFWグループ名
  • ※1〜255字のアルファベット・数字・ハイフン('-')・アンダーバー('_')が使用できます
  • ※最初の文字はアルファベットである必要があります
文字列 - -  
SecurityGroupName 取り消すニフティクラウドのファイアウォールグループ名
(CIDRIPを指定しない場合)
文字列 15 -  
CIDRIP 取り消すIP帯
(SecurityGroupNameを指定しない場合)
文字列 - -  

レスポンス

XML

status

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

result
要素名 説明 備考
RevokeDEPSecurityGroupIngressResponse ルート  
RevokeDEPSecurityGroupIngressResult 結果  
DEPSecurityGroup 専有エンドポイントFWグループ  
DEPSecurityGroupDescription 専有エンドポイントFWグループの説明 文字列  
DEPSecurityGroupName 専有エンドポイントFWグループ名 文字列  
SecurityGroups ニフクラファイアウォールグループ要素リスト リスト  
SecurityGroup ニフクラファイアウォールグループ要素 -  
SecurityGroupName ニフクラファイアウォールグループ名 文字列  
SecurityGroupOwnerId ニフクラファイアウォールグループを所有する@nifty ID 文字列  
Status ニフクラファイアウォールグループのステータス 文字列  
IPRanges IP帯リスト リスト  
IPRange IP帯 -  
CIDRIP IP帯 文字列  
Status IP帯のステータス 文字列  
OwnerId 専有エンドポイントFWグループを所有する@nifty ID 文字列  
AvailabilityZone 専有エンドポイントFWグループのゾーン 文字列  
ResponseMetadata 共通メタ -  

エラー

コード メッセージ タイプ HTTPステータスコード 説明
Client.InvalidParameterCannotSpecify.DEPSecurityGroupName DEPSecurityGroupName must not contain leading or trailing spaces. Sender 400 DEPSecurityGroupNameの最初か最後に " " を入力した場合
Client.InvalidParameterCombination.CidrIp.and.SecurityGroupName If CIDRIP is specified, SecurityGroupName must be omitted. Sender 400 このAPIを使うための条件を満たすパラメータを指定していない場合
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 {0} as the CIDRIP parameter. Sender 400 CIDRIPにフォーマット以外のデータを適用した場合
Client.InvalidParameterFormat.DEPSecurityGroupName DEPSecurityGroupName can contain only ASCII letters and digits, spaces, underscores, and hyphens. Sender 400 DEPSecurityGroupNameに無効な値(@、全角文字等)を指定した場合
Client.InvalidParameterNotFound.DEPSecurityGroupName DEPSecurityGroup aaaa not found. Sender 404 DEPSecurityGroupNameに存在しない名前を指定した場合
Client.InvalidParameterNotFound.DEPSecurityGroupRule SecurityGroup aaaa hasn't been authorized. Sender 404 設定されていないCIDRIPまたはニフクラファイアウォールグループを指定した場合
Client.InvalidParameterNotFound.DEPSecurityGroupRule CIDRIP 58.1.226.16/32 hasn't been authorized. Sender 404 設定されていないCIDRIPまたはニフクラファイアウォールグループを指定した場合
Client.InvalidParameterRequired.DEPSecurityGroupName The parameter DEPSecurityGroupName must be provided and must not be blank. Sender 400 必須のDEPSecurityGroupNameを指定しなかった場合
Client.InvalidParameterTooLong.DEPSecurityGroupName DEPSecurityGroupName can be no longer than 255 characters. Sender 400 DEPSecurityGroupNameに255文字を超える値を入力した場合
Client.InvalidParameterTooLong.SecurityGroupName SecurityGroupName can be no longer than 15 characters. Sender 400 SecurityGroupNameに15文字を超える値を入力した場合
Client.ResourceIncorrectState.DEPInstance.Processing Cannot revoke the DEPSecurityGroup because DEPInstance using the DEPSecurityGroup is {unavailable status}. Sender 400 指定された専有エンドポイントFWグループを使用している専有エンドポイントのステータスが「creating」または「modifying」のとき
Client.ResourceIncorrectState.DEPSecurityGroup.Unavailable The state of the DEP Security Group does not allow deletion. Sender 400 指定した専有エンドポイントFWグループのステータスが有効な状態でない場合

リクエストサンプル

https://dep.jp-east-1.api.cloud.nifty.com/
    ?Action=RevokeDEPSecurityGroupIngress
    &DEPSecurityGroupName=exsample-securitygroup
    &CIDRIP=192.168.100.101/28
    &SignatureVersion=2
    &SignatureMethod=HmacSHA256
    &Timestamp=2017-11-15T00%3A00%3A00.000Z
    &AWSAccessKeyId=<Nifty Cloud Access Key ID>
    &Signature=<Signature>

レスポンスサンプル

<RevokeDEPSecurityGroupIngressResponse>
  <RevokeDEPSecurityGroupIngressResult>
    <DEPSecurityGroup>
      <DEPSecurityGroupName>sample-securitygroup</DEPSecurityGroupName>
      <SecurityGroups/>
      <IPRanges>
        <IPRange>
          <CIDRIP>192.168.2.101/32</CIDRIP>
          <Status>revoking</Status>
        </IPRange>
      </IPRanges>
      <OwnerId>ZYP11117</OwnerId>
      <AvailabilityZone>east-13</AvailabilityZone>
    </DEPSecurityGroup>
  </RevokeDEPSecurityGroupIngressResult>
  <ResponseMetadata>
    <RequestId>f3226678-6486-4bee-bd7c-a0332f03697a</RequestId>
  </ResponseMetadata>
</RevokeDEPSecurityGroupIngressResponse>

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