本文へジャンプします。

ニフクラ APIリファレンス

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

NAS:DeleteNASInstance

処理概要

NASを削除します。
この操作の進捗状況を確認するにはDescribeNASInstancesアクションを利用してください。
このアクションは一度送信するとキャンセル・取り消しを行うことはできません。

リクエストパラメーター

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

NAS名

  • ※1〜63字のアルファベット・数字・ハイフン('-')が使用できます
  • ※最初の文字はアルファベットである必要があります
  • ※末尾にハイフンをつけたりハイフンを2個連続させたりすることはできません
文字列  
DirectoryServiceAdministratorName

Directory Serviceの管理者ユーザー名

※○ 文字列 Directory Service 認証NASを指定した場合必須
DirectoryServiceAdministratorPassword

Directory Serviceの管理者ユーザーパスワード

※○ 文字列 Directory Service認証NASを指定した場合必須

レスポンス

XML

status

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

result
要素名 説明 備考
DeleteNASInstanceResponse ルート  
DeleteNASInstanceResult 結果  
NASInstance NAS  
AllocatedStorage 割り当てるディスク容量(GB) 数値  
AvailabilityZone NASのゾーン 文字列  
NASInstanceIdentifier NAS名 文字列  
NASInstanceDescription NASのゾーン説明 文字列  
NASInstanceStatus NASのステータス 文字列  
NASInstanceErrorInfo NASのエラー情報 文字列  
NASInstanceErrorCode 発生中のエラーコード 文字列  
NASInstanceErrorMessage 発生中のエラーメッセージ 文字列  
NASSecurityGroups NASファイアウォールグループ情報リスト リスト  
NASSecurityGroup NASファイアウォールグループ  
NASSecurityGroupName NASファイアウォールグループ名 文字列  
Status NASファイアウォールグループのステータス
値:active(有効) | adding(適用中) | removing(取り外し中) | failed(変更失敗)
文字列  
Endpoint エンドポイント  
Address グローバルIPアドレス 文字列  
PrivateAddress プライベートIPアドレス 文字列  
Protocol プロトコル 文字列  
CreateTime NASの作成日時 日時  
MasterUsername NASのユーザ名 文字列  
StorageType ディスクタイプ 数値  
NetworkId プライベートLANのネットワークユニークID 文字列  
AuthenticationType 認証タイプ 数値 CIFS(ローカル認証) or NFS : 0
CIFS(Directory Service 認証) : 1
DirectoryServiceDomainName Directory Service のドメイン名 文字列 対象NASのAuthenticationType=1の場合のみ表示
※ステータスが認証エラーの場合は認証タイプ変更前の情報が表示される
DomainControllers ドメインコントローラ情報リスト リスト 対象NASのAuthenticationType=1の場合のみ表示
※ステータスが認証エラーの場合は認証タイプ変更前の情報が表示される
DomainController ドメインコントローラ -  
Hostname ドメインコントローラのホスト名 文字列  
IPAddress ドメインコントローラのIPアドレス 文字列  
NASInstanceType NASタイプ 数値 標準タイプ : 0 | 高速タイプ : 1
NoRootSquash root権限許可 真偽値 許可 : true | 禁止 : false
ResponseMetadata 共通メタ情報  

エラー

コード メッセージ タイプ HTTPステータスコード 説明
Client.InvalidParameter.NotFound.NASInstanceIdentifier NASInstance aaaa not found. Sender 404 指定したNASInstanceIdentifierが存在しない場合
Client.Resource.IncorrectState.DeleteNASInstance The specified NASInstance is not in the available state. Sender 400 指定したNASのステータスが以下でない場合availablefailedstorage-full
Client.InvalidParameter.Required.NASInstanceIdentifier The parameter NASInstanceIdentifier must be provided and must not be blank. Sender 400 必須のNASInstanceIdentifierを指定しなかった場合
Client.InvalidParameter.TooLong.NASInstanceIdentifier The parameter NASInstanceIdentifier is not a valid identifier because it is longer than 63 characters. Sender 400 NASInstanceIdentifierに63文字以上指定した場合
Client.InvalidParameter.Format.NASInstanceIdentifier The parameter NASInstanceIdentifier is not a valid identifier. Identifiers must begin with a letter; must contain only ASCII letters, digits, and hyphens; and must notend with a hyphen or contain two consecutive hyphens. Sender 400 ・NASInstanceIdentifierに数字から始まる値を指定した場合・NASInstanceIdentifierに@を使用した値を指定した場合
Client.InvalidParameter.Missing.DirectoryServiceAdministratorName The parameter DirectoryServiceAdministratorName is required. Sender 400 Directory Service 認証NAS指定時にDirectoryServiceAdministratorNameを指定しなかった場合
Client.InvalidParameter.Missing.DirectoryServiceAdministratorPassword The parameter DirectoryServiceAdministratorPassword is required. Sender 400 Directory Service 認証NAS指定時にDirectoryServiceAdministratorNameを指定しなかった場合

リクエストサンプル

https://nas.jp-east-2.api.cloud.nifty.com/
    ?Action=DeleteNASInstance
    &NASInstanceIdentifier=example-nas-server
    &SignatureVersion=2
    &SignatureMethod=HmacSHA256
    &Timestamp=2016-02-24T00%3A00%3A00.000Z
    &AWSAccessKeyId=<Nifty Cloud Access Key ID>
    &Signature=<Signature>

レスポンスサンプル

<DeleteNASInstanceResponse>
  <DeleteNASInstanceResult>
    <NASInstance>
      <AllocatedStorage>2000</AllocatedStorage>
      <AvailabilityZone>east-21</AvailabilityZone>
      <NASInstanceIdentifier>example-nas-server</NASInstanceIdentifier>
      <NASInstanceStatus>deleting</NASInstanceStatus>
      <NASSecurityGroups>
        <NASSecurityGroup>
          <NASSecurityGroupName>default.east-21</NASSecurityGroupName>
          <Status>available</Status>
        </NASSecurityGroup>
      </NASSecurityGroups>
      <Endpoint>
        <Address>xxx.xxx.xxx.xxx</Address>
        <PrivateAddress>yyy.yyy.yyy.yyy</PrivateAddress>
      </Endpoint>
      <Protocol>nfs</Protocol>
      <CreateTime>2016-02-02T09:07:34.000Z</CreateTime>
      <StorageType>0</StorageType>
    </NASInstance>
  </DeleteNASInstanceResult>
  <ResponseMetadata>
    <RequestId>41ecfde1-39f0-4aff-9b95-218f85650cbb</RequestId>
  </ResponseMetadata>
</DeleteNASInstanceResponse>

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