修改扩展文件-GetExtensionFile
功能介绍
修改扩展文件。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
PATCH https://{hostURL}/v2/{project_id}/sim/pm/extensions/{id}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 仿真拓展文件ID。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| id | 是 | Integer | 参数解释: 仿真拓展文件ID。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| name | 是 | String | 参数解释: 扩展文件名称。 约束限制: 不涉及 取值范围: 最大长度64位,支持中文,字母,数字及下划线命名。 默认取值: 不涉及 |
| description | 否 | String | 参数解释: 扩展文件描述。 约束限制: 不涉及 取值范围: 最大长度256位,支持中文,字母,数字及下划线命名。 默认取值: 不涉及 |
| mount_path | 是 | String | 参数解释: 挂载目录,需绝对路径。 约束限制: 不涉及 取值范围: 最大长度256位,支持中文,字母,数字及下划线命名,不允许挂载系统目录[/opt, /boot, /dev, /etc, /lib, /proc, /sys, /usr]。 默认取值: 不涉及 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| url | String | 参数解释: 扩展文件资源地址。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及 |
| id | Integer | 参数解释: 扩展文件ID。 约束限制: 不涉及。 取值范围: 不涉及 默认取值: 不涉及 |
| created_at | Double | 参数解释: 创建时间。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| updated_at | Double | 参数解释: 更新时间。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| status | Integer | 参数解释: 创建扩展文件状态信息。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及 |
| name | String | 参数解释: 扩展文件名称。 约束限制: 不涉及 取值范围: 最大长度64位,支持中文,字母,数字及下划线命名。 默认取值: 不涉及 |
| description | String | 参数解释: 扩展文件描述。 约束限制: 不涉及 取值范围: 最大长度256位,支持中文,字母,数字及下划线命名。 默认取值: 不涉及 |
| filename | String | 参数解释: 场景文件名。 约束限制: 场景文件为OpenSCENARIO格式。 取值范围: 长度范围[0-255]。 默认取值: 不涉及 |
| mount_path | String | 参数解释: 挂载目录,需绝对路径。 约束限制: 不涉及 取值范围: 最大长度256位,支持中文,字母,数字及下划线命名,不允许挂载系统目录[/opt, /boot, /dev, /etc, /lib, /proc, /sys, /usr]。 默认取值: 不涉及 |
| file | FileSrlz object | 参数解释: 扩展文件信息。 约束限制: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| url | String | 参数解释: 文件资源地址。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及 |
| sha256 | String | 参数解释: 文件SHA256值。 约束限制: 不涉及 取值范围: 不涉及。 默认取值: 不涉及 |
| created_at | Double | 参数解释: 创建时间。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| updated_at | Double | 参数解释: 更新时间。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| filename | String | 参数解释: 场景文件名。 约束限制: 场景文件为OpenSCENARIO格式。 取值范围: 长度范围[0-255]。 默认取值: 不涉及 |
| ready | Boolean | 参数解释: 文件上传状态。 约束限制: 当前未使用该参数。 取值范围: · true:上传完成 · false:上传未完成 默认取值: 不涉及 |
请求示例
修改扩展文件
PATCH https://{endpoint}/v2/{project_id}/sim/pm/extensions/94
{
"name" : "updated_extension",
"description" : "updated_extension",
"mount_path" : "/opt/xiugai"
} 响应示例
状态码:200
{
"url" : "/v2/54d37c8f25af42xxxxx9772687bf/sim/pm/extensions/94/",
"id" : 94,
"created_at" : 1.747730637876023E9,
"updated_at" : 1.747734633281017E9,
"status" : 0,
"file" : {
"url" : "/v2/54d37c8f25af42xxxxx9772687bf/sim/pm/extensions/94/files/82f68a68af49e7bxxxxxxxxx80d917/",
"sha256" : "82f68a68af49e7bxxxxxxxxx80d917",
"created_at" : 1.729847594246947E9,
"updated_at" : 1.729847595235026E9,
"filename" : "extension_xxx.xosc",
"ready" : true
},
"name" : "updated_extension",
"description" : "updated_extension",
"filename" : "extension_xxx.xosc",
"mount_path" : "/opt/xiugai"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 修改成功 |
错误码
请参见错误码。