上传测试步骤的文件 - UploadFile

功能介绍

用例脚本编辑或创建时，上传测试步骤的文件

调用方法

请参见如何调用API。

URI

POST /v3/{project_id}/files

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释: 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID 约束限制: 不涉及取值范围: 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字默认取值: 不涉及

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。约束限制：必传。取值范围：字符串长度不少于1，不超过10万。默认取值：不涉及。

表3 FormData参数
参数	是否必选	参数类型	描述
request	是	File	要上传的测试步骤文件

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
error	CommonResponseErrorOfobject object	统一错误返回
reason	String	错误原因
result	Object	结果
status	String	'状态值，如success、error' success，请求成功 error，请求报错

表5 CommonResponseErrorOfobject
参数	参数类型	描述
code	String	错误码
reason	String	错误原因

状态码：401

表6 响应Body参数
参数	参数类型	描述
error_code	String	参数解释接口调用失败错误码取值范围 12-18个字符组成的字符串
error_msg	String	参数解释接口调用失败错误信息取值范围 3-1000个字符组成的字符串

状态码：403

表7 响应Body参数
参数	参数类型	描述
error_code	String	参数解释接口调用失败错误码取值范围 12-18个字符组成的字符串
error_msg	String	参数解释接口调用失败错误信息取值范围 3-1000个字符组成的字符串

状态码：404

表8 响应Body参数
参数	参数类型	描述
error_code	String	参数解释接口调用失败错误码取值范围 12-18个字符组成的字符串
error_msg	String	参数解释接口调用失败错误信息取值范围 3-1000个字符组成的字符串

状态码：500

表9 响应Body参数
参数	参数类型	描述
error_code	String	参数解释接口调用失败错误码取值范围 12-18个字符组成的字符串
error_msg	String	参数解释接口调用失败错误信息取值范围 3-1000个字符组成的字符串

请求示例

post https://{endpoint}/v3/55ec3d7bac89412bbbea437743205c32/files

响应示例

状态码：200

SUCCESS

{
  "status" : "success",
  "result" : {
    "id" : "16f363e0044749f0a845cd7fcdb5a78d",
    "name" : "16f363e0044749f0a845cd7fcdb5a78d_APITest.yaml",
    "originName" : "APITest.yaml",
    "awInsId" : null,
    "projectId" : "6e1317b86fe440a6a70864a71b0ceddb",
    "region" : "{region}",
    "filePath" : "testcase/{region}/7b90e408636344328e44bf70bbae8351/bb5b0826b5ab4c70853df423192001fa/2ece630ee73e420c950bfe4de8a34088/file/16f363e0044749f0a845cd7fcdb5a78d_APITest.yaml",
    "create_time_string" : "2025-06-12 19:38:10 GMT+08:00",
    "update_time_string" : "2025-06-12 19:38:10 GMT+08:00",
    "create_time_stamp" : 1749728290000,
    "update_time_stamp" : 1749728290000,
    "create_user" : "CloudTest-0704",
    "create_time" : "2025-06-12T07:38:10+0800",
    "update_user" : "CloudTest-0704",
    "update_time" : "2025-06-12T07:38:10+0800",
    "current_size" : 4227,
    "testcase_id" : "v92s00010hrjv46f"
  },
  "reason" : null,
  "error" : null
}