本文へジャンプします。

ニフクラ ユーザーガイド

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

CreateNASSecurityGroup

処理概要

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

指定するパラメーター

パラメーター 説明 必須
NASSecurityGroupName string

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

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

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

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


NASSecurityGroupDescription string NASファイアウォールグループの説明
使用可能文字: 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 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

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>

  
  • ※本ページ記載の金額は、すべて税抜表示です。
  • ※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
  • ※本ページの内容は、2021年9月13日時点の情報です。

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