导入资产 - ImportAsset

功能介绍

创建导入资产作业任务，资产版本和具体哪些资产从资产内容里读取。
最大支持100个应用和任务。
一个用户同一时刻只能创建一个资产导入作业任务，没有Running状态的作业任务存在。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

POST /v2/{project_id}/instances/{instance_id}/assets/import

表1 路径参数
参数	是否必选	参数类型	描述
instance_id	是	String	实例ID。
project_id	是	String	项目ID，获取方式请参见API参考的“附录 > 获取项目ID”章节。

表2 Query参数
参数	是否必选	参数类型	描述
type	否	String	导入资产文件的模式。 AddNew：全量新增导入。 Merge：合并导入。默认为AddNew模式。
prefix	否	String	App应用的前缀。若加上前缀，导入资产时会拼接前缀和已有的App应用，形成新的App应用名称，再根据新的App应用名称导入资产。
datasource_overwrite	否	String	导入资产是否覆盖数据源。 true：数据源覆盖导入。 false：数据源不覆盖导入。默认为false模式。

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

表4 FormData参数
参数	是否必选	参数类型	描述
ImportAssetRequestBody	是	File	待导入资产文件。

响应参数

状态码：200

表5 响应Body参数
参数	参数类型	描述
job_id	String	资产导入作业的ID，可用于查询作业进度，获取导入作业进度。

状态码：403

表6 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误消息。
error_details	String	具体错误消息。
request_id	String	请求处理ID。

请求示例

通过资产包文件导入集成资产到实例。

POST https://{endpoint}/v2/{project_id}/instances/{instance_id}/assets/import

{
  "ImportAssetRequestBody" : "assetname.zip"
}

响应示例

状态码：200

{
  "job_id" : "ff8080814dbd65d7014dbe0d84db0013"
}

状态码：403

Forbidden

{
  "error_code" : "ROMA.00000101",
  "error_msg" : "error summary",
  "error_details" : "some error details here",
  "request_id" : "13760c1fe8655e61209b75665e9bef43"
}