更新时间:2023-08-18 GMT+08:00
分享

下载SDK配置

功能介绍

下载区块链SDK配置文件,只支持云端管理实例使用

URI

POST /v2/{project_id}/huaweicloudchain/instances/{instance_id}/chain/sdk-config

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

最小长度:32

最大长度:32

instance_id

String

实例ID

最小长度:36

最大长度:36

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token

最小长度:1

最大长度:65535

表3 请求Body参数

参数

是否必选

参数类型

描述

cert_path

String

证书存放路径

download_ca

Boolean

是否下载组织ca私钥、证书

orgs

Array of strings

需要下载客户端配置、证书的组织ID列表

最小长度:4

最大长度:26

数组长度:1 - 100

access_mode

String

区块链后台访问方式:标准通道(StandardChannel)、高性能通道(HighPerformanceChannel)

枚举值:

  • StandardChannel

  • HighPerformanceChannel

endpoint_ip

String

终端节点IP,选择高性能通道时必填

响应参数

状态码: 400

表4 响应Body参数

参数

参数类型

描述

code

String

状态码

最小长度:3

最大长度:3

error_code

String

错误码

最小长度:12

最大长度:12

error_msg

String

错误信息

最小长度:1

最大长度:65535

message

String

错误详细信息

最小长度:1

最大长度:65535

状态码: 401

表5 响应Body参数

参数

参数类型

描述

code

String

状态码

最小长度:3

最大长度:3

error_code

String

错误码

最小长度:12

最大长度:12

error_msg

String

错误信息

最小长度:1

最大长度:65535

message

String

错误详细信息

最小长度:1

最大长度:65535

状态码: 500

表6 响应Body参数

参数

参数类型

描述

code

String

状态码

最小长度:3

最大长度:3

error_code

String

错误码

最小长度:12

最大长度:12

error_msg

String

错误信息

最小长度:1

最大长度:65535

message

String

错误详细信息

最小长度:1

最大长度:65535

请求示例

  • {
      "cert_path" : "opt/temp",
      "download_ca" : false,
      "orgs" : [ "org1-engj39dn7" ],
      "access_mode" : "StandardChannel"
    }
  • {
      "cert_path" : "opt/temp",
      "download_ca" : true,
      "orgs" : [ "org1-engj39dn7" ],
      "access_mode" : "HighPerformanceChannel",
      "endpoint_ip" : "x.x.x.x"
    }

响应示例

状态码

状态码

描述

200

请求成功返回配置文件字节流,配置文件为zip格式,包含组织客户端配置文件和相关证书;客户端配置文件以“链ID-组织ID-sdk.yaml”命名;证书路径为:用户输入路径/orgcerts/组织ID/证书文件名;证书包含组织CA(ca.key、ca.crt)、组织CA通信证书(ca_tls.crt)、用户身份证书(user_sign.key、user_sign.crt)、用户通信证书(user_tls.key、user_tls.crt)

400

请求参数校验不通过

401

鉴权失败

500

服务内部执行错误

分享:

    相关文档

    相关产品