华为云用户手册

请求示例 { "orgID" : "4f1439758ebb41f7411b5f684b67713c08b89198", "channelID" : "mychannel", "cryptoMethod" : "SW", "cert" : "-----BEGIN CERTIFICATE-----\n...\n...\n-----END CERTIFICATE-----", "sk" : "------BEGIN PRIVATE KEY-----\n...\n...\n-----END PRIVATE KEY-----", "timestamp" : "2020-10-27T17:28:16+08:00", "vcIndex" : 1, "owner" : "did:example:ebfeb1f712ebc6f1c276e12ec21" }

组织解密 接口方法 func (client *GatewayClient) DecryptDataWithE2EE(consensusOrgID, decOrgID string, txID string) (data string, err error) 参数说明 参数 类型 说明 consensusOrgID string 共识组织ID decOrgID string 执行解密操作的组织ID。 txID string 密文对应的交易ID。 返回值 参数 类型 说明 data string 解密后的明文信息。 err error 解密成功返回nil，否则返回error。 父主题： Go SDK介绍

组织加密 接口方法 func (client *GatewayClient) EncryptDataWithE2EE(consensusOrgID, encOrgID string, decOrgIDs []string, data string, options ...interface{}) (txID string, err error) 参数说明 参数 类型 说明 consensusOrgID string 共识组织ID encOrgID string 执行加密操作的组织ID。 decOrgIDs []string 除了执行加密操作的组织ID以外，可以解密该消息的组织ID列表。 data string 需要加密的数据明文。 options interface{} 其他选项，目前支持输入一个bool类型，用于指定加密后，是否更新群组密钥。 返回值 参数 类型 说明 txID string 加密后返回密文对应的交易ID，解密时输入交易ID可以获得对应明文。 err error 加密成功返回nil，否则返回error。 父主题： Go SDK介绍

响应示例 状态码： 200 订单信息 { "consumer" : "did:example:3TMWx8owKHARgNwbj4ywmG", "consumerName" : "Tyler", "orderSeq" : "1", "provider" : "did:example:DHkJjyD5wZwya6sd6BNBnG", "providerName" : "hw", "productID" : "product1", "productName" : "prodname1", "price" : "0", "applyTime" : "1607332359", "encryptedAesKey" : "BNGhPwjaTgpM+V7czzw1i4mH21KKN+XLKXHLqVsRIfybUCncqZNfomkRfzX4WEHj+oty1X9oCd4h6xMnRvs8BWE5Tvg6BJ6QTW/km9EO/FSYqzJf2GqQzAleAcLJrTBZ3LRbPaF87CgJ114ae7R+VK9VvfXQ8exuH2KMRD305dXieGpM4VPVv9u1BbL15Jpd/g==", "status" : "ready", "reason" : "I want product1", "lockProof" : "" } 状态码： 500 失败响应 { "errorCode" : " BCS .5002046", "errorMsg" : "Incorrect number of arguments" }

请求示例 { "orgID" : "ce0ac69b0c8648cd25b44a551780409767c8890b", "channelID" : "mychannel", "cryptoMethod" : "SW", "cert" : "-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----", "sk" : "-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----", "timestamp" : "2020-10-27T17:28:16+08:00", "consumer" : "did:example:3TMWx8owKHARgNwbj4ywmG", "orderSeq" : "1" }

请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 orgID 是 String 组织id channelID 是 String 通道id cryptoMethod 是 String 加密方法，目前固定为SW cert 是 String 证书 sk 是 String 私钥 timestamp 是 String 时间戳 consumer 是 String 订单申请者身份标识 orderSeq 是 String 订单序列号

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 consumer String 订单消费者身份标识 consumerName String 订单消费者名称 orderSeq String 订单序列号 provider String 订单提供者身份标识 providerName String 订单提供者名称 productID String 数据集产品id productName String 数据集产品名称 price String 订单价钱 applyTime String 订单申请时间 encryptedAesKey String 密钥 status String 订单状态 reason String 订单申请原因 lockProof String 订单锁定证明 creatorDID String 流程创建者DID，如果没有加入任何流程，为“” processID String 当前订单所属流程ID，如果没有加入任何流程，为“” 状态码： 500 表3 响应Body参数 参数 参数类型 描述 errorCode String 错误码 errorMsg String 错误描述

