Crypto Manager Host Change Key Task

Crypto Manager Host Change Key Task

Change the key used for core dump encryption Note: CryptoManagerHostEnable must be called first If successful, a "best effort" will be made to "in place" shallow recrypt any core dumps found in /var/core to use the new key.

Required privileges: Cryptographer.RegisterHost

Request
URI
POST
https://{api_host}/sdk/vim25/{release}/CryptoManagerHost/{moId}/ChangeKey_Task
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 CryptoManagerHost/{moId}.

string
release
Required

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


Request Body
ChangeKeyRequestType of type(s) application/json
Required
"ChangeKeyRequestType Object"
object
newKey
Required

Data Object representing a plain text cryptographic key.

Authentication
This operation uses the following authentication methods.
Responses
200

OK

Returns MoRefTask of type(s) application/json
"MoRefTask Object"

500

InvalidState: if the host is not in safe state

Returns InvalidState of type(s) application/json
"InvalidState Object"

Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '[{}]' https://{api_host}/sdk/vim25/{release}/CryptoManagerHost/{moId}/ChangeKey_Task