ニフクラAPI (NAS: CreateNASSecurityGroup)

【重要なお知らせ】サービス統合に基づくサービス名称の読み替えのお願い（2024年4月1日）

2024年4月1日をもって、「ニフクラ」は、「FJcloud-V」に統合し、名称を変更しました。
当サイトのアドレス（ドメイン名）に含まれる「nifcloud.com」は現時点では変更はございませんが、
各ページに記載の「ニフクラ」「NIFCLOUD」「nifcloud」は、「FJcloud-V」に読み替えていただきますようお願いいたします。

ニフクラユーザーガイド

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

CreateNASSecurityGroup

処理概要

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

指定するパラメーター

パラメーター	型	説明	必須
NASSecurityGroupName	string	NASファイアウォールグループ名 ※最初の文字はアルファベットである必要があります ※すでに存在するNASファイアウォールグループの名前は指定できません使用可能文字: 1〜255字のアルファベット(小文字)・数字・ハイフン('-')・アンダースコア('_')・スペース(' ')	○
AvailabilityZone	string	NASファイアウォールグループが作成されるゾーン指定可能なゾーンについては、ニフクラゾーン別機能対応表をご参照ください。	○
NASSecurityGroupDescription	string	NASファイアウォールグループの説明 ※4バイト文字（絵文字や一部の漢字など）は使用できません使用可能文字: 1〜255文字の印字可能なASCII文字

パラメーター

型

説明

必須

NASSecurityGroupName

string

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

※最初の文字はアルファベットである必要があります
※すでに存在するNASファイアウォールグループの名前は指定できません

使用可能文字: 1〜255字のアルファベット(小文字)・数字・ハイフン('-')・アンダースコア('_')・スペース(' ')

○

AvailabilityZone

string

NASファイアウォールグループが作成されるゾーン
指定可能なゾーンについては、ニフクラゾーン別機能対応表をご参照ください。

○

NASSecurityGroupDescription

string

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

※4バイト文字（絵文字や一部の漢字など）は使用できません

使用可能文字: 1〜255文字の印字可能なASCII文字

応答フィールド

フィールド (項目)	型	説明
CreateNASSecurityGroupResponse	structure	ルート
␣CreateNASSecurityGroupResult	structure	結果
␣␣NASSecurityGroup	structure	NASファイアウォールグループ備考: NASSecurityGroupの子要素はDescribeNASSecurityGroupsで返却される要素をすべて記載しているためAPIによっては返却されない要素もあります。実際のレスポンスはレスポンスサンプルを参照してください。
␣␣␣NASSecurityGroupDescription	string	NASファイアウォールグループの説明
␣␣␣NASSecurityGroupName	string	NASファイアウォールグループ名
␣␣␣SecurityGroups	list	ニフクラファイアウォールグループ要素リスト
␣␣␣␣SecurityGroup	structure	ニフクラファイアウォールグループ要素
␣␣␣␣␣SecurityGroupName	string	ニフクラファイアウォールグループ名
␣␣␣␣␣SecurityGroupOwnerId	string	ニフクラのファイアウォールグループを所有しているニフクラID
␣␣␣␣␣Status	string	ニフクラのファイアウォールグループのステータス値：authorized(有効)\|authorizing(追加中)\|revoking(削除中)\|auth-failed(追加エラー)\|revoke-failed(削除エラー)\|not-exists(追加エラー(グループが存在しません))
␣␣␣IPRanges	list	IP帯リスト
␣␣␣␣IPRange	structure	IP帯
␣␣␣␣␣CIDRIP	string	CIDR
␣␣␣␣␣Status	string	IP帯のステータス値：authorized(有効)\|authorizing(追加中)\|revoking(削除中)\|auth-failed(追加エラー)\|revoke-failed(削除エラー))
␣␣␣OwnerId	string	NASファイアウォールグループを所有しているニフクラID
␣␣␣AvailabilityZone	string	NASファイアウォールグループのゾーン
␣ResponseMetadata	structure	共通メタ情報
␣␣RequestId	string	リクエスト識別子

エラー

コード	メッセージ	タイプ	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	The parameter NASSecurityGroupName must be provided and must not be blank.	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 lowercase 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.IllegalInput.NASSecurityGroupDescription	NASSecurityGroupDescription (4バイト文字) is not a valid parameter.	Sender	400	NASSecurityGroupDescriptionに4バイト文字を含む値を指定した場合
Client.InvalidParameter.TooLong.NASSecurityGroupDescription	NASSecurityGroupDescription can be no longer than 255 characters	Sender	400	NASSecurityGroupDescriptionに255文字以上を指定した場合
Client.InvalidParameter.Required.AvailabilityZone	The parameter AvailabilityZone must be provided and must not be blank.	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-11
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &Timestamp=2016-02-24T00:00:00.000Z
  &AWSAccessKeyId=<NIFCLOUD 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>