# 获取推理服务信息
#### 功能介绍
该API用于获取模型训推平台 ModelArts-在线服务的推理服务信息。当创建自定义接入点的"source"参数选择"custom_from_modelarts_v2"时，获取推理服务信息。
#### 接口约束
该功能仅支持"西南-贵阳一"区域。
#### URI
```
GET  /v1/{project_id}/maas/services/custom-endpoint/services/{region_id}?workspace_id={workspace_id}
```
表1路径参数 
| 参数           | 是否必选 | 参数类型      | 描述                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释：** 项目ID，获取方式请参见[获取项目ID和名称](https://support.huaweicloud.com/api-maas/api-maas-0028.html)。 **约束限制：**不涉及。 **取值范围：**不涉及。 **默认取值：**不涉及。 |
| region_id   | 是  | String   | **参数解释：** ModelArts-在线服务的Region信息。获取方式请参见[获取区域信息](https://support.huaweicloud.com/api-maas/api-maas-0019.html)。 **约束限制：**不涉及。 **取值范围：**不涉及。 **默认取值：**不涉及。                                                                                                        |
| workspace_id  | 否    | String    | **参数解释：** 通过传入workspace_id查询指定工作空间下的资源。不传则默认default空间。获取方式请参见[获取工作空间信息](https://support.huaweicloud.com/api-maas/api-maas-0020.html)。 **约束限制：**不涉及。 **取值范围：**不涉及。 **默认取值：**不涉及。                                                                                   |
   
#### 请求参数
表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参数 
| 参数     | 参数类型                      | 描述                                                                             |
|:---|:---|:---|
| data  | Array\[InferServerInfo\] | **参数解释：**推理服务信息。 **取值范围**：不涉及。  |
| pages | Integer                    | **参数解释：**总页数。 **取值范围**：不涉及。   |
| total | Integer                     | **参数解释：**推理信息总数。 **取值范围**：不涉及。 |
   
表4InferServerInfo 
| 参数            | 参数类型    | 描述                                                                                                    |
|:---|:---|:---|
| id            | String   | **参数解释：**推理服务ID。 **取值范围**：不涉及。                        |
| name        | String | **参数解释：**推理服务名称。 **取值范围**：不涉及。                       |
| status       | String  | **参数解释：**推理服务状态。 **取值范围**：不涉及。                           |
| version        | String  | **参数解释：**版本。 **取值范围**：不涉及。                          |
| version_count  | Integer | **参数解释：**版本总数。 **取值范围**：不涉及。                           |
| description    | String  | **参数解释：**推理服务描述。 **取值范围**：不涉及。                         |
| type         | String    | **参数解释：**推理服务类型。 **取值范围**：不涉及。                        |
| deploy_type    | String | **参数解释：**部署类型。 **取值范围**：不涉及。                       |
| user_name     | String  | **参数解释：**用户名称。 **取值范围**：不涉及。                        |
| workspace_id | String  | **参数解释：**工作空间。 **取值范围**：不涉及。                          |
| create_at      | Long     | **参数解释：**创建时间，时间戳格式，示例：1760538261106。 **取值范围**：不涉及。 |
| update_at      | Long    | **参数解释：**更新时间，时间戳格式，示例：1760538261106。 **取值范围**：不涉及。    |
| auth_type       | String   | **参数解释：**认证方式。 **取值范围**：不涉及。                         |
   
表5错误响应参数 
| 参数         | 参数类型     | 描述                                                                               |
|:---|:---|:---|
| error_msg | String | **参数解释：**错误描述信息。 **取值范围**：不涉及。    |
| error_code | String | **参数解释：**错误码，标识错误类型。 **取值范围**：不涉及。 |
   
#### 请求示例
```
GET
https://{endpoint}/v1/{project_id}/maas/services/custom-endpoint/services/{region_id}?workspace_id={workspace_id}
```
#### 响应示例
- 成功响应，状态码：200
  ```
  {
      "data": [
          {
              "id": "add6b9f8-7e97-4f1c-8816-************",
              "name": "dpsk-v3_2-*****",
              "status": "RUNNING",
              "version": "0.0.9",
              "version_count": 10,
              "description": "DeepSeek-V3.2-EXP",
              "type": "REAL_TIME",
              "deploy_type": "MULTI",
              "user_name": "*****",
              "workspace_id": "0",
              "create_at": 1760538261106,
              "update_at": 1765711080510,
              "auth_type": "NONE"
          }
      ],
      "pages": 1,
      "total": 1
  }
  ```
  
- 错误响应，状态码：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)。