创建扩展文件-CreateExtensionFile

功能介绍

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

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	创建扩展文件状态信息： 0 - 已发布 10 - 编辑中
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" 
}