API Guide

DELETE
Use the DELETE method to remove a resource. Services support the DELETE method for resources that can be deleted. If the
resource cannot be deleted, status code 405 is returned. Services return a representation of the deleted resource in the response
body. Services may return status code 404 or a success code if the resource is deleted successfully.
HTTP Headers
The server response contains only basic information about related resources. Any metadata, which is required to process a request
or response is accessed by using HTTP headers. iDRAC supports the following request headers:
Header Behavior
If-Match Supported for AccountService requests. Ignored for all other URIs.
If-None-Match Supported for AccountService and metadata URIs. Ignored for all other URIs.
iDRAC supports the following response headers:
Header Behavior
Content-Length Returned on all responses except those having Transfer-Encoding: chunked.
Content-Type Responses other than OData metadata — application/json;charset=utf-8
OData responses — application/xml;charset=utf-8
ETag Supported on AccountService and metadata URIs.
Location Service sets this header when resources are created or when HTTP requests are
redirected to other resources.
Cache-Control Returned on all responses. Metadata URIs support cached responses. Instrumentation
resources are not cacheable.
X-Auth-Token Used for authentication of user sessions. See “Session based authentication” under
Redfish Authentication and Authorization
HTTP Status Codes and Error Messages
HTTP defines status codes that can be returned in response messages. When the HTTP status code indicates a failure, the
response body contains an extended error resource, which provides meaningful and deterministic error semantics.
Dell Redfish service extended error information contains error or exception information that is unique to the Dell implementation. It
provides additional details and recommendations for error resolution. To learn more about extended error information, see the
iDRAC with Lifecycle Controller Dell Event Message Reference white paper available at http://en.community.dell.com/techcenter/
extras/m/white_papers/20442267.
For more information about supported status codes, see the Redfish Scalable Platforms Management API Specification document
available at https://www.dmtf.org/standards/redfish.
For more information about error messages, see the white papers available at https://www.dmtf.org/standards/redfish.
SSL Certificates of iDRAC
iDRAC includes a web server that is configured to use the industry-standard SSL security protocol to transfer encrypted data over a
network. Built upon asymmetric encryption technology, SSL is widely accepted for providing authenticated and encrypted
communication between clients and servers to prevent eavesdropping across a network. Redfish service reuses SSL certificate
installed on the iDRAC web server. The iDRAC web server has a Dell self-signed unique SSL digital certificate by default. You can
replace the default SSL certificate with a certificate signed by a well-known Certificate Authority (CA). SSL certificates can be
10