Listing Regions
Function
This API is used to list regions supported by Huawei Cloud.
The API can be called using either a global endpoint or a region-specific endpoint. For IAM endpoints, see Regions and Endpoints.
Debugging
You can debug this API in API Explorer.
URI
GET /v3/regions
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
Content-Type |
Yes |
String |
Set this parameter to application/json;charset=utf8. |
X-Auth-Token |
Yes |
String |
IAM user token (no special permission requirements). If the token does not contain private region information, no private regions will be returned. |
Response Parameters
Parameter |
Type |
Description |
---|---|---|
Object |
Resource link information. |
|
Array of objects |
Region information. |
Parameter |
Type |
Description |
---|---|---|
self |
String |
Resource link. |
previous |
String |
Previous resource link. If the previous resource link is unavailable, this parameter is set to null. |
next |
String |
Next resource link. If the next resource link is unavailable, this parameter is set to null. |
Parameter |
Type |
Description |
---|---|---|
description |
String |
Description of the region. |
parent_region_id |
String |
Null. |
Object |
Region resource link. |
|
Object |
Region name. Not all fields in the object are returned, which is determined by the registered region. |
|
id |
String |
Region ID. |
type |
String |
Region type. |
Example Request
Request for querying a region list
GET https://iam.myhuaweicloud.com/v3/regions
Example Response
Status code: 200
The request is successful.
{ "regions": [ { "parent_region_id": null, "description": "", "links": { "self": "https://iam.myhuaweicloud.com/v3/regions/ap-southeast-1" }, "type": "public", "id": "ap-southeast-1", "locales": { "zh-cn": "Region name in Chinese", "en-us": "ap-southeast-1" } }, { "parent_region_id": null, "description": "", "links": { "self": "https://iam.myhuaweicloud.com/v3/regions/la-south-2" }, "type": "public", "id": "la-south-2", "locales": { "pt-br": "AL-Santiago", "zh-cn": "Region name in Chinese", "en-us": "LA-Santiago", "es-us": "AL-Santiago de Chile1", "es-es": "LA-Santiago" } } ], "links": { "self": "https://iam.myhuaweicloud.com/v3/regions", "previous": null, "next": null } }
Status Codes
Status Code |
Description |
---|---|
200 |
The request is successful. |
400 |
Invalid parameters. |
401 |
Authentication failed. |
403 |
Access denied. |
404 |
The requested resource cannot be found. |
405 |
The method specified in the request is not allowed for the requested resource. |
413 |
The request entity is too large. |
500 |
Internal server error. |
503 |
Service unavailable. |
Error Codes
None
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot