本文へジャンプします。

ニフクラ ユーザーガイド

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

ModifyNASInstance

処理概要

NASの設定を変更します。
一度に複数のNAS設定を変更することができます。

NASに接続した状態でプライベートIPアドレスを変更すると、NASにアクセスできなくなる場合があります。
NASのプライベートIPアドレスを変更する場合は、NASへの接続がないことをご確認ください。
NASにアクセスできなくなった場合は、クライアント側のOS強制再起動を行ってください。

指定するパラメーター

パラメーター 説明 必須
AllocatedStorage integer ディスク容量 ※容量を減らすことはできません
単位: GB
値:
NASInstanceType=0 の場合
  • 100
  • 200
  • 300
  • 400
  • 500
  • 600
  • 700
  • 800
  • 900
  • 1000
NASInstanceType=1 の場合
  • 1000
  • 2000
  • 3000
  • 4000
  • 5000
  • 6000
  • 7000
  • 8000
  • 9000
  • 10000
Default: 既存の設定
NASInstanceIdentifier string 変更対象のNAS名
NASSecurityGroups.member.N string

NASファイアウォールグループのリスト

  • ※1つのみ指定可能です。複数指定した場合、2つ目以降は無視されます

MasterUserPassword string マスターユーザーの新パスワード
Default: 既存の設定
使用可能文字: 「/」、「@」、「"」、「 」、「'」を除く、1〜128文字の印字可能なASCII文字
備考: Protocol = cifs時のみ指定可能
NewNASInstanceIdentifier string

新しいNAS名

  • ※最初の文字はアルファベットである必要があります
  • ※末尾にハイフンをつけたりハイフンを2個連続させたりすることはできません

使用可能文字: 1〜63字のアルファベット(小文字)・数字・ハイフン('-')
NASInstanceDescription string

NASの説明

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

使用可能文字: 1〜255文字の印字可能なASCII文字
MasterPrivateAddress string NAS用のプライベートIPアドレス
NetworkId string 変更先のプライベートLANのネットワークID
値:
共通プライベートにする の場合
  

net-COMMON_PRIVATE


プライベートLANにする の場合
  

プライベートLANのネットワークユニークID


AuthenticationType integer 認証タイプ
値:
  • 0 (ローカル認証)
  • 1 (Directory Service 認証)
Default: 既存の設定
備考: NAS作成時は0
DirectoryServiceDomainName string Directory Service のドメイン名
使用可能文字: 「;」、「|」、「&」、「`」、「(」、「)」、「$」、「<」、「>」、「*」、「?」、「{」、「}」、「[」、「]」、「!」、「/」、「'」、「"」、「\」を除く、1〜256文字の印字可能なASCII文字
○ (・ローカル認証からDirectory Service 認証へ変更する場合
・ステータスが認証エラー時に再度認証設定変更する場合)
DirectoryServiceAdministratorName string Directory Service の管理者ユーザー名
使用可能文字: 「;」、「|」、「&」、「`」、「(」、「)」、「$」、「<」、「>」、「*」、「?」、「{」、「}」、「[」、「]」、「!」、「/」、「'」、「"」、「\」を除く、1〜128文字の印字可能なASCII文字
○ (・ローカル認証からDirectory Service 認証へ変更する場合
・ステータスが認証エラー時に再度認証設定変更する場合)
DirectoryServiceAdministratorPassword string Directory Service の管理者ユーザーパスワード
使用可能文字: 「;」、「|」、「&」、「`」、「(」、「)」、「$」、「<」、「>」、「*」、「?」、「{」、「}」、「[」、「]」、「!」、「/」、「'」、「"」、「\」を除く、1〜128文字の印字可能なASCII文字
○ (・ローカル認証からDirectory Service 認証へ変更する場合
・ステータスが認証エラー時に再度認証設定変更する場合)
DomainControllers.member.N.Hostname string

ドメインコントローラのホスト名

  • DomainController.member.N.IPAddressとセットで指定します。
  • 例:&DomainControllers.member.1.Hostname=nasaddc&DomainController.member.1.IPAddress=192.168.100.2

使用可能文字: 「;」、「|」、「&」、「`」、「(」、「)」、「$」、「<」、「>」、「*」、「?」、「{」、「}」、「[」、「]」、「!」、「/」、「'」、「"」、「\」を除く、1〜256文字の印字可能なASCII文字
備考: Nの部分は連番
○ (・ローカル認証からDirectory Service 認証へ変更する場合
・ステータスが認証エラー時に再度認証設定変更する場合)
DomainControllers.member.N.IPAddress string

