VPC 환경에서 이용 가능합니다.
블록체인 네트워크 Organization MSP 노드의 연결 정보를 JSON 형식의 파일로 다운로드합니다.
요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
메서드 | URI |
---|---|
GET | /networks/{networkId}/organizations/{mspId}/connection |
요청 헤더
Blockchain Service API에서 공통으로 사용하는 헤더에 대한 정보는 Blockchain Service 공통 헤더를 참조해 주십시오.
요청 경로 파라미터
파라미터에 대한 설명은 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
networkId |
Long | Required | 네트워크 아이디
|
mspId |
String | Required | Organization MSP 아이디
|
요청 예시
요청 예시는 다음과 같습니다.
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 | - | 채널 아이디 정보 |
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 아이디 정보 |
organizations.{mspId}.mspid |
String | - | Organization MSP 아이디 |
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 아이디 정보 |
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 아이디: 1630, MSP 아이디: 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}"
]
}
}
}
}