getZoneList

Prev Next

Overview

When creating a server instance (VM) on NAVER Cloud Platform, you can create it in a specific zone of a Region. This API queries the zone information.

Request

Request parameters

Parameter name Required Type Restrictions Description
regionNo No String - Region number
If you query by getting a Region number, filtering is only available with that Region.
You can obtain the Region number through the getRegionList action.
e.g., regionNo=1
responseFormatType No String - Response result's format type
Options: xml | json
Default: xml

Response

Response body

Examples

Request example

GET {SERVER_API_URL}/getZoneList
?regionNo=1

Response example

<getZoneListResponse>
  <requestId>8a1c667a-ce02-4cb8-98c4-506716a8cfba</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <zoneList>
    <zone>
      <zoneNo>3</zoneNo>
      <zoneName>KR-2</zoneName>
      <zoneCode>KR-2</zoneCode>
      <zoneDescription>Pyeongchon zone</zoneDescription>
      <regionNo>1</regionNo>
    </zone>
    <zone>
      <zoneNo>2</zoneNo>
      <zoneName>KR-1</zoneName>
      <zoneCode>KR-1</zoneCode>
      <zoneDescription>Gasan zone</zoneDescription>
      <regionNo>1</regionNo>
    </zone>
  </zoneList>
</getZoneListResponse>

Errors

Errors that may occur while using this action are listed below. For more information about common errors, see NAVER Cloud Platform API.

HTTP Response Code Return code Return message
400 23005 There is no zone available for use.