blockchainAdminCert

URI

<managerRoot_uri>/blockchains/admincerts[.<format>]

<managerRoot_uri>/blockchains/admincerts/{admincertname}[.<format>]

<managerRoot_uri>/blockchains/admincerts/{admincertname}/status[.<format>]

<managerRoot_uri>/blockchains/admincerts/{admincertname}/file[.<format>]

<managerRoot_uri>/blockchains/admincerts/{admincertname}/chaincodes/{chaincodename}/usercerts[.<format>]

支持的方法

GET、POST、HEAD

父资源

managerRoot

子资源

无

介绍

blockchainAdmincert 资源是区块链管理证书的入口，用于查看管理证书信息、导入管理证书文件等。

支持的方法：

• GET：获取导入的区块链管理证书列表、区块链管理证书详细信息、导出列表中的区块链管理证书文件、通过区块链管理证书查看区块链网络数据源信息以及数据源下的所有用户证书。
• POST：导入一份区块链管理证书文件。
• HEAD：检查 blockchainAdmincert 资源是否存在，或权限是否可以访问 blockchainAdmincert 资源。

支持的表述格式：RJSON、JSON、HTML、XML。

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求，以 rjson 输出格式为例加以说明，其中，supermapiserver 是服务器名。

http://supermapiserver:8090/iserver/manager/blockchains/admincerts[.<format>]

GET 请求

获取导入的区块链管理证书列表、区块链管理证书详细信息、导出列表中的区块链管理证书文件、通过区块链管理证书查看区块链网络数据源信息以及数据源下的所有用户证书。

请求参数

对 blockchainAdmincert 资源执行 GET 请求时，可在 URI 中包含如下参数，用来指定管理证书和链码。

响应结构1

获取导入的区块链管理证书列表。对blockchainAdmincert资源执行GET请求，返回的响应主体结构如下：

响应示例1

获取导入的区块链管理证书列表。对示例 blockchainAdmincert 资源 http://supermapiserver:8090/iserver/manager/blockchains/admincerts.rjson 执行 GET 请求，返回 rjson 格式的资源描述如下：

{

    "name": "supermapbc",

    "isAdmin": "true",

    "status": "AVAILABLE"

    "description": "geoblockchain",

    "dataserviceName": "",

    "orgs": "OrgA",

    "channels": "txchannel",

    "chaincodes": "supermapcc",

    "peers": "peer0.orga.example.com",

    "orderers": "Orderer0",

    "importTime": "2021-06-21T08:34:08.022Z",

    "expireTime": "2021-06-21T08:34:08.022Z",

}

响应结构2

区块链管理证书详细信息。传入请求参数 admincertname，获取指定区块链管理证书的详细信息。对 blockchainAdmincert 资源执行 GET 请求，返回的响应主体结构如下：

响应示例2

区块链管理证书详细信息。对示例 blockchainAdmincert 资源 http://supermapiserver:8090/iserver/manager/blockchains/admincerts/supermapbc.rjson 执行 GET 请求，返回 rjson 格式的资源描述如下：

{

    "name": "supermapbc",

    "isAdmin": "true",

    "status": "AVAILABLE"

    "description": "geoblockchain",

    "dataserviceName": "",

    "orgs": "OrgA",

    "channels": "txchannel",

    "chaincodes": "supermapcc",

    "peers": "peer0.orga.example.com",

    "orderers": "Orderer0",

    "importTime": "2021-06-21T08:34:08.022Z",

    "expireTime": "2021-06-21T08:34:08.022Z",

    {

        "usercert01"

        "usercert02"

    }

}

响应结构3

导出列表中指定的区块链管理证书文件。传入请求参数 admincertname，对 blockchainAdmincert 资源执行 GET 请求，返回一个 string 类型的 yaml 文件。

响应结构4

通过区块链管理证书查看区块链网络数据源信息。传入请求参数 admincertname，对 blockchainAdmincert 资源执行 GET 请求，返回的响应主体结构如下。

响应示例4

通过区块链管理证书查看区块链网络数据源信息。对示例 blockchainAdmincert 资源 http://supermapiserver:8090/iserver/manager/blockchains/admincerts/supermapbc/chaincodes/supermapcc.rjson 执行 GET 请求，返回 rjson 格式的资源描述如下：

{

    "chaincode": [

    "string"

    ]

}

响应结构5

通过区块链管理证书查看指定数据源下的所有用户证书。传入请求参数 admincertname、chaincodename，对 blockchainAdmincert 资源执行 GET 请求，返回的响应主体结构如下：

响应示例5

通过区块链管理证书查看指定数据源下的所有用户证书。对示例 blockchainAdmincert 资源 http://supermapiserver:8090/iserver/manager/blockchains/admincerts/supermapbc/chaincodes/supermapcc/usercerts.rjson 执行 GET 请求，返回 rjson 格式的资源描述如下：

{

    "name": "usercert01",

    "isAdmin": "false",

    "status": "AVAILABLE"

    "description": "geoblockchain",

    "dataserviceName": "",

    "parentCertName":"supermapbc"

    "orgs": "OrgA",

    "channels": "txchannel",

    "chaincodes": "supermapcc",

    "peers": "peer0.orga.example.com",

    "orderers": "Orderer0",

    "certKVMapping":"string"   //证书内容集合，包括网络结构信息、密钥等

    "userCertMapping":"string" //用户和用户证书的绑定关系

    "createTime": "2021-06-21T08:34:08.022Z",

    "expireTime": "2021-06-21T08:34:08.022Z",

    "importTime": "",

    "users"

    [

        "user01";

        "user02"

    ]

}

{

    "name": "usercert02",

    "isAdmin": "false",

    "status": "AVAILABLE"

    "description": "geoblockchain",

    "dataserviceName": "",

    "parentCertName":"supermapbc"

    "orgs": "OrgA",

    "channels": "txchannel",

    "chaincodes": "supermapcc",

    "peers": "peer0.orga.example.com",

    "orderers": "Orderer0",

    "certKVMapping":"string"   //证书内容集合，包括网络结构信息、密钥等

    "userCertMapping":"string"//用户和用户证书的绑定关系

    "createTime": "2021-06-21T08:34:08.022Z",

    "expireTime": "2021-06-21T08:34:08.022Z",

    "importTime": "",

    "users"

    [

        "user01";

    ]

}

POST 请求

导入一份区块链管理证书文件。

请求参数

对 blockchainAdmincert 资源执行 POST 请求时，可在 URI 中包含如下参数。

响应结构1

传入请求参数 file，对 blockchainAdmincert 资源执行 POST 请求，返回的响应主体结构如下：

响应示例1

导入一份区块链管理证书文件。对 blockchainAdmincert 资源执行 POST 请求，URL 为 http://supermapiserver:8090/iserver/manager/blockchains/admincerts.rjson

参数：file类型的证书文件

则返回的 rjson 格式的资源描述如下：

{

    "succeed": true,

    "errorMsg": ""

}

HEAD 请求

返回跟 GET 请求一样的 HTTP 响应头，但是没有响应实体。可以在不必传输整个响应内容的情况下，获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型，字符编码，压缩编码，实体内容长度等。

HEAD 请求可以用来判断 BlockChainAdminCer t资源是否存在，或者客户端是否有权限访问 blockchainAdmincert资源。通过对加.<format>的 URI 执行 HEAD 请求，还可以快速判断 blockchainAdmincert资源是否支持<format>格式的表述。

请参见

• managerRoot
• 客户端构建 REST 请求
• 状态码列表及说明
• SuperMap iServer REST API 表述格式介绍
• 资源层次结构