文档首页/MaaS模型即服务/API参考/查询AI开发平台ModelArts-在线服务/获取推理服务信息
更新时间：2026-03-16 GMT+08:00
查看PDF
分享

获取推理服务信息

功能介绍

该API用于获取AI开发平台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和名称。

约束限制：不涉及。

取值范围：不涉及。

默认取值：不涉及。

region_id

是

String

参数解释：AI开发平台ModelArts-在线服务的Region信息。获取方式请参见获取区域信息。

约束限制：不涉及。

取值范围：不涉及。

默认取值：不涉及。

workspace_id

否

String

参数解释：通过传入workspace_id查询指定工作空间下的资源。不传则默认default空间。获取方式请参见获取工作空间信息。

约束限制：不涉及。

取值范围：不涉及。

默认取值：不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：用户Token。通过调用IAM服务的获取用户Token接口获取（响应消息头中X-Subject-Token的值）。获取方式请参见认证鉴权。

约束限制：不涉及。

取值范围：不涉及。

默认取值：不涉及。

Content-Type

是

String

参数解释：消息体的类型，固定为application/json。

约束限制：不涉及。

取值范围：不涉及。

默认取值：不涉及。

响应参数

表3 响应Body参数

参数

参数类型

描述

data

Array[InferServerInfo]

参数解释：推理服务信息。

取值范围：不涉及。

pages

Integer

参数解释：总页数。

取值范围：不涉及。

total

Integer

参数解释：推理信息总数。

取值范围：不涉及。

表4 InferServerInfo

参数

参数类型

描述

id

String

参数解释：推理服务ID。

取值范围：不涉及。

name

String

参数解释：推理服务名称。

取值范围：不涉及。

status

String

参数解释：推理服务状态。

取值范围：不涉及。

version

String

参数解释：版本。

取值范围：不涉及。

version_count

String

参数解释：版本总数。

取值范围：不涉及。

description

String

参数解释：推理服务描述。

取值范围：不涉及。

type

String

参数解释：推理服务类型。

取值范围：不涉及。

deploy_type

String

参数解释：部署类型。

取值范围：不涉及。

user_name

String

参数解释：用户名称。

取值范围：不涉及。

workspace_id

String

参数解释：工作空间。

取值范围：不涉及。

create_at

String

参数解释：创建时间。

取值范围：不涉及。

update_at

String

参数解释：更新时间。

取值范围：不涉及。

auth_type

String

参数解释：认证方式。

取值范围：不涉及。

表5 错误响应参数

参数

参数类型

描述

error_msg

String

参数解释：错误描述信息。

取值范围：不涉及。

error_code

String

参数解释：错误码，标识错误类型。

取值范围：不涉及。

请求示例

GET
/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"
}

状态码

请参见状态码。

错误码

请参见错误码。

相关文档