创建场景数据回灌-CreateSceneDataReplay
功能介绍
此接口用于创建pblog格式的场景数据回灌信息。接口基于数据回灌文件的sha256判断数据回灌文件是否已存在，如果数据回灌文件不存在，响应中提供预签链接用于上传数据回灌文件。
URI
POST https://{hostURL}/v2/{project_id}/sim/sm/replays
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
file |
是 |
FileCreateSrlz object |
数据回灌文件信息。 |
|
format |
否 |
string |
数据回灌文件格式，当前仅支持pblog格式，默认值为pblog |
响应参数
状态码：201
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
url |
String |
数据回灌资源地址。 |
|
id |
Integer |
数据回灌ID。 |
|
created_at |
Double |
创建时间。 |
|
updated_at |
Double |
更新时间。 |
|
file |
FileCreateSrlz object |
数据回灌文件信息。 |
|
format |
string |
数据回灌文件格式，当前仅支持pblog格式。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
url |
String |
文件资源地址。 |
|
sha256 |
String |
文件sha256值。 |
|
created_at |
TimeStamp |
创建时间。 |
|
updated_at |
TimeStamp |
更新时间。 |
|
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/replays
{
"format": "pblog",
"file": {
"sha256": "597bcaf23420xxxx9582f1ec8244bd73b3b013c3a14",
"filename": "PBlog_player.pblog"
}
}
响应示例
状态码：201
请求成功
{
"url": "/v2/54d37c8xxxxf4ee9772687bf/sim/sm/replays/123/",
"id": 123,
"created_at": 1758185279.99988,
"updated_at": 1758185279.999914,
"file": {
"url": "/v2/54d37c8xxxxf4ee9772687bf/sim/sm/files/597bcaf23420xxxx9582f1ec8244bd73b3b013c3a14/",
"sha256": "597bcaf23420xxxx9582f1ec8244bd73b3b013c3a14",
"created_at": 1758185279.995749,
"updated_at": 1758185279.995806,
"post": {
"url": "https://octopus-raw-54d37c8xxxxf4ee9772687bf.obs.xxx.com/",
"fields": {
"key": "sim/ifiles/replay/597bcaf23420xxxx9582f1ec8244bd73b3b013c3a14.pblog",
"x-amz-algorithm": "AWS4-HMAC-SHA256",
"x-amz-credential": "HPUxxxD/20250918/cn-xxx-x/s3/aws4_request",
"x-amz-date": "20250918T084800Z",
"policy": "eyJleHBpcmF0aW9uIjogxxxxxF0ZSI6ICIyMDI1MDkxOFQwODQ4MDBaIn1dfQ==",
"x-amz-signature": "d972acdxxxxxxxxxx875e1ff0d2fab6504334be62a58ad"
}
},
"put_url": "",
"get_url": null,
"expire": 600,
"ready": false,
"filename": "PBlog_player.pblog"
},
"format": "pblog"
}
状态码
|
状态码 |
描述 |
|---|---|
|
201 |
请求成功 |
错误码
请参见错误码。
