CreateCodeBundle - 创建代码包并获取上传凭证
创建 pending 状态代码包,并返回预签名 OSS PUT 直传凭证。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
yundun-codesec:CreateCodeBundle |
create |
*全部资源
|
无 | 无 |
请求语法
POST /v1/projects/{projectId}/codeBundles HTTP/1.1
路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| projectId |
integer |
是 |
项目 ID |
123 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| filename |
string |
是 |
文件名称。 |
test-cases.zip |
| ciMetadata |
string |
否 |
可选 CI/CD 元数据 JSON 字符串; |
{"region":"cn-beijing"} |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| requestId |
string |
请求唯一标识。 |
9A1F403F-0A85-5578-8B7C-55E3E9408659 |
| codeBundleId |
integer |
代码包 ID |
111 |
| projectId |
integer |
项目 ID |
123 |
| bundleVersion |
string |
代码包版本标识。 |
1 |
| status |
string |
代码包状态。 枚举值:
|
pending |
| filename |
string |
文件名称。 |
test-cases.zip |
| createdAt |
string |
创建时间 |
2026-08-27T00:53:46.774Z |
| updatedAt |
string |
更新时间 |
2026-08-27T00:53:46.774Z |
| upload |
object |
上传凭证,字段见下。 |
|
| method |
string |
预签名 URL 的 HTTP 方法,枚举 PUT。 枚举值:
|
PUT |
| putUrl |
string |
预签名 OSS PUT 直传 URL。 |
https://codesec-beijing.oss-cn-beijing.aliyuncs.com/87766767%2F1001667%2F1004171.zip |
| requiredContentType |
string |
客户端 PUT 时必须携带的 Content-Type(当 putUrl 存在时)。 |
application/octet-stream |
| expiresAt |
string |
凭证过期时间(RFC3339)。 |
2026-09-03T05:58:47.88987539Z |
示例
正常返回示例
JSON格式
{
"requestId": "9A1F403F-0A85-5578-8B7C-55E3E9408659",
"codeBundleId": 111,
"projectId": 123,
"bundleVersion": "1",
"status": "pending",
"filename": "test-cases.zip",
"createdAt": "2026-08-27T00:53:46.774Z",
"updatedAt": "2026-08-27T00:53:46.774Z",
"upload": {
"method": "PUT",
"putUrl": "https://codesec-beijing.oss-cn-beijing.aliyuncs.com/87766767%2F1001667%2F1004171.zip",
"requiredContentType": "application/octet-stream",
"expiresAt": "2026-09-03T05:58:47.88987539Z"
}
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidParameter.%s | Invalid parameter:%s. | 无效的参数:%s。 |
| 400 | NotFound.%s | The resource does not exist. | 资源不存在。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。