- Introduction
- API Request
- API Response
- Zones
- Flavors
- Images
- Instances
- Block Storages
- Bill
- Authentication
- Usage Example
- Firewall
Instance Detail
GET
https://api-kr.iwinv.kr/v1/instances/{instance_id}
For more information, put in the fields
value from https://api-kr.iwinv.kr/fields/v1/instances
Request
Path Params
instance_id
string
required
Query Params
fields
integer
optional
Header Params
X-iwinv-Timestamp
integer
required
Example:
{{timestamp}}
X-iwinv-Credential
string
required
Example:
{{accesskey}}
X-iwinv-Signature
string
required
Example:
{{signature}}
Body Params application/x-www-form-urlencoded
object {0}
Request samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api-kr.iwinv.kr/v1/instances/?fields=' \
--header 'X-iwinv-Timestamp: {{timestamp}}' \
--header 'X-iwinv-Credential: {{accesskey}}' \
--header 'X-iwinv-Signature: {{signature}}'
Responses
🟢200Success
application/json
Body
code
string
required
error_code
string
required
message
string
required
result
array [object {17}]
required
instance_id
string
optional
name
string
required
description
null
required
status
string
required
provide
string
required
start_date
string
required
stop_date
null
required
default_account
object
required
ip
array [object {3}]
required
zone
object
required
flavor
object
required
image
object
required
monitoring
object
required
block_storage
array[string]
required
vnc
object
required
connection_limit
object
required
traffic
object
required
count
integer
required
page_no
integer
required
page_size
integer
required
Example
{
"code": "0x00",
"error_code": "SUCCESS",
"message": "",
"result": [
{
"instance_id": "INSTANCE-z3oB3PugYnKmmyxKyGzr9",
"name": "API test",
"description": null,
"status": "active",
"provide": "dedicated",
"start_date": "2024-11-18 17:09:35",
"stop_date": null,
"default_account": {
"username": "root",
"password": "********"
},
"ip": [
{
"public": {
"address": "49.247.***.***",
"attached": true
},
"private": {
"address": "10.100.***.***",
"netmask": "255.255.0.0",
"network": "10.100.0.0",
"broadcast": "10.100.255.255",
"gateway": "10.100.0.1"
},
"type": "default"
}
],
"zone": {
"zone_id": "kr2-z01",
"name": "KR2-Z01 API Beta"
},
"flavor": {
"flavor_id": "soi_2.8_s",
"name": "soi_2.8_s",
"type": "STORAGE",
"vcpu": 2,
"memory": 8192,
"disk": 200,
"network": 10,
"gpu": null
},
"image": {
"image_id": "PIMAGE-1Pos3S8VaJXq3wgC8c4BMi",
"visibility": "public",
"os": {
"type": "OS",
"name": "Rocky Linux release 9.0 (Blue Onyx)",
"status": "available",
"content": [
"[NEW]*EOL 2032 05.31",
"Kernel : 5.14.0-362.18.1.el9_3.x86_64Used Disk Size : 1.9 G IPTABLE 미적용[ 상세 정보 확인 ]",
"[ 주의 사항 ]iproute, dhclient, initscripts 패키지 삭제 금지"
],
"os_type": "ROCKYLINUX",
"version": "9.X",
"oid": "0e46f055-b19b-4ae2-bcdb-ca34f79058f4"
},
"image_type": "os_linux",
"zone": [
"kr2-z01"
]
},
"monitoring": {
"port": "OFF",
"resource": "OFF"
},
"block_storage": [],
"vnc": {
"link": "https://*****.iwinv.kr:****/vnc_auto.html?path=********************",
"type": "novnc"
},
"connection_limit": {
"block_storage": 3,
"ip": 3
},
"traffic": {
"default": 1000,
"period": "DAYMONTH",
"limit": null,
"reset_allow_count": null
}
}
],
"count": 1
}