Managed Object - CryptoManager(vim.encryption.CryptoManager)

Property of
HostConfigManager, ServiceContent
Extended by
CryptoManagerKmip
See also
CryptoKeyId, CryptoKeyPlain, CryptoKeyResult
Since
vSphere API 6.5


Managed Object Description

Singleton Managed Object used to manage cryptographic keys.

Properties

Name Type Description
enabledxsd:boolean

Indicate if the encryption feature is enabled.

Methods

Methods defined in this Managed Object
AddKey, AddKeys, ListKeys, RemoveKey, RemoveKeys

AddKey(addKey)

Add an existing key.
Required Privileges
Cryptographer.ManageKeys

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the CryptoManager used to make the method call.
keyCryptoKeyPlain

[in] The cryptographic key to add.

Return Value

Type Description
None

Faults

Type Description
AlreadyExistsin case the key is already in the key cache
InvalidArgumentin case the keyID is duplicated or key properties are incorrect.
InvalidStatein case the host is not Crypto Safe
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



AddKeys(addKeys)

Add multiple existing keys.
Required Privileges
Cryptographer.ManageKeys

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the CryptoManager used to make the method call.
keys*CryptoKeyPlain[]

[in] List of cryptographic keys to add.
*Need not be set

Return Value

Type Description
CryptoKeyResult[]The result for each key operation.

Faults

Type Description
InvalidStatein case the host is not Crypto Safe
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



ListKeys(listKeys)

List keys. * When executed against the host, lists all the keys added to the host's key cache by AddKey/AddKeys. * When executed against the VC, lists all the keys used by the correctly registered VMs, and the host key.
Required Privileges
Cryptographer.ManageKeys

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the CryptoManager used to make the method call.
limit*xsd:int

[in] maximum keys to return.
*Need not be set

Return Value

Type Description
CryptoKeyId[]List of known keys.

Faults

Type Description
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



RemoveKey(removeKey)

Remove a key (only the UUID is needed to remove). If "force" is set, removal will happen even if the key is in use.
Required Privileges
Cryptographer.ManageKeys

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the CryptoManager used to make the method call.
keyCryptoKeyId

[in] The key to remove.
forcexsd:boolean

[in] Remove the key even if in use or not existent.

Return Value

Type Description
None

Faults

Type Description
InvalidArgumentin case the keyID is not found and "force" is false.
ResourceInUseThrown if the key is used to encrypt any object and "force" is false.
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



RemoveKeys(removeKeys)

Remove multiple keys (only the UUID is needed to remove). If "force" is set, removal will happen even if they are in use.
Required Privileges
Cryptographer.ManageKeys

Parameters

NameTypeDescription
_thisManagedObjectReference A reference to the CryptoManager used to make the method call.
keys*CryptoKeyId[]

[in] List of keys to remove.
forcexsd:boolean

[in] Remove the key even if in use. Always successful.
*Need not be set

Return Value

Type Description
CryptoKeyResult[]

Faults

Type Description
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