Get CA identity

Prev Next

Available in VPC

Get the list and information of identities managed by a blockchain network certificate authority (CA).

Request

The following describes the request format for the endpoint. The request format is as follows:

Method URI
GET /networks/{networkId}/cas/{caId}/identity

Request headers

For headers common to all Blockchain Service APIs, see Common Blockchain Service headers.

Request path parameters

The following describes the parameters.

Field Type Required Description
networkId Long Required Network ID
caId String Required CA ID

Request example

The following is a sample request.

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'

Response

The following describes the response format.

Response body

The following describes the response body.

Field Type Required Description
content Array - CA identity details

content

The following describes content.

Field Type Required Description
networkId Long - Network ID
caId String - CA ID
identityName String - CA identity name
identityType String - CA identity type
  • ADMIN | PEER | ORDERER | CLIENT
    • ADMIN: network admin
    • PEER: Store and maintain data within the network, run chaincode
    • ORDERER: Collect information about transactions in the network and create blocks
    • CLIENT: network user
expireDate LocalDateTime - Expiration date of the issued certificate (YYYY-MM-DDTHH:MM:SS+0000)
creator Long - CA identity creator ID
createDate LocalDateTime - CA identity creation date and time (YYYY-MM-DDTHH:MM:SS+0000)
updateDate LocalDateTime - CA identity modification date and time (YYYY-MM-DDTHH:MM:SS+0000)

Response status codes

For response status codes common to all Blockchain Service APIs, see Common Blockchain Service response status codes.

Response example

The following is a sample example.

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