Description
You can call this operation to add region information for a host.
Call description
Prerequisite
You have the HOST_MANAGER permissions.
Request path
POST /api/v2/compute/regions
Request parameters
| Parameter | Type | Required | Example value | Description |
|---|---|---|---|---|
| name | String | Yes | Beijing | The name of the region. |
| description | String | No | The Beijing region. | The description of the region. |
Response parameters
| Parameter | Type | Description |
|---|---|---|
| data | Object | The requested region data. |
| successful | Boolean | Indicates whether the request was successful. |
| timestamp | Datetime | The timestamp when the server completed the request. |
| duration | Integer | The time taken by the server to process the request, in milliseconds. |
| status | Integer | An HTTP status code. |
| traceId | String | The trace ID of the request. This trace ID is used for troubleshooting. |
| server | String | The address of the application server that responded to the request. |
Data structure of the region information
| Parameter | Type | Description |
|---|---|---|
| id | Integer | The ID of the region. |
| name | String | The name of the region. |
| description | String | The description of the region. |
| createTime | String | The time when the region information was created. |
| updateTime | String | The time when the region information was modified. |
Examples
Sample request
POST /api/v2/compute/regions
curl --user <username>:<password> -X POST 'http://<IP>:<PORT>/api/v2/compute/regions' \
-H 'Content-Type: application/json' \
--data-raw '{"name":"shanghai","description":"The Shanghai region."}'
Sample response
{
"data": {
"createTime": null,
"id": 3000003,
"name": "shanghai",
"updateTime": null
},
"duration": 41,
"server": "a83ad33525",
"status": 200,
"successful": true,
"timestamp": "2021-08-25T16:00:19.895+08:00",
"traceId": "c8e610e3b33a4b17"
}