跳到主要内容

POST – Local SED key management

Use the POST method for local SED key management.

Request URL

PATCH https://<BMC_IPADDR>/redfish/v1/Systems/1/Actions/Oem/LenovoComputerSystem.SetEncryptionKey

Request body

FieldTypeDescription

CurrentEncryptionKey

StringOptional. The default value is empty string. When creating a key, it should be empty or not provided

EncryptionKey

StringRequired. If TargetStorage is not “DirectDrive”, this should be a password that has complexity requirements (1-9, a-z, A-Z, special character such as #@! and so on).

TargetStorage

String

Refer TargetStorage@Redfish.AllowableValues

Optional. Defaults to “AllDrives” if “AllDrives” exists in the allowed list, otherwise “Controller”.

When the target storage contains any controllers, this action needs to be done while the host is powered on.

After the action on the “DirectDrive” is complete, a host reboot is required.

Response body

FieldTypeDescription

EncryptionResult

ArrayItem: object
 

EncryptionResult[N]

ObjectExpanded
  

Identifier

StringEncrypted Storage
  

Status

StringSucceed or Failed
  

Message

StringUser prompted message or reason for failure

Status code

HTTP Status CodeError Message ID
500InternalError

Example

The following example is POST body.

{
"CurrentEncryptionKey":"",
"EncryptionKey":"Passw0rd12--",
"TargetStorage": "Controller"
}

The following example JSON response is returned.

{
"EncryptionResult": [
{
"Identifier": "Slot_2",
"Status": "Succeed",
"Message": "Local key management for controller is succeed"
}
]
}