Get network list
    • PDF

    Get network list

    • PDF

    Article summary

    Available in VPC

    Get the list of blockchain networks.

    Request

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

    MethodURI
    GET/networks

    Request headers

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

    Request query parameters

    The following describes the parameters.

    FieldTypeRequiredDescription
    pageIntegerOptionalPage number
  • 0 (default)
  • sizeIntegerOptionalQuery result list size
  • 20 (default)
  • sortStringOptionalSort by
    • ascending (default)
    • networkId | networkName | nksClusterName | networkStatus | createDt | updateDt
      • networkId: network ID
      • networkName: network name
      • nksClusterName: Ncloud Kubernetes Service cluster name
      • networkStatus: network status
      • createDt: network creation date and time
      • updateDt: network modification date and time

    Request example

    The following is a sample request.

    curl --location --request GET 'https://blockchainservice.apigw.ntruss.com/api/v1/networks?page=0&size=20&sort=networkName' \
    --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.

    FieldTypeRequiredDescription
    contentArray-Content details
    totalElementsLong-Total number of blockchain networks
    totalPagesInteger-Total number of pages

    content

    The following describes content.

    FieldTypeRequiredDescription
    networkIdLong-Network ID
    networkNameString-Network name
    nksClusterNameString-Ncloud Kubernetes Service cluster name
    statusString-Network status
    • ACTIVE | DEPLOY | DELETE
      • ACTIVE: running
      • DEPLOY: deploying
      • DELETE: deleting
    createDateLocalDateTime-Network creation date and time (YYYY-MM-DDTHH:MM:SS+0000)
    updateDateLocalDateTime-Network 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,
                "networkName": "******-blockchain-test1",
                "nksClusterName": "blockchain-test (1.28.10)",
                "status": "ACTIVE",
                "createDate": "2024-07-29T07:25:39+0000",
                "updateDate": "2024-07-29T07:30:59+0000"
            },
            {
                "networkId": 1635,
                "networkName": "******-blockchain-test2",
                "nksClusterName": "blockchain-test (1.28.10)",
                "status": "DEPLOY",
                "createDate": "2024-08-06T06:27:24+0000",
                "updateDate": "2024-08-06T06:27:24+0000"
            }
        ],
        "totalElements": 2,
        "totalPages": 1
    }
    

    Was this article helpful?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.