本文へジャンプします。

ニフクラ ユーザーガイド

クラウド トップ>API> コンピューティング> RunInstances

RunInstances

処理概要

サーバーを新規作成します。1回のリクエストで、1つのサーバーを作成できます。

サーバーの作成には、時間がかかることがあります。このAPIのレスポンス「instanceState」を確認し「pending」が返ってきた、タイムアウトした場合は、API「DescribeInstances」のレスポンス値「instanceState」でサーバーのステータスを確認できます。

APIのパラメーターに「IpType」、「NetworkInterface.n.NetworkId」両方を指定しなかった場合、「IpType」パラメーターのdefault値が適応されます。

UserDataを指定してリクエストする場合は、POSTのみの対応となりますので、ご注意ください

指定するパラメーター

パラメーター 型 説明 必須
ImageId string OSイメージID
 ○
MinCount integer ※指定不可
MaxCount integer ※指定不可
KeyName string SSHキー名
 ○ (スタンダードイメージのWindows以外)
SecurityGroup.n string 適用するファイアウォールグループ名
UserData string サーバー起動時スクリプト
UserData.Encoding string サーバー起動時スクリプトのエンコード
Default: base64
使用可能文字: プレーンテキストの場合は空、base64の場合はbase64
AddressingType string ※指定不可
InstanceType string サーバータイプ
値:
  • e-mini
  • mini
  • c-small
  • e-small
  • small
  • c-small2
  • e-small2
  • small2
  • c-small4
  • e-small4
  • small4
  • e-small8
  • small8
  • e-small16
  • small16
  • c-medium
  • e-medium
  • medium
  • c-medium4
  • e-medium4
  • medium4
  • c-medium8
  • e-medium8
  • medium8
  • e-medium16
  • medium16
  • e-medium24
  • medium24
  • c-large
  • e-large
  • large
  • c-large8
  • e-large8
  • large8
  • e-large16
  • large16
  • e-large24
  • large24
  • e-large32
  • large32
  • e-extra-large8
  • extra-large8
  • e-extra-large16
  • extra-large16
  • e-extra-large24
  • extra-large24
  • e-extra-large32
  • extra-large32
  • e-extra-large48
  • extra-large48
  • e-double-large16
  • double-large16
  • e-double-large24
  • double-large24
  • e-double-large32
  • double-large32
  • e-double-large48
  • double-large48
  • e-double-large64
  • double-large64
  • e-double-large96
  • double-large96
  • triple-large32
  • triple-large48
  • triple-large64
  • triple-large96
  • triple-large128
  • quad-large64
  • quad-large96
  • quad-large128
  • septa-large128
Default: mini
Placement.GroupName string ※指定不可
Placement.AvailabilityZone string ゾーン情報
Default: ニフクラが決定
KernelId string ※指定不可
RamdiskId string ※指定不可
BlockDeviceMapping.n.DeviceName string ※指定不可
BlockDeviceMapping.n.VirtualName string ※指定不可
BlockDeviceMapping.n.Ebs.SnapshotId string ※指定不可
BlockDeviceMapping.n.Ebs.VolumeSize integer ※指定不可
BlockDeviceMapping.n.Ebs.DeleteOnTermination boolean ※指定不可
BlockDeviceMapping.n.Ebs.NoDevice boolean ※指定不可
Monitoring.Enabled boolean ※指定不可
Default: False (基本監視の設定なし)
SubnetId string ※指定不可
DisableApiTermination boolean APIからのサーバー削除の可否
値:
  • True (削除不可)
  • False (削除可)
Default: True (削除不可)
InstanceInitiatedShutdownBehavior string ※指定不可
AccountingType string 利用料金タイプ
値:
  • 1 (月額課金)
  • 2 (従量課金)
Default: 2 (従量課金)
InstanceId string サーバー名
Default: 英数8文字 (システム発行)
Admin string 管理者アカウント
※Windows OS選択時のみ必須
 ○ (スタンダードイメージのWindows)
