归档接收的合约数据 - archiveReceivedData

功能介绍

归档接收的合约数据。当前只支持单条数据归档，即请求体中的data_packet_ids只能填一条记录。

授权信息

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

URI

PUT /v1/{project_id}/eds/instances/{instance_id}/connectors/{connector_id}/contracts/received-data-resources

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID。获取方法请参考获取项目ID。
instance_id	是	String	实例ID，开通的交换数据平台实例ID。获取方法请参考获取实例ID。
connector_id	是	String	连接器ID，指定交换数据平台下连接器的ID。获取方法请参考获取连接器ID。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。通过调用IAM服务“获取用户Token”接口获取（响应消息头中X-Subject-Token的值）。最小长度：1 最大长度：100000
x-eds-proxy-userid	否	String	如果X-Auth-Token是租户ID，那么x-eds-proxy-userid填写实际被代理的真实用户ID。最小长度：0 最大长度：100000

表3 请求Body参数
参数	是否必选	参数类型	描述
data_packet_ids	是	Array of strings	数据包ID。当前只允许同时归档一条数据。
new_folder_id	是	String	新的目录ID。

响应参数

状态码： 200

表4 响应Body参数
参数	参数类型	描述
data	Array of DataPackageResourceResponse objects	返回数据。
total	Long	总数。
error_code	String	错误码。
error_msg	String	错误描述。

表5 DataPackageResourceResponse
参数	参数类型	描述
data_packet_id	String	数据包ID。
data_resource_ids	Array of strings	资源ID。

状态码： 400

表6 响应Body参数
参数	参数类型	描述
data	Object	返回数据。
total	Long	总数。
error_code	String	错误码。
error_msg	String	错误描述。

状态码： 500

表7 响应Body参数
参数	参数类型	描述
data	Object	返回数据。
total	Long	总数。
error_code	String	错误码。
error_msg	String	错误描述。

请求示例

归档接收的合约数据。

PUT https://{endpoint}/v1/{project_id}/eds/instances/{instance_id}/connectors/{connector_id}/contracts/received-data-resources

{
  "data_packet_ids" : [ "44d2f35e-0371-433f-b5b6-************" ],
  "new_folder_id" : "ROOT"
}

响应示例

状态码： 200

归档返回结果。

{
  "data" : [ {
    "data_packet_id" : "44d2f35e-0371-433f-b5b6-************",
    "data_resource_ids" : [ "323daf49-15ee-4ad2-b6f0-************" ]
  } ],
  "total" : 1,
  "error_code" : null,
  "error_msg" : null
}