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 |
サーバータイプ 値:
|
|||||||||
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からのサーバー削除の可否 値:
|
|||||||||
InstanceInitiatedShutdownBehavior | string |
※指定不可 |
|||||||||
AccountingType | string |
利用料金タイプ 値:
|
|||||||||
InstanceId | string |
サーバー名 Default: 英数8文字 (システム発行) |
|||||||||
Admin | string |
管理者アカウント ※Windows OS選択時のみ必須 |
○ (スタンダードイメージのWindows) | ||||||||
Password | string |
管理者アカウントパスワード |
○ (スタンダードイメージのWindows) | ||||||||
IpType | string |
IPアドレスのタイプ 値:
|
|||||||||
PublicIp | string |
付替グローバルIPアドレス |
○ (IpTypeがelasticの場合) | ||||||||
Agreement | boolean |
Red Hat Enterprise Linux 5.8 64bit / 6.3 64bit、またはSPLAサーバーを指定した場合の同意 値:
|
|||||||||
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アドレス
|
|||||||||
License.n.LicenseName | string |
ライセンス種別 値:
|
|||||||||
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) 値:
Children: なし |
name | string |
現在のステータス名 値:
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 |
サーバータイプ 値:
Children: なし |
launchTime | timestamp |
サーバーの作成日時 値:
Children: なし |
placement | - |
ゾーン情報 Ancestor: item Children: availabilityZone |
availabilityZone | string |
ゾーン情報 Ancestor: placement Children: なし |
platform | string |
OS情報 値:
Children: なし |
monitoring | - |
監視情報 Ancestor: item Children: state |
state | string |
監視ステータス 値:
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イメージのアーキテクチャ 値:
Children: なし |
rootDeviceType | string |
ディスクの種類 値:
Children: なし |
blockDeviceMapping | - |
接続しているディスクの情報セット Ancestor: item Children: item |
item | - |
接続しているディスクの情報 Ancestor: blockDeviceMapping Children: deviceName | ebs |
deviceName | string |
ディスクの接続デバイス 値:
Children: なし |
ebs | - |
接続しているディスクの詳細情報 Ancestor: item Children: volumeId | status | deleteOnTermination |
volumeId | string |
ディスク名 Ancestor: ebs Children: なし |
status | string |
接続ステータス Ancestor: ebs Children: なし |
deleteOnTermination | boolean |
サーバー削除時のディスク消去 値:
Children: なし |
accountingType | string |
利用料金タイプ 値:
Children: なし |
ipType | string |
グローバルIPアドレスのタイプ 値:
Children: なし |
niftyPrivateIpType | string |
プライベートIPアドレスのタイプ 値:
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 |
ネットワークインターフェースのステータス 値:
Children: なし |
privateDnsName | string |
※空を返却 Ancestor: item Children: なし |
sourceDestCheck | string |
※空を返却 Ancestor: item Children: なし |
groupSet | - |
適用しているファイアウォール情報 ※空を返却 Ancestor: item Children: item |
item | - |
ファイアウォール情報 Ancestor: groupSet Children: groupId |
gruopId | 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 |
サーバー削除時のネットワークインターフェース消去 値:
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>