Redfish DMTF Logo

Document Identifier: DSP2046

Date: 2021-04-162020.4

Version: 2021.1

Redfish Resource and Schema Guide

Supersedes: 2020.4

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


title: Schema Documentation

0.1 search: true

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 Identifier

4.3.1 Description

Any additional identifiers for a resource.

4.3.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.3.3 Property details

4.3.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).
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.4 IOStatistics

4.4.1 Description

The properties of this type represent IO statistics.

4.4.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.5 IPv4Address

4.5.1 Description

This type describes an IPv4 address.

4.5.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.5.3 Property details

4.5.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.6 IPv6Address

4.6.1 Description

This type describes an IPv6 address.

4.6.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.6.3 Property details

4.6.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.6.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.7 IPv6GatewayStaticAddress

4.7.1 Description

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

4.7.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.8 IPv6StaticAddress

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 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.9 Location

4.9.1 Description

The location of a resource.

4.9.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, such as slot, bay, socket, or slot. 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.9.3 Property details

4.9.3.1 LocationType:

The type of location of the part, such as slot, bay, socket, or slot.

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

4.9.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.9.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.9.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.10 Message

4.10.1 Description

The message that the Redfish service returns.

4.10.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.10.3 Property details

4.10.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.11 Redundancy

4.11.1 Description

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

4.11.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.11.3 Property details

4.11.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.12 RedundantGroup

4.12.1 Description

The redundancy information for the devices in a redundancy group.

4.12.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.12.3 Property details

4.12.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.13 ReplicaInfo

4.13.1 Description

Defines the characteristics of a replica of a source.

4.13.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.13.3 Property details

4.13.3.1 ConsistencyState:

The current state of consistency.

string Description
Consistent Consistent.
Inconsistent Not consistent.

4.13.3.2 ConsistencyStatus:

The current status of consistency.

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

4.13.3.3 ConsistencyType:

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

string Description
SequentiallyConsistent Sequentially consistent.

4.13.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.13.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.13.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.13.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.13.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.13.3.9 ReplicaRole:

The source or target role of this replica.

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

4.13.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.13.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.13.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.13.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.13.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.14 Schedule

4.14.1 Description

Schedule a series of occurrences.

4.14.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.14.3 Property details

4.14.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.14.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.15 Status

4.15.1 Description

The status and health of a resource and its children.

4.15.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.
      }
      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.15.3 Property details

4.15.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.15.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.15.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.15.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.
} ]
Members@odata.count integer read-only The number of items in a collection.
Members@odata.navigationLink 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 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
BootOptionCollection /​redfish/​v1/​CompositionService/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​BootOptions
/​redfish/​v1/​ResourceBlocks/​{ResourceBlockId}/​Systems/​{ComputerSystemId}/​BootOptions
/​redfish/​v1/​Systems/​{ComputerSystemId}/​BootOptions
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}/​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/​EventService/​Subscriptions/​{EventDestinationId}/​Certificates
/​redfish/​v1/​Fabrics/​{FabricId}/​Switches/​{SwitchId}/​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}/​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/​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}/​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/​UpdateService/​RemoteServerCertificates
ChassisCollection /​redfish/​v1/​Chassis
CircuitCollection /​redfish/​v1/​PowerEquipment/​FloorPDUs/​{PowerDistributionId}/​Branches
/​redfish/​v1/​PowerEquipment/​FloorPDUs/​{PowerDistributionId}/​Mains
/​redfish/​v1/​PowerEquipment/​FloorPDUs/​{PowerDistributionId}/​Subfeeds
/​redfish/​v1/​PowerEquipment/​RackPDUs/​{PowerDistributionId}/​Branches
/​redfish/​v1/​PowerEquipment/​RackPDUs/​{PowerDistributionId}/​Mains
/​redfish/​v1/​PowerEquipment/​TransferSwitches/​{PowerDistributionId}/​Branches
/​redfish/​v1/​PowerEquipment/​TransferSwitches/​{PowerDistributionId}/​Feeders
/​redfish/​v1/​PowerEquipment/​TransferSwitches/​{PowerDistributionId}/​Mains
CompositionReservationCollection /​redfish/​v1/​CompositionService/​CompositionReservations
ComputerSystemCollection /​redfish/​v1/​Systems
ConnectionCollection /​redfish/​v1/​Fabrics/​{FabricId}/​Connections
ConnectionMethodCollection /​redfish/​v1/​AggregationService/​ConnectionMethods
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/​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
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/​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/​RackPDUs/​{PowerDistributionId}/​Outlets
/​redfish/​v1/​PowerEquipment/​TransferSwitches/​{PowerDistributionId}/​Outlets
OutletGroupCollection /​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}/​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/​FloorPDUs
/​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
ProcessorCollection /​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
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/​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.9.0

Version v1.9 v1.8 v1.7 v1.6 v1.5 v1.4 v1.3 v1.2 v1.1 v1.0
Release 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. The schema also contains links to the manager accounts and roles.

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.
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.
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.
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 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.8 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.9 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.10 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_9_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.1.2

Version v1.1 v1.0
Release 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.
      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_1_2.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.1.1

Version v1.1 v1.0
Release 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.
            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.
            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.
            }
            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)
The VLAN tag range for the fabric.
                  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.
                  ConnectRetrySeconds (v1.1+) integer read-write
(null)
Border Gateway Protocol (BGP) retry timer in seconds.
                  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 addressing for this Ethernet fabric. 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 end host subnet addressing for 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 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.
            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.
                  ConnectRetrySeconds (v1.1+) integer read-write
(null)
Border Gateway Protocol (BGP) retry timer in seconds.
                  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.
                  ConnectRetrySeconds (v1.1+) integer read-write
(null)
Border Gateway Protocol (BGP) retry timer in seconds.
                  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_1_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.
      } ]

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.
      } ]

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.

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.
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.

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.
      } ]

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.
      } ]

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.
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.

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.1.0

Version v1.1 v1.0
Release 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
HostName string
(URI)
read-write required
(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.
}
UserName string read-write
(null)
The user name for accessing the aggregation source.

6.7.4 Property details

6.7.4.1 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.2 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_1_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 Assembly 1.3.0

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

6.8.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.8.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/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/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.8.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.8.4 Property details

6.8.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.
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.
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.8.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.9 AttributeRegistry 1.3.6

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

6.9.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.9.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.9.3 Property details

6.9.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.9.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.9.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.9.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.9.3.5 Type:

6.9.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.9.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.9.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.10 Bios 1.2.0

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

6.10.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.10.2 URIs

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

6.10.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.10.4 Actions

6.10.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.10.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.10.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_3.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.11 BootOption 1.0.4

Version v1.0
Release 2017.3

6.11.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.11.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.11.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.11.4 Property details

6.11.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.11.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.12 Certificate 1.3.0

Version v1.3 v1.2 v1.1 v1.0
Release 2021.1 2020.1 2019.1 2018.3

6.12.1 Description

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

6.12.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}/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/EventService/Subscriptions/{EventDestinationId}/Certificates/{CertificateId}
/redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/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}/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/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}/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/UpdateService/RemoteServerCertificates/{CertificateId}

6.12.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.
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.
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.
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.12.4 Actions

6.12.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.
}

6.12.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.
}

6.12.5 Property details

6.12.5.1 CertificateType:

The format of the certificate.

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

6.12.5.2 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.12.6 Example response

{
    "@odata.type": "#Certificate.v1_3_0.Certificate",
    "Id": "1",
    "Name": "HTTPS Certificate",
    "CertificateString": "-----BEGIN CERTIFICATE-----\nMIIFsTCC [**truncated example**] 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.13 CertificateLocations 1.0.2

Version v1.0
Release 2018.3

6.13.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.13.2 URIs

/redfish/v1/CertificateService/CertificateLocations

6.13.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.13.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.14 CertificateService 1.0.4

Version v1.0
Release 2018.3

6.14.1 Description

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

6.14.2 URIs

/redfish/v1/CertificateService

6.14.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.14.4 Actions

6.14.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.14.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.14.5 Property details

6.14.5.1 CertificateType:

The format of the certificate.

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

6.14.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.14.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.15 Chassis 1.16.0

Version v1.16 v1.15 v1.14 v1.13 v1.12 v1.11 v1.10 v1.9 v1.8 v1.7 v1.6 ...
Release 2021.1 2020.4 2020.3 2020.2 2020.1 2019.4 2019.2 2018.3 2018.2 2018.1 2017.3 ...

6.15.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.15.2 URIs

/redfish/v1/Chassis/{ChassisId}

6.15.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.
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.
}
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.
      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.
      } ]
      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+) [ { array An array of DSP0274-defined measurement blocks.
      @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.15.4 Actions

6.15.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.

6.15.5 Property details

6.15.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.15.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.15.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.15.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.15.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.15.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.15.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.
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.

6.15.6 Example response

{
    "@odata.type": "#Chassis.v1_16_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.16 Circuit 1.2.0

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

6.16.1 Description

This is the schema definition for an electrical circuit.

6.16.2 URIs

/redfish/v1/PowerEquipment/FloorPDUs/{PowerDistributionId}/Branches/{CircuitId}
/redfish/v1/PowerEquipment/FloorPDUs/{PowerDistributionId}/Mains/{CircuitId}
/redfish/v1/PowerEquipment/FloorPDUs/{PowerDistributionId}/Subfeeds/{CircuitId}
/redfish/v1/PowerEquipment/RackPDUs/{PowerDistributionId}/Branches/{CircuitId}
/redfish/v1/PowerEquipment/RackPDUs/{PowerDistributionId}/Mains/{CircuitId}
/redfish/v1/PowerEquipment/TransferSwitches/{PowerDistributionId}/Branches/{CircuitId}
/redfish/v1/PowerEquipment/TransferSwitches/{PowerDistributionId}/Feeders/{CircuitId}
/redfish/v1/PowerEquipment/TransferSwitches/{PowerDistributionId}/Mains/{CircuitId}

6.16.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.
CriticalCircuit boolean read-write
(null)
Designates if this is a critical circuit.
CurrentAmps {} object The current reading for this single phase circuit. For more information about this property, see SensorCurrentExcerpt in Property Details.
ElectricalContext string
(enum)
read-only
(null)
The combination of current-carrying conductors. For the possible property values, see ElectricalContext in Property details.
EnergykWh {} object The energy reading for this circuit. For more information about this property, see SensorEnergykWhExcerpt in Property Details.
FrequencyHz { object
(excerpt)
The frequency reading for this circuit. 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.
}
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.
      }
      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.
      } ]
}
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 sensor. For more information about this property, see SensorCurrentExcerpt in Property Details.
      Line2 {} object Line 2 current sensor. For more information about this property, see SensorCurrentExcerpt in Property Details.
      Line3 {} object Line 3 current sensor. For more information about this property, see SensorCurrentExcerpt in Property Details.
      Neutral {} object Neutral line current sensor. 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 reading for this circuit. For more information about this property, see SensorEnergykWhExcerpt in Property Details.
      Line1ToNeutral {} object The Line 1 to Neutral energy reading for this circuit. For more information about this property, see SensorEnergykWhExcerpt in Property Details.
      Line2ToLine3 {} object The Line 2 to Line 3 energy reading for this circuit. For more information about this property, see SensorEnergykWhExcerpt in Property Details.
      Line2ToNeutral {} object The Line 2 to Neutral energy reading for this circuit. For more information about this property, see SensorEnergykWhExcerpt in Property Details.
      Line3ToLine1 {} object The Line 3 to Line 1 energy reading for this circuit. For more information about this property, see SensorEnergykWhExcerpt in Property Details.
      Line3ToNeutral {} object The Line 3 to Neutral energy reading 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 reading for this circuit. For more information about this property, see SensorPowerExcerpt in Property Details.
      Line1ToNeutral {} object The Line 1 to Neutral power reading for this circuit. For more information about this property, see SensorPowerExcerpt in Property Details.
      Line2ToLine3 {} object The Line 2 to Line 3 power reading for this circuit. For more information about this property, see SensorPowerExcerpt in Property Details.
      Line2ToNeutral {} object The Line 2 to Neutral power reading for this circuit. For more information about this property, see SensorPowerExcerpt in Property Details.
      Line3ToLine1 {} object The Line 3 to Line 1 power reading for this circuit. For more information about this property, see SensorPowerExcerpt in Property Details.
      Line3ToNeutral {} object The Line 3 to Neutral power reading 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 reading for this circuit. For more information about this property, see SensorVoltageExcerpt in Property Details.
      Line1ToNeutral {} object The Line 1 to Neutral voltage reading for this circuit. For more information about this property, see SensorVoltageExcerpt in Property Details.
      Line2ToLine3 {} object The Line 2 to Line 3 voltage reading for this circuit. For more information about this property, see SensorVoltageExcerpt in Property Details.
      Line2ToNeutral {} object The Line 2 to Neutral voltage reading for this circuit. For more information about this property, see SensorVoltageExcerpt in Property Details.
      Line3ToLine1 {} object The Line 3 to Line 1 voltage reading for this circuit. For more information about this property, see SensorVoltageExcerpt in Property Details.
      Line3ToNeutral {} object The Line 3 to Neutral voltage reading for this circuit. For more information about this property, see SensorVoltageExcerpt in Property Details.
}
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.
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.
PowerWatts {} object The power reading 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.
Voltage {} object The voltage reading 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.16.4 Actions

6.16.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.

6.16.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.

6.16.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.16.5 Property details

6.16.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.16.5.2 CircuitType:

The type of circuit.

string Description
Branch A branch (output) circuit.
Feeder A feeder (output) circuit.
Mains A mains input or utility circuit.
Subfeed A subfeed (output) circuit.

6.16.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.16.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.16.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.16.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.16.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.16.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.16.5.9 PowerState:

6.16.5.9.1 In Actions: BreakerControl:

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

string Description
Off The circuit is powered off.
On The circuit is powered on.
6.16.5.9.2 In Actions: PowerControl, :

The desired power state of the circuit.

string Description
Off The state is powered off.
On The state is powered on.
PoweringOff A temporary state between on and off.
PoweringOn A temporary state between off and on.

6.16.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.16.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.

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.
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.16.5.12 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.
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 ApparentVA and squared Power (Reading) for a circuit, in var units.
Reading number read-only
(null)
The sensor value.

6.16.5.13 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.16.5.14 VoltageType:

The type of voltage applied to the circuit.

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

6.16.6 Example response