ドメインコントローラのIPアドレス

  • DomainControllers.member.N.Hostnameとセットでを指定します。
  • 例:&DomainControllers.member.1.Hostname=nasaddc&DomainController.member.1.IPAddress=192.168.100.2

備考: Nの部分は連番
○ (・ローカル認証からDirectory Service 認証へ変更する場合
・ステータスが認証エラー時に再度認証設定変更する場合)
NoRootSquash boolean nfsのroot権限使用許可の指定
値:
  • true (root権限での使用を許可(no_root_squash))
  • false (root権限での使用を拒否(root_squash))
Default: 既存の設定
備考: プロトコルがnfsの場合のみ有効、cifsの場合は入力値を無視する。

応答フィールド

フィールド (項目) 説明
ModifyNASInstanceResponse structure ルート
ModifyNASInstanceResult structure 結果
NASInstance structure NAS
備考: NASInstanceの子要素はDescribeNASInstancesで返却される要素をすべて記載しているためAPIによっては返却されない要素もあります。実際のレスポンスはレスポンスサンプルを参照してください。
AllocatedStorage integer 割り当てるディスク容量
単位: GB
AvailabilityZone string NASのゾーン
NASInstanceClass string NASのタイプ
NASInstanceIdentifier string NAS名
NASInstanceDescription string NASの説明
NASInstanceStatus string NASのステータス
NASInstanceErrorInfo string NASのエラー情報
NASInstanceErrorCode string 発生中のエラーコード
NASInstanceErrorMessage string 発生中のエラーメッセージ
NASSecurityGroups list NASファイアウォールグループ情報リスト
NASSecurityGroup structure NASファイアウォールグループ
NASSecurityGroupName string NASファイアウォールグループ名
Status string

NASファイアウォールグループのステータス

  • 値:active(有効) | adding(適用中) | removing(取り外し中) | failed(変更失敗)

Endpoint structure エンドポイント
Address string グローバルIPアドレス
PrivateAddress string プライベートIPアドレス
Protocol string プロトコル
MasterUsername string NASのマスターユーザ名
StorageType integer ディスクタイプ
NetworkId string プライベートLANのネットワークユニークID
AuthenticationType integer 認証タイプ
備考: CIFS(ローカル認証) or NFS : 0
CIFS(Directory Service 認証) : 1
DirectoryServiceDomainName string Directory Service のドメイン名
備考: 対象NASのAuthenticationType=1の場合のみ表示
※ステータスが認証エラーの場合は認証タイプ変更前の情報が表示される
DomainControllers list ドメインコントローラ情報リスト
備考: 対象NASのAuthenticationType=1の場合のみ表示
※ステータスが認証エラーの場合は認証タイプ変更前の情報が表示される
DomainController structure ドメインコントローラ
Hostname string ドメインコントローラのホスト名
IPAddress string ドメインコントローラのIPアドレス
NASInstanceType integer NASタイプ
備考: 標準タイプ : 0 | 高速タイプ : 1
NoRootSquash boolean root権限許可
備考: false(root権限使用禁止)固定
UpgradeRequired boolean NAS領域の基盤アップグレード要否
備考: 基盤アップグレードが必要 : true | 基盤アップグレードは不要 : false
ResponseMetadata structure 共通メタ情報
RequestId string リクエスト識別子

エラー

コード メッセージ タイプ HTTPステータスコード 説明
Client.InvalidParameter.NotFound.NASInstanceIdentifier

NASInstance aaaa not found.

Sender 404 存在しないIDをNASInstanceIdentifierに指定した場合
Client.InvalidParameter.NotFound.NASSecurityGroupName

NASSecurityGroup aaaa not found.

Sender 404 存在しないファイアウォールグループをNASSecurityGroups.member.Nに指定した場合
Client.InvalidParameter.Duplicate.NASInstanceIdentifier

