本文へジャンプします。

ニフクラ ユーザーガイド

本ページは2023/9/5をもって、新ページhttps://docs.nifcloud.com/cp/api/CopyInstances.htmへ移行しました。 今後は新ページをご参照ください。

CopyInstances

処理概要

指定したサーバーのコピーを作成します。

停止中もしくは起動中のサーバーのみ指定ができます。コピー後のサーバー名は、指定したコピー後のサーバー名の後ろに「-連番」が付加された名称になります。

サーバーを指定するためには、サーバー名が必要です。
ディスクが接続しているサーバーのコピーは、指定したサーバーと同一ゾーンでのみ実行可能です。

指定するパラメーター

パラメーター 説明 必須
InstanceId string コピー元サーバーのサーバー名
CopyInstance.InstanceName string コピー後のサーバー名
CopyInstance.InstanceType string サーバータイプ
値:
  • e-mini
  • h2-mini
  • mini
  • c-small
  • e-small
  • h2-small
  • small
  • c-small2
  • e-small2
  • h2-small2
  • small2
  • c-small4
  • e-small4
  • h2-small4
  • small4
  • e-small8
  • h2-small8
  • small8
  • e-small16
  • h2-small16
  • small16
  • c-medium
  • e-medium
  • h2-medium
  • medium
  • c-medium4
  • e-medium4
  • h2-medium4
  • medium4
  • c-medium8
  • e-medium8
  • h2-medium8
  • medium8
  • e-medium16
  • h2-medium16
  • medium16
  • e-medium24
  • h2-medium24
  • medium24
  • c-large
  • e-large
  • h2-large
  • large
  • c-large8
  • e-large8
  • h2-large8
  • large8
  • e-large16
  • h2-large16
  • large16
  • e-large24
  • h2-large24
  • large24
  • e-large32
  • h2-large32
  • large32
  • e-extra-large8
  • h2-extra-large8
  • extra-large8
  • e-extra-large16
  • h2-extra-large16
  • extra-large16
  • e-extra-large24
  • h2-extra-large24
  • extra-large24
  • e-extra-large32
  • h2-extra-large32
  • extra-large32
  • e-extra-large48
  • h2-extra-large48
  • extra-large48
  • e-double-large16
  • h2-double-large16
  • double-large16
  • e-double-large24
  • h2-double-large24
  • double-large24
  • e-double-large32
  • h2-double-large32
  • double-large32
  • e-double-large48
  • h2-double-large48
  • double-large48
  • e-double-large64
  • h2-double-large64
  • double-large64
  • e-double-large96
  • h2-double-large96
  • double-large96
  • h2-triple-large32
  • triple-large32
  • h2-triple-large48
  • triple-large48
  • h2-triple-large64
  • triple-large64
  • h2-triple-large96
  • triple-large96
  • h2-triple-large128
  • triple-large128
  • h2-quad-large64
  • quad-large64
  • h2-quad-large96
  • quad-large96
  • h2-quad-large128
  • quad-large128
  • h2-septa-large128
  • septa-large128
Default: mini
CopyInstance.AccountingType string 利用料金タイプ
値:
  • 1 (月額課金)
  • 2 (従量課金)
Default: 2
CopyInstance.IpType string コピー先サーバーのIPアドレスのタイプ
値:
  • static (固定化)
  • none (グローバルIPなし)
Default: static (NetworkInterfaceの定義が指定されていれば、NetworkInterfaceの定義を適用)
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アドレス

1)指定されたネットワークが共通グローバル 値 : 指定不可
Default : DHCPによるIPアドレス自動発行
2)指定されたネットワークが共通プライベート 値 : 指定不可
Default : DHCPによるIPアドレス自動発行
3)指定されたネットワークがプライベートLANでDHCPが有効化されている 値 : static(手動化)
Default : DHCPによるIPアドレス自動発行
4)指定されたネットワークがプライベートLANでDHCPが無効化されている 値 : static(手動化)

応答フィールド

フィールド (項目) 説明
CopyInstancesResponse - CopyInstances レスポンス
requestId string リクエスト識別子
copyInstanceSet - コピー後のサーバー設定情報
item - コピー後のサーバー設定情報のセット
instanceId string コピー後のサーバー名
instanceUniqueId string コピー後のサーバーユニークID
instanceState string コピー後のサーバーのステータス
値:
  • creating (コピー中)
  • waiting (コピー待ち)

リクエストサンプル

    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>

  

ニフクラ サイト内検索

APIメニュー

  • ツイッターでフォローしてください
  • ニフクラ公式フェイスブックページ
  • ※本ページ記載の金額は、すべて税抜表示です。
  • ※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
  • ※本ページの内容は、2023年9月05日時点の情報です。

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