文档首页/ AI开发平台ModelArts/ API参考/ 开发环境管理/ 查询当前用户指定特性的开关及配额
更新时间:2025-11-19 GMT+08:00

查询当前用户指定特性的开关及配额

功能介绍

查询当前用户指定特性的开关及配额接口用于获取指定特性在当前用户下的开关状态及配额信息。该接口适用于以下场景:当用户需要了解特定特性是否已开启、查看配额限制或监控已使用的资源情况时,可通过此接口查询相关信息。使用该接口的前提条件是用户已登录且具有查询权限,同时指定的特性必须存在。调用该接口后,系统将返回该特性是否已开启、配额总量及已使用的资源情况等详细信息。若用户无权限查询、特性不存在或系统出现异常,接口将返回相应的错误信息。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

GET /v1/{project_id}/authoring/features/{feature}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:用户项目ID。获取方法请参见获取项目ID和名称

约束限制:1 - 64字符,字母、数字和中划线。

取值范围:不涉及。

默认取值:不涉及。

feature

String

参数解释:特性名称。

约束限制:不涉及。

取值范围:枚举类型,取值如下:

  • NOTEBOOK:用户显式创建的Notebook实例。

默认取值:NOTEBOOK。

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

create_at

Long

参数解释:实例创建的时间,UTC毫秒。

取值范围:不涉及。

enabled

Boolean

参数解释:特性开关。

取值范围:布尔类型:

  • true:开启。

  • false:未开启。

id

String

参数解释:特性ID。

取值范围:不涉及。

name

String

参数解释:特性名称。

取值范围:枚举类型,取值如下:

  • NOTEBOOK:用户显式创建的Notebook实例。

quota

Integer

参数解释:特性配额。

取值范围:不涉及。

used

Integer

参数解释:特性已使用额度。

取值范围:不涉及。

update_at

Long

参数解释:实例最后更新的时间,UTC毫秒。

取值范围:不涉及。

user_id

String

参数解释:用户ID。

取值范围:不涉及。

状态码:401

表3 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:ModelArts错误码。

取值范围:不涉及。

error_msg

String

参数解释:具体错误信息。

取值范围:不涉及。

状态码:403

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:ModelArts错误码。

取值范围:不涉及。

error_msg

String

参数解释:具体错误信息。

取值范围:不涉及。

状态码:404

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:ModelArts错误码。

取值范围:不涉及。

error_msg

String

参数解释:具体错误信息。

取值范围:不涉及。

请求示例

响应示例

状态码:200

OK。

{
  "create_at" : 1597119549430,
  "enabled" : true,
  "id" : "432hkjk3424kh432nb432km543m423m32",
  "name" : "NOTEBOOK",
  "quota" : 1000,
  "update_at" : 1735818559236,
  "used" : 300,
  "user_id" : "43278947598432457983257243532"
}

状态码

状态码

描述

200

OK。

401

Unauthorized。

403

Forbidden。

404

Not Found。

错误码

请参见错误码