修改场景文件-UpdateSceneFile

功能介绍

本接口用于修改场景文件。当场景文件上传成功后，需要调用该接口将"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
}