Host Certificate Manager Replace CA Certificates And CR Ls

Replaces the trusted Certificate Authority (CA) certificates and Certification Revocation List (CRL) used by the server with the provided values.

These determine whether the server can verify the identity of an external entity.

Required privileges: Certificate.Manage

Request

URI

POST

https://{vcenter-host}/sdk/vim25/{release}/HostCertificateManager/{moId}/ReplaceCACertificatesAndCRLs

COPY

Path Parameters

string

moId

Required

The unique identifier for the managed object to which the method attaches; the serialized managed object reference for a request has the form moType/moId, in this case HostCertificateManager/{moId}.

string

release

Required

The vSphere release schema. The current specification covers vSphere 8.0.2.0 APIs.

Request Body

ReplaceCACertificatesAndCRLsRequestType of type(s) application/json

Required

{
    "caCert": [
        "string"
    ],
    "caCrl": [
        "string"
    ]
}

array of string

caCert

Required

List of SSL certificates, in PEM format, of all CAs that should be trusted

array of string

caCrl

Optional

List of SSL CRLs, in PEM format, issued by trusted CAs from the above list

Authentication

This operation uses the following authentication methods.

Session

Responses

204

No Content

Operation doesn't return any data structure

500

HostConfigFault: if there's a problem with the input certificates or CRLs.

Returns HostConfigFault of type(s) application/json

This response body class contains all of the following: VimFault

{
    "_typeName": "string",
    "faultCause": "MethodFault Object",
    "faultMessage": [
        {
            "_typeName": "string",
            "key": "string",
            "arg": [
                {
                    "_typeName": "string",
                    "key": "string",
                    "value": {
                        "_typeName": "string"
                    }
                }
            ],
            "message": "string"
        }
    ]
}

On This Page

Description

Request

Path Parameters

Request Body

Authentication

Response

204 Response Body

Errors

Host Certificate Manager Operations

POST

Host Certificate Manager Generate Certificate Signing Request