获取节点对象 根据节点名称，获取需要发送交易的节点对象。所有消息发送前，都必须调用该方法，获取发送节点对象，然后再获取对应的消息发送接口对象。 调用方法 public WienerChainNode getWienerChainNode(String name) throws InvalidParameterException 参数说明 参数 类型 说明 name String 节点名称。 返回值 类型 说明 WienerChainNode WienerChainNode对象。

响应示例 状态码： 200 分布式身份文档结构体 { "context" : "https://www.w3.org/ns/did/v1", "id" : "did:example:ebfeb1f712ebc6f1c276e12ec21", "publicKey" : [ { "id" : "string", "type" : "string", "controller" : "string", "publicKeyPem" : "string" } ], "authentication" : [ "did:example:ebfeb1f712ebc6f1c276e12ec21#key-0" ], "recovery" : "string", "service" : [ { "id" : "did:example:ebfeb1f712ebc6f1c276e12ec21#xdi", "type" : "XdiService", "serviceEndpoint" : "https://xdi.example.com/8377464", "credentialApplySchema" : { "type" : "LegalCitizen", "name" : "LegalCitizen", "description" : "Certified Chinese citizens", "attributes" : [ { "name" : "name", "type" : "someType", "description" : "Identity number" } ] } } ], "proof" : { "creator" : "did:example:ebfeb1f712ebc6f1c276e12ec21", "type" : "RsaSignature2018", "created" : "1606720551", "signatureValue" : "eyJhbGciOiJSUzI1NiIsImI2NCI6ZmFsc2UsImNyaXQiOlsiYjY0I PAYuNzVBAh4vGHSrQyHUdBBPM" }, "created" : "1588921521", "updated" : "", "status" : "active" } 状态码： 500 失败响应 { "errorCode" : "B CS .5002034", "errorMsg" : "request timed out or been cancelled" }

请求示例 { "orgID" : "4f1439758ebb41f7411b5f684b67713c08b89198", "channelID" : "mychannel", "cryptoMethod" : "SW", "cert" : "-----BEGIN CERTIFICATE-----\n...\n...\n-----END CERTIFICATE-----", "sk" : "------BEGIN PRIVATE KEY-----\n...\n...\n-----END PRIVATE KEY-----", "timestamp" : "2020-10-27T17:28:16+08:00", "did" : "did:example:ebfeb1f712ebc6f1c276e12ec21" }

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 context String context id String 分布式身份标识 publicKey Array of DocPublicKey objects 公钥列表 authentication Array of strings did主公钥标识 recovery String 备用公钥标识，可用于修改主密钥 service Array of Service objects 服务列表 proof Proof object 证明结构，可为空 created String 创建时间 updated String 更新时间 status String 状态 表3 DocPublicKey 参数 参数类型 描述 id String 公钥标识 type String 公钥类型 controller String 公钥的控制者标识 publicKeyPem String 公钥证书 表4 Service 参数 参数类型 描述 id String 服务标识 type String 服务类型 serviceEndpoint String 服务介绍网址 credentialApplySchema CredentialApplySchema object 申请凭证所需数据的Schema 表5 CredentialApplySchema 参数 参数类型 描述 type String 类型 name String 名称 description String 描述信息 attributes Array of Attribute objects 属性列表 表6 Attribute 参数 参数类型 描述 name String 名称 type String 类型 description String 描述信息 表7 Proof 参数 参数类型 描述 creator String 创建者身份标识 type String 签名类型 created String 签名创建时间 signatureValue String 签名值 状态码： 500 表8 响应Body参数 参数 参数类型 描述 errorCode String 错误码 最小长度：8 最大长度：36 errorMsg String 错误描述 最小长度：2 最大长度：512

请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 orgID 是 String 组织id channelID 是 String 通道id cryptoMethod 是 String 加密方法，目前固定为SW cert 是 String 用户证书，每行末尾均需要增加显式换行符\n sk 是 String 用户私钥，每行末尾均需要增加显式换行符\n timestamp 是 String 时间戳 did 是 String 分布式身份标识

请求参数 表1 请求Body参数 参数 是否必选 参数类型 描述 orgID 是 String 组织id channelID 是 String 通道id cryptoMethod 是 String 加密方法，目前固定为SW cert 是 String 证书 sk 是 String 私钥 timestamp 是 String 时间戳 consumer 是 String 订单申请者身份标识 orderSeq 是 String 订单序列号 encryptData 否 String 数据密文，当onChainStore设置为“true”时，可不输入 watermarkType 否 String 水印类型，visible明水印，blind暗水印，嵌入水印时，必须填写本字段。如果发布或主动分享数据集的时候嵌入的是暗水印，则无法再次嵌入暗水印。嵌入的水印内容为：使用人did_orderID。 onChainStore 否 String 数据密文是否在链上存储，可设置为“true”或“false”，默认为“false”。如果设置为“true”，则不需要输入encryptData，可自动在链上获取数据密文

