Edit Instance Info - iwinv IaaS(Infrastructure as a Service) API

For more information, put in the fields value from https://api-kr.iwinv.kr/fields/v1/instances

Request

Path Params

instance_id

string

required

Instance ID of instance

Query Params

fields

integer

optional

Value From https://api-kr.iwinv.kr/fields/v1/instances

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

name

string

optional

Instance Name

URL encode the string when requesting

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

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

description

string

optional

Instance Description

Max Length: 50

URL encode the string when requesting

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

code

string

required

Status code

error_code

string

required

Error message

message

string

required

Status message

result

array [object {17}]

required

Result

instance_id

string

optional

Instance ID

name

string

required

Instance Name

description

null

required

Description

status

string

required

Status

provide

string

required

Providing type

start_date

string

required

Instance create datetime

stop_date

null

required

Instance delete datetime

default_account

object

required

Default account

array [object {3}]

required

IP info

zone

object

required

Zone info

flavor

object

required

Flavor info

image

object

required

Image info

monitoring

object

required

Monitoring info

block_storage

array[string]

required

Block Storage Details

vnc

object

required

VNC info

connection_limit

object

required

Connection Limit

traffic

object

required

Traffic info

count

integer

required

Number of instances returned

page_no

integer

required

Page number

page_size

integer

required

Page size

Example

{
    "code": "0x00",
    "error_code": "SUCCESS",
    "message": "",
    "result": [
        {
            "instance_id": "INSTANCE-z3oB3PugYnKmmyxKyGzr9",
            "name": "iwinv API test",
            "description": "API example instance",
            "status": "active",
            "provide": "dedicated",
            "start_date": "2024-11-18 17:09:35",
            "stop_date": null,
            "default_account": {
                "username": "root",
                "password": "/EVM=97P"
            },
            "ip": [
                {
                    "public": {
                        "address": "49.247.194.234",
                        "attached": true
                    },
                    "private": {
                        "address": "10.100.1.115",
                        "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-api.iwinv.kr:6080/vnc_auto.html?path=%3Ftoken%3Dfdd2ca8c-2b89-4930-989f-b41e21a21967",
                "type": "novnc"
            },
            "connection_limit": {
                "block_storage": 3,
                "ip": 3
            },
            "traffic": {
                "default": 1000,
                "period": "DAYMONTH",
                "limit": null,
                "reset_allow_count": null
            }
        }
    ],
    "count": 1
}