tklmMachineIdentityDelete

Use the tklmMachineIdentityDelete command to remove a machine identity from the IBM Security Key Lifecycle Manager data store.

Note: The IBM Security Key Lifecycle Manager command-line interface commands will be deprecated in the later versions of IBM Security Key Lifecycle Manager. Use the REST interfaces instead.

Purpose

Use this command to remove a machine identity from the IBM Security Key Lifecycle Manager data store.

Permissions

Your role must have a permission to the delete action and a permission to the DS5000 device group to which the machine identity is attached.

Syntax

tklmMachineIdentityDelete -machineUUID machineuuidvalue -machineID machineidentitystring | -machineText machineidentitytext

Parameters

-machineID
Required if the value of -machineText or -machineUUID is not specified. Specify a unique machine ID with a minimum length of 1 and a maximum length of 48 characters. For example: 3042383030303437000000000000. Use the tklmMachineIdentityList command to locate machine identities.
-machineText
Required if the value of -machineID or -machineUUID is not specified. Specify a unique, user-supplied descriptive label greater than zero bytes and not more than 96 bytes for a machine, such as myEncryptedDS5000.
-machineUUID
Required if the value of -machineText or -machineID is not specified. Specify a value for a unique universal identifier for the machine, such as MACHINE-bf57ca0d-1299-4bc7-9c9c-2fa29a99c7c9. Use the tklmMachineIdentityList command to locate the machine uuid.

Example

This Jython-formatted command removes a machine identity from the IBM Security Key Lifecycle Manager data store.

print AdminTask.tklmMachineIdentityDelete 
('[-machineID 3042383030303437000000000000]')