请求示例 { "orgID" : "ce0ac69b0c8648cd25b44a551780409767c8890b", "channelID" : "mychannel", "cryptoMethod" : "SW", "cert" : "-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----", "sk" : "-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----", "timestamp" : "2020-10-27T17:28:16+08:00", "consumer" : "did:example:3TMWx8owKHARgNwbj4ywmG", "orderSeq" : "1", "encryptData" : "base64 encoding string", "watermarkType" : "string", "onChainStore" : "string" }

响应示例 状态码： 200 订单信息。 { "provider" : "did:example:DHkJjyD5wZwya6sd6BNBnG", "productID" : "product1", "plaintext" : "base64 encoding string" } 状态码： 500 失败响应 { "errorCode" : "BCS.5002046", "errorMsg" : "Incorrect number of arguments" }

响应示例 { "resCode": "0", "resMsg": "成功", "result": { "description": "", "input": "ActionInput", "inputs": [ { "description": "", "isCollection": false, "label": "equipment", "lengthInCharacter": false,… } ], "label": "", "methodName": "editEquipment", "methodObject": "EditEquipment", "output": "ActionOutput", "outputs": [ { "description": "", "isCollection": false, "label": "", "lengthInCharacter": false,… } ], "script": "命名空间__editEquipment", "types": { "ActionInput": [ { "description": "", "isCollection": false, "label": "equipment", "lengthInCharacter": false,… } ], "ActionOutput": [ { "description": "", "isCollection": false, "label": "", "lengthInCharacter": false,… } ] } } }

URI DELETE AstroZero 域名 /u-route/baas/metadata/v1.0/Picklist/{Picklist_id} 表1 路径参数 参数 是否必选 参数类型 描述 Picklist _id 是 String 参数解释： Picklist实例的ID，可通过调用查询选项列表值集接口查看（响应消息中的“id”）。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

请求示例 根据ID增加选项列表值集的值。 POST https://AstroZero域名/u-route/baas/metadata/v1.0/Picklist/000y000000aM92DCu6hU { "picklistValues": [ { "value": "F", "label": "ff" } ] }

URI POST AstroZero域名/u-route/baas/metadata/v1.0/Picklist/{Picklist_id} 表1 路径参数 参数 是否必选 参数类型 描述 Picklist _id 是 String 参数解释： Picklist实例的ID，可通过调用查询选项列表值集接口查看（响应消息中的“id”）。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

响应示例 { "resCode": "0", "resMsg": "成功", "result": [ { "actionId": "", "actionScript": "", "belongTo": "", "createdBy": "10gd000001DHHEwmE1NQ", "createdBy.name": "test00xx", "createdDate": "2024-06-11 11:17:13", "custom": true, "description": "", "id": "000q000001DobvdqMuVk", "isBaseline": false, "label": "testLabel", "lastModifiedBy": "10gd000001DHHEwmE1NQ", "lastModifiedBy.name": "test00xx", "lastModifiedDate": "2024-06-11 11:17:13", "name": "TestNameForButton", "objectId": "cust000001Dgez2L19N2", "owner": "10gd000001DHHEwmE1NQ", "owner.name": "test00xx", "properties": "", "protectMode": 0, "source": "", "type": "Button", "visibility": 0 } ] }

响应参数 表1 响应参数 参数 参数类型 描述 resCode String 参数解释： 返回码。 取值范围： 如果返回“0”代表请求成功，其他错误码说明请参考错误码。 resMsg String 参数解释： 返回消息。 取值范围： 如果成功状态，通常会返回“Success”，其他情况会返回具体的错误信息。 result Array 参数解释： 成功返回会返回所有标准页面信息，以一个列表展示，每个值是一个标准页面。

