文档首页/ 自动驾驶云服务 Octopus/ API参考/ API/ 扩展文件/ 创建扩展文件
更新时间：2025-09-22 GMT+08:00
查看PDF
分享

创建扩展文件

功能介绍

此接口用于创建扩展文件。

URI

POST /v2/{project_id}/sim/pm/extensions

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，获取方法请参见获取项目ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

内容类型。填application/json

X-Auth-Token

是

String

用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）
表3 请求Body参数

参数

是否必选

参数类型

描述

name

是

String

扩展文件名称，最大长度64位，支持中文，字母，数字及下划线命名

description

否

String

扩展文件描述，最大长度255位，支持中文，字母，数字及下划线命名

mount_path

是

String

挂载路径

file

是

表4 object

扩展文件信息
表4 FileCreateSrlz

参数

是否必选

参数类型

描述

sha256

是

String

文件sha256值，长度64位

filename

是

String

扩展文件名，最大长度256位，支持中文，字母及其数字命名

格式要求为：. xosc,.xml,.osc,.xodr,.odr,.osgb,.py,.glb,.gltf,.sce,.json,.txt,.pb,.zip,.trt

响应参数

状态码：201

表5 响应Body参数

参数

参数类型

描述

url

String

扩展文件资源地址

id

Integer

扩展文件ID

created_at

TimeStamp

创建时间

updated_at

TimeStamp

更新时间

status

Integer

扩展文件状态

  • 10 - 编辑中
  • 0 - 已发布

name

String

扩展文件名称

description

String

扩展文件描述

mount_path

String

挂载路径

file

表6 object

扩展文件信息
表6 FileCreateSrlz

参数

参数类型

描述

url

String

文件资源地址。

sha256

String

文件sha256值

created_at

TimeStamp

创建时间

updated_at

TimeStamp

更新时间

post

表7 object

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

put_url

String

PUT预签链接地址，用于上传文件，优先使用POST方法上传

get_url

String

GET地址，用于下载文件

expire

Integer

默认失效时间为600秒

ready

Boolean

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

filename

String

文件名
表7 post

参数

参数类型

描述

url

String

文件资源地址

fields

表8 object

文件资源具体信息
表8 PostResponseField

参数

参数类型

描述

key

String

key信息

x-amz-algorithm

String

加密算法信息

x-amz-credential

String

credential信息

x-amz-date

String

日期信息

policy

String

策略信息

x-amz-signature

String

签名信息

请求示例

创建扩展文件

POST https://{endpoint}/v2/{project_id}/sim/pm/extensions 
 
{ 
  "name" : "new_model", 
  "description" : "new_model", 
  "file" : { 
    "sha256" : "8717ae1874a4b063267211bb575373b7eb73aaa99d6ed531352fff3776dc3a60", 
    "filename" : "new_model.py" 
  }, 
  "mount_path" : "/srv/code" 
}

响应示例

状态码：201

请求成功

{ 
  "url" : "/v2/54d37c8f25af42xxxxxxxxe9772687bf/sim/pm/extensions/49/", 
  "id" : 49, 
  "created_at" : 1746579828.060311, 
  "updated_at" : 1746579838.060311, 
  "status" : 10, 
  "file" : { 
    "url" : "/v2/54d37c8f25af42xxxxxxxxe9772687bf/sim/pm/files/file_sha256_info/", 
    "sha256" : "file_sha256_info", 
    "created_at" : 1746579828.060311, 
    "updated_at" : 1746579838.060311, 
    "post" : { 
      "url" : "file_obs_url_info", 
      "fields" : { 
        "key" : "sim/ifiles/extension/file_sha256_info.py", 
        "x-amz-algorithm" : "AWS4-HMAC-SHA256", 
        "x-amz-credential" : "CIMxxxY/20250507/cn-north-7/s3/aws4_request", 
        "x-amz-date" : "20250x07T025739Z", 
        "policy" : "policy_info", 
        "x-amz-signature" : "signature_info_id" 
      } 
    }, 
    "put_url" : "put_url_info", 
    "get_url" : null, 
    "expire" : 600, 
    "ready" : false, 
    "filename" : "new_model.py" 
  }, 
  "name" : "new_model", 
  "description" : "new_model", 
  "mount_path" : "/srv/code" 
}

状态码

状态码

描述

201

创建成功

错误码

请参见错误码。

父主题： 扩展文件

相关文档