# 获取区域信息
#### 功能介绍
该API用于获取模型训推平台 ModelArts-在线服务的区域信息。当创建自定义接入点的"source"参数选择"custom_from_modelarts_v2"时，获取请求中的region参数。
#### 接口约束
该功能仅支持"西南-贵阳一"区域。
#### URI
GET /v1/{project_id}/maas/services/custom-endpoint/regions
表1路径参数 
| 参数        | 是否必选 | 参数类型  | 描述                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| project_id | 是     | String | **参数解释** ：项目ID。关于如何获取项目ID，请参见[获取项目ID和名称](https://support.huaweicloud.com/api-maas/api-maas-0028.html)。 **约束限制**：不涉及。 **取值范围**：只能由小写英文字母和数字组成，长度为32。 **默认取值**：不涉及。 |
   
#### 请求参数
表2请求Header参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|:---|
| X-Auth-Token  | 是    | String | **参数解释：** 用户Token。通过调用IAM服务的获取用户Token接口获取（响应消息头中X-Subject-Token的值）。获取方式请参见[认证鉴权](https://support.huaweicloud.com/api-maas/api-maas-0005.html)。 **约束限制**：不涉及。 **取值范围**：不涉及。 **默认取值**：不涉及。 |
| Content-Type | 是  | String  | **参数解释：**消息体的类型，固定为application/json。 **约束限制**：不涉及。 **取值范围**：application/json。 **默认取值**：不涉及。                                                                                             |
   
#### 响应参数
表3响应Body参数 
| 参数          | 参数类型               | 描述                                                                                            |
|:---|:---|:---|
| region_items | Array\[RegionInfo\] | **参数解释：**ModelArts-在线服务所有的Region信息。 **取值范围**：不涉及。 |
   
表4RegionInfo 
| 参数       | 参数类型       | 描述                                                                                                                         |
|:---|:---|:---|
| region_id | String    | **参数解释：**ModelArts-在线服务的Region。 **取值范围：**不涉及。 |
| locales  | LocalInfo | **参数解释：**接入点中英文名称。                                                                                                          |
   
表5LocalInfo 
| 参数      | 参数类型  | 描述                                                                            |
|:---|:---|:---|
| en_us | String | **参数解释：**英文名称。 **取值范围：**不涉及。 |
| zh_cn    | String | **参数解释：**中文名称。 **取值范围：**不涉及。  |
   
表6错误响应参数 
| 参数           | 参数类型    | 描述                                                                             |
|:---|:---|:---|
| error_msg  | String | **参数解释：**错误描述信息。 **取值范围：**不涉及。   |
| error_code | String | **参数解释：**错误码，标识错误类型。 **取值范围：**不涉及。 |
   
#### 请求示例
```
GET
https://{endpoint}/v1/{project_id}/maas/services/custom-endpoint/regions
```
#### 响应示例
- 成功响应，状态码：200。
  ```
  {
      "region_items": [
          {
              "region_id": "cn-southwest-2",
              "locales": {
                  "en_us": "cn-southwest-2",
                  "zh_cn": "贵阳一"
              }
          },
          {
              "region_id": "cn-north-12",
              "locales": {
                  "en_us": "cn-north-12",
                  "zh_cn": "华北三"
              }
          },
          {
              "region_id": "cn-east-4",
              "locales": {
                  "en_us": "cn-east-4",
                  "zh_cn": "华东二"
              }
          },
          {
              "region_id": "cn-north-9",
              "locales": {
                  "en_us": "cn-north-9",
                  "zh_cn": "乌兰察布一"
              }
          }
      ]
  }
  ```
  
- 错误响应，状态码：400。
  ```
  {
  "error_msg": "Invalid token.",
  "error_code": "ModelArts.0104"
  }
  ```
  
 
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-maas/api-maas-0027.html)。
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-maas/ErrorCode.html)。