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

印刷する
共有
PDF

記事の要約

この要約は役に立ちましたか?

ご意見ありがとうございます

VPC環境で利用できます。

ブロックチェーンネットワーク Organization MSPノードの接続情報を JSON形式のファイルでダウンロードします。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド	URI
GET	/networks/{networkId}/organizations/{mspId}/connection

リクエストヘッダ

Blockchain Service APIで共通して使用されるヘッダの詳細は、Blockchain Serviceの共通ヘッダをご参照ください。

リクエストパスパラメータ

パラメータの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`networkId`	Long	Required	ネットワーク ID Networkリストの照会を通じて確認
`mspId`	String	Required	Organization MSP ID Organizationリストの照会を通じて確認

リクエスト例

リクエストのサンプルコードは次の通りです。

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}"
                ]
            }
        }
    }
}

この記事は役に立ちましたか?

What's Next

Ordererリストの照会

リクエスト
レスポンス

タグ

Blockchain Service