Password string 管理者アカウントパスワード
 ○ (スタンダードイメージのWindows)
IpType string IPアドレスのタイプ
値:
  • static (固定化)
  • elastic (付替)
  • none (グローバルIPなし)
Default: static (NetworkInterfaceの定義が指定されていれば、NetworkInterfaceの定義を適用)
PublicIp string 付替グローバルIPアドレス
 ○ (IpTypeがelasticの場合)
Agreement boolean Red Hat Enterprise Linux 5.8 64bit / 6.3 64bit、またはSPLAサーバーを指定した場合の同意
値:
  • True (同意する)
  • False (同意しない)
Default: False (同意しない)
Description string メモ
NetworkInterface.n.DeviceIndex integer ※指定不可
NetworkInterface.n.SecurityGroupId.n string ※指定不可
NetworkInterface.n.NetworkId string ネットワークID
使用可能文字: net-COMMON_GLOBAL(共通グローバル)、net-COMMON_PRIVATE(共通プライベート)、プライベートLAN のネットワークID
 ○ (ネットワーク名といずれか)
NetworkInterface.n.NetworkName string ネットワーク名
 ○ (ネットワークIDといずれか)
NetworkInterface.n.IpAddress string

IPアドレス

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

License.n.LicenseName string ライセンス種別
値:
  • RDS
  • Office(Std) (Microsoft Office Standard)
  • Office(Pro Plus) (Microsoft Office Professional Plus)
License.n.LicenseNum string ライセンス数
使用可能文字: 1〜200の数値

応答フィールド

フィールド (項目) 型 説明
RunInstancesResponse - RunInstancesレスポンス
Ancestor: なし
Children: requestId | reservationId | ownerId | groupSet | instancesSet
requestId string リクエスト識別子
Ancestor: RunInstancesResponse
Children: なし
reservationId string ※空を返却
Ancestor: RunInstancesResponse
Children: なし
ownerId string ※空を返却
Ancestor: RunInstancesResponse
Children: なし
groupSet - 適用したファイアウォールグループ情報
Ancestor: RunInstancesResponse
Children: item
item - ファイアウォールグループ情報
Ancestor: groupSet
Children: groupId
groupId string ファイアウォールグループ名
Ancestor: item
Children: なし
instancesSet - 作成に成功したサーバーの情報セット
Ancestor: RunInstancesResponse
Children: item
item - 作成に成功したサーバーの情報
Ancestor: instancesSet
Children: instanceId | instanceUniqueId | imageId | instanceState | privateDnsName | dnsName | reason | keyName | admin | instanceType | launchTime | placement | platform | monitoring | privateIpAddress | ipAddress | privateIpAddressV6 | ipAddressV6 | architecture | rootDeviceType | blockDeviceMapping | accountingType | ipType | niftyPrivateIpType | description | networkInterfaceSet | isoImage
instanceId string サーバー名
Ancestor: item
Children: なし
instanceUniqueId string サーバーユニークID
Ancestor: item
Children: なし
imageId string OSイメージ名
Ancestor: item
Children: なし
instanceState - サーバーの現在のステータス
Ancestor: item
Children: code | name
code integer 現在のステータスコード
(A 16-bit unsigned)
値:
  • 0(pending)
  • 16(running)
  • 80(stopped)
Ancestor: instanceState
Children: なし
name string 現在のステータス名
値:
  • pending(処理中)
  • running(起動済み)
  • stopped(停止済み)
