更新时间:2025-06-24 GMT+08:00
分享

修改场景文件

功能介绍

本接口用于修改场景文件。当场景文件上传成功后,需要调用该接口将"ready"字段值修改为"true",完成场景文件上传。

URI

PATCH https://{hostURL}/v2/{project_id}/sim/sm/scenarios/{parent_lookup_id}/files/{sha256}

表1 路径参数

参数

是否必选

参数类型

描述

parent_lookup_id

String

场景ID。

project_id

String

项目ID。

sha256

String

文件sha256值。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

filename

String

文件名。

ready

Boolean

文件状态。完成文件上传状态为true,未完成文件上传状态为false。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

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秒。

path

String

文件在OBS桶中的路径。

bucket

String

文件所在OBS桶。

filename

String

文件名。

ready

Boolean

文件状态。完成文件上传状态为true,未完成文件上传状态为false。

表4 post

参数

参数类型

描述

url

String

POST预签链接信息,用于上传文件。

fields

PostResponseField object

POST预签链接信息,调用POST预签链接上传文件时用于构造请求。

表5 PostResponseField

参数

参数类型

描述

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

请求成功

错误码

请参见错误码

相关文档