API Guide

Redfish-based systems management

This section provides an overview of the Redfish service implemented in the iDRAC firmware. It includes information about the Redfish

API, schema, configuration, authentication, authorization, and so on.

Topics:

• URL support

• Redfish configuration

• Redfish schema

• Redfish authentication and authorization

• Roles and privileges

• iDRAC licensing

• HTTP methods

• HTTP headers

• HTTP status codes and error messages

• SSL certificates of iDRAC

• Eventing

• Updating firmware using SimpleUpdate

• Query Parameters

URL support

Redfish is a web-based API which implies that resources are accessed using client supplied URLs. URLs are required to identify the

Redfish resources. The Redfish API uses a simple URL hierarchy which follows a /redfish/v1/ pattern for all resources. To access a

Redfish resource, use the URL pattern https://<iDRAC IP>/redfish/v1/<Resource Path>. For more information on the

supported resources, see Redfish resources on page 17. iDRAC supports the following URL patterns:

• /redfish — URL for the Redfish version object.

• /redfish/v1 — Root URL for version 1 of the Redfish services.

• /redfish/v1/odata — Redfish services expose an OData service document at this URI. This service document provides a

standard format for enumerating resources that are exposed by the service by enabling all generic hypermedia-driven OData clients to

navigate to the resources of the service.

• /redfish/v1/$metadata — Redfish services expose a metadata document in XML format. This document describes the

resources and collections that are available at the service root URI. It also provides references to other metadata documents, which

describe the complete set of resource types that are exposed by the service.

• /redfish/v1/$metadata#<Collection or a Singleton resource> — Metadata URL specified as a part of

@odata.context property for all resources. This URL returns data in XML format.

• /redfish/v1/JsonSchemas — This URL returns data in JSON format. The output is a collection of the JsonSchemaFile resource

instances.

• /redfish/v1/JsonSchemas/<resource URI> — The JSON Schema File resource instance describes the location (URI) of a

particular Redfish schema definition being implemented or referenced by a Redfish service. This URL returns data in JSON format.

• /redfish/v1/<other resource specific URIs> — All instrumentation resources follow this pattern.

NOTE: The Redfish standard implemented in iDRAC supports only HTTPS protocol.

NOTE: In previous versions of Redfish implementation, # character was parsed as #. Because this character is treated

as a break character by the code, any characters after # were ignored. Now, # character is automatically converted to

%23. This conversion allows the consoles or REST clients to use the URL without any errors.

Redfish configuration

You can configure the Redfish interface on iDRAC by enabling or disabling the iDRAC attribute. If this attribute is disabled, HTTPS

requests to Redfish URIs fail with an HTTP status code of 404 and an error message indicating that this attribute is disabled.

Redfish-based systems management 9