Ancestor: instanceState
Children: なし
privateDnsName string プライベートIPアドレス
Ancestor: item
Children: なし
dnsName string グローバルIPアドレス
Ancestor: item
Children: なし
reason string 異常時のエラーコード
※instanceStateで異常が発生した場合に返される。
Ancestor: item
Children: なし
keyName string SSHキー名
Ancestor: item
Children: なし
admin string 管理者アカウント
Ancestor: item
Children: なし
instanceType string サーバータイプ
値:
  • e-mini
  • mini
  • c-small
  • e-small
  • small
  • c-small2
  • e-small2
  • small2
  • c-small4
  • e-small4
  • small4
  • e-small8
  • small8
  • e-small16
  • small16
  • c-medium
  • e-medium
  • medium
  • c-medium4
  • e-medium4
  • medium4
  • c-medium8
  • e-medium8
  • medium8
  • e-medium16
  • medium16
  • e-medium24
  • medium24
  • c-large
  • e-large
  • large
  • c-large8
  • e-large8
  • large8
  • e-large16
  • large16
  • e-large24
  • large24
  • e-large32
  • large32
  • e-extra-large8
  • extra-large8
  • e-extra-large16
  • extra-large16
  • e-extra-large24
  • extra-large24
  • e-extra-large32
  • extra-large32
  • e-extra-large48
  • extra-large48
  • e-double-large16
  • double-large16
  • e-double-large24
  • double-large24
  • e-double-large32
  • double-large32
  • e-double-large48
  • double-large48
  • e-double-large64
  • double-large64
  • e-double-large96
  • double-large96
  • triple-large48
  • triple-large64
  • triple-large96
  • triple-large128
  • quad-large128
Ancestor: item
Children: なし
launchTime timestamp サーバーの作成日時
値:
  • yyyy-mm-ddThh:mi:ss.sssZ
Ancestor: item
Children: なし
placement - ゾーン情報
Ancestor: item
Children: availabilityZone
availabilityZone string ゾーン情報
Ancestor: placement
Children: なし
platform string OS情報
値:
  • windows
  • redhat
  • centos
  • ubuntu
Ancestor: item
Children: なし
monitoring - 監視情報
Ancestor: item
Children: state
state string 監視ステータス
値:
  • monitoring-disabled(disabled)
Ancestor: monitoring
Children: なし
privateIpAddress string プライベートIPアドレス
Ancestor: item
Children: なし
ipAddress string グローバルIPアドレス
Ancestor: item
Children: なし
privateIpAddressV6 string ※空を返却
プライベートIPアドレス（IPv6）
Ancestor: item
Children: なし
ipAddressV6 string ※空を返却
グローバルIPアドレス（IPv6）
Ancestor: item
Children: なし
architecture string OSイメージのアーキテクチャ
値:
  • i386
  • x86_64
Ancestor: item
Children: なし
rootDeviceType string ディスクの種類
値:
  • disk
Ancestor: item
Children: なし
blockDeviceMapping - 接続しているディスクの情報セット
Ancestor: item
Children: item
item - 接続しているディスクの情報
Ancestor: blockDeviceMapping
Children: deviceName | ebs
deviceName string ディスクの接続デバイス
値:
  • SCSI(xx:xx)
Ancestor: item
Children: なし
ebs - 接続しているディスクの詳細情報
Ancestor: item
Children: volumeId | status | deleteOnTermination
volumeId string ディスク名
Ancestor: ebs
Children: なし
status string 接続ステータス
Ancestor: ebs
Children: なし
deleteOnTermination boolean サーバー削除時のディスク消去
値:
  • true(消去)
  • false(消去しない)
Ancestor: ebs
Children: なし
accountingType string 利用料金タイプ
値:
  • 1(月額課金)
  • 2(従量課金)
Ancestor: item
Children: なし
ipType string グローバルIPアドレスのタイプ
値:
  • static(固定)
  • elastic(付替)
  • snone(グローバルIPなし)
Ancestor: item
Children: なし
niftyPrivateIpType string プライベートIPアドレスのタイプ
値:
  • static(固定)
  • elastic(付替)
