Redfish DMTF Logo

Document Identifier: DSP2046

Date: 2021-12-02

Version: 2021.4

Redfish Resource and Schema Guide






Supersedes: 2021.3

Document Class: Informational

Document Status: Published

Document Language: en-US

DMTF is a not-for-profit association of industry members dedicated to promoting enterprise and systems management and interoperability. Members and non-members may reproduce DMTF specifications and documents, provided that correct attribution is given. As DMTF specifications may be revised from time to time, the particular version and release date should always be noted.

Implementation of certain elements of this standard or proposed standard may be subject to third party patent rights, including provisional patent rights (herein "patent rights"). DMTF makes no representations to users of the standard as to the existence of such rights, and is not responsible to recognize, disclose, or identify any or all such third party patent right, owners or claimants, nor for any incomplete or inaccurate identification or disclosure of such rights, owners or claimants. DMTF shall have no liability to any party, in any manner or circumstance, under any legal theory whatsoever, for failure to recognize, disclose, or identify any such third party patent rights, or for such party's reliance on the standard or incorporation thereof in its product, protocols or testing procedures. DMTF shall have no liability to any party implementing such standard, whether such implementation is foreseeable or not, nor to any patent owner or claimant, and shall have no liability or responsibility for costs or losses incurred if a standard is withdrawn or modified after publication, and shall be indemnified and held harmless by any party implementing the standard from any and all claims of infringement by a patent owner for such implementations.

For information about patents held by third-parties which have notified the DMTF that, in their opinion, such patent may relate to or impact implementations of DMTF standards, visit http://www.dmtf.org/about/policies/disclosures.php.

This document's normative language is English. Translation into other languages is permitted.

CONTENTS

1 Overview

The Redfish standard comprises a set of specifications maintained by the Redfish Forum, a working group within the DMTF. The standard defines a protocol that uses RESTful interfaces to provide access to data and operations associated with the management of systems and networks. One of the strengths of the Redfish protocol is that it works with a wide range of servers: from stand-alone servers to rack-mount and bladed environments to large-scale data centers and cloud environments.

The Redfish standard addresses several key issues for infrastructures that require scalability. Large infrastructures often consist of many simple servers of different makes and types. This hyper-scale usage model requires a new approach to systems management. The Redfish protocol addresses these needs by providing a standard protocol based on out-of-band systems management.

With these goals in mind, the Redfish protocol was designed as an open-industry standard to meet scalability requirements in multi-vendor deployments. It easily integrates with commonly used tools, using RESTful interfaces to perform operations and using JSON and OData formats for data payloads.

1.1 Who should read this document?

This document is useful to people who want to understand how to use the Redfish API. This includes application developers who want to create client-side software to communicate with a Redfish Service, and other consumers of the API.

1.2 How can I provide feedback?

Feedback on all Redfish specifications and documents is encouraged. Feedback can be directed to the DMTF and the Redfish Forum by the following means:

1.3 Where can I find more information?

These web sites provide more information about the Redfish standard:

2 Using this guide

Every Redfish response consists of a JSON payload containing properties that are strictly defined by a schema for that Resource. The schema defining a particular Resource can be determined from the value of the "@odata.type" property returned in every Redfish response. This guide details the definitions for every Redfish standard schema.

Each schema section contains:


The property-level details include:

Column Purpose
Property name

The case-sensitive name of the JSON property as it appears in the JSON payload.

Lists the schema version in parentheses when properties were added to or deprecated in the schema after the initial v1.0.0 release.

Type

The JSON data types for the property, which can include boolean, number, string, or object.

The string (enum) tag identifies enumerated strings.

Number types that use units specify the units.

Attributes

Designates whether:

  • The property is read-only or read-write, if supported by the implementation.
  • The service might return a null value if the property value is temporarily unavailable.
Description

The normative description of the property, as copied directly from the schema LongDescription definition.

2.1 URI listings

The Redfish Specification v1.6.0 added mandatory OpenAPI Specification v3.0 support. As part of this support, the URIs for every Redfish Resource are defined to appear at known, fixed locations. Resource Collections also appear at fixed locations, with the members of each collection appearing at URIs constructed by using a fixed path structure, with appropriate path segments equal to the value of Id properties of members along the path.

To determine support for v1.6.0 and OpenAPI, compare the RedfishVersion property value in the Service root (\redfish\v1\). Services that report a 1.6.0 or greater value, such as 1.6.1 or 1.7.0, adhere to the URI definitions shown.

The URI listings do not apply to Redfish Services that report support of versions earlier than Specification v1.6.0. For those Services, clients must use the API's hypermedia features to discover links from the Service root to each Resource. While Services typically match the URIs listed in this documents for many of their Resources, this is not guaranteed and results in errors.

3 Common properties

3.1 Properties that all Redfish schemas define

The following properties are defined for inclusion in every Redfish schema, and therefore may be encountered in any response payload. They are documented in this guide to avoid repetition in the Reference Guide property tables. Note that several of these properties are payload annotations, but appear in this guide because they are required for all Redfish Resources.

3.1.1 Properties

Property Type Attributes Notes
@odata.context string
(URI)
read-only The URL to a metadata document with a fragment that describes the data, which is typically rooted at the top-level singleton or collection. Technically, the metadata document has to only define, or reference, any of the types that it directly uses, and different payloads could reference different metadata documents. However, because this property provides a root URL for resolving a relative reference, such as @odata.id, the API returns the canonical metadata document.
@odata.etag string read-only The current ETag for the Resource.
@odata.id string
(URI)
read-only required The unique ID for the Resource.
@odata.type string read-only required The type of a resource.
Description string read-only The human-readable description for the Resource.
Id string read-only The ID that uniquely identifies the Resource within the collection that contains it. This value is unique within a collection.
Name string read-only required The human-readable moniker for a Resource. The type is string. The value is NOT necessarily unique across Resource instances within a collection.
Oem {} object The manufacturer- or provider-specific extension moniker that divides the Oem object into sections.

3.2 Frequently used properties

In addition, the following properties are frequently defined in Redfish schemas. Their definition and usage is the same throughout the Redfish data model.

3.2.1 Properties

Property Type Attributes Notes
Actions {} object The Redfish actions available for this Resource.
Links {} object The links associated with the Resource, as defined by that Resource's schema definition. All associated reference properties defined for a Resource are nested under the Links property. Find all directly referenced, or subordinate, Resource properties from the root of the Resource.
RelatedItem [ { array An array of links. Each link points to a Resource or part of a Resource as defined by that Resource's schema. This representation is not intended to be a strong linking methodology like other references. Instead, it shows a relationship between elements or subelements in disparate parts of the service. For example, fans might be in one area of the system and processors in another. The relationship between the two might not be obvious. This property can show that one is related to the other. In this example, it might indicate that a specific fan cools a specific processor.
      @odata.id string
(URI)
read-only The unique identifier for a resource.
} ]

3.3 Payload annotations

Payload annotations enable a Service to provide additional information about a property or object. Redfish limits usage of these annotations to OData core terms, Redfish extensions, or Redfish messages.

3.3.1 Property-level annotations

A payload annotation for a single property takes the form of an additional property:

Property@Schema.Term


where

Variable Description
Property The JSON property being annotated.
Schema The schema file that contains the definition for the annotation.
Term The name of the annotation.

3.3.2 Properties

Property Type Attributes Notes
@Message.ExtendedInfo {} object The additional information for a set of message structures for a property. These messages can be useful when a property is null due to an error condition and the service wants to convey why the property is null.
@odata.count integer read-only The number of items in a collection.
@Redfish.AllowableValues [ ] array (string) read-only The string values that a service accepts for a property or action parameter.

In this example, the ResetType property is annotated with the AllowableValues term, which the Redfish schema defines. Redfish is an alias for RedfishExtensions. This code indicates to the client that the Service supports the On and ForceOff values for ResetType.

{
    "ResetType@Redfish.AllowableValues": [
        "On",
        "ForceOff"
    ]
}

3.3.3 Resource or object-level annotations

A payload annotation for an entire Resource or a JSON object takes the @Schema.Term form, where Namespace is the schema file where the definition is found and Term is the name of the Annotation. These payload annotations are used to provide further information about the object itself.

3.3.4 Properties

Property Type Attributes Notes
@Redfish.ActionInfo string
(URI)
read-only The URI to an ActionInfo Resource, which describes the parameters that this Action instance supports.
@Redfish.CollectionCapabilities {} object The reference to the Resource that represents the POST capabilities of a collection. For property details, see CollectionCapabilities.
@Redfish.MaintenanceWindow {} object The maintenance window configuration that defines when to apply settings or operations to a Resource. For property details, see MaintenanceWindow.
@Redfish.OperationApplyTime string
(enum)
read-write The client's requested apply time to complete a create, delete, or action operation. For the possible property values, see @Redfish.OperationApplyTime in Property details.
@Redfish.OperationApplyTimeSupport {} object An indication of whether a client can request a specific apply time for a create, delete, or action operation for a Resource through the OperationApplyTime term. For property details, see OperationApplyTimeSupport.
@Redfish.Settings {} object The reference to the Resource that represents the settings to apply to this object. For property details, see Settings.
@Redfish.SettingsApplyTime {} object The configuration settings that define when to apply the settings to a Resource. For property details, see PreferredApplyTime.

3.3.5 Property details

3.3.5.1 @Redfish.OperationApplyTime:

The client's requested apply time to complete a create, delete, or action operation.

string Description
AtMaintenanceWindowStart The requested operation is applied within the administrator-specified maintenance window.
Immediate The requested operation is applied immediately.
InMaintenanceWindowOnReset The requested operation is applied after a reset but within the administrator-specified maintenance window.
OnReset The requested operation is applied on a reset.
OnStartUpdateRequest The requested operation is applied when the StartUpdate action of the update service is invoked.

This example annotates the object with the Redfish schema-defined ActionInfo term. Redfish is an alias for RedfishExtensions. This term indicates that the client can find more information about the #ComputerSystem.Reset action at the /redfish/v1/Systems/1/ResetActionInfo URI:

{
    "#ComputerSystem.Reset": {
        "target": "/redfish/v1/Systems/1/Actions/ComputerSystem.Reset",
        "@Redfish.ActionInfo": "/redfish/v1/Systems/1/ResetActionInfo"
    }
}

4 Common objects

Redfish schemas frequently define the following JSON objects. Like the individual common properties listed above, these objects share a common definition that is shown here to avoid repetition in the Reference Guide property tables.

4.1 Actions

The Actions object contains descriptions of the defined and available actions for this Resource.

4.1.1 Properties

Property Type Attributes Notes
#{action name} { object A single Redfish action.
      @Redfish.ActionInfo string read-only The URI for an ActionInfo Resource that describes this action.
      target string read-only The target URI for the POST operation to invoke the action.
}

4.2 Capacity

4.2.1 Description

This is the schema definition for the Capacity of a device. It represents the properties for capacity for any data store.

4.2.2 Properties

Property Type Attributes Notes
Data { object The capacity information relating to the user data.
      AllocatedBytes integer
(bytes)
read-write
(null)
The number of bytes currently allocated by the storage system in this data store for this data type.
      ConsumedBytes integer
(bytes)
read-only
(null)
The number of bytes consumed in this data store for this data type.
      GuaranteedBytes integer
(bytes)
read-write
(null)
The number of bytes the storage system guarantees can be allocated in this data store for this data type.
      ProvisionedBytes integer
(bytes)
read-write
(null)
The maximum number of bytes that can be allocated in this data store for this data type.
}
IsThinProvisioned boolean read-only
(null)
Marks that the capacity is not necessarily fully allocated.
Metadata { object The capacity information relating to metadata.
      AllocatedBytes integer
(bytes)
read-write
(null)
The number of bytes currently allocated by the storage system in this data store for this data type.
      ConsumedBytes integer
(bytes)
read-only
(null)
The number of bytes consumed in this data store for this data type.
      GuaranteedBytes integer
(bytes)
read-write
(null)
The number of bytes the storage system guarantees can be allocated in this data store for this data type.
      ProvisionedBytes integer
(bytes)
read-write
(null)
The maximum number of bytes that can be allocated in this data store for this data type.
}
Snapshot { object The capacity information relating to snapshot or backup data.
      AllocatedBytes integer
(bytes)
read-write
(null)
The number of bytes currently allocated by the storage system in this data store for this data type.
      ConsumedBytes integer
(bytes)
read-only
(null)
The number of bytes consumed in this data store for this data type.
      GuaranteedBytes integer
(bytes)
read-write
(null)
The number of bytes the storage system guarantees can be allocated in this data store for this data type.
      ProvisionedBytes integer
(bytes)
read-write
(null)
The maximum number of bytes that can be allocated in this data store for this data type.
}

4.3 Condition

4.3.1 Description

A condition that requires attention.

4.3.2 Properties

Property Type Attributes Notes
LogEntry { object The link to the log entry created for this condition. See the LogEntry schema for details on this property.
      @odata.id string read-only Link to a LogEntry resource. See the Links section and the LogEntry schema for details.
}
Message string read-only The human-readable message for this condition.
MessageArgs [ ] array (string) read-only An array of message arguments that are substituted for the arguments in the message when looked up in the message registry.
MessageId string read-only required The identifier for the message.
OriginOfCondition { object A link to the resource or object that originated the condition.
      @odata.id string
(URI)
read-only The unique identifier for a resource.
}
Resolution (v1.14+) string read-only Suggestions on how to resolve the condition.
Severity string
(enum)
read-only The severity of the condition. For the possible property values, see Severity in Property details.
Timestamp string
(date-time)
read-only The time the condition occurred.

4.3.3 Property details

4.3.3.1 Severity:

The severity of the condition.

string Description
Critical A critical condition requires immediate attention.
OK Normal.
Warning A condition requires attention.

4.4 Identifier

4.4.1 Description

Any additional identifiers for a resource.

4.4.2 Properties

Property Type Attributes Notes
DurableName (v1.1+) string read-only
(null)
The world-wide, persistent name of the resource.
DurableNameFormat (v1.1+) string
(enum)
read-only
(null)
The format of the durable name property. For the possible property values, see DurableNameFormat in Property details.

4.4.3 Property details

4.4.3.1 DurableNameFormat:

The format of the durable name property.

string Description
EUI The IEEE-defined 64-bit Extended Unique Identifier (EUI).
FC_WWN The Fibre Channel (FC) World Wide Name (WWN).
iQN The iSCSI Qualified Name (iQN).
MACAddress (v1.14+) The media access control address (MAC address).
NAA The Name Address Authority (NAA) format.
NGUID (v1.10+) The Namespace Globally Unique Identifier (NGUID).
NQN (v1.6+) The NVMe Qualified Name (NQN).
NSID (v1.6+, deprecated v1.12) The NVM Namespace Identifier (NSID). Deprecated in v1.12 and later. This value has been deprecated due to its non-uniqueness and NGUID should be used.
UUID The Universally Unique Identifier (UUID).

4.5 IOStatistics

4.5.1 Description

The properties of this type represent IO statistics.

4.5.2 Properties

Property Type Attributes Notes
NonIORequests integer
({tot})
read-write
(null)
Count of non IO requests.
NonIORequestTime string read-write
(null)
The time that the resource is busy processing write requests.
ReadHitIORequests integer
({tot})
read-write
(null)
Count of read IO requests satisfied from memory.
ReadIOKiBytes integer
(KiBy)
read-write
(null)
Number of kibibytes read.
ReadIORequests integer
({tot})
read-write
(null)
Count of read IO requests.
ReadIORequestTime string read-write
(null)
The time that the resource is busy processing read requests.
WriteHitIORequests integer
({tot})
read-write
(null)
Count of write IO requests coalesced into memory.
WriteIOKiBytes integer
(KiBy)
read-write
(null)
Number of kibibytes written.
WriteIORequests integer
({tot})
read-write
(null)
Count of write IO requests.
WriteIORequestTime string read-write
(null)
The time that the resource is busy processing write requests.

4.6 IPv4Address

4.6.1 Description

This type describes an IPv4 address.

4.6.2 Properties

Property Type Attributes Notes
Address string read-write
(null)
The IPv4 address.
AddressOrigin string
(enum)
read-only
(null)
This indicates how the address was determined. For the possible property values, see AddressOrigin in Property details.
Gateway string read-write
(null)
The IPv4 gateway for this address.
Oem {} object See the Oem object definition in the Common properties section.
SubnetMask string read-write
(null)
The IPv4 subnet mask.

4.6.3 Property details

4.6.3.1 AddressOrigin:

This indicates how the address was determined.

string Description
BOOTP A BOOTP service-provided address.
DHCP A DHCPv4 service-provided address.
IPv4LinkLocal The address is valid for only this network segment, or link.
Static A user-configured static address.

4.7 IPv6Address

4.7.1 Description

This type describes an IPv6 address.

4.7.2 Properties

Property Type Attributes Notes
Address string read-write
(null)
The IPv6 address.
AddressOrigin string
(enum)
read-only
(null)
This indicates how the address was determined. For the possible property values, see AddressOrigin in Property details.
AddressState string
(enum)
read-only
(null)
The current RFC4862-defined state of this address. For the possible property values, see AddressState in Property details.
Oem {} object See the Oem object definition in the Common properties section.
PrefixLength integer read-only
(null)
The IPv6 address prefix Length.

4.7.3 Property details

4.7.3.1 AddressOrigin:

This indicates how the address was determined.

string Description
DHCPv6 A DHCPv6 service-provided address.
LinkLocal The address is valid for only this network segment, or link.
SLAAC A stateless autoconfiguration (SLAAC) service-provided address.
Static A static user-configured address.

4.7.3.2 AddressState:

The current RFC4862-defined state of this address.

string Description
Deprecated This address is currently within its valid lifetime but is now outside its RFC4862-defined preferred lifetime.
Failed This address has failed Duplicate Address Detection (DAD) testing, as defined in RFC4862, section 5.4, and is not currently in use.
Preferred This address is currently within both its RFC4862-defined valid and preferred lifetimes.
Tentative This address is currently undergoing Duplicate Address Detection (DAD) testing, as defined in RFC4862, section 5.4.

4.8 IPv6GatewayStaticAddress

4.8.1 Description

This type represents a single IPv6 static address to be assigned on a network interface.

4.8.2 Properties

Property Type Attributes Notes
Address (v1.1+) string read-write required
(null)
A valid IPv6 address.
Oem (v1.1+) {} object See the Oem object definition in the Common properties section.
PrefixLength (v1.1+) integer read-write
(null)
The IPv6 network prefix length, in bits, for this address.

4.9 IPv6StaticAddress

4.9.1 Description

This type represents a single IPv6 static address to be assigned on a network interface.

4.9.2 Properties

Property Type Attributes Notes
Address string read-write required
(null)
A valid IPv6 address.
Oem {} object See the Oem object definition in the Common properties section.
PrefixLength integer read-write required
(null)
The prefix length, in bits, of this IPv6 address.

4.10 Location

4.10.1 Description

The location of a resource.

4.10.2 Properties