{
    "@odata.type": "#Circuit.v1_2_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.17 CompositionReservation 1.0.0

Version v1.0
Release 2021.1

6.17.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.17.2 URIs

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

6.17.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.17.4 Property details

6.17.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.17.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.18 CompositionService 1.2.0

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

6.18.1 Description

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

6.18.2 URIs

/redfish/v1/CompositionService

6.18.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.18.4 Actions

6.18.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.18.5 Property details

6.18.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.18.5.2 RequestFormat:

The format of the request.

string Description
Manifest The request body contains a manifest.

6.18.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.18.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.18.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.19 ComputerSystem 1.15.0

Version v1.15 v1.14 v1.13 v1.12 v1.11 v1.10 v1.9 v1.8 v1.7 v1.6 v1.5 ...
Release 2021.1 2020.4 2020.3 2020.2 2020.1 2019.4 2019.3 2019.2 2019.1 2018.3 2017.3 ...

6.19.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.19.2 URIs

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

6.19.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.
      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.
      Certificates (v1.7+) { object The link to a collection of certificates used for booting through HTTPS by this computer system. Contains a link to a resource.
            @odata.id string read-only Link to Collection of Certificate. See the Certificate schema for details.
      }
      HttpBootUri (v1.9+) string
(URI)
read-write
(null)
The URI to boot from when BootSourceOverrideTarget is set to UefiHttp.
      RemainingAutomaticRetryAttempts (v1.11+) integer read-only
(null)
The number of remaining automatic retry boots.
      StopBootOnFault (v1.15+) string
(enum)
read-write
(null)
If the boot should stop on a fault. For the possible property values, see StopBootOnFault in Property details.
      TrustedModuleRequiredToBoot (v1.14+) string
(enum)
read-write
(null)
The Trusted Module boot requirement. For the possible property values, see TrustedModuleRequiredToBoot in Property details.
      UefiTargetBootSourceOverride string read-write
(null)
The UEFI device path of the device from which to boot when BootSourceOverrideTarget is UefiTarget.
}
BootProgress (v1.13+) { object
(null)
This object describes the last boot progress state.
      LastState (v1.13+) string
(enum)
read-only
(null)
The last boot progress state. For the possible property values, see LastState in Property details.
      LastStateTime (v1.13+) string
(date-time)
read-only
(null)
The date and time when the last boot state was updated.
      Oem (v1.13+) {} object See the Oem object definition in the Common properties section.
      OemLastState (v1.13+) string read-only
(null)
The OEM-specific last state, if the LastState type is OEM.
}
Certificates (v1.14+) { 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.
}
EthernetInterfaces { object The link to the collection of Ethernet interfaces associated with this system. Contains a link to a resource.
      @odata.id string read-only Link to Collection of EthernetInterface. See the EthernetInterface schema for details.
}
FabricAdapters (v1.10+) { object The link to the collection of fabric adapters associated with this system. Contains a link to a resource.
      @odata.id string read-only Link to Collection of FabricAdapter. See the FabricAdapter schema for details.
}
GraphicalConsole (v1.13+) { object The information about the graphical console (KVM-IP) service of this system.
      ConnectTypesSupported (v1.13+) [ ] array (string
(enum))
read-only This property enumerates the graphical console connection types that the implementation allows. For the possible property values, see ConnectTypesSupported in Property details.
      MaxConcurrentSessions (v1.13+) integer read-only The maximum number of service sessions, regardless of protocol, that this system can support.
      Port (v1.13+) integer read-write
(null)
The protocol port.
      ServiceEnabled (v1.13+) boolean read-write An indication of whether the service is enabled for this system.
}
GraphicsControllers (v1.15+) { object The link to a collection of graphics controllers that can output video for this system. Contains a link to a resource.
      @odata.id string read-only Link to Collection of GraphicsController. See the GraphicsController schema for details.
}
HostedServices (v1.2+) { object The services that this computer system supports.
      Oem (v1.2+) {} object See the Oem object definition in the Common properties section.
      StorageServices (v1.2+) { object The link to a collection of storage services that this computer system supports.
            @odata.id string
(URI)
read-only The unique identifier for a resource.
      }
}
HostingRoles (v1.2+) [ ] array (string
(enum))
read-only The hosting roles that this computer system supports. For the possible property values, see HostingRoles in Property details.
HostName string read-write
(null)
The DNS host name, without any domain information.
HostWatchdogTimer (v1.5+) { object The host watchdog timer functionality for this system.
      FunctionEnabled (v1.5+) boolean read-write required
(null)
An indication of whether a user has enabled the host watchdog timer functionality. This property indicates only that a user has enabled the timer. To activate the timer, installation of additional host-based software is necessary; an update to this property does not initiate the timer.
      Oem (v1.5+) {} object See the Oem object definition in the Common properties section.
      Status (v1.5+) {} object The status and health of the resource and its subordinate or dependent resources. For property details, see Status.
      TimeoutAction (v1.5+) string
(enum)
read-write required
(null)
The action to perform when the watchdog timer reaches its timeout value. For the possible property values, see TimeoutAction in Property details.
      WarningAction (v1.5+) string
(enum)
read-write
(null)
The action to perform when the watchdog timer is close to reaching its timeout value. This action typically occurs from three to ten seconds before to the timeout value, but the exact timing is dependent on the implementation. For the possible property values, see WarningAction in Property details.
}
IndicatorLED (deprecated v1.13) string
(enum)
read-write
(null)
The state of the indicator LED, which identifies the system. For the possible property values, see IndicatorLED in Property details. Deprecated in v1.13 and later. This property has been deprecated in favor of the LocationIndicatorActive property.
LastResetTime (v1.12+) string
(date-time)
read-only The date and time when the system was last reset or rebooted.
Links { object The links to other resources that are related to this resource.
      Chassis [ { array An array of links to the chassis that contains this system.
            @odata.id string read-only Link to a Chassis resource. See the Links section and the Chassis schema for details.
      } ]
      ConsumingComputerSystems (v1.5+) [ { array An array of links to ComputerSystems that are realized, in whole or in part, from this ComputerSystem.
            @odata.id string read-only Link to another ComputerSystem resource.
      } ]
      CooledBy [ { array An array of links to resources or objects that that cool this computer system. 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.
      } ]
      Endpoints (v1.2+) [ { array An array of links to the endpoints that connect to this system.
            @odata.id string read-only Link to a Endpoint resource. See the Links section and the Endpoint schema for details.
      } ]
      ManagedBy [ { array An array of links to the managers responsible for this system.
            @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.
      PoweredBy [ { array An array of links to resources or objects that power this computer system. 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.
      } ]
      ResourceBlocks (v1.4+) [ { array An array of links to the resource blocks that are used in this computer system.
            @odata.id string read-write Link to a ResourceBlock resource. See the Links section and the ResourceBlock schema for details.
      } ]
      SupplyingComputerSystems (v1.5+) [ { array An array of links to ComputerSystems that contribute, in whole or in part, to the implementation of this ComputerSystem.
            @odata.id string read-only Link to another ComputerSystem resource.
      } ]
}
LocationIndicatorActive (v1.13+) boolean read-write
(null)
An indicator allowing an operator to physically locate this resource.
LogServices { object The link to the collection of log services associated with this system. 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 or OEM of this system.
Measurements (v1.14+) [ { array An array of DSP0274-defined measurement blocks.
      @odata.id string read-only Link to a MeasurementBlock resource. See the Links section and the SoftwareInventory schema for details.
} ]
Memory (v1.1+) { object The link to the collection of memory associated with this system. Contains a link to a resource.
      @odata.id string read-only Link to Collection of Memory. See the Memory schema for details.
}
MemoryDomains (v1.2+) { object The link to the collection of memory domains associated with this system. Contains a link to a resource.
      @odata.id string read-only Link to Collection of MemoryDomain. See the MemoryDomain schema for details.
}
MemorySummary { object The central memory of the system in general detail.
      MemoryMirroring (v1.1+) string
(enum)
read-only
(null)
The ability and type of memory mirroring that this computer system supports. For the possible property values, see MemoryMirroring in Property details.
      Metrics (v1.8+) { object The link to the metrics associated with all memory in this system. See the MemoryMetrics schema for details on this property.
            @odata.id string read-only Link to a MemoryMetrics resource. See the Links section and the MemoryMetrics schema for details.
      }
      Status {} object The status and health of the resource and its subordinate or dependent resources. For property details, see Status.
      TotalSystemMemoryGiB number
(GiBy)
read-only
(null)
The total configured operating system-accessible memory (RAM), measured in GiB.
      TotalSystemPersistentMemoryGiB (v1.4+) number
(GiBy)
read-only
(null)
The total configured, system-accessible persistent memory, measured in GiB.
}
Model string read-only
(null)
The product name for this system, without the manufacturer name.
NetworkInterfaces (v1.3+) { object The link to the collection of Network Interfaces associated with this system. Contains a link to a resource.
      @odata.id string read-only Link to Collection of NetworkInterface. See the NetworkInterface schema for details.
}
PartNumber string read-only
(null)
The part number for this system.
PCIeDevices (v1.2+) [ { array The link to a collection of PCIe devices that this computer system uses.
      @odata.id string read-only Link to a PCIeDevice resource. See the Links section and the PCIeDevice schema for details.
} ]
PCIeFunctions (v1.2+) [ { array The link to a collection of PCIe functions that this computer system uses.
      @odata.id string read-only Link to a PCIeFunction resource. See the Links section and the PCIeFunction schema for details.
} ]
PowerCycleDelaySeconds (v1.13+) number read-write
(null)
The number of seconds to delay power on after a Reset action requesting PowerCycle. Zero seconds indicates no delay.
PowerMode (v1.15+) string
(enum)
read-write
(null)
The power mode setting of the computer system. For the possible property values, see PowerMode in Property details.
PowerOffDelaySeconds (v1.13+) number read-write
(null)
The number of seconds to delay power off during a reset. Zero seconds indicates no delay to power off.
PowerOnDelaySeconds (v1.13+) number read-write
(null)
The number of seconds to delay power on after a power cycle or during a reset. Zero seconds indicates no delay to power up.
PowerRestorePolicy (v1.6+) string
(enum)
read-write The desired power state of the system 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 current power state of the system. For the possible property values, see PowerState in Property details.
Processors { object The link to the collection of processors associated with this system. Contains a link to a resource.
      @odata.id string read-only Link to Collection of Processor. See the Processor schema for details.
}
ProcessorSummary { object The central processors of the system in general detail.
      CoreCount (v1.14+) integer read-only
(null)
The number of processor cores in the system.
      Count integer read-only
(null)
The number of physical processors in the system.
      LogicalProcessorCount (v1.5+) integer read-only
(null)
The number of logical processors in the system.
      Metrics (v1.7+) { object The link to the metrics associated with all processors in this system. See the ProcessorMetrics schema for details on this property.
            @odata.id string read-only Link to a ProcessorMetrics resource. See the Links section and the ProcessorMetrics schema for details.
      }
      Model string read-only
(null)
The processor model for the primary or majority of processors in this system.
      Status {} object The status and health of the resource and its subordinate or dependent resources. For property details, see Status.
      ThreadingEnabled (v1.15+) boolean read-write An indication of whether threading is enabled on all processors in this system.
}
Redundancy (v1.5+) [ { } ] array (object) The link to a collection of redundancy entities. Each entity specifies a kind and level of redundancy and a collection, or redundancy set, of other computer systems that provide the specified redundancy to this computer system. For property details, see Redundancy.
SecureBoot (v1.1+) { object The link to the UEFI Secure Boot associated with this system. See the SecureBoot schema for details on this property.
      @odata.id string read-only Link to a SecureBoot resource. See the Links section and the SecureBoot schema for details.
}
SerialConsole (v1.13+) { object The serial console services that this system provides.
      IPMI (v1.13+) {} object The connection details for an IPMI Serial-over-LAN service. For more information about this property, see SerialConsoleProtocol in Property Details.
      MaxConcurrentSessions (v1.13+) integer read-only The maximum number of service sessions, regardless of protocol, that this system can support.
      SSH (v1.13+) {} object The connection details for an SSH serial console service. For more information about this property, see SerialConsoleProtocol in Property Details.
      Telnet (v1.13+) {} object The connection details for a Telnet serial console service. For more information about this property, see SerialConsoleProtocol in Property Details.
}
SerialNumber string read-only
(null)
The serial number for this system.
SimpleStorage { object The link to the collection of storage devices associated with this system. Contains a link to a resource.
      @odata.id string read-only Link to Collection of SimpleStorage. See the SimpleStorage schema for details.
}
SKU string read-only
(null)
The manufacturer SKU for this system.
Status {} object The status and health of the resource and its subordinate or dependent resources. For property details, see Status.
Storage (v1.1+) { object The link to the collection of storage devices associated with this system. Contains a link to a resource.
      @odata.id string read-only Link to Collection of Storage. See the Storage schema for details.
}
SubModel (v1.5+) string read-only
(null)
The sub-model for this system.
SystemType string
(enum)
read-only The type of computer system that this resource represents. For the possible property values, see SystemType in Property details.
TrustedModules (v1.1+) [ { array An array of trusted modules in the system.
      FirmwareVersion (v1.1+) string read-only
(null)
The firmware version of this Trusted Module.
      FirmwareVersion2 (v1.3+) string read-only
(null)
The second firmware version of this Trusted Module, if applicable.
      InterfaceType (v1.1+) string
(enum)
read-only
(null)
The interface type of the Trusted Module. For the possible property values, see InterfaceType in Property details.
      InterfaceTypeSelection (v1.3+) string
(enum)
read-only
(null)
The interface type selection supported by this Trusted Module. For the possible property values, see InterfaceTypeSelection in Property details.
      Oem (v1.1+) {} object See the Oem object definition in the Common properties section.
      Status (v1.1+) {} object The status and health of the resource and its subordinate or dependent resources. For property details, see Status.
} ]
USBControllers (v1.15+) { object The link to a collection of USB controllers for this system. Contains a link to a resource.
      @odata.id string read-only Link to Collection of USBController. See the USBController schema for details.
}
UUID string read-only
(null)
The UUID for this system. For more information about this property, see Property details.
VirtualMedia (v1.13+) { object The link to the virtual media services for this system. Contains a link to a resource.
      @odata.id string read-only Link to Collection of VirtualMedia. See the VirtualMedia schema for details.
}
VirtualMediaConfig (v1.13+) { object The information about the virtual media service of this system.
      Port (v1.13+) integer read-write
(null)
The protocol port.
      ServiceEnabled (v1.13+) boolean read-write An indication of whether the service is enabled for this system.
}

6.19.4 Actions

6.19.4.1 AddResourceBlock (v1.6+)

Description

This action adds a resource block to a system.

Action URI: {Base URI of target resource}/Actions/ComputerSystem.AddResourceBlock

Action parameters

Parameter Name Type Attributes Notes
      ComputerSystemETag string optional The current ETag of the system.
      ResourceBlock { object required The resource block to add to the system. See the ResourceBlock schema for details on this property.
            @odata.id string read-only Link to a ResourceBlock resource. See the Links section and the ResourceBlock schema for details.
      }
      ResourceBlockETag string optional The current ETag of the resource block to add to the system.

6.19.4.2 RemoveResourceBlock (v1.6+)

Description

This action removes a resource block from a system.

Action URI: {Base URI of target resource}/Actions/ComputerSystem.RemoveResourceBlock

Action parameters

Parameter Name Type Attributes Notes
      ComputerSystemETag string optional The current ETag of the system.
      ResourceBlock { object required The resource block to remove from the system. See the ResourceBlock schema for details on this property.
            @odata.id string read-only Link to a ResourceBlock resource. See the Links section and the ResourceBlock schema for details.
      }
      ResourceBlockETag string optional The current ETag of the resource block to remove from the system.

6.19.4.3 Reset

Description

This action resets the system.

Action URI: {Base URI of target resource}/Actions/ComputerSystem.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.19.4.4 SetDefaultBootOrder (v1.5+)

Description

This action sets the BootOrder to the default settings.

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

Action parameters

This action takes no parameters.

6.19.5 Property details

6.19.5.1 AliasBootOrder:

Ordered array of boot source aliases representing the persistent boot order associated with this computer system.

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.19.5.2 AutomaticRetryConfig:

The configuration of how the system retries booting automatically.

string Description
Disabled Disable automatic retrying of booting.
RetryAlways Always automatically retry booting.
RetryAttempts Automatic retrying of booting is based on a specified retry count.

6.19.5.3 BootOrderPropertySelection:

The name of the boot order property that the system uses for the persistent boot order.

string Description
AliasBootOrder The system uses the AliasBootOrder property to specify the persistent boot order.
BootOrder The system uses the BootOrder property to specify the persistent boot order.

6.19.5.4 BootSourceOverrideEnabled:

The state of the boot source override feature.

string Description
Continuous The system boots to the target specified in the BootSourceOverrideTarget property until this property is Disabled.
Disabled The system boots normally.
Once On its next boot cycle, the system boots one time to the boot source override target. Then, the BootSourceOverrideEnabled value is reset to Disabled.

6.19.5.5 BootSourceOverrideMode:

The BIOS boot mode to use when the system boots from the BootSourceOverrideTarget boot source.

string Description
Legacy The system boots in non-UEFI boot mode to the boot source override target.
UEFI The system boots in UEFI boot mode to the boot source override target.

6.19.5.6 BootSourceOverrideTarget:

The current boot source to use at the next boot instead of the normal boot device, if BootSourceOverrideEnabled is true.

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 (v1.2+) Boot from a remote drive, such as an iSCSI target.
SDCard (v1.1+) Boot from an SD card.
UefiBootNext (v1.5+) Boot to the UEFI device that the BootNext property specifies.
UefiHttp (v1.1+) 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.19.5.7 ConnectTypesSupported:

This property enumerates the graphical console connection types that the implementation allows.

string Description
KVMIP The controller supports a graphical console connection through a KVM-IP (redirection of Keyboard, Video, Mouse over IP) protocol.
OEM The controller supports a graphical console connection through an OEM-specific protocol.

6.19.5.8 HostingRoles:

The hosting roles that this computer system supports.

string Description
Appliance The system hosts functionality that supports the system acting as an appliance.
ApplicationServer The system hosts functionality that supports general purpose applications.
BareMetalServer The system hosts functionality that supports the system acting as a bare metal server.
ContainerServer The system hosts functionality that supports the system acting as a container server.
StorageServer The system hosts functionality that supports the system acting as a storage server.
Switch The system hosts functionality that supports the system acting as a switch.
VirtualMachineServer The system hosts functionality that supports the system acting as a virtual machine server.

6.19.5.9 IndicatorLED:

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

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

6.19.5.10 InterfaceType:

The interface type of the Trusted Module.

string Description
TCM1_0 Trusted Cryptography Module (TCM) 1.0.
TPM1_2 Trusted Platform Module (TPM) 1.2.
TPM2_0 Trusted Platform Module (TPM) 2.0.

6.19.5.11 InterfaceTypeSelection:

The interface type selection supported by this Trusted Module.

string Description
BiosSetting The TrustedModule supports switching InterfaceType through platform software, such as a BIOS configuration attribute.
FirmwareUpdate The TrustedModule supports switching InterfaceType through a firmware update.
None The TrustedModule does not support switching the InterfaceType.
OemMethod The TrustedModule supports switching InterfaceType through an OEM proprietary mechanism.

6.19.5.12 LastState:

The last boot progress state.

string Description
BusInitializationStarted The system has started initializing the buses.
MemoryInitializationStarted The system has started initializing the memory.
None The system is not booting.
OEM A boot progress state in an OEM-defined format.
OSBootStarted The operating system has started booting.
OSRunning The operating system is running.
PCIResourceConfigStarted The system has started initializing the PCI resources.
PrimaryProcessorInitializationStarted The system has started initializing the primary processor.
SecondaryProcessorInitializationStarted The system has started initializing the remaining processors.
SetupEntered (v1.15+) The system has entered the setup utility.
SystemHardwareInitializationComplete The system has completed initializing all hardware.

6.19.5.13 MemoryMirroring:

The ability and type of memory mirroring that this computer system supports.

string Description
DIMM The system supports DIMM mirroring at the DIMM level. Individual DIMMs can be mirrored.
Hybrid The system supports a hybrid mirroring at the system and DIMM levels. Individual DIMMs can be mirrored.
None The system does not support DIMM mirroring.
System The system supports DIMM mirroring at the system level. Individual DIMMs are not paired for mirroring in this mode.

6.19.5.14 PowerMode:

The power mode setting of the computer system.

string Description
BalancedPerformance The system performs at the highest speeds while utilization is high and performs at reduced speeds when the utilization is low.
MaximumPerformance The system performs at the highest speeds possible.
OEM The system power mode is OEM-defined.
OSControlled The system power mode is controlled by the operating system.
PowerSaving The system performs at reduced speeds to save power.
Static The system power mode is static.

6.19.5.15 PowerRestorePolicy:

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

string Description
AlwaysOff The system always remains powered off when power is applied.
AlwaysOn The system always powers on when power is applied.
LastState The system returns to its last on or off power state when power is applied.

6.19.5.16 PowerState:

The current power state of the system.

string Description
Off The system is powered off, although some components might continue to have AUX power such as management controller.
On The system is powered on.
PoweringOff A temporary state between on and off. The power off action can take time while the OS is in the shutdown process.
PoweringOn A temporary state between off and on. This temporary state can be very short.

6.19.5.17 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.
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.

6.19.5.18 SerialConsoleProtocol:

The information about a serial console service that this system provides.

ConsoleEntryCommand (v1.13+) string read-only
(null)
The command string passed to the service to select or enter the system's serial console.
HotKeySequenceDisplay (v1.13+) string read-only
(null)
The hotkey sequence available for the user to exit the serial console session.
Port (v1.13+) integer read-write
(null)
The protocol port.
ServiceEnabled (v1.13+) boolean read-write An indication of whether the service is enabled for this system.
SharedWithManagerCLI (v1.13+) boolean read-only Indicates whether the serial console service is shared with access to the manager's command-line interface (CLI).

6.19.5.19 StopBootOnFault:

If the boot should stop on a fault.

string Description
AnyFault The system should stop the boot on any fault.
Never The system performs any normal recovery actions during boot if a fault occurs.

6.19.5.20 SystemType:

The type of computer system that this resource represents.

string Description
Composed (v1.4+) A computer system constructed by binding resource blocks together.
OS An operating system instance.
Physical A computer system.
PhysicallyPartitioned A hardware-based partition of a computer system.
Virtual A virtual machine instance running on this system.
VirtuallyPartitioned A virtual or software-based partition of a computer system.

6.19.5.21 TimeoutAction:

The action to perform when the watchdog timer reaches its timeout value.

string Description
None No action taken.
OEM Perform an OEM-defined action.
PowerCycle Power cycle the system.
PowerDown Power down the system.
ResetSystem Reset the system.

6.19.5.22 TrustedModuleRequiredToBoot:

The Trusted Module boot requirement.

string Description
Disabled No Trusted Module requirement to boot.
Required A functional Trusted Module is required to boot.

6.19.5.23 UUID:

The UUID for this system.

The UUID property contains a value that represents the universal unique identifier number (UUID) of a system.

The UUID property is a string data type. The format of the string is the 35-character string format specified in RFC4122: "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx". Each x represents a hexadecimal digit (0-f).

Regarding the case of the hex values, RFC4122 specifies that the hex values should be lowercase characters. Most modern scripting languages typically also represent hex values in lowercase characters following the RFC. However, dmidecode, WMI and some Redfish implementations currently use uppercase characters for UUID on output.

6.19.5.24 WarningAction:

The action to perform when the watchdog timer is close to reaching its timeout value. This action typically occurs from three to ten seconds before to the timeout value, but the exact timing is dependent on the implementation.

string Description
DiagnosticInterrupt Raise a (typically non-maskable) Diagnostic Interrupt.
MessagingInterrupt Raise a legacy IPMI messaging interrupt.
None No action taken.
OEM Perform an OEM-defined action.
SCI Raise an interrupt using the ACPI System Control Interrupt (SCI).
SMI Raise a Systems Management Interrupt (SMI).

6.19.6 Example response

{
    "@odata.type": "#ComputerSystem.v1_15_0.ComputerSystem",
    "Id": "437XR1138R2",
    "Name": "WebFrontEnd483",
    "SystemType": "Physical",
    "AssetTag": "Chicago-45Z-2381",
    "Manufacturer": "Contoso",
    "Model": "3500RX",
    "SKU": "8675309",
    "SerialNumber": "437XR1138R2",
    "PartNumber": "224071-J23",
    "Description": "Web Front End node",
    "UUID": "38947555-7742-3448-3784-823347823834",
    "HostName": "web483",
    "Status": {
        "State": "Enabled",
        "Health": "OK",
        "HealthRollup": "OK"
    },
    "HostingRoles": [
        "ApplicationServer"
    ],
    "IndicatorLED": "Off",
    "PowerState": "On",
    "Boot": {
        "BootSourceOverrideEnabled": "Once",
        "BootSourceOverrideTarget": "Pxe",
        "BootSourceOverrideTarget@Redfish.AllowableValues": [
            "None",
            "Pxe",
            "Cd",
            "Usb",
            "Hdd",
            "BiosSetup",
            "Utilities",
            "Diags",
            "SDCard",
            "UefiTarget"
        ],
        "BootSourceOverrideMode": "UEFI",
        "UefiTargetBootSourceOverride": "/0x31/0x33/0x01/0x01"
    },
    "TrustedModules": [
        {
            "FirmwareVersion": "1.13b",
            "InterfaceType": "TPM1_2",
            "Status": {
                "State": "Enabled",
                "Health": "OK"
            }
        }
    ],
    "Oem": {
        "Contoso": {
            "@odata.type": "#Contoso.ComputerSystem",
            "ProductionLocation": {
                "FacilityName": "PacWest Production Facility",
                "Country": "USA"
            }
        },
        "Chipwise": {
            "@odata.type": "#Chipwise.ComputerSystem",
            "Style": "Executive"
        }
    },
    "BiosVersion": "P79 v1.33 (02/28/2015)",
    "ProcessorSummary": {
        "Count": 2,
        "Model": "Multi-Core Intel(R) Xeon(R) processor 7xxx Series",
        "Status": {
            "State": "Enabled",
            "Health": "OK",
            "HealthRollup": "OK"
        }
    },
    "MemorySummary": {
        "TotalSystemMemoryGiB": 96,
        "TotalSystemPersistentMemoryGiB": 0,
        "MemoryMirroring": "None",
        "Status": {
            "State": "Enabled",
            "Health": "OK",
            "HealthRollup": "OK"
        }
    },
    "Bios": {
        "@odata.id": "/redfish/v1/Systems/437XR1138R2/BIOS"
    },
    "Processors": {
        "@odata.id": "/redfish/v1/Systems/437XR1138R2/Processors"
    },
    "Memory": {
        "@odata.id": "/redfish/v1/Systems/437XR1138R2/Memory"
    },
    "EthernetInterfaces": {
        "@odata.id": "/redfish/v1/Systems/437XR1138R2/EthernetInterfaces"
    },
    "SimpleStorage": {
        "@odata.id": "/redfish/v1/Systems/437XR1138R2/SimpleStorage"
    },
    "LogServices": {
        "@odata.id": "/redfish/v1/Systems/437XR1138R2/LogServices"
    },
    "Links": {
        "Chassis": [
            {
                "@odata.id": "/redfish/v1/Chassis/1U"
            }
        ],
        "ManagedBy": [
            {
                "@odata.id": "/redfish/v1/Managers/BMC"
            }
        ]
    },
    "Actions": {
        "#ComputerSystem.Reset": {
            "target": "/redfish/v1/Systems/437XR1138R2/Actions/ComputerSystem.Reset",
            "ResetType@Redfish.AllowableValues": [
                "On",
                "ForceOff",
                "GracefulShutdown",
                "GracefulRestart",
                "ForceRestart",
                "Nmi",
                "ForceOn",
                "PushPowerButton"
            ]
        },
        "Oem": {
            "#Contoso.Reset": {
                "target": "/redfish/v1/Systems/437XR1138R2/Oem/Contoso/Actions/Contoso.Reset"
            }
        }
    },
    "@odata.id": "/redfish/v1/Systems/437XR1138R2"
}

6.20 Connection 1.1.0

Version v1.1 v1.0
Release 2021.1 2020.3

6.20.1 Description

The Connection schema describes the access permissions endpoints, or groups of endpoints, have with other resources in the service.

6.20.2 URIs

/redfish/v1/Fabrics/{FabricId}/Connections/{ConnectionId}

6.20.3 Properties

Property Type Attributes Notes
ConnectionKeys (v1.1+) { object The permission keys required to access the specified resources for this connection.
      GenZ (v1.1+) { object
(null)
The Gen-Z-specific permission key information for this connection.
            AccessKey (v1.1+) string read-write The Access Key for this connection.
            RKeyDomainCheckingEnabled (v1.1+) boolean read-write Indicates whether Region Key domain checking is enabled for this connection.
            RKeyReadOnlyKey (v1.1+) string read-write The read-only Region Key for this connection.
            RKeyReadWriteKey (v1.1+) string read-write The read-write Region Key for this connection.
      }
}
ConnectionType string
(enum)
read-only
(null)
The type of resources this connection specifies. For the possible property values, see ConnectionType in Property details.
Links { object The links to other resources that are related to this resource.
      InitiatorEndpointGroups [ { array An array of links to the initiator endpoint groups that are associated with this connection.
            @odata.id string read-write Link to a EndpointGroup resource. See the Links section and the EndpointGroup schema for details.
      } ]
      InitiatorEndpoints [ { array An array of links to the initiator endpoints that are associated with this connection.
            @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.
      TargetEndpointGroups [ { array An array of links to the target endpoint groups that are associated with this connection.
            @odata.id string read-write Link to a EndpointGroup resource. See the Links section and the EndpointGroup schema for details.
      } ]
      TargetEndpoints [ { array An array of links to the target endpoints that are associated with this connection.
            @odata.id string read-write Link to a Endpoint resource. See the Links section and the Endpoint schema for details.
      } ]
}
MemoryChunkInfo (v1.1+) [ { array The set of memory chunks and access capabilities specified for this connection.
      AccessCapabilities (v1.1+) [ ] array (string
(enum))
read-write
(null)
Supported IO access capabilities. For the possible property values, see AccessCapabilities in Property details.
      AccessState (v1.1+) string
(enum)
read-write
(null)
The access state for this connection. For the possible property values, see AccessState in Property details.
      MemoryChunk (v1.1+) { object
(null)
The specified memory chunk. See the MemoryChunks schema for details on this property.
            @odata.id string read-write Link to a MemoryChunks resource. See the Links section and the MemoryChunks schema for details.
      }
} ]
Status {} object The status and health of the resource and its subordinate or dependent resources. For property details, see Status.
VolumeInfo [ { array The set of volumes and access capabilities specified for this connection.
      AccessCapabilities [ ] array (string
(enum))
read-write
(null)
Supported IO access capabilities. For the possible property values, see AccessCapabilities in Property details.
      AccessState string
(enum)
read-write
(null)
The access state for this connection. For the possible property values, see AccessState in Property details.
      Volume { object The specified volume.
            @odata.id string
(URI)
read-only The unique identifier for a resource.
      }
} ]

6.20.4 Property details

6.20.4.1 AccessCapabilities:

Supported IO access capabilities.

string Description
Read Endpoints are allowed to perform reads from the specified resource.
Write Endpoints are allowed to perform writes to the specified resource.

6.20.4.2 AccessState:

The access state for this connection.

string Description
NonOptimized The resource is in an active and non-optimized state.
Optimized The resource is in an active and optimized state.
Standby The resource is in a standby state.
Transitioning The resource is transitioning to a new state.
Unavailable The resource is in an unavailable state.

6.20.4.3 ConnectionType:

The type of resources this connection specifies.

string Description
Memory A connection to memory related resources.
Storage A connection to storage related resources, such as volumes.

6.20.5 Example response

{
    "@odata.type": "#Connection.v1_1_0.Connection",
    "Id": "1",
    "Name": "Connection info for host 1",
    "ConnectionType": "Storage",
    "VolumeInfo": [
        {
            "AccessCapabilities": [
                "Read",
                "Write"
            ],
            "Volume": {
                "@odata.id": "/redfish/v1/Storage/NVMeoF/Volumes/1"
            }
        },
        {
            "AccessCapabilities": [
                "Read",
                "Write"
            ],
            "Volume": {
                "@odata.id": "/redfish/v1/Storage/NVMeoF/Volumes/3"
            }
        }
    ],
    "Links": {
        "InitiatorEndpoints": [
            {
                "@odata.id": "/redfish/v1/Fabrics/NVMeoF/Endpoints/Initiator1"
            }
        ]
    },
    "@odata.id": "/redfish/v1/Fabrics/NVMeoF/Connections/1"
}

6.21 ConnectionMethod 1.0.0

Version v1.0
Release 2020.2

6.21.1 Description

The ConnectionMethod schema describes the protocol, provider, or other method used to communicate to a given access point for a Redfish aggregation service.

6.21.2 URIs

/redfish/v1/AggregationService/ConnectionMethods/{ConnectionMethodId}

6.21.3 Properties

Property Type Attributes Notes
ConnectionMethodType string
(enum)
read-only
(null)
The type of connection method. For the possible property values, see ConnectionMethodType in Property details.
ConnectionMethodVariant string read-only
(null)
The variant of connection method.
Links { object The links to other resources that are related to this resource.
      AggregationSources [ { array An array of links to the access points using this connection method.
            @odata.id string read-only Link to a AggregationSource resource. See the Links section and the AggregationSource schema for details.
      } ]
      Oem {} object See the Oem object definition in the Common properties section.
}

6.21.4 Property details

6.21.4.1 ConnectionMethodType:

The type of connection method.

string Description
IPMI15 IPMI 1.5 connection method.
IPMI20 IPMI 2.0 connection method.
NETCONF NETCONF connection method.
OEM OEM connection method.
Redfish Redfish connection method.
SNMP SNMP connection method.

6.21.5 Example response

{
    "@odata.type": "#ConnectionMethod.v1_0_0.ConnectionMethod",
    "Id": "ConnectionMethod1",
    "Name": "ConnectionMethod One",
    "ConnectionMethodType": "Redfish",
    "ConnectionMethodVariant": "Contoso",
    "Links": {
        "AggregationSources": [
            {
                "@odata.id": "/redfish/v1/AggregationService/AggregationSources/AggregationSource1"
            }
        ]
    },
    "Actions": {},
    "@odata.id": "/redfish/v1/AggregationService/ConnectionMethods/ConnectionMethod1"
}

6.22 Drive 1.12.1

Version v1.12 v1.11 v1.10 v1.9 v1.8 v1.7 v1.6 v1.5 v1.4 v1.3 v1.2 ...
Release 2020.4 2020.3 2020.2 2019.4 2019.3 2019.2 2019.1 2018.2 2018.1 2017.3 2017.1 ...

6.22.1 Description

The Drive schema represents a single physical drive for a system, including links to associated volumes.

6.22.2 URIs

/redfish/v1/Chassis/{ChassisId}/Drives/{DriveId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Drives/{DriveId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Drives/{DriveId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Drives/{DriveId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Drives/{DriveId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Drives/{DriveId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Drives/{DriveId}
/redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/Drives/{DriveId}

6.22.3 Properties

Property Type Attributes Notes
Assembly (v1.3+) { object The link to the assembly associated with this drive. 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 drive.
BlockSizeBytes integer
(bytes)
read-only
(null)
The size, in bytes, of the smallest addressable unit, or block.
CapableSpeedGbs number
(Gbit/s)
read-only
(null)
The speed, in gigabit per second (Gbit/s), at which this drive can communicate to a storage controller in ideal conditions.
CapacityBytes integer
(bytes)
read-only
(null)
The size, in bytes, of this drive.
Certificates (v1.12+) { 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.
}
EncryptionAbility string
(enum)
read-only
(null)
The encryption ability of this drive. For the possible property values, see EncryptionAbility in Property details.
EncryptionStatus string
(enum)
read-only
(null)
The status of the encryption of this drive. For the possible property values, see EncryptionStatus in Property details.
EnvironmentMetrics (v1.12+) { object The link to the environment metrics for this drive. 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.
}
FailurePredicted boolean read-only
(null)
An indication of whether this drive currently predicts a failure in the near future.
HotspareReplacementMode (v1.5+) string
(enum)
read-write
(null)
The replacement mode for the hot spare drive. For the possible property values, see HotspareReplacementMode in Property details.
HotspareType string
(enum)
read-only
(null)
The type of hot spare that this drive currently serves as. For the possible property values, see HotspareType in Property details.
Identifiers [ { } ] array (object) The durable names for the drive. For property details, see Identifier.
IndicatorLED (deprecated v1.11) string
(enum)
read-write
(null)
The state of the indicator LED, that identifies the drive. For the possible property values, see IndicatorLED in Property details. Deprecated in v1.11 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.
      Chassis (v1.2+) { object The link to the chassis that contains this drive. See the Chassis schema for details on this property.
            @odata.id string read-only Link to a Chassis resource. See the Links section and the Chassis schema for details.
      }
      Endpoints (v1.1+) [ { array An array of links to the endpoints that connect to this drive.
            @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 (v1.6+) [ { array An array of links to the PCIe functions that the drive produces.
            @odata.id string read-only Link to a PCIeFunction resource. See the Links section and the PCIeFunction schema for details.
      } ]
      StoragePools (v1.8+) [ { array An array of links to the storage pools to which this drive belongs.
            @odata.id string
(URI)
read-only The unique identifier for a resource.
      } ]
      Volumes [ { array An array of links to the volumes that this drive either wholly or only partially contains.
            @odata.id string
(URI)
read-only The unique identifier for a resource.
      } ]
}
Location (deprecated v1.4) [ { } ] array (object) The location of the drive. For property details, see Location. Deprecated in v1.4 and later. This property has been deprecated in favor of the singular property PhysicalLocation found in Drive.v1_4_0.
LocationIndicatorActive (v1.11+) boolean read-write
(null)
An indicator allowing an operator to physically locate this resource.
Manufacturer string read-only
(null)
The manufacturer of this drive.
Measurements (v1.12+) [ { array An array of DSP0274-defined measurement blocks.
      @odata.id string read-only Link to a MeasurementBlock resource. See the Links section and the SoftwareInventory schema for details.
} ]
MediaType string
(enum)
read-only
(null)
The type of media contained in this drive. For the possible property values, see MediaType in Property details.
Model string read-only
(null)
The model number for the drive.
Multipath (v1.9+) boolean read-only
(null)
An indication of whether the drive is accessible from multiple paths.
NegotiatedSpeedGbs number
(Gbit/s)
read-only
(null)
The speed, in gigabit per second (Gbit/s), at which this drive currently communicates to the storage controller.
Operations (v1.1+) [ { array The operations currently running on the Drive.
      AssociatedTask (v1.1+) { object The link to the task associated with the operation, if any. See the Task schema for details on this property.
            @odata.id string read-only Link to a Task resource. See the Links section and the Task schema for details.
      }
      OperationName (v1.1+) string read-only
(null)
The name of the operation.
      PercentageComplete (v1.1+) integer
(%)
read-only
(null)
The percentage of the operation that has been completed.
} ]
PartNumber string read-only
(null)
The part number for this drive.
PhysicalLocation (v1.4+) {} object The location of the drive. For property details, see Location.
PredictedMediaLifeLeftPercent number
(%)
read-only
(null)
The percentage of reads and writes that are predicted to be available for the media.
Protocol string
(enum)
read-only
(null)
The protocol that this drive currently uses to communicate to the storage controller. For the possible property values, see Protocol in Property details.
ReadyToRemove (v1.10+) boolean read-write
(null)
An indication of whether the drive is prepared by the system for removal.
Revision string read-only
(null)
The revision of this drive. This is typically the firmware or hardware version of the drive.
RotationSpeedRPM number
(RPM)
read-only
(null)
The rotation speed of this drive, in revolutions per minute (RPM).
SerialNumber string read-only
(null)
The serial number for this drive.
SKU string read-only
(null)
The SKU for this drive.
Status {} object The status and health of the resource and its subordinate or dependent resources. For property details, see Status.
StatusIndicator string
(enum)
read-write
(null)
The state of the status indicator, which communicates status information about this drive. For the possible property values, see StatusIndicator in Property details.
WriteCacheEnabled (v1.7+) boolean read-write
(null)
An indication of whether the drive write cache is enabled.

6.22.4 Actions

6.22.4.1 Reset (v1.7+)

Description

This action resets this drive.

Action URI: {Base URI of target resource}/Actions/Drive.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.22.4.2 SecureErase

Description

This action securely erases the contents of the drive.

Action URI: {Base URI of target resource}/Actions/Drive.SecureErase

Action parameters

This action takes no parameters.

6.22.5 Property details

6.22.5.1 EncryptionAbility:

The encryption ability of this drive.

string Description
None The drive is not capable of self-encryption.
Other The drive is capable of self-encryption through some other means.
SelfEncryptingDrive The drive is capable of self-encryption per the Trusted Computing Group's Self Encrypting Drive Standard.

6.22.5.2 EncryptionStatus:

The status of the encryption of this drive.

string Description
Foreign The drive is currently encrypted, the data is not accessible to the user, and the system requires user intervention to expose the data.
Locked The drive is currently encrypted and the data is not accessible to the user. However, the system can unlock the drive automatically.
Unecrypted (deprecated v1.1) The drive is not currently encrypted. Deprecated in v1.1 and later. This value has been deprecated in favor of Unencrypted.
Unencrypted (v1.1+) The drive is not currently encrypted.
Unlocked The drive is currently encrypted but the data is accessible to the user in unencrypted form.

6.22.5.3 HotspareReplacementMode:

The replacement mode for the hot spare drive.

string Description
NonRevertible The hot spare drive that is commissioned due to a drive failure remains as a data drive and does not revert to a hot spare if the failed drive is replaced.
Revertible The hot spare drive that is commissioned due to a drive failure reverts to a hot spare after the failed drive is replaced and rebuilt.

6.22.5.4 HotspareType:

The type of hot spare that this drive currently serves as.

string Description
Chassis The drive is currently serving as a hot spare for all other drives in the chassis.
Dedicated The drive is currently serving as a hot spare for a user-defined set of drives.
Global The drive is currently serving as a hot spare for all other drives in the storage system.
None The drive is not currently a hot spare.

6.22.5.5 IndicatorLED:

The state of the indicator LED, that identifies the drive.

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

6.22.5.6 MediaType:

The type of media contained in this drive.

string Description
HDD The drive media type is traditional magnetic platters.
SMR The drive media type is shingled magnetic recording.
SSD The drive media type is solid state or flash memory.

6.22.5.7 Protocol:

The protocol that this drive currently uses to communicate to the storage controller.

string Description
AHCI Advanced Host Controller Interface (AHCI).
DisplayPort DisplayPort.
DVI DVI.
Ethernet Ethernet.
FC Fibre Channel.
FCoE Fibre Channel over Ethernet (FCoE).
FCP Fibre Channel Protocol for SCSI.
FICON FIbre CONnection (FICON).
FTP File Transfer Protocol (FTP).
GenZ GenZ.
HDMI HDMI.
HTTP Hypertext Transport Protocol (HTTP).
HTTPS Hypertext Transfer Protocol Secure (HTTPS).
I2C Inter-Integrated Circuit Bus.
InfiniBand InfiniBand.
iSCSI Internet SCSI.
iWARP Internet Wide Area RDMA Protocol (iWARP).
MultiProtocol Multiple Protocols.
NFSv3 Network File System (NFS) version 3.
NFSv4 Network File System (NFS) version 4.
NVLink NVLink.
NVMe Non-Volatile Memory Express (NVMe).
NVMeOverFabrics NVMe over Fabrics.
OEM OEM-specific.
PCIe PCI Express.
RoCE RDMA over Converged Ethernet Protocol.
RoCEv2 RDMA over Converged Ethernet Protocol Version 2.
SAS Serial Attached SCSI.
SATA Serial AT Attachment.
SFTP SSH File Transfer Protocol (SFTP).
SMB Server Message Block (SMB). Also known as the Common Internet File System (CIFS).
TCP Transmission Control Protocol (TCP).
TFTP Trivial File Transfer Protocol (TFTP).
UDP User Datagram Protocol (UDP).
UHCI Universal Host Controller Interface (UHCI).
USB Universal Serial Bus (USB).
VGA VGA.

6.22.5.8 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.
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.

6.22.5.9 StatusIndicator:

The state of the status indicator, which communicates status information about this drive.

string Description
Fail The drive has failed.
Hotspare The drive has been marked to automatically rebuild and replace a failed drive.
InACriticalArray The array to which this drive belongs has been degraded.
InAFailedArray The array to which this drive belongs has failed.
OK The drive is OK.
PredictiveFailureAnalysis The drive still works but is predicted to fail soon.
Rebuild The drive is being rebuilt.

6.22.6 Example response

{
    "@odata.type": "#Drive.v1_12_1.Drive",
    "Id": "3D58ECBC375FD9F2",
    "Name": "Drive Sample",
    "IndicatorLED": "Lit",
    "Model": "C123",
    "Revision": "100A",
    "Status": {
        "State": "Enabled",
        "Health": "OK"
    },
    "CapacityBytes": 899527000000,
    "FailurePredicted": false,
    "Protocol": "SAS",
    "MediaType": "HDD",
    "Manufacturer": "Contoso",
    "SerialNumber": "1234568",
    "PartNumber": "C123-1111",
    "Identifiers": [
        {
            "DurableNameFormat": "NAA",
            "DurableName": "32ADF365C6C1B7BD"
        }
    ],
    "HotspareType": "None",
    "EncryptionAbility": "SelfEncryptingDrive",
    "EncryptionStatus": "Unlocked",
    "RotationSpeedRPM": 15000,
    "BlockSizeBytes": 512,
    "CapableSpeedGbs": 12,
    "NegotiatedSpeedGbs": 12,
    "Links": {
        "Volumes": [
            {
                "@odata.id": "/redfish/v1/Systems/437XR1138R2/Storage/1/Volumes/2"
            },
            {
                "@odata.id": "/redfish/v1/Systems/437XR1138R2/Storage/1/Volumes/3"
            }
        ]
    },
    "Actions": {
        "#Drive.SecureErase": {
            "target": "/redfish/v1/Systems/437XR1138R2/Storage/1/Drives/3D58ECBC375FD9F2/Actions/Drive.SecureErase"
        }
    },
    "@odata.id": "/redfish/v1/Systems/437XR1138R2/Storage/1/Drives/3D58ECBC375FD9F2"
}

6.23 Endpoint 1.6.0

Version v1.6 v1.5 v1.4 v1.3 v1.2 v1.1 v1.0
Release 2021.1 2020.3 2019.4 2018.3 2018.2 2017.3 2016.2

6.23.1 Description

The Endpoint schema contains the properties of an endpoint resource that represents the properties of an entity that sends or receives protocol-defined messages over a transport.

6.23.2 URIs

/redfish/v1/Fabrics/{FabricId}/Endpoints/{EndpointId}
/redfish/v1/Storage/{StorageId}/Endpoints/{EndpointId}
/redfish/v1/StorageServices/{StorageServiceId}/Endpoints/{EndpointId}

6.23.3 Properties

Property Type Attributes Notes
ConnectedEntities [ { array All the entities connected to this endpoint.
      EntityLink { object The link to the associated entity.
            @odata.id string
(URI)
read-only The unique identifier for a resource.
      }
      EntityPciId { object The PCI ID of the connected entity.
            ClassCode (v1.2+) string read-only
(null)
The Class Code, Subclass, and Programming Interface code of this PCIe function.
            DeviceId string read-only
(null)
The Device ID of this PCIe function.
            FunctionNumber (v1.2+) integer read-only
(null)
The PCI ID of the connected entity.
            SubsystemId string read-only
(null)
The Subsystem ID of this PCIe function.
            SubsystemVendorId string read-only
(null)
The Subsystem Vendor ID of this PCIe function.
            VendorId string read-only
(null)
The Vendor ID of this PCIe function.
      }
      EntityRole string
(enum)
read-only
(null)
The role of the connected entity. For the possible property values, see EntityRole in Property details.
      EntityType string
(enum)
read-only
(null)
The type of the connected entity. For the possible property values, see EntityType in Property details.
      GenZ (v1.4+) { object
(null)
The Gen-Z related properties for the entity.
            AccessKey (v1.4+, deprecated v1.6 string read-write
(null)
The Access Key for the entity. Deprecated in v1.6 and later. This property has been deprecated in favor of the ConnectionKeys property in the Connection resource.
            GCID (v1.4+) { object
(null)
The Global Component ID (GCID) for the entity.
                  CID (v1.4+) string read-write
(null)
The component identifier portion of the GCID for the entity.
                  SID (v1.4+) string read-write
(null)
The subnet identifier portion of the GCID for the entity.
            }
            RegionKey (v1.4+, deprecated v1.6 string read-write
(null)
The Region Key for the entity. Deprecated in v1.6 and later. This property has been deprecated in favor of the ConnectionKeys property in the Connection resource.
      }
      Identifiers [ { } ] array (object) Identifiers for the remote entity. For property details, see Identifier.
      Oem {} object See the Oem object definition in the Common properties section.
      PciClassCode (deprecated v1.2) string read-only
(null)
The Class Code, Subclass, and Programming Interface code of this PCIe function. Deprecated in v1.2 and later. This property has been deprecated in favor of the ClassCode property inside the EntityPciId object.
      PciFunctionNumber (deprecated v1.2) integer read-only
(null)
The PCI ID of the connected entity. Deprecated in v1.2 and later. This property has been deprecated in favor of the FunctionNumber property inside the EntityPciId object.
} ]
EndpointProtocol string
(enum)
read-only
(null)
The protocol supported by this endpoint. For the possible property values, see EndpointProtocol in Property details.
HostReservationMemoryBytes integer
(bytes)
read-only
(null)
The amount of memory in bytes that the host should allocate to connect to this endpoint.
Identifiers [ { } ] array (object) Identifiers for this endpoint. For property details, see Identifier.
IPTransportDetails (v1.1+) [ { array An array of details for each IP transport supported by this endpoint. The array structure can model multiple IP addresses for this endpoint.
      IPv4Address (v1.1+) {} object The IPv4 addresses assigned to the endpoint. For property details, see IPv4Address.
      IPv6Address (v1.1+) {} object The IPv6 addresses assigned to the endpoint. For property details, see IPv6Address.
      Port (v1.1+) number read-only The UDP or TCP port number used by the endpoint.
      TransportProtocol (v1.1+) string
(enum)
read-only The protocol used by the connection entity. For the possible property values, see TransportProtocol in Property details.
} ]
Links { object The links to other resources that are related to this resource.
      AddressPools (v1.4+) [ { array An array of links to the address pools associated with this endpoint.
            @odata.id string read-write Link to a AddressPool resource. See the Links section and the AddressPool schema for details.
      } ]
      ConnectedPorts (v1.4+) [ { array An array of links to the ports that connect to this endpoint.
            @odata.id string read-only Link to a Port resource. See the Links section and the Port schema for details.
      } ]
      Connections (v1.5+) [ { array The connections to which this endpoint belongs.
            @odata.id string read-only Link to a Connection resource. See the Links section and the Connection schema for details.
      } ]
      MutuallyExclusiveEndpoints [ { array An array of links to the endpoints that cannot be used in zones if this endpoint is in a zone.
            @odata.id string read-only Link to another Endpoint resource.
      } ]
      NetworkDeviceFunction (v1.1+) [ { array When NetworkDeviceFunction resources are present, this array contains links to the network device functions that connect to this endpoint.
            @odata.id string read-only Link to a NetworkDeviceFunction resource. See the Links section and the NetworkDeviceFunction schema for details.
      } ]
      Oem {} object See the Oem object definition in the Common properties section.
      Ports [ { array An array of links to the physical ports associated with this endpoint.
            @odata.id string read-only Link to a Port resource. See the Links section and the Port schema for details.
      } ]
      Zones (v1.6+) [ { array The zones to which this endpoint belongs.
            @odata.id string read-only Link to a Zone resource. See the Links section and the Zone schema for details.
      } ]
}
PciId { object The PCI ID of the endpoint.
      ClassCode (v1.2+) string read-only
(null)
The Class Code, Subclass, and Programming Interface code of this PCIe function.
      DeviceId string read-only
(null)
The Device ID of this PCIe function.
      FunctionNumber (v1.2+) integer read-only
(null)
The PCI ID of the connected entity.
      SubsystemId string read-only
(null)
The Subsystem ID of this PCIe function.
      SubsystemVendorId string read-only
(null)
The Subsystem Vendor ID of this PCIe function.
      VendorId string read-only
(null)
The Vendor ID of this PCIe function.
}
Redundancy [ { } ] array (object) Redundancy information for the lower-level endpoints supporting this endpoint. For property details, see Redundancy.
Status {} object The status and health of the resource and its subordinate or dependent resources. For property details, see Status.

6.23.4 Property details

6.23.4.1 EndpointProtocol:

The protocol supported by this endpoint.

string Description
AHCI Advanced Host Controller Interface (AHCI).
DisplayPort DisplayPort.
DVI DVI.
Ethernet Ethernet.
FC Fibre Channel.
FCoE Fibre Channel over Ethernet (FCoE).
FCP Fibre Channel Protocol for SCSI.
FICON FIbre CONnection (FICON).
FTP File Transfer Protocol (FTP).
GenZ GenZ.
HDMI HDMI.
HTTP Hypertext Transport Protocol (HTTP).
HTTPS Hypertext Transfer Protocol Secure (HTTPS).
I2C Inter-Integrated Circuit Bus.
InfiniBand InfiniBand.
iSCSI Internet SCSI.
iWARP Internet Wide Area RDMA Protocol (iWARP).
MultiProtocol Multiple Protocols.
NFSv3 Network File System (NFS) version 3.
NFSv4 Network File System (NFS) version 4.
NVLink NVLink.
NVMe Non-Volatile Memory Express (NVMe).
NVMeOverFabrics NVMe over Fabrics.
OEM OEM-specific.
PCIe PCI Express.
RoCE RDMA over Converged Ethernet Protocol.
RoCEv2 RDMA over Converged Ethernet Protocol Version 2.
SAS Serial Attached SCSI.
SATA Serial AT Attachment.
SFTP SSH File Transfer Protocol (SFTP).
SMB Server Message Block (SMB). Also known as the Common Internet File System (CIFS).
TCP Transmission Control Protocol (TCP).
TFTP Trivial File Transfer Protocol (TFTP).
UDP User Datagram Protocol (UDP).
UHCI Universal Host Controller Interface (UHCI).
USB Universal Serial Bus (USB).
VGA VGA.

6.23.4.2 EntityRole:

The role of the connected entity.

string Description
Both The entity can both send and receive commands, messages, and other requests to or from other entities on the fabric.
Initiator The entity sends commands, messages, or other types of requests to other entities on the fabric, but cannot receive commands from other entities.
Target The entity receives commands, messages, or other types of requests from other entities on the fabric, but cannot send commands to other entities.

6.23.4.3 EntityType:

The type of the connected entity.

string Description
AccelerationFunction (v1.3+) The entity is an acceleration function realized through a device, such as an FPGA.
Bridge The entity is a PCI(e) bridge.
DisplayController The entity is a display controller.
Drive The entity is a drive.
FabricBridge (v1.4+) The entity is a fabric bridge.
Manager (v1.5+) The entity is a manager.
MediaController (v1.4+) The entity is a media controller.
MemoryChunk (v1.4+) The entity is a memory chunk.
NetworkController The entity is a network controller.
Processor The entity is a processor.
RootComplex The entity is a PCI(e) root complex.
StorageExpander The entity is a storage expander.
StorageInitiator The entity is a storage initiator.
StorageSubsystem (v1.6+) The entity is a storage subsystem.
Switch (v1.4+) The entity is a switch, not an expander. Use Expander for expanders.
Volume (v1.1+) The entity is a volume.

6.23.4.4 TransportProtocol:

The protocol used by the connection entity.

string Description
AHCI Advanced Host Controller Interface (AHCI).
DisplayPort DisplayPort.
DVI DVI.
Ethernet Ethernet.
FC Fibre Channel.
FCoE Fibre Channel over Ethernet (FCoE).
FCP Fibre Channel Protocol for SCSI.
FICON FIbre CONnection (FICON).
FTP File Transfer Protocol (FTP).
GenZ GenZ.
HDMI HDMI.
HTTP Hypertext Transport Protocol (HTTP).
HTTPS Hypertext Transfer Protocol Secure (HTTPS).
I2C Inter-Integrated Circuit Bus.
InfiniBand InfiniBand.
iSCSI Internet SCSI.
iWARP Internet Wide Area RDMA Protocol (iWARP).
MultiProtocol Multiple Protocols.
NFSv3 Network File System (NFS) version 3.
NFSv4 Network File System (NFS) version 4.
NVLink NVLink.
NVMe Non-Volatile Memory Express (NVMe).
NVMeOverFabrics NVMe over Fabrics.
OEM OEM-specific.
PCIe PCI Express.
RoCE RDMA over Converged Ethernet Protocol.
RoCEv2 RDMA over Converged Ethernet Protocol Version 2.
SAS Serial Attached SCSI.
SATA Serial AT Attachment.
SFTP SSH File Transfer Protocol (SFTP).
SMB Server Message Block (SMB). Also known as the Common Internet File System (CIFS).
TCP Transmission Control Protocol (TCP).
TFTP Trivial File Transfer Protocol (TFTP).
UDP User Datagram Protocol (UDP).
UHCI Universal Host Controller Interface (UHCI).
USB Universal Serial Bus (USB).
VGA VGA.

6.23.5 Example response

{
    "@odata.type": "#Endpoint.v1_6_0.Endpoint",
    "Id": "Drive1",
    "Name": "SAS Drive",
    "Description": "The SAS Drive in Enclosure 2 Bay 0",
    "EndpointProtocol": "SAS",
    "ConnectedEntities": [
        {
            "EntityType": "Drive",
            "EntityRole": "Target",
            "Identifiers": [
                {
                    "DurableNameFormat": "NAA",
                    "DurableName": "32ADF365C6C1B7C3"
                }
            ],
            "Oem": {}
        }
    ],
    "Links": {
        "MutuallyExclusiveEndpoints": [
            {
                "@odata.id": "/redfish/v1/Fabrics/SAS/Endpoints/Enclosure2"
            }
        ],
        "Ports": [
            {
                "@odata.id": "/redfish/v1/Fabrics/SAS/Switches/Switch1/Ports/8"
            },
            {
                "@odata.id": "/redfish/v1/Fabrics/SAS/Switches/Switch2/Ports/8"
            }
        ],
        "Oem": {}
    },
    "Oem": {},
    "@odata.id": "/redfish/v1/Fabrics/SAS/Endpoints/Drive1"
}

6.24 EndpointGroup 1.3.2

Version v1.3 v1.2 v1.1 v1.0
Release 2020.3 WIP v1.1.0 WIP v1.0.5 TP v1.0.3

6.24.1 Description

The EndpointGroup schema describes group of endpoints that are managed as a unit.

6.24.2 URIs

/redfish/v1/Fabrics/{FabricId}/EndpointGroups/{EndpointGroupId}
/redfish/v1/Storage/{StorageId}/EndpointGroups/{EndpointGroupId}
/redfish/v1/StorageServices/{StorageServiceId}/EndpointGroups/{EndpointGroupId}
/redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/EndpointGroups/{EndpointGroupId}

6.24.3 Properties

Property Type Attributes Notes
AccessState (deprecated v1.3) string
(enum)
read-write
(null)
The access state for this group. For the possible property values, see AccessState in Property details. Deprecated in v1.3 and later. This property has been deprecated in favor of the AccessState property in the connection resource.
Endpoints (deprecated v1.3) [ { array The endpoints in this endpoint group. Deprecated in v1.3 and later. This property has been deprecated in favor of the Endpoints property within Links.
      @odata.id string read-write Link to a Endpoint resource. See the Links section and the Endpoint schema for details.
} ]
GroupType string
(enum)
read-write
(null)
The endpoint group type. For the possible property values, see GroupType in Property details.
Identifier {} object The durable name for the endpoint group. For property details, see Identifier.
Links { object The links to other resources that are related to this resource.
      Connections (v1.3+) [ { array The connections to which this endpoint group belongs.
            @odata.id string read-only Link to a Connection resource. See the Links section and the Connection schema for details.
      } ]
      Endpoints (v1.3+) [ { array The endpoints in this endpoint group.
            @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.
}
Preferred (deprecated v1.2) boolean read-write
(null)
An indication if access to the resources through the endpoint group is preferred. Deprecated in v1.2 and later. This property has been deprecated in favor of the AccessState property in the connection resource.
TargetEndpointGroupIdentifier integer read-write
(null)
The SCSI-defined identifier for this group.

6.24.4 Property details

6.24.4.1 AccessState:

The access state for this group.

string Description
NonOptimized The endpoints are in an active and non-optimized state.
Optimized The endpoints are in an active and optimized state.
Standby The endpoints are in a standby state.
Transitioning The endpoints are transitioning to a new state.
Unavailable The endpoints are in an unavailable state.

6.24.4.2 GroupType:

The endpoint group type.

string Description
Client (deprecated v1.3) The group contains the client (initiator) endpoints. Deprecated in v1.3 and later. This value has been deprecated in favor of Initiator.
Initiator (v1.3+) The group contains the initiator endpoints.
Server (deprecated v1.3) The group contains the server (target) endpoints. Deprecated in v1.3 and later. This value has been deprecated in favor of Target.
Target (v1.3+) The group contains the target endpoints.

6.24.5 Example response

{
    "@odata.type": "#EndpointGroup.v1_3_2.EndpointGroup",
    "Id": "1",
    "Name": "Endpoint group for all initiators",
    "GroupType": "Initiator",
    "Links": {
        "Endpoints": [
            {
                "@odata.id": "/redfish/v1/Fabrics/NVMeoF/Endpoints/Initiator1"
            },
            {
                "@odata.id": "/redfish/v1/Fabrics/NVMeoF/Endpoints/Initiator2"
            }
        ],
        "Connections": [
            {
                "@odata.id": "/redfish/v1/Fabrics/NVMeoF/Connections/3"
            }
        ]
    },
    "@odata.id": "/redfish/v1/Fabrics/NVMeoF/EndpointGroups/1"
}

6.25 EnvironmentMetrics 1.0.0

Version v1.0
Release 2020.4

6.25.1 Description

The EnvironmentMetrics schema represents the environmental metrics of a device.

6.25.2 URIs

/redfish/v1/Chassis/{ChassisId}/Drives/{DriveId}/EnvironmentMetrics
/redfish/v1/Chassis/{ChassisId}/EnvironmentMetrics
/redfish/v1/Chassis/{ChassisId}/MediaControllers/{MediaControllerId}/EnvironmentMetrics
/redfish/v1/Chassis/{ChassisId}/MediaControllers/{MediaControllerId}/Ports/{PortId}/EnvironmentMetrics
/redfish/v1/Chassis/{ChassisId}/Memory/{MemoryId}/EnvironmentMetrics
/redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/EnvironmentMetrics
/redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/Ports/{PortId}/EnvironmentMetrics
/redfish/v1/Chassis/{ChassisId}/PCIeDevices/{PCIeDeviceId}/EnvironmentMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Drives/{DriveId}/EnvironmentMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Memory/{MemoryId}/EnvironmentMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/EnvironmentMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Controllers/{ControllerId}/EnvironmentMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Controllers/{StorageControllerId}/Ports/{PortId}/EnvironmentMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Drives/{DriveId}/EnvironmentMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Ports/{PortId}/EnvironmentMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Memory/{MemoryId}/EnvironmentMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/PCIeDevices/{PCIeDeviceId}/EnvironmentMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/EnvironmentMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Controllers/{ControllerId}/EnvironmentMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Controllers/{StorageControllerId}/Ports/{PortId}/EnvironmentMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Drives/{DriveId}/EnvironmentMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Ports/{PortId}/EnvironmentMetrics
/redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/EnvironmentMetrics
/redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortId}/EnvironmentMetrics
/redfish/v1/Facilities/{FacilityId}/AmbientMetrics
/redfish/v1/Facilities/{FacilityId}/EnvironmentMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Drives/{DriveId}/EnvironmentMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Memory/{MemoryId}/EnvironmentMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/EnvironmentMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Controllers/{ControllerId}/EnvironmentMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Controllers/{StorageControllerId}/Ports/{PortId}/EnvironmentMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Drives/{DriveId}/EnvironmentMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Ports/{PortId}/EnvironmentMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Memory/{MemoryId}/EnvironmentMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/PCIeDevices/{PCIeDeviceId}/EnvironmentMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/EnvironmentMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Controllers/{ControllerId}/EnvironmentMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Controllers/{StorageControllerId}/Ports/{PortId}/EnvironmentMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Drives/{DriveId}/EnvironmentMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Ports/{PortId}/EnvironmentMetrics
/redfish/v1/Storage/{StorageId}/Controllers/{ControllerId}/EnvironmentMetrics
/redfish/v1/Storage/{StorageId}/Controllers/{StorageControllerId}/Ports/{PortId}/EnvironmentMetrics
/redfish/v1/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Ports/{PortId}/EnvironmentMetrics
/redfish/v1/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/EnvironmentMetrics
/redfish/v1/Systems/{ComputerSystemId}/Memory/{MemoryId}/EnvironmentMetrics
/redfish/v1/Systems/{ComputerSystemId}/PCIeDevices/{PCIeDeviceId}/EnvironmentMetrics
/redfish/v1/Systems/{ComputerSystemId}/Processors/{ProcessorId}/EnvironmentMetrics
/redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/Controllers/{ControllerId}/EnvironmentMetrics
/redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/Controllers/{StorageControllerId}/Ports/{PortId}/EnvironmentMetrics
/redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/Drives/{DriveId}/EnvironmentMetrics
/redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Ports/{PortId}/EnvironmentMetrics

6.25.3 Properties

Property Type Attributes Notes
EnergykWh { object
(excerpt)
Energy consumption (kWh). 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.
      LifetimeReading (v1.1+) number read-only
(null)
The total accumulation value for this sensor.
      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.
}
FanSpeedsPercent [ { array
(excerpt)
Fan speeds (percent). 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.
      DeviceName (v1.2+) string read-only
(null)
The name of the device.
      PhysicalContext string
(enum)
read-only
(null)
The area or device to which this sensor measurement applies. For the possible property values, see PhysicalContext in Property details.
      PhysicalSubContext string
(enum)
read-only
(null)
The usage or location within a device to which this sensor measurement applies. For the possible property values, see PhysicalSubContext in Property details.
      Reading number read-only
(null)
The sensor value.
      SpeedRPM (v1.2+) number
(RPM)
read-only
(null)
The rotational speed.
} ]
HumidityPercent { object
(excerpt)
Humidity (percent). 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.
}
PowerWatts { object
(excerpt)
Power consumption (Watts). 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.
      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 ApparentVA and squared Power (Reading) for a circuit, in var units.
      Reading number read-only
(null)
The sensor value.
}
TemperatureCelsius { object
(excerpt)
Temperature (Celsius). 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.25.4 Actions

6.25.4.1 ResetMetrics

Description

This action resets the summary metrics related to this equipment.

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

Action parameters

This action takes no parameters.

6.25.5 Property details

6.25.5.1 PhysicalContext:

The area or device to which this sensor measurement 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.
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.
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.25.5.2 PhysicalSubContext:

The usage or location within a device to which this sensor measurement applies.

string Description
Input The input.
Output The output.

6.25.6 Example response

{
    "@odata.type": "#EnvironmentMetrics.v1_0_0.EnvironmentMetrics",
    "Name": "Processor Environment Metrics",
    "TemperatureCelsius": {
        "DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/CPU1Temp",
        "Reading": 44
    },
    "PowerWatts": {
        "DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/CPU1Power",
        "Reading": 12.87
    },
    "FanSpeedsPercent": [
        {
            "DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/CPUFan1",
            "DeviceName": "CPU #1 Fan Speed",
            "Reading": 80
        }
    ],
    "Oem": {},
    "@odata.id": "/redfish/v1/Systems/437XR1138R2/Processors/1/EnvironmentMetrics"
}

6.26 EthernetInterface 1.6.4

Version v1.6 v1.5 v1.4 v1.3 v1.2 v1.1 v1.0
Release 2020.1 2019.1 2017.3 2017.1 2016.3 2016.2 1.0

6.26.1 Description

The EthernetInterface schema represents a single, logical Ethernet interface or network interface controller (NIC).

6.26.2 URIs

/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/EthernetInterfaces/{EthernetInterfaceId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/EthernetInterfaces/{EthernetInterfaceId}
/redfish/v1/Managers/{ManagerId}/EthernetInterfaces/{EthernetInterfaceId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/EthernetInterfaces/{EthernetInterfaceId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/EthernetInterfaces/{EthernetInterfaceId}
/redfish/v1/Systems/{ComputerSystemId}/EthernetInterfaces/{EthernetInterfaceId}

6.26.3 Properties

Property Type Attributes Notes
AutoNeg boolean read-write
(null)
An indication of whether the speed and duplex are automatically negotiated and configured on this interface.
DHCPv4 (v1.4+) { object DHCPv4 configuration for this interface.
      DHCPEnabled (v1.4+) boolean read-write
(null)
An indication of whether DHCP v4 is enabled on this Ethernet interface.
      FallbackAddress (v1.5+) string
(enum)
read-write
(null)
DHCPv4 fallback address method for this interface. For the possible property values, see FallbackAddress in Property details.
      UseDNSServers (v1.4+) boolean read-write
(null)
An indication of whether this interface uses DHCP v4-supplied DNS servers.
      UseDomainName (v1.4+) boolean read-write
(null)
An indication of whether this interface uses a DHCP v4-supplied domain name.
      UseGateway (v1.4+) boolean read-write
(null)
An indication of whether this interface uses a DHCP v4-supplied gateway.
      UseNTPServers (v1.4+) boolean read-write
(null)
An indication of whether the interface uses DHCP v4-supplied NTP servers.
      UseStaticRoutes (v1.4+) boolean read-write
(null)
An indication of whether the interface uses DHCP v4-supplied static routes.
}
DHCPv6 (v1.4+) { object DHCPv6 configuration for this interface.
      OperatingMode (v1.4+) string
(enum)
read-write
(null)
Determines the DHCPv6 operating mode for this interface. For the possible property values, see OperatingMode in Property details.
      UseDNSServers (v1.4+) boolean read-write
(null)
An indication of whether the interface uses DHCP v6-supplied DNS servers.
      UseDomainName (v1.4+) boolean read-write
(null)
An indication of whether the interface uses a domain name supplied through DHCP v6 stateless mode.
      UseNTPServers (v1.4+) boolean read-write
(null)
An indication of whether the interface uses DHCP v6-supplied NTP servers.
      UseRapidCommit (v1.4+) boolean read-write
(null)
An indication of whether the interface uses DHCP v6 rapid commit mode for stateful mode address assignments. Do not enable this option in networks where more than one DHCP v6 server is configured to provide address assignments.
}
EthernetInterfaceType (v1.6+) string
(enum)
read-only
(null)
The type of interface. For the possible property values, see EthernetInterfaceType in Property details.
FQDN string read-write
(null)
The complete, fully qualified domain name that DNS obtains for this interface.
FullDuplex boolean read-write
(null)
An indication of whether full-duplex mode is enabled on the Ethernet connection for this interface.
HostName string read-write
(null)
The DNS host name, without any domain information.
InterfaceEnabled boolean read-write
(null)
An indication of whether this interface is enabled.
IPv4Addresses [ { } ] array (object) The IPv4 addresses currently in use by this interface. For property details, see IPv4Address.
IPv4StaticAddresses (v1.4+) [ { } ] array (object)
(null)
The IPv4 static addresses assigned to this interface. See IPv4Addresses for the addresses in use by this interface. For property details, see IPv4Address.
IPv6Addresses [ { } ] array (object) The IPv6 addresses currently in use by this interface. For property details, see IPv6Address.
IPv6AddressPolicyTable [ { array An array that represents the RFC6724-defined address selection policy table.
      Label integer read-write
(null)
The IPv6 label, as defined in RFC6724, section 2.1.
      Precedence integer read-write
(null)
The IPv6 precedence, as defined in RFC6724, section 2.1.
      Prefix string read-write
(null)
The IPv6 address prefix, as defined in RFC6724, section 2.1.
} ]
IPv6DefaultGateway string read-only
(null)
The IPv6 default gateway address in use on this interface.
IPv6StaticAddresses [ { } ] array (object)
(null)
The IPv6 static addresses assigned to this interface. See IPv6Addresses for the addresses in use by this interface. For property details, see IPv6StaticAddress.
IPv6StaticDefaultGateways (v1.4+) [ { } ] array (object)
(null)
The IPv6 static default gateways for this interface. For property details, see IPv6GatewayStaticAddress v1.1.3).
Links (v1.1+) { object The links to other resources that are related to this resource.
      Chassis (v1.3+) { object The link to the chassis that contains this Ethernet interface. See the Chassis schema for details on this property.
            @odata.id string read-only Link to a Chassis resource. See the Links section and the Chassis schema for details.
      }
      Endpoints (v1.1+) [ { array An array of links to the endpoints that connect to this Ethernet interface.
            @odata.id string read-only Link to a Endpoint resource. See the Links section and the Endpoint schema for details.
      } ]
      HostInterface (v1.2+) { object The link to a Host Interface that is associated with this Ethernet interface. See the HostInterface schema for details on this property.
            @odata.id string read-only Link to a HostInterface resource. See the Links section and the HostInterface schema for details.
      }
      NetworkDeviceFunction (v1.6+) { object
(null)
The link to the parent network device function and is only used when representing one of the VLANs on that network device function, such as is done in Unix. See the NetworkDeviceFunction schema for details on this property.
            @odata.id string read-only Link to a NetworkDeviceFunction resource. See the Links section and the NetworkDeviceFunction schema for details.
      }
      Oem {} object See the Oem object definition in the Common properties section.
}
LinkStatus (v1.1+) string
(enum)
read-only
(null)
The link status of this interface, or port. For the possible property values, see LinkStatus in Property details.
MACAddress string read-write
(null)
The currently configured MAC address of the interface, or logical port.
MaxIPv6StaticAddresses integer read-only
(null)
The maximum number of static IPv6 addresses that can be configured on this interface.
MTUSize integer read-write
(null)
The currently configured maximum transmission unit (MTU), in bytes, on this interface.
NameServers [ ] array (string) read-only The DNS servers in use on this interface.
PermanentMACAddress string read-only
(null)
The permanent MAC address assigned to this interface, or port.
SpeedMbps integer
(Mbit/s)
read-write
(null)
The current speed, in Mbit/s, of this interface.
StatelessAddressAutoConfig (v1.4+) { object Stateless address autoconfiguration (SLAAC) parameters for this interface.
      IPv4AutoConfigEnabled (v1.4+) boolean read-write
(null)
An indication of whether IPv4 stateless address autoconfiguration (SLAAC) is enabled for this interface.
      IPv6AutoConfigEnabled (v1.4+) boolean read-write
(null)
An indication of whether IPv6 stateless address autoconfiguration (SLAAC) is enabled for this interface.
}
StaticNameServers (v1.4+) [ ] array (string, null) read-write The statically-defined set of DNS server IPv4 and IPv6 addresses.
Status {} object The status and health of the resource and its subordinate or dependent resources. For property details, see Status.
UefiDevicePath string read-only
(null)
The UEFI device path for this interface.
VLAN { object If this network interface supports more than one VLAN, this property is absent. VLAN collections appear in the Links property of this resource.
      VLANEnable boolean read-write required on create
(null)
An indication of whether this VLAN is enabled for this VLAN network interface.
      VLANId integer read-write required on create
(null)
The ID for this VLAN.
      VLANPriority (v1.2+) integer read-write
(null)
The priority for this VLAN.
}
VLANs { object The link to a collection of VLANs, which applies only if the interface supports more than one VLAN. If this property applies, the VLANEnabled and VLANId properties do not apply. Contains a link to a resource.
      @odata.id string read-only Link to Collection of VLanNetworkInterface. See the VLanNetworkInterface schema for details.
}

6.26.4 Property details

6.26.4.1 EthernetInterfaceType:

The type of interface.

string Description
Physical A physical Ethernet interface.
Virtual A virtual Ethernet interface.

6.26.4.2 FallbackAddress:

DHCPv4 fallback address method for this interface.

string Description
AutoConfig Fall back to an autoconfigured address.
None Continue attempting DHCP without a fallback address.
Static Fall back to a static address specified by IPv4StaticAddresses.

6.26.4.3 LinkStatus:

The link status of this interface, or port.

string Description
LinkDown No link is detected on this interface, but the interface is connected.
LinkUp The link is available for communication on this interface.
NoLink No link or connection is detected on this interface.

6.26.4.4 OperatingMode:

Determines the DHCPv6 operating mode for this interface.

string Description
Disabled DHCPv6 is disabled.
Stateful DHCPv6 stateful mode.
Stateless DHCPv6 stateless mode.

6.26.5 Example response

{
    "@odata.type": "#EthernetInterface.v1_6_4.EthernetInterface",
    "Id": "1",
    "Name": "Ethernet Interface",
    "Description": "Manager NIC 1",
    "Status": {
        "State": "Enabled",
        "Health": "OK"
    },
    "LinkStatus": "LinkUp",
    "PermanentMACAddress": "12:44:6A:3B:04:11",
    "MACAddress": "12:44:6A:3B:04:11",
    "SpeedMbps": 1000,
    "AutoNeg": true,
    "FullDuplex": true,
    "MTUSize": 1500,
    "HostName": "web483",
    "FQDN": "web483.contoso.com",
    "NameServers": [
        "names.contoso.com"
    ],
    "IPv4Addresses": [
        {
            "Address": "192.168.0.10",
            "SubnetMask": "255.255.252.0",
            "AddressOrigin": "DHCP",
            "Gateway": "192.168.0.1"
        }
    ],
    "DHCPv4": {
        "DHCPEnabled": true,
        "UseDNSServers": true,
        "UseGateway": true,
        "UseNTPServers": false,
        "UseStaticRoutes": true,
        "UseDomainName": true
    },
    "DHCPv6": {
        "OperatingMode": "Stateful",
        "UseDNSServers": true,
        "UseDomainName": false,
        "UseNTPServers": false,
        "UseRapidCommit": false
    },
    "StatelessAddressAutoConfig": {
        "IPv4AutoConfigEnabled": false,
        "IPv6AutoConfigEnabled": true
    },
    "IPv4StaticAddresses": [
        {
            "Address": "192.168.88.130",
            "SubnetMask": "255.255.0.0",
            "Gateway": "192.168.0.1"
        }
    ],
    "IPv6AddressPolicyTable": [
        {
            "Prefix": "::1/128",
            "Precedence": 50,
            "Label": 0
        }
    ],
    "MaxIPv6StaticAddresses": 1,
    "IPv6StaticAddresses": [
        {
            "Address": "fc00:1234::a:b:c:d",
            "PrefixLength": 64
        }
    ],
    "IPv6StaticDefaultGateways": [
        {
            "Address": "fe80::fe15:b4ff:fe97:90cd",
            "PrefixLength": 64
        }
    ],
    "IPv6DefaultGateway": "fe80::214:c1ff:fe4c:5c4d",
    "IPv6Addresses": [
        {
            "Address": "fe80::1ec1:deff:fe6f:1e24",
            "PrefixLength": 64,
            "AddressOrigin": "SLAAC",
            "AddressState": "Preferred",
            "Oem": {}
        },
        {
            "Address": "fc00:1234::a:b:c:d",
            "PrefixLength": 64,
            "AddressOrigin": "Static",
            "AddressState": "Preferred",
            "Oem": {}
        },
        {
            "Address": "2001:1:3:5::100",
            "PrefixLength": 64,
            "AddressOrigin": "DHCPv6",
            "AddressState": "Preferred",
            "Oem": {}
        },
        {
            "Address": "2002:2:5::1ec1:deff:fe6f:1e24",
            "PrefixLength": 64,
            "AddressOrigin": "SLAAC",
            "AddressState": "Preferred",
            "Oem": {}
        }
    ],
    "StaticNameServers": [
        "192.168.150.1",
        "fc00:1234:200:2500"
    ],
    "VLAN": {
        "VLANEnable": true,
        "VLANId": 101
    },
    "@odata.id": "/redfish/v1/Systems/437XR1138R2/EthernetInterfaces/12446A3B0411"
}

6.27 Event 1.6.1

Version v1.6 v1.5 v1.4 v1.3 v1.2 v1.1 v1.0
Release 2020.3 2020.2 2019.1 2018.2 2017.1 2016.1 1.0

6.27.1 Description

The Event schema describes the JSON payload received by an event destination, which has subscribed to event notification, when events occur. This resource contains data about events, including descriptions, severity, and a message identifier to a message registry that can be accessed for further information.

6.27.2 Properties

Property Type Attributes Notes
Context (v1.1+) string read-only A context can be supplied at subscription time. This property is the context value supplied by the subscriber.
Events [ { array * required* Each event in this array has a set of properties that describe the event. Because this is an array, more than one event can be sent simultaneously.
      Actions (v1.2+) {} object The available actions for this resource.
      Context (deprecated v1.1) string read-only A context can be supplied at subscription time. This property is the context value supplied by the subscriber. Deprecated in v1.1 and later. Events are triggered independently from subscriptions to those events. This property has been deprecated in favor of the Context property found at the root level of the object.
      EventGroupId (v1.3+) integer read-only The identifier that correlates events with the same root cause. If 0, no other event is related to this event.
      EventId string read-only The unique instance identifier of an event.
      EventTimestamp string
(date-time)
read-only The time the event occurred.
      EventType (deprecated v1.3) string
(enum)
read-only required The type of event. For the possible property values, see EventType in Property details. Deprecated in v1.3 and later. This property has been deprecated. Starting with Redfish Specification v1.6 (Event v1.3), subscriptions are based on the RegistryPrefix and ResourceType properties and not on the EventType property.
      MemberId string read-only required The identifier for the member within the collection.
      Message string read-only The human-readable event 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.5+) string
(enum)
read-only The severity of the message in this event. For the possible property values, see MessageSeverity in Property details.
      Oem {} object See the Oem object definition in the Common properties section.
      OriginOfCondition { object A link to the resource or object that originated the condition that caused the event to be generated.
            @odata.id string
(URI)
read-only The unique identifier for a resource.
      }
      Severity (deprecated v1.5) string read-only The severity of the event. Deprecated in v1.5 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.
      SpecificEventExistsInGroup (v1.6+) boolean read-only Indicates this event is equivalent to a more specific event in this Event Group.
} ]

6.27.3 Property details

6.27.3.1 EventType:

The type of event.

string Description
Alert A condition requires attention.
MetricReport (v1.3+) The telemetry service is sending a metric report.
Other (v1.4+) Because EventType is deprecated as of Redfish Specification v1.6, the event is based on a registry or resource but not an EventType.
ResourceAdded A resource has been added.
ResourceRemoved A resource has been removed.
ResourceUpdated A resource has been updated.
StatusChange The status of a resource has changed.

6.27.3.2 MessageSeverity:

The severity of the message in this event.

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

6.28 EventDestination 1.10.1

Version v1.10 v1.9 v1.8 v1.7 v1.6 v1.5 v1.4 v1.3 v1.2 v1.1 v1.0
Release 2020.4 2020.3 2020.1 2019.3 2019.2 2019.1 2018.2 2018.1 2017.1 2016.2 1.0

6.28.1 Description

The EventDestination schema defines the target of an event subscription, including the event types and context to provide to the target in the Event payload.

6.28.2 URIs

/redfish/v1/EventService/Subscriptions/{EventDestinationId}

6.28.3 Properties

Property Type Attributes Notes
Certificates (v1.9+) { object The link to a collection of server certificates for the server referenced by the Destination property. Contains a link to a resource.
      @odata.id string read-only Link to Collection of Certificate. See the Certificate schema for details.
}
Context string read-write required
(null)
A client-supplied string that is stored with the event destination subscription.
DeliveryRetryPolicy (v1.6+) string
(enum)
read-write
(null)
The subscription delivery retry policy for events, where the subscription type is RedfishEvent. For the possible property values, see DeliveryRetryPolicy in Property details.
Destination string
(URI)
read-only required on create The URI of the destination event receiver.
EventFormatType (v1.4+) string
(enum)
read-only
(null)
The content types of the message that are sent to the EventDestination. For the possible property values, see EventFormatType in Property details.
EventTypes (deprecated v1.5) [ ] array (string
(enum))
read-only The types of events that are sent to the destination. For the possible property values, see EventTypes in Property details. Deprecated in v1.5 and later. This property has been deprecated. Starting with Redfish Specification v1.6 (Event v1.3), subscriptions are based on the RegistryPrefix and ResourceType properties and not on the EventType property. Use EventFormatType to create subscriptions for Metric Reports. If the subscription does not include this property, the service shall use a single element with a default of Other.
HttpHeaders [ { array An array of settings for HTTP headers, such as authorization information. This array is null or an empty array in responses. An empty array is the preferred return value on read operations.
      (pattern) string read-write Property names follow regular expression pattern "^[^:\\s]+$"
} ]
IncludeOriginOfCondition (v1.8+) boolean read-only
(null)
An indication of whether the events subscribed to will also include the entire resource or object referenced the OriginOfCondition property in the event payload.
MessageIds (v1.1+) [ ] array (string, null) read-only The list of MessageIds that the service sends. If this property is absent or the array is empty, events with any MessageId are sent to the subscriber.
MetricReportDefinitions (v1.6+) [ { array A list of metric report definitions for which the service only sends related metric reports. If this property is absent or the array is empty, metric reports that originate from any metric report definition are sent to the subscriber.
      @odata.id string read-only Link to a MetricReportDefinition resource. See the Links section and the MetricReportDefinition schema for details.
} ]
OEMProtocol (v1.9+) string read-only The OEM-defined protocol type of the event connection.
OEMSubscriptionType (v1.9+) string read-only The OEM-defined subscription type for events.
OriginResources (v1.1+) [ { array The array of Resources for which the service sends only related events. If this property is absent or the array is empty, the service sends the events that originate from any Resource to the subscriber.
      @odata.id string
(URI)
read-only The unique identifier for a resource.
} ]
Protocol string
(enum)
read-only required on create The protocol type of the event connection. For the possible property values, see Protocol in Property details.
RegistryPrefixes (v1.4+) [ ] array (string, null) read-only The list of the prefixes for the Message Registries that contain the MessageIds that are sent to this event destination.
ResourceTypes (v1.4+) [ ] array (string, null) read-only The list of Resource Type values (Schema names) that correspond to the OriginOfCondition. The version and full namespace should not be specified.
SNMP (v1.7+) { object Settings for an SNMP event destination.
      AuthenticationKey (v1.7+) string read-write
(null)
The secret authentication key for SNMPv3.
      AuthenticationKeySet (v1.10+) boolean read-only Indicates if the AuthenticationKey property is set.
      AuthenticationProtocol (v1.7+) string
(enum)
read-write
(null)
The authentication protocol for SNMPv3. For the possible property values, see AuthenticationProtocol in Property details.
      EncryptionKey (v1.7+) string read-write
(null)
The secret authentication key for SNMPv3.
      EncryptionKeySet (v1.10+) boolean read-only Indicates if the EncryptionKey property is set.
      EncryptionProtocol (v1.7+) string
(enum)
read-write
(null)
The encryption protocol for SNMPv3. For the possible property values, see EncryptionProtocol in Property details.
      TrapCommunity (v1.7+) string read-write
(null)
The SNMP trap community string.
}
Status (v1.6+) {} object This property shall contain the status of the subscription. For property details, see Status.
SubordinateResources (v1.4+) boolean read-only
(null)
An indication of whether the subscription is for events in the OriginResources array and its subordinate Resources. If true and the OriginResources array is specified, the subscription is for events in the OriginResources array and its subordinate Resources. Note that Resources associated through the Links section are not considered subordinate. If false and the OriginResources array is specified, the subscription shall be for events in the OriginResources array only. If the OriginResources array is not present, this property shall have no relevance.
SubscriptionType (v1.3+) string
(enum)
read-only required
(null)
The subscription type for events. For the possible property values, see SubscriptionType in Property details.
SyslogFilters (v1.9+) [ { array A list of syslog message filters to send to a remote syslog server.
      LogFacilities (v1.9+) [ ] array (string
(enum))
read-write
(null)
The types of programs that can log messages. For the possible property values, see LogFacilities in Property details.
      LowestSeverity (v1.9+) string
(enum)
read-write
(null)
The lowest severity level message that will be forwarded. For the possible property values, see LowestSeverity in Property details.
} ]
VerifyCertificate (v1.9+) boolean read-write
(null)
An indication of whether the service will verify the certificate of the server referenced by the Destination property prior to sending the event.

6.28.4 Actions

6.28.4.1 ResumeSubscription

Description

This action resumes a suspended event subscription.

Action URI: {Base URI of target resource}/Actions/EventDestination.ResumeSubscription

Action parameters

This action takes no parameters.

6.28.5 Property details

6.28.5.1 AuthenticationProtocol:

The authentication protocol for SNMPv3.

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

6.28.5.2 DeliveryRetryPolicy:

The subscription delivery retry policy for events, where the subscription type is RedfishEvent.

string Description
RetryForever The subscription is not suspended or terminated, and attempts at delivery of future events shall continue regardless of the number of retries.
RetryForeverWithBackoff (v1.10+) The subscription is not suspended or terminated, and attempts at delivery of future events shall continue regardless of the number of retries, but issued over time according to a service-defined backoff algorithm.
SuspendRetries The subscription is suspended after the maximum number of retries is reached.
TerminateAfterRetries The subscription is terminated after the maximum number of retries is reached.

6.28.5.3 EncryptionProtocol:

The encryption protocol for SNMPv3.

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

6.28.5.4 EventFormatType:

The content types of the message that are sent to the EventDestination.

string Description
Event The subscription destination receives an event payload.
MetricReport The subscription destination receives a metric report.

6.28.5.5 EventTypes:

The types of events that are sent to the destination.

string Description
Alert A condition requires attention.
MetricReport The telemetry service is sending a metric report.
Other Because EventType is deprecated as of Redfish Specification v1.6, the event is based on a registry or resource but not an EventType.
ResourceAdded A resource has been added.
ResourceRemoved A resource has been removed.
ResourceUpdated A resource has been updated.
StatusChange The status of a resource has changed.

6.28.5.6 LogFacilities:

The types of programs that can log messages.

string Description
Auth Security/authentication messages.
Authpriv Security/authentication messages.
Console Log alert.
Cron Clock daemon.
Daemon System daemons.
FTP FTP daemon.
Kern Kernel messages.
Local0 Locally used facility 0.
Local1 Locally used facility 1.
Local2 Locally used facility 2.
Local3 Locally used facility 3.
Local4 Locally used facility 4.
Local5 Locally used facility 5.
Local6 Locally used facility 6.
Local7 Locally used facility 7.
LPR Line printer subsystem.
Mail Mail system.
News Network news subsystem.
NTP NTP subsystem.
Security Log audit.
SolarisCron Scheduling daemon.
Syslog Messages generated internally by syslogd.
User User-level messages.
UUCP UUCP subsystem.

6.28.5.7 LowestSeverity:

The lowest severity level message that will be forwarded.

string Description
Alert A condition that should be corrected immediately, such as a corrupted system database.
All A message of any severity.
Critical Hard device errors.
Debug Messages that contain information normally of use only when debugging a program.
Emergency A panic condition.
Error An Error.
Informational Informational only.
Notice Conditions that are not error conditions, but that may require special handling.
Warning A Warning.

6.28.5.8 Protocol:

The protocol type of the event connection.

string Description
OEM (v1.9+) The destination follows an OEM protocol for event notifications.
Redfish The destination follows the Redfish Specification for event notifications.
SMTP (v1.7+) The destination follows the SMTP specification for event notifications.
SNMPv1 (v1.7+) The destination follows the SNMPv1 protocol for event notifications.
SNMPv2c (v1.7+) The destination follows the SNMPv2c protocol for event notifications.
SNMPv3 (v1.7+) The destination follows the SNMPv3 protocol for event notifications.
SyslogRELP (v1.9+) The destination follows syslog RELP for event notifications.
SyslogTCP (v1.9+) The destination follows syslog TCP-based for event notifications.
SyslogTLS (v1.9+) The destination follows syslog TLS-based for event notifications.
SyslogUDP (v1.9+) The destination follows syslog UDP-based for event notifications.

6.28.5.9 SubscriptionType:

The subscription type for events.

string Description
OEM (v1.9+) The subscription is an OEM subscription.
RedfishEvent The subscription follows the Redfish Specification for event notifications. To send an event notification, a service sends an HTTP POST to the subscriber's destination URI.
SNMPInform (v1.7+) The subscription follows versions 2 and 3 of SNMP Inform for event notifications.
SNMPTrap (v1.7+) The subscription follows the various versions of SNMP Traps for event notifications.
SSE The subscription follows the HTML5 Server-Sent Event definition for event notifications.
Syslog (v1.9+) The subscription sends Syslog messages for event notifications.

6.28.6 Example response

{
    "@odata.type": "#EventDestination.v1_10_1.EventDestination",
    "Id": "1",
    "Name": "EventSubscription 1",
    "Destination": "http://www.dnsname.com/Destination1",
    "SubscriptionType": "RedfishEvent",
    "DeliveryRetryPolicy": "TerminateAfterRetries",
    "Status": {
        "State": "Enabled"
    },
    "Actions": {
        "#EventDestination.ResumeSubscription": {
            "target": "/redfish/v1/EventService/Subscriptions/1/Actions/EventDestination.ResumeSubscription"
        }
    },
    "EventTypes": [
        "Alert"
    ],
    "Context": "WebUser3",
    "Protocol": "Redfish",
    "@odata.id": "/redfish/v1/EventService/Subscriptions/1"
}

6.29 EventService 1.7.1

Version v1.7 v1.6 v1.5 v1.4 v1.3 v1.2 v1.1 v1.0
Release 2020.2 2020.1 2019.3 2019.2 2019.1 2018.2 2018.1 1.0

6.29.1 Description

The EventService schema contains properties for managing event subscriptions and generates the events sent to subscribers. The resource has links to the actual collection of subscriptions, which are called event destinations.

6.29.2 URIs

/redfish/v1/EventService

6.29.3 Properties

Property Type Attributes Notes
DeliveryRetryAttempts integer read-write The number of times that the POST of an event is retried before the subscription terminates. This retry occurs at the service level, which means that the HTTP POST to the event destination fails with an HTTP 4XX or 5XX status code or an HTTP timeout occurs this many times before the event destination subscription terminates.
DeliveryRetryIntervalSeconds integer
(seconds)
read-write The interval, in seconds, between retry attempts for sending any event.
EventFormatTypes (v1.2+) [ ] array (string
(enum))
read-only
(null)
The content types of the message that this service can send to the event destination. For the possible property values, see EventFormatTypes in Property details.
EventTypesForSubscription (deprecated v1.3) [ ] array (string
(enum))
read-only The types of events to which a client can subscribe. For the possible property values, see EventTypesForSubscription in Property details. Deprecated in v1.3 and later. This property has been deprecated. Starting with Redfish Specification v1.6 (Event v1.3), subscriptions are based on the RegistryPrefix and ResourceType properties and not on the EventType property.
IncludeOriginOfConditionSupported (v1.6+) boolean read-only
(null)
An indication of whether the service supports including the resource payload of the origin of condition in the event payload.
RegistryPrefixes (v1.2+) [ ] array (string, null) read-only The list of the prefixes of the message registries that can be used for the RegistryPrefix property on a subscription. If this property is absent or contains an empty array, the service does not support RegistryPrefix-based subscriptions.
ResourceTypes (v1.2+) [ ] array (string, null) read-only The list of @odata.type values, or schema names, that can be specified in the ResourceTypes array in a subscription. If this property is absent or contains an empty array, the service does not support resource type-based subscriptions.
ServerSentEventUri (v1.1+) string
(URI)
read-only The link to a URI for receiving Server-Sent Event representations for the events that this service generates.
ServiceEnabled boolean read-write
(null)
An indication of whether this service is enabled.
SMTP (v1.5+) { object Settings for SMTP event delivery.
      Authentication (v1.5+) string
(enum)
read-write
(null)
The authentication method for the SMTP server. For the possible property values, see Authentication in Property details.
      ConnectionProtocol (v1.5+) string
(enum)
read-write
(null)
The connection type to the outgoing SMTP server. For the possible property values, see ConnectionProtocol in Property details.
      FromAddress (v1.5+) string read-write
(null)
The 'from' email address of the outgoing email.
      Password (v1.5+) string read-write
(null)
The password for authentication with the SMTP server. The value is null in responses.
      Port (v1.5+) integer read-write
(null)
The destination SMTP port.
      ServerAddress (v1.5+) string read-write
(null)
The address of the SMTP server.
      ServiceEnabled (v1.5+) boolean read-write
(null)
An indication if SMTP for event delivery is enabled.
      Username (v1.5+) string read-write
(null)
The username for authentication with the SMTP server.
}
SSEFilterPropertiesSupported (v1.2+) { object The set of properties that are supported in the $filter query parameter for the ServerSentEventUri.
      EventFormatType (v1.2+) boolean read-only An indication of whether the service supports filtering by the EventFormatType property.
      EventType (v1.2+, deprecated v1.3 boolean read-only An indication of whether the service supports filtering by the EventType property. Deprecated in v1.3 and later. This property has been deprecated. Starting with Redfish Specification v1.6 (Event v1.3), subscriptions are based on the RegistryPrefix and ResourceType properties and not on the EventType property.
      MessageId (v1.2+) boolean read-only An indication of whether the service supports filtering by the MessageId property.
      MetricReportDefinition (v1.2+) boolean read-only An indication of whether the service supports filtering by the MetricReportDefinition property.
      OriginResource (v1.2+) boolean read-only An indication of whether the service supports filtering by the OriginResource property.
      RegistryPrefix (v1.2+) boolean read-only An indication of whether the service supports filtering by the RegistryPrefix property.
      ResourceType (v1.2+) boolean read-only An indication of whether the service supports filtering by the ResourceType property.
      SubordinateResources (v1.4+) boolean read-only An indication of whether the service supports filtering by the SubordinateResources property.
}
Status {} object The status and health of the resource and its subordinate or dependent resources. For property details, see Status.
SubordinateResourcesSupported (v1.2+) boolean read-only
(null)
An indication of whether the service supports the SubordinateResources property on both event subscriptions and generated events.
Subscriptions { object The link to a collection of event destinations. Contains a link to a resource.
      @odata.id string read-only Link to Collection of EventDestination. See the EventDestination schema for details.
}

6.29.4 Actions

6.29.4.1 SubmitTestEvent

Description

This action generates a test event.

Action URI: {Base URI of target resource}/Actions/EventService.SubmitTestEvent

Action parameters

Parameter Name Type Attributes Notes
      EventGroupId (v1.3+) integer optional The group identifier for the event.
      EventId string optional The ID for the event to add.
      EventTimestamp string
(date-time)
optional The date and time for the event to add.
      EventType (deprecated v1.3) string
(enum)
optional The type for the event to add. For the possible property values, see EventType in Property details. Deprecated in v1.3 and later. This parameter has been deprecated. Starting with Redfish Specification v1.6 (Event v1.3), subscriptions are based on the RegistryPrefix and ResourceType properties and not on the EventType property.
      Message string optional The human-readable message for the event to add.
      MessageArgs [ ] array (string) optional An array of message arguments for the event to add.
      MessageId string required The MessageId for the event to add.
      OriginOfCondition string
(URI)
optional The URL in the OriginOfCondition property of the event to add. It is not a reference object.
      Severity string optional The severity for the event to add.

6.29.5 Property details

6.29.5.1 Authentication:

The authentication method for the SMTP server.

string Description
AutoDetect Auto-detect.
CRAM_MD5 CRAM-MD5 authentication.
Login (deprecated v1.7) LOGIN authentication. Deprecated in v1.7 and later. This value has been deprecated in favor of Plain, which supersedes the LOGIN authentication method for SASL.
None No authentication.
Plain PLAIN authentication.

6.29.5.2 ConnectionProtocol:

The connection type to the outgoing SMTP server.

string Description
AutoDetect Auto-detect.
None Clear text.
StartTLS StartTLS.
TLS_SSL TLS/SSL.

6.29.5.3 EventFormatTypes:

The content types of the message that this service can send to the event destination.

string Description
Event The subscription destination receives an event payload.
MetricReport The subscription destination receives a metric report.

6.29.5.4 EventType:

The type for the event to add.

string Description
Alert A condition requires attention.
MetricReport The telemetry service is sending a metric report.
Other Because EventType is deprecated as of Redfish Specification v1.6, the event is based on a registry or resource but not an EventType.
ResourceAdded A resource has been added.
ResourceRemoved A resource has been removed.
ResourceUpdated A resource has been updated.
StatusChange The status of a resource has changed.

6.29.5.5 EventTypesForSubscription:

The types of events to which a client can subscribe.

string Description
Alert A condition requires attention.
MetricReport The telemetry service is sending a metric report.
Other Because EventType is deprecated as of Redfish Specification v1.6, the event is based on a registry or resource but not an EventType.
ResourceAdded A resource has been added.
ResourceRemoved A resource has been removed.
ResourceUpdated A resource has been updated.
StatusChange The status of a resource has changed.

6.29.6 Example response

{
    "@odata.type": "#EventService.v1_7_1.EventService",
    "Id": "EventService",
    "Name": "Event Service",
    "Status": {
        "State": "Enabled",
        "Health": "OK"
    },
    "ServiceEnabled": true,
    "DeliveryRetryAttempts": 3,
    "DeliveryRetryIntervalSeconds": 60,
    "EventTypesForSubscription": [
        "StatusChange",
        "ResourceUpdated",
        "ResourceAdded",
        "ResourceRemoved",
        "Alert"
    ],
    "ServerSentEventUri": "/redfish/v1/EventService/SSE",
    "SSEFilterPropertiesSupported": {
        "EventType": true,
        "MetricReportDefinition": false,
        "RegistryPrefix": true,
        "ResourceType": true,
        "EventFormatType": false,
        "MessageId": true,
        "OriginResource": true,
        "SubordinateResources": true
    },
    "Subscriptions": {
        "@odata.id": "/redfish/v1/EventService/Subscriptions"
    },
    "Actions": {
        "#EventService.SubmitTestEvent": {
            "target": "/redfish/v1/EventService/Actions/EventService.SubmitTestEvent",
            "@Redfish.ActionInfo": "/redfish/v1/EventService/SubmitTestEventActionInfo"
        },
        "Oem": {}
    },
    "Oem": {},
    "@odata.id": "/redfish/v1/EventService"
}

6.30 ExternalAccountProvider 1.2.0

Version v1.2 v1.1 v1.0
Release 2020.4 2018.3 2018.1

6.30.1 Description

The ExternalAccountProvider schema represents a remote service that provides accounts for this manager to use for authentication.

6.30.2 URIs

/redfish/v1/AccountService/ExternalAccountProviders/{ExternalAccountProviderId}
/redfish/v1/Managers/{ManagerId}/RemoteAccountService/ExternalAccountProviders/{ExternalAccountProviderId}

6.30.3 Properties

Property Type Attributes Notes
AccountProviderType string
(enum)
read-only required on create
(null)
The type of external account provider to which this service connects. For the possible property values, see AccountProviderType in Property details.
Authentication { object The authentication information for the external account provider.
      AuthenticationType 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.2+) string read-write
(null)
Specifies the encryption key.
      EncryptionKeySet (v1.2+) boolean read-only
(null)
Indicates if the EncryptionKey property is set.
      KerberosKeytab 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 {} object See the Oem object definition in the Common properties section.
      Password string read-write
(null)
The password for this service. A PATCH or PUT request writes the password. This property is null in responses.
      Token string read-write
(null)
The token for this service. A PATCH or PUT operation writes the token. This property is null in responses.
      Username string read-write The user name for the service.
}
Certificates (v1.1+) { 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 { object The additional mapping information needed to parse a generic LDAP service.
      Oem {} object See the Oem object definition in the Common properties section.
      SearchSettings { object The required settings to search an external LDAP service.
            BaseDistinguishedNames [ ] array (string, null) read-write The base distinguished names to use to search an external LDAP service.
            GroupNameAttribute string read-write
(null)
The attribute name that contains the LDAP group name entry.
            GroupsAttribute string read-write
(null)
The attribute name that contains the groups for a user on the LDAP user entry.
            UsernameAttribute string read-write
(null)
The attribute name that contains the LDAP user name entry.
      }
}
Links { object The links to other resources that are related to this resource.
      Oem {} object See the Oem object definition in the Common properties section.
}
Priority (v1.2+) integer read-write
(null)
The authentication priority for the external account provider.
RemoteRoleMapping [ { array The mapping rules to convert the external account providers account information to the local Redfish role.
      LocalRole string read-write
(null)
The name of the local Redfish role to which to map the remote user or group.
      Oem {} object See the Oem object definition in the Common properties section.
      RemoteGroup 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 string read-write
(null)
The name of the remote user that maps to the local Redfish role to which this entity links.
} ]
ServiceAddresses [ ] 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 boolean read-write
(null)
An indication of whether this service is enabled.
TACACSplusService (v1.2+) { object
(null)
The additional information needed to parse a TACACS+ services.
      PasswordExchangeProtocols (v1.2+) [ ] 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.2+) string read-write
(null)
Indicates the name of the TACACS+ argument name in an authorization request.
}

6.30.4 Property details

6.30.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.
OEM An OEM-specific external authentication or directory service.
RedfishService An external Redfish service.

6.30.4.2 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.30.4.3 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.30.5 Example response

{
    "@odata.type": "#ExternalAccountProvider.v1_2_0.ExternalAccountProvider",
    "Id": "ExternalRedfishService",
    "Name": "Remote Redfish Service",
    "Description": "Remote Redfish Service providing additional Accounts to this Redfish Service",
    "AccountProviderType": "RedfishService",
    "ServiceAddresses": [
        "http://redfish.dmtf.org/redfish/v1/AccountService"
    ],
    "Authentication": {
        "AuthenticationType": "Token",
        "Token": null
    },
    "RemoteRoleMapping": [
        {
            "RemoteGroup": "Admin",
            "LocalRole": "Administrator"
        },
        {
            "RemoteGroup": "Operator",
            "LocalRole": "Operator"
        },
        {
            "RemoteGroup": "ReadOnly",
            "LocalRole": "ReadOnly"
        }
    ],
    "@odata.id": "/redfish/v1/AccountService/ExternalAccountProviders/ExternalRedfishService"
}

6.31 Fabric 1.2.2

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

6.31.1 Description

The Fabric schema represents a simple fabric consisting of one or more switches, zero or more endpoints, and zero or more zones.

6.31.2 URIs

/redfish/v1/Fabrics/{FabricId}

6.31.3 Properties

Property Type Attributes Notes
AddressPools (v1.1+) { object The collection of links to the address pools that this fabric contains. Contains a link to a resource.
      @odata.id string read-only Link to Collection of AddressPool. See the AddressPool schema for details.
}
Connections (v1.2+) { object The collection of links to the connections that this fabric contains. Con