CopyInstances
処理概要
指定したサーバーのコピーを作成します。
停止中もしくは起動中のサーバーのみ指定ができます。コピー後のサーバー名は、指定したコピー後のサーバー名の後ろに「-連番」が付加された名称になります。
サーバーを指定するためには、サーバー名が必要です。
ディスクが接続しているサーバーのコピーは、指定したサーバーと同一ゾーンでのみ実行可能です。
一部のサーバータイプは一度に指定できるコピー台数が1台のみです。
指定するパラメーター
| パラメーター | 型 | 説明 | 必須 | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| InstanceId | string |
コピー元サーバーのサーバー名 |
○ | ||||||||
| CopyInstance.InstanceName | string |
コピー後のサーバー名 |
○ | ||||||||
| CopyInstance.InstanceType | string |
サーバータイプ 値:
備考: h2r,e2r,c2rについては、対象でないリージョンで指定した場合にエラーとなります |
|||||||||
| CopyInstance.AccountingType | string |
利用料金タイプ 値:
|
|||||||||
| CopyInstance.IpType | string |
コピー先サーバーのIPアドレスのタイプ 値:
|
|||||||||
| CopyInstance.LoadBalancers.n.LoadBalancerName | string |
ロードバランサー名 |
|||||||||
| CopyInstance.LoadBalancers.n.LoadBalancerPort | integer |
待ち受けポート |
|||||||||
| CopyInstance.LoadBalancers.n.InstancePort | integer |
宛先ポート |
|||||||||
| CopyInstance.SecurityGroup.n | string |
適用するファイアウォールグループ名 |
|||||||||
| CopyCount | integer |
コピー台数 Default: 1 使用可能文字: 1 - 作成可能な台数(上限数 - 既存サーバーの台数) |
|||||||||
| CopyInstance.Placement.RegionName | string |
リージョン情報 Default: リクエスト先エンドポイントのリージョン |
|||||||||
| CopyInstance.Placement.AvailabilityZone | string |
ゾーン情報 Default: サーバーのゾーン(リージョン指定なし)またはリージョン内のゾーンからニフクラが決定(リージョン指定あり) |
|||||||||
| NetworkInterface.n.DeviceIndex | integer |
※指定不可 |
|||||||||
| NetworkInterface.n.SecurityGroupId.n | string |
※指定不可 |
|||||||||
| NetworkInterface.n.NetworkId | string |
ネットワークID 使用可能文字: net-COMMON_GLOBAL(共通グローバル)、net-COMMON_PRIVATE(共通プライベート)、プライベートLAN のネットワークID |
○ (NetworkInterface.n.IpAddressを指定した場合、ネットワーク名といずれか) | ||||||||
| NetworkInterface.n.NetworkName | string |
ネットワーク名(共通グローバルと共通プライベートは、ネットワークIDを指定) |
○ (NetworkInterface.n.IpAddressを指定した場合、ネットワークIDといずれか) | ||||||||
| NetworkInterface.n.IpAddress | string |
IPアドレス
|
応答フィールド
| フィールド (項目) | 型 | 説明 |
|---|---|---|
| CopyInstancesResponse | - |
CopyInstances レスポンス |
| ␣requestId | string |
リクエスト識別子 |
| ␣copyInstanceSet | - |
コピー後のサーバー設定情報 |
| ␣␣item | - |
コピー後のサーバー設定情報のセット |
| ␣␣␣instanceId | string |
コピー後のサーバー名 |
| ␣␣␣instanceUniqueId | string |
コピー後のサーバーユニークID |
| ␣␣␣instanceState | string |
コピー後のサーバーのステータス 値:
|
リクエストサンプル
https://jp-east-1.computing.api.nifcloud.com/api/
?Action=CopyInstances
&InstanceId=server01
&CopyInstance.InstanceName=copyserver
&CopyCount=2
&CommonParams
応答サンプル
<CopyInstancesResponse xmlns="https://computing.api.nifcloud.com/api/">
<requestId>ac501097-4c8d-475b-b06b-a90048ec181c</requestId>
<copyInstanceSet>
<item>
<instanceId>copyserver-01</instanceId>
<instanceUniqueId>i-abfd1234</instanceUniqueId>
<instanceState>waiting</instanceState>
</item>
<item>
<instanceId>copyserver-02</instanceId>
<instanceUniqueId>i-abfd5678</instanceUniqueId>
<instanceState>waiting</instanceState>
</item>
</copyInstanceSet>
</CopyInstancesResponse>
