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

更新AI应用

功能介绍

更新AI应用的名称和/或描述

URI

PUT /v1/{project_id}/aiguard/aiapps/{app_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

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

约束限制:

字符串类型,32位UUID。

取值范围:

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

默认取值:

不涉及。

app_id

String

参数解释:

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

约束限制:

字符串类型,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-255字符。

取值范围:

不涉及。

默认取值:

无。

description

String

参数解释:

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

约束限制:

字符串类型,长度1-255字符。

取值范围:

不涉及。

默认取值:

无。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

appId

String

参数解释:

AI应用ID,用于标识更新后的AI应用。

取值范围:

字符串类型,32位UUID。

name

String

参数解释:

AI应用名称,用于标识更新后的AI应用名称。

取值范围:

字符串类型,长度1-255字符。

description

String

参数解释:

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

取值范围:

字符串类型,长度1-1024字符。

updateTime

Long

参数解释:

更新时间,表示AI应用最后更新的时间。

取值范围:

长整型,纪元毫秒。

请求示例

响应示例

状态码

状态码

描述

200

AI应用更新成功

400

请求无效

401

未授权

403

禁止访问

404

AI应用不存在

500

服务器内部错误

错误码

请参见错误码

相关文档