响应示例 { "resCode": "0", "resMsg": "成功", "result": [{ "active": false, "application": null, "belongTo": "000f000001DHIByJ3nKC", "belongTo.__objectType": "Application", "belongTo.name": "", "createdBy": "10gd000001DHHEwmE1NQ", "createdBy.__objectType": "User", "createdBy.name": "test00xx", "createdDate": "2024-05-22 16:02:55", "custom": true, "customStyle": null, "deletedDate": null, "description": null, "id": "003g000001DHkGa4LkkC", "installedPackage": null, "isDeleted": false, "label": "Test__ApprovedResource__CST Detail", "lastModifiedBy": "10gd000001DHHEwmE1NQ", "lastModifiedBy.__objectType": "User", "lastModifiedBy.name": "test00xx", "lastModifiedDate": "2024-05-22 16:02:55", "layer": "null", "libraries": "[]", "logo": null, "name": "__layout__Test__ApprovedResource__CST__detail", "overridable": true, "owner": "10gd000001DHHEwmE1NQ", "owner.__objectType": "User", "owner.name": "test00xx", "pageType": null, "protectMode": 0, "referencePageId": null, "systemModifiedDate": null, "type": "Page", "version": "1.0.1", "visibility": 0 }, { "active": false, "application": "000f000001Df2QvzMS4O", "application.__objectType": "Application", "application.name": "N2109869914__psi", "belongTo": null, "createdBy": "10gd000001DHHEwmE1NQ", "createdBy.__objectType": "User", "createdBy.name": "test00xx", "createdDate": "2024-06-05 16:52:39", "custom": true, "customStyle": ".newmodal .form-buttons-container{\n display: none\n}", "deletedDate": null, "description": null, "id": "003g000001Df2TOk6oxI", "installedPackage": "003L000001Df2QxT2t6U", "installedPackage.__objectType": "PackageInstall", "installedPackage.name": "", "isDeleted": false, "label": "管理仓库管理员", "lastModifiedBy": "10gd000001DHHEwmE1NQ", "lastModifiedBy.__objectType": "User", "lastModifiedBy.name": "test00xx", "lastModifiedDate": "2024-06-05 16:52:41", "layer": "null", "libraries": "", "logo": null, "name": "N2109869914__Managewarehouse_admin", "overridable": true, "owner": "10gd000001DHHEwmE1NQ", "owner.__objectType": "User", "owner.name": "test00xx", "pageType": "Manage", "protectMode": 0, "referencePageId": null, "systemModifiedDate": null, "type": "Page", "version": "1.0.9", "visibility": 0 }, { "active": false, "application": "000f000001Df2fEmnBmy", "application.__objectType": "Application", "application.name": "N2211461455__psi", "belongTo": "000f000001Df2fEmnBmy", "belongTo.__objectType": "Application", "belongTo.name": "N2211461455__psi", "createdBy": "10gd000001DHHEwmE1NQ", "createdBy.__objectType": "User", "createdBy.name": "test00xx", "createdDate": "2024-06-05 16:55:53", "custom": true, "customStyle": ".newmodal .form-buttons-container{\n display: none\n}", "deletedDate": null, "description": null, "id": "003g000001Df2hjjDouB", "installedPackage": "003L000001Df2fGPHBr4", "installedPackage.__objectType": "PackageInstall", "installedPackage.name": "", "isDeleted": false, "label": "管理买家", "lastModifiedBy": "10gd000001DHHEwmE1NQ", "lastModifiedBy.__objectType": "User", "lastModifiedBy.name": "test00xx", "lastModifiedDate": "2024-06-05 16:55:55", "layer": "null", "libraries": "", "logo": null, "name": "N2211461455__Managebuyer", "overridable": true, "owner": "10gd000001DHHEwmE1NQ", "owner.__objectType": "User", "owner.name": "test00xx", "pageType": "Manage", "protectMode": 0, "referencePageId": null, "systemModifiedDate": null, "type": "Page", "version": "1.0.8", "visibility": 0 } ] }

响应参数 表1 响应参数 参数 参数类型 描述 resCode String 参数解释： 返回码。 取值范围： 如果返回“0”代表请求成功，其他错误码说明请参考错误码。 resMsg String 参数解释： 返回消息。 取值范围： 如果成功状态，通常会返回“Success”，其他情况会返回具体的错误信息。 result result object 参数解释： 在成功请求时会有内容返回。 表2 result参数说明 参数 参数类型 描述 name String 参数解释： 服务编排的公式名称。 取值范围： 不涉及。 category String 参数解释： 服务编排公式的类别。 取值范围： 不涉及。 format String 参数解释： 服务编排公式的调用格式。 取值范围： 不涉及。 description String 参数解释： 服务编排公式的描述信息。 取值范围： 不涉及。

