NAS：DeleteNASInstance
処理概要
NASを削除します。
この操作の進捗状況を確認するにはDescribeNASInstancesアクションを利用してください。
このアクションは一度送信するとキャンセル・取り消しを行うことはできません。
リクエストパラメーター
| 要素名 | 説明 | 必須 | 値 | 最大値 | デフォルト値 | 備考 |
|---|---|---|---|---|---|---|
| NASInstanceIdentifier | NAS名
|
○ | 文字列 | − | − | |
| DirectoryServiceAdministratorName | Directory Serviceの管理者ユーザー名 |
※○ | 文字列 | − | − | Directory Service 認証NASを指定した場合必須 |
| DirectoryServiceAdministratorPassword | Directory Serviceの管理者ユーザーパスワード |
※○ | 文字列 | − | − | Directory Service認証NASを指定した場合必須 |
レスポンス
XML
status
statusは共通の応答メッセージを返却します。
result
| 要素名 | 説明 | 値 | 備考 |
|---|---|---|---|
| CreateNASInstanceResponse | ルート | − | |
| CreateNASInstanceResult | 結果 | − | |
| 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>
