参数名称 参数描述 类型 是否必须 Tag 参数解释： 单个标签。 Container 是

功能说明 AbortMultipartUpload用来实现舍弃一个分块上传并删除已上传的块。当您调用该请求时，如果有正在使用这个uploadId上传块的请求，则该上传会返回失败。 请求消息样式 plaintext DELETE /{Bucket}/{key}?uploadId2~DixxGkXNw6F79q2AcwMQH41XMMkUr HTTP/1.1 Host: xxx.zos.ctyun.cn xamzcontentsha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b85 xamzdate: 20220406T063538Z Authorization: AWS4HMACSHA256 Credentialbase/20220406/useast1/s3/aws4request, SignedHeadershost;xamzacl;xamzcontentsha256;xamzdate;xamzstorageclass;xamztagging, Signature4f31f3b56e248aa32b165005714448c3fe30b38a76e1c3cdeac11bf5d8314963 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： Bucket的名称。 String 是 Key 参数解释： 上传对象在集群中保存的对象名称。 String 是 uploadId 参数解释： 分段上传的ID。 String 是 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: tx00000000000000000004b00624d5da35403fdefault Date: Wed, 06 Apr 2022 09:30:11 GMT Connection: KeepAlive

请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code ContentLength: length xamzrequestid: tx0000000000000000000060062553c171e4cbdefault Date: Tue, 12 Apr 2022 08:45:11 GMT Connection: KeepAlive xamzversionid: VersionId string timestamp 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 参数名称 描述 类型 CopyObjectResult 参数解释： 复制结果信息的容器。 Container 表CopyObjectResult 参数名称 描述 类型 ETag 参数解释： 目的对象的ETag。 String LastModified 参数解释： 源对象的修改时间。 Date 错误码 请参见调用前必知错误码全局错误码。

功能说明 CreateBucket请求可以在指定账号下创建一个新的Bucket。 注意事项 存储桶一旦创建成功，名称和所处地域不能修改。 用户在每个资源池的默认配额为100个桶，用户可通过工单申请扩大配额，最大配额1000个桶。 华东1（2024年11月12日）、长沙42（2024年11月5日）、上海7（2024年11月12日）、内蒙6（2025年1月10日）、成都4（2024年11月12日）、杭州7（2024年12月3日）已于括号内的时间完成升级。在资源池升级之后新创建的桶不再有对象数量上限，您可以放心使用。在升级之前已创建的桶，对象数量上限为4亿。除上述已完成升级的地域外，其余地域暂未升级，单桶的对象数量上限仍为4亿。当桶的对象数量达到该上限后，涉及新增对象的操作有被限制的风险。 请求消息样式 plaintext PUT /{Bucket} HTTP/1.1 Host: xxx.zos.ctyun.cn xamzcontentsha256: String ContentLength: 0 xamzacl: private xamzbucketobjectlockenabled: False xamzstorageclass: STANDARD xamzdate: 20220401T084340Z xazpolicy: MULTIAZ Authorization: authorization string 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 约束限制： 命名规则如下： 不能与已有的任何桶名称重复。 创建成功后不支持修改。 长度范围为3到63个字符，支持小写字母、数字、中划线（）。 禁止以中划线（）开头或结尾。 String 是

参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是

错误码 请参见调用前必知错误码全局错误码。

请求消息体（可选） 请求消息体用于携带除消息头以外的额外数据，其格式通常与 ContentType 头部字段相匹配，如 JSON 或 XML。当包含中文参数时，需确保使用 UTF8 编码。是否需要消息体及其具体内容，取决于所调用的接口类型；例如，GET 和 DELETE 请求通常不包含消息体，而其他接口则可能需要根据其功能传入相应的数据结构。

参数名称 参数描述 类型 是否必须 Body 参数解释： 上传的对象数据。 Binary 否

参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是

响应消息元素 该请求的响应中不带有响应元素。 错误码 请参见调用前必知错误码全局错误码。

名称 描述 类型 Body 参数解释： 返回处理后的图片，action为缩放、裁剪等具体操作时，Body返回修改后的图片数据，action为info等获取图片信息时，Body返回json数据。 StreamingBody

删除对象 删除桶内某一个对象。 请求示例： plaintext DELETE /bucketexample/obj0703 HTTP/1.1 AcceptEncoding: identity UserAgent: pythonurllib3/2.0.7 Host: 169.254.248.1:17480 ContentType: application/json ContentLength: 0 date: Thu, 03 Jul 2025 09:22:11 GMT Authorization: AWS user1ak:yBsz56JHCtsc050cdyhhrGzMFDI 响应示例： plaintext HTTP/1.1 204 No Content xamzrequestid: tx00000000000000000001a0068664bc354e6d1default Date: Thu, 03 Jul 2025 09:22:11 GMT Connection: KeepAlive

