Skip to main content
Sign Out

Welcome to Dell

My Account
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Create and access a list of your products
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.
Sign In Create an Account Premier Sign In Partner Program Sign In

Dell Unity™ Family Unisphere® Management REST API Programmer's Guide

PDF

Downloading Data at Rest Encryption files

You can download the following files to manage Data at Rest Encryption:

  • Encrypted copy of the keystore file, for backing up to an external location. Key manager audit logs and checksum files together in a single .tar file, for monitoring encryption events
  • Checksum file for a specified audit log, for verifying the integrity of the previously-downloaded audit log. The hash in the checksum file should match the hash in the checksum file for the specified audit log.

Syntax for downloading the keystore file

To download the keystore file from the storage system to the local host, use the following request components:

Headers 
Accept: application/json
X-EMC-REST-CLIENT: true
Operation 
GET
URI pattern 
/download/encryption/keystore
Body
Empty.

A successful download request returns a 200 OK HTTP status code. If the request does not succeed, the server returns a 4nn or 5nn HTTP status code in the response header and a message entity in the response body.

Syntax for downloading key manager audit logs and checksum files together

To download the key manager audit logs and checksum files together as a single .tar file from the storage system to the local host, use the following request components:

Headers 
Accept: application/json
X-EMC-REST-CLIENT: true
Operations 
GET
URI pattern 
/download/encryption/auditLogAndChecksum?date=<YYYY-mm>
where <YYYY-mm> is the year and month of the audit log to download. If no date is specified, the entire audit log is downloaded.
Body
Empty.

A successful download request returns 200 OK HTTP status code. If the request does not succeed, the server returns a 4nn or 5nn HTTP status code in the response header and a message entity in the response body.

Syntax for downloading the checksum file for a specified audit log

To download the checksum file for a specified audit log from the storage system to the local host, use the following request components:

Headers 
Accept: application/json
X-EMC-REST-CLIENT: true
Operations 
GET
URI pattern 
/download/encryption/checksum?audit_log=<audit_log_file_name>
where <audit_log_file_name> is the file name of the previously downloaded audit log. The audit log file has a .log suffix.
Body
Empty.

A successful download request returns a 200 OK HTTP status code. If the request does not succeed, the server returns a 4nn or 5nn HTTP status code in the response header and a message entity in the response body.

Example 1: Downloading the keystore file

The following example downloads the keystore file to the local host.

Headers 
Accept: application/json
X-EMC-REST-CLIENT: true
Request 
GET https://10.108.53.216/download/encryption/keystore
Request body
Empty.
Response body (raw) for a successful response
Contains the downloaded keystore file.

Example 2: Downloading audit logs and checksum files

The following example downloads audit logs and checksum files for November, 2015 to the local host as a single .tar file.

Headers 
Accept: application/json
X-EMC-REST-CLIENT: true
Request 
GET https://10.108.253.216/download/encryption/auditLogAndChecksum?date=2015-11
Request body
Empty.
Response body (raw) for a successful response
A tar file that contains the downloaded key manager audit log and checksum files.

Example 3: Downloading a checksum file for a specified audit log

The following example downloads the checksum file for audit log APM00143414369_2015_02_03_19_50_38_0000000000000001_000000000000002C.log to the local host.

Headers 
Accept: application/json
X-EMC-REST-CLIENT: true
Request 
GET https://10.108.253.216/download/encryption/checksum ?audit_log= APM00143414369_2015_02_03_19_50_38_0000000000000001_000000000000002C.log
Request body
Empty.
Response body (raw) for a successful response
A file that contains the downloaded checksum file.

Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\