Create Instance - iwinv IaaS(Infrastructure as a Service) API

Request

Header Params

X-iwinv-Timestamp

integer

required

Refer to [API Request]

Example:

X-iwinv-Credential

string

required

Refer to [API Request]

Example:

X-iwinv-Signature

string

required

Refer to [API Request]

Example:

Body Params multipart/form-data

zone_id

string

required

zone_code from [Zone > Zone List]

image_id

string

required

image_id from [Images]

flavor_id

string

required

flavor_id from [Flavors]

name

string

optional

Instance Name

Default Value is "iwinv Server"

URL encode the string when requesting

Min Length: 4, Max Length: 32(Allowed Characters: English, Korean, Numbers, Special Characters Below)

Allowed Special Characters: ! @ # $ % ^ & * - _ = + ( ) [ ] { } ; : ‘ “ , . < > / ?

Default:

iwinv 서버

description

string

optional

Instance Description

Max Length: 50

URL encode the string when requesting

count

integer

optional

Number of Instances

Min: 1, Max: 10 / per request

Default:

1

ssh_key_id

string

optional

ssh_key_id from [Authentication > SSH Key List]

If ssh_key_id is empty, the instance is only accessible with a username and password.

To request more than 1, separate with a comma

user_script_id

string

optional

user_script_id from [Instances > User Script List]

block_storage.N.size

integer

optional

Unit: GB

For Details, refer to Docs

N is allowed from 0 to flavor's Block Storage Limit - 1

block_storage.N.name

string

optional

Same Rule as Instance Name

Default Value is "iwinv Block Storage"

block_storage.N.type

string

deprecated

Disk Type(Only ssd is supported for now.)

security_group

string

deprecated

security_group_id from [Security Group]

attach_public_ip

boolean

deprecated

Deciding whether to attach a Public IP or not.

Default:

true

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api-kr.iwinv.kr/v1/instances' \
--header 'X-iwinv-Timestamp: {{timestamp}}' \
--header 'X-iwinv-Credential: {{accesskey}}' \
--header 'X-iwinv-Signature: {{signature}}' \
--form 'zone_id=""' \
--form 'image_id=""' \
--form 'flavor_id=""' \
--form 'name=""' \
--form 'description=""' \
--form 'count=""' \
--form 'ssh_key_id=""' \
--form 'user_script_id=""' \
--form 'block_storage.N.size=""' \
--form 'block_storage.N.name=""' \
--form 'block_storage.N.type=""' \
--form 'security_group=""' \
--form 'attach_public_ip=""'

Responses

🟢202Accepted

application/json

Body

code

string

required

Status code

error_code

string

required

Error message

message

string

required

Status message

result

array [object {12}]

required

Result

instance_id

string

optional

Instance ID

name

string

optional

Instance name

description

string

optional

Description

status

string

optional

Status

zone_id

string

optional

Zone ID

flavor_id

string

optional

Flavor ID

image_id

string

optional

Image ID

count

string

optional

Number of instances created

ssh_key

array[string]

optional

SSH Key ID

user_script_id

null

optional

User script ID

block_storage

array[string]

optional

Block storage info

attach_default_ip

boolean

optional

Whether if default IP is attached

count

integer

required

Example

{
  "code": "0x00",
  "error_code": "SUCCESS",
  "message": "",
  "result": [
    {
      "instance_id": "INSTANCE-2IZyamjZEKllbeUSTZPsl3",
      "name": "iwinv 서버",
      "description": "",
      "status": "building",
      "zone_id": "kr2-z01",
      "flavor_id": "vgna_1_n",
      "image_id": "PIMAGE-1Pos3S8VaJXq3wgC8c4BMi",
      "count": "1/1",
      "ssh_key": [],
      "user_script_id": null,
      "block_storage": [],
      "attach_default_ip": true
    }
  ],
  "count": 1
}