REST API - get

vcenter certificate management vcenter tls: get

Returns the rhttpproxy TLS certificate. This operation was added in vSphere API 6.7.2.

Request:

HTTP request

GET https://{server}/rest/vcenter/certificate-management/vcenter/tls
No request parameters

Response:

HTTP Status Code: 200

Representation:

{
    "value"{
        "issuer_dn""string",
        "key_usage"[
            "string",
            "string"
        ],
        "thumbprint""string",
        "valid_from""2015-01-01T22:13:05.651Z",
        "serial_number""string",
        "cert""string",
        "version"1,
        "is_CA"true,
        "subject_dn""string",
        "path_length_constraint"1,
        "subject_alternative_name"[
            "string",
            "string"
        ],
        "valid_to""2015-01-01T22:13:05.651Z",
        "signature_algorithm""string",
        "authority_information_access_uri"[
            "string",
            "string"
        ],
        "extended_key_usage"[
            "string",
            "string"
        ]
    }
}

Response Type:

Name Type Description
bold = required
value info TLS certificate.
value.version long Version (version number) value from the certificate. This attribute was added in vSphere API 6.7.2.

value.serial_number string SerialNumber value from the certificate. This attribute was added in vSphere API 6.7.2.

value.signature_algorithm string Signature algorithm name from the certificate. This attribute was added in vSphere API 6.7.2.

value.issuer_dn string Issuer (issuer distinguished name) value from the certificate. This attribute was added in vSphere API 6.7.2.

value.valid_from date_time validFrom specify the start date of the certificate. This attribute was added in vSphere API 6.7.2.

value.valid_to date_time validTo specify the end date of the certificate. This attribute was added in vSphere API 6.7.2.

value.subject_dn string Subject (subject distinguished name) value from the certificate. This attribute was added in vSphere API 6.7.2.

value.thumbprint string Thumbprint value from the certificate. This attribute was added in vSphere API 6.7.2.

value.is_CA boolean Certificate constraints isCA from the critical BasicConstraints extension, (OID = 2.5.29.19). This attribute was added in vSphere API 6.7.2.

value.path_length_constraint long Certificate constraints path length from the critical BasicConstraints extension, (OID = 2.5.29.19). This attribute was added in vSphere API 6.7.2.

value.key_usage string[] Collection of keyusage contained in the certificate. This attribute was added in vSphere API 6.7.2.

value.extended_key_usage string[] Collection of extended keyusage that contains details for which the certificate can be used for. This attribute was added in vSphere API 6.7.2.

value.subject_alternative_name string[] Collection of subject alternative names. This attribute was added in vSphere API 6.7.2.

value.authority_information_access_uri string[] Collection of authority information access URI. This attribute was added in vSphere API 6.7.2.

value.cert string TLS certificate in PEM format. This attribute was added in vSphere API 6.7.2.

Errors:

HTTP Status Code Type Description
404 not_found if the rhttpproxy certificate is not present in VECS store.
500 error if failed due to generic exception.