View virtual device - certificate connection
    • PDF

    View virtual device - certificate connection

    • PDF

    Article Summary

    Summary

    Views the connection between a virtual device and a certificate.

    Request

    Request URL

    GET {CLOUD_IOT_CORE_API_URL}/mappings/device-certification
    
    Content-Type: application/json; charset=utf-8
    x-ncp-apigw-timestamp: {Timestamp}
    x-ncp-iam-access-key: {Sub Account Access Key}
    x-ncp-apigw-signature-v2: {API Gateway Signature}
    

    Request parameters

    When inputting devicename only as a parameter, all connections for the virtual device are retrieved.
    When inputting serialno only as a parameter, all connections for the certificate are retrieved.
    When inputting both devicename and serialno as parameters, the single connection between the virtual device and the certificate is retrieved.

    Parameter nameRequired statusTypeRestrictionsDescription
    devicenameNostringVirtual device name
    serialnoNostringCertificate's serial number

    Response

    Response body

    {
        "status": "string",
        "body": {
            "content": [
                {
                    "deviceName": "string",
                    "serialNo": "string",
                    "registerTime": "localDateTime"
                }
            ],
            "page": {
                "size": "long",
                "totalElements": "long",
                "totalPages": "long",
                "number": "long"
            }
        }
    }
    
    CategoryTypeDescription
    statusstringIndicates whether response was successful
    body.content[].deviceNamestringName of connected virtual device
    body.content[].serialNostringConnected certificate's serial number
    body.content[].registerTimelocalDateTimeVirtual device - certificate connection date

    Example

    {
        "status": "SUCCESS",
        "body": {
            "content": [
                {
                    "deviceName": "bulb",
                    "serialNo": "7d:94:1c:b1:be:0a:da:b1:c2:20:32:e9:a4:c4:51:f1:56:a3:b1:71",
                    "registerTime": "2020-09-11 14:22:48"
                }
            ],
            "page": {
                "size": 10,
                "totalElements": 1,
                "totalPages": 1,
                "number": 0
            }
        }
    }
    

    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.