NASInstance already exists.

Sender 400 すでに存在するIDをNewNASInstanceIdentifierに指定した場合
Client.InvalidParameter.Format.NASInstanceIdentifier

The parameter NASInstanceIdentifier is not a valid identifier. Identifiers must begin with a letter; must contain only lowercase ASCII letters, digits, and hyphens; and must not end with a hyphen or contain two consecutive hyphens.

Sender 400 NewNASInstanceIdentifierに無効な値(数字から始まる、@を使用した値など)を指定した場合
Client.InvalidParameter.IllegalInput.NASInstanceDescription

NASInstanceDescription (4バイト文字) is not a valid parameter.

Sender 400 NASInstanceDescriptionに4バイト文字を含む値を指定した場合
Client.Resource.IncorrectState.ModifyNASInstance

The specified NASInstance is not in the modifiable state.

Sender 400 指定したNASのステータスが以下でない場合
available
incompatible-authentication
Client.Resource.IncorrectState.StorageFullNASInstance

The specified NASInstance is currently in the storage-full state. The only modification permitted on a NASInstance in this state is an increase in allocated storage.

Sender 400 NASのステータスが「storage-full」の場合に、ディスクサイズの増加以外の指定をした場合
Client.InvalidParameter.CannotSpecify.MasterUserPassword

Cannot modify MasterUserPassword for NASInstance Protocol ‘nfs’.

Sender 400 Protocol = nfsの場合MasterUserPasswordを変更しようとしたとき
Client.InvalidParameter.NotAllowed.MasterUserPassword

The parameter MasterUserPassword is not a valid password. Only printable ASCII characters besides ‘/’, ‘@’, ‘"’, ’ ‘,’'’ may be used.

Sender 400 Protocol= cifs のときにMasterUserPasswordに無効な値(@など)を指定した場合
Client.InvalidParameter.TooLong.MasterUserPassword

The parameter MasterUserPassword is not a valid password because it is longer than 128 characters.

Sender 400 Protocol= cifs のときにMasterUserPasswordに128文字以上指定した場合
Client.InvalidParameter.CannotSpecify.MasterPrivateAddress

Cannot modify MasterPrivateAddress for NASInstance is not PrivateLAN.

Sender 400 プライベートLANを使用していないNASでMasterPrivateAddressを指定したとき
Client.InvalidParameter.TooSmall.AllocatedStorage

Requested storage size (1) cannot be less then the current storage size (5)

Sender 400 AllocatedStorageに現在より小さい値を指定した場合
Client.InvalidParameter.OutOfRange.AllocatedStorage

Invalid storage size: 11000. The storage size must be between 1000 and 10000 GB.

Sender 400 AllocatedStorageに1000〜指定された最大値(デフォルトは10000)でない値を指定した場合
Client.InvalidParameter.Format.NASSecurityGroupName

NASSecurityGroupName must not contain leading or trailing spaces

Sender 400 NASSecurityGroups.member.Nの最初または最後にスペースを入力した場合
Client.InvalidParameter.Format.AllocatedStorage

AllocatedStorage should specify the multiple of 1000.

Sender 400 AllocatedStorageに1000の倍数でない値を指定した場合
Client.InvalidParameter.Format.MasterPrivateAddress

Invalid MasterPrivateAddress aaa.bbb.ccc.ddd.

Sender 400 MasterPrivateAddressにIPアドレスとして無効な値を指定したとき
Client.InvalidParameter.Duplicate.MasterPrivateAddress

Private address is already in use: 192.168.98.160.

Sender 400 MasterPrivateAddressに重複しているIPアドレスを指定したとき
Client.InvalidParameter.PrivateAddressMismacth.CIDRprefix

Invalid MasterPrivateAddress: 192.168.128.1/27. Valid value is /20.

Sender 400 MasterPrivateAddressのプレフィックスにプライベートLAN作成時のプレフィックスと異なる値を指定したとき
Client.InvalidParameter.OutOfRange.MasterPrivateAddress

Invalid MasterPrivateAddress: 192.168.128.31. Valid range is 192.168.128.1-192.168.128.30.

