Query details about a region

2023-08-22 02:51:01  Updated

Description

You can call this operation to query details about a region based on its ID.

Call description

Prerequisite

You have the HOST_VIEWER permissions.

Request path

GET /api/v2/compute/regions/{regionId}

Request parameters

Parameter Type Required Example value Description
regionId Integer Yes 100 The ID 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

GET /api/v2/compute/regions/100

Sample response

{
  "data": {
    "createTime": "2021-07-22T20:04:15+08:00",
    "id": 1000002,
    "name": "testregion",
    "updateTime": "2021-07-22T20:04:15+08:00"
  },
  "duration": 29,
  "server": "xxx.xxx.xxx.xxx",
  "status": 200,
  "successful": true,
  "timestamp": "2021-08-25T15:54:02.484+08:00",
  "traceId": "0aa496e9309747b2"
}

Contact Us