Property Type Attributes Notes
AltitudeMeters (v1.6+) number
(meters)
read-write
(null)
The altitude of the resource in meters.
Contacts (v1.7+) [ { array An array of contact information.
      ContactName (v1.7+) string read-write
(null)
Name of this contact.
      EmailAddress (v1.7+) string read-write
(null)
Email address for this contact.
      PhoneNumber (v1.7+) string read-write
(null)
Phone number for this contact.
} ]
Info (v1.1+, deprecated v1.5 string read-only
(null)
The location of the resource. Deprecated in v1.5 and later. This property has been deprecated in favor of the PostalAddress, Placement, and PartLocation properties.
InfoFormat (v1.1+, deprecated v1.5 string read-only
(null)
The format of the Info property. Deprecated in v1.5 and later. This property has been deprecated in favor of the PostalAddress, Placement, and PartLocation properties.
Latitude (v1.6+) number
(deg)
read-write
(null)
The latitude of the resource.
Longitude (v1.6+) number
(deg)
read-write
(null)
The longitude of the resource in degrees.
Oem (v1.1+) { object See the Oem object definition in the Common properties section.
      (pattern) {} object Property names follow regular expression pattern "^[A-Za-z0-9_]+$"
}
PartLocation (v1.5+) { object The part location for a resource within an enclosure.
      LocationOrdinalValue (v1.5+) integer read-only
(null)
The number that represents the location of the part. For example, if LocationType is Slot and this unit is in slot 2, the LocationOrdinalValue is 2.
      LocationType (v1.5+) string
(enum)
read-only
(null)
The type of location of the part. For the possible property values, see LocationType in Property details.
      Orientation (v1.5+) string
(enum)
read-only
(null)
The orientation for the ordering of the slot enumeration used by the LocationOrdinalValue property. For the possible property values, see Orientation in Property details.
      Reference (v1.5+) string
(enum)
read-only
(null)
The reference point for the part location. Provides guidance about the general location of the part. For the possible property values, see Reference in Property details.
      ServiceLabel (v1.5+) string read-only
(null)
The label of the part location, such as a silk-screened name or a printed label.
}
Placement (v1.3+) { object A place within the addressed location.
      AdditionalInfo (v1.7+) string read-write
(null)
Area designation or other additional info.
      Rack (v1.3+) string read-write
(null)
The name of a rack location within a row.
      RackOffset (v1.3+) integer read-write
(null)
The vertical location of the item, in terms of RackOffsetUnits.
      RackOffsetUnits (v1.3+) string
(enum)
read-write
(null)
The type of rack units in use. For the possible property values, see RackOffsetUnits in Property details.
      Row (v1.3+) string read-write
(null)
The name of the row.
}
PostalAddress (v1.3+) { object The postal address of the addressed resource.
      AdditionalCode (v1.3+) string read-write
(null)
The additional code.
      AdditionalInfo (v1.7+) string read-write
(null)
The room designation or other additional information.
      Building (v1.3+) string read-write
(null)
The name of the building.
      City (v1.3+) string read-write
(null)
City, township, or shi (JP).
      Community (v1.3+) string read-write
(null)
The postal community name.
      Country (v1.3+) string read-write
(null)
The country.
      District (v1.3+) string read-write
(null)
A county, parish, gun (JP), or district (IN).
      Division (v1.3+) string read-write
(null)
City division, borough, city district, ward, or chou (JP).
      Floor (v1.3+) string read-write
(null)
The floor.
      GPSCoords (v1.3+, deprecated v1.6 string read-write
(null)
The GPS coordinates of the part. Deprecated in v1.6 and later. This property has been deprecated in favor of the Longitude and Latitude properties.
      HouseNumber (v1.3+) integer read-write
(null)
The numeric portion of house number.
      HouseNumberSuffix (v1.3+) string read-write
(null)
The house number suffix.
      Landmark (v1.3+) string read-write
(null)
The landmark.
      LeadingStreetDirection (v1.3+) string read-write
(null)
A leading street direction.
      Location (v1.3+, deprecated v1.7 string read-write
(null)
The room designation or other additional information. Deprecated in v1.7 and later. This property has been deprecated in favor of the AdditionalInfo property.
      Name (v1.3+) string read-write
(null)
The name.
      Neighborhood (v1.3+) string read-write
(null)
Neighborhood or block.
      PlaceType (v1.3+) string read-write
(null)
The description of the type of place that is addressed.
      POBox (v1.3+) string read-write
(null)
The post office box (PO box).
      PostalCode (v1.3+) string read-write
(null)
The postal code or zip code.
      Road (v1.3+) string read-write
(null)
The primary road or street.
      RoadBranch (v1.3+) string read-write
(null)
The road branch.
      RoadPostModifier (v1.3+) string read-write
(null)
The road post-modifier.
      RoadPreModifier (v1.3+) string read-write
(null)
The road pre-modifier.
      RoadSection (v1.3+) string read-write
(null)
The road section.
      RoadSubBranch (v1.3+) string read-write
(null)
The road sub branch.
      Room (v1.3+) string read-write
(null)
The name or number of the room.
      Seat (v1.3+) string read-write
(null)
The seat, such as the desk, cubicle, or workstation.
      Street (v1.3+) string read-write
(null)
Street name.
      StreetSuffix (v1.3+) string read-write
(null)
Avenue, Platz, Street, Circle.
      Territory (v1.3+) string read-write
(null)
A top-level subdivision within a country.
      TrailingStreetSuffix (v1.3+) string read-write
(null)
A trailing street suffix.
      Unit (v1.3+) string read-write
(null)
The name or number of the apartment unit or suite.
}

4.10.3 Property details

4.10.3.1 LocationType:

The type of location of the part.

string Description
Backplane (v1.12+) A backplane.
Bay A bay.
Connector A connector or port.
Embedded (v1.13+) Embedded within a part.
Slot A slot.
Socket A socket.

4.10.3.2 Orientation:

The orientation for the ordering of the slot enumeration used by the LocationOrdinalValue property.

string Description
BackToFront The ordering for the LocationOrdinalValue is back to front.
BottomToTop The ordering for LocationOrdinalValue is bottom to top.
FrontToBack The ordering for LocationOrdinalValue is front to back.
LeftToRight The ordering for the LocationOrdinalValue is left to right.
RightToLeft The ordering for the LocationOrdinalValue is right to left.
TopToBottom The ordering for the LocationOrdinalValue is top to bottom.

4.10.3.3 RackOffsetUnits:

The type of rack units in use.

string Description
EIA_310 A rack unit that is equal to 1.75 in (44.45 mm).
OpenU A rack unit that is equal to 48 mm (1.89 in).

4.10.3.4 Reference:

The reference point for the part location. Provides guidance about the general location of the part.

string Description
Bottom The part is in the bottom of the unit.
Front The part is in the front of the unit.
Left The part is on the left side of of the unit.
Middle The part is in the middle of the unit.
Rear The part is in the rear of the unit.
Right The part is on the right side of the unit.
Top The part is in the top of the unit.

4.11 Message

4.11.1 Description

The message that the Redfish service returns.

4.11.2 Properties

Property Type Attributes Notes
Message string read-only The human-readable message.
MessageArgs [ ] array (string) read-only An array of message arguments that are substituted for the arguments in the message when looked up in the message registry.
MessageId string read-only required The identifier for the message.
MessageSeverity (v1.1+) string
(enum)
read-only The severity of the message. For the possible property values, see MessageSeverity in Property details.
Oem {} object See the Oem object definition in the Common properties section.
RelatedProperties [ ] array (string) read-only A set of properties described by the message.
Resolution string read-only Used to provide suggestions on how to resolve the situation that caused the message.
Severity (deprecated v1.1) string read-only The severity of the message. Deprecated in v1.1 and later. This property has been deprecated in favor of MessageSeverity, which ties the values to the enumerations defined for the Health property within Status.

4.11.3 Property details

4.11.3.1 MessageSeverity:

The severity of the message.

string Description
Critical A critical condition requires immediate attention.
OK Normal.
Warning A condition requires attention.

4.12 Redundancy

4.12.1 Description

The common redundancy definition and structure used in other Redfish schemas.

4.12.2 Properties

Property Type Attributes Notes
@odata.id string
(URI)
read-only required The unique identifier for a resource.
Actions (v1.2+) {} object The available actions for this resource.
MaxNumSupported integer read-only
(null)
The maximum number of members allowable for this particular redundancy group.
MemberId string read-only required The identifier for the member within the collection.
MinNumNeeded integer read-only required
(null)
The minimum number of members needed for this group to be redundant.
Mode string
(enum)
read-write required
(null)
The redundancy mode of the group. For the possible property values, see Mode in Property details.
Name string read-only required The name of the resource or array member.
Oem {} object See the Oem object definition in the Common properties section.
RedundancyEnabled (v1.1+) boolean read-write
(null)
An indication of whether redundancy is enabled.
RedundancySet [ { array * required* The links to components of this redundancy set.
      @odata.id string
(URI)
read-only The unique identifier for a resource.
} ]
Status {} object * required* The status and health of the resource and its subordinate or dependent resources. For property details, see Status.

4.12.3 Property details

4.12.3.1 Mode:

The redundancy mode of the group.

string Description
Failover Failure of one unit automatically causes a standby or offline unit in the redundancy set to take over its functions.
N+m Multiple units are available and active such that normal operation will continue if one or more units fail.
NotRedundant (v1.3+) The subsystem is not configured in a redundancy mode, either due to configuration or the functionality has been disabled by the user.
Sharing Multiple units contribute or share such that operation will continue, but at a reduced capacity, if one or more units fail.
Sparing One or more spare units are available to take over the function of a failed unit, but takeover is not automatic.

4.13 RedundantGroup

4.13.1 Description

The redundancy information for the devices in a redundancy group.

4.13.2 Properties

Property Type Attributes Notes
MaxSupportedInGroup (v1.4+) integer read-only
(null)
The maximum number of devices supported in this redundancy group.
MinNeededInGroup (v1.4+) integer read-only required
(null)
The minimum number of devices needed for this group to be redundant.
RedundancyGroup (v1.4+) [ { array * required* The links to the devices included in this redundancy group.
      @odata.id string
(URI)
read-only The unique identifier for a resource.
} ]
RedundancyType (v1.4+) string
(enum)
read-only required
(null)
The redundancy mode of the group. For the possible property values, see RedundancyType in Property details.
Status (v1.4+) {} object * required* The status and health of the resource and its subordinate or dependent resources. For property details, see Status.

4.13.3 Property details

4.13.3.1 RedundancyType:

The redundancy mode of the group.

string Description
Failover Failure of one unit automatically causes a standby or offline unit in the redundancy set to take over its functions.
NotRedundant The subsystem is not configured in a redundancy mode, either due to configuration or the functionality has been disabled by the user.
NPlusM Multiple units are available and active such that normal operation will continue if one or more units fail.
Sharing Multiple units contribute or share such that operation will continue, but at a reduced capacity, if one or more units fail.
Sparing One or more spare units are available to take over the function of a failed unit, but takeover is not automatic.

4.14 ReplicaInfo

4.14.1 Description

Defines the characteristics of a replica of a source.

4.14.2 Properties

Property Type Attributes Notes
ConsistencyEnabled boolean read-only
(null)
True if consistency is enabled.
ConsistencyState string
(enum)
read-only
(null)
The current state of consistency. For the possible property values, see ConsistencyState in Property details.
ConsistencyStatus string
(enum)
read-only
(null)
The current status of consistency. For the possible property values, see ConsistencyStatus in Property details.
ConsistencyType string
(enum)
read-only
(null)
Indicates the consistency type used by the source and its associated target group. For the possible property values, see ConsistencyType in Property details.
DataProtectionLineOfService (v1.1+) { object A pointer to the DataProtection line of service element that describes this replica.
      @odata.id string
(URI)
read-only The unique identifier for a resource.
}
FailedCopyStopsHostIO boolean read-only
(null)
If true, the storage array tells host to stop sending data to source element if copying to a remote element fails.
PercentSynced integer
(%)
read-only
(null)
Specifies the percent of the work completed to reach synchronization.
Replica { object Deprecated - Use Source Replica. The resource that is the source of this replica.
      @odata.id string
(URI)
read-only The unique identifier for a resource.
}
ReplicaFaultDomain (v1.3+) string
(enum)
read-only
(null)
ReplicaFaultDomain describes the fault domain (local or remote) of the replica relationship. For the possible property values, see ReplicaFaultDomain in Property details.
ReplicaPriority string
(enum)
read-only
(null)
The priority of background copy engine I/O to be managed relative to host I/O operations during a sequential background copy operation. For the possible property values, see ReplicaPriority in Property details.
ReplicaProgressStatus string
(enum)
read-only
(null)
The status of the session with respect to Replication activity. For the possible property values, see ReplicaProgressStatus in Property details.
ReplicaReadOnlyAccess string
(enum)
read-only
(null)
This property specifies whether the source, the target, or both elements are read only to the host. For the possible property values, see ReplicaReadOnlyAccess in Property details.
ReplicaRecoveryMode string
(enum)
read-only
(null)
Describes whether the copy operation continues after a broken link is restored. For the possible property values, see ReplicaRecoveryMode in Property details.
ReplicaRole string
(enum)
read-only
(null)
The source or target role of this replica. For the possible property values, see ReplicaRole in Property details.
ReplicaSkewBytes integer
(bytes)
read-only
(null)
Applies to Adaptive mode and it describes maximum number of bytes the SyncedElement (target) can be out of sync.
ReplicaState string
(enum)
read-only
(null)
ReplicaState describes the state of the relationship with respect to Replication activity. For the possible property values, see ReplicaState in Property details.
ReplicaType string
(enum)
read-only
(null)
ReplicaType describes the intended outcome of the replication. For the possible property values, see ReplicaType in Property details.
ReplicaUpdateMode string
(enum)
read-only
(null)
Describes whether the target elements will be updated synchronously or asynchronously. For the possible property values, see ReplicaUpdateMode in Property details.
RequestedReplicaState string
(enum)
read-only
(null)
The last requested or desired state for the relationship. For the possible property values, see RequestedReplicaState in Property details.
SourceReplica (v1.2+) { object The resource that is the source of this replica.
      @odata.id string
(URI)
read-only The unique identifier for a resource.
}
SyncMaintained boolean read-only
(null)
Synchronization is maintained.
UndiscoveredElement string
(enum)
read-only
(null)
This property specifies whether the source, the target, or both elements involved in a copy operation are undiscovered. For the possible property values, see UndiscoveredElement in Property details.
WhenActivated string
(%)
read-only
(null)
Specifies when point-in-time copy was taken or when the replication relationship is activated, reactivated, resumed or re-established.
WhenDeactivated string
(%)
read-only
(null)
Specifies when the replication relationship is deactivated.
WhenEstablished string
(%)
read-only
(null)
Specifies when the replication relationship is established.
WhenSuspended string
(%)
read-only
(null)
Specifies when the replication relationship is suspended.
WhenSynced string read-only
(null)
The point in time that the Elements were synchronized.
WhenSynchronized string
(%)
read-only
(null)
Specifies when the replication relationship is synchronized.

4.14.3 Property details

4.14.3.1 ConsistencyState:

The current state of consistency.

string Description
Consistent Consistent.
Inconsistent Not consistent.

4.14.3.2 ConsistencyStatus:

The current status of consistency.

string Description
Consistent Consistent.
Disabled Consistency disabled.
InError Consistency error.
InProgress Becoming consistent.

4.14.3.3 ConsistencyType:

Indicates the consistency type used by the source and its associated target group.

string Description
SequentiallyConsistent Sequentially consistent.

4.14.3.4 ReplicaFaultDomain:

ReplicaFaultDomain describes the fault domain (local or remote) of the replica relationship.

string Description
Local Local indicates that the source and target replicas are contained within a single fault domain.
Remote Remote indicates that the source and target replicas are in separate fault domains.

4.14.3.5 ReplicaPriority:

The priority of background copy engine I/O to be managed relative to host I/O operations during a sequential background copy operation.

string Description
High Copy engine I/O has higher priority than host I/O.
Low Copy engine I/O lower priority than host I/O.
Same Copy engine I/O has the same priority as host I/O.
Urgent Copy operation to be performed as soon as possible, regardless of the host I/O requests.

4.14.3.6 ReplicaProgressStatus:

The status of the session with respect to Replication activity.

string Description
Aborting Abort in progress.
Completed The request is completed. Data flow is idle.
Detaching Detach in progress.
Dormant Indicates that the data flow is inactive, suspended or quiesced.
FailingBack Undoing the result of failover.
FailingOver In the process of switching source and target.
Fracturing Fracture in progress.
Initializing In the process of establishing source/replica relationship and the data flow has not started.
Mixed Applies to groups with element pairs with different statuses. Generally, the individual statuses need to be examined.
Pending The flow of data has stopped momentarily due to limited bandwidth or a busy system.
Preparing Preparation in progress.
RequiresActivate The requested operation has completed, however, the synchronization relationship needs to be activated before further copy operations can be issued.
RequiresDetach The requested operation has completed, however, the synchronization relationship needs to be detached before further copy operations can be issued.
RequiresFracture The requested operation has completed, however, the synchronization relationship needs to be fractured before further copy operations can be issued.
RequiresResume The requested operation has completed, however, the synchronization relationship needs to be resumed before further copy operations can be issued.
RequiresResync The requested operation has completed, however, the synchronization relationship needs to be resynced before further copy operations can be issued.
RequiresSplit The requested operation has completed, however, the synchronization relationship needs to be split before further copy operations can be issued.
Restoring Restore in progress.
Resyncing Resync in progress.
Splitting Split in progress.
Suspending The copy operation is in the process of being suspended.
Synchronizing Sync in progress.
Terminating The relationship is in the process of terminating.

4.14.3.7 ReplicaReadOnlyAccess:

This property specifies whether the source, the target, or both elements are read only to the host.

string Description
Both Both the source and the target elements are read only to the host.
ReplicaElement The replica element.
SourceElement The source element.

4.14.3.8 ReplicaRecoveryMode:

Describes whether the copy operation continues after a broken link is restored.

string Description
Automatic Copy operation resumes automatically.
Manual ReplicaState is set to Suspended after the link is restored. It is required to issue the Resume operation to continue.

4.14.3.9 ReplicaRole:

The source or target role of this replica.

string Description
Source The source element.
Target The target element.

4.14.3.10 ReplicaState:

ReplicaState describes the state of the relationship with respect to Replication activity.

string Description
Aborted The copy operation is aborted with the Abort operation. Use the Resync Replica operation to restart the copy operation.
Broken The relationship is non-functional due to errors in the source, the target, the path between the two or space constraints.
Failedover Reads and writes are sent to the target element. Source element is not reachable.
Fractured Target is split from the source.
Inactive Data flow has stopped, writes to source element will not be sent to target element.
Initialized The link to enable replication is established and source/replica elements are associated, but the data flow has not started.
Invalid The array is unable to determine the state of the replication relationship, for example, after the connection is restored; however, either source or target elements have an unknown status.
Mixed Applies to the ReplicaState of GroupSynchronized. It indicates the StorageSynchronized relationships of the elements in the groups have different ReplicaState values.
Partitioned State of replication relationship can not be determined, for example, due to a connection problem.
Prepared Initialization is completed, however, the data flow has not started.
Restored It indicates the source element was restored from the target element.
Skewed The target has been modified and is no longer synchronized with the source element or the point-in-time view.
Split The target element was gracefully (or systematically) split from its source element -- consistency is guaranteed.
Suspended Data flow between the source and target elements has stopped. Writes to source element are held until the relationship is Resumed.
Synchronized For the Mirror, Snapshot, or Clone replication, the target represents a copy of the source.
Unsynchronized Not all the source element data has been copied to the target element.

4.14.3.11 ReplicaType:

ReplicaType describes the intended outcome of the replication.

string Description
Clone Create a point in time, full copy the source.
Mirror Create and maintain a copy of the source.
Snapshot Create a point in time, virtual copy of the source.
TokenizedClone Create a token based clone.

4.14.3.12 ReplicaUpdateMode:

Describes whether the target elements will be updated synchronously or asynchronously.

string Description
Active Active-Active (i.e. bidirectional) synchronous updates.
Adaptive Allows implementation to switch between synchronous and asynchronous modes.
Asynchronous Asynchronous updates.
Synchronous Synchronous updates.

4.14.3.13 RequestedReplicaState:

The last requested or desired state for the relationship.

string Description
Aborted The copy operation is aborted with the Abort operation. Use the Resync Replica operation to restart the copy operation.
Broken The relationship is non-functional due to errors in the source, the target, the path between the two or space constraints.
Failedover Reads and writes are sent to the target element. Source element is not reachable.
Fractured Target is split from the source.
Inactive Data flow has stopped, writes to source element will not be sent to target element.
Initialized The link to enable replication is established and source/replica elements are associated, but the data flow has not started.
Invalid The array is unable to determine the state of the replication relationship, for example, after the connection is restored; however, either source or target elements have an unknown status.
Mixed Applies to the ReplicaState of GroupSynchronized. It indicates the StorageSynchronized relationships of the elements in the groups have different ReplicaState values.
Partitioned State of replication relationship can not be determined, for example, due to a connection problem.
Prepared Initialization is completed, however, the data flow has not started.
Restored It indicates the source element was restored from the target element.
Skewed The target has been modified and is no longer synchronized with the source element or the point-in-time view.
Split The target element was gracefully (or systematically) split from its source element -- consistency is guaranteed.
Suspended Data flow between the source and target elements has stopped. Writes to source element are held until the relationship is Resumed.
Synchronized For the Mirror, Snapshot, or Clone replication, the target represents a copy of the source.
Unsynchronized Not all the source element data has been copied to the target element.

4.14.3.14 UndiscoveredElement:

This property specifies whether the source, the target, or both elements involved in a copy operation are undiscovered.

string Description
ReplicaElement The replica element is undiscovered.
SourceElement The source element is undiscovered.

4.15 Schedule

4.15.1 Description

Schedule a series of occurrences.

4.15.2 Properties

Property Type Attributes Notes
EnabledDaysOfMonth [ ] array (integer, null) read-write Days of the month when scheduled occurrences are enabled. 0 indicates that every day of the month is enabled.
EnabledDaysOfWeek [ ] array (string
(enum))
read-write
(null)
Days of the week when scheduled occurrences are enabled, for enabled days of the month and months of the year. If not present, all days of the week are enabled. For the possible property values, see EnabledDaysOfWeek in Property details.
EnabledIntervals (v1.1+) [ ] array (string, null) read-write Intervals when scheduled occurrences are enabled.
EnabledMonthsOfYear [ ] array (string
(enum))
read-write
(null)
The months of the year when scheduled occurrences are enabled. If not present, all months of the year are enabled. For the possible property values, see EnabledMonthsOfYear in Property details.
InitialStartTime string
(date-time)
read-write
(null)
The date and time when the initial occurrence is scheduled to occur.
Lifetime string read-write
(null)
The time after provisioning when the schedule as a whole expires.
MaxOccurrences integer read-write
(null)
The maximum number of scheduled occurrences.
Name string read-write
(null)
The schedule name.
RecurrenceInterval string read-write
(null)
The amount of time until the next occurrence occurs.

4.15.3 Property details

4.15.3.1 EnabledDaysOfWeek:

Days of the week when scheduled occurrences are enabled, for enabled days of the month and months of the year. If not present, all days of the week are enabled.

string Description
Every Every day of the week.
Friday Friday.
Monday Monday.
Saturday Saturday.
Sunday Sunday.
Thursday Thursday.
Tuesday Tuesday.
Wednesday Wednesday.

4.15.3.2 EnabledMonthsOfYear:

The months of the year when scheduled occurrences are enabled. If not present, all months of the year are enabled.

string Description
April April.
August August.
December December.
Every Every month of the year.
February February.
January January.
July July.
June June.
March March.
May May.
November November.
October October.
September September.

4.16 Status

4.16.1 Description

The status and health of a resource and its children.

4.16.2 Properties

Property Type Attributes Notes
Conditions (v1.11+) [ { array Conditions in this resource that require attention.
      LogEntry { object The link to the log entry created for this condition. See the LogEntry schema for details on this property.
            @odata.id string read-only Link to a LogEntry resource. See the Links section and the LogEntry schema for details.
      }
      Message string read-only The human-readable message for this condition.
      MessageArgs [ ] array (string) read-only An array of message arguments that are substituted for the arguments in the message when looked up in the message registry.
      MessageId string read-only required The identifier for the message.
      OriginOfCondition { object A link to the resource or object that originated the condition.
            @odata.id string
(URI)
read-only The unique identifier for a resource.
      }
      Resolution (v1.14+) string read-only Suggestions on how to resolve the condition.
      Severity string
(enum)
read-only The severity of the condition. For the possible property values, see Severity in Property details.
      Timestamp string
(date-time)
read-only The time the condition occurred.
} ]
Health string
(enum)
read-only
(null)
The health state of this resource in the absence of its dependent resources. For the possible property values, see Health in Property details.
HealthRollup string
(enum)
read-only
(null)
The overall health state from the view of this resource. For the possible property values, see HealthRollup in Property details.
Oem { object See the Oem object definition in the Common properties section.
      (pattern) {} object Property names follow regular expression pattern "^[A-Za-z0-9_]+$"
}
State string
(enum)
read-only
(null)
The known state of the resource, such as, enabled. For the possible property values, see State in Property details.

4.16.3 Property details

4.16.3.1 Health:

The health state of this resource in the absence of its dependent resources.

string Description
Critical A critical condition requires immediate attention.
OK Normal.
Warning A condition requires attention.

4.16.3.2 HealthRollup:

The overall health state from the view of this resource.

string Description
Critical A critical condition requires immediate attention.
OK Normal.
Warning A condition requires attention.

4.16.3.3 Severity:

The severity of the condition.

string Description
Critical A critical condition requires immediate attention.
OK Normal.
Warning A condition requires attention.

4.16.3.4 State:

The known state of the resource, such as, enabled.

string Description
Absent This function or resource is either not present or detected.
Deferring (v1.2+) The element does not process any commands but queues new requests.
Disabled This function or resource is disabled.
Enabled This function or resource is enabled.
InTest This function or resource is undergoing testing, or is in the process of capturing information for debugging.
Qualified (v1.9+) The element quality is within the acceptable range of operation.
Quiesced (v1.2+) The element is enabled but only processes a restricted set of commands.
StandbyOffline This function or resource is enabled but awaits an external action to activate it.
StandbySpare This function or resource is part of a redundancy set and awaits a failover or other external action to activate it.
Starting This function or resource is starting.
UnavailableOffline (v1.1+) This function or resource is present but cannot be used.
Updating (v1.2+) The element is updating and might be unavailable or degraded.

5 Resource collections

A core concept in Redfish is a collection of Resources. A collection is a group of like Resources where the number of instances in the group can shrink or grow depending on the scope of the Redfish Service or the configuration of the devices being managed. Every Resource in a collection has the same set of supported properties, and all contain Collection in the name of their schema. Every Resource linked in the Members array within a Resource Collection have the same Resource type, or the same schema with the same major version, but can vary in minor or errata schema versions, which are all compatible.

The properties of a Resource Collection are as follows:

5.0.1 Properties

Property Type Attributes Notes
@odata.context string
(URI)
read-only The OData description of a payload.
@odata.id string
(URI)
read-only required The unique identifier for a resource.
@odata.type string read-only required The type of a resource.
Description string read-only
(null)
The description of this resource. Used for commonality in the schema definitions.
Members [ { array * required* The members of this collection.
      @odata.id string
(URI)
read-only The link to a Resource instance, which is a member of this collection.
} ]
integer read-only The number of items in a collection.
string
(URI)
read-write
Name string read-only required The name of the resource or array member.
Oem {} object The manufacturer- or provider-specific extension moniker that divides the Oem object into sections.

As shown in the following example, a Redfish Service may provide management functionality for several Computer Systems, and therefore a ComputerSystemCollection Resource is provided. This example shows a Service with multiple ComputerSystem instances, or members.

{
    "@odata.type": "#ComputerSystemCollection.ComputerSystemCollection",
    "Name": "Computer System Collection",
    "Members@odata.count": 4,
    "Members": [{
            "@odata.id": "/redfish/v1/Systems/529QB9450R6"
        },
        {
            "@odata.id": "/redfish/v1/Systems/529QB9451R6"
        },
        {
            "@odata.id": "/redfish/v1/Systems/529QB9452R6"
        },
        {
            "@odata.id": "/redfish/v1/Systems/529QB9453R6"
        }
    ],
    "@odata.context": "/redfish/v1/$metadata#ComputerSystemCollection.ComputerSystemCollection",
    "@odata.id": "/redfish/v1/Systems"
}

5.1 Collection Capabilities annotation (#CollectionCapabilities)

This annotation is used to inform the client how to form the request body for a create (POST) operation to a given collection based on a specified use case, which will result in a new member being added to the given collection.

5.1.1 Properties

Property Type Attributes Notes
Capabilities [ { array The list of capabilities supported by this resource.
      CapabilitiesObject { object * required* The link to the resource the client can issue a GET request against to understand how to form a POST request for a collection.
            @odata.id string
(URI)
read-only The unique identifier for a resource.
      }
      Links { object * required* The links to other resources that are related to this resource.
            Oem {} object The OEM extension property. For property details, see Oem.
            RelatedItem [ { array An array of links to resources associated with this capability.
                  @odata.id string
(URI)
read-only The unique identifier for a resource.
            } ]
             integer read-only The number of items in a collection.
            TargetCollection { object * required* The link to the collection that this capabilities structure is describing.
                  @odata.id string
(URI)
read-only The unique identifier for a resource.
            }
      }
      UseCase string
(enum)
read-only required The use case in which a client can issue a POST request to the collection. For the possible property values, see UseCase in Property details.
} ]
MaxMembers (v1.2+) integer read-only The maximum number of members allowed in this collection.

5.1.2 Property details

5.1.2.1 UseCase:

The use case in which a client can issue a POST request to the collection.

string Description
ComputerSystemComposition This capability describes a client creating a new computer system resource from a set of disaggregated hardware.
ComputerSystemConstrainedComposition (v1.1+) This capability describes a client creating a new computer system resource from a set of constraints.
ResourceBlockComposition (v1.3+) This capability describes a client creating a new resource block from a set of other resource blocks.
ResourceBlockConstrainedComposition (v1.3+) This capability describes a client creating a new resource block from a set of constraints.
VolumeCreation This capability describes a client creating a new volume resource as part of an existing storage subsystem.

5.1.3 Example Collection Capabilities annotation

{
    "@Redfish.CollectionCapabilities": {
        "@odata.type": "#CollectionCapabilities.v1_1_0.CollectionCapabilities",
        "Capabilities": [
            {
                "CapabilitiesObject": {
                    "@odata.id": "/redfish/v1/Systems/Capabilities"
                },
                "UseCase": "ComputerSystemComposition",
                "Links": {
                    "TargetCollection": {
                        "@odata.id": "/redfish/v1/Systems"
                    }
                }
            },
            {
                "CapabilitiesObject": {
                    "@odata.id": "/redfish/v1/Systems/ConstrainedCompositionCapabilities"
                },
                "UseCase": "ComputerSystemConstrainedComposition",
                "Links": {
                    "TargetCollection": {
                        "@odata.id": "/redfish/v1/Systems"
                    }
                }
            }
        ]
    },
    ...
}

5.2 Resource collection URIs for Redfish v1.6 and later

The following table lists the Redfish-defined Resource Collections and the URIs where they can appear. NOTE: The URIs listed are valid for Redfish Services conforming to the Redfish Specification v1.6.0 or higher. Services built on earlier versions of the Specification may use different URIs. To discover these URIs, follow the links from the Service Root (/redfish/v1/).

Collection Type URIs
AccelerationFunctionCollection /​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Processors/​{ProcessorId}/​AccelerationFunctions
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Processors/​{ProcessorId}/​AccelerationFunctions
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Processors/​{ProcessorId}/​AccelerationFunctions
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Processors/​{ProcessorId}/​AccelerationFunctions
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Processors/​{ProcessorId}/​AccelerationFunctions
AddressPoolCollection /​redfish/​v1/​Fabrics/​{FabricId}/​AddressPools
AggregateCollection /​redfish/​v1/​AggregationService/​Aggregates
AggregationSourceCollection /​redfish/​v1/​AggregationService/​AggregationSources
AllowDenyCollection /​redfish/​v1/​Chassis/​{ChassisId}/​NetworkAdapters/​{NetworkAdapterId}/​NetworkDeviceFunctions/​{NetworkDeviceFunctionId}/​AllowDeny
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​NetworkInterfaces/​{NetworkInterfaceId}/​NetworkDeviceFunctions{NetworkDeviceFunctionId}/​AllowDeny
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​NetworkInterfaces/​{NetworkInterfaceId}/​NetworkDeviceFunctions{NetworkDeviceFunctionId}/​AllowDeny
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​NetworkInterfaces/​{NetworkInterfaceId}/​NetworkDeviceFunctions{NetworkDeviceFunctionId}/​AllowDeny
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​NetworkInterfaces/​{NetworkInterfaceId}/​NetworkDeviceFunctions{NetworkDeviceFunctionId}/​AllowDeny
/​redfish/​v1/​Systems/​{ComputerSystemId}/​NetworkInterfaces/​{NetworkInterfaceId}/​NetworkDeviceFunctions{NetworkDeviceFunctionId}/​AllowDeny
BatteryCollection /​redfish/​v1/​Chassis/​{ChassisId}/​PowerSubsystem/​Batteries
BootOptionCollection /​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​BootOptions
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​BootOptions
/​redfish/​v1/​Systems/​{ComputerSystemId}/​BootOptions
CableCollection /​redfish/​v1/​Cables
CertificateCollection /​redfish/​v1/​AccountService/​Accounts/​{ManagerAccountId}/​Certificates
/​redfish/​v1/​AccountService/​ActiveDirectory/​Certificates
/​redfish/​v1/​AccountService/​ExternalAccountProviders/​{ExternalAccountProviderId}/​Certificates
/​redfish/​v1/​AccountService/​LDAP/​Certificates
/​redfish/​v1/​Chassis/​{ChassisId}/​Certificates
/​redfish/​v1/​Chassis/​{ChassisId}/​Drives/​{DriveId}/​Certificates
/​redfish/​v1/​Chassis/​{ChassisId}/​Memory/​{MemoryId}/​Certificates
/​redfish/​v1/​Chassis/​{ChassisId}/​NetworkAdapters/​{NetworkAdapterId}/​Certificates
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Drives/​{DriveId}/​Certificates
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Memory/​{MemoryId}/​Certificates
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Processors/​{ProcessorId}/​Certificates
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​Controllers/​{StorageControllerId}/​Certificates
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​Drives/​{DriveId}/​Certificates
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​StorageControllers/​{StorageControllerId}/​Certificates
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Boot/​Certificates
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Certificates
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​KeyManagement/​KMIPCertificates
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Memory/​{MemoryId}/​Certificates
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Processors/​{ProcessorId}/​Certificates
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​SecureBoot/​SecureBootDatabases/​{DatabaseId}/​Certificates
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Controllers/​{StorageControllerId}/​Certificates
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Drives/​{DriveId}/​Certificates
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​StorageControllers/​{StorageControllerId}/​Certificates
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​VirtualMedia/​{VirtualMediaId}/​Certificates
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​VirtualMedia/​{VirtualMediaId}/​ClientCertificates
/​redfish/​v1/​EventService/​Subscriptions/​{EventDestinationId}/​Certificates
/​redfish/​v1/​EventService/​Subscriptions/​{EventDestinationId}/​ClientCertificates
/​redfish/​v1/​Fabrics/​{FabricId}/​Switches/​{SwitchId}/​Certificates
/​redfish/​v1/​Managers/​{ManagerId}/​Certificates
/​redfish/​v1/​Managers/​{ManagerId}/​NetworkProtocol/​HTTPS/​Certificates
/​redfish/​v1/​Managers/​{ManagerId}/​RemoteAccountService/​Accounts/​{ManagerAccountId}/​Certificates
/​redfish/​v1/​Managers/​{ManagerId}/​RemoteAccountService/​ActiveDirectory/​Certificates
/​redfish/​v1/​Managers/​{ManagerId}/​RemoteAccountService/​ExternalAccountProviders/​{ExternalAccountProviderId}/​Certificates
/​redfish/​v1/​Managers/​{ManagerId}/​RemoteAccountService/​LDAP/​Certificates
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Drives/​{DriveId}/​Certificates
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Memory/​{MemoryId}/​Certificates
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Processors/​{ProcessorId}/​Certificates
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​Controllers/​{StorageControllerId}/​Certificates
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​Drives/​{DriveId}/​Certificates
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​StorageControllers/​{StorageControllerId}/​Certificates
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Boot/​Certificates
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Certificates
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​KeyManagement/​KMIPCertificates
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Memory/​{MemoryId}/​Certificates
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Processors/​{ProcessorId}/​Certificates
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​SecureBoot/​SecureBootDatabases/​{DatabaseId}/​Certificates
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Controllers/​{StorageControllerId}/​Certificates
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Drives/​{DriveId}/​Certificates
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​StorageControllers/​{StorageControllerId}/​Certificates
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​VirtualMedia/​{VirtualMediaId}/​Certificates
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​VirtualMedia/​{VirtualMediaId}/​ClientCertificates
/​redfish/​v1/​Storage/​{StorageId}/​Controllers/​{StorageControllerId}/​Certificates
/​redfish/​v1/​Storage/​{StorageId}/​StorageControllers/​{StorageControllerId}/​Certificates
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Boot/​Certificates
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Certificates
/​redfish/​v1/​Systems/​{ComputerSystemId}/​KeyManagement/​KMIPCertificates
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Memory/​{MemoryId}/​Certificates
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Processors/​{ProcessorId}/​Certificates
/​redfish/​v1/​Systems/​{ComputerSystemId}/​SecureBoot/​SecureBootDatabases/​{DatabaseId}/​Certificates
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Controllers/​{StorageControllerId}/​Certificates
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Drives/​{DriveId}/​Certificates
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​StorageControllers/​{StorageControllerId}/​Certificates
/​redfish/​v1/​Systems/​{ComputerSystemId}/​VirtualMedia/​{VirtualMediaId}/​Certificates
/​redfish/​v1/​Systems/​{ComputerSystemId}/​VirtualMedia/​{VirtualMediaId}/​ClientCertificates
/​redfish/​v1/​UpdateService/​ClientCertificates
/​redfish/​v1/​UpdateService/​RemoteServerCertificates
ChassisCollection /​redfish/​v1/​Chassis
CircuitCollection /​redfish/​v1/​PowerEquipment/​ElectricalBuses/​{PowerDistributionId}/​Branches
/​redfish/​v1/​PowerEquipment/​ElectricalBuses/​{PowerDistributionId}/​Mains
/​redfish/​v1/​PowerEquipment/​FloorPDUs/​{PowerDistributionId}/​Branches
/​redfish/​v1/​PowerEquipment/​FloorPDUs/​{PowerDistributionId}/​Mains
/​redfish/​v1/​PowerEquipment/​FloorPDUs/​{PowerDistributionId}/​Subfeeds
/​redfish/​v1/​PowerEquipment/​PowerShelves/​{PowerDistributionId}/​Branches
/​redfish/​v1/​PowerEquipment/​PowerShelves/​{PowerDistributionId}/​Mains
/​redfish/​v1/​PowerEquipment/​RackPDUs/​{PowerDistributionId}/​Branches
/​redfish/​v1/​PowerEquipment/​RackPDUs/​{PowerDistributionId}/​Mains
/​redfish/​v1/​PowerEquipment/​Switchgear/​{PowerDistributionId}/​Branches/​{CircuitId}
/​redfish/​v1/​PowerEquipment/​Switchgear/​{PowerDistributionId}/​Feeders/​{CircuitId}
/​redfish/​v1/​PowerEquipment/​Switchgear/​{PowerDistributionId}/​Mains/​{CircuitId}
/​redfish/​v1/​PowerEquipment/​Switchgear/​{PowerDistributionId}/​Subfeeds/​{CircuitId}
/​redfish/​v1/​PowerEquipment/​TransferSwitches/​{PowerDistributionId}/​Branches
/​redfish/​v1/​PowerEquipment/​TransferSwitches/​{PowerDistributionId}/​Feeders
/​redfish/​v1/​PowerEquipment/​TransferSwitches/​{PowerDistributionId}/​Mains
ComponentIntegrityCollection /​redfish/​v1/​ComponentIntegrity
CompositionReservationCollection /​redfish/​v1/​CompositionService/​CompositionReservations
ComputerSystemCollection /​redfish/​v1/​Systems
ConnectionCollection /​redfish/​v1/​Fabrics/​{FabricId}/​Connections
ConnectionMethodCollection /​redfish/​v1/​AggregationService/​ConnectionMethods
ControlCollection /​redfish/​v1/​Chassis/​{ChassisId}/​Controls
/​redfish/​v1/​PowerEquipment/​FloorPDUs/​{PowerDistributionId}/​Controls
/​redfish/​v1/​PowerEquipment/​PowerShelves/​{PowerDistributionId}/​Controls
/​redfish/​v1/​PowerEquipment/​RackPDUs/​{PowerDistributionId}/​Controls
/​redfish/​v1/​PowerEquipment/​Switchgear/​{PowerDistributionId}/​Controls
/​redfish/​v1/​PowerEquipment/​TransferSwitches/​{PowerDistributionId}/​Controls
DriveCollection /​redfish/​v1/​Chassis/​{ChassisId}/​Drives
/​redfish/​v1/​Storage/​{StorageId}/​FileSystems/​{FileSystemId}/​CapacitySources/​{CapacitySourceId}/​ProvidingDrives
/​redfish/​v1/​Storage/​{StorageId}/​StoragePools/​{StoragePoolId}/​CapacitySources/​{CapacitySourceId}/​ProvidingDrives
/​redfish/​v1/​Storage/​{StorageId}/​Volumes/​{VolumeId}/​CapacitySources/​{CapacitySourceId}/​ProvidingDrives
/​redfish/​v1/​StorageServices/​{StorageServiceId}/​Drives
/​redfish/​v1/​StorageServices/​{StorageServiceId}/​FileSystems/​{FileSystemId}/​CapacitySources/​{CapacitySourceId}/​ProvidingDrives
/​redfish/​v1/​StorageServices/​{StorageServiceId}/​StoragePools/​{StoragePoolId}/​CapacitySources/​{CapacitySourceId}/​ProvidingDrives
/​redfish/​v1/​StorageServices/​{StorageServiceId}/​Volumes/​{VolumeId}/​CapacitySources/​{CapacitySourceId}/​ProvidingDrives
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​FileSystems/​{FileSystemId}/​CapacitySources/​{CapacitySourceId}/​ProvidingDrives
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​StoragePools/​{StoragePoolId}/​CapacitySources/​{CapacitySourceId}/​ProvidingDrives
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Volumes/​{VolumeId}/​CapacitySources/​{CapacitySourceId}/​ProvidingDrives
EndpointCollection /​redfish/​v1/​Fabrics/​{FabricId}/​Endpoints
/​redfish/​v1/​Storage/​{StorageId}/​Endpoints
/​redfish/​v1/​StorageServices/​{StorageServiceId}/​Endpoints
EndpointGroupCollection /​redfish/​v1/​Fabrics/​{FabricId}/​EndpointGroups
/​redfish/​v1/​Storage/​{StorageId}/​EndpointGroups
/​redfish/​v1/​StorageServices/​{StorageServiceId}/​EndpointGroups
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​EndpointGroups
EthernetInterfaceCollection /​redfish/​v1/​Chassis/​{ChassisId}/​NetworkAdapters/​{NetworkAdaptersId}/​NetworkDeviceFunctions/​{NetworkDeviceFunctionId}/​EthernetInterfaces
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​EthernetInterfaces
/​redfish/​v1/​Managers/​{ManagerId}/​EthernetInterfaces
/​redfish/​v1/​Managers/​{ManagerId}/​HostInterfaces/​{HostInterfaceId}/​HostEthernetInterfaces
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​EthernetInterfaces
/​redfish/​v1/​Systems/​{ComputerSystemId}/​EthernetInterfaces
EventDestinationCollection /​redfish/​v1/​EventService/​Subscriptions
ExternalAccountProviderCollection /​redfish/​v1/​AccountService/​ExternalAccountProviders
/​redfish/​v1/​Managers/​{ManagerId}/​RemoteAccountService/​ExternalAccountProviders
FabricAdapterCollection /​redfish/​v1/​Systems/​{ComputerSystemId}/​FabricAdapters
FabricCollection /​redfish/​v1/​Fabrics
FacilityCollection /​redfish/​v1/​Facilities
FanCollection /​redfish/​v1/​Chassis/​{ChassisId}/​ThermalSubsystem/​Fans
GraphicsControllerCollection /​redfish/​v1/​Systems/​{ComputerSystemId}/​GraphicsControllers
HostInterfaceCollection /​redfish/​v1/​Managers/​{ManagerId}/​HostInterfaces
JobCollection /​redfish/​v1/​JobService/​Jobs
/​redfish/​v1/​JobService/​Jobs/​{JobId}/​Steps
JsonSchemaFileCollection /​redfish/​v1/​JsonSchemas
KeyCollection /​redfish/​v1/​KeyService/​NVMeoFSecrets
KeyPolicyCollection /​redfish/​v1/​KeyService/​NVMeoFKeyPolicies
LicenseCollection /​redfish/​v1/​LicenseService/​Licenses
LogEntryCollection /​redfish/​v1/​Chassis/​{ChassisId}/​LogServices/​{LogServiceId}/​Entries
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​LogServices/​{LogServiceId}/​Entries
/​redfish/​v1/​JobService/​Log/​Entries
/​redfish/​v1/​Managers/​{ManagerId}/​LogServices/​{LogServiceId}/​Entries
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​LogServices/​{LogServiceId}/​Entries
/​redfish/​v1/​Systems/​{ComputerSystemId}/​LogServices/​{LogServiceId}/​Entries
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Memory/​{MemoryId}/​DeviceLog/​Entries
/​redfish/​v1/​TelemetryService/​LogService/​Entries
LogServiceCollection /​redfish/​v1/​Chassis/​{ChassisId}/​LogServices
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​LogServices
/​redfish/​v1/​Managers/​{ManagerId}/​LogServices
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​LogServices
/​redfish/​v1/​Systems/​{ComputerSystemId}/​LogServices
ManagerAccountCollection /​redfish/​v1/​AccountService/​Accounts
/​redfish/​v1/​Managers/​{ManagerId}/​RemoteAccountService/​Accounts
ManagerCollection /​redfish/​v1/​Managers
MediaControllerCollection /​redfish/​v1/​Chassis/​{ChassisId}/​MediaControllers
MemoryChunksCollection /​redfish/​v1/​Chassis/​{ChassisId}/​MemoryDomains/​{MemoryDomainId}/​MemoryChunks
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​MemoryDomains/​{MemoryDomainId}/​MemoryChunks
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​MemoryDomains/​{MemoryDomainId}/​MemoryChunks
/​redfish/​v1/​Systems/​{ComputerSystemId}/​MemoryDomains/​{MemoryDomainId}/​MemoryChunks
MemoryCollection /​redfish/​v1/​Chassis/​{ChassisId}/​Memory
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Memory
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Memory
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Memory
MemoryDomainCollection /​redfish/​v1/​Chassis/​{ChassisId}/​MemoryDomains
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​MemoryDomains
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​MemoryDomains
/​redfish/​v1/​Systems/​{ComputerSystemId}/​MemoryDomains
MessageRegistryCollection
MessageRegistryFileCollection /​redfish/​v1/​Registries
MetricDefinitionCollection /​redfish/​v1/​TelemetryService/​MetricDefinitions
MetricReportCollection /​redfish/​v1/​TelemetryService/​MetricReports
MetricReportDefinitionCollection /​redfish/​v1/​TelemetryService/​MetricReportDefinitions
NetworkAdapterCollection /​redfish/​v1/​Chassis/​{ChassisId}/​NetworkAdapters
NetworkDeviceFunctionCollection /​redfish/​v1/​Chassis/​{ChassisId}/​NetworkAdapters/​{NetworkAdapterId}/​NetworkDeviceFunctions
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​NetworkInterfaces/​{NetworkInterfaceId}/​NetworkDeviceFunctions
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​NetworkInterfaces/​{NetworkInterfaceId}/​NetworkDeviceFunctions
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​NetworkInterfaces/​{NetworkInterfaceId}/​NetworkDeviceFunctions
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​NetworkInterfaces/​{NetworkInterfaceId}/​NetworkDeviceFunctions
/​redfish/​v1/​Systems/​{ComputerSystemId}/​NetworkInterfaces/​{NetworkInterfaceId}/​NetworkDeviceFunctions
NetworkInterfaceCollection /​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​NetworkInterfaces
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​NetworkInterfaces
/​redfish/​v1/​Systems/​{ComputerSystemId}/​NetworkInterfaces
NetworkPortCollection /​redfish/​v1/​Chassis/​{ChassisId}/​NetworkAdapters/​{NetworkAdapterId}/​NetworkPorts
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​NetworkInterfaces/​{NetworkInterfaceId}/​NetworkPorts
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​NetworkInterfaces/​{NetworkInterfaceId}/​NetworkPorts
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​NetworkInterfaces/​{NetworkInterfaceId}/​NetworkPorts
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​NetworkInterfaces/​{NetworkInterfaceId}/​NetworkPorts
/​redfish/​v1/​Systems/​{ComputerSystemId}/​NetworkInterfaces/​{NetworkInterfaceId}/​NetworkPorts
OperatingConfigCollection /​redfish/​v1/​Systems/​{ComputerSystemId}/​OperatingConfigs
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Processors/​{ProcessorId}/​OperatingConfigs
OutletCollection /​redfish/​v1/​PowerEquipment/​ElectricalBuses/​{PowerDistributionId}/​Outlets
/​redfish/​v1/​PowerEquipment/​PowerShelves/​{PowerDistributionId}/​Outlets
/​redfish/​v1/​PowerEquipment/​RackPDUs/​{PowerDistributionId}/​Outlets
/​redfish/​v1/​PowerEquipment/​TransferSwitches/​{PowerDistributionId}/​Outlets
OutletGroupCollection /​redfish/​v1/​PowerEquipment/​ElectricalBuses/​{PowerDistributionId}/​OutletGroups
/​redfish/​v1/​PowerEquipment/​PowerShelves/​{PowerDistributionId}/​OutletGroups
/​redfish/​v1/​PowerEquipment/​RackPDUs/​{PowerDistributionId}/​OutletGroups
/​redfish/​v1/​PowerEquipment/​TransferSwitches/​{PowerDistributionId}/​OutletGroups
PCIeDeviceCollection /​redfish/​v1/​Chassis/​{ChassisId}/​PCIeDevices
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​PCIeDevices
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​PCIeDevices
/​redfish/​v1/​Systems/​{ComputerSystemId}/​PCIeDevices
PCIeFunctionCollection /​redfish/​v1/​Chassis/​{ChassisId}/​PCIeDevices/​{PCIeDeviceId}/​PCIeFunctions
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​PCIeDevices/​{PCIeDeviceId}/​PCIeFunctions
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​PCIeDevices/​{PCIeDeviceId}/​PCIeFunctions
/​redfish/​v1/​Systems/​{ComputerSystemId}/​PCIeDevices/​{PCIeDeviceId}/​PCIeFunctions
PortCollection /​redfish/​v1/​Chassis/​{ChassisId}/​MediaControllers/​{MediaControllerId}/​Ports
/​redfish/​v1/​Chassis/​{ChassisId}/​NetworkAdapters/​{NetworkAdapterId}/​Ports
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​NetworkInterfaces/​{NetworkInterfaceId}/​Ports
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​Controllers/​{StorageControllerId}/​Ports
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​StorageControllers/​{StorageControllerId}/​Ports
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​NetworkInterfaces/​{NetworkInterfaceId}/​Ports
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Controllers/​{StorageControllerId}/​Ports
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​StorageControllers/​{StorageControllerId}/​Ports
/​redfish/​v1/​Fabrics/​{FabricId}/​Switches/​{SwitchId}/​Ports
/​redfish/​v1/​Managers/​{ManagerId}/​USBPorts
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​NetworkInterfaces/​{NetworkInterfaceId}/​Ports
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​Controllers/​{StorageControllerId}/​Ports
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​StorageControllers/​{StorageControllerId}/​Ports
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​NetworkInterfaces/​{NetworkInterfaceId}/​Ports
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Controllers/​{StorageControllerId}/​Ports
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​StorageControllers/​{StorageControllerId}/​Ports
/​redfish/​v1/​Storage/​{StorageId}/​Controllers/​{StorageControllerId}/​Ports
/​redfish/​v1/​Storage/​{StorageId}/​StorageControllers/​{StorageControllerId}/​Ports
/​redfish/​v1/​Systems/​{ComputerSystemId}/​FabricAdapters/​{FabricAdapterId}/​Ports
/​redfish/​v1/​Systems/​{ComputerSystemId}/​GraphicsControllers/​{ControllerId}/​Ports
/​redfish/​v1/​Systems/​{ComputerSystemId}/​NetworkInterfaces/​{NetworkInterfaceId}/​Ports
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Processors/​{ProcessorId}/​Ports
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Controllers/​{StorageControllerId}/​Ports
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​StorageControllers/​{StorageControllerId}/​Ports
/​redfish/​v1/​Systems/​{ComputerSystemId}/​USBControllers/​{ControllerId}/​Ports
PowerDistributionCollection /​redfish/​v1/​PowerEquipment/​ElectricalBuses
/​redfish/​v1/​PowerEquipment/​FloorPDUs
/​redfish/​v1/​PowerEquipment/​PowerShelves
/​redfish/​v1/​PowerEquipment/​RackPDUs
/​redfish/​v1/​PowerEquipment/​Switchgear
/​redfish/​v1/​PowerEquipment/​TransferSwitches
PowerDomainCollection /​redfish/​v1/​Facilities/​{FacilityId}/​PowerDomains
PowerSupplyCollection /​redfish/​v1/​Chassis/​{ChassisId}/​PowerSubsystem/​PowerSupplies
/​redfish/​v1/​PowerEquipment/​PowerShelves/​{PowerDistributionId}/​PowerSupplies
ProcessorCollection /​redfish/​v1/​Chassis/​{ChassisId}/​NetworkAdapters/​{NetworkAdapterId}/​Processors
/​redfish/​v1/​Chassis/​{ChassisId}/​NetworkAdapters/​{NetworkAdapterId}/​Processors/​{ProcessorId}/​SubProcessors
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Processors/​{ProcessorId}/​SubProcessors
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Processors
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Processors/​{ProcessorId}/​SubProcessors
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Processors/​{ProcessorId}/​SubProcessors
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Processors
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Processors/​{ProcessorId}/​SubProcessors
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Processors
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Processors/​{ProcessorId}/​SubProcessors
RegisteredClientCollection /​redfish/​v1/​RegisteredClients
ResourceBlockCollection /​redfish/​v1/​CompositionService/​ActivePool
/​redfish/​v1/​CompositionService/​FreePool
/​redfish/​v1/​CompositionService/​ResourceBlocks
/​redfish/​v1/​ResourceBlocks
RoleCollection /​redfish/​v1/​AccountService/​Roles
/​redfish/​v1/​Managers/​{ManagerId}/​RemoteAccountService/​Roles
RouteEntryCollection /​redfish/​v1/​Fabrics/​{FabricId}/​Switches/​{SwitchId}/​Ports/​{PortId}/​LPRT
/​redfish/​v1/​Fabrics/​{FabricId}/​Switches/​{SwitchId}/​Ports/​{PortId}/​MPRT
/​redfish/​v1/​Systems/​{ComputerSystemId}/​FabricAdapters/​{FabricAdapterId}/​MSDT
/​redfish/​v1/​Systems/​{ComputerSystemId}/​FabricAdapters/​{FabricAdapterId}/​Ports/​{PortId}/​LPRT
/​redfish/​v1/​Systems/​{ComputerSystemId}/​FabricAdapters/​{FabricAdapterId}/​Ports/​{PortId}/​MPRT
/​redfish/​v1/​Systems/​{ComputerSystemId}/​FabricAdapters/​{FabricAdapterId}/​SSDT
RouteSetEntryCollection /​redfish/​v1/​Fabrics/​{FabricId}/​Switches/​{SwitchId}/​Ports/​{PortId}/​LPRT/​{LPRTId}/​RouteSet
/​redfish/​v1/​Fabrics/​{FabricId}/​Switches/​{SwitchId}/​Ports/​{PortId}/​MPRT/​{MPRTId}/​RouteSet
/​redfish/​v1/​Systems/​{ComputerSystemId}/​FabricAdapters/​{FabricAdapterId}/​MSDT/​{MSDTId}/​RouteSet
/​redfish/​v1/​Systems/​{ComputerSystemId}/​FabricAdapters/​{FabricAdapterId}/​Ports/​{PortId}/​LPRT/​{LPRTId}/​RouteSet
/​redfish/​v1/​Systems/​{ComputerSystemId}/​FabricAdapters/​{FabricAdapterId}/​Ports/​{PortId}/​MPRT/​{MPRTId}/​RouteSet
/​redfish/​v1/​Systems/​{ComputerSystemId}/​FabricAdapters/​{FabricAdapterId}/​SSDT/​{SSDTId}/​RouteSet
SecureBootDatabaseCollection /​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​SecureBoot/​SecureBootDatabases
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​SecureBoot/​SecureBootDatabases
/​redfish/​v1/​Systems/​{ComputerSystemId}/​SecureBoot/​SecureBootDatabases
SensorCollection /​redfish/​v1/​Chassis/​{ChassisId}/​Sensors
/​redfish/​v1/​Facilities/​{FacilityId}/​Sensors
/​redfish/​v1/​PowerEquipment/​FloorPDUs/​{PowerDistributionId}/​Sensors
/​redfish/​v1/​PowerEquipment/​PowerShelves/​{PowerDistributionId}/​Sensors
/​redfish/​v1/​PowerEquipment/​RackPDUs/​{PowerDistributionId}/​Sensors
/​redfish/​v1/​PowerEquipment/​Switchgear/​{PowerDistributionId}/​Sensors
/​redfish/​v1/​PowerEquipment/​TransferSwitches/​{PowerDistributionId}/​Sensors
SerialInterfaceCollection /​redfish/​v1/​Managers/​{ManagerId}/​SerialInterfaces
SessionCollection /​redfish/​v1/​SessionService/​Sessions
SignatureCollection /​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​SecureBoot/​SecureBootDatabases/​{DatabaseId}/​Signatures
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​SecureBoot/​SecureBootDatabases/​{DatabaseId}/​Signatures
/​redfish/​v1/​Systems/​{ComputerSystemId}/​SecureBoot/​SecureBootDatabases/​{DatabaseId}/​Signatures
SimpleStorageCollection /​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​SimpleStorage
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​SimpleStorage
/​redfish/​v1/​Systems/​{ComputerSystemId}/​SimpleStorage
SoftwareInventoryCollection /​redfish/​v1/​UpdateService/​FirmwareInventory
/​redfish/​v1/​UpdateService/​SoftwareInventory
StorageCollection /​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Storage
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Storage
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage
/​redfish/​v1/​Storage
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Storage
StorageControllerCollection /​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​Controllers
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Controllers
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​Controllers
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Controllers
/​redfish/​v1/​Storage/​{StorageId}/​Controllers
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Controllers
SwitchCollection /​redfish/​v1/​Fabrics/​{FabricId}/​Switches
TaskCollection /​redfish/​v1/​TaskService/​Tasks
/​redfish/​v1/​TaskService/​Tasks/​{TaskId}/​SubTasks
TriggersCollection /​redfish/​v1/​TelemetryService/​Triggers
USBControllerCollection /​redfish/​v1/​Systems/​{ComputerSystemId}/​USBControllers
VCATEntryCollection /​redfish/​v1/​Fabrics/​{FabricId}/​Switches/​{SwitchId}/​Ports/​{PortId}/​VCAT
/​redfish/​v1/​Systems/​{SystemId}/​FabricAdapters/​{FabricAdapterId}/​Ports/​{PortId}/​VCAT
/​redfish/​v1/​Systems/​{SystemId}/​FabricAdapters/​{FabricAdapterId}/​REQ-VCAT
/​redfish/​v1/​Systems/​{SystemId}/​FabricAdapters/​{FabricAdapterId}/​RSP-VCAT
VirtualMediaCollection /​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​VirtualMedia
/​redfish/​v1/​Managers/​{ManagerId}/​VirtualMedia
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​VirtualMedia
/​redfish/​v1/​Systems/​{ComputerSystemId}/​VirtualMedia
VLanNetworkInterfaceCollection /​redfish/​v1/​Chassis/​{ChassisId}/​NetworkAdapters/​{NetworkAdapterId}/​NetworkDeviceFunctions/​{NetworkDeviceFunctionId}/​Ethernet/​VLANs
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​EthernetInterfaces/​{EthernetInterfaceId}/​VLANs
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​EthernetInterfaces/​{EthernetInterfaceId}/​VLANs
/​redfish/​v1/​Managers/​{ManagerId}/​EthernetInterfaces/​{EthernetInterfaceId}/​VLANs
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​EthernetInterfaces/​{EthernetInterfaceId}/​VLANs
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​EthernetInterfaces/​{EthernetInterfaceId}/​VLANs
/​redfish/​v1/​Systems/​{ComputerSystemId}/​EthernetInterfaces/​{EthernetInterfaceId}/​VLANs
VolumeCollection /​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​Volumes
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Volumes
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​Volumes
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Volumes
/​redfish/​v1/​Storage/​{StorageId}/​ConsistencyGroups/​{ConsistencyGroupId}/​Volumes
/​redfish/​v1/​Storage/​{StorageId}/​FileSystems/​{FileSystemId}/​CapacitySources/​{CapacitySourceId}/​ProvidingVolumes
/​redfish/​v1/​Storage/​{StorageId}/​StoragePools/​{StoragePoolId}/​AllocatedVolumes
/​redfish/​v1/​Storage/​{StorageId}/​StoragePools/​{StoragePoolId}/​CapacitySources/​{CapacitySourceId}/​ProvidingVolumes
/​redfish/​v1/​Storage/​{StorageId}/​Volumes
/​redfish/​v1/​StorageServices/​{StorageServiceId}/​ConsistencyGroups/​{ConsistencyGroupId}/​Volumes
/​redfish/​v1/​StorageServices/​{StorageServiceId}/​FileSystems/​{FileSystemId}/​CapacitySources/​{CapacitySourceId}/​ProvidingVolumes
/​redfish/​v1/​StorageServices/​{StorageServiceId}/​StoragePools/​{StoragePoolId}/​AllocatedVolumes
/​redfish/​v1/​StorageServices/​{StorageServiceId}/​StoragePools/​{StoragePoolId}/​CapacitySources/​{CapacitySourceId}/​ProvidingVolumes
/​redfish/​v1/​StorageServices/​{StorageServiceId}/​Volumes
/​redfish/​v1/​StorageServices/​{StorageServiceId}/​Volumes/​{VolumeId}/​CapacitySources/​{CapacitySourceId}/​ProvidingVolumes
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​ConsistencyGroups/​{ConsistencyGroupId}/​Volumes
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​FileSystems/​{FileSystemId}/​CapacitySources/​{CapacitySourceId}/​ProvidingVolumes
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​StoragePools/​{StoragePoolId}/​AllocatedVolumes
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​StoragePools/​{StoragePoolId}/​CapacitySources/​{CapacitySourceId}/​ProvidingVolumes
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Volumes
ZoneCollection /​redfish/​v1/​CompositionService/​ResourceZones
/​redfish/​v1/​Fabrics/​{FabricId}/​Zones

6 Reference Guide

To produce this guide, DMTF's Redfish Documentation Generator merges the DMTF Redfish Schema bundle (DSP8010) contents with supplemental text.

6.1 AccelerationFunction 1.0.3

Version v1.0
Release 2018.3

6.1.1 Description

The AccelerationFunction schema describes an acceleration function that a processor implements. This can include functions such as audio processing, compression, encryption, packet inspection, packet switching, scheduling, or video processing.

6.1.2 URIs

/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Processors/​{ProcessorId}/​AccelerationFunctions/​{AccelerationFunctionId}
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Processors/​{ProcessorId}/​AccelerationFunctions/​{AccelerationFunctionId}
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Processors/​{ProcessorId}/​AccelerationFunctions/​{AccelerationFunctionId}
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Processors/​{ProcessorId}/​AccelerationFunctions/​{AccelerationFunctionId}
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Processors/​{ProcessorId}/​AccelerationFunctions/​{AccelerationFunctionId}

6.1.3 Properties

Property Type Attributes Notes
AccelerationFunctionType string
(enum)
read-only
(null)
The acceleration function type. For the possible property values, see AccelerationFunctionType in Property details.
FpgaReconfigurationSlots [ ] array (string) read-only An array of the reconfiguration slot identifiers of the FPGA that this acceleration function occupies.
Links { object The links to other Resources that are related to this Resource.
      Endpoints [ { array An array of links to the endpoints that connect to this acceleration function.
            @odata.id string read-only Link to a Endpoint resource. See the Links section and the Endpoint schema for details.
      } ]
      Oem {} object See the Oem object definition in the Common properties section.
      PCIeFunctions [ { array An array of links to the PCIeFunctions associated with this acceleration function.
            @odata.id string read-only Link to a PCIeFunction resource. See the Links section and the PCIeFunction schema for details.
      } ]
}
Manufacturer string read-only The acceleration function code manufacturer.
PowerWatts integer
(Watts)
read-only The acceleration function power consumption, in watts.
Status {} object The status and health of the Resource and its subordinate or dependent Resources. For property details, see Status.
UUID string read-only
(null)
The UUID for this acceleration function.
Version string read-only The acceleration function version.

6.1.4 Property details

6.1.4.1 AccelerationFunctionType:

The acceleration function type.

string Description
AudioProcessing An audio processing function.
Compression A compression function.
Encryption An encryption function.
OEM An OEM-defined acceleration function.
PacketInspection A packet inspection function.
PacketSwitch A packet switch function.
Scheduler A scheduler function.
VideoProcessing A video processing function.

6.1.5 Example response

{
    "@odata.type": "#AccelerationFunction.v1_0_3.AccelerationFunction",
    "Id": "Compression",
    "Name": "Compression Accelerator",
    "Status": {
        "State": "Enabled",
        "Health": "OK"
    },
    "FpgaReconfigurationSlots": [
        "AFU0"
    ],
    "AccelerationFunctionType": "Compression",
    "Manufacturer": "Intel (R) Corporation",
    "Version": "Green Compression Type 1 v.1.00.86",
    "PowerWatts": 15,
    "Links": {
        "Endpoints": [],
        "PCIeFunctions": []
    },
    "Oem": {},
    "@odata.id": "/redfish/v1/Systems/1/Processors/FPGA1/AccelerationFunctions/Compression"
}

6.2 AccountService 1.10.0

Version v1.10 v1.9 v1.8 v1.7 v1.6 v1.5 v1.4 v1.3 v1.2 v1.1 v1.0
Release 2021.2 2021.1 2020.4 2019.4 2019.2 2019.1 2018.3 2018.1 2017.1 2016.3 1.0

6.2.1 Description

The AccountService schema defines an account service. The properties are common to, and enable management of, all user accounts. The properties include the password requirements and control features, such as account lockout. Properties and actions in this service specify general behavior that should be followed for typical accounts, however implementations may override these behaviors for special accounts or situations to avoid denial of service or other deadlock situations.

6.2.2 URIs

/​redfish/​v1/​AccountService
/​redfish/​v1/​Managers/​{ManagerId}/​RemoteAccountService

6.2.3 Properties

Property Type Attributes Notes
AccountLockoutCounterResetAfter integer
(seconds)
read-write The period of time, in seconds, between the last failed login attempt and the reset of the lockout threshold counter. This value must be less than or equal to the AccountLockoutDuration value. A reset sets the counter to 0.
AccountLockoutCounterResetEnabled (v1.5+) boolean read-write An indication of whether the threshold counter is reset after AccountLockoutCounterResetAfter expires. If true, it is reset. If false, only a successful login resets the threshold counter and if the user reaches the AccountLockoutThreshold limit, the account will be locked out indefinitely and only an administrator-issued reset clears the threshold counter. If this property is absent, the default is true.
AccountLockoutDuration integer
(seconds)
read-write
(null)
The period of time, in seconds, that an account is locked after the number of failed login attempts reaches the account lockout threshold, within the period between the last failed login attempt and the reset of the lockout threshold counter. If this value is 0, no lockout will occur. If the AccountLockoutCounterResetEnabled value is false, this property is ignored.
AccountLockoutThreshold integer read-write
(null)
The number of allowed failed login attempts before a user account is locked for a specified duration. If 0, the account is never locked.
Accounts { object The collection of manager accounts. Contains a link to a resource.
      @odata.id string read-only Link to Collection of ManagerAccount. See the ManagerAccount schema for details.
}
ActiveDirectory (v1.3+) {} object The first Active Directory external account provider that this account service supports. For more information about this property, see ExternalAccountProvider in Property Details.
AdditionalExternalAccountProviders (v1.3+) { object The additional external account providers that this account service uses. Contains a link to a resource.
      @odata.id string read-only Link to Collection of ExternalAccountProvider. See the ExternalAccountProvider schema for details.
}
AuthFailureLoggingThreshold integer read-write The number of authorization failures per account that are allowed before the failed attempt is logged to the manager log.
LDAP (v1.3+) {} object The first LDAP external account provider that this account service supports. For more information about this property, see ExternalAccountProvider in Property Details.
LocalAccountAuth (v1.3+) string
(enum)
read-write An indication of how the service uses the accounts collection within this account service as part of authentication. The enumerated values describe the details for each mode. For the possible property values, see LocalAccountAuth in Property details.
MaxPasswordLength integer read-write The maximum password length for this account service.
MinPasswordLength integer read-write The minimum password length for this account service.
OAuth2 (v1.10+) {} object
(null)
The first OAuth 2.0 external account provider that this account service supports. For more information about this property, see ExternalAccountProvider in Property Details.
PasswordExpirationDays (v1.9+) integer read-write
(null)
The number of days before account passwords in this account service will expire.
PrivilegeMap (v1.1+) { object The link to the mapping of the privileges required to complete a requested operation on a URI associated with this service. See the PrivilegeRegistry schema for details on this property.
      @odata.id string read-only Link to a PrivilegeRegistry resource. See the Links section and the PrivilegeRegistry schema for details.
}
RestrictedOemPrivileges (v1.8+) [ ] array (string) read-only The set of restricted OEM privileges.
RestrictedPrivileges (v1.8+) [ ] array (string
(enum))
read-only The set of restricted Redfish privileges. For the possible property values, see RestrictedPrivileges in Property details.
Roles { object The collection of Redfish roles. Contains a link to a resource.
      @odata.id string read-only Link to Collection of Role. See the Role schema for details.
}
ServiceEnabled boolean read-write
(null)
An indication of whether the account service is enabled. If true, it is enabled. If false, it is disabled and users cannot be created, deleted, or modified, and new sessions cannot be started. However, established sessions might still continue to run. Any service, such as the session service, that attempts to access the disabled account service fails. However, this does not affect HTTP Basic Authentication connections.
Status {} object The status and health of the resource and its subordinate or dependent resources. For property details, see Status.
SupportedAccountTypes (v1.8+) [ ] array (string
(enum))
read-only The account types supported by the service. For the possible property values, see SupportedAccountTypes in Property details.
SupportedOEMAccountTypes (v1.8+) [ ] array (string) read-only The OEM account types supported by the service.
TACACSplus (v1.8+) {} object
(null)
The first TACACS+ external account provider that this account service supports. For more information about this property, see ExternalAccountProvider in Property Details.

6.2.4 Property details

6.2.4.1 AccountProviderType:

The type of external account provider to which this service connects.

string Description
ActiveDirectoryService An external Active Directory service.
LDAPService A generic external LDAP service.
OAuth2 (v1.10+) An external OAuth 2.0 service.
OEM An OEM-specific external authentication or directory service.
RedfishService An external Redfish service.
TACACSplus (v1.8+) An external TACACS+ service.

6.2.4.2 Authentication:

The information required to authenticate to the external service.

AuthenticationType (v1.3+) string
(enum)
read-write
(null)
The type of authentication used to connect to the external account provider. For the possible property values, see AuthenticationType in Property details.
EncryptionKey (v1.8+) string read-write
(null)
Specifies the encryption key.
EncryptionKeySet (v1.8+) boolean read-only
(null)
Indicates if the EncryptionKey property is set.
KerberosKeytab (v1.3+) string read-write
(null)
The Base64-encoded version of the Kerberos keytab for this service. A PATCH or PUT operation writes the keytab. This property is null in responses.
Oem (v1.3+) {} object See the Oem object definition in the Common properties section.
Password (v1.3+) string read-write
(null)
The password for this service. A PATCH or PUT request writes the password. This property is null in responses.
Token (v1.3+) string read-write
(null)
The token for this service. A PATCH or PUT operation writes the token. This property is null in responses.
Username (v1.3+) string read-write The user name for the service.

6.2.4.3 AuthenticationType:

The type of authentication used to connect to the external account provider.

string Description
KerberosKeytab A Kerberos keytab.
OEM An OEM-specific authentication mechanism.
Token An opaque authentication token.
UsernameAndPassword A user name and password combination.

6.2.4.4 ExternalAccountProvider:

The external account provider services that can provide accounts for this manager to use for authentication.

AccountProviderType (v1.3+, deprecated v1.5 string
(enum)
read-only
(null)
The type of external account provider to which this service connects. For the possible property values, see AccountProviderType in Property details. Deprecated in v1.5 and later. This property is deprecated because the account provider type is known when used in the LDAP and ActiveDirectory objects.
Authentication (v1.3+) {} object The authentication information for the external account provider. For more information about this property, see Authentication in Property Details.
Certificates (v1.4+) { object The link to a collection of certificates that the external account provider uses. Contains a link to a resource.
      @odata.id string read-only Link to Collection of Certificate. See the Certificate schema for details.
}
LDAPService (v1.3+) {} object The additional mapping information needed to parse a generic LDAP service. For more information about this property, see LDAPService in Property Details.
OAuth2Service (v1.10+) {} object
(null)
The additional information needed to parse an OAuth 2.0 service. For more information about this property, see OAuth2Service in Property Details.
PasswordSet (v1.7+) boolean read-only Indicates if the Password property is set.
Priority (v1.8+) integer read-write
(null)
The authentication priority for the external account provider.
RemoteRoleMapping (v1.3+) [ { array The mapping rules to convert the external account providers account information to the local Redfish role.
      LocalRole (v1.3+) string read-write
(null)
The name of the local Redfish role to which to map the remote user or group.
      Oem (v1.3+) {} object See the Oem object definition in the Common properties section.
      RemoteGroup (v1.3+) string read-write
(null)
The name of the remote group, or the remote role in the case of a Redfish service, that maps to the local Redfish role to which this entity links.
      RemoteUser (v1.3+) string read-write
(null)
The name of the remote user that maps to the local Redfish role to which this entity links.
} ]
ServiceAddresses (v1.3+) [ ] array (string, null) read-write The addresses of the user account providers to which this external account provider links. The format of this field depends on the type of external account provider.
ServiceEnabled (v1.3+) boolean read-write
(null)
An indication of whether this service is enabled.
TACACSplusService (v1.8+) {} object
(null)
The additional information needed to parse a TACACS+ services. For more information about this property, see TACACSplusService in Property Details.

6.2.4.5 LDAPService:

The settings required to parse a generic LDAP service.

Oem (v1.3+) {} object See the Oem object definition in the Common properties section.
SearchSettings (v1.3+) { object The required settings to search an external LDAP service.
      BaseDistinguishedNames (v1.3+) [ ] array (string, null) read-write The base distinguished names to use to search an external LDAP service.
      GroupNameAttribute (v1.3+) string read-write
(null)
The attribute name that contains the LDAP group name entry.
      GroupsAttribute (v1.3+) string read-write
(null)
The attribute name that contains the groups for a user on the LDAP user entry.
      UsernameAttribute (v1.3+) string read-write
(null)
The attribute name that contains the LDAP user name entry.
}

6.2.4.6 LocalAccountAuth:

An indication of how the service uses the accounts collection within this account service as part of authentication. The enumerated values describe the details for each mode.

string Description
Disabled The service never authenticates users based on the account service-defined accounts collection.
Enabled The service authenticates users based on the account service-defined accounts collection.
Fallback The service authenticates users based on the account service-defined accounts collection only if any external account providers are currently unreachable.
LocalFirst (v1.6+) The service first authenticates users based on the account service-defined accounts collection. If authentication fails, the service authenticates by using external account providers.

6.2.4.7 Mode:

The mode of operation for token validation.

string Description
Discovery OAuth 2.0 service information for token validation is downloaded by the service.
Offline OAuth 2.0 service information for token validation is configured by a client.

6.2.4.8 OAuth2Service:

Various settings to parse an OAuth 2.0 service.

Audience (v1.10+) [ ] array (string) read-only The allowable audience strings of the Redfish service.
Issuer (v1.10+) string read-write
(null)
The issuer string of the OAuth 2.0 service.
Mode (v1.10+) string
(enum)
read-write The mode of operation for token validation. For the possible property values, see Mode in Property details.
OAuthServiceSigningKeys (v1.10+) string read-write
(null)
The Base64-encoded signing keys of the issuer of the OAuth 2.0 service.

6.2.4.9 PasswordExchangeProtocols:

Indicates the allowed TACACS+ password exchange protocols.

string Description
ASCII The ASCII Login method.
CHAP The CHAP Login method.
MSCHAPv1 The MS-CHAP v1 Login method.
MSCHAPv2 The MS-CHAP v2 Login method.
PAP The PAP Login method.

6.2.4.10 RestrictedPrivileges:

The set of restricted Redfish privileges.

string Description
ConfigureComponents Can configure components that this service manages.
ConfigureCompositionInfrastructure Can view and configure composition service resources.
ConfigureManager Can configure managers.
ConfigureSelf Can change the password for the current user account and log out of their own sessions.
ConfigureUsers Can configure users and their accounts.
Login Can log in to the service and read Resources.
NoAuth Authentication is not required.

6.2.4.11 SupportedAccountTypes:

The account types supported by the service.

string Description
HostConsole Allow access to the host's console, which could be connected through Telnet, SSH, or other protocol.
IPMI Allow access to the Intelligent Platform Management Interface service.
KVMIP Allow access to a Keyboard-Video-Mouse over IP session.
ManagerConsole Allow access to the manager's console, which could be connected through Telnet, SSH, SM CLP, or other protocol.
OEM OEM account type. See the OEMAccountTypes property.
Redfish Allow access to the Redfish service.
SNMP Allow access to SNMP services.
VirtualMedia Allow access to control virtual media.
WebUI Allow access to a web user interface session, such as a graphical interface or another web-based protocol.

6.2.4.12 TACACSplusService:

Various settings to parse a TACACS+ service.

PasswordExchangeProtocols (v1.8+) [ ] array (string
(enum))
read-write
(null)
Indicates the allowed TACACS+ password exchange protocols. For the possible property values, see PasswordExchangeProtocols in Property details.
PrivilegeLevelArgument (v1.8+) string read-write
(null)
Indicates the name of the TACACS+ argument name in an authorization request.

6.2.5 Example response

{
    "@odata.type": "#AccountService.v1_10_0.AccountService",
    "Id": "AccountService",
    "Name": "Account Service",
    "Description": "Local Manager Account Service",
    "Status": {
        "State": "Enabled",
        "Health": "OK"
    },
    "ServiceEnabled": true,
    "AuthFailureLoggingThreshold": 3,
    "MinPasswordLength": 8,
    "AccountLockoutThreshold": 5,
    "AccountLockoutDuration": 30,
    "AccountLockoutCounterResetAfter": 30,
    "AccountLockoutCounterResetEnabled": true,
    "Accounts": {
        "@odata.id": "/redfish/v1/AccountService/Accounts"
    },
    "Roles": {
        "@odata.id": "/redfish/v1/AccountService/Roles"
    },
    "LocalAccountAuth": "Enabled",
    "LDAP": {
        "AccountProviderType": "LDAPService",
        "ServiceEnabled": false,
        "ServiceAddresses": [
            "ldaps://ldap.example.org:636"
        ],
        "Authentication": {
            "AuthenticationType": "UsernameAndPassword",
            "Username": "cn=Manager,dc=example,dc=org",
            "Password": null
        },
        "LDAPService": {
            "SearchSettings": {
                "BaseDistinguishedNames": [
                    "dc=example,dc=org"
                ],
                "UsernameAttribute": "uid",
                "GroupsAttribute": "memberof"
            }
        },
        "RemoteRoleMapping": [
            {
                "RemoteUser": "cn=Manager,dc=example,dc=org",
                "LocalRole": "Administrator"
            },
            {
                "RemoteGroup": "cn=Admins,ou=Groups,dc=example,dc=org",
                "LocalRole": "Administrator"
            },
            {
                "RemoteGroup": "cn=PowerUsers,ou=Groups,dc=example,dc=org",
                "LocalRole": "Operator"
            },
            {
                "RemoteGroup": "(cn=*)",
                "LocalRole": "ReadOnly"
            }
        ]
    },
    "ActiveDirectory": {
        "AccountProviderType": "ActiveDirectoryService",
        "ServiceEnabled": true,
        "ServiceAddresses": [
            "ad1.example.org",
            "ad2.example.org",
            null,
            null
        ],
        "Authentication": {
            "AuthenticationType": "KerberosKeytab",
            "KerberosKeytab": null
        },
        "RemoteRoleMapping": [
            {
                "RemoteGroup": "Administrators",
                "LocalRole": "Administrator"
            },
            {
                "RemoteUser": "DOMAIN\\Bob",
                "LocalRole": "Operator"
            },
            {
                "RemoteGroup": "PowerUsers",
                "LocalRole": "Operator"
            },
            {
                "RemoteGroup": "Everybody",
                "LocalRole": "ReadOnly"
            }
        ]
    },
    "AdditionalExternalAccountProviders": {
        "@odata.id": "/redfish/v1/AccountService/ExternalAccountProviders"
    },
    "@odata.id": "/redfish/v1/AccountService"
}

6.3 ActionInfo 1.2.0

Version v1.2 v1.1 v1.0
Release 2021.2 2018.2 2016.2

6.3.1 Description

The ActionInfo schema defines the supported parameters and other information for a Redfish action. Supported parameters can differ among vendors and even among resource instances. This data can ensure that action requests from applications contain supported parameters.

6.3.2 Properties

Property Type Attributes Notes
Parameters [ { array The list of parameters included in the specified Redfish action.
      AllowableValues [ ] array (string, null) read-only The allowable values for this parameter as applied to this action target.
      ArraySizeMaximum (v1.2+) integer read-only
(null)
The maximum number of array elements allowed for this parameter.
      ArraySizeMinimum (v1.2+) integer read-only
(null)
The minimum number of array elements required for this parameter.
      DataType string
(enum)
read-only
(null)
The JSON property type for this parameter. For the possible property values, see DataType in Property details.
      MaximumValue (v1.1+) number read-only
(null)
The maximum supported value for this parameter.
      MinimumValue (v1.1+) number read-only
(null)
The minimum supported value for this parameter.
      Name string read-only required The name of the parameter for this action.
      ObjectDataType string read-only
(null)
The data type of an object-based parameter.
      Required boolean read-only An indication of whether the parameter is required to complete this action.
} ]

6.3.3 Property details

6.3.3.1 DataType:

The JSON property type for this parameter.

string Description
Boolean A boolean.
Number A number.
NumberArray An array of numbers.
Object An embedded JSON object.
ObjectArray An array of JSON objects.
String A string.
StringArray An array of strings.

6.3.4 Example response

{
    "@odata.type": "#ActionInfo.v1_2_0.ActionInfo",
    "Id": "ResetActionInfo",
    "Name": "Reset Action Info",
    "Parameters": [
        {
            "Name": "ResetType",
            "Required": true,
            "DataType": "String",
            "AllowableValues": [
                "On",
                "ForceOff",
                "GracefulShutdown",
                "GracefulRestart",
                "ForceRestart",
                "Nmi",
                "ForceOn",
                "PushPowerButton"
            ]
        }
    ],
    "Oem": {},
    "@odata.id": "/redfish/v1/Systems/1/ResetActionInfo"
}

6.4 AddressPool 1.2.1

Version v1.2 v1.1 v1.0
Release 2021.2 2020.3 2019.4

6.4.1 Description

The schema definition of an address pool and its configuration.

6.4.2 URIs

/​redfish/​v1/​Fabrics/​{FabricId}/​AddressPools/​{AddressPoolId}

6.4.3 Properties

Property Type Attributes Notes
Ethernet (v1.1+) { object The Ethernet related properties for this address pool.
      BFDSingleHopOnly (v1.1+) { object
(null)
Bidirectional Forwarding Detection (BFD) related properties for this Ethernet fabric.
            DemandModeEnabled (v1.1+) boolean read-write
(null)
Bidirectional Forwarding Detection (BFD) Demand Mode status.
            DesiredMinTxIntervalMilliseconds (v1.1+) integer read-write
(null)
Desired Bidirectional Forwarding Detection (BFD) minimal transmit interval.
            KeyChain (v1.1+) string read-write
(null)
Bidirectional Forwarding Detection (BFD) Key Chain name.
            LocalMultiplier (v1.1+) integer read-write
(null)
Bidirectional Forwarding Detection (BFD) multiplier value.
            MeticulousModeEnabled (v1.1+) boolean read-write
(null)
Meticulous MD5 authentication of the Bidirectional Forwarding Detection (BFD) session.
            RequiredMinRxIntervalMilliseconds (v1.1+) integer read-write
(null)
Bidirectional Forwarding Detection (BFD) receive value.
            SourcePort (v1.1+) integer read-write
(null)
Bidirectional Forwarding Detection (BFD) source port.
      }
      BGPEvpn (v1.1+) { object
(null)
BGP Ethernet Virtual Private Network (EVPN) related properties for this Ethernet fabric.
            AnycastGatewayIPAddress (v1.1+) string read-write
(null)
The anycast gateway IPv4 address.
            AnycastGatewayMACAddress (v1.1+) string read-write
(null)
The anycast gateway MAC address.
            ARPProxyEnabled (v1.1+) boolean read-write
(null)
Address Resolution Protocol (ARP) proxy status.
            ARPSupressionEnabled (v1.1+) boolean read-write
(null)
Address Resolution Protocol (ARP) suppression status.
            ESINumberRange (v1.1+) { object
(null)
The Ethernet Segment Identifier (ESI) number range for the fabric.
                  Lower (v1.1+) integer read-write Lower Ethernet Segment Identifier (ESI) number.
                  Upper (v1.1+) integer read-write Upper Ethernet Segment Identifier (ESI) number.
            }
            EVINumberRange (v1.1+) { object
(null)
The Ethernet Virtual Private Network (EVPN) Instance number (EVI) number range for the fabric.
                  Lower (v1.1+) integer read-write Lower Ethernet Virtual Private Network (EVPN) Instance (EVI) number.
                  Upper (v1.1+) integer read-write Upper Ethernet Virtual Private Network (EVPN) Instance (EVI) number.
            }
            GatewayIPAddress (v1.1+) string read-write
(null)
The gateway IPv4 address.
            GatewayIPAddressRange (v1.2+) { object
(null)
The IPv4 address range for gateways.
                  Lower (v1.2+) string read-write
(null)
The lower IPv4 address.
                  Upper (v1.2+) string read-write
(null)
The upper IPv4 address.
            }
            NDPProxyEnabled (v1.1+) boolean read-write
(null)
Network Discovery Protocol (NDP) proxy status.
            NDPSupressionEnabled (v1.1+) boolean read-write
(null)
Network Discovery Protocol (NDP) suppression status.
            RouteDistinguisherAdministratorSubfield (v1.2+) string read-write
(null)
The Route Distinguisher (RD) Administrator subfield.
            RouteDistinguisherRange (v1.1+) { object
(null)
The Route Distinguisher (RD) number range for the fabric.
                  Lower (v1.1+) integer read-write Lower Route Distinguisher (RD) number.
                  Upper (v1.1+) integer read-write Upper Route Distinguisher (RD) number.
            }
            RouteTargetAdministratorSubfield (v1.2+) string read-write
(null)
The Route Target (RT) Administrator Subfield.
            RouteTargetRange (v1.1+) { object
(null)
The Route Target (RT) number range for the fabric.
                  Lower (v1.1+) integer read-write
(null)
Lower Route Target (RT) number.
                  Upper (v1.1+) integer read-write
(null)
Upper Route Target (RT) number.
            }
            UnderlayMulticastEnabled (v1.1+) boolean read-write
(null)
Underlay multicast status.
            UnknownUnicastSuppressionEnabled (v1.1+) boolean read-write
(null)
Suppression of unknown unicast packets.
            VLANIdentifierAddressRange (v1.1+) { object
(null)
Virtual LAN (VLAN) tag related address range applicable to this Ethernet fabric or for end host subnets.
                  Lower (v1.1+) integer read-write
(null)
Virtual LAN (VLAN) tag lower value.
                  Upper (v1.1+) integer read-write
(null)
Virtual LAN (VLAN) tag upper value.
            }
      }
      EBGP (v1.1+) { object
(null)
External BGP (eBGP) related properties for this Ethernet fabric.
            AllowDuplicateASEnabled (v1.1+) boolean read-write
(null)
Allow duplicate Autonomous System (AS) path.
            AllowOverrideASEnabled (v1.1+) boolean read-write
(null)
Option to override an Autonomous System (AS) number with the AS number of the sending peer .
            AlwaysCompareMEDEnabled (v1.1+) boolean read-write
(null)
Compare Multi Exit Discriminator (MED) status.
            ASNumberRange (v1.1+) { object
(null)
Autonomous System (AS) number range.
                  Lower (v1.1+) integer read-write Lower Autonomous System (AS) number.
                  Upper (v1.1+) integer read-write Upper Autonomous System (AS) number.
            }
            BGPLocalPreference (v1.1+) integer read-write
(null)
Local preference value.
            BGPNeighbor (v1.1+) { object
(null)
Border Gateway Protocol (BGP) neighbor related properties.
                  Address (v1.1+) string read-write
(null)
Border Gateway Protocol (BGP) neighbor address.
                  AllowOwnASEnabled (v1.1+) boolean read-write
(null)
Allow own Autonomous System (AS) status.
                  CIDR (v1.2+) integer read-write The Classless Inter-Domain Routing (CIDR) value used for neighbor communication. This is the number of ones before the first zero in the subnet mask.
                  ConnectRetrySeconds (v1.1+) integer read-write
(null)
Border Gateway Protocol (BGP) retry timer in seconds.
                  Enabled (v1.2+) boolean read-write An indication of whether BGP neighbor communication is enabled.
                  HoldTimeSeconds (v1.1+) integer read-write
(null)
Border Gateway Protocol (BGP) hold timer in seconds.
                  KeepaliveIntervalSeconds (v1.1+) integer read-write
(null)
Border Gateway Protocol (BGP) Keepalive timer in seconds.
                  LocalAS (v1.1+) integer read-write
(null)
Local Autonomous System (AS) number.
                  LogStateChangesEnabled (v1.1+) boolean read-write
(null)
Border Gateway Protocol (BGP) neighbor log state change status.
                  MaxPrefix (v1.1+) { object
(null)
Border Gateway Protocol (BGP) max prefix properties.
                        MaxPrefixNumber (v1.1+) integer read-write
(null)
Maximum prefix number.
                        RestartTimerSeconds (v1.1+) integer read-write
(null)
Border Gateway Protocol (BGP) restart timer in seconds.
                        ShutdownThresholdPercentage (v1.1+) number
(%)
read-write
(null)
Shutdown threshold status.
                        ThresholdWarningOnlyEnabled (v1.1+) boolean read-write
(null)
Threshold warning only status.
                  }
                  MinimumAdvertisementIntervalSeconds (v1.1+) integer read-write
(null)
Minimum Border Gateway Protocol (BGP) advertisement interval in seconds.
                  PassiveModeEnabled (v1.1+) boolean read-write
(null)
Border Gateway Protocol (BGP) passive mode status.
                  PathMTUDiscoveryEnabled (v1.1+) boolean read-write
(null)
Path MTU discovery status.
                  PeerAS (v1.1+) integer read-write
(null)
Peer Autonomous System (AS) number.
                  ReplacePeerASEnabled (v1.1+) boolean read-write
(null)
Replace Border Gateway Protocol (BGP) peer Autonomous System (AS) status.
                  TCPMaxSegmentSizeBytes (v1.1+) integer read-write
(null)
TCP max segment size in Bytes.
                  TreatAsWithdrawEnabled (v1.1+) boolean read-write
(null)
Border Gateway Protocol (BGP) treat as withdraw status.
            }
            BGPRoute (v1.1+) { object
(null)
Border Gateway Protocol (BGP) route related properties.
                  AdvertiseInactiveRoutesEnabled (v1.1+) boolean read-write
(null)
Advertise inactive route status.
                  DistanceExternal (v1.1+) integer read-write
(null)
Route distance for external routes.
                  DistanceInternal (v1.1+) integer read-write
(null)
Route distance for internal routes.
                  DistanceLocal (v1.1+) integer read-write
(null)
Route distance for local routes.
                  ExternalCompareRouterIdEnabled (v1.1+) boolean read-write
(null)
Compare router id status.
                  FlapDampingEnabled (v1.1+) boolean read-write
(null)
Route flap dampening status.
                  SendDefaultRouteEnabled (v1.1+) boolean read-write
(null)
Send default route status.
            }
            BGPWeight (v1.1+) integer read-write
(null)
BGP weight attribute.
            GracefulRestart (v1.1+) { object
(null)
Graceful restart related properties.
                  GracefulRestartEnabled (v1.1+) boolean read-write
(null)
Border Gateway Protocol (BGP) graceful restart status.
                  HelperModeEnabled (v1.1+) boolean read-write
(null)
Graceful restart helper mode status.
                  StaleRoutesTimeSeconds (v1.1+) integer read-write
(null)
Stale route timer in seconds.
                  TimeSeconds (v1.1+) integer read-write
(null)
Graceful restart timer in seconds.
            }
            MED (v1.1+) integer read-write
(null)
BGP Multi Exit Discriminator (MED) value.
            MultihopEnabled (v1.1+) boolean read-write
(null)
External BGP (eBGP) multihop status.
            MultihopTTL (v1.1+) integer read-write
(null)
External BGP (eBGP) multihop Time to Live (TTL) value.
            MultiplePaths (v1.1+) { object
(null)
Multiple path related properties.
                  MaximumPaths (v1.1+) integer read-write
(null)
Maximum paths number.
                  UseMultiplePathsEnabled (v1.1+) boolean read-write
(null)
Border Gateway Protocol (BGP) multiple paths status.
            }
            SendCommunityEnabled (v1.1+) boolean read-write
(null)
This property shall indicate whether community attributes are sent.
      }
      IPv4 (v1.1+) { object
(null)
IPv4 and Virtual LAN (VLAN) related addressing for this Ethernet fabric.
            AnycastGatewayIPAddress (v1.1+) string read-write
(null)
The anycast gateway IPv4 address.
            AnycastGatewayMACAddress (v1.1+) string read-write
(null)
The anycast gateway MAC address.
            DHCP (v1.1+) { object
(null)
The Dynamic Host Configuration Protocol (DHCP) related addressing for this Ethernet fabric.
                  DHCPInterfaceMTUBytes (v1.1+) integer read-write
(null)
Dynamic Host Configuration Protocol (DHCP) interface Maximum Transmission Unit (MTU).
                  DHCPRelayEnabled (v1.1+) boolean read-write
(null)
Dynamic Host Configuration Protocol (DHCP) relay status.
                  DHCPServer (v1.1+) [ ] array (string, null) read-write The Dynamic Host Configuration Protocol (DHCP) IPv4 addresses for this Ethernet fabric.
            }
            DistributeIntoUnderlayEnabled (v1.1+) boolean read-write
(null)
Indicates if host subnets should be distributed into the fabric underlay.
            DNSDomainName (v1.1+) string read-write
(null)
The Domain Name Service (DNS) domain name for this Ethernet fabric.
            DNSServer (v1.1+) [ ] array (string, null) read-write The Domain Name Service (DNS) servers for this Ethernet fabric.
            EBGPAddressRange (v1.1+) {} object
(null)
External BGP (eBGP) related addressing for this Ethernet fabric. For more information about this property, see IPv4AddressRange in Property Details.
            FabricLinkAddressRange (v1.1+) {} object
(null)
Link related IPv4 addressing for this Ethernet fabric typically applied to connections between spine and leaf Ethernet switches. For more information about this property, see IPv4AddressRange in Property Details.
            GatewayIPAddress (v1.1+) string read-write
(null)
The gateway IPv4 address.
            HostAddressRange (v1.1+) {} object
(null)
IPv4 related host subnet addressing for physical device endpoints that connect to this Ethernet fabric. For more information about this property, see IPv4AddressRange in Property Details.
            IBGPAddressRange (v1.1+) {} object
(null)
Internal BGP (iBGP) related addressing for this Ethernet fabric. For more information about this property, see IPv4AddressRange in Property Details.
            LoopbackAddressRange (v1.1+) {} object
(null)
Loopback related IPv4 addressing for this Ethernet fabric. For more information about this property, see IPv4AddressRange in Property Details.
            ManagementAddressRange (v1.1+) {} object
(null)
Management related addressing for this Ethernet fabric. For more information about this property, see IPv4AddressRange in Property Details.
            NativeVLAN (v1.1+) integer read-write
(null)
The native Virtual LAN (VLAN) tag value.
            NTPOffsetHoursMinutes (v1.1+) integer read-write
(null)
The Network Time Protocol (NTP) offset configuration.
            NTPServer (v1.1+) [ ] array (string, null) read-write The Network Time Protocol (NTP) servers for this Ethernet fabric.
            NTPTimezone (v1.1+) string read-write
(null)
The Network Time Protocol (NTP) timezone for this Ethernet fabric.
            SystemMACRange (v1.2+) { object
(null)
The MAC address range for systems in this subnet.
                  Lower (v1.2+) string read-write
(null)
The lower system MAC address.
                  Upper (v1.2+) string read-write
(null)
The upper system MAC address.
            }
            VLANIdentifierAddressRange (v1.1+) { object
(null)
Virtual LAN (VLAN) tag related addressing for this Ethernet fabric or for end host networks.
                  Lower (v1.1+) integer read-write
(null)
Virtual LAN (VLAN) tag lower value.
                  Upper (v1.1+) integer read-write
(null)
Virtual LAN (VLAN) tag upper value.
            }
      }
      MultiProtocolEBGP (v1.1+) { object
(null)
Multi Protocol eBGP (MP eBGP) related properties for this Ethernet fabric.
            AllowDuplicateASEnabled (v1.1+) boolean read-write
(null)
Allow duplicate Autonomous System (AS) path.
            AllowOverrideASEnabled (v1.1+) boolean read-write
(null)
Option to override an Autonomous System (AS) number with the AS number of the sending peer .
            AlwaysCompareMEDEnabled (v1.1+) boolean read-write
(null)
Compare Multi Exit Discriminator (MED) status.
            ASNumberRange (v1.1+) { object
(null)
Autonomous System (AS) number range.
                  Lower (v1.1+) integer read-write Lower Autonomous System (AS) number.
                  Upper (v1.1+) integer read-write Upper Autonomous System (AS) number.
            }
            BGPLocalPreference (v1.1+) integer read-write
(null)
Local preference value.
            BGPNeighbor (v1.1+) { object
(null)
Border Gateway Protocol (BGP) neighbor related properties.
                  Address (v1.1+) string read-write
(null)
Border Gateway Protocol (BGP) neighbor address.
                  AllowOwnASEnabled (v1.1+) boolean read-write
(null)
Allow own Autonomous System (AS) status.
                  CIDR (v1.2+) integer read-write The Classless Inter-Domain Routing (CIDR) value used for neighbor communication. This is the number of ones before the first zero in the subnet mask.
                  ConnectRetrySeconds (v1.1+) integer read-write
(null)
Border Gateway Protocol (BGP) retry timer in seconds.
                  Enabled (v1.2+) boolean read-write An indication of whether BGP neighbor communication is enabled.
                  HoldTimeSeconds (v1.1+) integer read-write
(null)
Border Gateway Protocol (BGP) hold timer in seconds.
                  KeepaliveIntervalSeconds (v1.1+) integer read-write
(null)
Border Gateway Protocol (BGP) Keepalive timer in seconds.
                  LocalAS (v1.1+) integer read-write
(null)
Local Autonomous System (AS) number.
                  LogStateChangesEnabled (v1.1+) boolean read-write
(null)
Border Gateway Protocol (BGP) neighbor log state change status.
                  MaxPrefix (v1.1+) { object
(null)
Border Gateway Protocol (BGP) max prefix properties.
                        MaxPrefixNumber (v1.1+) integer read-write
(null)
Maximum prefix number.
                        RestartTimerSeconds (v1.1+) integer read-write
(null)
Border Gateway Protocol (BGP) restart timer in seconds.
                        ShutdownThresholdPercentage (v1.1+) number
(%)
read-write
(null)
Shutdown threshold status.
                        ThresholdWarningOnlyEnabled (v1.1+) boolean read-write
(null)
Threshold warning only status.
                  }
                  MinimumAdvertisementIntervalSeconds (v1.1+) integer read-write
(null)
Minimum Border Gateway Protocol (BGP) advertisement interval in seconds.
                  PassiveModeEnabled (v1.1+) boolean read-write
(null)
Border Gateway Protocol (BGP) passive mode status.
                  PathMTUDiscoveryEnabled (v1.1+) boolean read-write
(null)
Path MTU discovery status.
                  PeerAS (v1.1+) integer read-write
(null)
Peer Autonomous System (AS) number.
                  ReplacePeerASEnabled (v1.1+) boolean read-write
(null)
Replace Border Gateway Protocol (BGP) peer Autonomous System (AS) status.
                  TCPMaxSegmentSizeBytes (v1.1+) integer read-write
(null)
TCP max segment size in Bytes.
                  TreatAsWithdrawEnabled (v1.1+) boolean read-write
(null)
Border Gateway Protocol (BGP) treat as withdraw status.
            }
            BGPRoute (v1.1+) { object
(null)
Border Gateway Protocol (BGP) route related properties.
                  AdvertiseInactiveRoutesEnabled (v1.1+) boolean read-write
(null)
Advertise inactive route status.
                  DistanceExternal (v1.1+) integer read-write
(null)
Route distance for external routes.
                  DistanceInternal (v1.1+) integer read-write
(null)
Route distance for internal routes.
                  DistanceLocal (v1.1+) integer read-write
(null)
Route distance for local routes.
                  ExternalCompareRouterIdEnabled (v1.1+) boolean read-write
(null)
Compare router id status.
                  FlapDampingEnabled (v1.1+) boolean read-write
(null)
Route flap dampening status.
                  SendDefaultRouteEnabled (v1.1+) boolean read-write
(null)
Send default route status.
            }
            BGPWeight (v1.1+) integer read-write
(null)
BGP weight attribute.
            GracefulRestart (v1.1+) { object
(null)
Graceful restart related properties.
                  GracefulRestartEnabled (v1.1+) boolean read-write
(null)
Border Gateway Protocol (BGP) graceful restart status.
                  HelperModeEnabled (v1.1+) boolean read-write
(null)
Graceful restart helper mode status.
                  StaleRoutesTimeSeconds (v1.1+) integer read-write
(null)
Stale route timer in seconds.
                  TimeSeconds (v1.1+) integer read-write
(null)
Graceful restart timer in seconds.
            }
            MED (v1.1+) integer read-write
(null)
BGP Multi Exit Discriminator (MED) value.
            MultihopEnabled (v1.1+) boolean read-write
(null)
External BGP (eBGP) multihop status.
            MultihopTTL (v1.1+) integer read-write
(null)
External BGP (eBGP) multihop Time to Live (TTL) value.
            MultiplePaths (v1.1+) { object
(null)
Multiple path related properties.
                  MaximumPaths (v1.1+) integer read-write
(null)
Maximum paths number.
                  UseMultiplePathsEnabled (v1.1+) boolean read-write
(null)
Border Gateway Protocol (BGP) multiple paths status.
            }
            SendCommunityEnabled (v1.1+) boolean read-write
(null)
This property shall indicate whether community attributes are sent.
      }
      MultiProtocolIBGP (v1.1+) { object
(null)
Multi Protocol iBGP (MP iBGP) related properties for this Ethernet fabric.
            ASNumberRange (v1.1+) { object
(null)
Autonomous System (AS) number range.
                  Lower (v1.1+) integer read-write Lower Autonomous System (AS) number.
                  Upper (v1.1+) integer read-write Upper Autonomous System (AS) number.
            }
            BGPNeighbor (v1.1+) { object
(null)
Border Gateway Protocol (BGP) neighbor related properties.
                  Address (v1.1+) string read-write
(null)
Border Gateway Protocol (BGP) neighbor address.
                  AllowOwnASEnabled (v1.1+) boolean read-write
(null)
Allow own Autonomous System (AS) status.
                  CIDR (v1.2+) integer read-write The Classless Inter-Domain Routing (CIDR) value used for neighbor communication. This is the number of ones before the first zero in the subnet mask.
                  ConnectRetrySeconds (v1.1+) integer read-write
(null)
Border Gateway Protocol (BGP) retry timer in seconds.
                  Enabled (v1.2+) boolean read-write An indication of whether BGP neighbor communication is enabled.
                  HoldTimeSeconds (v1.1+) integer read-write
(null)
Border Gateway Protocol (BGP) hold timer in seconds.
                  KeepaliveIntervalSeconds (v1.1+) integer read-write
(null)
Border Gateway Protocol (BGP) Keepalive timer in seconds.
                  LocalAS (v1.1+) integer read-write
(null)
Local Autonomous System (AS) number.
                  LogStateChangesEnabled (v1.1+) boolean read-write
(null)
Border Gateway Protocol (BGP) neighbor log state change status.
                  MaxPrefix (v1.1+) { object
(null)
Border Gateway Protocol (BGP) max prefix properties.
                        MaxPrefixNumber (v1.1+) integer read-write
(null)
Maximum prefix number.
                        RestartTimerSeconds (v1.1+) integer read-write
(null)
Border Gateway Protocol (BGP) restart timer in seconds.
                        ShutdownThresholdPercentage (v1.1+) number
(%)
read-write
(null)
Shutdown threshold status.
                        ThresholdWarningOnlyEnabled (v1.1+) boolean read-write
(null)
Threshold warning only status.
                  }
                  MinimumAdvertisementIntervalSeconds (v1.1+) integer read-write
(null)
Minimum Border Gateway Protocol (BGP) advertisement interval in seconds.
                  PassiveModeEnabled (v1.1+) boolean read-write
(null)
Border Gateway Protocol (BGP) passive mode status.
                  PathMTUDiscoveryEnabled (v1.1+) boolean read-write
(null)
Path MTU discovery status.
                  PeerAS (v1.1+) integer read-write
(null)
Peer Autonomous System (AS) number.
                  ReplacePeerASEnabled (v1.1+) boolean read-write
(null)
Replace Border Gateway Protocol (BGP) peer Autonomous System (AS) status.
                  TCPMaxSegmentSizeBytes (v1.1+) integer read-write
(null)
TCP max segment size in Bytes.
                  TreatAsWithdrawEnabled (v1.1+) boolean read-write
(null)
Border Gateway Protocol (BGP) treat as withdraw status.
            }
            BGPRoute (v1.1+) { object
(null)
Border Gateway Protocol (BGP) route related properties.
                  AdvertiseInactiveRoutesEnabled (v1.1+) boolean read-write
(null)
Advertise inactive route status.
                  DistanceExternal (v1.1+) integer read-write
(null)
Route distance for external routes.
                  DistanceInternal (v1.1+) integer read-write
(null)
Route distance for internal routes.
                  DistanceLocal (v1.1+) integer read-write
(null)
Route distance for local routes.
                  ExternalCompareRouterIdEnabled (v1.1+) boolean read-write
(null)
Compare router id status.
                  FlapDampingEnabled (v1.1+) boolean read-write
(null)
Route flap dampening status.
                  SendDefaultRouteEnabled (v1.1+) boolean read-write
(null)
Send default route status.
            }
            GracefulRestart (v1.1+) { object
(null)
Graceful restart related properties.
                  GracefulRestartEnabled (v1.1+) boolean read-write
(null)
Border Gateway Protocol (BGP) graceful restart status.
                  HelperModeEnabled (v1.1+) boolean read-write
(null)
Graceful restart helper mode status.
                  StaleRoutesTimeSeconds (v1.1+) integer read-write
(null)
Stale route timer in seconds.
                  TimeSeconds (v1.1+) integer read-write
(null)
Graceful restart timer in seconds.
            }
            MultiplePaths (v1.1+) { object
(null)
Multiple path related properties.
                  MaximumPaths (v1.1+) integer read-write
(null)
Maximum paths number.
                  UseMultiplePathsEnabled (v1.1+) boolean read-write
(null)
Border Gateway Protocol (BGP) multiple paths status.
            }
            SendCommunityEnabled (v1.1+) boolean read-write
(null)
This property shall indicate whether community attributes are sent.
      }
}
GenZ { object The Gen-Z related properties for this address pool.
      AccessKey string read-write
(null)
The Access Key required for this address pool.
      MaxCID integer read-write
(null)
The maximum value for the Component Identifier (CID).
      MaxSID integer read-write
(null)
The maximum value for the Subnet Identifier (SID).
      MinCID integer read-write
(null)
The minimum value for the Component Identifier (CID).
      MinSID integer read-write
(null)
The minimum value for the Subnet Identifier (SID).
}
Links { object The links to other resources that are related to this resource.
      Endpoints [ { array An array of links to the endpoints that this address pool contains.
            @odata.id string read-write Link to a Endpoint resource. See the Links section and the Endpoint schema for details.
      } ]
      Oem {} object See the Oem object definition in the Common properties section.
      Zones [ { array An array of links to the zones that this address pool contains.
            @odata.id string read-write Link to a Zone resource. See the Links section and the Zone schema for details.
      } ]
}
Status {} object The status and health of the resource and its subordinate or dependent resources. For property details, see Status.

6.4.4 Property details

6.4.4.1 IPv4AddressRange:

IPv4 related address range for an Ethernet fabric.

Lower (v1.1+) string read-write
(null)
Lower IPv4 network address.
Upper (v1.1+) string read-write
(null)
Upper IPv4 network address.

6.4.5 Example response

{
    "@odata.type": "#AddressPool.v1_2_1.AddressPool",
    "Id": "AP1",
    "Name": "Address Pool 1",
    "Description": "Address Pool 1",
    "Status": {
        "State": "Enabled",
        "Health": "OK"
    },
    "GenZ": {
        "MinCID": 1,
        "MaxCID": 4096,
        "MinSID": 100,
        "MaxSID": 8192,
        "AccessKey": "0x1A"
    },
    "Links": {
        "Endpoints": [
            {
                "@odata.id": "/redfish/v1/Fabrics/GenZ/Endpoints/1"
            }
        ]
    },
    "Oem": {},
    "@odata.id": "/redfish/v1/Fabrics/GenZ/AddressPools/AP1"
}

6.5 Aggregate 1.0.1

Version v1.0
Release 2020.2

6.5.1 Description

The Aggregate schema describes a grouping method for an aggregation service. Aggregates are formal groups of resources that are more persistent than ad hoc groupings.

6.5.2 URIs

/​redfish/​v1/​AggregationService/​Aggregates/​{AggregateId}

6.5.3 Properties

Property Type Attributes Notes
Elements [ { array * required* The elements of this aggregate.
      @odata.id string
(URI)
read-only The unique identifier for a resource.
} ]
ElementsCount integer read-only
(null)
The number of entries in the Elements array.

6.5.4 Actions

6.5.4.1 AddElements

Description

This action is used to add one or more resources to the aggregate.

Action URI: {Base URI of target resource}/Actions/Aggregate.AddElements

Action parameters

Parameter Name Type Attributes Notes
      Elements [ { array required An array of resource links to add to the Elements array.
            @odata.id string
(URI)
read-only The unique identifier for a resource.
      } ]

Request Example

{
    "Elements": [
        {
            "@odata.id": "/redfish/v1/Systems/cluster-node7"
        },
        {
            "@odata.id": "node8.intranet.contoso.com/redfish/v1/Systems/1"
        }
    ]
}

6.5.4.2 RemoveElements

Description

This action is used to remove one or more resources from the aggregate.

Action URI: {Base URI of target resource}/Actions/Aggregate.RemoveElements

Action parameters

Parameter Name Type Attributes Notes
      Elements [ { array required An array of resource links to remove from the Elements array.
            @odata.id string
(URI)
read-only The unique identifier for a resource.
      } ]

Request Example

{
    "Elements": [
        {
            "@odata.id": "node8.intranet.contoso.com/redfish/v1/Systems/1"
        }
    ]
}

6.5.4.3 Reset

Description

This action is used to reset a collection of resources. For example, this could be an aggregate or a list of computer systems.

Action URI: {Base URI of target resource}/Actions/Aggregate.Reset

Action parameters

Parameter Name Type Attributes Notes
      BatchSize integer optional The number of elements in each batch being reset.
      DelayBetweenBatchesInSeconds integer
(seconds)
optional The delay of the batches of elements being reset in seconds.
      ResetType string
(enum)
optional The type of reset. For the possible property values, see ResetType in Property details.

Request Example

{
    "ResetType": "ForceRestart",
    "BatchSize": 5,
    "DelayBetweenBatchesInSeconds": 30
}

6.5.4.4 SetDefaultBootOrder

Description

This action is used to restore the boot order to the default state for the computer systems that are members of this aggregate.

Action URI: {Base URI of target resource}/Actions/Aggregate.SetDefaultBootOrder

Action parameters

This action takes no parameters.

6.5.5 Property details

6.5.5.1 ResetType:

The type of reset.

string Description
ForceOff Turn off the unit immediately (non-graceful shutdown).
ForceOn Turn on the unit immediately.
ForceRestart Shut down immediately and non-gracefully and restart the system.
GracefulRestart Shut down gracefully and restart the system.
GracefulShutdown Shut down gracefully and power off.
Nmi Generate a diagnostic interrupt, which is usually an NMI on x86 systems, to stop normal operations, complete diagnostic actions, and, typically, halt the system.
On Turn on the unit.
Pause Pause execution on the unit but do not remove power. This is typically a feature of virtual machine hypervisors.
PowerCycle Power cycle the unit. Behaves like a full power removal, followed by a power restore to the resource.
PushPowerButton Simulate the pressing of the physical power button on this unit.
Resume Resume execution on the paused unit. This is typically a feature of virtual machine hypervisors.
Suspend Write the state of the unit to disk before powering off. This allows for the state to be restored when powered back on.

6.5.6 Example response

{
    "@odata.type": "#Aggregate.v1_0_1.Aggregate",
    "Id": "Aggregate1",
    "Name": "Aggregate One",
    "ElementsCount": 2,
    "Elements": [
        {
            "@odata.id": "/redfish/v1/Systems/cluster-node3"
        },
        {
            "@odata.id": "/redfish/v1/Systems/cluster-node4"
        }
    ],
    "Actions": {
        "#Aggregate.Reset": {
            "target": "/redfish/v1/AggregationService/Aggregates/Aggregate1/Actions/Aggregate.Reset",
            "@Redfish.ActionInfo": "/redfish/v1/AggregationService/Aggregates/Aggregate1/ResetActionInfo"
        },
        "#Aggregate.SetDefaultBootOrder": {
            "target": "/redfish/v1/AggregationService/Aggregates/Aggregate1/Actions/Aggregate.SetDefaultBootOrder",
            "@Redfish.ActionInfo": "/redfish/v1/AggregationService/Aggregates/Aggregate1/SetDefaultBootOrderActionInfo"
        },
        "#Aggregate.AddElements": {
            "target": "/redfish/v1/AggregationService/Aggregates/Aggregate1/Actions/Aggregate.AddElements",
            "@Redfish.ActionInfo": "/redfish/v1/AggregationService/Aggregates/Aggregate1/AddElementsActionInfo"
        },
        "#Aggregate.RemoveElements": {
            "target": "/redfish/v1/AggregationService/Aggregates/Aggregate1/Actions/Aggregate.RemoveElements",
            "@Redfish.ActionInfo": "/redfish/v1/AggregationService/Aggregates/Aggregate1/RemoveElementsActionInfo"
        }
    },
    "@odata.id": "/redfish/v1/AggregationService/Aggregates/Aggregate1"
}

6.6 AggregationService 1.0.1

Version v1.0
Release 2020.2

6.6.1 Description

The AggregationService schema contains properties for managing aggregation operations, either on ad hoc combinations of resources or on defined sets of resources called aggregates. Access points define the properties needed to access the entity being aggregated and connection methods describe the protocol or other semantics of the connection.

6.6.2 URIs

/​redfish/​v1/​AggregationService

6.6.3 Properties

Property Type Attributes Notes
Aggregates { object The link to the collection of aggregates associated with this service. Contains a link to a resource.
      @odata.id string read-only Link to Collection of Aggregate. See the Aggregate schema for details.
}
AggregationSources { object The link to the collection of aggregation sources associated with this service. Contains a link to a resource.
      @odata.id string read-only Link to Collection of AggregationSource. See the AggregationSource schema for details.
}
ConnectionMethods { object The link to the collection of connection methods associated with this service. Contains a link to a resource.
      @odata.id string read-only Link to Collection of ConnectionMethod. See the ConnectionMethod schema for details.
}
ServiceEnabled boolean read-write
(null)
An indication of whether the aggregation service is enabled.
Status {} object The status and health of the resource and its subordinate or dependent resources. For property details, see Status.

6.6.4 Actions

6.6.4.1 Reset

Description

This action is used to reset a set of resources. For example this could be a list of computer systems.

Action URI: {Base URI of target resource}/Actions/AggregationService.Reset

Action parameters

Parameter Name Type Attributes Notes
      BatchSize integer optional The number of elements in each batch being reset.
      DelayBetweenBatchesInSeconds integer
(seconds)
optional The delay of the batches of elements being reset in seconds.
      ResetType string
(enum)
optional The type of reset. For the possible property values, see ResetType in Property details.
      TargetURIs [ { array required An array of links to the resources being reset.
            @odata.id string
(URI)
read-only The unique identifier for a resource.
      } ]

Request Example

{
    "ResetType": "ForceRestart",
    "BatchSize": 1,
    "DelayBetweenBatchesInSeconds": 30,
    "TargetURIs": [
        {
            "@odata.id": "/redfish/v1/Systems/cluster-node3"
        },
        {
            "@odata.id": "/redfish/v1/Systems/cluster-node4"
        },
        {
            "@odata.id": "node7.intranet.contoso.com/redfish/v1/Systems/1"
        }
    ]
}

6.6.4.2 SetDefaultBootOrder

Description

This action is used to restore the boot order to the default state for the specified computer systems.

Action URI: {Base URI of target resource}/Actions/AggregationService.SetDefaultBootOrder

Action parameters

Parameter Name Type Attributes Notes
      Systems [ { array required The computer systems to restore.
            @odata.id string read-only Link to a ComputerSystem resource. See the Links section and the ComputerSystem schema for details.
      } ]

Request Example

{
    "Systems": [
        {
            "@odata.id": "/redfish/v1/Systems/cluster-node3"
        },
        {
            "@odata.id": "/redfish/v1/Systems/cluster-node4"
        },
        {
            "@odata.id": "node7.intranet.contoso.com/redfish/v1/Systems/1"
        }
    ]
}

6.6.5 Property details

6.6.5.1 ResetType:

The type of reset.

string Description
ForceOff Turn off the unit immediately (non-graceful shutdown).
ForceOn Turn on the unit immediately.
ForceRestart Shut down immediately and non-gracefully and restart the system.
GracefulRestart Shut down gracefully and restart the system.
GracefulShutdown Shut down gracefully and power off.
Nmi Generate a diagnostic interrupt, which is usually an NMI on x86 systems, to stop normal operations, complete diagnostic actions, and, typically, halt the system.
On Turn on the unit.
Pause Pause execution on the unit but do not remove power. This is typically a feature of virtual machine hypervisors.
PowerCycle Power cycle the unit. Behaves like a full power removal, followed by a power restore to the resource.
PushPowerButton Simulate the pressing of the physical power button on this unit.
Resume Resume execution on the paused unit. This is typically a feature of virtual machine hypervisors.
Suspend Write the state of the unit to disk before powering off. This allows for the state to be restored when powered back on.

6.6.6 Example response

{
    "@odata.type": "#AggregationService.v1_0_1.AggregationService",
    "Id": "AggregationService",
    "Description": "Aggregation Service",
    "Name": "Aggregation Service",
    "ServiceEnabled": true,
    "Status": {
        "Health": "OK",
        "HealthRollup": "OK",
        "State": "Enabled"
    },
    "Aggregates": {
        "@odata.id": "/redfish/v1/AggregationService/Aggregates"
    },
    "AggregationSources": {
        "@odata.id": "/redfish/v1/AggregationService/AggregationSources"
    },
    "ConnectionMethods": {
        "@odata.id": "/redfish/v1/AggregationService/ConnectionMethods"
    },
    "Actions": {
        "#AggregationService.Reset": {
            "target": "/redfish/v1/AggregationService/Actions/AggregationService.Reset",
            "@Redfish.ActionInfo": "/redfish/v1/AggregationService/ResetActionInfo"
        },
        "#AggregationService.SetDefaultBootOrder": {
            "target": "/redfish/v1/AggregationService/Actions/AggregationService.SetDefaultBootOrder",
            "@Redfish.ActionInfo": "/redfish/v1/AggregationService/SetDefaultBootOrderActionInfo"
        }
    },
    "@odata.id": "/redfish/v1/AggregationService/"
}

6.7 AggregationSource 1.2.0

Version v1.2 v1.1 v1.0
Release 2021.3 2020.4 2020.2

6.7.1 Description

The AggregationSource schema is used to represent the source of information for a subset of the resources provided by a Redfish service. It can be thought of as a provider of information. As such, most such interfaces have requirements to support the gathering of information like address and account used to access the information.

6.7.2 URIs

/​redfish/​v1/​AggregationService/​AggregationSources/​{AggregationSourceId}

6.7.3 Properties

Property Type Attributes Notes
AggregationType (v1.2+) string
(enum)
read-write The type of aggregation used towards the aggregation source. For the possible property values, see AggregationType in Property details.
HostName string
(URI)
read-write
(null)
The URI of the system to be accessed.
Links { object The links to other resources that are related to this resource.
      ConnectionMethod { object
(null)
An array of links to the connection methods used to contact this aggregation source. See the ConnectionMethod schema for details on this property.
            @odata.id string read-only Link to a ConnectionMethod resource. See the Links section and the ConnectionMethod schema for details.
      }
      Oem {} object See the Oem object definition in the Common properties section.
      ResourcesAccessed [ { array An array links to the resources added to the service through this aggregation source. It is recommended that this be the minimal number of properties needed to find the resources that would be lost when the aggregation source is deleted.
            @odata.id string
(URI)
read-only The unique identifier for a resource.
      } ]
}
Password string read-write
(null)
The password for accessing the aggregation source. The value is null in responses.
SNMP (v1.1+) { object
(null)
SNMP settings of the aggregation source.
      AuthenticationKey (v1.1+) string read-write
(null)
The secret authentication key for SNMPv3.
      AuthenticationKeySet (v1.1+) boolean read-only Indicates if the AuthenticationKey property is set.
      AuthenticationProtocol (v1.1+) string
(enum)
read-write
(null)
The authentication protocol for SNMPv3. For the possible property values, see AuthenticationProtocol in Property details.
      EncryptionKey (v1.1+) string read-write
(null)
The secret authentication key for SNMPv3.
      EncryptionKeySet (v1.1+) boolean read-only Indicates if the EncryptionKey property is set.
      EncryptionProtocol (v1.1+) string
(enum)
read-write
(null)
The encryption protocol for SNMPv3. For the possible property values, see EncryptionProtocol in Property details.
      TrapCommunity (v1.2+) string read-write
(null)
The SNMP trap community string.
}
UserName string read-write
(null)
The user name for accessing the aggregation source.

6.7.4 Property details

6.7.4.1 AggregationType:

The type of aggregation used towards the aggregation source.

string Description
Full Full aggregation according to connection method.
NotificationsOnly Only notifications are aggregated.

6.7.4.2 AuthenticationProtocol:

The authentication protocol for SNMPv3.

string Description
CommunityString Trap community string authentication.
HMAC128_SHA224 HMAC-128-SHA-224 authentication.
HMAC192_SHA256 HMAC-192-SHA-256 authentication.
HMAC256_SHA384 HMAC-256-SHA-384 authentication.
HMAC384_SHA512 HMAC-384-SHA-512 authentication.
HMAC_MD5 HMAC-MD5-96 authentication.
HMAC_SHA96 HMAC-SHA-96 authentication.
None No authentication.

6.7.4.3 EncryptionProtocol:

The encryption protocol for SNMPv3.

string Description
CBC_DES CBC-DES encryption.
CFB128_AES128 CFB128-AES-128 encryption.
None No encryption.

6.7.5 Example response

{
    "@odata.type": "#AggregationSource.v1_2_0.AggregationSource",
    "Id": "AggregationSource1",
    "Name": "AggregationSource One",
    "HostName": "https://Someserver.Contoso.com/redfish/v1",
    "UserName": "root",
    "Password": null,
    "Links": {
        "ConnectionMethod": {
            "@odata.id": "/redfish/v1/AggregationService/ConnectionMethods/ConnectionMethod1"
        },
        "ResourcesAccessed": [
            {
                "@odata.id": "/redfish/v1/Managers/1"
            }
        ]
    },
    "Actions": {},
    "@odata.id": "/redfish/v1/AggregationService/AggregationSources/AggregationSource1"
}

6.8 AllowDeny 1.0.0

Version v1.0
Release 2021.2

6.8.1 Description

The AllowDeny schema represents a set of allow or deny configurations.

6.8.2 URIs

/​redfish/​v1/​Chassis/​{ChassisId}/​NetworkAdapters/​{NetworkAdapterId}/​NetworkDeviceFunctions/​{NetworkDeviceFunctionId}/​AllowDeny/​{AllowDenyId}
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​NetworkInterfaces/​{NetworkInterfaceId}/​NetworkDeviceFunctions{NetworkDeviceFunctionId}/​AllowDeny/​{AllowDenyId}
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​NetworkInterfaces/​{NetworkInterfaceId}/​NetworkDeviceFunctions{NetworkDeviceFunctionId}/​AllowDeny/​{AllowDenyId}
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​NetworkInterfaces/​{NetworkInterfaceId}/​NetworkDeviceFunctions{NetworkDeviceFunctionId}/​AllowDeny/​{AllowDenyId}
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​NetworkInterfaces/​{NetworkInterfaceId}/​NetworkDeviceFunctions{NetworkDeviceFunctionId}/​AllowDeny/​{AllowDenyId}
/​redfish/​v1/​Systems/​{ComputerSystemId}/​NetworkInterfaces/​{NetworkInterfaceId}/​NetworkDeviceFunctions{NetworkDeviceFunctionId}/​AllowDeny/​{AllowDenyId}

6.8.3 Properties

Property Type Attributes Notes
AllowType string
(enum)
read-write
(null)
Indicates the type of permission. For the possible property values, see AllowType in Property details.
DestinationPortLower integer read-write
(null)
The TCP, UDP, or other destination port to which this rule begins to application, inclusive.
DestinationPortUpper integer read-write
(null)
The TCP, UDP, or other destination port to which this rule ends application, inclusive.
Direction string
(enum)
read-write
(null)
Indicates the direction of the data to which this permission applies. For the possible property values, see Direction in Property details.
IANAProtocolNumber integer read-write
(null)
The IANA protocol number to which this permission applies. For TCP, this is 6. For UDP, this is 17.
IPAddressLower string read-write
(null)
The lower IP address to which this permission applies.
IPAddressType string
(enum)
read-write
(null)
The type of IP address populated in the IPAddressLower and IPAddressUpper properties. For the possible property values, see IPAddressType in Property details.
IPAddressUpper string read-write
(null)
The upper IP address to which this permission applies.
SourcePortLower integer read-write
(null)
The TCP, UDP, or other source port to which this rule begins application, inclusive.
SourcePortUpper integer read-write
(null)
The TCP, UDP or other source port to which this rule ends application, inclusive.
StatefulSession boolean read-write
(null)
Indicates if this is a permission that only applies to stateful connection.

6.8.4 Property details

6.8.4.1 AllowType:

Indicates the type of permission.

string Description
Allow Indicates that traffic that matches the criteria in this resource shall be permitted.
Deny Indicates that traffic that matches the criteria in this resource shall not be permitted.

6.8.4.2 Direction:

Indicates the direction of the data to which this permission applies.

string Description
Egress Indicates that this limit is enforced on packets and bytes transmitted by the network device function.
Ingress Indicates that this limit is enforced on packets and bytes received by the network device function.

6.8.4.3 IPAddressType:

The type of IP address populated in the IPAddressLower and IPAddressUpper properties.

string Description
IPv4 IPv4 addressing is used for all IP-fields in this object.
IPv6 IPv6 addressing is used for all IP-fields in this object.

6.8.5 Example response

{
    "@odata.type": "#AllowDeny.v1_0_0.AllowDeny",
    "Id": "AllowDeny Rule 1",
    "Name": "Allow Rule 1",
    "Direction": "Ingress",
    "AllowType": "Allow",
    "StatefulSession": true,
    "IPAddressType": "IPv4",
    "IPAddressLower": "192.168.1.1",
    "IPAddressUpper": "192.168.1.100",
    "IANAProtocolNumber": 6,
    "SourcePortLower": 5,
    "SourcePortUpper": 65535,
    "DestinationPortLower": 5,
    "DestinationPortUpper": 65535,
    "@odata.id": "/redfish/v1/Chassis/Card1/NetworkAdapters/Slot1/NetworkDeviceFunctions/SC2KP1F0/AllowDeny/Rule1"
}

6.9 Assembly 1.3.0

Version v1.3 v1.2 v1.1 v1.0
Release 2020.3 2018.2 2018.1 2017.3

6.9.1 Description

The Assembly schema defines an assembly. Assembly information contains details about a device, such as part number, serial number, manufacturer, and production date. It also provides access to the original data for the assembly.

6.9.2 URIs

/​redfish/​v1/​Chassis/​{ChassisId}/​Assembly
/​redfish/​v1/​Chassis/​{ChassisId}/​Drives/​{DriveId}/​Assembly
/​redfish/​v1/​Chassis/​{ChassisId}/​NetworkAdapters/​{NetworkAdapterId}/​Assembly
/​redfish/​v1/​Chassis/​{ChassisId}/​PCIeDevices/​{PCIeDeviceId}/​Assembly
/​redfish/​v1/​Chassis/​{ChassisId}/​Power/​PowerSupplies/​{PowerSupplyId}/​Assembly
/​redfish/​v1/​Chassis/​{ChassisId}/​PowerSubsystem/​Batteries/​{BatteryId}/​Assembly
/​redfish/​v1/​Chassis/​{ChassisId}/​PowerSubsystem/​PowerSupplies/​{PowerSupplyId}/​Assembly
/​redfish/​v1/​Chassis/​{ChassisId}/​Thermal/​Fans/​{FanId}/​Assembly
/​redfish/​v1/​Chassis/​{ChassisId}/​ThermalSubsystem/​Fans/​{FanId}/​Assembly
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Drives/​{DriveId}/​Assembly
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Memory/​{MemoryId}/​Assembly
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Processors/​{ProcessorId}/​Assembly
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Processors/​{ProcessorId}/​SubProcessors/​{ProcessorId2}/​Assembly
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​Controllers/​{StorageControllerId}/​Assembly
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​Drives/​{DriveId}/​Assembly
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​StorageControllers/​{StorageControllerId}/​Assembly
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Memory/​{MemoryId}/​Assembly
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Processors/​{ProcessorId}/​Assembly
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Processors/​{ProcessorId}/​SubProcessors/​{ProcessorId2}/​Assembly
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Controllers/​{StorageControllerId}/​Assembly
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Drives/​{DriveId}/​Assembly
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​StorageControllers/​{StorageControllerId}/​Assembly
/​redfish/​v1/​PowerEquipment/​PowerShelves/​{PowerDistributionId}/​PowerSupplies/​{PowerSupplyId}/​Assembly
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Drives/​{DriveId}/​Assembly
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Memory/​{MemoryId}/​Assembly
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Processors/​{ProcessorId}/​Assembly
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Processors/​{ProcessorId}/​SubProcessors/​{ProcessorId2}/​Assembly
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​Controllers/​{StorageControllerId}/​Assembly
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​Drives/​{DriveId}/​Assembly
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​StorageControllers/​{StorageControllerId}/​Assembly
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Memory/​{MemoryId}/​Assembly
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Processors/​{ProcessorId}/​Assembly
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Processors/​{ProcessorId}/​SubProcessors/​{ProcessorId2}/​Assembly
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Controllers/​{StorageControllerId}/​Assembly
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Drives/​{DriveId}/​Assembly
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​StorageControllers/​{StorageControllerId}/​Assembly
/​redfish/​v1/​Storage/​{StorageId}/​Controllers/​{StorageControllerId}/​Assembly
/​redfish/​v1/​Storage/​{StorageId}/​StorageControllers/​{StorageControllerId}/​Assembly
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Memory/​{MemoryId}/​Assembly
/​redfish/​v1/​Systems/​{ComputerSystemId}/​PCIeDevices/​{PCIeDeviceId}/​Assembly
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Processors/​{ProcessorId}/​Assembly
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Processors/​{ProcessorId}/​SubProcessors/​{ProcessorId2}/​Assembly
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Controllers/​{StorageControllerId}/​Assembly
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Drives/​{DriveId}/​Assembly
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​StorageControllers/​{StorageControllerId}/​Assembly

6.9.3 Properties

Property Type Attributes Notes
Assemblies [ { array The assembly records.
      @odata.id string
(URI)
read-only required The unique identifier for a resource.
      Actions {} object The available actions for this Resource.
      BinaryDataURI string
(URI)
read-only
(null)
The URI at which to access an image of the assembly information.
      Description string read-only
(null)
The description of the assembly.
      EngineeringChangeLevel string read-only
(null)
The engineering change level of the assembly.
      Location (v1.3+) {} object The location of the assembly. For property details, see Location.
      LocationIndicatorActive (v1.3+) boolean read-write
(null)
An indicator allowing an operator to physically locate this resource.
      MemberId string read-only required The identifier for the member within the collection.
      Model string read-only
(null)
The model number of the assembly.
      Name string read-only
(null)
The name of the assembly.
      Oem {} object See the Oem object definition in the Common properties section.
      PartNumber string read-only
(null)
The part number of the assembly.
      PhysicalContext (v1.2+) string
(enum)
read-only The area or device to which the assembly data applies. For the possible property values, see PhysicalContext in Property details.
      Producer string read-only
(null)
The producer or manufacturer of the assembly.
      ProductionDate string
(date-time)
read-only
(null)
The production date of the assembly.
      SerialNumber (v1.2+) string read-only
(null)
The serial number of the assembly.
      SKU string read-only
(null)
The SKU of the assembly.
      SparePartNumber string read-only
(null)
The spare part number of the assembly.
      Status (v1.1+) {} object The status and health of the Resource and its subordinate or dependent Resources. For property details, see Status.
      Vendor string read-only
(null)
The vendor of the assembly.
      Version string read-only
(null)
The hardware version of the assembly.
} ]

6.9.4 Property details

6.9.4.1 PhysicalContext:

The area or device to which the assembly data applies.

string Description
Accelerator An accelerator.
ACInput An AC input.
ACMaintenanceBypassInput An AC maintenance bypass input.
ACOutput An AC output.
ACStaticBypassInput An AC static bypass input.
ACUtilityInput An AC utility input.
ASIC An ASIC device, such as a networking chip or chipset component.
Back The back of the chassis.
Backplane A backplane within the chassis.
Battery A battery.
Board A circuit board.
Chassis The entire chassis.
ComputeBay Within a compute bay.
CoolingSubsystem The entire cooling, or air and liquid, subsystem.
CPU A processor (CPU).
CPUSubsystem The entire processor (CPU) subsystem.
DCBus A DC bus.
Exhaust The air exhaust point or points or region of the chassis.
ExpansionBay Within an expansion bay.
Fan A fan.
FPGA An FPGA.
Front The front of the chassis.
GPU A graphics processor (GPU).
GPUSubsystem The entire graphics processor (GPU) subsystem.
Intake The air intake point or points or region of the chassis.
LiquidInlet The liquid inlet point of the chassis.
LiquidOutlet The liquid outlet point of the chassis.
Lower The lower portion of the chassis.
Memory A memory device.
MemorySubsystem The entire memory subsystem.
Motor A motor.
NetworkBay Within a networking bay.
NetworkingDevice A networking device.
PowerSubsystem The entire power subsystem.
PowerSupply A power supply.
PowerSupplyBay Within a power supply bay.
Pump A pump.
Rectifier A rectifier device.
Room The room.
StorageBay Within a storage bay.
StorageDevice A storage device.
SystemBoard The system board (PCB).
Transceiver A transceiver.
Transformer A transformer.
TrustedModule A trusted module.
Upper The upper portion of the chassis.
VoltageRegulator A voltage regulator device.

6.9.5 Example response

{
    "@odata.type": "#Assembly.v1_3_0.Assembly",
    "Id": "Assembly",
    "Name": "System-related Assembly data",
    "Assemblies": [
        {
            "@odata.id": "/redfish/v1/Chassis/1/Assembly#/Assemblies/0",
            "MemberId": "0",
            "Name": "System Board",
            "Description": "PCA System Board",
            "Model": "345TTT",
            "PartNumber": "923943",
            "SparePartNumber": "55-434",
            "SKU": "55ZZATR",
            "SerialNumber": "345394834",
            "Vendor": "Contoso",
            "ProductionDate": "2017-04-01T14:55:33+03:00",
            "Producer": "Contoso Supply Co.",
            "Version": "1.44B",
            "EngineeringChangeLevel": "9",
            "BinaryDataURI": "/dumpster/434",
            "Oem": {
                "Contoso": {
                    "Region": "C",
                    "Packaging": "Retail"
                }
            }
        },
        {
            "@odata.id": "/redfish/v1/Chassis/1/Assembly#/Assemblies/1",
            "MemberId": "1",
            "Name": "Fan Controller",
            "Description": "PCA Fan Controller",
            "Model": "F58AS",
            "PartNumber": "3434-149",
            "Vendor": "Contoso",
            "Version": "2.4.481",
            "BinaryDataURI": "/dumpster/422",
            "Status": {
                "State": "Enabled",
                "Health": "Warning"
            }
        }
    ],
    "@odata.id": "/redfish/v1/Chassis/1/Assembly"
}

6.10 AttributeRegistry 1.3.6

Version v1.3 v1.2 v1.1 v1.0
Release 2018.3 2018.1 2017.1 2016.1

6.10.1 Description

The AttributeRegistry schema contains a set of key-value pairs that represent the structure of an attribute registry. It includes mechanisms for building user interfaces, or menus, allowing consistent navigation of the contents. The attribute registry is specific to an implementation or product. The attributes and property names are not standardized.

6.10.2 Properties

Property Type Attributes Notes
Language string read-only required The RFC5646-conformant language code for the attribute registry.
OwningEntity string read-only required The organization or company that publishes this attribute registry.
RegistryEntries { object The list of all attributes and their metadata for this component.
      Attributes [ { array An array of attributes and their possible values in the attribute registry.
            AttributeName string read-only required The unique name for the attribute.
            CurrentValue string, boolean, number read-only
(null)
The placeholder of the current value for the attribute.
            DefaultValue string, boolean, number read-only
(null)
The default value for the attribute.
            DisplayName string read-only
(null)
The user-readable display string for the attribute in the defined language.
            DisplayOrder integer read-only
(null)
The ascending order, as a number, in which this attribute appears relative to other attributes.
            GrayOut boolean read-only
(null)
An indication of whether this attribute is grayed out. A grayed-out attribute is not active and is grayed out in user interfaces but the attribute value can be modified.
            HelpText string read-only
(null)
The help text for the attribute.
            Hidden boolean read-only
(null)
An indication of whether this attribute is hidden in user interfaces.
            Immutable boolean read-only
(null)
An indication of whether this attribute is immutable. Immutable attributes shall not be modified and typically reflect a hardware state.
            IsSystemUniqueProperty boolean read-only
(null)
An indication of whether this attribute is unique for this system and should not be replicated.
            LowerBound integer read-only
(null)
The lower limit for an integer attribute.
            MaxLength integer read-only
(null)
The maximum character length of a string attribute.
            MenuPath string read-only
(null)
The path that describes the menu hierarchy of this attribute.
            MinLength integer read-only
(null)
The minimum character length of the string attribute.
            Oem (v1.3+) {} object See the Oem object definition in the Common properties section.
            ReadOnly boolean read-only
(null)
An indication of whether this attribute is read-only. A read-only attribute cannot be modified, and should be grayed out in user interfaces.
            ResetRequired (v1.2+) boolean read-only
(null)
An indication of whether a system or device reset is required for this attribute value change to take effect.
            ScalarIncrement integer read-only
(null)
The amount to increment or decrement an integer attribute each time a user requests a value change. The 0 value indicates a free-form numeric user-input attribute.
            Type string
(enum)
read-only The attribute type. For the possible property values, see Type in Property details.
            UefiDevicePath (v1.2+) string read-only
(null)
The UEFI device path that qualifies this attribute.
            UefiKeywordName (v1.2+) string read-only The UEFI keyword string for this attribute.
            UefiNamespaceId (v1.2+) string read-only The UEFI namespace ID for the attribute.
            UpperBound integer read-only
(null)
The upper limit for an integer attribute.
            Value [ { array An array of the possible values for enumerated attribute values.
                  ValueDisplayName string read-only
(null)
A user-readable display string of the value for the attribute in the defined language.
                  ValueName string read-only required The unique value name for the attribute.
            } ]
            ValueExpression string read-only
(null)
A valid regular expression, according to the Perl regular expression dialect, that validates the attribute value. Applies to only string and integer attributes.
            WarningText string read-only
(null)
The warning text for the attribute.
            WriteOnly boolean read-only
(null)
An indication of whether this attribute is write-only. A write-only attribute reverts to its initial value after settings are applied.
      } ]
      Dependencies [ { array An array of dependencies of attributes on this component.
            Dependency { object The dependency expression for one or more attributes in this attribute registry.
                  MapFrom [ { array An array of the map-from conditions for a mapping dependency.
                        MapFromAttribute string read-only The attribute to use to evaluate this dependency expression.
                        MapFromCondition string
(enum)
read-only The condition to use to evaluate this dependency expression. For the possible property values, see MapFromCondition in Property details.
                        MapFromProperty string
(enum)
read-only The metadata property for the attribute that the MapFromAttribute property specifies to use to evaluate this dependency expression. For the possible property values, see MapFromProperty in Property details.
                        MapFromValue string, boolean, number read-only
(null)
The value to use to evaluate this dependency expression.
                        MapTerms string
(enum)
read-only The logical term that combines two or more map-from conditions in this dependency expression. For example, AND for logical AND, or OR for logical OR. For the possible property values, see MapTerms in Property details.
                  } ]
                  MapToAttribute string read-only The AttributeName of the attribute that is affected by this dependency expression.
                  MapToProperty string
(enum)
read-only The metadata property for the attribute that contains the map-from condition that evaluates this dependency expression. For the possible property values, see MapToProperty in Property details.
                  MapToValue string, boolean, number read-only
(null)
The value that the map-to property changes to if the dependency expression evaluates to true.
            }
            DependencyFor string read-only The AttributeName of the attribute whose change triggers the evaluation of this dependency expression.
            Type string
(enum)
read-only The type of the dependency structure. For the possible property values, see Type in Property details.
      } ]
      Menus [ { array An array for the attributes menus and their hierarchy in the attribute registry.
            DisplayName string read-only
(null)
The user-readable display string of this menu in the defined language.
            DisplayOrder integer read-only
(null)
The ascending order, as a number, in which this menu appears relative to other menus.
            GrayOut boolean read-only
(null)
An indication of whether this menu is grayed out. A grayed-only menu is not accessible in user interfaces.
            Hidden (v1.3+) boolean read-only
(null)
An indication of whether this menu is hidden in user interfaces.
            MenuName string read-only The unique name string of this menu.
            MenuPath string read-only
(null)
The path to the menu names that describes this menu hierarchy relative to other menus.
            Oem (v1.3+) {} object See the Oem object definition in the Common properties section.
            ReadOnly boolean read-only
(null)
An indication of whether this menu is read-only. A read-only menu, its properties, and sub-menus are not accessible in user interfaces.
      } ]
}
RegistryVersion string read-only required The attribute registry version.
SupportedSystems [ { array An array of systems that this attribute registry supports.
      FirmwareVersion (v1.1+) string read-only
(null)
Firmware version.
      ProductName string read-only
(null)
The product name of the computer system to which this attribute registry applies.
      SystemId string read-only
(null)
The ID of the systems to which this attribute registry applies.
} ]

6.10.3 Property details

6.10.3.1 MapFromCondition:

The condition to use to evaluate this dependency expression.

string Description
EQU The logical operation for 'Equal'.
GEQ The logical operation for 'Greater than or Equal'.
GTR The logical operation for 'Greater than'.
LEQ The logical operation for 'Less than or Equal'.
LSS The logical operation for 'Less than'.
NEQ The logical operation for 'Not Equal'.

6.10.3.2 MapFromProperty:

The metadata property for the attribute that the MapFromAttribute property specifies to use to evaluate this dependency expression.

string Description
CurrentValue The dependency on an attribute's CurrentValue.
DefaultValue The dependency on an attribute's DefaultValue.
GrayOut The dependency on an attribute's GrayOut state.
Hidden The dependency on an attribute's Hidden state.
LowerBound The dependency on an attribute's LowerBound.
MaxLength The dependency on an attribute's MaxLength.
MinLength The dependency on an attribute's MinLength.
ReadOnly The dependency on an attribute's ReadOnly state.
ScalarIncrement The dependency on an attribute's ScalarIncrement.
UpperBound The dependency on an attribute's UpperBound.
WriteOnly The dependency on an attribute's WriteOnly state.

6.10.3.3 MapTerms:

The logical term that combines two or more map-from conditions in this dependency expression. For example, AND for logical AND, or OR for logical OR.

string Description
AND The operation used for logical 'AND' of dependency terms.
OR The operation used for logical 'OR' of dependency terms.

6.10.3.4 MapToProperty:

The metadata property for the attribute that contains the map-from condition that evaluates this dependency expression.

string Description
CurrentValue The dependency that affects an attribute's CurrentValue.
DefaultValue The dependency that affects an attribute's DefaultValue.
DisplayName The dependency that affects an attribute's DisplayName.
DisplayOrder The dependency that affects an attribute's DisplayName.
GrayOut The dependency that affects an attribute's GrayOut state.
HelpText The dependency that affects an attribute's HelpText.
Hidden The dependency that affects an attribute's Hidden state.
Immutable The dependency that affects an attribute's Immutable state.
LowerBound The dependency that affects an attribute's LowerBound.
MaxLength The dependency that affects an attribute's MaxLength.
MinLength The dependency that affects an attribute's MinLength.
ReadOnly The dependency that affects an attribute's ReadOnly state.
ScalarIncrement The dependency that affects an attribute's ScalarIncrement.
UpperBound The dependency that affects an attribute's UpperBound.
ValueExpression The dependency that affects an attribute's ValueExpression.
WarningText The dependency that affects an attribute's WarningText.
WriteOnly The dependency that affects an attribute's WriteOnly state.

6.10.3.5 Type:

6.10.3.5.1 In RegistryEntries: Attributes:

The attribute type.

string Description
Boolean A flag with a true or false value.
Enumeration A list of the known possible enumerated values.
Integer An integer value.
Password Password values that do not appear as plain text. The value shall be null in responses.
String Free-form text in their values.
6.10.3.5.2 In RegistryEntries: Dependencies:

The type of the dependency structure.

string Description
Map A simple mapping dependency. If the condition evaluates to true, the attribute or state changes to the mapped value.

6.10.4 Example response

{
    "@odata.type": "#AttributeRegistry.v1_3_6.AttributeRegistry",
    "Description": "This registry defines a representation of BIOS Attribute instances",
    "Id": "BiosAttributeRegistryG9000.v1_0_0",
    "Language": "en",
    "Name": "G9000 BIOS Attribute Registry",
    "OwningEntity": "Contoso",
    "RegistryVersion": "1.0.0",
    "SupportedSystems": [
        {
            "ProductName": "Contoso Server GLH9000",
            "SystemId": "G9000",
            "FirmwareVersion": "v1.00 (06/02/2014)"
        }
    ],
    "RegistryEntries": {
        "Attributes": [
            {
                "CurrentValue": null,
                "DisplayName": "Embedded NIC 1 Boot",
                "DisplayOrder": 5,
                "HelpText": "Select this option to enable network boot (PXE, iSCSI, or FCoE) for the selected NIC. You may need to configure the NIC firmware for the boot option to be active.",
                "MenuPath": "./SystemOptions/NetworkBootOptions",
                "AttributeName": "NicBoot1",
                "ReadOnly": false,
                "Hidden": false,
                "Type": "Enumeration",
                "Value": [
                    {
                        "ValueDisplayName": "Network Boot",
                        "ValueName": "NetworkBoot"
                    },
                    {
                        "ValueDisplayName": "Disabled",
                        "ValueName": "Disabled"
                    }
                ],
                "WarningText": "Important: When enabling network boot support for an embedded NIC, the NIC boot option does not appear in the UEFI Boot Order or Legacy IPL lists until the next system reboot."
            },
            {
                "CurrentValue": null,
                "DisplayName": "Embedded SATA Configuration",
                "DisplayOrder": 74,
                "HelpText": "Important: Select this option to configure the embedded chipset SATA controller.",
                "MenuPath": "./SystemOptions/SataOptions",
                "AttributeName": "EmbeddedSata",
                "ReadOnly": false,
                "Hidden": false,
                "Type": "Enumeration",
                "Value": [
                    {
                        "ValueDisplayName": "Enable SATA AHCI Support",
                        "ValueName": "Ahci"
                    },
                    {
                        "ValueDisplayName": "Enable Software RAID Support",
                        "ValueName": "Raid"
                    }
                ],
                "WarningText": "Important: Software RAID is not supported when the Boot Mode is configured in Legacy BIOS Mode."
            }
        ],
        "Dependencies": [
            {
                "Dependency": {
                    "MapFrom": [
                        {
                            "MapFromAttribute": "BootMode",
                            "MapFromCondition": "EQU",
                            "MapFromProperty": "CurrentValue",
                            "MapFromValue": "LegacyBios"
                        }
                    ],
                    "MapToAttribute": "EmbeddedSata",
                    "MapToProperty": "ReadOnly",
                    "MapToValue": true
                },
                "DependencyFor": "EmbeddedSata",
                "Type": "Map"
            }
        ],
        "Menus": [
            {
                "DisplayName": "BIOS Configuration",
                "DisplayOrder": 1,
                "MenuPath": "./",
                "MenuName": "BiosMainMenu",
                "Hidden": false,
                "ReadOnly": false
            },
            {
                "DisplayName": "System Options",
                "DisplayOrder": 2,
                "MenuPath": "./SystemOptions",
                "MenuName": "SystemOptions",
                "Hidden": false,
                "ReadOnly": false
            }
        ]
    }
}

6.11 Battery 1.0.1

Version v1.0
Release 2021.2

6.11.1 Description

The Battery schema describes a battery unit, such as those used to provide systems with power during a power loss event.

6.11.2 URIs

/​redfish/​v1/​Chassis/​{ChassisId}/​PowerSubsystem/​Batteries/​{BatteryId}

6.11.3 Properties

Property Type Attributes Notes
Assembly { object The link to the assembly associated with this battery. See the Assembly schema for details on this property.
      @odata.id string read-only Link to a Assembly resource. See the Links section and the Assembly schema for details.
}
CapacityActualAmpHours number
(A.h)
read-only
(null)
The actual maximum capacity of this battery in amp-hours.
CapacityActualWattHours number
(W.h)
read-only
(null)
The actual maximum capacity of this battery in watt-hours.
CapacityRatedAmpHours number
(A.h)
read-only
(null)
The rated maximum capacity of this battery in amp-hours.
CapacityRatedWattHours number
(W.h)
read-only
(null)
The rated maximum capacity of this battery in watt-hours.
ChargeState string
(enum)
read-only
(null)
The charge state of this battery. For the possible property values, see ChargeState in Property details.
FirmwareVersion string read-only
(null)
The firmware version for this battery.
HotPluggable boolean read-only
(null)
An indication of whether this device can be inserted or removed while the equipment is in operation.
Location {} object The location of the battery. For property details, see Location.
LocationIndicatorActive boolean read-write
(null)
An indicator allowing an operator to physically locate this resource.
Manufacturer string read-only
(null)
The manufacturer of this battery.
MaxChargeRateAmps number
(A)
read-only
(null)
The maximum charge rate of this battery in amps.
MaxChargeVoltage number
(Volts)
read-only
(null)
The maximum charge voltage of this battery.
MaxDischargeRateAmps number
(A)
read-only
(null)
The maximum discharge rate of this battery in amps.
Metrics { object The link to the battery metrics resource associated with this battery. See the BatteryMetrics schema for details on this property.
      @odata.id string read-only Link to a BatteryMetrics resource. See the Links section and the BatteryMetrics schema for details.
}
Model string read-only
(null)
The model number for this battery.
PartNumber string read-only
(null)
The part number for this battery.
ProductionDate string
(date-time)
read-only
(null)
The production or manufacturing date of this battery.
SerialNumber string read-only
(null)
The serial number for this battery.
SparePartNumber string read-only
(null)
The spare part number for this battery.
StateOfHealthPercent { object
(excerpt)
The state of health (percent) of this battery. This object is an excerpt of the Sensor resource located at the URI shown in DataSourceUri.
      DataSourceUri string
(URI)
read-only
(null)
The link to the resource that provides the data for this sensor.
      Reading number read-only
(null)
The sensor value.
}
Status {} object The status and health of the resource and its subordinate or dependent resources. For property details, see Status.
Version string read-only
(null)
The hardware version of this battery.

6.11.4 Actions

6.11.4.1 Calibrate

Description

This action performs a self-calibration, or learn cycle, of the battery.

Action URI: {Base URI of target resource}/Actions/Battery.Calibrate

Action parameters

This action takes no parameters.

6.11.4.2 Reset

Description

This action resets the battery.

Action URI: {Base URI of target resource}/Actions/Battery.Reset

Action parameters

Parameter Name Type Attributes Notes
      ResetType string
(enum)
optional The type of reset. For the possible property values, see ResetType in Property details.

6.11.4.3 SelfTest

Description

This action performs a self-test of the battery.

Action URI: {Base URI of target resource}/Actions/Battery.SelfTest

Action parameters

This action takes no parameters.

6.11.5 Property details

6.11.5.1 ChargeState:

The charge state of this battery.

string Description
Charging The battery is charging.
Discharging The battery is discharging.
Idle The battery is idle.

6.11.5.2 ResetType:

The type of reset.

string Description
ForceOff Turn off the unit immediately (non-graceful shutdown).
ForceOn Turn on the unit immediately.
ForceRestart Shut down immediately and non-gracefully and restart the system.
GracefulRestart Shut down gracefully and restart the system.
GracefulShutdown Shut down gracefully and power off.
Nmi Generate a diagnostic interrupt, which is usually an NMI on x86 systems, to stop normal operations, complete diagnostic actions, and, typically, halt the system.
On Turn on the unit.
Pause Pause execution on the unit but do not remove power. This is typically a feature of virtual machine hypervisors.
PowerCycle Power cycle the unit. Behaves like a full power removal, followed by a power restore to the resource.
PushPowerButton Simulate the pressing of the physical power button on this unit.
Resume Resume execution on the paused unit. This is typically a feature of virtual machine hypervisors.
Suspend Write the state of the unit to disk before powering off. This allows for the state to be restored when powered back on.

6.11.6 Example response

{
    "@odata.type": "#Battery.v1_0_1.Battery",
    "Id": "Module1",
    "Name": "Battery 1",
    "Status": {
        "State": "Enabled",
        "Health": "OK"
    },
    "Actions": {
        "#Battery.SelfTest": {
            "target": "/redfish/v1/Chassis/1U/PowerSubsystem/Batteries/Module1/Actions/Battery.SelfTest"
        },
        "#Battery.Calibrate": {
            "target": "/redfish/v1/Chassis/1U/PowerSubsystem/Batteries/Module1/Actions/Battery.Calibrate"
        }
    },
    "Location": {
        "PartLocation": {
            "ServiceLabel": "Battery 1",
            "LocationType": "Bay",
            "LocationOrdinalValue": 0
        }
    },
    "Model": "RKS-440DC",
    "Manufacturer": "Contoso Power",
    "FirmwareVersion": "1.00",
    "Version": "A05",
    "ProductionDate": "2019-10-01T06:00:00Z",
    "SerialNumber": "3488247",
    "PartNumber": "23456-133",
    "SparePartNumber": "93284-133",
    "LocationIndicatorActive": false,
    "HotPluggable": true,
    "CapacityRatedWattHours": 20,
    "CapacityActualWattHours": 19.41,
    "MaxDischargeRateAmps": 10,
    "StateOfHealthPercent": {
        "DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/Battery1StateOfHealth",
        "Reading": 91
    },
    "ChargeState": "Idle",
    "Metrics": {
        "@odata.id": "/redfish/v1/Chassis/1U/PowerSubsystem/Batteries/Module1/Metrics"
    },
    "@odata.id": "/redfish/v1/Chassis/1U/PowerSubsystem/Batteries/Module1"
}

6.12 BatteryMetrics 1.0.1

Version v1.0
Release 2021.2

6.12.1 Description

The BatteryMetrics schema contains definitions for the metrics of a battery unit.

6.12.2 URIs

/​redfish/​v1/​Chassis/​{ChassisId}/​PowerSubsystem/​Batteries/​{BatteryId}/​Metrics

6.12.3 Properties

Property Type Attributes Notes
CellVoltages [ { array
(excerpt)
The cell voltages (V) for this battery. This object is an excerpt of the Sensor resource located at the URI shown in DataSourceUri.
      CrestFactor (v1.1+) number read-only
(null)
The crest factor for this sensor.
      DataSourceUri string
(URI)
read-only
(null)
The link to the resource that provides the data for this sensor.
      Reading number read-only
(null)
The sensor value.
      THDPercent (v1.1+) number read-only
(null)
The total harmonic distortion (THD).
} ]
ChargePercent {} object The amount of charge available (percent) in this battery. For more information about this property, see SensorExcerpt in Property Details.
DischargeCycles number read-only
(null)
The number of discharges this battery sustained.
InputCurrentAmps { object
(excerpt)
The input current (A) for this battery. This object is an excerpt of the Sensor resource located at the URI shown in DataSourceUri.
      CrestFactor (v1.1+) number read-only
(null)
The crest factor for this sensor.
      DataSourceUri string
(URI)
read-only
(null)
The link to the resource that provides the data for this sensor.
      Reading number read-only
(null)
The sensor value.
      THDPercent (v1.1+) number read-only
(null)
The total harmonic distortion (THD).
}
InputVoltage { object
(excerpt)
The input voltage (V) for this battery. This object is an excerpt of the Sensor resource located at the URI shown in DataSourceUri.
      CrestFactor (v1.1+) number read-only
(null)
The crest factor for this sensor.
      DataSourceUri string
(URI)
read-only
(null)
The link to the resource that provides the data for this sensor.
      Reading number read-only
(null)
The sensor value.
      THDPercent (v1.1+) number read-only
(null)
The total harmonic distortion (THD).
}
OutputCurrentAmps [ { array
(excerpt)
The output currents (A) for this battery. This object is an excerpt of the Sensor resource located at the URI shown in DataSourceUri.
      CrestFactor (v1.1+) number read-only
(null)
The crest factor for this sensor.
      DataSourceUri string
(URI)
read-only
(null)
The link to the resource that provides the data for this sensor.
      Reading number read-only
(null)
The sensor value.
      THDPercent (v1.1+) number read-only
(null)
The total harmonic distortion (THD).
} ]
OutputVoltages [ { array
(excerpt)
The output voltages (V) for this battery. This object is an excerpt of the Sensor resource located at the URI shown in DataSourceUri.
      CrestFactor (v1.1+) number read-only
(null)
The crest factor for this sensor.
      DataSourceUri string
(URI)
read-only
(null)
The link to the resource that provides the data for this sensor.
      Reading number read-only
(null)
The sensor value.
      THDPercent (v1.1+) number read-only
(null)
The total harmonic distortion (THD).
} ]
Status {} object The status and health of the resource and its subordinate or dependent resources. For property details, see Status.
StoredChargeAmpHours {} object The charge (Ah) stored in this battery. For more information about this property, see SensorExcerpt in Property Details.
StoredEnergyWattHours {} object The energy (Wh) stored in this battery. For more information about this property, see SensorExcerpt in Property Details.
TemperatureCelsius {} object The temperature (C) for this battery. For more information about this property, see SensorExcerpt in Property Details.

6.12.4 Property details

6.12.4.1 SensorExcerpt:

The Sensor schema describes a sensor and its properties. This object is an excerpt of the Sensor resource located at the URI shown in DataSourceUri.

DataSourceUri string
(URI)
read-only
(null)
The link to the resource that provides the data for this sensor.
Reading number read-only
(null)
The sensor value.

6.12.5 Example response

{
    "@odata.type": "#BatteryMetrics.v1_0_1.BatteryMetrics",
    "Id": "Metrics",
    "Name": "Metrics for Battery 1",
    "DischargeCycles": 8.67,
    "InputVoltage": {
        "DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/Battery1InputVoltage",
        "Reading": 12.22
    },
    "InputCurrentAmps": {
        "DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/Battery1InputCurrent",
        "Reading": 0
    },
    "OutputVoltages": [
        {
            "DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/Battery1OutputVoltage",
            "Reading": 12.22
        }
    ],
    "OutputCurrentAmps": [
        {
            "DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/Battery1OutputCurrent",
            "Reading": 0
        }
    ],
    "StoredEnergyWattHours": {
        "Reading": 19.41
    },
    "TemperatureCelsius": {
        "DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/Battery1Temp",
        "Reading": 33
    },
    "ChargePercent": {
        "Reading": 100
    },
    "CellVoltages": [
        {
            "Reading": 3.44
        },
        {
            "Reading": 3.45
        },
        {
            "Reading": 3.43
        },
        {
            "Reading": 3.43
        },
        {
            "Reading": 3.45
        },
        {
            "Reading": 3.44
        },
        {
            "Reading": 3.43
        },
        {
            "Reading": 3.44
        }
    ],
    "@odata.id": "/redfish/v1/Chassis/1U/PowerSubsystem/Batteries/Module1/Metrics"
}

6.13 Bios 1.2.0

Version v1.2 v1.1 v1.0
Release 2021.1 2019.2 2016.1

6.13.1 Description

The Bios schema contains properties related to the BIOS attribute registry. The attribute registry describes the system-specific BIOS attributes and actions for changing to BIOS settings. Changes to the BIOS typically require a system reset before they take effect. It is likely that a client finds the @Redfish.Settings term in this resource, and if it is found, the client makes requests to change BIOS settings by modifying the resource identified by the @Redfish.Settings term.

6.13.2 URIs

/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Bios
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Bios
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Bios

6.13.3 Properties

Property Type Attributes Notes
AttributeRegistry string read-only
(null)
The resource ID of the attribute registry that has the system-specific information about a BIOS resource.
Attributes { object The list of BIOS attributes specific to the manufacturer or provider.
      (pattern) string, boolean, number read-write
(null)
Property names follow regular expression pattern "^[A-Za-z][A-Za-z0-9_]+$"
}
Links (v1.1+) { object The links to other resources that are related to this resource.
      ActiveSoftwareImage (v1.1+) { object The link to the software inventory that represents the active BIOS firmware image. See the SoftwareInventory schema for details on this property.
            @odata.id string read-write Link to a SoftwareInventory resource. See the Links section and the SoftwareInventory schema for details.
      }
      Oem {} object See the Oem object definition in the Common properties section.
      SoftwareImages (v1.1+) [ { array The images that are associated with this BIOS.
            @odata.id string read-only Link to a SoftwareInventory resource. See the Links section and the SoftwareInventory schema for details.
      } ]
}
ResetBiosToDefaultsPending (v1.2+) boolean read-only
(null)
An indication of whether there is a pending request to reset the BIOS attributes to default values.

6.13.4 Actions

6.13.4.1 ChangePassword

Description

This action changes a BIOS password.

Action URI: {Base URI of target resource}/Actions/Bios.ChangePassword

Action parameters

Parameter Name Type Attributes Notes
      NewPassword string required The new BIOS password.
      OldPassword string required The existing BIOS password.
      PasswordName string required The name of the BIOS password to change.

Request Example

{
    "OldPassword": "secret123",
    "NewPassword": "B3tterS3cur1tY!",
    "PasswordName": "Admin"
}

6.13.4.2 ResetBios

Description

This action resets the BIOS attributes to default.

Action URI: {Base URI of target resource}/Actions/Bios.ResetBios

Action parameters

This action takes no parameters.

6.13.5 Example response

{
    "@odata.type": "#Bios.v1_2_0.Bios",
    "Id": "BIOS",
    "Name": "BIOS Configuration Current Settings",
    "AttributeRegistry": "BiosAttributeRegistryP89.v1_0_0",
    "Attributes": {
        "AdminPhone": "",
        "BootMode": "Uefi",
        "EmbeddedSata": "Raid",
        "NicBoot1": "NetworkBoot",
        "NicBoot2": "Disabled",
        "PowerProfile": "MaxPerf",
        "ProcCoreDisable": 0,
        "ProcHyperthreading": "Enabled",
        "ProcTurboMode": "Enabled",
        "UsbControl": "UsbEnabled"
    },
    "@Redfish.Settings": {
        "@odata.type": "#Settings.v1_3_4.Settings",
        "ETag": "9234ac83b9700123cc32",
        "Messages": [
            {
                "MessageId": "Base.1.0.SettingsFailed",
                "RelatedProperties": [
                    "#/Attributes/ProcTurboMode"
                ]
            }
        ],
        "SettingsObject": {
            "@odata.id": "/redfish/v1/Systems/437XR1138R2/Bios/Settings"
        },
        "Time": "2016-03-07T14:44.30-05:00"
    },
    "Actions": {
        "#Bios.ResetBios": {
            "target": "/redfish/v1/Systems/437XR1138R2/Bios/Actions/Bios.ResetBios"
        },
        "#Bios.ChangePassword": {
            "target": "/redfish/v1/Systems/437XR1138R2/Bios/Actions/Bios.ChangePassword"
        }
    },
    "@odata.id": "/redfish/v1/Systems/437XR1138R2/Bios"
}

6.14 BootOption 1.0.4

Version v1.0
Release 2017.3

6.14.1 Description

The BootOption schema reports information about a single boot option in a system. It represents the properties of a bootable device available in the system.

6.14.2 URIs

/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​BootOptions/​{BootOptionId}
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​BootOptions/​{BootOptionId}
/​redfish/​v1/​Systems/​{ComputerSystemId}/​BootOptions/​{BootOptionId}

6.14.3 Properties

Property Type Attributes Notes
Alias string
(enum)
read-only
(null)
The alias of this boot source. For the possible property values, see Alias in Property details.
BootOptionEnabled boolean read-write
(null)
An indication of whether the boot option is enabled. If true, it is enabled. If false, the boot option that the boot order array on the computer system contains is skipped. In the UEFI context, this property shall influence the load option active flag for the boot option.
BootOptionReference string read-only required
(null)
The unique boot option.
DisplayName string read-only
(null)
The user-readable display name of the boot option that appears in the boot order list in the user interface.
RelatedItem [ { array An array of links to resources or objects associated with this boot option.
      @odata.id string
(URI)
read-only The unique identifier for a resource.
} ]
UefiDevicePath string read-only
(null)
The UEFI device path to access this UEFI boot option.

6.14.4 Property details

6.14.4.1 Alias:

The alias of this boot source.

string Description
BiosSetup Boot to the BIOS setup utility.
Cd Boot from the CD or DVD.
Diags Boot to the manufacturer's diagnostics program.
Floppy Boot from the floppy disk drive.
Hdd Boot from a hard drive.
None Boot from the normal boot device.
Pxe Boot from the Pre-Boot EXecution (PXE) environment.
RemoteDrive Boot from a remote drive, such as an iSCSI target.
SDCard Boot from an SD card.
UefiBootNext Boot to the UEFI device that the BootNext property specifies.
UefiHttp Boot from a UEFI HTTP network location.
UefiShell Boot to the UEFI Shell.
UefiTarget Boot to the UEFI device specified in the UefiTargetBootSourceOverride property.
Usb Boot from a system BIOS-specified USB device.
Utilities Boot to the manufacturer's utilities program or programs.

6.14.5 Example response

{
    "@odata.type": "#BootOption.v1_0_4.BootOption",
    "Id": "1",
    "Name": "Boot Option",
    "Description": "UEFI Boot Option",
    "BootOptionReference": "Boot0000",
    "DisplayName": "Windows Boot Manager",
    "UefiDevicePath": "PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x0)/Scsi(0x0,0x0)/HD(2,GPT,B02BF459-8975-4222-A1C4-17915C29E5E5,0x96800,0x31800)/\\EFI\\Microsoft\\Boot\\bootmgfw.efi",
    "Alias": "Hdd",
    "RelatedItem": [
        {
            "@odata.id": "/redfish/v1/Systems/1/SimpleStorage/1"
        }
    ],
    "Oem": {},
    "@odata.id": "/redfish/v1/Systems/1/BootOptions/1"
}

6.15 Cable 1.2.0

Version v1.2 v1.1 v1.0
Release 2021.4 2021.3 2021.2

6.15.1 Description

The Cable schema contains properties that describe a cable connecting endpoints of a chassis, port, or any other cable-compatible endpoint.

6.15.2 URIs

/​redfish/​v1/​Cables/​{CableId}

6.15.3 Properties

Property Type Attributes Notes
Assembly { object The link to the assembly associated with this cable. See the Assembly schema for details on this property.
      @odata.id string read-only Link to a Assembly resource. See the Links section and the Assembly schema for details.
}
AssetTag string read-write
(null)
The user-assigned asset tag for this cable.
CableClass string
(enum)
read-write
(null)
The identifier for the downstream resource. For the possible property values, see CableClass in Property details.
CableStatus string
(enum)
read-write The user-reported status of this resource. For the possible property values, see CableStatus in Property details.
CableType string read-write
(null)
The type of this cable.
DownstreamConnectorTypes [ ] array (string
(enum))
read-write The connector types this cable supports. For the possible property values, see DownstreamConnectorTypes in Property details.
DownstreamName string read-write
(null)
The identifier for the downstream resource.
LengthMeters number read-write
(null)
The length of the cable in meters.
Links { object The links to other resources that are related to this resource.
      DownstreamChassis [ { array An array of links to the downstream chassis connected to this cable.
            @odata.id string read-write Link to a Chassis resource. See the Links section and the Chassis schema for details.
      } ]
      DownstreamPorts [ { array An array of links to the downstream ports connected to this cable.
            @odata.id string read-write Link to a Port resource. See the Links section and the Port schema for details.
      } ]
      DownstreamResources [ { array An array of links to the downstream resources connected to this cable.
            @odata.id string
(URI)
read-only The unique identifier for a resource.
      } ]
      Oem {} object See the Oem object definition in the Common properties section.
      UpstreamChassis [ { array An array of links to the upstream chassis connected to this cable.
            @odata.id string read-write Link to a Chassis resource. See the Links section and the Chassis schema for details.
      } ]
      UpstreamPorts [ { array An array of links to the upstream ports connected to this cable.
            @odata.id string read-write Link to a Port resource. See the Links section and the Port schema for details.
      } ]
      UpstreamResources [ { array An array of links to the upstream resources connected to this cable.
            @odata.id string
(URI)
read-only The unique identifier for a resource.
      } ]
}
Location {} object The location of the assembly. For property details, see Location.
Manufacturer string read-write
(null)
The manufacturer of this cable.
Model string read-write
(null)
The model number of the cable.
PartNumber string read-write
(null)
The part number for this cable.
SerialNumber string read-write
(null)
The serial number for this cable.
SKU string read-write
(null)
The SKU for this cable.
Status {} object The status and health of the resource and its subordinate or dependent resources. For property details, see Status.
UpstreamConnectorTypes [ ] array (string
(enum))
read-write The connector types this cable supports. For the possible property values, see UpstreamConnectorTypes in Property details.
UpstreamName string read-write
(null)
The identifier for the downstream resource.
UserDescription string read-write
(null)
The description of this cable.
UserLabel (v1.1+) string read-write A user-assigned label.
Vendor string read-write
(null)
The manufacturer of this cable.

6.15.4 Property details

6.15.4.1 CableClass:

The identifier for the downstream resource.

string Description
Fabric This cable is used for connecting to a fabric.
Fan This cable is used for connecting to a fan system.
General This cable is used for providing general connectivity.
Network This cable is used for connecting to a networking system.
PCIe This cable is used for connecting to a PCIe endpoint.
Power This cable is used for connecting to a power system.
Serial This cable is used for connecting to a serial endpoint.
Storage This cable is used for connecting to a storage system.
USB This cable is used for connecting to a USB endpoint.
Video This cable is used for connecting to a video system.

6.15.4.2 CableStatus:

The user-reported status of this resource.

string Description
Degraded The cable is degraded.
Disabled The cable is disabled.
Failed The cable has failed.
Normal The cable is operating normally.
SetByService The cable status is set by the service.
Testing The cable is under test.

6.15.4.3 DownstreamConnectorTypes:

The connector types this cable supports.

string Description
ACPower This cable connects to a AC power connector.
CDFP This cable connects to a CDFP connector.
DB9 This cable connects to a DB9 connector.
DCPower This cable connects to a DC power connector.
DisplayPort This cable connects to a DisplayPort power connector.
HDMI This cable connects to an HDMI connector.
ICI This cable connects to an ICI connector.
IPASS This cable connects to an IPASS connector.
OSFP This cable connects to a OSFP connector.
PCIe This cable connects to a PCIe connector.
Proprietary This cable connects to a proprietary connector.
QSFP This cable connects to a QSFP connector.
RJ45 This cable connects to an RJ45 connector.
SATA This cable connects to a SATA connector.
SCSI This cable connects to a SCSI connector.
SFP This cable connects to a SFP connector.
SFPPlus This cable connects to a SFPPlus connector.
SlimSAS This cable connects to a SlimSAS connector.
USBA This cable connects to a USB-A connector.
USBC This cable connects to a USB-C connector.

6.15.4.4 UpstreamConnectorTypes:

The connector types this cable supports.

string Description
ACPower This cable connects to a AC power connector.
CDFP This cable connects to a CDFP connector.
DB9 This cable connects to a DB9 connector.
DCPower This cable connects to a DC power connector.
DisplayPort This cable connects to a DisplayPort power connector.
HDMI This cable connects to an HDMI connector.
ICI This cable connects to an ICI connector.
IPASS This cable connects to an IPASS connector.
OSFP This cable connects to a OSFP connector.
PCIe This cable connects to a PCIe connector.
Proprietary This cable connects to a proprietary connector.
QSFP This cable connects to a QSFP connector.
RJ45 This cable connects to an RJ45 connector.
SATA This cable connects to a SATA connector.
SCSI This cable connects to a SCSI connector.
SFP This cable connects to a SFP connector.
SFPPlus This cable connects to a SFPPlus connector.
SlimSAS This cable connects to a SlimSAS connector.
USBA This cable connects to a USB-A connector.
USBC This cable connects to a USB-C connector.

6.15.5 Example response

{
    "@odata.type": "#Cable.v1_2_0.Cable",
    "Id": "hdmi_dp",
    "Name": "HDMI to DP Cable",
    "UserDescription": "HDMI to DisplayPort Cable",
    "UpstreamName": "HDMI0",
    "DownstreamName": "Video Out",
    "CableType": "HDMI",
    "LengthMeters": 0.1,
    "CableClass": "Video",
    "UpstreamConnectorTypes": [
        "HDMI"
    ],
    "DownstreamConnectorTypes": [
        "DisplayPort"
    ],
    "Links": {
        "UpstreamChassis": [
            {
                "@odata.id": "/redfish/v1/Chassis/bmc"
            }
        ]
    },
    "PartNumber": "934AMS02X",
    "Manufacturer": "Cable Co.",
    "SerialNumber": "2345791",
    "Vendor": "Cablestore",
    "Status": {
        "State": "Enabled",
        "Health": "OK"
    },
    "CableStatus": "Normal",
    "@odata.id": "/redfish/v1/Cables/hdmi_dp"
}

6.16 Certificate 1.5.0

Version v1.5 v1.4 v1.3 v1.2 v1.1 v1.0
Release 2021.3 2021.2 2021.1 2020.1 2019.1 2018.3

6.16.1 Description

The Certificate schema describes a certificate that proves the identify of a component, account, or service.

6.16.2 URIs

/​redfish/​v1/​AccountService/​Accounts/​{ManagerAccountId}/​Certificates/​{CertificateId}
/​redfish/​v1/​AccountService/​ActiveDirectory/​Certificates/​{CertificateId}
/​redfish/​v1/​AccountService/​ExternalAccountProviders/​{ExternalAccountProviderId}/​Certificates/​{CertificateId}
/​redfish/​v1/​AccountService/​LDAP/​Certificates/​{CertificateId}
/​redfish/​v1/​Chassis/​{ChassisId}/​Certificates/​{CertificateId}
/​redfish/​v1/​Chassis/​{ChassisId}/​Drives/​{DriveId}/​Certificates/​{CertificateId}
/​redfish/​v1/​Chassis/​{ChassisId}/​Memory/​{MemoryId}/​Certificates/​{CertificateId}
/​redfish/​v1/​Chassis/​{ChassisId}/​NetworkAdapters/​{NetworkAdapterId}/​Certificates/​{CertificateId}
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Drives/​{DriveId}/​Certificates/​{CertificateId}
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Memory/​{MemoryId}/​Certificates/​{CertificateId}
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Processors/​{ProcessorId}/​Certificates/​{CertificateId}
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​Controllers/​{StorageControllerId}/​Certificates/​{CertificateId}
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​Drives/​{DriveId}/​Certificates/​{CertificateId}
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​StorageControllers/​{StorageControllerId}/​Certificates/​{CertificateId}
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Boot/​Certificates/​{CertificateId}
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Certificates/​{CertificateId}
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​KeyManagement/​KMIPCertificates
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Memory/​{MemoryId}/​Certificates/​{CertificateId}
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Processors/​{ProcessorId}/​Certificates/​{CertificateId}
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​SecureBoot/​SecureBootDatabases/​{DatabaseId}/​Certificates/​{CertificateId}
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Controllers/​{StorageControllerId}/​Certificates/​{CertificateId}
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Drives/​{DriveId}/​Certificates/​{CertificateId}
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​StorageControllers/​{StorageControllerId}/​Certificates/​{CertificateId}
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​VirtualMedia/​{VirtualMediaId}/​Certificates/​{CertificateId}
/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​VirtualMedia/​{VirtualMediaId}/​ClientCertificates/​{CertificateId}
/​redfish/​v1/​EventService/​Subscriptions/​{EventDestinationId}/​Certificates/​{CertificateId}
/​redfish/​v1/​EventService/​Subscriptions/​{EventDestinationId}/​ClientCertificates/​{CertificateId}
/​redfish/​v1/​Fabrics/​{FabricId}/​Switches/​{SwitchId}/​Certificates/​{CertificateId}
/​redfish/​v1/​Managers/​{ManagerId}/​Certificates/​{CertificateId}
/​redfish/​v1/​Managers/​{ManagerId}/​NetworkProtocol/​HTTPS/​Certificates/​{CertificateId}
/​redfish/​v1/​Managers/​{ManagerId}/​RemoteAccountService/​Accounts/​{ManagerAccountId}/​Certificates/​{CertificateId}
/​redfish/​v1/​Managers/​{ManagerId}/​RemoteAccountService/​ActiveDirectory/​Certificates/​{CertificateId}
/​redfish/​v1/​Managers/​{ManagerId}/​RemoteAccountService/​ExternalAccountProviders/​{ExternalAccountProviderId}/​Certificates/​{CertificateId}
/​redfish/​v1/​Managers/​{ManagerId}/​RemoteAccountService/​LDAP/​Certificates/​{CertificateId}
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Drives/​{DriveId}/​Certificates/​{CertificateId}
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Memory/​{MemoryId}/​Certificates/​{CertificateId}
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Processors/​{ProcessorId}/​Certificates/​{CertificateId}
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​Controllers/​{StorageControllerId}/​Certificates/​{CertificateId}
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​Drives/​{DriveId}/​Certificates/​{CertificateId}
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Storage/​{StorageId}/​StorageControllers/​{StorageControllerId}/​Certificates/​{CertificateId}
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Boot/​Certificates/​{CertificateId}
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Certificates/​{CertificateId}
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​KeyManagement/​KMIPCertificates
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Memory/​{MemoryId}/​Certificates/​{CertificateId}
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Processors/​{ProcessorId}/​Certificates/​{CertificateId}
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​SecureBoot/​SecureBootDatabases/​{DatabaseId}/​Certificates/​{CertificateId}
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Controllers/​{StorageControllerId}/​Certificates/​{CertificateId}
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Drives/​{DriveId}/​Certificates/​{CertificateId}
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​StorageControllers/​{StorageControllerId}/​Certificates/​{CertificateId}
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​VirtualMedia/​{VirtualMediaId}/​Certificates/​{CertificateId}
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​VirtualMedia/​{VirtualMediaId}/​ClientCertificates/​{CertificateId}
/​redfish/​v1/​Storage/​{StorageId}/​Controllers/​{StorageControllerId}/​Certificates/​{CertificateId}
/​redfish/​v1/​Storage/​{StorageId}/​StorageControllers/​{StorageControllerId}/​Certificates/​{CertificateId}
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Boot/​Certificates/​{CertificateId}
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Certificates/​{CertificateId}
/​redfish/​v1/​Systems/​{ComputerSystemId}/​KeyManagement/​KMIPCertificates
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Memory/​{MemoryId}/​Certificates/​{CertificateId}
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Processors/​{ProcessorId}/​Certificates/​{CertificateId}
/​redfish/​v1/​Systems/​{ComputerSystemId}/​SecureBoot/​SecureBootDatabases/​{DatabaseId}/​Certificates/​{CertificateId}
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Controllers/​{StorageControllerId}/​Certificates/​{CertificateId}
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​Drives/​{DriveId}/​Certificates/​{CertificateId}
/​redfish/​v1/​Systems/​{ComputerSystemId}/​Storage/​{StorageId}/​StorageControllers/​{StorageControllerId}/​Certificates/​{CertificateId}
/​redfish/​v1/​Systems/​{ComputerSystemId}/​VirtualMedia/​{VirtualMediaId}/​Certificates/​{CertificateId}
/​redfish/​v1/​Systems/​{ComputerSystemId}/​VirtualMedia/​{VirtualMediaId}/​ClientCertificates/​{CertificateId}
/​redfish/​v1/​UpdateService/​ClientCertificates/​{CertificateId}
/​redfish/​v1/​UpdateService/​RemoteServerCertificates/​{CertificateId}

6.16.3 Properties

Property Type Attributes Notes
CertificateString string read-only required on create
(null)
The string for the certificate.
CertificateType string
(enum)
read-only required on create
(null)
The format of the certificate. For the possible property values, see CertificateType in Property details.
CertificateUsageTypes (v1.4+) [ ] array (string
(enum))
read-only
(null)
The types or purposes for this certificate. For the possible property values, see CertificateUsageTypes in Property details.
Fingerprint (v1.3+) string read-only The fingerprint of the certificate.
FingerprintHashAlgorithm (v1.3+) string read-only The hash algorithm for the fingerprint of the certificate.
Issuer { object The issuer of the certificate.
      City string read-only The city or locality of the organization of the entity.
      CommonName string read-only The fully qualified domain name of the entity.
      Country string read-only The country of the organization of the entity.
      Email string read-only
(null)
The email address of the contact within the organization of the entity.
      Organization string read-only The name of the organization of the entity.
      OrganizationalUnit string read-only The name of the unit or division of the organization of the entity.
      State string read-only The state, province, or region of the organization of the entity.
}
KeyUsage [ ] array (string
(enum))
read-only
(null)
The key usage extension, which defines the purpose of the public keys in this certificate. For the possible property values, see KeyUsage in Property details.
Links (v1.4+) { object The links to other resources that are related to this resource.
      Issuer (v1.4+) { object
(null)
A link to the certificate of the CA that issued this certificate.
            @odata.id string read-write Link to another Certificate resource.
      }
      Oem {} object See the Oem object definition in the Common properties section.
      Subjects (v1.4+) [ { array An array of links to certificates that were issued by the CA that is represented by this certificate.
            @odata.id string read-write Link to another Certificate resource.
      } ]
}
SerialNumber (v1.3+) string read-only The serial number of the certificate.
SignatureAlgorithm (v1.3+) string read-only The algorithm used for creating the signature of the certificate.
SPDM (v1.5+) { object
(null)
SPDM-related information for the certificate.
      SlotId (v1.5+) integer read-only
(null)
Slot identifier of the certificate.
}
Subject { object The subject of the certificate.
      City string read-only The city or locality of the organization of the entity.
      CommonName string read-only The fully qualified domain name of the entity.
      Country string read-only The country of the organization of the entity.
      Email string read-only
(null)
The email address of the contact within the organization of the entity.
      Organization string read-only The name of the organization of the entity.
      OrganizationalUnit string read-only The name of the unit or division of the organization of the entity.
      State string read-only The state, province, or region of the organization of the entity.
}
UefiSignatureOwner (v1.2+) string read-only
(null)
The UEFI signature owner for this certificate.
ValidNotAfter string
(date-time)
read-only The date when the certificate is no longer valid.
ValidNotBefore string
(date-time)
read-only The date when the certificate becomes valid.

6.16.4 Actions

6.16.4.1 Rekey (v1.1+)

Description

This action generates a new key-pair for a certificate and produces a certificate signing request.

Action URI: {Base URI of target resource}/Actions/Certificate.Rekey

Action parameters

Parameter Name Type Attributes Notes
      ChallengePassword string optional The challenge password to apply to the certificate for revocation requests.
      KeyBitLength integer optional The length of the key, in bits, if needed based on the KeyPairAlgorithm parameter value.
      KeyCurveId string optional The curve ID to use with the key, if needed based on the KeyPairAlgorithm parameter value.
      KeyPairAlgorithm string optional The type of key-pair for use with signing algorithms.

Response Payload

{
      Certificate (v1.1+) { object * required* The link to the certificate being rekeyed.
            @odata.id string read-only Link to another Certificate resource.
      }
      CSRString (v1.1+) string read-only required The string for the certificate signing request.
}

Request Example

{
    "KeyPairAlgorithm": "TPM_ALG_RSA",
    "KeyBitLength": 4096
}

Response Example

{
    "CSRString": "-----BEGIN CERTIFICATE REQUEST-----...-----END CERTIFICATE REQUEST-----",
    "Certificate": {
        "@odata.id": "/redfish/v1/Managers/BMC/NetworkProtocol/HTTPS/Certificates/1"
    }
}

6.16.4.2 Renew (v1.1+)

Description

This action generates a certificate signing request by using the existing information and key-pair of the certificate.

Action URI: {Base URI of target resource}/Actions/Certificate.Renew

Action parameters

Parameter Name Type Attributes Notes
      ChallengePassword string optional The challenge password to apply to the certificate for revocation requests.

Response Payload

{
      Certificate (v1.1+) { object * required* The link to the certificate being renewed.
            @odata.id string read-only Link to another Certificate resource.
      }
      CSRString (v1.1+) string read-only required The string for the certificate signing request.
}

Request Example

{
    "ChallengePassword": "p4ssw0rd"
}

Response Example

{
    "CSRString": "-----BEGIN CERTIFICATE REQUEST-----...-----END CERTIFICATE REQUEST-----",
    "Certificate": {
        "@odata.id": "/redfish/v1/Managers/BMC/NetworkProtocol/HTTPS/Certificates/1"
    }
}

6.16.5 Property details

6.16.5.1 CertificateType:

The format of the certificate.

string Description
PEM A Privacy Enhanced Mail (PEM)-encoded single certificate.
PEMchain (v1.4+) A Privacy Enhanced Mail (PEM)-encoded certificate chain.
PKCS7 A Privacy Enhanced Mail (PEM)-encoded PKCS7 certificate.

6.16.5.2 CertificateUsageTypes:

The types or purposes for this certificate.

string Description
BIOS This certificate is a BIOS certificate like those associated with UEFI.
Device This certificate is a device type certificate like those associated with SPDM and other standards.
Platform This certificate is a platform type certificate like those associated with SPDM and other standards.
SSH This certificate is used for SSH.
User This certificate is a user certificate like those associated with a manager account.
Web This certificate is a web or HTTPS certificate like those used for event destinations.

6.16.5.3 KeyUsage:

The key usage extension, which defines the purpose of the public keys in this certificate.

string Description
ClientAuthentication TLS WWW client authentication.
CodeSigning Signs downloadable executable code.
CRLSigning Verifies signatures on certificate revocation lists (CRLs).
DataEncipherment Directly enciphers raw user data without an intermediate symmetric cipher.
DecipherOnly Deciphers data while performing a key agreement.
DigitalSignature Verifies digital signatures, other than signatures on certificates and CRLs.
EmailProtection Email protection.
EncipherOnly Enciphers data while performing a key agreement.
KeyAgreement Key agreement.
KeyCertSign Verifies signatures on public key certificates.
KeyEncipherment Enciphers private or secret keys.
NonRepudiation Verifies digital signatures, other than signatures on certificates and CRLs, and provides a non-repudiation service that protects against the signing entity falsely denying some action.
OCSPSigning Signs OCSP responses.
ServerAuthentication TLS WWW server authentication.
Timestamping Binds the hash of an object to a time.

6.16.6 Example response

{
    "@odata.type": "#Certificate.v1_5_0.Certificate",
    "Id": "1",
    "Name": "HTTPS Certificate",
    "CertificateString": "-----BEGIN CERTIFICATE-----\nMIIFsTCC [*truncated*] GXG5zljlu\n-----END CERTIFICATE-----",
    "CertificateType": "PEM",
    "Issuer": {
        "Country": "US",
        "State": "Oregon",
        "City": "Portland",
        "Organization": "Contoso",
        "OrganizationalUnit": "ABC",
        "CommonName": "manager.contoso.org"
    },
    "Subject": {
        "Country": "US",
        "State": "Oregon",
        "City": "Portland",
        "Organization": "Contoso",
        "OrganizationalUnit": "ABC",
        "CommonName": "manager.contoso.org"
    },
    "ValidNotBefore": "2018-09-07T13:22:05Z",
    "ValidNotAfter": "2019-09-07T13:22:05Z",
    "KeyUsage": [
        "KeyEncipherment",
        "ServerAuthentication"
    ],
    "SerialNumber": "5d:7a:d8:df:f6:fc:c1:b3:ca:fe:fb:cc:38:f3:01:64:51:ea:05:cb",
    "Fingerprint": "A6:E9:D2:5C:DC:52:DA:4B:3B:14:97:F3:A4:53:D9:99:A1:0B:56:41",
    "FingerprintHashAlgorithm": "TPM_ALG_SHA1",
    "SignatureAlgorithm": "sha256WithRSAEncryption",
    "Oem": {},
    "@odata.id": "/redfish/v1/Managers/BMC/NetworkProtocol/HTTPS/Certificates/1"
}

6.17 CertificateLocations 1.0.2

Version v1.0
Release 2018.3

6.17.1 Description

The CertificateLocations schema describes a Resource that an administrator can use in order to locate all certificates installed on a given service.

6.17.2 URIs

/​redfish/​v1/​CertificateService/​CertificateLocations

6.17.3 Properties

Property Type Attributes Notes
Links { object The links to other Resources that are related to this Resource.
      Certificates [ { array An array of links to the certificates installed on this service.
            @odata.id string read-only Link to a Certificate resource. See the Links section and the Certificate schema for details.
      } ]
      Oem {} object See the Oem object definition in the Common properties section.
}

6.17.4 Example response

{
    "@odata.type": "#CertificateLocations.v1_0_2.CertificateLocations",
    "Id": "CertificateLocations",
    "Name": "Certificate Locations",
    "Links": {
        "Certificates": [
            {
                "@odata.id": "/redfish/v1/Managers/BMC/NetworkProtocol/HTTPS/Certificates/1"
            }
        ]
    },
    "Oem": {},
    "@odata.id": "/redfish/v1/CertificateService/CertificateLocations"
}

6.18 CertificateService 1.0.4

Version v1.0
Release 2018.3

6.18.1 Description

The CertificateService schema describes a certificate service that represents the actions available to manage certificates and links to the certificates.

6.18.2 URIs

/​redfish/​v1/​CertificateService

6.18.3 Properties

Property Type Attributes Notes
CertificateLocations { object The information about the location of certificates. See the CertificateLocations schema for details on this property.
      @odata.id string read-only Link to a CertificateLocations resource. See the Links section and the CertificateLocations schema for details.
}

6.18.4 Actions

6.18.4.1 GenerateCSR

Description

This action makes a certificate signing request.

Action URI: {Base URI of target resource}/Actions/CertificateService.GenerateCSR

Action parameters

Parameter Name Type Attributes Notes
      AlternativeNames [ ] array (string) optional The additional host names of the component to secure.
      CertificateCollection { object required The link to the certificate collection where the certificate is installed after the certificate authority (CA) signs the certificate. Contains a link to a resource.
            @odata.id string read-only Link to Collection of Certificate. See the Certificate schema for details.
      }
      ChallengePassword string optional The challenge password to apply to the certificate for revocation requests.
      City string required The city or locality of the organization making the request.
      CommonName string required The fully qualified domain name of the component to secure.
      ContactPerson string optional The name of the user making the request.
      Country string required The two-letter country code of the organization making the request.
      Email string optional The email address of the contact within the organization making the request.
      GivenName string optional The given name of the user making the request.
      Initials string optional The initials of the user making the request.
      KeyBitLength integer optional The length of the key, in bits, if needed based on the KeyPairAlgorithm parameter value.
      KeyCurveId string optional The curve ID to use with the key, if needed based on the KeyPairAlgorithm parameter value.
      KeyPairAlgorithm string optional The type of key-pair for use with signing algorithms.
      KeyUsage [ ] array (string
(enum))
read-write The usage of the key contained in the certificate. For the possible property values, see KeyUsage in Property details.
      Organization string required The name of the organization making the request.
      OrganizationalUnit string required The name of the unit or division of the organization making the request.
      State string required The state, province, or region of the organization making the request.
      Surname string optional The surname of the user making the request.
      UnstructuredName string optional The unstructured name of the subject.

Response Payload

{
      CertificateCollection { object * required* The link to the certificate collection where the certificate is installed. Contains a link to a resource.
            @odata.id string read-only Link to Collection of Certificate. See the Certificate schema for details.
      }
      CSRString string read-only required The string for the certificate signing request.
}

Request Example

{
    "Country": "US",
    "State": "Oregon",
    "City": "Portland",
    "Organization": "Contoso",
    "OrganizationalUnit": "ABC",
    "CommonName": "manager.contoso.org",
    "AlternativeNames": [
        "manager.contoso.com",
        "manager.contoso.us"
    ],
    "Email": "admin@contoso.org",
    "KeyPairAlgorithm": "TPM_ALG_RSA",
    "KeyBitLength": 4096,
    "KeyUsage": [
        "KeyEncipherment",
        "ServerAuthentication"
    ],
    "CertificateCollection": {
        "@odata.id": "/redfish/v1/Managers/BMC/NetworkProtocol/HTTPS/Certificates"
    }
}

Response Example

{
    "CSRString": "-----BEGIN CERTIFICATE REQUEST-----...-----END CERTIFICATE REQUEST-----",
    "CertificateCollection": {
        "@odata.id": "/redfish/v1/Managers/BMC/NetworkProtocol/HTTPS/Certificates"
    }
}

6.18.4.2 ReplaceCertificate

Description

This action replaces a certificate.

Action URI: {Base URI of target resource}/Actions/CertificateService.ReplaceCertificate

Action parameters

Parameter Name Type Attributes Notes
      CertificateString string required The string for the certificate.
      CertificateType string
(enum)
required The format of the certificate. For the possible property values, see CertificateType in Property details.
      CertificateUri { object required The link to the certificate that is being replaced. See the Certificate schema for details on this property.
            @odata.id string read-only Link to a Certificate resource. See the Links section and the Certificate schema for details.
      }

Request Example

{
    "CertificateUri": {
        "@odata.id": "/redfish/v1/Managers/BMC/NetworkProtocol/HTTPS/Certificates/1"
    },
    "CertificateString": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----",
    "CertificateType": "PEM"
}

6.18.5 Property details

6.18.5.1 CertificateType:

The format of the certificate.

string Description
PEM A Privacy Enhanced Mail (PEM)-encoded single certificate.
PEMchain A Privacy Enhanced Mail (PEM)-encoded certificate chain.
PKCS7 A Privacy Enhanced Mail (PEM)-encoded PKCS7 certificate.

6.18.5.2 KeyUsage:

The usage of the key contained in the certificate.

string Description
ClientAuthentication TLS WWW client authentication.
CodeSigning Signs downloadable executable code.
CRLSigning Verifies signatures on certificate revocation lists (CRLs).
DataEncipherment Directly enciphers raw user data without an intermediate symmetric cipher.
DecipherOnly Deciphers data while performing a key agreement.
DigitalSignature Verifies digital signatures, other than signatures on certificates and CRLs.
EmailProtection Email protection.
EncipherOnly Enciphers data while performing a key agreement.
KeyAgreement Key agreement.
KeyCertSign Verifies signatures on public key certificates.
KeyEncipherment Enciphers private or secret keys.
NonRepudiation Verifies digital signatures, other than signatures on certificates and CRLs, and provides a non-repudiation service that protects against the signing entity falsely denying some action.
OCSPSigning Signs OCSP responses.
ServerAuthentication TLS WWW server authentication.
Timestamping Binds the hash of an object to a time.

6.18.6 Example response

{
    "@odata.type": "#CertificateService.v1_0_4.CertificateService",
    "Id": "CertificateService",
    "Name": "Certificate Service",
    "Actions": {
        "#CertificateService.GenerateCSR": {
            "target": "/redfish/v1/CertificateService/Actions/CertificateService.GenerateCSR",
            "@Redfish.ActionInfo": "/redfish/v1/CertificateService/GenerateCSRActionInfo"
        },
        "#CertificateService.ReplaceCertificate": {
            "target": "/redfish/v1/CertificateService/Actions/CertificateService.ReplaceCertificate",
            "@Redfish.ActionInfo": "/redfish/v1/CertificateService/ReplaceCertificateActionInfo"
        }
    },
    "CertificateLocations": {
        "@odata.id": "/redfish/v1/CertificateService/CertificateLocations"
    },
    "Oem": {},
    "@odata.id": "/redfish/v1/CertificateService"
}

6.19 Chassis 1.19.0

Version v1.19 v1.18 v1.17 v1.16 v1.15 v1.14 v1.13 v1.12 v1.11 v1.10 v1.9 ...
Release 2021.4 2021.3 2021.2 2021.1 2020.4 2020.3 2020.2 2020.1 2019.4 2019.2 2018.3 ...

6.19.1 Description

The Chassis schema represents the physical components of a system. This resource represents the sheet-metal confined spaces and logical zones such as racks, enclosures, chassis and all other containers. Subsystems, such as sensors, that operate outside of a system's data plane are linked either directly or indirectly through this resource. A subsystem that operates outside of a system's data plane are not accessible to software that runs on the system.

6.19.2 URIs

/​redfish/​v1/​Chassis/​{ChassisId}

6.19.3 Properties

Property Type Attributes Notes
Assembly (v1.6+) { object The link to the assembly associated with this chassis. See the Assembly schema for details on this property.
      @odata.id string read-only Link to a Assembly resource. See the Links section and the Assembly schema for details.
}
AssetTag string read-write
(null)
The user-assigned asset tag of this chassis.
Certificates (v1.15+) { object The link to a collection of certificates for device identity and attestation. Contains a link to a resource.
      @odata.id string read-only Link to Collection of Certificate. See the Certificate schema for details.
}
ChassisType string
(enum)
read-only required The type of physical form factor of the chassis. For the possible property values, see ChassisType in Property details.
Controls (v1.17+) { object The link to the collection of controls located in this chassis. Contains a link to a resource.
      @odata.id string read-only Link to Collection of Control. See the Control schema for details.
}
DepthMm (v1.4+) number
(mm)
read-only
(null)
The depth of the chassis.
Drives (v1.14+) { object The link to the collection of drives within this chassis. Contains a link to a resource.
      @odata.id string read-only Link to Collection of Drive. See the Drive schema for details.
}
ElectricalSourceManagerURIs (v1.18+) [ ] array
(URI) (string, null)
read-write The URIs of the management interfaces for the upstream electrical source connections for this chassis.
ElectricalSourceNames (v1.18+) [ ] array (string, null) read-write The names of the upstream electrical sources, such as circuits or outlets, connected to this chassis.
EnvironmentalClass (v1.9+) string
(enum)
read-only
(null)
The ASHRAE Environmental Class for this chassis. For the possible property values, see EnvironmentalClass in Property details.
EnvironmentMetrics (v1.15+) { object The link to the environment metrics for this chassis. See the EnvironmentMetrics schema for details on this property.
      @odata.id string read-only Link to a EnvironmentMetrics resource. See the Links section and the EnvironmentMetrics schema for details.
}
HeightMm (v1.4+) number
(mm)
read-only
(null)
The height of the chassis.
IndicatorLED (deprecated v1.14) string
(enum)
read-write
(null)
The state of the indicator LED, which identifies the chassis. For the possible property values, see IndicatorLED in Property details. Deprecated in v1.14 and later. This property has been deprecated in favor of the LocationIndicatorActive property.
Links { object The links to other resources that are related to this resource.
      Cables (v1.17+) [ { array An array of links to the cables connected to this chassis.
            @odata.id string read-only Link to a Cable resource. See the Links section and the Cable schema for details.
      } ]
      ComputerSystems [ { array An array of links to the computer systems that this chassis directly and wholly contains.
            @odata.id string read-only Link to a ComputerSystem resource. See the Links section and the ComputerSystem schema for details.
      } ]
      ContainedBy { object The link to the chassis that contains this chassis.
            @odata.id string read-write Link to another Chassis resource.
      }
      Contains [ { array An array of links to any other chassis that this chassis has in it.
            @odata.id string read-write Link to another Chassis resource.
      } ]
      CooledBy [ { array An array of links to resources or objects that cool this chassis. Normally, the link is for either a chassis or a specific set of fans.
            @odata.id string
(URI)
read-only The unique identifier for a resource.
      } ]
      Drives (v1.2+) [ { array An array of links to the drives located in this chassis.
            @odata.id string read-only Link to a Drive resource. See the Links section and the Drive schema for details.
      } ]
      Facility (v1.11+) { object The link to the facility that contains this chassis. See the Facility schema for details on this property.
            @odata.id string read-write Link to a Facility resource. See the Links section and the Facility schema for details.
      }
      ManagedBy [ { array An array of links to the managers responsible for managing this chassis.
            @odata.id string read-only Link to a Manager resource. See the Links section and the Manager schema for details.
      } ]
      ManagersInChassis (v1.2+) [ { array An array of links to the managers located in this chassis.
            @odata.id string read-only Link to a Manager resource. See the Links section and the Manager schema for details.
      } ]
      Oem {} object See the Oem object definition in the Common properties section.
      PCIeDevices (v1.4+, deprecated v1.10 [ { array An array of links to the PCIe devices located in this chassis. Deprecated in v1.10 and later. This property has been deprecated in favor of the PCIeDevices resource collection in the root of this resource.
            @odata.id string read-only Link to a PCIeDevice resource. See the Links section and the PCIeDevice schema for details.
      } ]
      PoweredBy [ { array An array of links to resources or objects that power this chassis. Normally, the link is for either a chassis or a specific set of power supplies.
            @odata.id string
(URI)
read-only The unique identifier for a resource.
      } ]
      PowerOutlets (v1.18+) [ { array An array of links to the outlets that provide power to this chassis.
            @odata.id string read-write Link to a Outlet resource. See the Links section and the Outlet schema for details.
      } ]
      Processors (v1.9+) [ { array An array of links to the processors located in this chassis.
            @odata.id string read-only Link to a Processor resource. See the Links section and the Processor schema for details.
      } ]
      ResourceBlocks (v1.5+) [ { array An array of links to the resource blocks located in this chassis.
            @odata.id string read-only Link to a ResourceBlock resource. See the Links section and the ResourceBlock schema for details.
      } ]
      Storage (v1.2+) [ { array An array of links to the storage subsystems connected to or inside this chassis.
            @odata.id string read-only Link to a Storage resource. See the Links section and the Storage schema for details.
      } ]
      Switches (v1.7+) [ { array An array of links to the switches located in this chassis.
            @odata.id string read-only Link to a Switch resource. See the Links section and the Switch schema for details.
      } ]
}
Location (v1.2+) {} object The location of the chassis. For property details, see Location.
LocationIndicatorActive (v1.14+) boolean read-write
(null)
An indicator allowing an operator to physically locate this resource.
LogServices { object The link to the logs for this chassis. Contains a link to a resource.
      @odata.id string read-only Link to Collection of LogService. See the LogService schema for details.
}
Manufacturer string read-only
(null)
The manufacturer of this chassis.
MaxPowerWatts (v1.12+) number
(Watts)
read-only
(null)
The upper bound of the total power consumed by the chassis.
Measurements (v1.15+, deprecated v1.19 [ { array An array of DSP0274-defined measurement blocks. Deprecated in v1.19 and later. This property has been deprecated in favor of the ComponentIntegrity resource.
      @odata.id string read-only Link to a MeasurementBlock resource. See the Links section and the SoftwareInventory schema for details.
} ]
MediaControllers (v1.11+) { object The link to the collection of media controllers located in this chassis. Contains a link to a resource.
      @odata.id string read-only Link to Collection of MediaController. See the MediaController schema for details.
}
Memory (v1.11+) { object The link to the collection of memory located in this chassis. Contains a link to a resource.
      @odata.id string read-only Link to Collection of Memory. See the Memory schema for details.
}
MemoryDomains (v1.11+) { object The link to the collection of memory domains located in this chassis. Contains a link to a resource.
      @odata.id string read-only Link to Collection of MemoryDomain. See the MemoryDomain schema for details.
}
MinPowerWatts (v1.12+) number
(Watts)
read-only
(null)
The lower bound of the total power consumed by the chassis.
Model string read-only
(null)
The model number of the chassis.
NetworkAdapters (v1.4+) { object The link to the collection of network adapters associated with this chassis. Contains a link to a resource.
      @odata.id string read-only Link to Collection of NetworkAdapter. See the NetworkAdapter schema for details.
}
PartNumber string read-only
(null)
The part number of the chassis.
PCIeDevices (v1.10+) { object The link to the collection of PCIe devices located in this chassis. Contains a link to a resource.
      @odata.id string read-only Link to Collection of PCIeDevice. See the PCIeDevice schema for details.
}
PCIeSlots (v1.8+) { object The link to the PCIe slot properties for this chassis. See the PCIeSlots schema for details on this property.
      @odata.id string read-only Link to a PCIeSlots resource. See the Links section and the PCIeSlots schema for details.
}
PhysicalSecurity (v1.1+) { object The state of the physical security sensor.
      IntrusionSensor (v1.1+) string
(enum)
read-write
(null)
This indicates the known state of the physical security sensor, such as if it is hardware intrusion detected. For the possible property values, see IntrusionSensor in Property details.
      IntrusionSensorNumber (v1.1+) integer read-only
(null)
A numerical identifier to represent the physical security sensor.
      IntrusionSensorReArm (v1.1+) string
(enum)
read-only
(null)
The method that restores this physical security sensor to the normal state. For the possible property values, see IntrusionSensorReArm in Property details.
}
Power (deprecated v1.15) { object The link to the power properties, or power supplies, power policies, and sensors, for this chassis. See the Power schema for details on this property. Deprecated in v1.15 and later. This link has been deprecated in favor of the PowerSubsystem link property.
      @odata.id string read-only Link to a Power resource. See the Links section and the Power schema for details.
}
PowerState (v1.0.1+) string
(enum)
read-only
(null)
The current power state of the chassis. For the possible property values, see PowerState in Property details.
PowerSubsystem (v1.15+) { object The link to the power subsystem properties for this chassis. See the PowerSubsystem schema for details on this property.
      @odata.id string read-only Link to a PowerSubsystem resource. See the Links section and the PowerSubsystem schema for details.
}
Sensors (v1.9+) { object The link to the collection of sensors located in the equipment and sub-components. Contains a link to a resource.
      @odata.id string read-only Link to Collection of Sensor. See the Sensor schema for details.
}
SerialNumber string read-only
(null)
The serial number of the chassis.
SKU string read-only
(null)
The SKU of the chassis.
SparePartNumber (v1.16+) string read-only
(null)
The spare part number of the chassis.
Status {} object The status and health of the resource and its subordinate or dependent resources. For property details, see Status.
Thermal (deprecated v1.15) { object The link to the thermal properties, such as fans, cooling, and sensors, for this chassis. See the Thermal schema for details on this property. Deprecated in v1.15 and later. This link has been deprecated in favor of the ThermalSubsystem link property.
      @odata.id string read-only Link to a Thermal resource. See the Links section and the Thermal schema for details.
}
ThermalSubsystem (v1.15+) { object The link to the thermal subsystem properties for this chassis. See the ThermalSubsystem schema for details on this property.
      @odata.id string read-only Link to a ThermalSubsystem resource. See the Links section and the ThermalSubsystem schema for details.
}
UUID (v1.7+) string read-only
(null)
The UUID for this chassis.
WeightKg (v1.4+) number
(kg)
read-only
(null)
The weight of the chassis.
WidthMm (v1.4+) number
(mm)
read-only
(null)
The width of the chassis.

6.19.4 Actions

6.19.4.1 Reset

Description

This action resets the chassis but does not reset systems or other contained resources, although side effects can occur that affect those resources.

Action URI: {Base URI of target resource}/Actions/Chassis.Reset

Action parameters

Parameter Name Type Attributes Notes
      ResetType string
(enum)
optional The type of reset. For the possible property values, see ResetType in Property details.

Request Example

{
    "ResetType": "ForceRestart"
}

6.19.5 Property details

6.19.5.1 ChassisType:

The type of physical form factor of the chassis.

string Description
Blade An enclosed or semi-enclosed, typically vertically-oriented, system chassis that must be plugged into a multi-system chassis to function normally.
Card A loose device or circuit board intended to be installed in a system or other enclosure.
Cartridge A small self-contained system intended to be plugged into a multi-system chassis.
Component A small chassis, card, or device that contains devices for a particular subsystem or function.
Drawer An enclosed or semi-enclosed, typically horizontally-oriented, system chassis that can be slid into a multi-system chassis.
Enclosure A generic term for a chassis that does not fit any other description.
Expansion A chassis that expands the capabilities or capacity of another chassis.
IPBasedDrive (v1.3+) A chassis in a drive form factor with IP-based network connections.
Module A small, typically removable, chassis or card that contains devices for a particular subsystem or function.
Other A chassis that does not fit any of these definitions.
Pod A collection of equipment racks in a large, likely transportable, container.
Rack An equipment rack, typically a 19-inch wide freestanding unit.
RackGroup (v1.4+) A group of racks that form a single entity or share infrastructure.
RackMount A single-system chassis designed specifically for mounting in an equipment rack.
Row A collection of equipment racks.
Shelf An enclosed or semi-enclosed, typically horizontally-oriented, system chassis that must be plugged into a multi-system chassis to function normally.
Sidecar A chassis that mates mechanically with another chassis to expand its capabilities or capacity.
Sled An enclosed or semi-enclosed, system chassis that must be plugged into a multi-system chassis to function normally similar to a blade type chassis.
StandAlone A single, free-standing system, commonly called a tower or desktop chassis.
StorageEnclosure (v1.6+) A chassis that encloses storage.
Zone A logical division or portion of a physical chassis that contains multiple devices or systems that cannot be physically separated.

6.19.5.2 EnvironmentalClass:

The ASHRAE Environmental Class for this chassis.

string Description
A1 ASHRAE Environmental Class 'A1'.
A2 ASHRAE Environmental Class 'A2'.
A3 ASHRAE Environmental Class 'A3'.
A4 ASHRAE Environmental Class 'A4'.

6.19.5.3 IndicatorLED:

The state of the indicator LED, which identifies the chassis.

string Description
Blinking The indicator LED is blinking.
Lit The indicator LED is lit.
Off The indicator LED is off.
Unknown (deprecated v1.2) The state of the indicator LED cannot be determined. Deprecated in v1.2 and later. This value has been deprecated in favor of returning null if the state is unknown.

6.19.5.4 IntrusionSensor:

This indicates the known state of the physical security sensor, such as if it is hardware intrusion detected.

string Description
HardwareIntrusion A door, lock, or other mechanism protecting the internal system hardware from being accessed is detected to be in an insecure state.
Normal No abnormal physical security condition is detected at this time.
TamperingDetected Physical tampering of the monitored entity is detected.

6.19.5.5 IntrusionSensorReArm:

The method that restores this physical security sensor to the normal state.

string Description
Automatic Because no abnormal physical security condition is detected, this sensor is automatically restored to the normal state.
Manual A manual re-arm of this sensor restores it to the normal state.

6.19.5.6 PowerState:

The current power state of the chassis.

string Description
Off The components within the chassis have no power, except some components might continue to have AUX power, such as the management controller.
On The components within the chassis have power.
PoweringOff A temporary state between on and off. The components within the chassis can take time to process the power off action.
PoweringOn A temporary state between off and on. The components within the chassis can take time to process the power on action.

6.19.5.7 ResetType:

The type of reset.

string Description
ForceOff Turn off the unit immediately (non-graceful shutdown).
ForceOn Turn on the unit immediately.
ForceRestart Shut down immediately and non-gracefully and restart the system.
GracefulRestart Shut down gracefully and restart the system.
GracefulShutdown Shut down gracefully and power off.
Nmi Generate a diagnostic interrupt, which is usually an NMI on x86 systems, to stop normal operations, complete diagnostic actions, and, typically, halt the system.
On Turn on the unit.
Pause Pause execution on the unit but do not remove power. This is typically a feature of virtual machine hypervisors.
PowerCycle Power cycle the unit. Behaves like a full power removal, followed by a power restore to the resource.
PushPowerButton Simulate the pressing of the physical power button on this unit.
Resume Resume execution on the paused unit. This is typically a feature of virtual machine hypervisors.
Suspend Write the state of the unit to disk before powering off. This allows for the state to be restored when powered back on.

6.19.6 Example response

{
    "@odata.type": "#Chassis.v1_19_0.Chassis",
    "Id": "1U",
    "Name": "Computer System Chassis",
    "ChassisType": "RackMount",
    "AssetTag": "Chicago-45Z-2381",
    "Manufacturer": "Contoso",
    "Model": "3500RX",
    "SKU": "8675309",
    "SerialNumber": "437XR1138R2",
    "PartNumber": "224071-J23",
    "PowerState": "On",
    "LocationIndicatorActive": true,
    "Location": {
        "Placement": {
            "Row": "North",
            "Rack": "WEB43",
            "RackOffsetUnits": "EIA_310",
            "RackOffset": 12
        }
    },
    "Status": {
        "State": "Enabled",
        "Health": "OK"
    },
    "HeightMm": 44.45,
    "WidthMm": 431.8,
    "DepthMm": 711,
    "WeightKg": 15.31,
    "EnvironmentalClass": "A3",
    "Sensors": {
        "@odata.id": "/redfish/v1/Chassis/1U/Sensors"
    },
    "PowerSubsystem": {
        "@odata.id": "/redfish/v1/Chassis/1U/PowerSubsystem"
    },
    "ThermalSubsystem": {
        "@odata.id": "/redfish/v1/Chassis/1U/ThermalSubsystem"
    },
    "EnvironmentMetrics": {
        "@odata.id": "/redfish/v1/Chassis/1U/EnvironmentMetrics"
    },
    "Links": {
        "ComputerSystems": [
            {
                "@odata.id": "/redfish/v1/Systems/437XR1138R2"
            }
        ],
        "ManagedBy": [
            {
                "@odata.id": "/redfish/v1/Managers/BMC"
            }
        ],
        "ManagersInChassis": [
            {
                "@odata.id": "/redfish/v1/Managers/BMC"
            }
        ],
        "Oem": {}
    },
    "Oem": {},
    "@odata.id": "/redfish/v1/Chassis/1U"
}

6.20 Circuit 1.5.0

Version v1.5 v1.4 v1.3 v1.2 v1.1 v1.0
Release 2021.4 2021.3 2021.2 2020.4 2020.3 2019.4

6.20.1 Description

This is the schema definition for an electrical circuit.

6.20.2 URIs

/​redfish/​v1/​PowerEquipment/​ElectricalBuses/​{PowerDistributionId}/​Branches/​{CircuitId}
/​redfish/​v1/​PowerEquipment/​ElectricalBuses/​{PowerDistributionId}/​Mains/​{CircuitId}
/​redfish/​v1/​PowerEquipment/​FloorPDUs/​{PowerDistributionId}/​Branches/​{CircuitId}
/​redfish/​v1/​PowerEquipment/​FloorPDUs/​{PowerDistributionId}/​Mains/​{CircuitId}
/​redfish/​v1/​PowerEquipment/​FloorPDUs/​{PowerDistributionId}/​Subfeeds/​{CircuitId}
/​redfish/​v1/​PowerEquipment/​PowerShelves/​{PowerDistributionId}/​Branches/​{CircuitId}
/​redfish/​v1/​PowerEquipment/​PowerShelves/​{PowerDistributionId}/​Mains/​{CircuitId}
/​redfish/​v1/​PowerEquipment/​RackPDUs/​{PowerDistributionId}/​Branches/​{CircuitId}
/​redfish/​v1/​PowerEquipment/​RackPDUs/​{PowerDistributionId}/​Mains/​{CircuitId}
/​redfish/​v1/​PowerEquipment/​Switchgear/​{PowerDistributionId}/​Branches/​{CircuitId}
/​redfish/​v1/​PowerEquipment/​Switchgear/​{PowerDistributionId}/​Feeders/​{CircuitId}
/​redfish/​v1/​PowerEquipment/​Switchgear/​{PowerDistributionId}/​Mains/​{CircuitId}
/​redfish/​v1/​PowerEquipment/​Switchgear/​{PowerDistributionId}/​Subfeeds/​{CircuitId}
/​redfish/​v1/​PowerEquipment/​TransferSwitches/​{PowerDistributionId}/​Branches/​{CircuitId}
/​redfish/​v1/​PowerEquipment/​TransferSwitches/​{PowerDistributionId}/​Feeders/​{CircuitId}
/​redfish/​v1/​PowerEquipment/​TransferSwitches/​{PowerDistributionId}/​Mains/​{CircuitId}

6.20.3 Properties

Property Type Attributes Notes
BreakerState string
(enum)
read-only
(null)
The state of the over current protection device. For the possible property values, see BreakerState in Property details.
CircuitType string
(enum)
read-only
(null)
The type of circuit. For the possible property values, see CircuitType in Property details.
ConfigurationLocked (v1.5+) boolean read-write Indicates whether the configuration is locked.
CriticalCircuit boolean read-write
(null)
Designates if this is a critical circuit.
CurrentAmps {} object The current (A) for this single phase circuit. For more information about this property, see SensorCurrentExcerpt in Property Details.
ElectricalConsumerNames (v1.4+) [ ] array (string, null) read-write An array of names of downstream devices that are powered by this circuit.
ElectricalContext string
(enum)
read-only
(null)
The combination of current-carrying conductors. For the possible property values, see ElectricalContext in Property details.
ElectricalSourceManagerURI (v1.4+) string
(URI)
read-write The URI of the management interface for the upstream electrical source connection for this circuit.
ElectricalSourceName (v1.4+) string read-write The name of the upstream electrical source, such as a circuit or outlet, connected to this circuit.
EnergykWh {} object The energy (kWh) for this circuit. For more information about this property, see SensorEnergykWhExcerpt in Property Details.
FrequencyHz {} object The frequency (Hz) for this circuit. For more information about this property, see SensorExcerpt in Property Details.
IndicatorLED (deprecated v1.1) string
(enum)
read-write
(null)
The state of the indicator LED, which identifies the circuit. For the possible property values, see IndicatorLED in Property details. Deprecated in v1.1 and later. This property has been deprecated in favor of the LocationIndicatorActive property.
Links { object The links to other resources that are related to this resource.
      BranchCircuit { object
(null)
A reference to the branch circuit related to this circuit.
            @odata.id string read-only Link to another Circuit resource.
      }
      DistributionCircuits (v1.4+) [ { array An array of links to the circuits powered by this circuit.
            @odata.id string read-write Link to another Circuit resource.
      } ]
      Oem {} object See the Oem object definition in the Common properties section.
      Outlets [ { array An array of references to the outlets contained by this circuit.
            @odata.id string read-only Link to a Outlet resource. See the Links section and the Outlet schema for details.
      } ]
      PowerOutlet (v1.4+) { object
(null)
A link to the power outlet that provides power to this circuit. See the Outlet schema for details on this property.
            @odata.id string read-write Link to a Outlet resource. See the Links section and the Outlet schema for details.
      }
      SourceCircuit (v1.4+) { object
(null)
A link to the circuit that provides power to this circuit.
            @odata.id string read-write Link to another Circuit resource.
      }
}
LocationIndicatorActive (v1.1+) boolean read-write
(null)
An indicator allowing an operator to physically locate this resource.
NominalVoltage string
(enum)
read-only
(null)
The nominal voltage for this circuit. For the possible property values, see NominalVoltage in Property details.
PhaseWiringType string
(enum)
read-only
(null)
The number of ungrounded current-carrying conductors (phases) and the total number of conductors (wires). For the possible property values, see PhaseWiringType in Property details.
PlugType string
(enum)
read-only
(null)
The type of plug according to NEMA, IEC, or regional standards. For the possible property values, see PlugType in Property details.
PolyPhaseCurrentAmps { object
(null)
The current readings for this circuit.
      Line1 {} object Line 1 current (A). For more information about this property, see SensorCurrentExcerpt in Property Details.
      Line2 {} object Line 2 current (A). For more information about this property, see SensorCurrentExcerpt in Property Details.
      Line3 {} object Line 3 current (A). For more information about this property, see SensorCurrentExcerpt in Property Details.
      Neutral {} object Neutral line current (A). For more information about this property, see SensorCurrentExcerpt in Property Details.
}
PolyPhaseEnergykWh { object
(null)
The energy readings for this circuit.
      Line1ToLine2 {} object The Line 1 to Line 2 energy (kWh) for this circuit. For more information about this property, see SensorEnergykWhExcerpt in Property Details.
      Line1ToNeutral {} object The Line 1 to Neutral energy (kWh) for this circuit. For more information about this property, see SensorEnergykWhExcerpt in Property Details.
      Line2ToLine3 {} object The Line 2 to Line 3 energy (kWh) for this circuit. For more information about this property, see SensorEnergykWhExcerpt in Property Details.
      Line2ToNeutral {} object The Line 2 to Neutral energy (kWh) for this circuit. For more information about this property, see SensorEnergykWhExcerpt in Property Details.
      Line3ToLine1 {} object The Line 3 to Line 1 energy (kWh) for this circuit. For more information about this property, see SensorEnergykWhExcerpt in Property Details.
      Line3ToNeutral {} object The Line 3 to Neutral energy (kWh) for this circuit. For more information about this property, see SensorEnergykWhExcerpt in Property Details.
}
PolyPhasePowerWatts { object
(null)
The power readings for this circuit.
      Line1ToLine2 {} object The Line 1 to Line 2 power (W) for this circuit. For more information about this property, see SensorPowerExcerpt in Property Details.
      Line1ToNeutral {} object The Line 1 to Neutral power (W) for this circuit. For more information about this property, see SensorPowerExcerpt in Property Details.
      Line2ToLine3 {} object The Line 2 to Line 3 power (W) for this circuit. For more information about this property, see SensorPowerExcerpt in Property Details.
      Line2ToNeutral {} object The Line 2 to Neutral power (W) for this circuit. For more information about this property, see SensorPowerExcerpt in Property Details.
      Line3ToLine1 {} object The Line 3 to Line 1 power (W) for this circuit. For more information about this property, see SensorPowerExcerpt in Property Details.
      Line3ToNeutral {} object The Line 3 to Neutral power (W) for this circuit. For more information about this property, see SensorPowerExcerpt in Property Details.
}
PolyPhaseVoltage { object
(null)
The voltage readings for this circuit.
      Line1ToLine2 {} object The Line 1 to Line 2 voltage (V) for this circuit. For more information about this property, see SensorVoltageExcerpt in Property Details.
      Line1ToNeutral {} object The Line 1 to Neutral voltage (V) for this circuit. For more information about this property, see SensorVoltageExcerpt in Property Details.
      Line2ToLine3 {} object The Line 2 to Line 3 voltage (V) for this circuit. For more information about this property, see SensorVoltageExcerpt in Property Details.
      Line2ToNeutral {} object The Line 2 to Neutral voltage (V) for this circuit. For more information about this property, see SensorVoltageExcerpt in Property Details.
      Line3ToLine1 {} object The Line 3 to Line 1 voltage (V) for this circuit. For more information about this property, see SensorVoltageExcerpt in Property Details.
      Line3ToNeutral {} object The Line 3 to Neutral voltage (V) for this circuit. For more information about this property, see SensorVoltageExcerpt in Property Details.
}
PowerControlLocked (v1.5+) boolean read-write Indicates whether power control requests are locked.
PowerCycleDelaySeconds number read-write
(null)
The number of seconds to delay power on after a PowerControl action to cycle power. Zero seconds indicates no delay.
PowerEnabled boolean read-only
(null)
Indicates if the circuit can be powered.
PowerLoadPercent (v1.3+) {} object The power load (percent) for this circuit. For more information about this property, see SensorExcerpt in Property Details.
PowerOffDelaySeconds number read-write
(null)
The number of seconds to delay power off after a PowerControl action. Zero seconds indicates no delay to power off.
PowerOnDelaySeconds number read-write
(null)
The number of seconds to delay power up after a power cycle or a PowerControl action. Zero seconds indicates no delay to power up.
PowerRestoreDelaySeconds number read-write
(null)
The number of seconds to delay power on after power has been restored. Zero seconds indicates no delay.
PowerRestorePolicy string
(enum)
read-write The desired power state of the circuit when power is restored after a power loss. For the possible property values, see PowerRestorePolicy in Property details.
PowerState string
(enum)
read-only
(null)
The power state of the circuit. For the possible property values, see PowerState in Property details.
PowerStateInTransition (v1.5+) boolean read-only Indicates whether the power state is undergoing a delayed transition.
PowerWatts {} object The power (W) for this circuit. For more information about this property, see SensorPowerExcerpt in Property Details.
RatedCurrentAmps number
(A)
read-only
(null)
The rated maximum current allowed for this circuit.
Status {} object The status and health of the resource and its subordinate or dependent resources. For property details, see Status.
UnbalancedCurrentPercent (v1.5+) {} object The current imbalance (percent) between phases. For more information about this property, see SensorExcerpt in Property Details.
UnbalancedVoltagePercent (v1.5+) {} object The voltage imbalance (percent) between phases. For more information about this property, see SensorExcerpt in Property Details.
UserLabel (v1.4+) string read-write A user-assigned label.
Voltage {} object The voltage (V) for this single phase circuit. For more information about this property, see SensorVoltageExcerpt in Property Details.
VoltageType string
(enum)
read-only
(null)
The type of voltage applied to the circuit. For the possible property values, see VoltageType in Property details.

6.20.4 Actions

6.20.4.1 BreakerControl

Description

This action attempts to reset the circuit breaker.

Action URI: {Base URI of target resource}/Actions/Circuit.BreakerControl

Action parameters

Parameter Name Type Attributes Notes
      PowerState string
(enum)
optional The desired power state of the circuit if the breaker is reset successfully. For the possible property values, see PowerState in Property details.

Request Example

{
    "PowerState": "On"
}

6.20.4.2 PowerControl

Description

This action turns the circuit on or off.

Action URI: {Base URI of target resource}/Actions/Circuit.PowerControl

Action parameters

Parameter Name Type Attributes Notes
      PowerState string
(enum)
optional The desired power state of the circuit. For the possible property values, see PowerState in Property details.

Request Example

{
    "PowerState": "Off"
}

6.20.4.3 ResetMetrics

Description

This action resets metrics related to this circuit.

Action URI: {Base URI of target resource}/Actions/Circuit.ResetMetrics

Action parameters

This action takes no parameters.

6.20.5 Property details

6.20.5.1 BreakerState:

The state of the over current protection device.

string Description
Normal The breaker is powered on.
Off The breaker is off.
Tripped The breaker has been tripped.

6.20.5.2 CircuitType:

The type of circuit.

string Description
Branch A branch (output) circuit.
Bus (v1.3+) An electrical bus circuit.
Feeder A feeder (output) circuit.
Mains A mains input or utility circuit.
Subfeed A subfeed (output) circuit.

6.20.5.3 ElectricalContext:

The combination of current-carrying conductors.

string Description
Line1 The circuits that share the L1 current-carrying conductor.
Line1ToLine2 The circuit formed by L1 and L2 current-carrying conductors.
Line1ToNeutral The circuit formed by L1 and neutral current-carrying conductors.
Line1ToNeutralAndL1L2 The circuit formed by L1, L2, and neutral current-carrying conductors.
Line2 The circuits that share the L2 current-carrying conductor.
Line2ToLine3 The circuit formed by L2 and L3 current-carrying conductors.
Line2ToNeutral The circuit formed by L2 and neutral current-carrying conductors.
Line2ToNeutralAndL1L2 The circuit formed by L1, L2, and Neutral current-carrying conductors.
Line2ToNeutralAndL2L3 The circuits formed by L2, L3, and neutral current-carrying conductors.
Line3 The circuits that share the L3 current-carrying conductor.
Line3ToLine1 The circuit formed by L3 and L1 current-carrying conductors.
Line3ToNeutral The circuit formed by L3 and neutral current-carrying conductors.
Line3ToNeutralAndL3L1 The circuit formed by L3, L1, and neutral current-carrying conductors.
LineToLine The circuit formed by two current-carrying conductors.
LineToNeutral The circuit formed by a line and neutral current-carrying conductor.
Neutral The grounded current-carrying return circuit of current-carrying conductors.
Total The circuit formed by all current-carrying conductors.

6.20.5.4 IndicatorLED:

The state of the indicator LED, which identifies the circuit.

string Description
Blinking The indicator LED is blinking.
Lit The indicator LED is lit.
Off The indicator LED is off.

6.20.5.5 NominalVoltage:

The nominal voltage for this circuit.

string Description
AC100To240V AC 100-240V nominal.
AC100To277V AC 100-277V nominal.
AC120V AC 120V nominal.
AC200To240V AC 200-240V nominal.
AC200To277V AC 200-277V nominal.
AC208V AC 208V nominal.
AC230V AC 230V nominal.
AC240AndDC380V AC 200-240V and DC 380V.
AC240V AC 240V nominal.
AC277AndDC380V AC 200-277V and DC 380V.
AC277V AC 277V nominal.
AC400V AC 400V or 415V nominal.
AC480V AC 480V nominal.
DC240V DC 240V nominal.
DC380V High Voltage DC (380V).
DC48V (v1.2+) DC 48V nominal.
DCNeg48V -48V DC.

6.20.5.6 PhaseWiringType:

The number of ungrounded current-carrying conductors (phases) and the total number of conductors (wires).

string Description
OneOrTwoPhase3Wire Single or Two-Phase / 3-Wire (Line1, Line2 or Neutral, Protective Earth).
OnePhase3Wire Single-phase / 3-Wire (Line1, Neutral, Protective Earth).
ThreePhase4Wire Three-phase / 4-Wire (Line1, Line2, Line3, Protective Earth).
ThreePhase5Wire Three-phase / 5-Wire (Line1, Line2, Line3, Neutral, Protective Earth).
TwoPhase3Wire Two-phase / 3-Wire (Line1, Line2, Protective Earth).
TwoPhase4Wire Two-phase / 4-Wire (Line1, Line2, Neutral, Protective Earth).

6.20.5.7 PlugType:

The type of plug according to NEMA, IEC, or regional standards.

string Description
California_CS8265 California Standard CS8265 (Single-phase 250V; 50A; 2P3W).
California_CS8365 California Standard CS8365 (Three-phase 250V; 50A; 3P4W).
Field_208V_3P4W_60A Field-wired; Three-phase 200-250V; 60A; 3P4W.
Field_400V_3P5W_32A Field-wired; Three-phase 200-240/346-415V; 32A; 3P5W.
IEC_60309_316P6 IEC 60309 316P6 (Single-phase 200-250V; 16A; 1P3W; Blue, 6-hour).
IEC_60309_332P6 IEC 60309 332P6 (Single-phase 200-250V; 32A; 1P3W; Blue, 6-hour).
IEC_60309_363P6 IEC 60309 363P6 (Single-phase 200-250V; 63A; 1P3W; Blue, 6-hour).
IEC_60309_460P9 IEC 60309 460P9 (Three-phase 200-250V; 60A; 3P4W; Blue; 9-hour).
IEC_60309_516P6 IEC 60309 516P6 (Three-phase 200-240/346-415V; 16A; 3P5W; Red; 6-hour).
IEC_60309_532P6 IEC 60309 532P6 (Three-phase 200-240/346-415V; 32A; 3P5W; Red; 6-hour).
IEC_60309_560P9 IEC 60309 560P9 (Three-phase 120-144/208-250V; 60A; 3P5W; Blue; 9-hour).
IEC_60309_563P6 IEC 60309 563P6 (Three-phase 200-240/346-415V; 63A; 3P5W; Red; 6-hour).
IEC_60320_C14 IEC C14 (Single-phase 250V; 10A; 1P3W).
IEC_60320_C20 IEC C20 (Single-phase 250V; 16A; 1P3W).
NEMA_5_15P NEMA 5-15P (Single-phase 125V; 15A; 1P3W).
NEMA_5_20P NEMA 5-20P (Single-phase 125V; 20A; 1P3W).
NEMA_6_15P NEMA 6-15P (Single-phase 250V; 15A; 2P3W).
NEMA_6_20P NEMA 6-20P (Single-phase 250V; 20A; 2P3W).
NEMA_L14_20P NEMA L14-20P (Split-phase 125/250V; 20A; 2P4W).
NEMA_L14_30P NEMA L14-30P (Split-phase 125/250V; 30A; 2P4W).
NEMA_L15_20P NEMA L15-20P (Three-phase 250V; 20A; 3P4W).
NEMA_L15_30P NEMA L15-30P (Three-phase 250V; 30A; 3P4W).
NEMA_L21_20P NEMA L21-20P (Three-phase 120/208V; 20A; 3P5W).
NEMA_L21_30P NEMA L21-30P (Three-phase 120/208V; 30A; 3P5W).
NEMA_L22_20P NEMA L22-20P (Three-phase 277/480V; 20A; 3P5W).
NEMA_L22_30P NEMA L22-30P (Three-phase 277/480V; 30A; 3P5W).
NEMA_L5_15P NEMA L5-15P (Single-phase 125V; 15A; 1P3W).
NEMA_L5_20P NEMA L5-20P (Single-phase 125V; 20A; 1P3W).
NEMA_L5_30P NEMA L5-30P (Single-phase 125V; 30A; 1P3W).
NEMA_L6_15P NEMA L6-15P (Single-phase 250V; 15A; 2P3W).
NEMA_L6_20P NEMA L6-20P (Single-phase 250V; 20A; 2P3W).
NEMA_L6_30P NEMA L6-30P (Single-phase 250V; 30A; 2P3W).

6.20.5.8 PowerRestorePolicy:

The desired power state of the circuit when power is restored after a power loss.

string Description
AlwaysOff Always remain powered off when external power is applied.
AlwaysOn Always power on when external power is applied.
LastState Return to the last power state (on or off) when external power is applied.

6.20.5.9 PowerState:

6.20.5.9.1 In top level:

The power state of the circuit.

string Description
Off The state is powered off.
On The state is powered on.
Paused The state is paused.
PoweringOff A temporary state between on and off.
PoweringOn A temporary state between off and on.
6.20.5.9.2 In Actions: BreakerControl, Actions: PowerControl:

The desired power state of the circuit if the breaker is reset successfully.

string Description
Off Power off.
On Power on.
PowerCycle (v1.5+) Power cycle.

6.20.5.10 SensorCurrentExcerpt:

The Sensor schema describes a sensor and its properties. This object is an excerpt of the Sensor resource located at the URI shown in DataSourceUri.

CrestFactor (v1.1+) number read-only
(null)
The crest factor for this sensor.
DataSourceUri string
(URI)
read-only
(null)
The link to the resource that provides the data for this sensor.
Reading number read-only
(null)
The sensor value.
THDPercent (v1.1+) number read-only
(null)
The total harmonic distortion (THD).

6.20.5.11 SensorEnergykWhExcerpt:

The Sensor schema describes a sensor and its properties. This object is an excerpt of the Sensor resource located at the URI shown in DataSourceUri.

ApparentkVAh (v1.5+) number
(kV.A.h)
read-only
(null)
Apparent energy (kVAh).
DataSourceUri string
(URI)
read-only
(null)
The link to the resource that provides the data for this sensor.
LifetimeReading (v1.1+) number read-only
(null)
The total accumulation value for this sensor.
ReactivekVARh (v1.5+) number
(kV.A.h)
read-only
(null)
Reactive energy (kVARh).
Reading number read-only
(null)
The sensor value.
SensorResetTime string
(date-time)
read-only
(null)
The date and time when the time-based properties were last reset.

6.20.5.12 SensorExcerpt:

The Sensor schema describes a sensor and its properties. This object is an excerpt of the Sensor resource located at the URI shown in DataSourceUri.

DataSourceUri string
(URI)
read-only
(null)
The link to the resource that provides the data for this sensor.
Reading number read-only
(null)
The sensor value.

6.20.5.13 SensorPowerExcerpt:

The Sensor schema describes a sensor and its properties. This object is an excerpt of the Sensor resource located at the URI shown in DataSourceUri.

ApparentVA number
(V.A)
read-only
(null)
The product of voltage and current for an AC circuit, in volt-ampere units.
DataSourceUri string
(URI)
read-only
(null)
The link to the resource that provides the data for this sensor.
PhaseAngleDegrees (v1.5+) number read-only
(null)
The phase angle (degrees) between the current and voltage waveforms.
PowerFactor number read-only
(null)
The power factor for this sensor.
ReactiveVAR number
(V.A)
read-only
(null)
The square root of the difference term of squared apparent VA and squared power (Reading) for a circuit, in VAR units.
Reading number read-only
(null)
The sensor value.

6.20.5.14 SensorVoltageExcerpt:

The Sensor schema describes a sensor and its properties. This object is an excerpt of the Sensor resource located at the URI shown in DataSourceUri.

CrestFactor (v1.1+) number read-only
(null)
The crest factor for this sensor.
DataSourceUri string
(URI)
read-only
(null)
The link to the resource that provides the data for this sensor.
Reading number read-only
(null)
The sensor value.
THDPercent (v1.1+) number read-only
(null)
The total harmonic distortion (THD).

6.20.5.15 VoltageType:

The type of voltage applied to the circuit.

string Description
AC Alternating Current (AC) circuit.
DC Direct Current (DC) circuit.

6.20.6 Example response

{
    "@odata.type": "#Circuit.v1_5_0.Circuit",
    "Id": "A",
    "Name": "Branch Circuit A",
    "Status": {
        "State": "Enabled",
        "Health": "OK"
    },
    "CircuitType": "Branch",
    "PhaseWiringType": "TwoPhase3Wire",
    "NominalVoltage": "AC200To240V",
    "RatedCurrentAmps": 16,
    "BreakerState": "Normal",
    "PolyPhaseVoltage": {
        "Line1ToNeutral": {
            "DataSourceUri": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/VoltageAL1N",
            "Reading": 118.2
        },
        "Line1ToLine2": {
            "DataSourceUri": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/VoltageAL1L2",
            "Reading": 203.5
        }
    },
    "CurrentAmps": {
        "DataSourceUri": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/CurrentA",
        "Reading": 5.19
    },
    "PolyPhaseCurrentAmps": {
        "Line1": {
            "DataSourceUri": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/CurrentA",
            "Reading": 5.19
        }
    },
    "PowerWatts": {
        "DataSourceUri": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/PowerA",
        "Reading": 937.4,
        "ApparentVA": 937.4,
        "ReactiveVAR": 0,
        "PowerFactor": 1
    },
    "PolyPhasePowerWatts": {
        "Line1ToNeutral": {
            "DataSourceUri": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/PowerA1",
            "Reading": 937.4,
            "PeakReading": 1000.5,
            "ApparentVA": 937.4,
            "ReactiveVAR": 0,
            "PowerFactor": 1
        }
    },
    "FrequencyHz": {
        "DataSourceUri": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/FrequencyA",
        "Reading": 60
    },
    "EnergykWh": {
        "DataSourceUri": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/EnergyA",
        "Reading": 325675
    },
    "Links": {
        "Outlets": [
            {
                "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Outlets/A1"
            },
            {
                "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Outlets/A2"
            },
            {
                "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Outlets/A3"
            }
        ]
    },
    "Actions": {
        "#Circuit.BreakerControl": {
            "target": "/redfish/v1/PowerEquipment/RackPDUs/1/Branches/A/Circuit.BreakerControl"
        },
        "#Outlet.ResetMetrics": {
            "target": "/redfish/v1/PowerEquipment/RackPDUs/1/Branches/A/Circuit.ResetMetrics"
        }
    },
    "@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Branches/A"
}

6.21 ComponentIntegrity 1.0.0

Version v1.0
Release 2021.4

6.21.1 Description

The ComponentIntegrity resource provides critical and pertinent security information about a specific device, system, software element, or other managed entity.

6.21.2 URIs

/​redfish/​v1/​ComponentIntegrity/​{ComponentIntegrityId}

6.21.3 Properties

Property Type Attributes Notes
ComponentIntegrityEnabled boolean read-write An indication of whether security protocols are enabled for the component.
ComponentIntegrityType string
(enum)
read-only required The type of security technology for the component. For the possible property values, see ComponentIntegrityType in Property details.
ComponentIntegrityTypeVersion string read-only required The version of the security technology.
LastUpdated string
(date-time)
read-only
(null)
The date and time when information for the component was last updated.
Links { object The links to other resources that are related to this resource.
      ComponentsProtected [ { array An array of links to resources that the target component protects.
            @odata.id string
(URI)
read-only The unique identifier for a resource.
      } ]
      Oem {} object See the Oem object definition in the Common properties section.
}
SPDM { object Integrity information about the SPDM Responder as reported by an SPDM Requester.
      ComponentCommunication { object
(null)
Information about communication between the SPDM Requester and SPDM Responder.
            Sessions [ { array The active sessions or communication channels between two components.
                  SessionId integer read-only
(null)
The identifier for an active session or communication channel between two components.
                  SessionType string
(enum)
read-only
(null)
The type of session or communication channel between two components. For the possible property values, see SessionType in Property details.
            } ]
      }
      IdentityAuthentication { object
(null)
Identity authentication information about the SPDM Requester and SPDM Responder.
            RequesterAuthentication { object
(null)
Authentication information of the identity of the SPDM Requester.
                  ProvidedCertificate { object A link to the certificate that represents the identify of the SPDM Requester provided in mutual authentication. See the Certificate schema for details on this property.
                        @odata.id string read-only Link to a Certificate resource. See the Links section and the Certificate schema for details.
                  }
            }
            ResponderAuthentication { object
(null)
Authentication information of the identity of the SPDM Responder.
                  ComponentCertificate { object A link to the certificate that represents the identify of the component. See the Certificate schema for details on this property.
                        @odata.id string read-only Link to a Certificate resource. See the Links section and the Certificate schema for details.
                  }
                  VerificationStatus string
(enum)
read-only
(null)
The status of the verification of the identity of the component. For the possible property values, see VerificationStatus in Property details.
            }
      }
      MeasurementSet { object
(null)
Measurement information about the SPDM Responder.
            Measurements [ { array Measurements from an SPDM Responder.
                  LastUpdated string
(date-time)
read-only
(null)
The date and time when information for the measurement was last updated.
                  Measurement string read-only
(null)
The measurement data.
                  MeasurementHashAlgorithm string read-only
(null)
The hash algorithm used to compute the measurement.
                  MeasurementIndex integer read-only
(null)
The index of the measurement.
                  MeasurementType string
(enum)
read-only
(null)
The type or characteristics of the data that this measurement represents. For the possible property values, see MeasurementType in Property details.
                  Oem {} object See the Oem object definition in the Common properties section.
                  PartofSummaryHash boolean read-only
(null)
Indicates whether this measurement is part of the measurement summary.
            } ]
            MeasurementSpecification string
(enum)
read-only
(null)
The measurement specification negotiated between the SPDM Requester and SPDM Responder. For the possible property values, see MeasurementSpecification in Property details.
            MeasurementSummary string read-only
(null)
The measurement summary data.
            MeasurementSummaryHashAlgorithm string read-only
(null)
The hash algorithm used to compute the measurement summary.
            MeasurementSummaryType string
(enum)
read-only
(null)
The type of measurement summary. For the possible property values, see MeasurementSummaryType in Property details.
            Oem {} object See the Oem object definition in the Common properties section.
      }
      Requester { object * required* The link to the the component that is reporting the integrity information of the target component.
            @odata.id string
(URI)
read-only The unique identifier for a resource.
      }
}
Status {} object The status and health of the resource and its subordinate or dependent resources. For property details, see Status.
TargetComponentURI string read-only required The link to the the component whose integrity that this resource reports.
TPM { object Integrity information about the Trusted Platform Module (TPM).
      ComponentCommunication { object
(null)
Information about communication with the TPM.
            Sessions [ { array The active sessions or communication channels between two components.
                  SessionId integer read-only
(null)
The identifier for an active session or communication channel between two components.
                  SessionType string
(enum)
read-only
(null)
The type of session or communication channel between two components. For the possible property values, see SessionType in Property details.
            } ]
      }
      IdentityAuthentication { object
(null)
Identity authentication information about the TPM.
            ComponentCertificate { object A link to the certificate that represents the identify of the component. See the Certificate schema for details on this property.
                  @odata.id string read-only Link to a Certificate resource. See the Links section and the Certificate schema for details.
            }
            VerificationStatus string
(enum)
read-only
(null)
The status of the verification of the identity of the component. For the possible property values, see VerificationStatus in Property details.
      }
      MeasurementSet { object
(null)
Measurement information from the TPM.
            Measurements [ { array Measurements from a TPM.
                  LastUpdated string
(date-time)
read-only
(null)
The date and time when information for the measurement was last updated.
                  Measurement string read-only
(null)
The measurement data.
                  MeasurementHashAlgorithm string read-only
(null)
The hash algorithm used to compute the measurement.
                  PCR integer read-only
(null)
The Platform Configuration Register (PCR) bank of the measurement.
            } ]
      }
}

6.21.4 Actions

6.21.4.1 SPDMGetSignedMeasurements

Description

This action generates an SPDM cryptographic signed statement over the given nonce and measurements of the SPDM Responder.

Action URI: {Base URI of target resource}/Actions/ComponentIntegrity.SPDMGetSignedMeasurements

Action parameters

Parameter Name Type Attributes Notes
      MeasurementIndices [ ] array (integer) optional An array of indices that identify the measurement blocks to sign.
      Nonce string optional A 32-byte hex-encoded string that is signed with the measurements. The value should be unique.
      SlotId integer optional The slot identifier for the certificate containing the private key to generate the signature over the measurements.

Response Payload

{
      Certificate { object A link to the certificate corresponding to the SPDM slot identifier that can be used to validate the signature. See the Certificate schema for details on this property.
            @odata.id string read-only Link to a Certificate resource. See the Links section and the Certificate schema for details.
      }
      HashingAlgorithm string read-only required The hashing algorithm used for generating the cryptographic signed statement.
      Oem {} object See the Oem object definition in the Common properties section.
      PublicKey string read-only A Privacy Enhanced Mail (PEM)-encoded public key that can be used to validate the signature.
      SignedMeasurements string read-only required Base64 encoded cryptographic signed statement generated by the signer.
      SigningAlgorithm string read-only required The asymmetric signing algorithm used for generating the cryptographic signed statement.
      Version string read-only required The SPDM version used by the SPDM Responder to generate the cryptographic signed statement.
}

6.21.5 Property details

6.21.5.1 ComponentIntegrityType:

The type of security technology for the component.

string Description
OEM OEM-specific.
SPDM Security Protocol and Data Model (SPDM) protocol.
TPM Trusted Platform Module (TPM).

6.21.5.2 MeasurementSpecification:

The measurement specification negotiated between the SPDM Requester and SPDM Responder.

string Description
DMTF DMTF.

6.21.5.3 MeasurementSummaryType:

The type of measurement summary.

string Description
All The measurement summary covers all measurements in SPDM.
TCB The measurement summary covers the TCB.

6.21.5.4 MeasurementType:

The type or characteristics of the data that this measurement represents.

string Description
FirmwareConfiguration Firmware configuration, such as configurable firmware policy.
HardwareConfiguration Hardware configuration, such as straps.
ImmutableROM Immutable ROM.
MeasurementManifest Measurement Manifest.
MutableFirmware Mutable firmware or any mutable code.
MutableFirmwareSecurityVersionNumber Mutable firmware security version number.
MutableFirmwareVersion Mutable firmware version.

6.21.5.5 SessionType:

The type of session or communication channel between two components.

string Description
AuthenticatedOnly An established session where only authentication is protecting the communication.
EncryptedAuthenticated An established session where both encryption and authentication are protecting the communication.
Plain A plain text session without any protection.

6.21.5.6 VerificationStatus:

The status of the verification of the identity of the component.

string Description
Failed Unsuccessful verification.
Success Successful verification.

6.21.6 Example response

{
    "@odata.type": "#ComponentIntegrity.v1_0_0.ComponentIntegrity",
    "Id": "TPM-0",
    "Description": "TPM physically attached to a GPU.",
    "Status": {
        "Health": "OK",
        "State": "Enabled"
    },
    "ComponentIntegrityType": "TPM",
    "ComponentIntegrityTypeVersion": "1.2.0",
    "ComponentIntegrityEnabled": true,
    "LastUpdated": "2021-11-02T14:09:54-07:00",
    "TargetComponentURI": "/redvish/v1/Systems/437XR1138R2#/TrustedModules/0",
    "Links": {
        "ComponentsProtected": [
            {
                "@odata.id": "/redfish/v1/Systems/437XR1138R2/GraphicsControllers/GPU1"
            }
        ]
    },
    "TPM": {
        "MeasurementSet": {
            "Measurements": [
                {
                    "PCR": 1,
                    "Measurement": "h6spEuxbyOtGhP35UoGhTcVX3iRaZQGDw4Yk5oQcabw=",
                    "LastUpdated": "2021-10-31T20:14:27-07:00",
                    "MeasurementHashAlgorithm": "TPM_ALG_SHA256"
                },
                {
                    "PCR": 3,
                    "Measurement": "GnbzS4ToNQb+Y7SxXw4AvRDTf4SzO5eeAlAlDca28AA=",
                    "LastUpdated": "2021-10-31T20:14:27-07:00",
                    "MeasurementHashAlgorithm": "TPM_ALG_SHA256"
                },
                {
                    "PCR": 1,
                    "Measurement": "pLJa5Dyh8CDYFZ1WNOrsiSG1eyCPBlre42CD7CTywg7VkcC4afw4ZG3gQxi2XEFCt5jxz6tN1/cbx/DNx2/tOg==",
                    "LastUpdated": "2021-10-31T20:14:27-07:00",
                    "MeasurementHashAlgorithm": "TPM_ALG_SHA512"
                },
                {
                    "PCR": 3,
                    "Measurement": "GBgEucATV8omirTmYqY+vvbbisHR1jBKfVAEK1XSifBHnnIYXopsc0NExURDSSyPjO21NrPqnwiq5LhI1p6rzQ==",
                    "LastUpdated": "2021-10-31T20:14:27-07:00",
                    "MeasurementHashAlgorithm": "TPM_ALG_SHA512"
                }
            ]
        },
        "IdentityAuthentication": {
            "VerificationStatus": "Success",
            "ComponentCertificate": {
                "@odata.id": "/redfish/v1/Systems/437XR1138R2/Certificates/TPMcert"
            }
        },
        "ComponentCommunication": {
            "Sessions": [
                {
                    "SessionId": 4556,
                    "SessionType": "Plain"
                }
            ]
        }
    },
    "@odata.id": "/redfish/v1/ComponentIntegrity/TPM-0"
}

6.22 CompositionReservation 1.0.0

Version v1.0
Release 2021.1

6.22.1 Description

The CompositionReservation schema contains reservation information related to the Compose action defined in the CompositionService resource when the of RequestType parameter contains the value PreviewReserve.

6.22.2 URIs

/​redfish/​v1/​CompositionService/​CompositionReservations/​{CompositionReservationId}

6.22.3 Properties

Property Type Attributes Notes
Client string read-only The client that owns the reservation.
Manifest { object The manifest document processed by the service that resulted in this reservation.
      Description string read-write
(null)
The description of this manifest.
      Expand string
(enum)
read-write
(null)
The expansion control for references in manifest responses, similar to the $expand=. query parameter. For the possible property values, see Expand in Property details.
      Stanzas [ { array An array of stanzas that describe the requests specified by this manifest.
            OEMStanzaType string read-write
(null)
The OEM-defined type of stanza.
            Request {} object
(null)
The request details for the stanza.
            Response {} object
(null)
The response details for the stanza.
            StanzaId string read-write
(null)
The identifier of the stanza. This is a unique identifier specified by the client and is not used by the service.
            StanzaType string
(enum)
read-write
(null)
The type of stanza. For the possible property values, see StanzaType in Property details.
      } ]
      Timestamp string
(date-time)
read-write
(null)
The date and time when the manifest was created.
}
ReservationTime string
(date-time)
read-only The date time the service created the reservation.
ReservedResourceBlocks [ { array The array of links to the reserved resource blocks.
      @odata.id string read-only Link to a ResourceBlock resource. See the Links section and the ResourceBlock schema for details.
} ]

6.22.4 Property details

6.22.4.1 Expand:

The expansion control for references in manifest responses, similar to the $expand=. query parameter.

string Description
All Expand all subordinate references.
None Do not expand any references.
Relevant Expand relevant subordinate references. Relevant references are those that are tied to a constrained composition request, such as a request for a quantity of processors.

6.22.4.2 StanzaType:

The type of stanza.

string Description
ComposeResource A stanza that describes the desired end state for a composed resource block. The resources consumed by the composed resource block are moved to the active pool.
ComposeSystem A stanza that describes the desired end state for computer system composition operation. The resources consumed by the composed computer system are moved to the active pool.
DecomposeResource A stanza that references a composed resource block to decompose and return resources to the free pool.
DecomposeSystem A stanza that references a computer system to decompose and return resources to the free pool.
OEM A stanza that describes an OEM-specific request.

6.23 CompositionService 1.2.0

Version v1.2 v1.1 v1.0
Release 2021.1 2018.2 2017.1

6.23.1 Description

The CompositionService schema describes a composition service and its properties and links to the resources available for composition.

6.23.2 URIs

/​redfish/​v1/​CompositionService

6.23.3 Properties

Property Type Attributes Notes
ActivePool (v1.2+) { object The link to the collection of resource blocks within the active pool. Resource blocks in the active pool are contributing to at least one composed resource as a result of a composition request. Contains a link to a resource.
      @odata.id string read-only Link to Collection of ResourceBlock. See the ResourceBlock schema for details.
}
AllowOverprovisioning (v1.1+) boolean read-write
(null)
An indication of whether this service is allowed to overprovision a composition relative to the composition request.
AllowZoneAffinity (v1.1+) boolean read-only
(null)
An indication of whether a client can request that a specific resource zone fulfill a composition request.
CompositionReservations (v1.2+) { object The link to the collection of reservations with the composition reservation collection. Contains a link to a resource.
      @odata.id string read-only Link to Collection of CompositionReservation. See the CompositionReservation schema for details.
}
FreePool (v1.2+) { object The link to the collection of resource blocks within the free pool. Resource blocks in the free pool are not contributing to any composed resources. Contains a link to a resource.
      @odata.id string read-only Link to Collection of ResourceBlock. See the ResourceBlock schema for details.
}
ReservationDuration (v1.2+) string read-write
(null)
The length of time a composition reservation is held before the service deletes the reservation marks any related resource blocks as no longer reserved.
ResourceBlocks { object The resource blocks available on the service. Contains a link to a resource.
      @odata.id string read-only Link to Collection of ResourceBlock. See the ResourceBlock schema for details.
}
ResourceZones { object The resource zones available on the service. Contains a link to a resource.
      @odata.id string read-only Link to Collection of Zone. See the Zone schema for details.
}
ServiceEnabled boolean read-write
(null)
An indication of whether this service is enabled.
Status {} object The status and health of the resource and its subordinate or dependent resources. For property details, see Status.

6.23.4 Actions

6.23.4.1 Compose (v1.2+)

Description

This action performs a set of operations specified by a manifest.

Action URI: {Base URI of target resource}/Actions/CompositionService.Compose

Action parameters

Parameter Name Type Attributes Notes
      Manifest { object optional The manifest containing the compose operation request.
            Description string read-write
(null)
The description of this manifest.
            Expand string
(enum)
read-write
(null)
The expansion control for references in manifest responses, similar to the $expand=. query parameter. For the possible property values, see Expand in Property details.
            Stanzas [ { array An array of stanzas that describe the requests specified by this manifest.
                  OEMStanzaType string read-write
(null)
The OEM-defined type of stanza.
                  Request {} object
(null)
The request details for the stanza.
                  Response {} object
(null)
The response details for the stanza.
                  StanzaId string read-write
(null)
The identifier of the stanza. This is a unique identifier specified by the client and is not used by the service.
                  StanzaType string
(enum)
read-write
(null)
The type of stanza. For the possible property values, see StanzaType in Property details.
            } ]
            Timestamp string
(date-time)
read-write
(null)
The date and time when the manifest was created.
      }
      RequestFormat string
(enum)
required The format of the request. For the possible property values, see RequestFormat in Property details.
      RequestType string
(enum)
required The type of request. For the possible property values, see RequestType in Property details.
      ReservationId string optional The identifier of the composition reservation if applying a reservation. The value for this parameter is obtained from the response of a Compose action where the RequestType parameter contains the value PreviewReserve.

Response Payload

{
      Manifest (v1.2+) { object The manifest containing the compose operation response.
            Description string read-write
(null)
The description of this manifest.
            Expand string
(enum)
read-write
(null)
The expansion control for references in manifest responses, similar to the $expand=. query parameter. For the possible property values, see Expand in Property details.
            Stanzas [ { array An array of stanzas that describe the requests specified by this manifest.
                  OEMStanzaType string read-write
(null)
The OEM-defined type of stanza.
                  Request {} object
(null)
The request details for the stanza.
                  Response {} object
(null)
The response details for the stanza.
                  StanzaId string read-write
(null)
The identifier of the stanza. This is a unique identifier specified by the client and is not used by the service.
                  StanzaType string
(enum)
read-write
(null)
The type of stanza. For the possible property values, see StanzaType in Property details.
            } ]
            Timestamp string
(date-time)
read-write
(null)
The date and time when the manifest was created.
      }
      RequestFormat (v1.2+) string
(enum)
read-only required The format of the request. For the possible property values, see RequestFormat in Property details.
      RequestType (v1.2+) string
(enum)
read-only required The type of request. For the possible property values, see RequestType in Property details.
      ReservationId (v1.2+) string read-only The identifier of the composition reservation that was created.
}

Request Example

{
    "RequestFormat": "Manifest",
    "RequestType": "Apply",
    "Manifest": {
        "Description": "Specific composition example",
        "Timestamp": "2019-08-22T10:35:16+06:00",
        "Expand": "None",
        "Stanzas": [
            {
                "StanzaType": "ComposeSystem",
                "StanzaId": "Compute1",
                "Request": {
                    "Links": {
                        "ResourceBlocks": [
                            {
                                "@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/BladeServer-1"
                            },
                            {
                                "@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/NVMe-TargetsAppliance-1"
                            },
                            {
                                "@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/NetworkCard1"
                            }
                        ]
                    }
                }
            }
        ]
    }
}

Response Example

{
    "RequestFormat": "Manifest",
    "RequestType": "Apply",
    "Manifest": {
        "Description": "Specific composition example",
        "Timestamp": "2019-08-22T10:35:16+06:00",
        "Expand": "None",
        "Stanzas": [
            {
                "StanzaType": "ComposeSystem",
                "StanzaId": "Compute1",
                "Request": {
                    "Links": {
                        "ResourceBlocks": [
                            {
                                "@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/BladeServer-1"
                            },
                            {
                                "@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/NVMe-TargetsAppliance-1"
                            },
                            {
                                "@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/NetworkCard1"
                            }
                        ]
                    }
                },
                "Response": {
                    "@odata.id": "/redfish/v1/Systems/ComposedCompute1",
                    "@odata.type": "#ComputerSystem.v1_14_0.ComputerSystem",
                    "Id": "ComposedCompute1",
                    "Name": "Computer system composed from Compute1",
                    "Processors": {
                        "@odata.id": "/redfish/v1/Systems/ComposedCompute1/Processors"
                    },
                    "Memory": {
                        "@odata.id": "/redfish/v1/Systems/ComposedCompute1/Memory"
                    },
                    "NetworkInterfaces": {
                        "@odata.id": "/redfish/v1/Systems/ComposedCompute1/NetworkInterfaces"
                    },
                    "Storage": {
                        "@odata.id": "/redfish/v1/Systems/ComposedCompute1/Storage"
                    },
                    "Links": {
                        "ResourceBlocks": [
                            {
                                "@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/BladeServer-1"
                            },
                            {
                                "@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/NVMe-TargetsAppliance-1"
                            },
                            {
                                "@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/NetworkCard1"
                            }
                        ]
                    }
                }
            }
        ]
    }
}

6.23.5 Property details

6.23.5.1 Expand:

The expansion control for references in manifest responses, similar to the $expand=. query parameter.

string Description
All Expand all subordinate references.
None Do not expand any references.
Relevant Expand relevant subordinate references. Relevant references are those that are tied to a constrained composition request, such as a request for a quantity of processors.

6.23.5.2 RequestFormat:

The format of the request.

string Description
Manifest The request body contains a manifest.

6.23.5.3 RequestType:

The type of request.

string Description
Apply Perform the requested operations specified by the manifest and modify resources as needed.
Preview Preview the outcome of the operations specified by the manifest.
PreviewReserve Preview the outcome of the operations specified by the manifest and reserve resources.

6.23.5.4 StanzaType:

The type of stanza.

string Description
ComposeResource A stanza that describes the desired end state for a composed resource block. The resources consumed by the composed resource block are moved to the active pool.
ComposeSystem A stanza that describes the desired end state for computer system composition operation. The resources consumed by the composed computer system are moved to the active pool.
DecomposeResource A stanza that references a composed resource block to decompose and return resources to the free pool.
DecomposeSystem A stanza that references a computer system to decompose and return resources to the free pool.
OEM A stanza that describes an OEM-specific request.

6.23.6 Example response

{
    "@odata.type": "#CompositionService.v1_2_0.CompositionService",
    "Id": "CompositionService",
    "Name": "Composition Service",
    "Status": {
        "State": "Enabled",
        "Health": "OK"
    },
    "ServiceEnabled": true,
    "AllowOverprovisioning": true,
    "AllowZoneAffinity": true,
    "ResourceBlocks": {
        "@odata.id": "/redfish/v1/CompositionService/ResourceBlocks"
    },
    "ResourceZones": {
        "@odata.id": "/redfish/v1/CompositionService/ResourceZones"
    },
    "Oem": {},
    "@odata.id": "/redfish/v1/CompositionService"
}

6.24 ComputerSystem 1.17.0

Version v1.17 v1.16 v1.15 v1.14 v1.13 v1.12 v1.11 v1.10 v1.9 v1.8 v1.7 ...
Release 2021.4 2021.2 2021.1 2020.4 2020.3 2020.2 2020.1 2019.4 2019.3 2019.2 2019.1 ...

6.24.1 Description

The ComputerSystem schema represents a computer or system instance and the software-visible resources, or items within the data plane, such as memory, CPU, and other devices that it can access. Details of those resources or subsystems are also linked through this resource.

6.24.2 URIs

/​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}
/​redfish/​v1/​Systems/​{ComputerSystemId}

6.24.3 Properties

Property Type Attributes Notes
AssetTag string read-write
(null)
The user-definable tag that can track this computer system for inventory or other client purposes.
Bios (v1.1+) { object The link to the BIOS settings associated with this system. See the Bios schema for details on this property.
      @odata.id string read-only Link to a Bios resource. See the Links section and the Bios schema for details.
}
BiosVersion string read-only
(null)
The version of the system BIOS or primary system firmware.
Boot { object The boot settings for this system.
      AliasBootOrder (v1.6+) [ ] array (string
(enum))
read-write
(null)
Ordered array of boot source aliases representing the persistent boot order associated with this computer system. For the possible property values, see AliasBootOrder in Property details.
      AutomaticRetryAttempts (v1.11+) integer read-write
(null)
The number of attempts the system will automatically retry booting.
      AutomaticRetryConfig (v1.11+) string
(enum)
read-write
(null)
The configuration of how the system retries booting automatically. For the possible property values, see AutomaticRetryConfig in Property details.
      BootNext (v1.5+) string read-write
(null)
The BootOptionReference of the Boot Option to perform a one-time boot from when BootSourceOverrideTarget is UefiBootNext.
      BootOptions (v1.5+) { object The link to the collection of the UEFI boot options associated with this computer system. Contains a link to a resource.
            @odata.id string read-only Link to Collection of BootOption. See the BootOption schema for details.
      }
      BootOrder (v1.5+) [ ] array (string, null) read-write An array of BootOptionReference strings that represent the persistent boot order for with this computer system. Changes to the boot order typically require a system reset before they take effect. It is likely that a client finds the @Redfish.Settings term in this resource, and if it is found, the client makes requests to change boot order settings by modifying the resource identified by the @Redfish.Settings term.
      BootOrderPropertySelection (v1.6+) string
(enum)
read-write
(null)
The name of the boot order property that the system uses for the persistent boot order. For the possible property values, see BootOrderPropertySelection in Property details.
      BootSourceOverrideEnabled string
(enum)
read-write
(null)
The state of the boot source override feature. For the possible property values, see BootSourceOverrideEnabled in Property details.
      BootSourceOverrideMode (v1.1+) string
(enum)
read-write
(null)
The BIOS boot mode to use when the system boots from the BootSourceOverrideTarget boot source. For the possible property values, see BootSourceOverrideMode in Property details.
      BootSourceOverrideTarget string
(enum)
read-write
(null)
The current boot source to use at the next boot instead of the normal boot device, if BootSourceOverrideEnabled is true. For the possible property values, see BootSourceOverrideTarget in Property details.