Sender 400 MasterPrivateAddressにサブネットの範囲外のIPアドレスを指定したとき
Client.InvalidParameter.LimitExceeded.AllocatedStorage

The total storage capacity max limit of east-21 is 10,000GB.

Sender 400 AvailavilityZoneに指定されたゾーンに存在している全てのNASのストレージサイズ合計が、設定された上限値を超えてしまう場合
Client.InvalidParameter.NotAllowed.AllocatedStorage

Sender 400 AllocatedStorageに数値でない値を指定した場合
Client.InvalidParameter.NotFound.NetworkId

Private LAN net-1234abcd does not exist.

Sender 404 存在しないNetWorkIdを指定した場合
Client.InvalidParameter.NotFound.NetworkId

Private LAN net-1234abcd does not belong to availability zone east-11.

Sender 400 指定されたゾーンと異なるゾーンに所属するNetworkIdを指定した場合
Client.Resource.IncorrectState.ApplyNASSecurityGroup

NASSecurityGroup is not in available state.

Sender 400 変更しようとしたNASファイアウォールグループのルールのうち、ステータスが、「authorizing」または「revoking」のルールが存在する場合
Client.InvalidParameter.Missing.MasterPrivateAddress

The parameter MasterPrivateAddress must be provided and must not be blank.

Sender 400 NetworkIdを指定したが、MasterPrivateAddressを指定しなかった場合
Client.InvalidParameter.Format.AuthenticationType
Sender 400 AuthenticationTypeに有効でない値を指定した場合
Client.InvalidParameter.Missing.DirectoryServiceDomainName

The parameter DirectoryServiceDomainName must be provided and must not be blank.

Sender 400 以下の認証設定変更時にDirectoryServiceAdministratorNameを指定しなかった場合
・ローカル認証からDirectory Service 認証へ変更
・ステータスが認証エラー時に再度認証設定変更
Client.InvalidParameter.Missing.DirectoryServiceAdministratorName

The parameter DirectoryServiceAdministratorName must be provided and must not be blank.

Sender 400 以下の認証設定変更時にDirectoryServiceAdministratorNameを指定しなかった場合
・ローカル認証からDirectory Service 認証へ変更
・ドメイン変更
・Directory Service 認証からローカル認証へ変更
・ステータスが認証エラー時に再度認証設定変更
Client.InvalidParameter.Missing.DirectoryServiceAdministratorPassword

The parameter DirectoryServiceAdministratorPassword must be provided and must not be blank.

Sender 400 以下の認証設定変更時にDirectoryServiceAdministratorPasswordを指定しなかった場合
・ローカル認証からDirectory Service 認証へ変更
・ドメイン変更
・Directory Service 認証からローカル認証へ変更
・ステータスが認証エラー時に再度認証設定変更
Client.InvalidParameter.Missing.DomainControllers.member.Hostname

The parameter DomainControllers.member.Hostname must be provided and must not be blank.

Sender 400 以下の認証設定変更時にDomainControllers.member.Hostnameを指定しなかった場合
・ローカル認証からDirectory Service 認証へ変更
・ドメイン変更
・ドメインコントローラ情報を変更
・ステータスが認証エラー時に再度認証設定変更
Client.InvalidParameter.Missing.DomainControllers.member.IPAddress

The parameter DomainControllers.member.IPAddress must be provided and must not be blank.

Sender 400 以下の認証設定変更時にDomainControllers.member.IPAddressを指定しなかった場合
・ローカル認証からDirectory Service 認証へ変更
・ドメイン変更
・ドメインコントローラ情報を変更
・ステータスが認証エラー時に再度認証設定変更
Client.InvalidParameter.Format.DomainControllers.member.IPAddress

Invalid IPAddress : DomainControllers.member.N.IPAddress

Sender 400 無効なIPアドレスの形式を指定した場合
Client.InvalidParameter.CannotSpecify.AuthenticationType

Cannot modify AuthenticationType for NASInstance Protocol ‘NFS’.

Sender 400 Protocol がnfsのNASでAuthenticationType=1を指定した場合
Client.InvalidParameter.Unavailable.MasterUserPassword

Unavailable MasterUserPassword for AuthenticationType ‘1’

