合约管理-华为云

交换数据空间 EDS-查询合约列表:响应参数

响应参数状态码： 200 表4 响应Body参数参数参数类型描述 data Array of Contract objects 返回数据。 total Long 总数。 error_code String 错误码。 error_msg String 错误描述。表5 Contract 参数参数类型描述 contract_id String 合约ID。 contract_name String 合约名称。 contract_description String 合约描述。 owner_connector_id String 提供者连接器ID。 owner_connector_name String 提供者连接器名称。 subscribe_connector_id String 订阅连接器ID。 subscribe_connector_name String 订阅连接器名称。 transactional_mode String 交换模式： PEER_TO_PEER：点对点 SUBSCRIBE：订阅枚举值： PEER_TO_PEER SUBSCRIBE status String 合约状态： APPROVING：审批中 RUNNING：数据传输中 SUCCESS：成功 FAILED：失败 TERMINATED：已终止 REJECTED：审批驳回枚举值： APPROVING RUNNING SUCCESS FAILED TERMINATED REJECTED create_time String 创建时间。状态码： 400 表6 响应Body参数参数参数类型描述 data - 返回null。 total Long 总数。 error_code String 错误码。 error_msg String 错误描述。状态码： 500 表7 响应Body参数参数参数类型描述 data - 返回null。 total Long 总数。 error_code String 错误码。 error_msg String 错误描述。

交换数据空间 EDS 合约管理

交换数据空间 EDS-查询合约列表:响应示例

响应示例状态码： 200 OK 合约列表。 { "data" : [ { "contract_id" : "AGRTconnector-****94b22a8544ab486c8f45************", "contract_name" : "测试合约1", "contract_description" : "测试合约", "owner_connector_id" : "b40b0d94-3201-4687-93aa-************", "owner_connector_name" : "连接器A", "subscribe_connector_id" : "c1bf9bd7-52fc-435b-ae55-************", "subscribe_connector_name" : "连接器B", "transactional_mode" : "SUBSCRIBE", "status" : "SUCCESS", "create_time" : "2023-10-12T18:11:07Z" }, { "contract_id" : "AGRTconnector-****e1c57b62b46b411380a0************", "contract_name" : "测试合约2", "contract_description" : "测试合约", "owner_connector_id" : "b40b0d94-3201-4687-93aa-************", "owner_connector_name" : "连接器A", "subscribe_connector_id" : "c1bf9bd7-52fc-435b-ae55-************", "subscribe_connector_name" : "连接器B", "transactional_mode" : "SUBSCRIBE", "status" : "SUCCESS", "create_time" : "2023-10-12T16:20:20Z" } ], "total" : 2, "error_code" : null, "error_msg" : null }

交换数据空间 EDS 合约管理

交换数据空间 EDS-查询合约列表:URI

URI GET /v1/{project_id}/eds/instances/{instance_id}/connectors/{connector_id}/contracts 表1 路径参数参数是否必选参数类型描述 project_id 是 String 项目ID。获取方法请参考获取项目ID。 instance_id 是 String 实例ID，开通的数据交换平台实例ID。获取方法请参考获取实例ID。 connector_id 是 String 连接器ID，指定数据交换平台下连接器的ID。获取方法请参考获取连接器ID。表2 Query参数参数是否必选参数类型描述 sub_flag 是 Integer 子标志：我提供的合约-0、我收到的合约-1。 offset 否 Integer 偏移量，表示从此偏移量开始查询，offset大于等于0。最小值：0 最大值：999999 缺省值：0 limit 否 Integer 每页显示条目数量，最大数量999，超过999后只返回999（防止单页返回过大）。最小值：1 最大值：999 缺省值：10 transactional_mode 否 String 交换模式： PEER_TO_PEER：点对点 SUBSCRIBE：订阅枚举值： PEER_TO_PEER SUBSCRIBE name 否 String 合约名称。

交换数据空间 EDS 合约管理

交换数据空间 EDS-查询合约详情:响应示例

