CA Identity 조회

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

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

요청

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

메서드	URI
GET	/api/v1/networks/{networkId}/cas/{caId}/identity (한국 리전)
GET	/api/sgn-v1/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`

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