参数 参数类型 必选 说明 匹配方式 示例 bucket String 否 存储桶名称。 bucket {"bucket": "examplebucket"} key String 否 上传对象的名称。 eq、startswith ["eq", "$key", "ExampleObject"] contentlengthrange String 否 上传对象时的最小以及最大允许的大小，单位是字节。 contentlengthrange ["contentlengthrange", 1, 10] successactionstatus String 否 上传成功后的返回状态码。 eq、startswith ["eq", "$successactionstatus", "201"] contenttype String 否 限制对象的文件类型。 eq、startswith ["eq", "$contenttype", "image/jpg"] cachecontrol String 否 缓存控制。 eq、startswith ["eq", "$cachecontrol", "nocache"]

参数 参数类型 说明 xamzalgorithm String 指定签名的版本和算法，固定值为AWS4HMACSHA256。 xamzcredential String 指明派生密钥的参数集。格式： <AccessKeyId>/<date>/<region>/s3/aws4request 。 xamzdate String 请求的时间（遵循ISO 8601日期和时间标准）。格式：20241216T020211Z。 xamzsignature String 签名认证信息。其值为通过HMACSHA256算法对Base64编码后的policy字符串进行加密计算，然后所得的二进制哈希值转换成十六进制的形式

参数名称 参数描述 类型 是否必须 Bucket 参数解释： Bucket的名称。 String 是 Key 参数解释： 对象名称。 String 是 versionId 参数解释： 对象的版本ID。 String 否

固定地址 1. 打开AI网关控制台实例页面，在顶部菜单栏选择目标实例所在地域，并单击目标实例ID。 2. 在左侧导航栏，单击服务，然后单击创建服务。 3. 配置基本信息。 ● 在弹窗中先选择服务来源为“固定地址”，随后编辑其余配置。 ● 服务名称： 自定义服务名称。 ● 服务地址：单击添加， 输入后端节点主机地址和端口，支持同时添加多个服务地址。存在多个服务地址时，优先路由到优先级高的服务地址，若优先级相同，则按照权重按比例路由到服务地址。 ● 请求协议：转发至后端服务的请求协议，支持HTTP、HTTPS、GRPC、GRPCS和DUBBO。 4. 配置完成后单击确定，完成服务创建。 函数计算 1. 打开AI网关控制台实例页面，在顶部菜单栏选择目标实例所在地域，并单击目标实例ID。 2. 在左侧导航栏，单击服务，然后单击创建服务。 3. 配置基本信息。 在弹窗中先选择服务来源为“函数计算”，随后编辑其余配置。 ● 函数：从函数列表中选择函数。 ● 版本/别名：选择函数的版本或别名。 ● 请求协议：函数的请求协议，支持HTTP。 4. 配置完成后单击确定，完成服务创建。 DNS域名 1. 打开AI网关控制台实例页面，在顶部菜单栏选择目标实例所在地域，并单击目标实例ID。 2. 在左侧导航栏，单击服务，然后单击创建服务。 3. 配置基本信息。 ● 在弹窗中先选择服务来源为“DNS域名”，随后编辑其余配置。 ● 服务名称： 自定义服务名称。 ● 域名： 后端服务的域名地址。 注意：如果指定的是外网地址，需要配置NAT网关。 ● 端口： 后端服务的端口。 ● 请求协议： 后端服务的请求协议，支持HTTP、HTTPS、GRPC、GRPCS和DUBBO。

本章节介绍如何管理服务。 概述 完成服务创建后，可以在服务管理页面查看已创建的服务列表，同时也可以对服务进行查看、编辑和删除等操作。 查看服务 服务完成创建后，可以在服务管理页面查看服务。 1. 打开AI网关控制台实例页面，在顶部菜单栏选择目标实例所在地域，并单击目标实例ID。 2. 在左侧导航栏，单击服务。 3. 查看服务时，支持通过服务来源和服务名称筛选服务。 4. 单击服务名称，可跳转至服务概览页面查看服务的详细信息。 编辑服务 1. 打开AI网关控制台实例页面，在顶部菜单栏选择目标实例所在地域，并单击目标实例ID。 2. 在左侧导航栏，单击服务。 3. 单击需要变更的服务对应的编辑，在编辑服务面板，修改服务相关参数，然后单击确定。 删除服务 1. 打开AI网关控制台实例页面，在顶部菜单栏选择目标实例所在地域，并单击目标实例ID。 2. 在左侧导航栏，单击服务。 3. 单击需要变更的服务对应的删除。 4. 在删除服务面板，单击确定，完成删除服务。