响应示例状态码： 200 OK 合约详情。 { "data" : { "contract_id" : "AGRTconnector-****3b53a05caccd4c53b509************", "contract_name" : "测试合约3", "contract_description" : "OpenApi demo.", "owner_connector_id" : "b40b0d94-3201-4687-93aa-************", "owner_connector_name" : "连接器A", "subscribe_connector_id" : "c1bf9bd7-52fc-435b-ae55-************", "subscribe_connector_name" : "连接器B", "subscriber_name" : "************", "subscriber_id" : "************", "approver_id" : "************", "approver_name" : "************", "offer_id" : "fbf85846-3782-46dc-affb-************", "offer_name" : "offer-mysql-20231129AA", "transactional_mode" : "SUBSCRIBE", "status" : "SUCCESS", "create_time" : "2023-12-05T20:24:37Z", "need_approval" : false, "can_terminate" : true, "use_control_policies" : [ { "action" : "VIEW", "when" : { "start_time" : "2023-12-05T20:24:37Z", "end_time" : "2023-12-25T20:24:37Z" }, "how_many" : null, "where" : [ ], "who" : [ "************" ], "user_type": null, "application" : [ "321ac118-758e-4324-9d41-************" ], "additional_attributes" : { "column" : "id,category", "rows" : [ { "column_name" : null, "condition" : "!=", "value" : "1" } ] } }, { "action" : "MODIFY", "when" : { "start_time" : "2023-12-05T20:24:37Z", "end_time" : "2023-12-25T20:24:37Z" }, "how_many" : null, "where" : [ ], "who" : [ "************" ], "user_type": null, "application" : [ "321ac118-758e-4324-9d41-************" ], "additional_attributes" : { "column" : "id,category", "rows" : [ { "column_name" : null, "condition" : "!=", "value" : "1" } ] } }, { "action" : "DOWNLOAD", "when" : { "start_time" : "2023-12-05T20:24:37Z", "end_time" : "2023-12-25T20:24:37Z" }, "how_many" : null, "where" : [ ], "who" : [ "************" ], "user_type": null, "application" : [ "321ac118-758e-4324-9d41-************" ], "additional_attributes" : { "column" : "id,category", "rows" : [ { "column_name" : null, "condition" : "!=", "value" : "1" } ] } } ], "artifacts" : [ { "data_resource_id" : "25546208-0854-49a0-9023-************", "artifact_id" : "303b4f5f-596e-41c9-ad50-************", "artifact_code" : null, "artifact_title" : "animals", "byte_size" : 16384, "media_type" : "jdbc" } ] }, "total" : 0, "error_code" : null, "error_msg" : null }

交换数据空间 EDS 合约管理

交换数据空间 EDS-查询合约详情:响应参数

响应参数状态码： 200 表3 响应Body参数参数参数类型描述 data ContractDetail object 返回数据。 total Long 总数。 error_code String 错误码。 error_msg String 错误描述。表4 ContractDetail 参数参数类型描述 contract_id String 合约ID。 contract_name String 合约名称。 contract_description String 合约描述。 owner_connector_id String 提供者连接器ID。 owner_connector_name String 提供者连接器名称。 subscribe_connector_id String 订阅连接器ID。 subscribe_connector_name String 订阅连接器名称。 subscriber_name String 订阅人名称。 subscriber_id String 订阅人ID。 approver_id String 审批人ID。 approver_name String 审批人名称。 offer_id String Offer ID。 offer_name String offer名称。 transactional_mode String 交换模式： PEER_TO_PEER：点对点 SUBSCRIBE：订阅枚举值： PEER_TO_PEER SUBSCRIBE status String 合约状态： APPROVING：审批中 RUNNING：数据传输中 SUCCESS：成功 FAILED：失败 TERMINATED：已终止 REJECTED：审批驳回枚举值： APPROVING RUNNING SUCCESS FAILED TERMINATED REJECTED create_time String 创建时间。 need_approval Boolean 是否需要审批。注：开启【需要审批】后，下载合约资源的加工产物时需要审批。 can_terminate Boolean 是否允许提供方删除数据。 use_control_policies Array of UseControlPoliciesInner objects 合约使用控制策略列表。 artifacts Array of Artifact objects 合约资产列表。表5 UseControlPoliciesInner 参数参数类型描述 action String 执行动作过滤： VIEW：查看 MODIFY：加工 DOWNLOAD：下载枚举值： VIEW MODIFY DOWNLOAD when TimeInterval object 限制使用时间。 how_many Integer 限制使用次数。 where Array of strings 限制地点列表。 who Array of strings 限制用户列表。 application Array of strings 限制应用列表。 additional_attributes DatabaseAttributes object 策略的扩展属性。 user_type String 限制用户类型。 USER ：指定用户 TEAM ：指定团队枚举值： USER TEAM 表6 Artifact 参数参数类型描述 data_resource_id String 所属资源ID。 artifact_id String 资产ID。 artifact_code String 资产编码。 artifact_title String 文件名称。 byte_size Long 文件大小。 media_type String 资产格式类型。表7 TimeInterval 参数参数类型描述 start_time String 起始时间。 end_time String 截止时间。表8 DatabaseAttributes 参数参数类型描述 column String 可见行。 rows Arrays of RowDTO 可见列。表9 RowDTO 参数参数类型描述 column_name String 参数名称。 condition String 参数条件。 value String 参数条件值。状态码： 400 表10 响应Body参数参数参数类型描述 data - 返回null。 total Long 总数。 error_code String 错误码。 error_msg String 错误描述。状态码： 500 表11 响应Body参数参数参数类型描述 data - 返回null。 total Long 总数。 error_code String 错误码。 error_msg String 错误描述。

交换数据空间 EDS 合约管理

交换数据空间 EDS-查询合约详情:URI

URI GET /v1/{project_id}/eds/instances/{instance_id}/connectors/{connector_id}/contracts/{contract_id} 表1 路径参数参数是否必选参数类型描述 instance_id 是 String 实例ID，开通的数据交换平台实例ID。获取方法请参考获取实例ID。 connector_id 是 String 连接器ID，指定数据交换平台下连接器的ID。获取方法请参考获取连接器ID。 contract_id 是 String 合约ID。参数校验规则：最小长度1，最大长度50，匹配字母数字和符号-。 project_id 是 String 项目ID。获取方法请参考获取项目ID。

