Updated on 2024-09-12 GMT+08:00

Querying Regions Supported for a Cloud Vendor

Function

This API is used to query regions supported for a cloud vendor.

Calling Method

For details, see Calling APIs.

URI

GET /v2/{project_id}/objectstorage/data-center

Table 1 Path parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

The project ID.

Minimum length: 1 character

Maximum length: 1,024 characters

Request

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

The IAM token authentication. Ensure that the project ID contained in the token matches the project ID in the request URI.

Minimum length: 1 character

Maximum length: 16,384 characters

Response

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

[Array element]

Array of ShowRegionInfoResp objects

The queried region information.

Table 4 ShowRegionInfoResp field description

Parameter

Type

Description

service_name

String

The cloud vendor name.

Minimum length: 0 characters

Maximum length: 255 characters

region_list

Array of RegionInfo objects

The region list.

Array length: 0 to 1,024

Table 5 RegionInfo field description

Parameter

Type

Description

cloud_type

String

The cloud service name.

Minimum length: 1 character

Maximum length: 255 characters

value

String

The region name.

Minimum length: 1 character

Maximum length: 255 characters

description

String

The region description.

Minimum length: 0 characters

Maximum length: 1,024 characters

Example Request

None

Example Response

Status code: 200

The region list was returned.

[ {
  "service_name" : "AWS",
  "region_list" : [ {
    "cloud_type" : "AWS",
    "value" : "us-east-1",
    "description" : "US Standard (N. Virginia)"
  }, {
    "cloud_type" : "AWS",
    "value" : "us-west-1",
    "description" : "US West (N. California)"
  }, {
    "cloud_type" : "AWS",
    "value" : "us-west-2",
    "description" : "US West (Oregon)"
  }, {
    "cloud_type" : "AWS",
    "value" : "eu-west-1",
    "description" : "EU (Ireland)"
  }, {
    "cloud_type" : "AWS",
    "value" : "eu-central-1",
    "description" : "EU (Frankfurt)"
  }, {
    "cloud_type" : "AWS",
    "value" : "ap-northeast-1",
    "description" : "Asia Pacific (Tokyo)"
  }, {
    "cloud_type" : "AWS",
    "value" : "ap-northeast-2",
    "description" : "Asia Pacific (Seoul)"
  }, {
    "cloud_type" : "AWS",
    "value" : "ap-southeast-1",
    "description" : "Asia Pacific (Singapore)"
  }, {
    "cloud_type" : "AWS",
    "value" : "ap-southeast-2",
    "description" : "Asia Pacific (Sydney)"
  }, {
    "cloud_type" : "AWS",
    "value" : "ap-south-1",
    "description" : "Asia Pacific (Mumbai)"
  }, {
    "cloud_type" : "AWS",
    "value" : "sa-east-1",
    "description" : "South America (Sao Paulo)"
  }, {
    "cloud_type" : "AWS",
    "value" : "us-east-2",
    "description" : "US East (Ohio)"
  }, {
    "cloud_type" : "AWS",
    "value" : "eu-west-2",
    "description" : "EU (London)"
  }, {
    "cloud_type" : "AWS",
    "value" : "ca-central-1",
    "description" : "Canada (Central)"
  }, {
    "cloud_type" : "AWS",
    "value" : "ap-east-1",
    "description" : "Asia Pacific (Hong Kong)"
  } ]
} ]

Status Codes

Status Code

Description

200

The region list was returned.

Error Codes

For details, see Error Codes.