Organization 연결 정보 다운로드

Prev Next

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 여부
  • 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 아이디 정보
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 라이브러리에서 정의된 표준 속성
  • 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}"
                ]
            }
        }
    }
}