VPC環境で利用できます。
ブロックチェーンネットワーク Organization MSPノードの接続情報を JSON形式のファイルでダウンロードします。
リクエスト
リクエスト形式を説明します。リクエスト形式は次の通りです。
メソッド | URI |
---|---|
GET | /networks/{networkId}/organizations/{mspId}/connection |
リクエストヘッダ
Blockchain Service APIで共通して使用されるヘッダの詳細は、Blockchain Serviceの共通ヘッダをご参照ください。
リクエストパスパラメータ
パラメータの説明は次の通りです。
フィールド | タイプ | 必須の有無 | 説明 |
---|---|---|---|
networkId |
Long | Required | ネットワーク ID
|
mspId |
String | Required | Organization MSP ID
|
リクエスト例
リクエストのサンプルコードは次の通りです。
curl --location --request GET 'https://blockchainservice.apigw.ntruss.com/api/v1/networks/{networkId}/organizations/{mspId}/connection' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json'
レスポンス
レスポンス形式を説明します。
レスポンスボディ
レスポンスボディの説明は次の通りです。
フィールド | タイプ | 必須の有無 | 説明 |
---|---|---|---|
name |
String | - | ネットワーク名 |
description |
String | - | ネットワークの詳細説明 |
version |
String | - | ネットワークバージョン情報 |
client.organization |
String | - | Organization MSP名 |
channels |
Object | - | チャンネルの詳細情報 |
channels.{channelId} |
Object | - | チャンネル ID情報 |
channels.{channelId}.orderers |
Array<String> | - | Orderer URL情報 |
channels.{channelId}.peers |
Object | - | チャンネル Peer情報 |
channels.{channelId}.peers.{peerURL} |
Object | - | Peer URLと属性情報 |
channels.{channelId}.peers.{peerURL}.endorsingPeer |
Boolean | - | Endorsing Peerかどうか
|
channels.{channelId}.peers.{peerURL}.chaincodeQuery |
Boolean | - | Peerにチェーンコードをインストールできるかどうか
|
channels.{channelId}.peers.{peerURL}.ledgerQuery |
Boolean | - | Peerにクエリの提案(Query Proposal)できるかどうか
|
channels.{channelId}.peers.{peerURL}.eventSource |
Boolean | - | SDKのイベントリスナー対象が可能かどうか
|
channels.{channelId}.peers.{peerURL}.discover |
Boolean | - | Peer間の接続(Discover)が可能かどうか
|
organizations |
Object | - | Organizationの詳細情報 |
organizations.{mspId} |
Object | - | Organization MSP ID情報 |
organizations.{mspId}.mspid |
String | - | Organization MSP ID |
organizations.{mspId}.peers |
Array<String> | - | Organization Peerアドレス |
organizations.{mspId}.certificateAuthorities |
Array<String> | - | Organization Peer CA認証情報 |
orderers |
Object | - | Orderer情報 |
orderers.{ordererId} |
Object | - | Orderer URLアドレス情報 |
orderers.{ordererId}.url |
String | - | Orderer URLアドレス |
orderers.{ordererId}.tlsCACerts |
Object | - | Orderer TLS認証情報 |
orderers.{ordererId}.tlsCACerts.pem |
String | - | Orderer TLS認証 PEMキー |
peers |
Object | - | Peer情報 |
peers.{peerId} |
Object | - | Peer ID情報 |
peers.{peerId}.url |
String | - | Peer URLアドレス |
peers.{peerId}.tlsCACerts |
Object | - | Peer TLS認証情報 |
peers.{peerId}.tlsCACerts.pem |
String | - | Peer TLS認証 PEMキー |
peers.{peerId}.grpcOptions |
Object | - | gRPCオプション情報 |
peers.{peerId}.grpcOptions.ssl-target-name-override |
String | - | gRPCライブラリで定義された標準属性
|
certificateAuthorities |
Object | - | CAの詳細情報 |
certificateAuthorities.{certId} |
Object | - | CA URL情報 |
certificateAuthorities.{certId}.url |
String | - | CA URLアドレス |
certificateAuthorities.{certId}.tlsCACerts |
Object | - | CA TLS認証情報 |
certificateAuthorities.{certId}.tlsCACerts.pem |
Array<String> | - | CA TLS認証 PEMキー |
レスポンスステータスコード
Blockchain Service APIで共通して使用されるレスポンスステータスコードの詳細は、Blockchain Serviceの共通レスポンスステータスコードをご参照ください。
レスポンス例
レスポンスのサンプルコードは次の通りです。
{
"name": "******-blockchain-test1",
"description": "Connection profile for Naver Cloud Blockchain Service. Network ID: 1630、MSP ID: test-msp",
"version": "1.0.0",
"client": {
"organization": "test-msp"
},
"channels": {
"test-channel": {
"orderers": [
"test-orderer1-******-***-ord.bc-gryy4rew.kr.blockchain.naverncp.com:443"
],
"peers": {
"test-peer2-******-***-peer.bc-gryy4rew.kr.blockchain.naverncp.com:443": {
"endorsingPeer": true,
"chaincodeQuery": true,
"ledgerQuery": true,
"eventSource": true,
"discover": true
}
}
}
},
"organizations": {
"test-msp": {
"mspid": "test-msp",
"peers": [
"test-peer2-******-***-peer.bc-gryy4rew.kr.blockchain.naverncp.com:443"
],
"certificateAuthorities": [
"test-ca-******-***-ca.bc-gryy4rew.kr.blockchain.naverncp.com:443"
]
}
},
"orderers": {
"test-orderer1-******-***-ord.bc-gryy4rew.kr.blockchain.naverncp.com:443": {
"url": "grpcs://test-orderer1-******-***-ord.bc-gryy4rew.kr.blockchain.naverncp.com:443",
"tlsCACerts": {
"pem": "{pem}"
}
}
},
"peers": {
"test-peer2-******-***-peer.bc-gryy4rew.kr.blockchain.naverncp.com:443": {
"url": "grpcs://test-peer2-******-***-peer.bc-gryy4rew.kr.blockchain.naverncp.com:443",
"tlsCACerts": {
"pem": "{pem}"
},
"grpcOptions": {
"ssl-target-name-override": "test-peer2-******-***-peer.bc-gryy4rew.kr.blockchain.naverncp.com"
}
}
},
"certificateAuthorities": {
"test-ca-******-***-ca.bc-gryy4rew.kr.blockchain.naverncp.com:443": {
"url": "https://test-ca-******-***-ca.bc-gryy4rew.kr.blockchain.naverncp.com:443",
"tlsCACerts": {
"pem": [
"{pem}"
]
}
}
}
}