修改场景文件
功能介绍
本接口用于修改场景文件。当场景文件上传成功后,需要调用该接口将"ready"字段值修改为"true",完成场景文件上传。
URI
PATCH /v2/{project_id}/sim/sm/scenarios/{parent_lookup_id}/files/{sha256}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
parent_lookup_id |
是 |
String |
场景ID。 |
project_id |
是 |
String |
项目ID。 |
sha256 |
是 |
String |
文件sha256值。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
url |
否 |
String |
文件资源地址。 |
sha256 |
否 |
String |
文件sha256值。 |
created_at |
否 |
Double |
最小值:0 |
updated_at |
否 |
Double |
最小值:0 |
post |
否 |
String |
POST预签链接信息,用于上传文件。 |
put_url |
否 |
String |
PUT预签链接地址,用于上传文件。优先使用POST方法上传。 |
get_url |
否 |
String |
GET地址,用于下载文件。 |
expire |
否 |
Integer |
默认失效时间为600秒。 缺省值:600 |
path |
否 |
String |
文件在OBS桶中的路径。 |
bucket |
否 |
String |
文件所在OBS桶。 |
filename |
否 |
String |
文件名。 最大长度:255 |
ready |
否 |
Boolean |
文件状态。完成文件上传状态为true,未完成文件上传状态为false。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
url |
String |
文件资源地址。 |
sha256 |
String |
文件sha256值。 |
created_at |
Double |
创建时间。 最小值:0 |
updated_at |
Double |
更新时间。 最小值:0 |
post |
post object |
POST预签链接信息,用于上传文件。 |
put_url |
String |
PUT预签链接地址,用于上传文件。优先使用POST方法上传。 |
get_url |
String |
GET地址,用于下载文件。 |
expire |
Integer |
默认失效时间为600秒。 缺省值:600 |
path |
String |
文件在OBS桶中的路径。 |
bucket |
String |
文件所在OBS桶。 |
filename |
String |
文件名。 最大长度:255 |
ready |
Boolean |
文件状态。完成文件上传状态为true,未完成文件上传状态为false。 |
参数 |
参数类型 |
描述 |
---|---|---|
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字段,在创建请求时需要添加到请求头。 |
请求示例
修改场景文件状态
PATCH https://{endpoint}/v2/{project_id}/sim/sm/scenarios/{id}/files/{sha256}/ { "ready" : true }
响应示例
状态码: 200
请求成功
{ "url" : "/v2/my_project_id/sim/sm/files/0fb50a138fb132be3c794eb423375cca3263fe35a33063c06a4821819ab7fc85/", "sha256" : "0fb50a138fb132be3c794eb423375cca3263fe35a33063c06a4821819ab7fc85", "created_at" : 1.699954029767271E9, "updated_at" : 1.699954030498088E9, "post" : null, "put_url" : null, "get_url" : "my-get-url", "path" : "my-path", "bucket" : ",my-bucket", "filename" : "ALKS_Scenario_4.1_1_FreeDriving_TEMPLATE.xosc", "ready" : true }
状态码
状态码 |
描述 |
---|---|
200 |
请求成功 |
错误码
请参见错误码。