Sender 400 AuthenticationType=1のNASでMasterUserPasswordを変更しようとした場合
Client.InvalidParameter.TooLong.DirectoryServiceDomainName

The parameter DirectoryServiceDomainName is not a valid parameter because it is longer than 256 characters.

Sender 400 DirectoryServiceDomainNameに256文字以上指定した場合
Client.InvalidParameter.TooLong.DirectoryServiceAdministratorName

The parameter DirectoryServiceAdministratorName is not a valid parameter because
it is longer than 128 characters.

Sender 400 DirectoryServiceAdministratorNameに128文字以上指定した場合
Client.InvalidParameter.TooLong.DirectoryServiceAdministratorPassword

The parameter DirectoryServiceAdministratorPassword is not a valid parameter because
it is longer than 128 characters.

Sender 400 DirectoryServiceAdministratorPasswordに128文字以上指定した場合
Client.InvalidParameter.TooLong.DomainControllers.member.Hostname

The parameter DomainControllers.member.Hostname is not a valid parameter because
it is longer than 256 characters.

Sender 400 DomainControllers.member.Hostnameに256文字以上指定した場合
Client.InvalidParameter.NotAllowed.DirectoryServiceDomainName

The parameter DirectoryServiceDomainName is not a valid parameter because It contains the banned characters in the parameter.

Sender 400 DirectoryServiceDomainNameに使用禁止文字を指定した場合
Client.InvalidParameter.NotAllowed.DirectoryServiceAdministratorName

The parameter DirectoryServiceAdministratorName is not a valid parameter because It contains the banned characters in the parameter.

Sender 400 DirectoryServiceAdministratorNameに使用禁止文字を指定した場合
Client.InvalidParameter.NotAllowed.DirectoryServiceAdministratorPassword

The parameter DirectoryServiceAdministratorPassword is not a valid parameter because It contains the banned characters in the parameter.

Sender 400 DirectoryServiceAdministratorPasswordに使用禁止文字を指定した場合
Client.InvalidParameter.NotAllowed.DomainControllers.member.Hostname

The parameter MasterUserPassword is not a valid parameter because It contains the banned characters in the parameter.

Sender 400 DomainControllers.member.Hostnameに使用禁止文字を指定した場合
Client.InvalidParameter.Format.NoRootSquash

Sender 400 NoRootSquashにtrueまたはfalse以外の値を指定した場合

リクエストサンプル

    https://jp-east-1.nas.api.nifcloud.com/
  ?Action=ModifyNASInstance
  &AllocatedStorage=2000
  &NASInstanceIdentifier=example-nas-server
  &SignatureVersion=2
  &SignatureMethod=HmacSHA256
  &Timestamp=2016-02-24T00:00:00.000Z
  &AWSAccessKeyId=<NIFCLOUD Access Key ID>
  &Signature=<Signature>

  

応答サンプル

    <ModifyNASInstanceResponse>
  <ModifyNASInstanceResult>
    <NASInstance>
      <AllocatedStorage>1000</AllocatedStorage>
      <AvailabilityZone>east-21</AvailabilityZone>
      <NASInstanceClass>small</NASInstanceClass>
      <NASInstanceIdentifier>example-nas-server</NASInstanceIdentifier>
      <NASInstanceStatus>modifying</NASInstanceStatus>
      <NASSecurityGroups>
        <NASSecurityGroup>
          <NASSecurityGroupName>default.east-21</NASSecurityGroupName>
          <Status>active</Status>
        </NASSecurityGroup>
      </NASSecurityGroups>
      <Endpoint>
        <Address>xxx.xxx.xxx.xxx</Address>
        <PrivateAddress>yyy.yyy.yyy.yyy</PrivateAddress>
      </Endpoint>
      <Protocol>nfs</Protocol>
      <InstanceCreateTime>2016-02-02T09:07:40.000+09:00</InstanceCreateTime>
      <StorageType>0</StorageType>
      <UpgradeRequired>true</UpgradeRequired>
    </NASInstance>
  </ModifyNASInstanceResult>
  <ResponseMetadata>
    <RequestId>9b66595c-de6e-416a-886f-0104105e2339</RequestId>
  </ResponseMetadata>
</ModifyNASInstanceResponse>

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

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