Updated on 2022-08-05 GMT+08:00

Downloading the SSL Socket Certificate and Private Key

Function

When the source server runs a Windows OS, the migration Agent installed on source servers communicates with destination servers through the SSL socket. This API is used to download the certificates and private keys in PEM format required by destination servers.

This API is automatically called by the migration Agent to download SSL socket certificates and private keys. You do not need to make calls to this API.

URI

GET /v1/sms/tasks/{task_id}/certkey

For details about the parameters, see Table 1.
Table 1 Parameter description

Parameter

Mandatory

Description

task_id

Yes

Specifies the task ID.

Request

None

Response

Response parameters

For details about the response parameters, see Table 2.

Table 2 Response parameters

Parameter

Type

Description

cert

String

Specifies the self-signed certificate in the PEM format

private_key

String

Specifies the private key in the PEM format.

Example

  • Example request

    None

  • Example response
    {
    "cert":"  -----BEGIN CERTIFICATE-----
    MIICrjCCAhegAwIBAgIBADANBgkqhkiG9w0BAQUFADCBnDELMAkGA1UEBhMCQ04x
    EjAQBgNVBAgMCUd1YW5nRG9uZzERMA8GA1UEBwwIU2hlbnpoZW4xDTALBgNVBAoM
    BE1hYVMxFDASBgNVBAsMC0Nsb3VkYmlsaXR5MSIwIAYDVQQDDBlBdGxhcyBQZXJz
    b25hbCBMaWNlbnNlIENBMR0wGwYJKoZIhvcNAQkBFg5jd2pjc3VAMTI2LmNvbTAe
    Fw0xODAzMTYwMTQzMDFaFw0xOTAzMTYwMTQzMDFaMIGcMQswCQYDVQQGEwJDTjES
    MBAGA1UECAwJR3VhbmdEb25nMREwDwYDVQQHDAhTaGVuemhlbjENMAsGA1UECgwE
    TWFhUzEUMBIGA1UECwwLQ2xvdWRiaWxpdHkxIjAgBgNVBAMMGUF0bGFzIFBlcnNv
    bmFsIExpY2Vuc2UgQ0ExHTAbBgkqhkiG9w0BCQEWDmN3amNzdUAxMjYuY29tMIGf
    MA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDGA3ahP8o4h9B6BLlfOVECpbeHbB4+
    H8dNB+NtAopv9NKg2fz9KPTxJKw037L/dCNE/DCFFlu9dczxXmJRFIRRz677LcBj
    T+05VEjil86qeucnWGVZJjTqG11f5eTUGzUlV12cT425Q/y/BdWAniW70XfjOeeS
    hOW6CZefJ9Q0FwIDAQABMA0GCSqGSIb3DQEBBQUAA4GBAH16ASRuNjbJ5eIBPAig
    9vmQ3iPgUYJFCMPoJeZWecrqj+pGhVJDsviLimNmEnCkEJpRf0sFvPG64R/BISsB
    v/PXvfDLwfTcx1q2j9Y4i3sPe2JfwPKcQLKPdZIyakk9tYsRztFPoxlK0F7YQKd+
    rvbHNGLkWxDArm44wURYFA1t
    -----END CERTIFICATE-----",
    "private_key":"-----BEGIN RSA PRIVATE KEY-----
    MIICXAIBAAKBgQDGA3ahP8o4h9B6BLlfOVECpbeHbB4+H8dNB+NtAopv9NKg2fz9
    KPTxJKw037L/dCNE/DCFFlu9dczxXmJRFIRRz677LcBjT+05VEjil86qeucnWGVZ
    JjTqG11f5eTUGzUlV12cT425Q/y/BdWAniW70XfjOeeShOW6CZefJ9Q0FwIDAQAB
    AoGAG753fC9iZ5pL8RTBXmC7A4pxlRVmhWDRfW8KBAeTmw0sB+KTKmt3KmRvhncD
    bvx4Rp2pNLSFxR2Ayh7l2qNryIWcuxTrlDowGrUg+QzwMfJixczAEU7IHCRC2k3t
    7yf0EILYoM+A+SgvDO8YWhaJ6SYe0zAHFZbabNsSbWzbb8kCQQDlggnh5CN/nDHb
    URZ1FoUrQ8pzk3rc6krWe4WWPx9YJ33zgCOut1w2y2eJ0SN1m+yxAAZ22fnY47kj
    HrS8TjvZAkEA3N7DnLggtQcOC6Ye2v5SGLzv0O6Gw5Xl3NLWiiGK8kY/3Q1Aa5gh
    /8qBnqKLfxpe+3IKfN+wrXUG5PV+XdapbwJAbKbdatWIgLc/WybOTOw2az8SrxiY
    x9EbUOL1YSXM/vzjQc3eFq6ztzUgdTxPXzRMH5d1d/rFr4pPcXLt+V/IMQJBAJQB
    AnumNuSX0aWkr9B303OYR+ttqwitDdcnwXPWflFTGcB6/MwcqcvKW4l9ypRli3hb
    NwPusWnKndAXYZJoIikCQGe7Nb+e59Ksm5+BoSXp/07FriqvwPrDkr+e1Xpfmoai
    s4U4T0RA/NkYRTX/jN/HtpXkjR/dEf7RAAmNO3WtKm4=
    -----END RSA PRIVATE KEY-----"
    }

Status Codes

See Status Codes.

Error Codes

See Out-of-Date Error Codes.