Peer 정보 조회

VPC 환경에서 이용 가능합니다.

블록체인 네트워크의 Peer 상세 정보를 조회합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드	URI
GET	/networks/{networkId}/peers/{peerId}

요청 헤더

Blockchain Service API에서 공통으로 사용하는 헤더에 대한 정보는 Blockchain Service 공통 헤더를 참조해 주십시오.

요청 경로 파라미터

파라미터에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`networkId`	Long	Required	네트워크 아이디 Network 목록 조회를 통해 확인
`peerId`	Long	Required	Peer 아이디 Peer 목록 조회를 통해 확인

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request GET 'https://blockchainservice.apigw.ntruss.com/api/v1/networks/{networkId}/peers/{peerId}' \
--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'

응답

응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`content`	Object	-	Peer 상세 정보
`content.networkId`	Long	-	네트워크 아이디
`content.peerId`	String	-	Peer 아이디
`content.peerName`	String	-	Peer 이름
`content.statusDatabaseType`	String	-	Peer의 State 데이터베이스 타입 `LEVEL_DB` \| `COUCH_DB` `LEVEL_DB`: 빠른 성능과 간단한 데이터 구조를 지원하는 경량 DB `COUCH_DB`: JSON 문서 형식의 데이터와 복잡한 쿼리 및 검색 기능을 제공하는 문서 기반 DB
`content.mspId`	String	-	Peer MSP 아이디
`content.endpointAddr`	String	-	Peer URL 주소
`content.adminIdentityName`	String	-	Admin Peer CA 이름
`content.peerResourceCpu`	Float	-	Peer Pod에 할당된 CPU 용량 (단위: core)
`content.peerResourceMem`	Integer	-	Peer Pod에 할당된 Memory 용량 (단위: MB)
`content.peerResourceStorage`	Integer	-	Peer Pod에 할당된 Storage 용량 (단위: MiB)
`content.statusDatabaseResourceCpu`	Float	-	Peer 데이터베이스에 할당된 CPU 용량 (단위: core) 0 (기본값)
`content.statusDatabaseResourceMem`	Integer	-	Peer 데이터베이스에 할당된 Memory 용량 (단위: MB) 0 (기본값)
`content.statusDatabaseResourceStorage`	Integer	-	Peer 데이터베이스에 할당된 Storage 용량 (단위: MiB) 0 (기본값)
`content.nodeAffinityLabel`	String	-	Peer 노드가 배치된 Ncloud Kubernetes Service 클러스터 노드풀의 라벨 이름
`content.channelList`	Array	-	channelList 상세 정보
`content.installChaincodeList`	Array	-	installChaincodeList 상세 정보
`content.podStatus`	String	-	Peer Pod의 라이프사이클(Lifecycle) 단계 `Running` \| `Pending` \| `Failed` \| `Unknown` `Running`: 실행 중 `Pending`: 대기 중 `Failed`: 작동 실패 `Unknown`: 상태 확인 불가
`content.createDate`	LocalDateTime	-	Peer 생성 일시(YYYY-MM-DDTHH:MM:SS+0000)

`channelList`

content.channelList에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`networkId`	String	-	채널이 생성된 네트워크 아이디
`ordererId`	String	-	채널이 생성된 Orderer 아이디
`channelName`	String	-	채널 이름
`operator`	String	-	채널 Operator 이름

`installChaincodeList`

content.installChaincodeList에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`networkId`	String	-	체인코드가 설치된 네트워크 아이디
`peerId`	String	-	체인코드가 설치된 Peer 아이디
`chaincodeName`	String	-	체인코드 이름
`chaincodeVersion`	String	-	체인코드 버전 정보
`creator`	Long	-	체인코드 생성자 정보
`createDate`	LocalDateTime	-	체인코드 설치 일시(YYYY-MM-DDTHH:MM:SS+0000)

응답 상태 코드

Blockchain Service API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Blockchain Service 공통 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

{
    "content": {
        "networkId": 1630,
        "peerId": "25738634",
        "peerName": "test-peer2",
        "statusDatabaseType": "LEVEL_DB",
        "mspId": "test-msp",
        "endpointAddr": "test-peer2-******-***-peer.bc-gryy4rew.kr.blockchain.naverncp.com",
        "adminIdentityName": "******-peer",
        "peerResourceCpu": 1.1,
        "peerResourceMem": 2800,
        "peerResourceStorage": 200,
        "statusDatabaseResourceCpu": 0.0,
        "statusDatabaseResourceMem": 0,
        "statusDatabaseResourceStorage": 0,
        "nodeAffinityLabel": "",
        "channelList": [
            {
                "networkId": 1630,
                "ordererId": "25728701",
                "channelName": "test-channel",
                "operator": "test-msp"
            }
        ],
        "installChaincodeList": [],
        "podStatus": "Running",
        "createDate": "2024-07-30T00:29:32+0000"
    }
}