本文へジャンプします。

ニフクラ APIリファレンス

専有エンドポイント:ModifyDEPSecurityGroup

処理概要

専有エンドポイントFWグループの設定を変更します。
一度に複数の設定を変更することができます。

リクエストパラメーター

要素名 説明 必須 最大値 デフォルト値 備考
DEPSecurityGroupName 変更する専有エンドポイントFWグループ名
  • ※専有エンドポイントに適用されている専有エンドポイントFWグループは削除できません
  • ※デフォルトの専有エンドポイントFWグループは削除できません
  • ※1〜255字のアルファベット・数字・ハイフン('-')・アンダーバー('_')が使用できます
  • ※最初の文字はアルファベットである必要があります
  • ※末尾にハイフンをつけたりハイフンを2個連続させたりすることはできません
文字列 - -  
NewDEPSecurityGroupName 新しい専有エンドポイントFWグループ名
  • ※1〜255字のアルファベット・数字・ハイフン('-')・アンダーバー('_')が使用できます
  • ※最初の文字はアルファベットである必要があります
  • ※末尾にハイフンをつけたりハイフンを2個連続させたりすることはできません
  • ※default.〜形式(デフォルトの専有エンドポイントFWグループ名の形式)は指定できません
  • ※すでに存在する専有エンドポイントFWグループの名前は指定できません
  文字列 - -  
DEPSecurityGroupDescription 新しい専有エンドポイントFWグループの説明
  • ※1〜255文字の印字可能なASCII文字が使用できます
  文字列 - -  

レスポンス

XML

status

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

result
要素名 説明 備考
ModifyDEPSecurityGroupResponse ルート  
ModifyDEPSecurityGroupResult 結果  
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.DEPSecurityGroup You cannot modify the default DEP security group. Sender 400 defaultファイアウォールグループを変更しようとした場合
Client.InvalidParameterCannotSpecify.DEPSecurityGroupName DEPSecurityGroupName must not contain leading or trailing spaces. Sender 400 DEPSecurityGroupNameの最初か最後に " " を入力した場合
Client.InvalidParameterCannotSpecify.DEPSecurityGroupName NewDEPSecurityGroupName must not contain leading or trailing spaces. Sender 400 NewDEPSecurityGroupNameの最初か最後に " " を入力した場合
Client.InvalidParameterDuplicate.DEPSecurityGroupName A security group named default already exists. Sender 400 NewDEPSecurityGroupNameに"default" 等すでにあるDEPSecurityGroupNameを指定した場合
Client.InvalidParameterFormat.DEPSecurityGroupName DEPSecurityGroupName can contain only ASCII letters and digits, spaces, underscores, and hyphens. Sender 400 DEPSecurityGroupNameに無効な値(@、全角文字等)を指定した場合
Client.InvalidParameterFormat.DEPSecurityGroupName NewDEPSecurityGroupName 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.InvalidParameterRequired.DEPSecurityGroupName The parameter DEPSecurityGroupName must be provided and must not be blank. Sender 400 必須のDEPSecurityGroupNameを指定しなかった場合
Client.InvalidParameterTooLong.DEPSecurityGroupDescription DEPSecurityGroupDescription can be no longer than 255 characters. Sender 400 DEPSecurityGroupDescriptionに255文字を超える値を入力した場合
Client.InvalidParameterTooLong.DEPSecurityGroupName DEPSecurityGroupName can be no longer than 255 characters. Sender 400 DEPSecurityGroupNameに255文字を超える値を入力した場合
Client.InvalidParameterTooLong.DEPSecurityGroupName NewDEPSecurityGroupName can be no longer than 255 characters. Sender 400 NewDEPSecurityGroupNameに255文字を超える値を入力した場合
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=ModifyDEPSecurityGroup
    &DEPSecurityGroupName=exsample-securitygroup
    &NewDEPSecurityGroupName=sample-securitygroup
    &SignatureVersion=2
    &SignatureMethod=HmacSHA256
    &Timestamp=2017-11-15T00%3A00%3A00.000Z
    &AWSAccessKeyId=<Nifty Cloud Access Key ID>
    &Signature=<Signature>

レスポンスサンプル

<ModifyDEPSecurityGroupResponse>
  <ModifyDEPSecurityGroupResult>
    <DEPSecurityGroup>
      <DEPSecurityGroupName>sample-securitygroup</DEPSecurityGroupName>
      <SecurityGroups/>
      <IPRanges>
        <IPRange>
          <CIDRIP>192.168.2.101/32</CIDRIP>
          <Status>authorized</Status>
        </IPRange>
      </IPRanges>
      <OwnerId>ZYP11117</OwnerId>
      <AvailabilityZone>east-13</AvailabilityZone>
    </DEPSecurityGroup>
  </ModifyDEPSecurityGroupResult>
    <ResponseMetadata>
  <RequestId>1fa1c9c0-d28b-407b-9e36-8c2d425a8f20</RequestId>
  </ResponseMetadata>
</ModifyDEPSecurityGroupResponse>

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