Managed Object - CryptoManagerHost(vim.encryption.CryptoManagerHost)

Extended by
CryptoManagerHostKMS
Extends
CryptoManager
See also
CryptoKeyPlain
Since
vSphere API 6.7


Managed Object Description

Properties

Name Type Description
None
Properties inherited from CryptoManager
enabled

Methods

Methods defined in this Managed Object
ChangeKey_Task, CryptoManagerHostEnable, CryptoManagerHostPrepare
Methods inherited from CryptoManager
AddKey, AddKeys, ListKeys, RemoveKey, RemoveKeys

ChangeKey_Task(changeKey)

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

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the CryptoManagerHost used to make the method call.
newKeyCryptoKeyPlain

The key that replaces the existing core dump encryption key

Return Value

Type Description
ManagedObjectReference
to a Task

Faults

Type Description
InvalidStateThrown if the host is not in safe state
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None



CryptoManagerHostEnable(enable)

Begin core dump encryption by specifying the encryption key and put the host in safe state Note: CryptoManagerHostPrepare must be called first
Required Privileges
Cryptographer.RegisterHost

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the CryptoManagerHost used to make the method call.
initialKeyCryptoKeyPlain

The key to be used for core dump encryption

Return Value

Type Description
None

Faults

Type Description
AlreadyExistsThrown if the host is in safe state and initialKey differs from the existing core dump encryption key
InvalidStateThrown if the host is in incapable state
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition



CryptoManagerHostPrepare(prepare)

Prime the host to receive sensitive information and put the host in prepared state
Required Privileges
Cryptographer.RegisterHost

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the CryptoManagerHost used to make the method call.

Return Value

Type Description
None

Faults

Type Description
InvalidStateThrown if the host is not in incapable state
RuntimeFaultThrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Events

Type
None

Show WSDL type definition