更新时间:2024-02-06 GMT+08:00
分享

修改场景文件

功能介绍

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

URI

PATCH /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参数

参数

是否必选

参数类型

描述

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

表3 响应Body参数

参数

参数类型

描述

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。

表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

请求成功

错误码

请参见错误码

相关文档