功能简介 当客户端发起请求时，需要在请求头中携带签名信息，服务端会根据请求内容、签名算法和存储的秘钥信息，对签名进行校验。签名校验的目的是： 1. 身份验证：确保请求者是合法用户，防止未授权用户访问。 2. 请求完整性校验：保障传输内容完整性，防止请求在传输过程中被篡改。 3. 时效性校验：签名中包含时间戳，用于限定请求的有效时长。服务端在接收到请求时，会校验请求时间是否在允许范围内。 签名计算工具 请查看签名工具。

配置模板 plaintext [必填]正则过滤数组，不可重复。如果当前请求 URI 命中其中任何一个，则将响应代码设置为 rejectedcode 以退出当前用户请求 blockrules: test.com+ [可选]当请求 URI 命中 blockrules 中的任何一个时，将返回的 HTTP 状态代码。有效值[200,599], 默认值403 rejectedcode: 403 [可选]当请求 URI 命中 blockrules 中的任何一个时，将返回的 HTTP 响应体 rejectedmsg: “This URI is not allowed to be accessed ” [可选]匹配URI时是否忽略大小写.默认false caseinsensitive: false

本文将详细介绍clientcontrol插件功能、配置和使用。 功能说明 clientcontrol 插件通过设置客户端请求体大小上限来动态控制客户端的请求。当设置较大的限制时可能导致内存使用增加，需根据实际需求合理配置。 配置字段 名称 类型 填写要求 默认值 有效值 描述 maxbodysize integer 可选 [0,...] 动态设置 clientmaxbodysize 的大小 配置示例 clientcontrol 使用示例 plaintext maxbodysize: 1 根据该场景请求路由 plaintext curl d '123' 由于请求路由的请求体大小超过了所设置的客户端请求体大小上限，请求返回413. plaintext HTTP/1.1 413 Request Entity Too Large ...... 配置模板 plaintext [可选]设置客户端请求体大小上限.有效范围[0,...] maxbodysize: 1024

本文将简单介绍HTTP API的概念和使用场景。 HTTP API HTTP API是基于HTTP协议的接口，以路由为中心。适用于微服务架构等场景，支持单服务、多服务、Mock、重定向等多种使用场景。 若业务系统无需细粒度的API管理，可通过设置路由规则的方式，指定特定请求由哪个后端服务承接。相较于REST API接口，路由路径的粒度通常更粗，例如可以通过前缀匹配的方式配置路由（/user/），这种特性支持快速设定访问路径，助力系统间高效协作，具有较高的灵活性，业务系统间的调用逻辑也更简单。

本章节介绍配置可观测信息。 概述 AI网关支持采集链路数据和请求日志。本文介绍配置可观测信息的操作步骤。 配置链路追踪 1. 登录AI网关控制台，并在顶部菜单栏选择地域。 2. 在左侧导航栏，选择AI网关实例，进入实例列表页。 3. 在网关列表页单击需要查看的网关实例ID或者实例名称。 4. 在左侧导航栏，单击概览，然后单击可观测信息。 5. 单击链路追踪的编辑，随后打开启用链路追踪开关，输入链路采样百分比，然后单击保存。 配置日志投递 1. 登录AI网关控制台，并在顶部菜单栏选择地域。 2. 在左侧导航栏，选择AI网关实例，进入实例列表页。 3. 在网关列表页单击需要查看的网关实例ID或者实例名称 。 4. 在左侧导航栏，单击概览，然后单击可观测信息。 5. 单击日志投递的编辑，随后打开启用访问日志采集开关，然后单击保存。

告警支持通过短信、邮箱、翼连等方式将告警信息通知给对应接收人,我们可以在通知组中设置接收人信息。 功能入口 选择目标资源池，并登录APM组件控制台。 在左侧导航栏中选择「告警管理」「通知组」。 功能说明 联系人（短信/邮箱） 如需要通过短信/邮箱进行告警，可在此处维护联系人信息。支持对联系人信息进行增删改查，需要录入基础信息 同时也支持对联系人进行分组，对联系人组进行增删改查。 WebHook集成 支持以WebHook的方式对第三方通知对象（钉钉、企业微信、飞书等）发送告警信息。支持增删改查WebHook信息。

本章节介绍如何修改AI网关的名称。 概述 网关名称是网关实例的别名，不影响业务，允许用户灵活修改。 操作步骤 1. 登录AI网关控制台，并在顶部菜单栏选择地域。 2. 在左侧导航栏，选择AI网关实例，点击目标实例名称或实例id，进入实例详情。 3. 在实例信息基础信息中，点击名称旁边的修改按钮。 4. 在弹窗中填写新的名称。实例名称长度4~40个字符，大小写字母开头，只能包含大小写字母、数字及分隔符()，大小写字母或数字结尾。点击确认提交修改操作。 5. 弹窗展示任务处理情况，任务完成表示修改成功。

