文档首页/ 自动驾驶云服务 Octopus/ API参考/ API/ 仿真场景/ 创建场景文件
更新时间：2024-02-06 GMT+08:00
查看PDF
分享

创建场景文件

功能介绍

本接口用于创建仿真场景文件。平台会根据文件sha256值判断场景文件是否已存在，如果场景文件不存在，则返回预签链接用于上传场景文件。

URI

POST /v2/{project_id}/sim/sm/scenarios/{parent_lookup_id}/files

表1 路径参数

参数

是否必选

参数类型

描述

parent_lookup_id

是

String

场景ID。

project_id

是

String

项目ID。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

url

是

String

文件资源地址。

sha256

是

String

文件sha256值。

最小长度：64

最大长度：64

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

ready

是

Boolean

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

filename

是

String

文件名。

最大长度：255
表3 post

参数

是否必选

参数类型

描述

url

否

String

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

fields

否

PostResponseField object

POST预签链接信息，调用POST预签链接上传文件时用于构造请求。
表4 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字段，在创建请求时需要添加到请求头。

响应参数

状态码： 201

表5 响应Body参数

参数

参数类型

描述

url

String

文件资源地址。

sha256

String

文件sha256值。

最小长度：64

最大长度：64

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

ready

Boolean

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

filename

String

文件名。

最大长度：255
表6 post

参数

参数类型

描述

url

String

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

fields

PostResponseField object

POST预签链接信息，调用POST预签链接上传文件时用于构造请求。
表7 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字段，在创建请求时需要添加到请求头。

请求示例

创建场景文件

POST https://{endpoint}/v2/{project_id}/sim/sm/scenarios/{id}/files/

{
  "sha256" : "0fb50a138fb132be3c794eb423375cca3263fe35a33063c06a4821819ab7fc85",
  "filename" : "ALKS_Scenario_4.1_1_FreeDriving_TEMPLATE.xosc"
}

响应示例

状态码： 201

请求成功

  • {
  "url" : "/v2/my_project_id/sim/sm/scenarios/361/files/0fb50a138fb132be3c794eb423375cca3263fe35a33063c06a4821819ab7fc85/",
  "sha256" : "0fb50a138fb132be3c794eb423375cca3263fe35a33063c06a4821819ab7fc85",
  "created_at" : 1.699954029767271E9,
  "updated_at" : 1.699954029767295E9,
  "post" : {
    "url" : "my-post-url",
    "fields" : {
      "key" : "sim/ifiles/file/0fb50a138fb132be3c794eb423375cca3263fe35a33063c06a4821819ab7fc85.xosc",
      "x-amz-algorithm" : "AWS4-HMAC-SHA256",
      "x-amz-credential" : "my-amz-credential",
      "x-amz-date" : "20231114T092710Z",
      "policy" : "my-policy",
      "x-amz-signature" : "my-x-amz-signature"
    }
  },
  "put_url" : "my-put-url",
  "get_url" : null,
  "expire" : 600,
  "ready" : false,
  "filename" : "ALKS_Scenario_4.1_1_FreeDriving_TEMPLATE.xosc"
}

状态码

状态码

描述

201

请求成功

错误码

请参见错误码。

父主题： 仿真场景

相关文档