交换数据空间 EDS 合约管理

交换数据空间 EDS-归档接收的合约数据:请求示例

请求示例归档接收的合约数据。 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" }

交换数据空间 EDS 合约管理

交换数据空间 EDS-归档接收的合约数据:响应参数

响应参数状态码： 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_id String 资源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 错误描述。

交换数据空间 EDS 合约管理

交换数据空间 EDS-归档接收的合约数据:响应示例

响应示例状态码： 200 OK 归档返回结果。 { "data" : [ { "data_packet_id" : "44d2f35e-0371-433f-b5b6-************", "data_resource_id" : "323daf49-15ee-4ad2-b6f0-************" } ], "total" : 1, "error_code" : null, "error_msg" : null }

交换数据空间 EDS 合约管理

交换数据空间 EDS-归档接收的合约数据:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 X-Auth-Token 是 String 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。最小长度：1 最大长度：100000 表3 请求Body参数参数是否必选参数类型描述 data_packet_ids 否 Array of strings 数据包ID。 new_folder_id 否 String 新的目录ID。

交换数据空间 EDS 合约管理

交换数据空间 EDS-归档接收的合约数据:URI

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。

交换数据空间 EDS 合约管理

区块链服务 BCS-安装合约:响应参数

响应参数状态码： 200 表4 响应Body参数参数参数类型描述 result String 操作结果，值固定为success 最小长度：7 最大长度：7 状态码： 400 表5 响应Body参数参数参数类型描述 code String 状态码最小长度：3 最大长度：3 error_code String 错误码最小长度：12 最大长度：12 error_msg String 错误信息最小长度：1 最大长度：65535 message String 错误详细信息最小长度：1 最大长度：65535 状态码： 401 表6 响应Body参数参数参数类型描述 code String 状态码最小长度：3 最大长度：3 error_code String 错误码最小长度：12 最大长度：12 error_msg String 错误信息最小长度：1 最大长度：65535 message String 错误详细信息最小长度：1 最大长度：65535 状态码： 500 表7 响应Body参数参数参数类型描述 code String 状态码最小长度：3 最大长度：3 error_code String 错误码最小长度：12 最大长度：12 error_msg String 错误信息最小长度：1 最大长度：65535 message String 错误详细信息最小长度：1 最大长度：65535

区块链服务 BCS 合约管理

区块链服务 BCS-安装合约:请求示例

请求示例 { "name" : "test01", "version" : "1.0", "type" : "solidity", "install_orgs" : "[\"org1-c0dx4mj1u\",\"org2-spogt1az5\"]", "endorse_orgs" : "[\"org1-c0dx4mj1u\",\"org2-spogt1az5\"]", "endorse_policy" : "OR", "byte_code" : "xxx"} { "name" : "test01", "version" : "1.0", "type" : "go", "install_orgs" : "[\"org1-c0dx4mj1u\",\"org2-spogt1az5\"]", "endorse_orgs" : "[\"org1-c0dx4mj1u\",\"org2-spogt1az5\"]", "endorse_policy" : "OR"}

区块链服务 BCS 合约管理

区块链服务 BCS-安装合约:请求参数

请求参数表2 请求Header参数参数是否必选参数类型描述 X-Auth-Token 是 String 用户Token 最小长度：1 最大长度：65535 表3 FormData参数参数是否必选参数类型描述 name 是 String 合约名称，支持小写字母和数字，必须以小写字母开头最小长度：6 最大长度：25 version 是 String 合约版本号，支持小写字母、数字、点和下划线，必须以小写字母或数字开头，数字结尾，且不能包含连续两个点或者下划线，也不能包含点和下划线相邻最小长度：2 最大长度：14 type 是 String 合约类型：Go语言类型（go）、Solidity语言类型(solidity) 枚举值： go solidity install_orgs 是 String 合约安装的组织ID列表，合约类型为solidity时该字段可不填写最小长度：10 最大长度：65535 endorse_orgs 是 String 合约背书的组织ID列表，合约类型为solidity时该字段可不填写最小长度：10 最大长度：65535 endorse_policy 是 String 合约背书策略：任意组织背书（OR）、全部组织背书（AND），合约类型为soildity的时候背书策略只能为任意组织背书枚举值： OR AND file 是 File 合约ZIP文件。只能上传一个zip文件，且zip文件不能超过30M；子文件总数不能超过1000000个，子文件总大小不能超过500M，当前只支持Go语言类型合约 description 否 String 合约描述最小长度：0 最大长度：50 security_check 否 String 是否开启合约安全检查任务；true表示开启，其它值表示不开启；当前只支持Go语言类型合约枚举值： true byte_code 否 String Solidity合约字节码内容最小长度：0 最大长度：512000

区块链服务 BCS 合约管理

云服务器内容精选

合约管理

7*24

备案

专业服务

退订

建议反馈

售前咨询热线