CopyFromBackupInstance
処理概要
増分バックアップで作成されたバックアップサーバーからコピーを作成します。
コピーを行うためには、バックアップサーバーユニークIDが必要です。
コピーで作成されたサーバーは、停止状態で作成されます。
指定するパラメーター
| パラメーター | 型 | 説明 | 必須 | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| BackupInstanceUniqueId | string |
バックアップサーバーユニークID |
○ | ||||||||
| InstanceId | string |
コピーするサーバー名 Default: 英数8文字 (システム発行) |
|||||||||
| InstanceType | string |
サーバータイプ 値:
備考: h2r,e2r,c2rについては、対象でないリージョンで指定した場合にエラーとなります |
|||||||||
| AccountingType | string |
利用料金タイプ 値:
|
|||||||||
| SecurityGroup.n | string |
適用するファイアウォールグループ名 ※「SecurityGroup.1」のみ有効(複数指定不可) |
|||||||||
| DisableApiTermination | boolean |
APIからのサーバー削除の可否 値:
|
|||||||||
| NetworkInterface.n.NetworkId | string |
ネットワークID 使用可能文字: net-COMMON_GLOBAL(共通グローバル)、net-COMMON_PRIVATE(共通プライベート)、プライベートLAN のネットワークID |
○ (ネットワーク名といずれか) | ||||||||
| NetworkInterface.n.NetworkName | string |
ネットワーク名(共通グローバルと共通プライベートはネットワークIDを指定) |
○ (ネットワークIDといずれか) | ||||||||
| NetworkInterface.n.IpAddress | string |
IPアドレス
|
|||||||||
| Description | string |
メモ情報 |
応答フィールド
| フィールド (項目) | 型 | 説明 |
|---|---|---|
| CopyFromBackupInstanceResponse | - |
CopyFromBackupInstanceレスポンス |
| ␣requestId | string |
リクエスト識別子 |
| ␣return | boolean |
処理結果 |
| ␣reservationId | string |
※空を返却 |
| ␣ownerId | string |
※空を返却 |
| ␣groupSet | - |
ファイアウォールグループ情報 |
| ␣␣item | - |
|
| ␣␣␣groupId | string |
ファイアウォールグループ名 |
| ␣instance | - |
サーバーの情報 |
| ␣␣instanceId | string |
サーバー名 |
| ␣␣instanceUniqueId | string |
サーバーユニークID |
| ␣␣imageId | string |
OSイメージID |
| ␣␣instanceState | - |
サーバーの現在のステータス |
| ␣␣␣code | integer |
現在のステータスコード 備考: 返却値 0 (pending),16 (running),80 (stopped) |
| ␣␣␣name | string |
現在のステータス名 値:
|
| ␣␣privateDnsName | string |
プライベートIPアドレス |
| ␣␣dnsName | string |
グローバルIPアドレス |
| ␣␣reason | string |
異常時のエラーコード |
| ␣␣keyName | string |
SSHキー名 |
| ␣␣admin | string |
管理者アカウント |
| ␣␣amiLaunchIndex | string |
※空を返却 |
| ␣␣productCodes | - |
※空を返却 |
| ␣␣␣item | - |
|
| ␣␣␣␣productCode | string |
※空を返却 |
| ␣␣instanceType | string |
サーバータイプ 値:
|
| ␣␣launchTime | string |
サーバーの作成日時 |
| ␣␣placement | - |
ゾーン情報 |
| ␣␣␣availabilityZone | string |
ゾーン情報 |
| ␣␣kernelId | string |
※空を返却 |
| ␣␣ramdiskId | string |
※空を返却 |
| ␣␣platform | string |
OS情報 |
| ␣␣monitoring | - |
監視情報 |
| ␣␣␣state | string |
監視ステータス 値:
|
| ␣␣subnetId | string |
※空を返却 |
| ␣␣vpcId | string |
※空を返却 |
| ␣␣privateIpAddress | string |
プライベートIPアドレス |
| ␣␣ipAddress | string |
グローバルIPアドレス |
| ␣␣privateIpAddressV6 | string |
プライベートIPアドレス(IPv6) |
| ␣␣ipAddressV6 | string |
グローバルIPアドレス(IPv6) |
| ␣␣stateReason | - |
※空を返却 |
| ␣␣␣code | string |
※空を返却 |
| ␣␣␣message | string |
※空を返却 |
| ␣␣architecture | string |
OSイメージのアーキテクチャ 値:
|
| ␣␣rootDeviceType | string |
ディスクの種類 値:
|
| ␣␣rootDeviceName | string |
※空を返却 |
| ␣␣blockDeviceMapping | - |
接続しているディスクの情報 |
| ␣␣␣item | - |
|
| ␣␣␣␣deviceName | string |
ディスクの接続デバイス |
| ␣␣␣␣ebs | - |
接続しているディスクの詳細情報 |
| ␣␣␣␣␣volumeId | string |
ディスク名 |
| ␣␣␣␣␣volumeUniqueId | string |
ディスクユニークID |
| ␣␣␣␣␣status | string |
接続ステータス |
| ␣␣␣␣␣attachTime | string |
※空を返却 |
| ␣␣␣␣␣deleteOnTermination | string |
サーバー削除時のディスク消去 |
| ␣␣instanceLifecycle | string |
※空を返却 |
| ␣␣spotInstanceRequestId | string |
※空を返却 |
| ␣␣accountingType | string |
利用料金タイプ 値:
|
| ␣␣ipType | string |
グローバルIPアドレスのタイプ 値:
|
| ␣␣niftyPrivateIpType | string |
プライベートIPアドレスのタイプ 値:
|
| ␣␣description | string |
メモ情報(CDATA付) |
| ␣␣networkInterfaceSet | - |
ネットワークインターフェース情報 |
| ␣␣␣item | - |
|
| ␣␣␣␣networkInterfaceId | string |
ネットワークインターフェースID |
| ␣␣␣␣subnetId | string |
※空を返却 |
| ␣␣␣␣vpcId | string |
※空を返却 |
| ␣␣␣␣description | string |
メモ情報(CDATA付) |
| ␣␣␣␣ownerId | string |
※空を返却 |
| ␣␣␣␣niftyNetworkId | string |
ネットワークユニークID |
| ␣␣␣␣niftyNetworkName | string |
ネットワーク名 |
| ␣␣␣␣status | string |
ネットワークインタフェースのステータス 値:
|
| ␣␣␣␣macAddress | string |
MACアドレス |
| ␣␣␣␣privateIpAddress | string |
プライベートIPアドレス(v4) |
| ␣␣␣␣privateDnsName | string |
※空を返却 |
| ␣␣␣␣sourceDestCheck | string |
※空を返却 |
| ␣␣␣␣groupSet | - |
セキュリティグループ |
| ␣␣␣␣␣item | - |
|
| ␣␣␣␣␣␣groupId | string |
※空を返却 |
| ␣␣␣␣attachment | - |
サーバへの割り当て情報 |
| ␣␣␣␣␣attachmentId | string |
※空を返却 |
| ␣␣␣␣␣deviceIndex | string |
デバイス番号 |
| ␣␣␣␣␣status | string |
接続ステータス 値:
|
| ␣␣␣␣␣attachTime | string |
※空を返却 |
| ␣␣␣␣␣deleteOnTermination | string |
サーバー削除時のディスク消去 値:
|
| ␣␣␣␣␣instanceId | string |
※空を返却 |
| ␣␣␣␣␣instanceOwnerId | string |
※空を返却 |
| ␣␣␣␣association | - |
付替IPアドレスとしての情報 |
| ␣␣␣␣␣allocationId | string |
※空を返却 |
| ␣␣␣␣␣associationId | string |
※空を返却 |
| ␣␣␣␣␣ipOwnerId | string |
※空を返却 |
| ␣␣␣␣␣publicDnsName | string |
※空を返却 |
| ␣␣␣␣␣publicIp | string |
グローバルIPアドレスまたはグローバル付替IPアドレス |
| ␣␣␣␣␣publicIpV6 | string |
グローバルIPアドレス(IPv6) |
| ␣␣␣␣privateIpAddressesSet | - |
プライベートIPアドレス(v4)セット |
| ␣␣␣␣␣item | - |
|
| ␣␣␣␣␣␣association | - |
付替IPアドレスとしての情報 |
| ␣␣␣␣␣␣␣allocationId | string |
※空を返却 |
| ␣␣␣␣␣␣␣associationId | string |
※空を返却 |
| ␣␣␣␣␣␣␣ipOwnerId | string |
※空を返却 |
| ␣␣␣␣␣␣␣publicDnsName | string |
※空を返却 |
| ␣␣␣␣␣␣␣publicIp | string |
グローバルIPアドレスまたはグローバル付替IPアドレス |
| ␣␣␣␣␣␣␣publicIpV6 | string |
グローバルIPアドレス(IPv6) |
| ␣␣␣␣␣␣primary | string |
※空を返却 |
| ␣␣␣␣␣␣privateDnsName | string |
※空を返却 |
| ␣␣␣␣␣␣privateIpAddress | string |
※空を返却 |
リクエストサンプル
https://jp-east-1.computing.api.nifcloud.com/api/?
Action=CopyFromBackupInstance
&BackupInstanceUniqueId=bi-0123abcd
&InstanceId=server04
&NetworkInterface.1.NetworkId=net-COMMON_GLOBAL
&NetworkInterface.2.NetworkId=net-COMMON_PRIVATE
&SecurityGroup.1=firewall
&CommonParams
応答サンプル
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<CopyFromBackupInstanceResponse xmlns="https://computing.api.nifcloud.com/api/">
<requestId>dd1c39b0-a251-4596-a058-4f4c35069b9d</requestId>
<return>true</return>
<reservationId/>
<ownerId/>
<groupSet>
<item>
<groupId>firewall</groupId>
</item>
</groupSet>
<instance>
<instanceId>server04</instanceId>
<instanceUniqueId>i-0123abcd</instanceUniqueId>
<imageId>56</imageId>
<instanceState>
<code>0</code>
<name>pending</name>
</instanceState>
<privateDnsName/>
<dnsName/>
<reason/>
<keyName/>
<admin/>
<amiLaunchIndex/>
<productCodes>
<item>
<productCode/>
</item>
</productCodes>
<instanceType>mini</instanceType>
<launchTime/>
<placement>
<availabilityZone>east-11</availabilityZone>
</placement>
<kernelId/>
<ramdiskId/>
<platform>centos</platform>
<monitoring>
<state>monitoring-disabled</state>
</monitoring>
<subnetId/>
<vpcId/>
<privateIpAddress/>
<ipAddress/>
<privateIpAddressV6/>
<ipAddressV6/>
<stateReason>
<code/>
<message/>
</stateReason>
<architecture>x86_64</architecture>
<rootDeviceType>disk</rootDeviceType>
<rootDeviceName/>
<blockDeviceMapping/>
<instanceLifecycle/>
<spotInstanceRequestId/>
<accountingType>2</accountingType>
<ipType>static</ipType>
<niftyPrivateIpType>static</niftyPrivateIpType>
<description><![CDATA[メモ]]></description>
<networkInterfaceSet>
<item>
<networkInterfaceId/>
<subnetId/>
<vpcId/>
<description></description>
<ownerId/>
<niftyNetworkId>net-COMMON_GLOBAL</niftyNetworkId>
<niftyNetworkName/>
<status>processing</status>
<macAddress/>
<privateIpAddress/>
<privateIpAddressV6/>
<privateDnsName/>
<sourceDestCheck/>
<groupSet>
<item>
<groupId/>
</item>
</groupSet>
<attachment>
<attachmentId/>
<deviceIndex>0</deviceIndex>
<status>attached</status>
<attachTime/>
<deleteOnTermination>true</deleteOnTermination>
</attachment>
<association>
<allocationId/>
<associationId/>
<ipOwnerId/>
<publicDnsName/>
<publicIp/>
</association>
<privateIpAddressesSet>
<item>
<association>
<allocationId/>
<associationId/>
<ipOwnerId/>
<publicDnsName/>
<publicIp/>
</association>
<primary/>
<privateDnsName/>
<privateIpAddress/>
</item>
</privateIpAddressesSet>
</item>
<item>
<networkInterfaceId/>
<subnetId/>
<vpcId/>
<description></description>
<ownerId/>
<niftyNetworkId>net-COMMON_PRIVATE</niftyNetworkId>
<niftyNetworkName/>
<status>processing</status>
<macAddress/>
<privateIpAddress/>
<privateIpAddressV6/>
<privateDnsName/>
<sourceDestCheck/>
<groupSet>
<item>
<groupId/>
</item>
</groupSet>
<attachment>
<attachmentId/>
<deviceIndex>0</deviceIndex>
<status>attached</status>
<attachTime/>
<deleteOnTermination>true</deleteOnTermination>
</attachment>
<association>
<allocationId/>
<associationId/>
<ipOwnerId/>
<publicDnsName/>
<publicIp/>
</association>
<privateIpAddressesSet>
<item>
<association>
<allocationId/>
<associationId/>
<ipOwnerId/>
<publicDnsName/>
<publicIp/>
<publicIpV6/>
</association>
<primary/>
<privateDnsName/>
<privateIpAddress/>
</item>
</privateIpAddressesSet>
</item>
</networkInterfaceSet>
</instance>
</CopyFromBackupInstanceResponse>
