更新时间:2025-09-25 GMT+08:00
分享

API导入资源包文件

功能介绍

API导入资源包文件。

URI

POST /v1/{project_id}/resource-package/api-import

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。

获取方法请参考获取项目ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Workspace-Id

String

工作空间ID。获取方法请参见获取工作空间ID

X-Auth-Token

String

用户Token。通过调用IAM服务获取IAM用户Token接口,接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见Token认证

Content-Type

String

固定值,指定请求体类型和字符集。

示例:Content-Type: multipart/form-data

表3 FormData参数

参数

是否必选

参数类型

描述

file

File

资源包文件。

import_strategy

String

资源重复导入策略。

  • replace:指替换,无法恢复。
  • addNew:指不替换,新增资源包。

replace_rule

String

替换规则,默认值为BY_ID。

枚举值:

  • BY_ID:同源替换。
  • BY_NAME:同名替换。

响应参数

表4 响应Body参数

参数

参数类型

描述

task_id

String

任务ID。

请求示例

API导入资源包文件。

POST https://{endpoint}/v1/{project_id}/resource-package/api-import
{
    "file": 文件流,
    "import_strategy": "replace",
    "replace_rule": "BY_ID"
}

响应示例

导入资源包成功。

{
  "task_id" : "b8913c92-xxxx-4721-b8fd-a72af3945b61"
}

状态码

表5

状态码

描述

200

导入资源包成功。

错误码

请参见错误码

相关文档