Organization接続情報のダウンロード

Prev Next

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かどうか
  • true | false
    • true: Endorsing Peer
    • false: Endorsing Peerではない
channels.{channelId}.peers.{peerURL}.chaincodeQuery Boolean - Peerにチェーンコードをインストールできるかどうか
  • true | false
    • true: インストール可能
    • false: インストール不可
channels.{channelId}.peers.{peerURL}.ledgerQuery Boolean - Peerにクエリの提案(Query Proposal)できるかどうか
  • true | false
    • true: 提案可能
    • false: 提案不可
channels.{channelId}.peers.{peerURL}.eventSource Boolean - SDKのイベントリスナー対象が可能かどうか
  • true | false
    • true: 対象可能
    • false: 対象不可
channels.{channelId}.peers.{peerURL}.discover Boolean - Peer間の接続(Discover)が可能かどうか
  • true | false
    • true: 接続可能
    • false: 接続不可
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ライブラリで定義された標準属性
  • 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}"
                ]
            }
        }
    }
}