Block Storage List - iwinv IaaS(Infrastructure as a Service) API

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

Block Storage Name

Filter Images Containing {name}

type

string

optional

Disk Type returned from [Block Storages > Block Storage Types]

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

object {0}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET 'https://api-kr.iwinv.kr/v1/block-storages?zone_id=&name&type=' \
--header 'X-iwinv-Timestamp: {{timestamp}}' \
--header 'X-iwinv-Credential: {{accesskey}}' \
--header 'X-iwinv-Signature: {{signature}}'

Responses

🟢202Accepted

application/json

Body

code

string

required

Status code

error_code

string

required

Error message

message

string

required

Status message

result

array [object {10}]

required

Result

block_storage_id

string

optional

Block storage ID

instance_id

string

optional

Instace ID of instance attached to

name

string

optional

Block storage name

status

string

optional

Block storage status

description

string

optional

Block storage description

oid

string

optional

OID of block storage

type

string

optional

Block storage type

size

integer

optional

Block storage size(Unit: GB)

start_date

string

optional

Block storage start datetime

zone

object

optional

Zone info

count

integer

required

Number of block storages returned

page_no

integer

required

Page number

page_size

integer

required

Page size

Example

{
  "code": "0x00",
  "error_code": "SUCCESS",
  "message": "",
  "result": [
    {
      "block_storage_id": "BLOCK-7Y9Pd3D13qHQrM8WnoFCJu",
      "instance_id": "INSTANCE-2IZyamjZEKllbeUSTZPsl3",
      "name": "iwinv Block Storage",
      "status": "active",
      "description": "",
      "oid": "5419fc3b-5134-4680-84dc-05c31354d155",
      "type": "ssd",
      "size": 50,
      "start_date": "2024-11-20 11:18:43",
      "zone": {
        "zone_id": "kr2-z01",
        "name": "KR2-Z01 API Beta"
      }
    }
  ],
  "count": 1,
  "page_no": 1,
  "page_size": 10
}