Ancestor: item
Children: なし
description string メモ
Ancestor: item
Children: なし
networkInterfaceSet - ネットワークインターフェース情報セット
Ancestor: item
Children: item
item - ネットワークインターフェース情報
Ancestor: networkInterfaceSet
Children: networkInterfaceId | subnetId | vpcId | description | ownerId | niftyNetworkId | niftyNetworkName | status | privateDnsName | sourceDestCheck | groupSet | attachment | association | privateIpAddressesSet
networkInterfaceId string ※空を返却
Ancestor: item
Children: なし
subnetId string ※空を返却
Ancestor: item
Children: なし
vpcId string ※空を返却
Ancestor: item
Children: なし
description string ※空を返却
Ancestor: item
Children: なし
ownerId string ※空を返却
Ancestor: item
Children: なし
niftyNetworkId string ネットワークユニークID
Ancestor: item
Children: なし
niftyNetworkName string ネットワーク名
Ancestor: item
Children: なし
status string ネットワークインターフェースのステータス
値:
  • available(利用可能)
  • in-use(使用中)
  • processing(処理中)
Ancestor: item
Children: なし
privateDnsName string ※空を返却
Ancestor: item
Children: なし
sourceDestCheck string ※空を返却
Ancestor: item
Children: なし
groupSet - 適用しているファイアウォール情報 ※空を返却
Ancestor: item
Children: item
item - ファイアウォール情報
Ancestor: groupSet
Children: groupId
groupId string ファイアウォールグループ名
Ancestor: item
Children: なし
attachment - ネットワークインターフェースの接続情報
Ancestor: item
Children: attachmentID | deviceIndex | status | attachTime | deleteOnTermination
attachmentID string ※空を返却
Ancestor: attachment
Children: なし
deviceIndex integer デバイス番号
Ancestor: attachment
Children: なし
status string 接続状態
Ancestor: attachment
Children: なし
attachTime timestamp ※空を返却
Ancestor: attachment
Children: なし
deleteOnTermination boolean サーバー削除時のネットワークインターフェース消去
値:
  • true(消去)
Ancestor: attachment
Children: なし
association - ネットワークインターフェースに関連付けられているパブリックIP（固定グローバルIPアドレス、付替IPアドレス）の情報
Ancestor: item
Children: publicDnsName | ipOwnerId
publicDnsName string ※空を返却
Ancestor: association
Children: なし
ipOwnerId string ※空を返却
Ancestor: association
Children: なし
privateIpAddressesSet - ※空を返却
Ancestor: item
Children: item
item - インスタンスに付属するプライベートIP
Ancestor: privateIpAddressesSet
Children: association | primary | privateDnsName | privateIpAddress
association - 付替IPアドレスの関連付け情報
Ancestor: item
Children: ipOwnerId | publicDnsName | publicIp
ipOwnerId string 付替IPアドレスのオーナーID
Ancestor: association
Children: なし
publicDnsName string パブリックDNS名
Ancestor: association
Children: なし
publicIp string ネットワークインターフェースのパブリックIP
Ancestor: association
Children: なし
primary boolean ネットワークインターフェースのプライマリープライベートIP情報
Ancestor: item
Children: なし
privateDnsName string プライベートDNS名
Ancestor: item
Children: なし
privateIpAddress string ネットワークインターフェースのプライベートIP
Ancestor: item
Children: なし
isoImage - ※空を返却
適用しているISOイメージの情報
Ancestor: item
Children: item
item - 適用しているISOイメージの情報
Ancestor: isoImage
Children: isoImageId | isoImageName
isoImageId string 適用しているISOイメージユニークID
Ancestor: item
Children: なし
isoImageName string 適用しているISOイメージ名
Ancestor: item
Children: なし

リクエストサンプル

    https://jp-east-1.computing.api.nifcloud.com/api/
  ?Action=RunInstances
  &ImageId=1
  &KeyName=sshkey01
  &InstanceType=medium
  &InstanceId=server04
  &Description=memo
  &NetworkInterface.1.IpAddress=111.111.111.111
  &NetworkInterface.1.NetworkId=net-COMMON_GLOBAL
  &NetworkInterface.2.IpAddress=192.168.0.1
  &NetworkInterface.2.NetworkName=network
  &SecurityGroup.1=group
  &CommonParams

