iwinv IaaS(Infrastructure as a Service) API
HomeMain PageConsoleDocsError CodeFieldsAPI TEST
HomeMain PageConsoleDocsError CodeFieldsAPI TEST
  1. Images
  • Introduction
  • API Request
  • API Response
  • Zones
    • Zone List
      GET
  • Flavors
    • Flavor List
      GET
    • Flavor Detail
      GET
  • Images
    • Image List
      GET
    • Image Detail
      GET
  • Instances
    • Instance List
      GET
    • Instance Detail
      GET
    • Create Instance
      POST
    • Edit Instance Info
      PUT
    • Delete Instance
      DELETE
    • Start(ON) Instance
      POST
    • Shutdown(OFF) Instance
      POST
    • Reboot Instance
      POST
    • Rebuild(Image) Instance
      POST
    • Resize(Flavor) Instance
      POST
    • Remote Console
      GET
    • User Script List
      GET
  • Block Storages
    • Block Storage Types
      GET
    • Block Storage List
      GET
    • Block Storage Detail
      GET
    • Create Block Storage
      POST
    • Delete Block Storage
      DELETE
    • Attach Block Storage
      POST
    • Detach Block Storage
      POST
  • Bill
    • Live Bill
    • Billing and Payment List
    • Billing and Payment Detail
  • Authentication
    • SSH Key List
  • Usage Example
    • Zone List
  • Firewall
    • Firewall List
    • Firewall Detail
    • Create Firewall
    • Edit Firewall
    • Delete Firewall
    • Attach Firewall
    • Detach Firewall
  1. Images

Image List

GET
https://api-kr.iwinv.kr/v1/images
*response can vary between public and private images

Request

Query Params
zone_id
string 
optional
zone_code from [Zone > Zone List]
To request more than 1, separate with a comma
name
string 
optional
Image Name
Filter Images Containing {name}
os
enum<string> 
optional
To request more than 1, separate with a comma
Allowed values:
windowswindows_corewindows_sqlubunturockycentfedorafreebsdopensusecoreosoracledebianalmaminthamonikr
type
enum<string> 
optional
Image Type
To request more than 1, separate with a comma
Allowed values:
osvdigpusolution
visibility
enum<string> 
optional
Only enter public or private
Allowed values:
publicprivate
page_no
string 
optional
Page Number
Default:
1
page_size
string 
optional
Page Size
Default:
10
Header Params
X-iwinv-Timestamp
integer 
required
Refer to [API Request]
Example:
{{timestamp}}
X-iwinv-Credential
string 
required
Refer to [API Request]
Example:
{{accesskey}}
X-iwinv-Signature
string 
required
Refer to [API Request]
Example:
{{signature}}
Body Params multipart/form-data
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/images?zone_id=&name&os=&type&visibility&page_no=&page_size=' \
--header 'X-iwinv-Timestamp: {{timestamp}}' \
--header 'X-iwinv-Credential: {{accesskey}}' \
--header 'X-iwinv-Signature: {{signature}}'

Responses

🟢200OK
application/json
Body
code
string 
required
Status code
error_code
string 
required
Error message
message
string 
required
Status message
result
array [object {5}] 
required
Result
image_id
string 
required
Image ID
visibility
string 
required
Image Visibility(public, private)
os
object 
required
Operating System
image_type
string 
required
Image type(it matches with [flavors])
zone
array[string]
required
Available Zones
count
integer 
required
Number of images returned
page_no
integer 
required
Page number
page_size
integer 
required
Page size
Example
{
  "code": "0x00",
  "error_code": "SUCCESS",
  "message": "",
  "result": [
    {
      "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"
      ]
    },
    {
      "image_id": "PIMAGE-14G0aJcbpfC2AdbUsnG8Do",
      "visibility": "public",
      "os": {
        "type": "OS",
        "name": "Rocky Linux release 8.X (Green Obsidian)",
        "status": "available",
        "content": [
          "[NEW]*EOL 2029 05.31",
          "Kernel : 4.18.0-513.11.1.el8_9.x86_64Used Disk Size : 2.9 GIPTABLE 미적용[ 상세 정보 확인 ]",
          "[ 주의 사항 ]iproute, dhclient, initscripts 패키지 삭제 금지"
        ],
        "os_type": "ROCKYLINUX",
        "version": "8.8",
        "oid": "6890c7a5-a5a8-4af9-824c-17fb7bea9a70"
      },
      "image_type": "os_linux",
      "zone": [
        "kr2-z01"
      ]
    },
    {
      "image_id": "PIMAGE-1tQFoTuKeENlSZ7xFXyVix",
      "visibility": "public",
      "os": {
        "type": "OS",
        "name": "Ubuntu 24.04 LTS",
        "status": "available",
        "content": [
          "[NEW]*EOL 2029 04",
          "Kernel : 6.8.0-31-genericUsed Disk Size : 1.4G[ 상세 정보 확인 ]",
          "[ 주의 사항 ]iproute2, isc-dhcp, initscripts,systemd-resolve 패키지 삭제 금지"
        ],
        "os_type": "UBUNTU",
        "version": "Ubuntu 24.04 LTS",
        "oid": "2f71f863-edac-457f-b9ad-7e988f01fe81"
      },
      "image_type": "os_linux",
      "zone": [
        "kr2-z01"
      ]
    },
    {
      "image_id": "PIMAGE-16OMEFf3FMbFWIHcJ23q8s",
      "visibility": "public",
      "os": {
        "type": "OS",
        "name": "Ubuntu 22.04 LTS",
        "status": "available",
        "content": [
          "*EOL 2027 04",
          "Kernel :5.15.0-94-genericUsed Disk Size : 2.3G[ 상세 정보 확인 ]",
          "[ 주의 사항 ]iproute2, isc-dhcp, initscripts,systemd-resolve 패키지 삭제 금지"
        ],
        "os_type": "UBUNTU",
        "version": "Ubuntu 22.04 LTS",
        "oid": "7d0fa6d3-7506-45ad-8178-59b99c0cac11"
      },
      "image_type": "os_linux",
      "zone": [
        "kr2-z01"
      ]
    }
  ],
  "count": 4,
  "page_no": 1,
  "page_size": 10
}
Previous
Flavor Detail
Next
Image Detail
Built with