CA Identity 조회

인쇄
공유
PDF

기사 요약

이 요약이 도움이 되었나요?

의견을 보내 주셔서 감사합니다.

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

블록체인 네트워크 CA(Certificate Authority)에서 관리하는 ID(Identity)의 목록과 정보를 조회합니다.

요청

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

메서드	URI
GET	/networks/{networkId}/cas/{caId}/identity

요청 헤더

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

요청 경로 파라미터

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

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

요청 예시

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

curl --location --request GET 'https://blockchainservice.apigw.ntruss.com/api/v1/networks/{networkId}/cas/{caId}/identity' \
--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`	Array	-	CA Identity 상세 정보

`content`

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

필드	타입	필수 여부	설명
`networkId`	Long	-	네트워크 아이디
`caId`	String	-	CA 아이디
`identityName`	String	-	CA Identity 이름
`identityType`	String	-	CA Identity 타입 `ADMIN` \| `PEER` \| `ORDERER` \| `CLIENT` `ADMIN`: 네트워크 관리자 `PEER`: 네트워크 내 데이터 저장 및 유지, 체인코드 실행 `ORDERER`: 네트워크 내 거래 정보 수집 및 블록 생성 `CLIENT`: 네트워크 사용자
`expireDate`	LocalDateTime	-	발급받은 인증서의 만료 일시(YYYY-MM-DDTHH:MM:SS+0000)
`creator`	Long	-	CA Identity 생성자 아이디
`createDate`	LocalDateTime	-	CA Identity 생성 일시(YYYY-MM-DDTHH:MM:SS+0000)
`updateDate`	LocalDateTime	-	CA Identity 수정 일시(YYYY-MM-DDTHH:MM:SS+0000)

응답 상태 코드

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

응답 예시

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

{
    "content": [
        {
            "networkId": 1630,
            "caId": "25728700",
            "identityName": "******-ca",
            "identityType": "ADMIN",
            "expireDate": "2027-07-29T07:29:00+0000",
            "creator": 2795985,
            "createDate": "2024-07-29T07:30:59+0000",
            "updateDate": "2024-07-29T07:30:59+0000"
        },
        {
            "networkId": 1630,
            "caId": "25728700",
            "identityName": "******-orderer",
            "identityType": "ORDERER",
            "expireDate": "2027-07-29T07:29:00+0000",
            "creator": 2795985,
            "createDate": "2024-07-29T07:30:59+0000",
            "updateDate": "2024-07-29T07:30:59+0000"
        },
        {
            "networkId": 1630,
            "caId": "25728700",
            "identityName": "******-peer",
            "identityType": "PEER",
            "expireDate": "2027-07-30T00:09:00+0000",
            "creator": 2795985,
            "createDate": "2024-07-30T00:09:06+0000",
            "updateDate": "2024-07-30T00:09:06+0000"
        }
    ]
}

이 문서가 도움이 되었습니까?

What's Next

CA Identity 다운로드

요청
응답

태그

Blockchain Service