- 功能总览
- 产品介绍
- 快速入门
- 用户指南
- API参考
- SDK参考
- 常见问题
- 文档下载
- 通用参考
链接复制成功！
创建场景文件
功能介绍
本接口用于创建仿真场景文件。平台会根据文件sha256值判断场景文件是否已存在，如果场景文件不存在，则返回预签链接用于上传场景文件。
URI
POST https://{hostURL}/v2/{project_id}/sim/sm/scenarios/{parent_lookup_id}/files
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
parent_lookup_id |
是 |
String |
场景ID。 |
|
project_id |
是 |
String |
项目ID。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
sha256 |
是 |
String |
文件sha256值。 |
|
filename |
是 |
String |
文件名。 |
响应参数
状态码：201
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
url |
String |
文件资源地址。 |
|
sha256 |
String |
文件sha256值。 |
|
created_at |
Double |
创建时间。 |
|
updated_at |
Double |
更新时间。 |
|
post |
post object |
POST预签链接信息，用于上传文件。 |
|
put_url |
String |
PUT预签链接地址，用于上传文件。优先使用POST方法上传。 |
|
get_url |
String |
GET地址，用于下载文件。 |
|
expire |
Integer |
默认失效时间为600秒。 |
|
ready |
Boolean |
文件状态。完成文件上传状态为true，未完成文件上传状态为false。 |
|
filename |
String |
文件名。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
url |
String |
POST预签链接信息，用于上传文件。 |
|
fields |
PostResponseField object |
POST预签链接信息，调用POST预签链接上传文件时用于构造请求。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
key |
String |
Post预签链接Key字段，在创建请求时需要添加到请求头。 |
|
x-amz-algorithm |
String |
Post预签链接x-amz-algorithm字段，在创建请求时需要添加到请求头。 |
|
x-amz-credential |
String |
Post预签链接x-amz-credential字段，在创建请求时需要添加到请求头。 |
|
x-amz-date |
String |
Post预签链接x-amz-date字段，在创建请求时需要添加到请求头。 |
|
policy |
String |
Post预签链接policy字段，在创建请求时需要添加到请求头。 |
|
x-amz-signature |
String |
Post预签链接x-amz-signature字段，在创建请求时需要添加到请求头。 |
请求示例
创建场景文件
POST https://{endpoint}/v2/{project_id}/sim/sm/scenarios/{id}/files/
{
"sha256" : "0fb50a138fb132be3c794eb423375cca3263fe35a33063c06a4821819ab7fc85",
"filename" : "ALKS_Scenario_4.1_1_FreeDriving_TEMPLATE.xosc"
}响应示例
状态码：201
请求成功
{
"url" : "/v2/my_project_id/sim/sm/scenarios/361/files/0fb50a138fb132be3c794eb423375cca3263fe35a33063c06a4821819ab7fc85/",
"sha256" : "0fb50a138fb132be3c794eb423375cca3263fe35a33063c06a4821819ab7fc85",
"created_at" : 1.699954029767271E9,
"updated_at" : 1.699954029767295E9,
"post" : {
"url" : "my-post-url",
"fields" : {
"key" : "sim/ifiles/file/0fb50a138fb132be3c794eb423375cca3263fe35a33063c06a4821819ab7fc85.xosc",
"x-amz-algorithm" : "AWS4-HMAC-SHA256",
"x-amz-credential" : "my-amz-credential",
"x-amz-date" : "20231114T092710Z",
"policy" : "my-policy",
"x-amz-signature" : "my-x-amz-signature"
}
},
"put_url" : "my-put-url",
"get_url" : null,
"expire" : 600,
"ready" : false,
"filename" : "ALKS_Scenario_4.1_1_FreeDriving_TEMPLATE.xosc"
}状态码
|
状态码 |
描述 |
|---|---|
|
201 |
请求成功 |
错误码
请参见错误码。
