• /redfish/v1 is the root and version
• /Systems/SvrID is the resource identifier
Redfish
™
Tree Structure
The Redfish tree structure comprises a top-level root from where the RESTful interface branches out to cover
a number of “Collections” that subsequently include multiple levels within, creating a tree-like structure. You
can navigate down to this structure to find information and settings.
For example, accessing the Redfish
™
structure for the controller on a C-Series server would be navigated by
using the following path:
https://10.10.10.10/redfish/v1/Systems/FCH2005V1EN/SimpleStorage/SLO
T-HBA
Some portions of an API path could vary depending on the hardware configuration. For example, “SLO
T-HBA” may be different when another type of RAID controller is installed in the managed server.
Note
Redfish
™
Operations
Redfish
™
uses the HTTPS method to perform operations of a RESTful API. You can specify the type of
request being made. It adheres to a standard CRUD (Create, Retrieve, Update, and Delete) format. Depending
on the desired result, you can issue the following types of commands:
•
GET
: View data
•
POST
: Create resources or use actions
•
PATCH
: Change one or more properties on a resource
•
DELETE
: Remove a resource
Currently, HEAD and PUT operations are not supported for Redfish
™
URIs.
Note
Management Standard
IT solution models have evolved over the years and given way to several Out-of-Band (OOB) systems
management standards, or lights-out management (LOM) systems that work within emerging programming
standards and can be implemented in the embedded systems. While this has worked fairly well, there was still
a need for a single management standard that could handle the various demands of IT solutions robustly.
Expanded scale, higher security, and multi-vendor openness call for equally diverse DevOps tools and processes.
Keeping these requirements in mind, the DMTF took on the responsibility of creating a new management
interface standard, which resulted in Redfish
™
version 1.0, which was formally launched in July, 2015.
Key features of the Redfish
™
management standard include:
• Simple to use and highly secure
• Encrypted connections and generally heightened security
• Simple programmatic interface that can be easily managed using scripts
Cisco UCS C-Series Servers REST API Programmer's Guide
2
Cisco IMC REST API Overview
Management Standard
