本文へジャンプします。

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

専有エンドポイント:CreateDEPSecurityGroup

処理概要

専有エンドポイントFWグループを作成します。

リクエストパラメーター

要素名 説明 必須 最大値 デフォルト値 備考
DEPSecurityGroupName 専有エンドポイントFWグループ名
  • ※1〜255字のアルファベット・数字・ハイフン('-')・アンダーバー('_')が使用できます
  • ※最初の文字はアルファベットである必要があります
  • ※末尾にハイフンをつけたりハイフンを2個連続させたりすることはできません
  • ※default.〜形式(デフォルトの専有エンドポイントFWグループ名の形式)は指定できません。
  • ※すでに存在する専有エンドポイントFWグループの名前は指定できません
文字列 - -  
AvailabilityZone 専有エンドポイントFWグループが作成されるゾーン指定可能なゾーンについては、ニフティクラウド ゾーン別機能対応表をご参照ください。 文字列 -    
DEPSecurityGroupDescription 専有エンドポイントFWグループの説明
  • ※1〜255文字の印字可能なASCII文字が使用できます。
  文字列 - -  

レスポンス

XML

status

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

result
要素名 説明 備考
CreateDEPSecurityGroupResponse ルート  
CreateDEPSecurityGroupResult 結果  
DEPSecurityGroup 専有エンドポイントFWグループ  
DEPSecurityGroupDescription 専有エンドポイントFWグループの説明 文字列  
DEPSecurityGroupName 専有エンドポイントFWグループ名 文字列  
OwnerId DEP Security Groupのオーナーの@nifty ID 文字列  
AvailabilityZone DEP Security GroupのAvailability Zone 文字列  
ResponseMetadata 共通メタ -  

エラー

コード メッセージ タイプ HTTPステータスコード 説明
Client.InvalidParameterCannotSpecify.DEPSecurityGroupName DEPSecurityGroupName must not contain leading or trailing spaces. Sender 400 DEPSecurityGroupNameの最初か最後 に " " を入力した場合
Client.InvalidParameterDuplicate.DEPSecurityGroupName A security group named default already exists. Sender 400 DEPSecurityGroupNameに"default" 等すでにあるDEPSecurityGroupNameを指定した場合
Client.InvalidParameterFormat.DEPSecurityGroupName DEPSecurityGroupName can contain only ASCII letters and digits, spaces, underscores, and hyphens. Sender 400 DEPSecurityGroupNameに無効な値(@、全角文字等)を指定した場合
Client.InvalidParameterIllegalInput.AvailabilityZone aaa is not a valid availability zone. Sender 400 存在しないAvailabilityZoneをAvailabilityZoneに指定した場合
Client.InvalidParameterRequired.AvailabilityZone The parameter AvailabilityZone must be provided and must not be blank.. Sender 400 必須のAvailabilityZoneを指定しなかった場合
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.LimitExceeded.NumberOfDEPSecurityGroup Request would result in user exceeding the allowed number of DEP Security Groups. Sender 400 作成できるDEPSecurityGroupの上限に達している場合

リクエストサンプル

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

レスポンスサンプル

<CreateDEPSecurityGroupResponse>
  <CreateDEPSecurityGroupResult>
    <DEPSecurityGroup>
      <DEPSecurityGroupName>exsample-securitygroup</DEPSecurityGroupName>
      <OwnerId>ZYP11117</OwnerId>
      <AvailabilityZone>east-13</AvailabilityZone>
    </DEPSecurityGroup>
  </CreateDEPSecurityGroupResult>
  <ResponseMetadata>
  <RequestId>ebe265d8-b99b-4e79-ab70-66f8a2cf52f1</RequestId>
  </ResponseMetadata>
</CreateDEPSecurityGroupResponse>

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