响应参数 表3 响应参数 参数 参数类型 描述 resCode String 参数解释： 返回码。 取值范围： 如果返回“0”代表请求成功，其他错误码说明请参考错误码。 resMsg String 参数解释： 返回消息。 取值范围： 如果成功状态，通常会返回“Success”，其他情况会返回具体的错误信息。 result Object 参数解释： 在成功请求时会有内容，返回启动BPM后，BPM实例的运行信息。

响应示例 可以看到返回的报文中，BPM实例的suspended字段被置为了true。 { "resCode":"0", "resMsg":"Success", "result":{ "name":"SimpleBP", "version":"1.0.1", "id":"002N000000Q3QW4IMAOO", "processDefID":"001L000000Peuw1Q318a", "interviewLabel":"SimpleBP 2019-05-10 15:14:09", "nextElem":"", "isTest":true, "state":"New", "bpStatus":"New", "urgency":0, "taskOutcome":"", "businessKey":"002N000000Q3QW4IMAOO", "startTime":"2019-05-10 15:14:09", "endTime":"", "Ext1":"", "Ext2":"", "Ext3":"", "Ext4":"", "Ext5":"", "Ext6":"", "Ext7":0, "Ext8":0, "suspended":true, "isClosed":false } }

URI PUT AstroZero域名/u-route/baas/bp/v2.0/runtime/instances/{instance_id} 表1 路径参数 参数 是否必选 参数类型 描述 instance_id 是 String 参数解释： 对应一个具体BPM实例的标识，可通过调用查询BPM实例接口查看（响应消息中的“id”）。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

请求参数 表2 请求参数 参数 是否必选 参数类型 描述 action 是 String 参数解释： 对BPM实例操作的动作名。 约束限制： 不涉及。 取值范围： suspend：挂起。 resume：恢复。 terminate：终止。 restart：重启。 cancel：撤销。 rollBackPreviousTask：打回任务，即管理员或当前任务处理人将流程回退到上一步任务。 revokePreviousTask：撤回任务，即任务提交人撤回已提交审批的任务，任务重新回到待审批。 默认取值： 不涉及。

响应示例 { "resCode": "0", "resMsg": "成功", "result": [ { "controlField": null, "createdBy": "testUserId", "createdBy.__objectType": "User", "createdBy.name": "test0xx", "createdDate": "2019-08-05 20:38:24", "custom": true, "description": "", "id": "testListId", "installedPackage": null, "isGlobal": true, "isRestricted": false, "isSorted": false, "lastModifiedBy": "testUserId", "lastModifiedBy.__objectType": "User", "lastModifiedBy.name": "test0xx", "lastModifiedDate": "2019-08-05 20:38:24", "masterLabel": "testLabel", "name": "testName", "owner": "testUserId", "owner.__objectType": "User", "owner.name": "test0xx", "protectMode": 0 } ] }

请求参数 表1 请求参数 参数 是否必选 参数类型 描述 flag 否 String 参数解释： 查询选项列表值集列表的两种显示方式。 约束限制： 不涉及。 取值范围： flag=A：表示查询所有选项列表值集，包含全局选项列表值集和字段级选项列表值集。 不携带flag，可根据条件进行查询。 默认取值： 不涉及。 project 否 String 参数解释： Picklist所属的项目名称。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 type 否 String 参数解释： Picklist所属的项目类型。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 name 否 String 参数解释： Picklist的名称。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 isGlobal 否 String 参数解释： 是否为全局Picklist。 约束限制： 不涉及。 取值范围： true false 默认取值： 默认为false。

URI POST AstroZero域名/u-route/baas/v1.0/flow/{action}/{name_or_id} 表1 参数说明 参数 是否必选 参数类型 描述 action 是 String 参数解释： 需要对服务编排执行的操作。 约束限制： 不涉及。 取值范围： 各个操作取值及其含义如下： start：启动服务编排，系统标准启动操作。 run：开始执行服务编排，自定义启动操作。 next：执行服务编排的下一步。 back：执行服务编排的上一步。 finish：结束运行的服务编排，即正常完成服务编排。 terminate：终止运行的服务编排实例和相关资源。 del：删除服务编排实例和相关资源。 默认取值： 不涉及 name_or_id 是 String 参数解释： 当action取值为start或run时，设置为服务编排的名称。其他操作设置为服务编排的运行实例ID，可通过调用查看服务编排运行实例接口查看（响应消息中的“id”）。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。