访问Model API 1. 打开AI网关控制台实例页面，在顶部菜单栏选择目标实例所在地域，并单击目标实例ID。 2. 在左侧导航栏，单击概览，然后单击接入点，获取AI网关入口地址。 3. 以OpenAI 兼容协议为例，通过AI网关入口地址访问Model API，如： plaintext curl location ' Path}/chat/completions' header 'ContentType: application/json' data '{ "stream": false, "model": "deepseekchat", "messages": [ { "role": "system", "content": "You are a helpful assistant." }, { "role": "user", "content": "你是谁？" } ], "temperature": 0.7, "topp": 1, "maxtokens": 1024 }'

本章节介绍如何进行监控分析 进入监控分析页面，可以看到监控指标统计，主要包括出入流量、请求成功率、4xx&5xx比例、分位耗时等，如下图所示： 出入流量、网关配置中心连接状态，请求成功率： 4xx、5xx比例，请求失败率，平均耗时 分位耗时和网关连接数统计

编辑模型定义 控制台入口： 1. 进入API托管>API分组菜单页。 2. 点击模型管理 ，进入模型管理页面，点击编辑按钮，可对已有模型进行更新 删除模型定义 用户可以对分组下的模型进行删除操作。 注意 网关不维护模型和API的关联关系，删除模型请谨慎操作。

功能说明 DeleteBucketLifecycle接口用于删除存储桶设置的生命周期规则。 请求消息样式 plaintext DELETE /{Bucket}?lifecycle HTTP/1.1 Host: xxx.zos.ctyun.cn Date: Date ContentLength: ContentLength xamzcontentsha256: ContentSHA256 Authorization: string 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： 指定存储桶名称。 String 是 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 该请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: tx00000000000000000002e00624e43581217bdefault ContentType: application/xml Date: Thu, 07 Apr 2022 01:50:16 GMT Connection: KeepAlive 响应消息头 该请求的响应消息使用公共的响应消息头，请参见如何调用API响应结果响应消息头。 响应消息元素 该请求的响应中不带有响应元素。 错误码 请参见调用前必知错误码全局错误码。

功能说明 GetSymlink获取软链接，得到版本号和链接所指向的对象名。如果软链接的当前版本为删除标记，服务端会返回404 Not Found。 请求消息样式 plaintext GET /{Bucket}/{Object}?symlink&versionIdxxx HTTP/1.1 Host: xxx.zos.ctyun.cn xzossymlinktarget: xxx xzosforbidoverwrite:xxx AcceptEncoding: identity xamzcontentsha256: ContentSHA256 xamzdate: 20250107T025728Z ContentLength: 0 Authorization: string 请求消息参数 参数名称 参数描述 类型 是否必须 Bucket 参数解释： Bucket的名称。 String 是 Object 参数解释： Object的名称。 String 是 versionId 参数解释： Object的指定版本。 String 否 请求消息头 该请求使用公共的请求消息头，请参见如何调用API构造请求请求消息头。 请求消息元素 请求消息中不带消息元素。 响应消息样式 plaintext HTTP/1.1 Status Code xamzrequestid: tx00000000000000000000400677c98181f09bbdefault ContentLength: 0 Date: Tue, 07 Jan 2025 02:57:28 GMT Connection: KeepAlive xzossymlinktarget: xxx 响应消息头 参数描述 参数描述 类型 xzossymlinktarget 参数解释： 软链接指向的目标文件。 String xamzversionid 参数解释： 指定对象的版本id。 String 响应消息元素 该请求的响应中不带有响应元素。

参数名称 参数描述 类型 是否必须 Bucket 参数解释： 桶的名称。 String 是 id 参数解释： 用来标识清单规则的id。 String 是

本节介绍训练任务管理。 训练任务状态 训练任务的生命周期指从创建开始到删除结束，训练任务所经历的状态。以下介绍训练任务状态说明及状态转换说明： 状态 描述信息 创建中 创建训练任务的配置信息 已创建 训练任务已提交 运行中 训练任务已创建完成并正常运行 已停止 训练已停止 成功 训练任务运行成功并退出 失败 训练任务执行出错 更新训练任务 训练任务支持更新的字段有：队列、优先级、资源配置、启动命令及参数、环境变量以及容忍策略。 停止训练任务 启动训练任务 删除训练任务

状态 描述信息 创建中 创建开发机的配置信息 已创建 开发机任务已提交 运行中 开发机已创建完成并正常运行，需等到“访问”按钮可点击后能远程访问 停止 开发机已停止，停止实例后未保存到持久化存储中的数据将丢失