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
}
Modified at 2024-11-18 22:53:52
Previous
Flavor Detail
Next
Image Detail
Built with