更新时间:2026-08-19 GMT+08:00
分享

创建AI应用

功能介绍

创建具有指定名称、描述、API签名和策略的新AI应用

URI

POST /v1/{project_id}/aiguard/aiapps

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID,用于标识请求所属的项目。

约束限制:

字符串类型,32位UUID。

取值范围:

只能由英文字母、数字组成,长度为1~64个字符。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token,用于验证用户身份,确保请求的合法性。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

约束限制:

字符串类型,长度1~16384个字符。

取值范围:

只能由英文字母、数字及"-"、"_"组成。

默认取值:

不涉及。

表3 请求Body参数

参数

是否必选

参数类型

描述

name

String

参数解释:

AI应用名称,用于标识AI应用,需唯一。

约束限制:

字符串类型,长度1~64个字符,只能由英文字母、数字、中文及"_"、"-"组成。

取值范围:

不涉及。

默认取值:

无。

api_sign

String

参数解释:

API签名,用于验证API请求的合法性。

约束限制:

字符串类型,长度1~128字符。

取值范围:

不涉及。

默认取值:

无。

description

String

参数解释:

应用描述,用于描述AI应用的功能和用途。

约束限制:

字符串类型,长度0~255字符。

取值范围:

不涉及。

默认取值:

无。

policy_id

String

参数解释:

策略ID,用于关联AI应用的策略,确保应用按策略执行。

约束限制:

字符串类型,32位UUID。

取值范围:

只能由英文字母、数字组成,长度为1~64个字符。

默认取值:

无。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

id

String

参数解释:

AI应用ID,用于唯一标识AI应用。

取值范围:

字符串类型,32位UUID。

name

String

参数解释:

AI应用名称,用于标识AI应用,需唯一。

取值范围:

字符串类型,长度1~64字符。

apiSign

String

参数解释:

API签名,用于验证API请求的合法性。

取值范围:

字符串类型,长度1~128字符。

description

String

参数解释:

应用描述,用于描述AI应用的功能和用途。

取值范围:

字符串类型,长度0~255字符。

createTime

Long

参数解释:

创建时间,用于记录AI应用的创建时间。

取值范围:

长整型,纪元毫秒。

请求示例

响应示例

状态码

状态码

描述

200

AI应用创建成功

400

请求无效

401

未授权

403

禁止访问

500

服务器内部错误

错误码

请参见错误码

相关文档