応答サンプル

    <RunInstancesResponse xmlns="https://computing.api.nifcloud.com/api/">
  <requestId>ac501097-4c8d-475b-b06b-a90048ec181c</requestId>
  <reservationId></reservationId>
  <ownerId></ownerId>
  <groupSet>
    <item>
      <groupId>group</groupId>
    </item>
  </groupSet>
  <instancesSet>
    <item>
      <instanceId>server04</instanceId>
      <instanceUniqueId>i-efgh1234</instanceUniqueId>
      <imageId>customimage</imageId>
      <instanceState>
        <code>0</code>
        <name>pending</name>
      </instanceState>
      <privateDnsName>192.168.0.1</privateDnsName>
      <dnsName>111.111.111.111</dnsName>
      <admin></admin>
      <instanceType>medium</instanceType>
      <launchTime>2010-05-17T11:22:33.456+09:00</launchTime>
      <placement>
        <availabilityZone>east-11</availabilityZone>
      </placement>
      <platform>centos</platform>
      <monitoring>
        <state>monitoring-disable</state>
      </monitoring>
      <privateIpAddress>192.168.0.1</privateIpAddress>
      <ipAddress>111.111.111.111</ipAddress>
      <privateIpAddressV6></privateIpAddressV6>
      <ipAddressV6></ipAddressV6>
      <architecture>x86_64</architecture>
      <rootDeviceType>disk</rootDeviceType>
      <blockDeviceMapping>
        <item>
          <deviceName>SCSI (0:1)</deviceName>
          <ebs>
            <volumeId>disk0001</volumeId>
            <status>attaching</status>
            <deleteOnTermination>false</deleteOnTermination>
          </ebs>
        </item>
      </blockDeviceMapping>
      <accountingType>2</accountingType>
      <ipType>elastic</ipType>
      <niftyPrivateIpType>static</niftyPrivateIpType>
      <description>memo</description>
      <networkInterfaceSet>
        <item>
          <networkInterfaceId></networkInterfaceId>
          <subnetId></subnetId>
          <vpcId></vpcId>
          <description></description>
          <ownerId></ownerId>
          <niftyNetworkId>net-COMMON_GLOBAL</niftyNetworkId>
          <status>processing</status>
          <privateDnsName></privateDnsName>
          <sourceDestCheck></sourceDestCheck>
          <groupSet></groupSet>
          <attachment>
            <attachmentID></attachmentID>
            <deviceIndex>0</deviceIndex>
            <status>attached</status>
            <attachTime></attachTime>
            <deleteOnTermination>true</deleteOnTermination>
          </attachment>
          <association>
            <publicDnsName></publicDnsName>
            <ipOwnerId></ipOwnerId>
          </association>
          <privateIpAddressesSet></privateIpAddressesSet>
        </item>
        <item>
          <networkInterfaceId></networkInterfaceId>
          <subnetId></subnetId>
          <vpcId></vpcId>
          <description></description>
          <ownerId></ownerId>
          <niftyNetworkId>net-0glomv00</niftyNetworkId>
          <niftyNetworkName>network</niftyNetworkName>
          <status>processing</status>
          <privateDnsName></privateDnsName>
          <sourceDestCheck></sourceDestCheck>
          <groupSet></groupSet>
          <attachment>
            <attachmentID></attachmentID>
            <deviceIndex>0</deviceIndex>
            <status>attached</status>
            <attachTime></attachTime>
            <deleteOnTermination>true</deleteOnTermination>
          </attachment>
          <privateIpAddressesSet></privateIpAddressesSet>
        </item>
      </networkInterfaceSet>
      <isoImage/>
    </item>
  </instancesSet>
</RunInstancesResponse>

ニフクラ サイト内検索

APIメニュー

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

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

ページの先頭へ