本文へジャンプします。

ニフクラ APIリファレンス

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

NAS:CreateNASSecurityGroup

処理概要

NASファイアウォールグループを作成します。

リクエストパラメーター

要素名 説明 必須 最大値 デフォルト値 備考
NASSecurityGroupName

NASファイアウォールグループ名

  • ※1〜255字のアルファベット・数字・ハイフン('-')が使用できます
  • ※最初の文字はアルファベットである必要があります
  • ※末尾にハイフンをつけたりハイフンを2個連続させたりすることはできません
  • ※すでに存在するNASファイアウォールグループの名前は指定できません
文字列  
AvailabilityZone NASファイアウォールグループが作成されるゾーン
指定可能なゾーンについては、ニフクラ ゾーン別機能対応表をご参照ください。
文字列    
NASSecurityGroupDescription

NASファイアウォールグループの説明

  • ※1〜255文字の印字可能なASCII文字が使用できます。
  文字列  

レスポンス

XML

status

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

result
要素名 説明 備考
CreateNASSecurityGroupResponse ルート  
CreateNASSecurityGroupResult 結果  
NASSecurityGroup NASファイアウォールグループ  
NASSecurityGroupDescription NASファイアウォールグループの説明 文字列  
NASSecurityGroupName NASファイアウォールグループ名 文字列  
OwnerId NASファイアウォールグループを所有している ニフクラID 文字列  
AvailabilityZone NASファイアウォールグループのゾーン 文字列  
ResponseMetadata 共通メタ情報  

エラー

コード メッセージ タイプ HTTPステータスコード 説明
Client.InvalidParameter.Duplicate.NASSecurityGroupName A security group named default already exists Sender 400 NASSecurityGroupNameに"default" などすでにあるNASSecurityGroupNameを指定した場合
Client.InvalidParameter.LimitExceeded.NASSecurityGroup Request would result in user exceeding the allowed number of NAS Security Groups. Sender 400 作成できるNASSecurityGroupの上限に達している場合
Client.InvalidParameter.Required.NASSecurityGroupName NASSecurityGroupName is required Sender 400 必須のNASSecurityGroupNameを指定しなかった場合
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.NASSecurityGroupName NASSecurityGroupName can be no longer than 255 characters Sender 400 NASSecurityGroupNameに255文字以上指定した場合
Client.InvalidParameter.TooLong.NASSecurityGroupDescription NASSecurityGroupDescription can be no longer than 255 characters Sender 400 NASSecurityGroupDescriptionに255文字以上を指定した場合
Client.InvalidParameter.Required.AvailabilityZone AvailabilityZone is required Sender 400 AvailabilityZoneを指定しなかった場合
Client.InvalidParameter.NotFound.AvailabilityZone aaa is not a valid availability zone. Sender 400 存在しないAvailabilityZoneをAvailabilityZoneに指定した場合

リクエストサンプル

https://jp-east-1.nas.api.nifcloud.com/
    ?Action=CreateNASSecurityGroup
    &NASSecurityGroupName=exsample-securitygroup
    &AvailabilityZone=east-21
    &SignatureVersion=2
    &SignatureMethod=HmacSHA256
    &Timestamp=2016-02-24T00%3A00%3A00.000Z
    &AWSAccessKeyId=<Nifty Cloud Access Key ID>
    &Signature=<Signature>

レスポンスサンプル

<CreateNASSecurityGroupResponse>
  <CreateNASSecurityGroupResult>
    <NASSecurityGroup>
      <NASSecurityGroupName>exsample-securitygroup</NASSecurityGroupName>
      <OwnerId>ABC01234</OwnerId>
      <AvailabilityZone>east-21</AvailabilityZone>
    </NASSecurityGroup>
  </CreateNASSecurityGroupResult>
  <ResponseMetadata>
    <RequestId>820e8ba1-160f-4d04-ab7b-7a4863d47dd0</RequestId>
  </ResponseMetadata>
</CreateNASSecurityGroupResponse>

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