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