1 Overview
The Redfish standard comprises a set of specifications maintained by the Redfish Forum, a working group within 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 for data payloads.
1.1 Who should read this document?
This document is for Redfish service developers or application software developers that interface with a Redfish service. This document includes the informative and normative descriptions copied from the description and long description annotations in the Redfish Schema Bundle (DSP8010), and adds supplemental normative text to further explain the usage of particular properties or resources.
If mistakes or discrepencies arise in this document, the Redfish Schema Bundle (DSP8010) is the primary normative document.
1.2 How can I provide feedback?
Feedback on all Redfish specifications and documents is encouraged. Feedback can be directed to DMTF and the Redfish Forum by the following means:
- Redfish User Forum: http://www.redfishforum.com User forum monitored by DMTF Redfish Forum personnel to answer questions about any Redfish-related topics.
- DMTF Feedback Portal: https://www.dmtf.org/standards/feedback Formal submission portal for enhancements or proposals to DMTF and the Redfish Forum.
1.3 Where can I find more information?
The following web sites provide more information about the Redfish standard:
-
Resources for developers who use Redfish to build applications. Contains an interactive schema explorer, hosted schema, and other links.
-
DMTF Redfish-monitored user forum. Answers questions about Redfish-related topics.
-
Open source tools and libraries for working with Redfish.
-
Schemas, specifications, mockups, white papers, FAQ, educational material, and more.
-
Working group that maintains the Redfish standard. Site lists member companies, future work and schedules, charter, and information about joining.
1.4 Related documents
The following documents are part of the Redfish development effort. They can be accessed or downloaded from DMTF's Redfish Standards web site: http://www.dmtf.org/standards/redfish
- DSP0218 - Platform Level Data Model (PLDM) for Redfish Device Enablement Specification - Binary-encoded JSON (BEJ) and dictionary-based mapping of Redfish schemas and properties into PLDM messages.
- DSP0266 - Redfish Specification - Main Redfish Specification.
- DSP0268 - Redfish Data Model Specification - Normative descriptions and additional text for every schema defined in DSP8010 and example payloads for every resource.
- DSP0270 - Redfish Host Interface Specification - "In-band" or "OS-based" Redfish host interface.
- DSP0272 - Redfish Interoperability Profiles Specification - Structure and JSON document that is used to define and publish an interoperability profile that checks an implementation's conformance to a defined minimum set of functionality.
- DSP2043 - Redfish Mockups Bundle - Set of mockups that can be used
as sample output from
GETsfrom a Redfish service. Informative in nature, it was used to develop the schema. A person can set up an NGINX or similar server and configure it to output JSON format and then use this directory for demonstration purposes. - DSP2044 - Redfish White Paper - Non-normative document helping those new to Redfish understand how to interact with the Redfish service and understand common functions and tasks.
- DSP2046 - Redfish Resource and Schema Guide - Informative documentation regarding common Redfish resource properties and a listing of properties that can be found in each of the Redfish resources.
- DSP2053 - Redfish Property Guide - Informative documentation providing an index to individual property definitions across all Redfish schema.
- DSP2065 - Redfish Message Registry Guide - Informative documentation providing details regarding the messages defined in Redfish standard message registries.
- DSP8010 - Redfish Schema - Redfish schema definitions. These files are normative in nature and are normatively referenced by the Redfish Specification. The three schema formats are CSDL (OData Common Schema Definition Language format, which is in XML), JSON Schema, and OpenAPI schema. These schema definitions should be functionally equivalent, thus specifying the schema in two different languages.
- DSP8011 - Redfish Standard Registries - Redfish registry definitions. This bundle of Redfish registries includes message registries used for Redfish-defined messages including events and privilege maps.
- DSP8013 - Redfish Interoperability Profiles Bundle - Bundle of published Redfish interoperability profile documents and supporting schema and sample documents used for creating profiles.
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 that defines a 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 name, current version, and description of the schema.
- The release history of the schema. Lists each minor schema version and the DSP8010 release bundle that included it.
- List of the possible URIs where schema-defined resources can appear in a Redfish service following specification version v1.6 or later. See URI listings.
- Table that defines each property. Shows additional details for those properties when needed.
- List of available actions defined for the schema.
- Example JSON payload for a resource using the schema.
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.
|
| Attributes | Designates whether:
|
| Description | The description of the property, as copied directly from the schema's definition of the property. |
2.1 URI listings
The Redfish Specification v1.6.0 added mandatory support for
the OpenAPI Specification v3.0. 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.
Support for v1.6.0 and OpenAPI can be determined by comparing the
value of the RedfishVersion property in the service root
(/redfish/v1/). Services that report a 1.6.0
or higher value, such as 1.6.1 or 1.7.0,
adhere to the URI definitions.
The URI listings do not apply to Redfish services that support specification versions earlier than v1.6.0. For those services, clients must use the hypermedia features of the API to discover hyperlinks from the service root to each resource. While services typically match the URIs listed in this document for many of their resources, this match 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 here in this guide to avoid repetition in the Reference guide property tables.
Note: Several of these properties are payload annotations but appear here because they are required for all Redfish resources.
3.1.1 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| @odata.context | string (URI) |
read-only | The value of this property shall be the context URL that describes the resource according to OData-Protocol and shall be of the form defined in the Redfish specification. |
| @odata.etag | string | read-only | The value of this property shall be a string that is defined by the ETag HTTP header definition in RFC7232. |
| @odata.id | string (URI) |
read-only required | The value of this property shall be the unique identifier for the resource and it shall be of the form defined in the Redfish specification. |
| @odata.type | string | read-only required | The value of this property shall be a URI fragment that specifies the type of the resource and it shall be of the form defined in the Redfish specification. |
| Description | string | read-only | This property shall contain the description of this resource. The value shall conform with the 'Description' clause of the Redfish Specification. |
| Id | string | read-only required | This property shall contain the identifier for this resource. The value shall conform with the 'Id' clause of the Redfish Specification. |
| Name | string | read-only required | This property shall contain the name of this resource or array member. The value shall conform with the 'Name' clause of the Redfish Specification. |
| 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 value of this property shall be the unique identifier for the resource and it shall be of the form defined in the Redfish specification. |
| } ] |
3.3 Payload annotations
Payload annotations are a mechanism in which a service provides additional information about a given 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 named Property@Schema.Term, where
Property is the JSON property being annotated,
Schema is the schema file where the definition for the
annotation is found, and Term is 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 value of this property shall be an integer representing 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 the following example, the property ResetType is
annotated with the Redfish schema-defined
AllowableValues term. Redfish is an alias for
RedfishExtensions. This term indicates to the client that
the service supports the values On and
ForceOff for ResetType.
{
"ResetType@Redfish.AllowableValues": [
"On",
"ForceOff"
]
}3.3.3 Resource-level or object-level annotations
A payload annotation for an entire Resource or a JSON object takes
the @Schema.Term form, where Schema 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 | This type shall describe any capabilities of a resource collection in terms of how a client can create resources within the resource collection. For property details, see CollectionCapabilities. | |
| @Redfish.MaintenanceWindow {} | object | This type shall indicate that a resource has a maintenance window assignment for applying settings or operations. Other resources can link to this object to convey a common control surface for the configuration of the maintenance window. 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 | This type shall indicate that a client can request a specific apply time of a create, delete, or action operation of a resource. For property details, see OperationApplyTimeSupport. | |
| @Redfish.Settings {} | object | This type shall describe any settings of a resource. For property details, see Settings. | |
| @Redfish.SettingsApplyTime {} | object | This type shall be specified by client to indicate the preferred time to apply the configuration settings. 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 | This value shall indicate the requested create, delete, or action operation is applied during the maintenance window that the MaintenanceWindowStartTime and MaintenanceWindowDurationInSeconds properties specify. A service can complete resets during this maintenance window. |
| Immediate | This value shall indicate the requested create, delete, or action operation is applied immediately. This value may result in an immediate host reset, manager reset, or other side effects. |
| InMaintenanceWindowOnReset | This value shall indicate the requested create, delete, or action operation is applied during the maintenance window that the MaintenanceWindowStartTime and MaintenanceWindowDurationInSeconds properties specify, and if a reset occurs within the maintenance window. |
| OnReset | This value shall indicate the requested create, delete, or action operation is applied when the system or service is reset. |
| OnStartUpdateRequest | This value shall indicate the requested create, delete, or action operation is applied when the StartUpdate action of the update service is invoked. |
This example annotates the object with the Redfish
schema-defined action info 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 the available for a
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.
- This composition may be used to represent storage capacity. The sum of the values in Data, Metadata, and Snapshot shall be equal to the total capacity for the data store.
4.2.2 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Data { | object | The capacity information relating to the
user data.
|
|
| AllocatedBytes | integer (bytes) |
read-write (null) |
The number of bytes currently allocated by
the storage system in this data store for this data type.
|
| ConsumedBytes | integer (bytes) |
read-only (null) |
The number of bytes consumed in this data
store for this data type.
|
| GuaranteedBytes | integer (bytes) |
read-write (null) |
The number of bytes the storage system
guarantees can be allocated in this data store for this data
type.
|
| ProvisionedBytes | integer (bytes) |
read-write (null) |
The maximum number of bytes that can be
allocated in this data store for this data type.
|
| } | |||
| IsThinProvisioned | boolean | read-only (null) |
Marks that the capacity is not necessarily
fully allocated.
|
| Metadata { | object | The capacity information relating to
metadata.
|
|
| AllocatedBytes | integer (bytes) |
read-write (null) |
The number of bytes currently allocated by
the storage system in this data store for this data type.
|
| ConsumedBytes | integer (bytes) |
read-only (null) |
The number of bytes consumed in this data
store for this data type.
|
| GuaranteedBytes | integer (bytes) |
read-write (null) |
The number of bytes the storage system
guarantees can be allocated in this data store for this data
type.
|
| ProvisionedBytes | integer (bytes) |
read-write (null) |
The maximum number of bytes that can be
allocated in this data store for this data type.
|
| } | |||
| Snapshot { | object | The capacity information relating to
snapshot or backup data.
|
|
| AllocatedBytes | integer (bytes) |
read-write (null) |
The number of bytes currently allocated by
the storage system in this data store for this data type.
|
| ConsumedBytes | integer (bytes) |
read-only (null) |
The number of bytes consumed in this data
store for this data type.
|
| GuaranteedBytes | integer (bytes) |
read-write (null) |
The number of bytes the storage system
guarantees can be allocated in this data store for this data
type.
|
| ProvisionedBytes | integer (bytes) |
read-write (null) |
The maximum number of bytes that can be
allocated in this data store for this data type.
|
| } |
4.3 Condition
4.3.1 Description
A condition that requires attention.
- This type shall contain the description and details of a condition that exists within this resource or a related resource that requires attention.
4.3.2 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| LogEntry { | object | The link to the log entry created for this
condition.
|
|
| @odata.id | string | read-only | Link to a LogEntry resource. See the Links section and the LogEntry schema for details. |
| } | |||
| Message | string | read-only | The human-readable message for this
condition.
|
| MessageArgs [ ] | array (string) | read-only | An array of message arguments that are
substituted for the arguments in the message when looked up in the
message registry.
|
| MessageId | string | read-only required | The identifier for the
message.
|
| OriginOfCondition { | object | A link to the resource or object that
originated the condition.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } | |||
| Resolution (v1.14+) | string | read-only | Suggestions on how to resolve the
condition.
|
| Severity | string (enum) |
read-only | The severity of the condition.
|
| Timestamp | string (date-time) |
read-only | The time the condition
occurred.
|
4.3.3 Property details
4.3.3.1 Severity
The severity of the condition.
- This property shall contain the severity of the condition. Services can replace the value defined in the message registry with a value more applicable to the implementation.
| string | Description |
|---|---|
| Critical | A critical condition requires immediate attention. |
| OK | Normal. |
| Warning | A condition requires attention. |
4.4 Identifier
4.4.1 Description
Any additional identifiers for a resource.
- This type shall contain any additional identifiers for a resource.
4.4.2 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| DurableName (v1.1+) | string | read-only (null) |
The world-wide, persistent name of the
resource.
|
| DurableNameFormat (v1.1+) | string (enum) |
read-only (null) |
The format of the durable name
property.
|
4.4.3 Property details
4.4.3.1 DurableNameFormat
The format of the durable name property.
- This property shall represent the format of the DurableName property.
| string | Description |
|---|---|
| EUI | The IEEE-defined 64-bit Extended Unique
Identifier (EUI).
|
| FC_WWN | The Fibre Channel (FC) World Wide Name
(WWN).
|
| GCXLID (v1.15+) | The globally unique CXL logical device
identifier (GCXLID).
|
| iQN | The iSCSI Qualified Name
(iQN).
|
| MACAddress (v1.14+) | The media access control address (MAC
address).
|
| NAA | The Name Address Authority (NAA)
format.
|
| NGUID (v1.10+) | The Namespace Globally Unique Identifier
(NGUID).
|
| NQN (v1.6+) | The NVMe Qualified Name (NQN).
|
| NSID (v1.6+, deprecated v1.12) | The NVM Namespace Identifier
(NSID).
NGUID
should be used. |
| UUID | The Universally Unique Identifier
(UUID).
|
4.5 IOStatistics
4.5.1 Description
The properties of this type represent IO statistics.
- The properties of this type shall be used to represent the IO statistics of the requested object.
4.5.2 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| NonIORequests | integer ({tot}) |
read-write (null) |
Count of non IO requests.
|
| NonIORequestTime | string | read-write (null) |
The time that the resource is busy
processing write requests.
|
| ReadHitIORequests | integer ({tot}) |
read-write (null) |
Count of read IO requests satisfied from
memory.
|
| ReadIOKiBytes | integer (KiBy) |
read-write (null) |
Number of kibibytes read.
|
| ReadIORequests | integer ({tot}) |
read-write (null) |
Count of read IO requests.
|
| ReadIORequestTime | string | read-write (null) |
The time that the resource is busy
processing read requests.
|
| WriteHitIORequests | integer ({tot}) |
read-write (null) |
Count of write IO requests coalesced into
memory.
|
| WriteIOKiBytes | integer (KiBy) |
read-write (null) |
Number of kibibytes written.
|
| WriteIORequests | integer ({tot}) |
read-write (null) |
Count of write IO requests.
|
| WriteIORequestTime | string | read-write (null) |
The time that the resource is busy
processing write requests.
|
4.6 IPv4Address
4.6.1 Description
This type describes an IPv4 address.
- This type shall describe an IPv4 address assigned to an interface.
4.6.2 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Address | string | read-write (null) |
The IPv4 address.
^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$ |
| AddressOrigin | string (enum) |
read-only (null) |
This indicates how the address was
determined.
|
| Gateway | string | read-write (null) |
The IPv4 gateway for this
address.
^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$ |
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| SubnetMask | string | read-write (null) |
The IPv4 subnet mask.
^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$ |
4.6.3 Property details
4.6.3.1 AddressOrigin
This indicates how the address was determined.
- This property shall contain the IP address origin for this network interface.
| string | Description |
|---|---|
| BOOTP | A BOOTP service-provided address. |
| DHCP | A DHCPv4 service-provided address. |
| IPv4LinkLocal | The address is valid for only this network segment, or link. |
| Static | A user-configured static address. |
4.7 IPv6Address
4.7.1 Description
This type describes an IPv6 address.
- This type shall describe an IPv6 address assigned to an interface.
4.7.2 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Address | string | read-write (null) |
The IPv6 address.
|
| AddressOrigin | string (enum) |
read-only (null) |
This indicates how the address was
determined.
|
| AddressState | string (enum) |
read-only (null) |
The current RFC4862-defined state of this
address.
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| PrefixLength | integer | read-only (null) |
The IPv6 address prefix
Length.
|
4.7.3 Property details
4.7.3.1 AddressOrigin
This indicates how the address was determined.
- This property shall contain the IPv6 address origin for this interface.
| string | Description |
|---|---|
| DHCPv6 | A DHCPv6 service-provided address. |
| LinkLocal | The address is valid for only this network segment, or link. |
| SLAAC | A stateless autoconfiguration (SLAAC) service-provided address. |
| Static | A static user-configured address. |
4.7.3.2 AddressState
The current RFC4862-defined state of this address.
- This property shall contain the current RFC4862-defined state of this address. Preferred and Deprecated states follow the definitions in RFC4862, section 5.5.4. The Tentative state indicates that the address is undergoing Duplicate Address Detection (DAD), as defined in RFC4862, section 5.4. The Failed state indicates a static address that did not pass DAD. A static address in the Failed state is not in use on the network stack, and corrective action is required to remedy this condition.
| string | Description |
|---|---|
| Deprecated | This address is currently within its valid lifetime but is now outside its RFC4862-defined preferred lifetime. |
| Failed | This address has failed Duplicate Address Detection (DAD) testing, as defined in RFC4862, section 5.4, and is not currently in use. |
| Preferred | This address is currently within both its RFC4862-defined valid and preferred lifetimes. |
| Tentative | This address is currently undergoing Duplicate Address Detection (DAD) testing, as defined in RFC4862, section 5.4. |
4.8 IPv6GatewayStaticAddress
4.8.1 Description
This type represents a single IPv6 static address to be assigned on a network interface.
- This type shall represent a single IPv6 static address to be assigned on a network interface.
4.8.2 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Address (v1.1+) | string | read-write
required (null) |
A valid IPv6 address.
|
| Oem (v1.1+) {} | object | See the OEM object definition in the Using this guide clause. | |
| PrefixLength (v1.1+) | integer | read-write (null) |
The IPv6 network prefix length, in bits,
for this address.
|
4.9 IPv6StaticAddress
4.9.1 Description
This type represents a single IPv6 static address to be assigned on a network interface.
- This type shall represent a single IPv6 static address to be assigned on a network interface.
4.9.2 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Address | string | read-write
required (null) |
A valid IPv6 address.
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| PrefixLength | integer | read-write
required (null) |
The prefix length, in bits, of this IPv6
address.
|
4.10 Location
4.10.1 Description
The location of a resource.
- This type shall describe the location of a resource.
4.10.2 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AltitudeMeters (v1.6+) | number (meters) |
read-write (null) |
The altitude of the resource in
meters.
|
| Contacts (v1.7+) [ { | array | An array of contact
information.
|
|
| ContactName (v1.7+) | string | read-write (null) |
Name of this contact.
|
| EmailAddress (v1.7+) | string | read-write (null) |
Email address for this
contact.
|
| PhoneNumber (v1.7+) | string | read-write (null) |
Phone number for this contact.
|
| } ] | |||
| Info (v1.1+, deprecated v1.5 | string | read-only (null) |
The location of the resource.
|
| InfoFormat (v1.1+, deprecated v1.5 | string | read-only (null) |
The format of the Info
property.
|
| 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 Using this guide clause. | |
| (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.
|
| Orientation (v1.5+) | string (enum) |
read-only (null) |
The orientation for the ordering of the
slot enumeration used by the LocationOrdinalValue property.
|
| Reference (v1.5+) | string (enum) |
read-only (null) |
The reference point for the part location.
Provides guidance about the general location of the part.
|
| ServiceLabel (v1.5+) | string | read-only (null) |
The label of the part location, such as a
silk-screened name or a printed label.
|
| } | |||
| PartLocationContext (v1.16+) | string | read-only (null) |
Human readable string to enable
differentiation between PartLocation value for parts in the same
enclosure, which might include hierarchical information of containing
PartLocation values for the part.
|
| PhysicalAddress (v1.17+) { | object | The physical address for a
resource.
|
|
| City (v1.17+) | string | read-write (null) |
City, township, or shi (JP).
|
| Country (v1.17+) | string | read-write (null) |
The country.
|
| ISOCountryCode (v1.17+) | string | read-write (null) |
The ISO 3166-1 country code.
^([A-Z]{2}|[A-Z]{3})$ |
| ISOSubdivisionCode (v1.17+) | string | read-write (null) |
ISO 3166-2 subdivision code .
^[A-Z0-9]{1,3}$ |
| PostalCode (v1.17+) | string | read-write (null) |
The postal code.
|
| StateOrProvince (v1.17+) | string | read-write (null) |
State or province.
|
| StreetAddress (v1.17+) | string | read-write (null) |
The street-level address, including
building, room, or other identifiers.
|
| } | |||
| 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.
|
| Row (v1.3+) | string | read-write (null) |
The name of the row.
|
| } | |||
| PostalAddress (v1.3+, deprecated v1.17 { | 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.
|
| 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.
|
| Name (v1.3+) | string | read-write (null) |
The name.
|
| Neighborhood (v1.3+) | string | read-write (null) |
Neighborhood or block.
|
| PlaceType (v1.3+) | string | read-write (null) |
The description of the type of place that
is addressed.
|
| POBox (v1.3+) | string | read-write (null) |
The post office box (PO box).
|
| PostalCode (v1.3+) | string | read-write (null) |
The postal code or zip code.
|
| Road (v1.3+) | string | read-write (null) |
The primary road or street.
|
| RoadBranch (v1.3+) | string | read-write (null) |
The road branch.
|
| RoadPostModifier (v1.3+) | string | read-write (null) |
The road post-modifier.
|
| RoadPreModifier (v1.3+) | string | read-write (null) |
The road pre-modifier.
|
| RoadSection (v1.3+) | string | read-write (null) |
The road section.
|
| RoadSubBranch (v1.3+) | string | read-write (null) |
The road sub branch.
|
| Room (v1.3+) | string | read-write (null) |
The name or number of the room.
|
| Seat (v1.3+) | string | read-write (null) |
The seat, such as the desk, cubicle, or
workstation.
|
| Street (v1.3+) | string | read-write (null) |
Street name.
|
| StreetSuffix (v1.3+) | string | read-write (null) |
Avenue, Platz, Street, Circle.
|
| Territory (v1.3+) | string | read-write (null) |
A top-level subdivision within a
country.
|
| TrailingStreetSuffix (v1.3+) | string | read-write (null) |
A trailing street suffix.
|
| Unit (v1.3+) | string | read-write (null) |
The name or number of the apartment unit
or suite.
|
| } |
4.10.3 Property details
4.10.3.1 LocationType
The type of location of the part.
- This property shall contain the type of location of the part.
| string | Description |
|---|---|
| Backplane (v1.12+) | A backplane.
|
| Bay | A bay.
|
| Connector | A connector or port.
|
| Embedded (v1.13+) | Embedded within a part.
|
| Slot | A slot.
|
| Socket | A socket.
|
4.10.3.2 Orientation
The orientation for the ordering of the slot enumeration used by the LocationOrdinalValue property.
- This property shall contain the orientation for the ordering used by the LocationOrdinalValue property.
| string | Description |
|---|---|
| BackToFront | The ordering for the LocationOrdinalValue
is back to front.
|
| BottomToTop | The ordering for LocationOrdinalValue is
bottom to top.
|
| FrontToBack | The ordering for LocationOrdinalValue is
front to back.
|
| LeftToRight | The ordering for the LocationOrdinalValue
is left to right.
|
| RightToLeft | The ordering for the LocationOrdinalValue
is right to left.
|
| TopToBottom | The ordering for the LocationOrdinalValue
is top to bottom.
|
4.10.3.3 RackOffsetUnits
The type of rack units in use.
- This property shall contain a RackUnit enumeration literal that indicates the type of rack units in use.
| string | Description |
|---|---|
| EIA_310 | A rack unit that is equal to 1.75 in
(44.45 mm).
|
| OpenU | A rack unit that is equal to 48 mm (1.89
in).
|
4.10.3.4 Reference
The reference point for the part location. Provides guidance about the general location of the part.
- This property shall contain the general location within the unit of the part.
| string | Description |
|---|---|
| Bottom | The part is in the bottom of the
unit.
|
| Front | The part is in the front of the
unit.
|
| Left | The part is on the left side of of the
unit.
|
| Middle | The part is in the middle of the
unit.
|
| Rear | The part is in the rear of the
unit.
|
| Right | The part is on the right side of the
unit.
|
| Top | The part is in the top of the
unit.
|
4.11 Message
4.11.1 Description
The message that the Redfish service returns.
- This type shall contain a message that the Redfish service returns, as described in the Redfish Specification.
4.11.2 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Message | string | read-only | The human-readable message.
|
| MessageArgs [ ] | array (string) | read-only | An array of message arguments that are
substituted for the arguments in the message when looked up in the
message registry.
|
| MessageId | string | read-only required | The identifier for the
message.
|
| MessageSeverity (v1.1+) | string (enum) |
read-only | The severity of the message.
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| 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.
|
4.11.3 Property details
4.11.3.1 MessageSeverity
The severity of the message.
- This property shall contain the severity of the message. Services can replace the value defined in the message registry with a value more applicable to the implementation.
| string | Description |
|---|---|
| Critical | A critical condition requires immediate attention. |
| OK | Normal. |
| Warning | A condition requires attention. |
4.12 Redundancy
4.12.1 Description
The common redundancy definition and structure used in other Redfish schemas.
- This object represents the redundancy element property.
4.12.2 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| @odata.id | string (URI) |
read-only required | The unique identifier for a
resource.
|
| Actions (v1.2+) {} | object | The available actions for this
resource.
|
|
| MaxNumSupported | integer | read-only (null) |
The maximum number of members allowable
for this particular redundancy group.
|
| MemberId | string | read-only required | The unique identifier for the member
within an array.
|
| 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.
|
| Name | string | read-only required | The name of the resource or array
member.
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| 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.
|
4.12.3 Property details
4.12.3.1 Mode
The redundancy mode of the group.
- This property shall contain the information about the redundancy mode of this subsystem.
| string | Description |
|---|---|
| Failover | Failure of one unit automatically causes a standby or offline unit in the redundancy set to take over its functions. |
| N+m | Multiple units are available and active such that normal operation will continue if one or more units fail. |
| NotRedundant (v1.3+) | The subsystem is not configured in a redundancy mode, either due to configuration or the functionality has been disabled by the user. |
| Sharing | Multiple units contribute or share such that operation will continue, but at a reduced capacity, if one or more units fail. |
| Sparing | One or more spare units are available to take over the function of a failed unit, but takeover is not automatic. |
4.13 RedundantGroup
4.13.1 Description
The redundancy information for the devices in a redundancy group.
- This type shall contain redundancy information for the set of devices in this redundancy group.
4.13.2 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| MaxSupportedInGroup (v1.4+) | integer | read-only (null) |
The maximum number of devices supported in
this redundancy group.
|
| MinNeededInGroup (v1.4+) | integer | read-only required (null) |
The minimum number of devices needed for
this group to be redundant.
|
| RedundancyGroup (v1.4+) [ { | array | required | The links to the devices included in this
redundancy group.
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| RedundancyType (v1.4+) | string (enum) |
read-write
required (null) |
The redundancy mode of the
group.
|
| Status (v1.4+) {} | object | required | The status and health of the resource and
its subordinate or dependent resources.
|
4.13.3 Property details
4.13.3.1 RedundancyType
The redundancy mode of the group.
- This property shall contain the information about the redundancy mode of this redundancy group.
| string | Description |
|---|---|
| Failover | Failure of one unit automatically causes a
standby or offline unit in the redundancy set to take over its
functions.
|
| NotRedundant | The subsystem is not configured in a redundancy mode, either due to configuration or the functionality has been disabled by the user. |
| NPlusM | Multiple units are available and active
such that normal operation will continue if one or more units
fail.
|
| Sharing | Multiple units contribute or share such that operation will continue, but at a reduced capacity, if one or more units fail. |
| Sparing | One or more spare units are available to take over the function of a failed unit, but takeover is not automatic. |
4.14 ReplicaInfo
4.14.1 Description
Defines the characteristics of a replica of a source.
- The value shall define the characteristics of a replica of a source.
4.14.2 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| ConsistencyEnabled | boolean | read-only (null) |
True if consistency is enabled.
|
| ConsistencyState | string (enum) |
read-only (null) |
The current state of
consistency.
|
| ConsistencyStatus | string (enum) |
read-only (null) |
The current status of
consistency.
|
| ConsistencyType | string (enum) |
read-only (null) |
Indicates the consistency type used by the
source and its associated target group.
|
| 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.
|
| RemoteSourceReplica (v1.4+) | string | read-only (null) |
ReplicaFaultDomain describes the fault
domain (local or remote) of the replica relationship.
|
| 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.
|
| 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.
|
| ReplicaProgressStatus | string (enum) |
read-only (null) |
The status of the session with respect to
Replication activity.
|
| ReplicaReadOnlyAccess | string (enum) |
read-only (null) |
This property specifies whether the
source, the target, or both elements are read only to the
host.
|
| ReplicaRecoveryMode | string (enum) |
read-only (null) |
Describes whether the copy operation
continues after a broken link is restored.
|
| ReplicaRole | string (enum) |
read-only (null) |
The source or target role of this
replica.
|
| 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.
|
| ReplicaType | string (enum) |
read-only (null) |
ReplicaType describes the intended outcome
of the replication.
|
| ReplicaUpdateMode | string (enum) |
read-only (null) |
Describes whether the target elements will
be updated synchronously or asynchronously.
|
| RequestedReplicaState | string (enum) |
read-only (null) |
The last requested or desired state for
the relationship.
|
| SourceReplica (v1.2+) { | object | The URI to the source replica when located
on a different Swordfish service instance.
|
|
| @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.
|
| WhenActivated | string (%) |
read-only (null) |
Specifies when point-in-time copy was
taken or when the replication relationship is activated, reactivated,
resumed or re-established.
|
| WhenDeactivated | string (%) |
read-only (null) |
Specifies when the replication
relationship is deactivated.
|
| WhenEstablished | string (%) |
read-only (null) |
Specifies when the replication
relationship is established.
|
| WhenSuspended | string (%) |
read-only (null) |
Specifies when the replication
relationship is suspended.
|
| WhenSynced | string | read-only (null) |
The point in time that the Elements were
synchronized.
|
| WhenSynchronized | string (%) |
read-only (null) |
Specifies when the replication
relationship is synchronized.
|
4.14.3 Property details
4.14.3.1 ConsistencyState
The current state of consistency.
- The ConsistencyState enumeration literal shall indicate the current state of consistency.
| string | Description |
|---|---|
| Consistent | Consistent.
|
| Inconsistent | Not consistent.
|
4.14.3.2 ConsistencyStatus
The current status of consistency.
- The ConsistencyStatus enumeration literal shall specify the current status of consistency. Consistency may have been disabled or is experiencing an error condition.
| string | Description |
|---|---|
| Consistent | Consistent.
|
| Disabled | Consistency disabled.
|
| InError | Consistency error.
|
| InProgress | Becoming consistent.
|
4.14.3.3 ConsistencyType
Indicates the consistency type used by the source and its associated target group.
- The ConsistencyType enumeration literal shall indicate the consistency type used by the source and its associated target group.
| string | Description |
|---|---|
| SequentiallyConsistent | Sequentially consistent.
|
4.14.3.4 ReplicaFaultDomain
ReplicaFaultDomain describes the fault domain (local or remote) of the replica relationship.
- The ReplicaFaultDomain enumeration literal shall describe the fault domain (local or remote) of the replica relationship.
| string | Description |
|---|---|
| Local | Local indicates that the source and target
replicas are contained within a single fault domain.
|
| Remote | Remote indicates that the source and
target replicas are in separate fault domains.
|
4.14.3.5 ReplicaPriority
The priority of background copy engine I/O to be managed relative to host I/O operations during a sequential background copy operation.
- The enumeration literal shall specify the priority of background copy engine I/O to be managed relative to host I/O operations during a sequential background copy operation.
| string | Description |
|---|---|
| High | Copy engine I/O has higher priority than
host I/O.
|
| Low | Copy engine I/O lower priority than host
I/O.
|
| Same | Copy engine I/O has the same priority as
host I/O.
|
| Urgent | Copy operation to be performed as soon as
possible, regardless of the host I/O requests.
|
4.14.3.6 ReplicaProgressStatus
The status of the session with respect to Replication activity.
- The ReplicaProgressStatus enumeration literal shall specify the status of the session with respect to Replication activity.
| string | Description |
|---|---|
| Aborting | Abort in progress.
|
| Completed | The request is completed. Data flow is
idle.
|
| Detaching | Detach in progress.
|
| Dormant | Indicates that the data flow is inactive,
suspended or quiesced.
|
| FailingBack | Undoing the result of
failover.
|
| FailingOver | In the process of switching source and
target.
|
| Fracturing | Fracture in progress.
|
| Initializing | In the process of establishing
source/replica relationship and the data flow has not
started.
|
| Mixed | Applies to groups with element pairs with
different statuses. Generally, the individual statuses need to be
examined.
|
| Pending | The flow of data has stopped momentarily
due to limited bandwidth or a busy system.
|
| Preparing | Preparation in progress.
|
| RequiresActivate | The requested operation has completed,
however, the synchronization relationship needs to be activated before
further copy operations can be issued.
|
| RequiresDetach | The requested operation has completed,
however, the synchronization relationship needs to be detached before
further copy operations can be issued.
|
| RequiresFracture | The requested operation has completed,
however, the synchronization relationship needs to be fractured before
further copy operations can be issued.
|
| RequiresResume | The requested operation has completed,
however, the synchronization relationship needs to be resumed before
further copy operations can be issued.
|
| RequiresResync | The requested operation has completed,
however, the synchronization relationship needs to be resynced before
further copy operations can be issued.
|
| RequiresSplit | The requested operation has completed,
however, the synchronization relationship needs to be split before
further copy operations can be issued.
|
| Restoring | Restore in progress.
|
| Resyncing | Resync in progress.
|
| Splitting | Split in progress.
|
| Suspending | The copy operation is in the process of
being suspended.
|
| Synchronizing | Sync in progress.
|
| Terminating | The relationship is in the process of
terminating.
|
4.14.3.7 ReplicaReadOnlyAccess
This property specifies whether the source, the target, or both elements are read only to the host.
- The enumeration literal shall specify whether the source, the target, or both elements are read only to the host.
| string | Description |
|---|---|
| Both | Both the source and the target elements
are read only to the host.
|
| ReplicaElement | The replica element.
|
| SourceElement | The source element.
|
4.14.3.8 ReplicaRecoveryMode
Describes whether the copy operation continues after a broken link is restored.
- The enumeration literal shall specify whether the copy operation continues after a broken link is restored.
| string | Description |
|---|---|
| Automatic | Copy operation resumes
automatically.
|
| Manual | ReplicaState is set to Suspended after the
link is restored. It is required to issue the Resume operation to
continue.
|
4.14.3.9 ReplicaRole
The source or target role of this replica.
- The ReplicaRole enumeration literal shall represent the source or target role of this replica as known to the containing resource.
| string | Description |
|---|---|
| Source | The source element.
|
| Target | The target element.
|
4.14.3.10 ReplicaState
ReplicaState describes the state of the relationship with respect to Replication activity.
- The ReplicaState enumeration literal shall specify the state of the relationship with respect to Replication activity.
| string | Description |
|---|---|
| Aborted | The copy operation is aborted with the
Abort operation. Use the Resync Replica operation to restart the copy
operation.
|
| Broken | The relationship is non-functional due to
errors in the source, the target, the path between the two or space
constraints.
|
| Failedover | Reads and writes are sent to the target
element. Source element is not reachable.
|
| Fractured | Target is split from the
source.
|
| Inactive | Data flow has stopped, writes to source
element will not be sent to target element.
|
| Initialized | The link to enable replication is
established and source/replica elements are associated, but the data
flow has not started.
|
| Invalid | The array is unable to determine the state
of the replication relationship, for example, after the connection is
restored; however, either source or target elements have an unknown
status.
|
| Mixed | Applies to the ReplicaState of
GroupSynchronized. It indicates the StorageSynchronized relationships of
the elements in the groups have different ReplicaState
values.
|
| Partitioned | State of replication relationship can not
be determined, for example, due to a connection problem.
|
| Prepared | Initialization is completed, however, the
data flow has not started.
|
| Restored | It indicates the source element was
restored from the target element.
|
| Skewed | The target has been modified and is no
longer synchronized with the source element or the point-in-time
view.
|
| Split | The target element was gracefully (or
systematically) split from its source element -- consistency is
guaranteed.
|
| Suspended | Data flow between the source and target
elements has stopped. Writes to source element are held until the
relationship is Resumed.
|
| Synchronized | For the Mirror, Snapshot, or Clone
replication, the target represents a copy of the source.
|
| Unsynchronized | Not all the source element data has been
copied to the target element.
|
4.14.3.11 ReplicaType
ReplicaType describes the intended outcome of the replication.
- The ReplicaType enumeration literal shall describe the intended outcome of the replication.
| string | Description |
|---|---|
| Clone | Create a point in time, full copy the
source.
|
| Mirror | Create and maintain a copy of the
source.
|
| Snapshot | Create a point in time, virtual copy of
the source.
|
| TokenizedClone | Create a token based clone.
|
4.14.3.12 ReplicaUpdateMode
Describes whether the target elements will be updated synchronously or asynchronously.
- The enumeration literal shall specify whether the target elements will be updated synchronously or asynchronously.
| string | Description |
|---|---|
| Active | Active-Active (i.e. bidirectional)
synchronous updates.
|
| Adaptive | Allows implementation to switch between
synchronous and asynchronous modes.
|
| Asynchronous | Asynchronous updates.
|
| Synchronous | Synchronous updates.
|
4.14.3.13 RequestedReplicaState
The last requested or desired state for the relationship.
- The last requested or desired state for the relationship. The actual state of the relationship shall be represented by ReplicaState. When RequestedState reaches the requested state, this property shall be null.
| string | Description |
|---|---|
| Aborted | The copy operation is aborted with the
Abort operation. Use the Resync Replica operation to restart the copy
operation.
|
| Broken | The relationship is non-functional due to
errors in the source, the target, the path between the two or space
constraints.
|
| Failedover | Reads and writes are sent to the target
element. Source element is not reachable.
|
| Fractured | Target is split from the
source.
|
| Inactive | Data flow has stopped, writes to source
element will not be sent to target element.
|
| Initialized | The link to enable replication is
established and source/replica elements are associated, but the data
flow has not started.
|
| Invalid | The array is unable to determine the state
of the replication relationship, for example, after the connection is
restored; however, either source or target elements have an unknown
status.
|
| Mixed | Applies to the ReplicaState of
GroupSynchronized. It indicates the StorageSynchronized relationships of
the elements in the groups have different ReplicaState
values.
|
| Partitioned | State of replication relationship can not
be determined, for example, due to a connection problem.
|
| Prepared | Initialization is completed, however, the
data flow has not started.
|
| Restored | It indicates the source element was
restored from the target element.
|
| Skewed | The target has been modified and is no
longer synchronized with the source element or the point-in-time
view.
|
| Split | The target element was gracefully (or
systematically) split from its source element -- consistency is
guaranteed.
|
| Suspended | Data flow between the source and target
elements has stopped. Writes to source element are held until the
relationship is Resumed.
|
| Synchronized | For the Mirror, Snapshot, or Clone
replication, the target represents a copy of the source.
|
| Unsynchronized | Not all the source element data has been
copied to the target element.
|
4.14.3.14 UndiscoveredElement
This property specifies whether the source, the target, or both elements involved in a copy operation are undiscovered.
- The enumeration literal shall specify whether the source, the target, or both elements involved in a copy operation are undiscovered. An element is considered undiscovered if its object model is not known to the service performing the copy operation.
| string | Description |
|---|---|
| ReplicaElement | The replica element is
undiscovered.
|
| SourceElement | The source element is
undiscovered.
|
4.15 Schedule
4.15.1 Description
Schedule a series of occurrences.
- The properties of this type shall schedule a series of occurrences.
4.15.2 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| EnabledDaysOfMonth [ ] | array (integer, null) | read-write | Days of the month when scheduled
occurrences are enabled. 0 indicates that every day of the
month is enabled.
|
| EnabledDaysOfWeek [ ] | array (string (enum)) |
read-write (null) |
Days of the week.
|
| EnabledIntervals (v1.1+) [ ] | array (string, null) | read-write | Intervals when scheduled occurrences are
enabled.
|
| EnabledMonthsOfYear [ ] | array (string (enum)) |
read-write (null) |
Months of the year.
|
| InitialStartTime | string (date-time) |
read-write (null) |
The date and time when the initial
occurrence is scheduled to occur.
|
| Lifetime | string (duration) |
read-write (null) |
The time after provisioning when the
schedule as a whole expires.
^P(\d+D)?(T(\d+H)?(\d+M)?(\d+(.\d+)?S)?)?$ |
| MaxOccurrences | integer | read-write (null) |
The maximum number of scheduled
occurrences.
|
| Name | string | read-write (null) |
The schedule name.
|
| RecurrenceInterval | string (duration) |
read-write (null) |
The duration between consecutive
occurrences.
^P(\d+D)?(T(\d+H)?(\d+M)?(\d+(.\d+)?S)?)?$ |
4.15.3 Property details
4.15.3.1 EnabledDaysOfWeek
Days of the week.
- 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.
- Days of the week when scheduled occurrences are enabled. If not present, all days of the week shall be enabled.
| string | Description |
|---|---|
| Every | Every day of the week.
|
| Friday | Friday. |
| Monday | Monday. |
| Saturday | Saturday. |
| Sunday | Sunday. |
| Thursday | Thursday. |
| Tuesday | Tuesday. |
| Wednesday | Wednesday. |
4.15.3.2 EnabledMonthsOfYear
Months of the year.
- The months of the year when scheduled
occurrences are enabled. If not present, all months of the year are
enabled.
- This property shall contain the months of the year when scheduled occurrences are enabled, for enabled days of week and days of month. If not present, all months of the year shall be enabled.
| string | Description |
|---|---|
| April | April. |
| August | August. |
| December | December. |
| Every | Every month of the year.
|
| February | February. |
| January | January. |
| July | July. |
| June | June. |
| March | March. |
| May | May. |
| November | November. |
| October | October. |
| September | September. |
4.16 Status
4.16.1 Description
The status and health of a resource and its children.
- This type shall contain any status or health properties of a resource.
4.16.2 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Conditions (v1.11+) [ { | array | Conditions in this resource that require
attention.
|
|
| LogEntry { | object | The link to the log entry created for this
condition.
|
|
| @odata.id | string | read-only | Link to a LogEntry resource. See the Links section and the LogEntry schema for details. |
| } | |||
| Message | string | read-only | The human-readable message for this
condition.
|
| MessageArgs [ ] | array (string) | read-only | An array of message arguments that are
substituted for the arguments in the message when looked up in the
message registry.
|
| MessageId | string | read-only required | The identifier for the
message.
|
| OriginOfCondition { | object | A link to the resource or object that
originated the condition.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } | |||
| Resolution (v1.14+) | string | read-only | Suggestions on how to resolve the
condition.
|
| Severity | string (enum) |
read-only | The severity of the condition.
|
| 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.
|
| HealthRollup | string (enum) |
read-only (null) |
The overall health state from the view of
this resource.
|
| Oem { | object | See the OEM object definition in the Using this guide clause. | |
| (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.
|
4.16.3 Property details
4.16.3.1 Health
The health state of this resource in the absence of its dependent resources.
- This property shall represent the health state of the resource without considering its dependent resources. The values shall conform to those defined in the Redfish Specification.
| string | Description |
|---|---|
| Critical | A critical condition requires immediate attention. |
| OK | Normal. |
| Warning | A condition requires attention. |
4.16.3.2 HealthRollup
The overall health state from the view of this resource.
- This property shall represent the health state of the resource and its dependent resources. The values shall conform to those defined in the Redfish Specification.
Methods used to determine the value of this property can vary between
different architectures and requirements of the underlying product. This
property does not necessarily surface the most degraded health from all
subordinate resources. For example, if a PowerSupply
resource contains Critical for its Health
property, but belongs to a redundancy group that is still able to power
the parent Chassis resource, the Chassis
resource could report Warning for the
HealthRollup property, depending on the redundancy policy
for the Chassis resource. Using the same
PowerSupply example, the ComputerSystem
resource associated with this Chassis resource could
degrade its HealthRollup, even though the
PowerSupply resource is not subordinate to the
ComputerSystem resource. In this case, the
ComputerSystem resource is dependent on the
PowerSupply, but are in two different resource
hierarchies.
| string | Description |
|---|---|
| Critical | A critical condition requires immediate attention. |
| OK | Normal. |
| Warning | A condition requires attention. |
4.16.3.3 Severity
The severity of the condition.
- This property shall contain the severity of the condition. Services can replace the value defined in the message registry with a value more applicable to the implementation.
| string | Description |
|---|---|
| Critical | A critical condition requires immediate attention. |
| OK | Normal. |
| Warning | A condition requires attention. |
4.16.3.4 State
The known state of the resource, such as, enabled.
- This property shall indicate whether and why this component is available. Enabled indicates the resource is available. Disabled indicates the resource has been intentionally made unavailable but it can be enabled. Offline indicates the resource is unavailable intentionally and requires action to make it available. InTest indicates that the component is undergoing testing. Starting indicates that the resource is becoming available. Absent indicates the resource is physically unavailable.
| string | Description |
|---|---|
| Absent | This function or device is not currently present or detected. This resource represents a capability or an available location where a device can be installed. |
| 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 resource collection is a core concept in Redfish. A resource
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 collection contains 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 will have the same resource type with the same major version,
but can vary in minor or errata schema versions.
The properties of a resource collection are:
5.0.1 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| @odata.context | string (URI) |
read-only | The value of this property shall be the context URL that describes the resource according to OData-Protocol and shall be of the form defined in the Redfish specification. |
| @odata.id | string (URI) |
read-only required | The value of this property shall be the unique identifier for the resource and it shall be of the form defined in the Redfish specification. |
| @odata.type | string | read-only required | The value of this property shall be a URI fragment that specifies the type of the resource and it shall be of the form defined in the Redfish specification. |
| Description | string | read-only (null) |
This property shall contain the description of this resource. The value shall conform with the 'Description' clause of the Redfish Specification. |
| 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 value of this property shall be an integer representing the number of items in a collection. |
| Members@odata.nextLink | string (URI) |
read-only | The value of this property shall be a URI to a resource, with the same @odata.type, containing the next set of partial members. |
| Name | string | read-only required | This property shall contain the name of this resource or array member. The value shall conform with the 'Name' clause of the Redfish Specification. |
| Oem {} | object | This string property shall be in the
Oem reserved word format. |
As shown in the following example, a Redfish service may provide
management functionality for several ComputerSystem
resources, and therefore a ComputerSystemCollection
resource is provided. This example shows a service with four
ComputerSystem instances inside the Members
array.
{
"@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.id": "/redfish/v1/Systems"
}5.1 Collection capabilities annotation (#CollectionCapabilities)
This annotation is used to inform the client how to form the request body for a create (POST) operation to a given collection based on a specified use case, which will result in a new member being added to the given collection.
5.1.1 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Capabilities [ { | array | This property shall contain an array of objects that describe the capabilities of this resource collection. | |
| CapabilitiesObject { | object | required | This property shall contain a link to a resource that matches the type for a resource collection and shall contain annotations that describe the properties allowed in the POST request. |
| @odata.id | string (URI) |
read-only | The value of this property shall be the unique identifier for the resource and it shall be of the form defined in the Redfish specification. |
| } | |||
| Links { | object | required | This property shall contain links to resources that are related to but are not contained by, or subordinate to, this resource. |
| Oem {} | object | This property shall contain the OEM extensions. All values for properties contained in this object shall conform to the Redfish Specification-described requirements. For property details, see Oem. | |
| RelatedItem [ { | array | This property shall contain an array of links to resources that are related to this capability. | |
| @odata.id | string (URI) |
read-only | The value of this property shall be the unique identifier for the resource and it shall be of the form defined in the Redfish specification. |
| } ] | |||
| RelatedItem@odata.count | integer | read-only | The value of this property shall be an integer representing the number of items in a collection. |
| TargetCollection { | object | required | This property shall contain a link to a resource collection that this structure describes. A client can use this structure to understand how to form the POST request for the collection. |
| @odata.id | string (URI) |
read-only | The value of this property shall be the unique identifier for the resource and it shall be of the form defined in the Redfish specification. |
| } | |||
| } | |||
| UseCase | string (enum) |
read-only required | This property shall contain an enumerated value that describes the use case for this capability instance. For the possible property values, see UseCase in Property details. |
| } ] | |||
| MaxMembers (v1.2+) | integer | read-only | This property shall contain the maximum number of members allowed in this resource collection. |
5.1.2 Property details
5.1.2.1 UseCase
This property shall contain an enumerated value that describes the use case for this capability instance.
| string | Description |
|---|---|
| ComputerSystemComposition | This capability describes a client creating a new computer system resource from a set of disaggregated hardware. |
| ComputerSystemConstrainedComposition (v1.1+) | This capability describes a client creating a new computer system resource from a set of constraints. |
| ResourceBlockComposition (v1.3+) | This capability describes a client creating a new resource block from a set of other resource blocks. |
| ResourceBlockConstrainedComposition (v1.3+) | This capability describes a client creating a new resource block from a set of constraints. |
| VolumeCreation | This capability describes a client creating a new volume resource as part of an existing storage subsystem. |
5.1.3 Example collection capabilities annotation
{
"@Redfish.CollectionCapabilities": {
"@odata.type": "#CollectionCapabilities.v1_1_0.CollectionCapabilities",
"Capabilities": [
{
"CapabilitiesObject": {
"@odata.id": "/redfish/v1/Systems/Capabilities"
},
"UseCase": "ComputerSystemComposition",
"Links": {
"TargetCollection": {
"@odata.id": "/redfish/v1/Systems"
}
}
},
{
"CapabilitiesObject": {
"@odata.id": "/redfish/v1/Systems/ConstrainedCompositionCapabilities"
},
"UseCase": "ComputerSystemConstrainedComposition",
"Links": {
"TargetCollection": {
"@odata.id": "/redfish/v1/Systems"
}
}
}
]
},
...
}5.2 Resource collection URIs in Redfish v1.6 and later
The following table lists all Redfish-defined resource collections and the URIs where they can appear.
Note: The URIs listed are valid for Redfish services that conform to the Redfish Specification v1.6.0 or higher. Services built on earlier specification versions might use different URIs, which must be discovered by following the hyperlinks from the service root (
/redfish/v1/).
| Collection Type | URIs |
|---|---|
| AccelerationFunctionCollection | /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/AccelerationFunctions /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/AccelerationFunctions /redfish/v1/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/AccelerationFunctions /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/AccelerationFunctions /redfish/v1/Systems/{ComputerSystemId}/Processors/{ProcessorId}/AccelerationFunctions |
| AddressPoolCollection | /redfish/v1/Fabrics/{FabricId}/AddressPools |
| AggregateCollection | /redfish/v1/AggregationService/Aggregates |
| AggregationSourceCollection | /redfish/v1/AggregationService/AggregationSources |
| AllowDenyCollection | /redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/NetworkDeviceFunctions/{NetworkDeviceFunctionId}/AllowDeny /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/NetworkInterfaces/{NetworkInterfaceId}/NetworkDeviceFunctions/{NetworkDeviceFunctionId}/AllowDeny /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/NetworkInterfaces/{NetworkInterfaceId}/NetworkDeviceFunctions/{NetworkDeviceFunctionId}/AllowDeny /redfish/v1/ResourceBlocks/{ResourceBlockId}/NetworkInterfaces/{NetworkInterfaceId}/NetworkDeviceFunctions/{NetworkDeviceFunctionId}/AllowDeny /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/NetworkInterfaces/{NetworkInterfaceId}/NetworkDeviceFunctions/{NetworkDeviceFunctionId}/AllowDeny /redfish/v1/Systems/{ComputerSystemId}/NetworkInterfaces/{NetworkInterfaceId}/NetworkDeviceFunctions/{NetworkDeviceFunctionId}/AllowDeny |
| ApplicationCollection | /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/OperatingSystem/Applications /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/OperatingSystem/Applications /redfish/v1/Systems/{ComputerSystemId}/OperatingSystem/Applications |
| BatteryCollection | /redfish/v1/Chassis/{ChassisId}/PowerSubsystem/Batteries |
| BootOptionCollection | /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/BootOptions /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/BootOptions /redfish/v1/Systems/{ComputerSystemId}/BootOptions |
| CableCollection | /redfish/v1/Cables |
| CertificateCollection | /redfish/v1/AccountService/Accounts/{ManagerAccountId}/Certificates /redfish/v1/AccountService/ActiveDirectory/Certificates /redfish/v1/AccountService/ExternalAccountProviders/{ExternalAccountProviderId}/Certificates /redfish/v1/AccountService/LDAP/Certificates /redfish/v1/AccountService/MultiFactorAuth/ClientCertificate/Certificates /redfish/v1/AccountService/MultiFactorAuth/SecurID/Certificates /redfish/v1/AccountService/OutboundConnections/{OutboundConnectionId}/Certificates /redfish/v1/AccountService/OutboundConnections/{OutboundConnectionId}/ClientCertificates /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/Chassis/{ChassisId}/TrustedComponents/{TrustedComponentId}/Certificates /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Drives/{DriveId}/Certificates /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Memory/{MemoryId}/Certificates /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/Certificates /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Controllers/{StorageControllerId}/Certificates /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Drives/{DriveId}/Certificates /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Certificates /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Boot/Certificates /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Certificates /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/KeyManagement/KMIPCertificates /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Memory/{MemoryId}/Certificates /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/Certificates /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/SecureBoot/SecureBootDatabases/{DatabaseId}/Certificates /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Controllers/{StorageControllerId}/Certificates /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Drives/{DriveId}/Certificates /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Certificates /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/VirtualMedia/{VirtualMediaId}/Certificates /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/VirtualMedia/{VirtualMediaId}/ClientCertificates /redfish/v1/EventService/Subscriptions/{EventDestinationId}/Certificates /redfish/v1/EventService/Subscriptions/{EventDestinationId}/ClientCertificates /redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Certificates /redfish/v1/Managers/{ManagerId}/Certificates /redfish/v1/Managers/{ManagerId}/NetworkProtocol/HTTPS/Certificates /redfish/v1/Managers/{ManagerId}/RemoteAccountService/Accounts/{ManagerAccountId}/Certificates /redfish/v1/Managers/{ManagerId}/RemoteAccountService/ActiveDirectory/Certificates /redfish/v1/Managers/{ManagerId}/RemoteAccountService/ExternalAccountProviders/{ExternalAccountProviderId}/Certificates /redfish/v1/Managers/{ManagerId}/RemoteAccountService/LDAP/Certificates /redfish/v1/Managers/{ManagerId}/RemoteAccountService/MultiFactorAuth/ClientCertificate/Certificates /redfish/v1/Managers/{ManagerId}/RemoteAccountService/MultiFactorAuth/SecurID/Certificates /redfish/v1/Managers/{ManagerId}/SecurityPolicy/SPDM/RevokedCertificates /redfish/v1/Managers/{ManagerId}/SecurityPolicy/SPDM/TrustedCertificates /redfish/v1/Managers/{ManagerId}/SecurityPolicy/TLS/Client/RevokedCertificates /redfish/v1/Managers/{ManagerId}/SecurityPolicy/TLS/Client/TrustedCertificates /redfish/v1/Managers/{ManagerId}/SecurityPolicy/TLS/Server/RevokedCertificates /redfish/v1/Managers/{ManagerId}/SecurityPolicy/TLS/Server/TrustedCertificates /redfish/v1/ResourceBlocks/{ResourceBlockId}/Drives/{DriveId}/Certificates /redfish/v1/ResourceBlocks/{ResourceBlockId}/Memory/{MemoryId}/Certificates /redfish/v1/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/Certificates /redfish/v1/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Controllers/{StorageControllerId}/Certificates /redfish/v1/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Drives/{DriveId}/Certificates /redfish/v1/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Certificates /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Boot/Certificates /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Certificates /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/KeyManagement/KMIPCertificates /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Memory/{MemoryId}/Certificates /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/Certificates /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/SecureBoot/SecureBootDatabases/{DatabaseId}/Certificates /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Controllers/{StorageControllerId}/Certificates /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Drives/{DriveId}/Certificates /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Certificates /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/VirtualMedia/{VirtualMediaId}/Certificates /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/VirtualMedia/{VirtualMediaId}/ClientCertificates /redfish/v1/Storage/{StorageId}/Controllers/{StorageControllerId}/Certificates /redfish/v1/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Certificates /redfish/v1/Systems/{ComputerSystemId}/Boot/Certificates /redfish/v1/Systems/{ComputerSystemId}/Certificates /redfish/v1/Systems/{ComputerSystemId}/KeyManagement/KMIPCertificates /redfish/v1/Systems/{ComputerSystemId}/Memory/{MemoryId}/Certificates /redfish/v1/Systems/{ComputerSystemId}/Processors/{ProcessorId}/Certificates /redfish/v1/Systems/{ComputerSystemId}/SecureBoot/SecureBootDatabases/{DatabaseId}/Certificates /redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/Controllers/{StorageControllerId}/Certificates /redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/Drives/{DriveId}/Certificates /redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Certificates /redfish/v1/Systems/{ComputerSystemId}/VirtualMedia/{VirtualMediaId}/Certificates /redfish/v1/Systems/{ComputerSystemId}/VirtualMedia/{VirtualMediaId}/ClientCertificates /redfish/v1/UpdateService/ClientCertificates /redfish/v1/UpdateService/RemoteServerCertificates |
| ChassisCollection | /redfish/v1/Chassis |
| CircuitCollection | /redfish/v1/PowerEquipment/ElectricalBuses/{PowerDistributionId}/Branches /redfish/v1/PowerEquipment/ElectricalBuses/{PowerDistributionId}/Mains /redfish/v1/PowerEquipment/FloorPDUs/{PowerDistributionId}/Branches /redfish/v1/PowerEquipment/FloorPDUs/{PowerDistributionId}/Mains /redfish/v1/PowerEquipment/FloorPDUs/{PowerDistributionId}/Subfeeds /redfish/v1/PowerEquipment/PowerShelves/{PowerDistributionId}/Branches /redfish/v1/PowerEquipment/PowerShelves/{PowerDistributionId}/Mains /redfish/v1/PowerEquipment/RackPDUs/{PowerDistributionId}/Branches /redfish/v1/PowerEquipment/RackPDUs/{PowerDistributionId}/Mains /redfish/v1/PowerEquipment/Switchgear/{PowerDistributionId}/Branches /redfish/v1/PowerEquipment/Switchgear/{PowerDistributionId}/Feeders /redfish/v1/PowerEquipment/Switchgear/{PowerDistributionId}/Mains /redfish/v1/PowerEquipment/Switchgear/{PowerDistributionId}/Subfeeds /redfish/v1/PowerEquipment/TransferSwitches/{PowerDistributionId}/Branches /redfish/v1/PowerEquipment/TransferSwitches/{PowerDistributionId}/Feeders /redfish/v1/PowerEquipment/TransferSwitches/{PowerDistributionId}/Mains |
| ComponentIntegrityCollection | /redfish/v1/ComponentIntegrity |
| CompositionReservationCollection | /redfish/v1/CompositionService/CompositionReservations |
| ComputerSystemCollection | /redfish/v1/Systems |
| ConnectionCollection | /redfish/v1/Fabrics/{FabricId}/Connections /redfish/v1/Storage/{StorageId}/Connections |
| ConnectionMethodCollection | /redfish/v1/AggregationService/ConnectionMethods |
| ContainerCollection | /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/OperatingSystem/Containers /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/OperatingSystem/Containers /redfish/v1/Systems/{ComputerSystemId}/OperatingSystem/Containers |
| ContainerImageCollection | /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/OperatingSystem/ContainerImages /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/OperatingSystem/ContainerImages /redfish/v1/Systems/{ComputerSystemId}/OperatingSystem/ContainerImages |
| ControlCollection | /redfish/v1/Chassis/{ChassisId}/Controls |
| CoolantConnectorCollection | /redfish/v1/Chassis/{ChassisId}/ThermalSubsystem/CoolantConnectors /redfish/v1/ThermalEquipment/CDUs/{CoolingUnitId}/PrimaryCoolantConnectors /redfish/v1/ThermalEquipment/CDUs/{CoolingUnitId}/SecondaryCoolantConnectors /redfish/v1/ThermalEquipment/CoolingLoops/{CoolingUnitId}/PrimaryCoolantConnectors /redfish/v1/ThermalEquipment/CoolingLoops/{CoolingUnitId}/SecondaryCoolantConnectors /redfish/v1/ThermalEquipment/HeatExchangers/{CoolingUnitId}/PrimaryCoolantConnectors /redfish/v1/ThermalEquipment/HeatExchangers/{CoolingUnitId}/SecondaryCoolantConnectors /redfish/v1/ThermalEquipment/ImmersionUnits/{CoolingUnitId}/PrimaryCoolantConnectors /redfish/v1/ThermalEquipment/ImmersionUnits/{CoolingUnitId}/SecondaryCoolantConnectors |
| CoolingLoopCollection | /redfish/v1/ThermalEquipment/CoolingLoops |
| CoolingUnitCollection | /redfish/v1/ThermalEquipment/CDUs /redfish/v1/ThermalEquipment/HeatExchangers /redfish/v1/ThermalEquipment/ImmersionUnits |
| CXLLogicalDeviceCollection | /redfish/v1/Chassis/{ChassisId}/PCIeDevices/{PCIeDeviceId}/CXLLogicalDevices |
| DriveCollection | /redfish/v1/Chassis/{ChassisId}/Drives /redfish/v1/Storage/{StorageId}/FileSystems/{FileSystemId}/CapacitySources/{CapacitySourceId}/ProvidingDrives /redfish/v1/Storage/{StorageId}/StoragePools/{StoragePoolId}/CapacitySources/{CapacitySourceId}/ProvidingDrives /redfish/v1/Storage/{StorageId}/Volumes/{VolumeId}/CapacitySources/{CapacitySourceId}/ProvidingDrives /redfish/v1/StorageServices/{StorageServiceId}/Drives /redfish/v1/StorageServices/{StorageServiceId}/FileSystems/{FileSystemId}/CapacitySources/{CapacitySourceId}/ProvidingDrives /redfish/v1/StorageServices/{StorageServiceId}/StoragePools/{StoragePoolId}/CapacitySources/{CapacitySourceId}/ProvidingDrives /redfish/v1/StorageServices/{StorageServiceId}/Volumes/{VolumeId}/CapacitySources/{CapacitySourceId}/ProvidingDrives /redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/FileSystems/{FileSystemId}/CapacitySources/{CapacitySourceId}/ProvidingDrives /redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/StoragePools/{StoragePoolId}/CapacitySources/{CapacitySourceId}/ProvidingDrives /redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/Volumes/{VolumeId}/CapacitySources/{CapacitySourceId}/ProvidingDrives |
| EndpointCollection | /redfish/v1/Fabrics/{FabricId}/Endpoints /redfish/v1/Storage/{StorageId}/Endpoints /redfish/v1/StorageServices/{StorageServiceId}/Endpoints |
| EndpointGroupCollection | /redfish/v1/Fabrics/{FabricId}/EndpointGroups /redfish/v1/Storage/{StorageId}/EndpointGroups /redfish/v1/StorageServices/{StorageServiceId}/EndpointGroups /redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/EndpointGroups |
| EthernetInterfaceCollection | /redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/NetworkDeviceFunctions/{NetworkDeviceFunctionId}/EthernetInterfaces /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/EthernetInterfaces /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/OperatingSystem/Containers/EthernetInterfaces /redfish/v1/Managers/{ManagerId}/EthernetInterfaces /redfish/v1/Managers/{ManagerId}/HostInterfaces/{HostInterfaceId}/HostEthernetInterfaces /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/EthernetInterfaces /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/OperatingSystem/Containers/EthernetInterfaces /redfish/v1/Systems/{ComputerSystemId}/EthernetInterfaces /redfish/v1/Systems/{ComputerSystemId}/OperatingSystem/Containers/EthernetInterfaces |
| EventDestinationCollection | /redfish/v1/EventService/Subscriptions |
| ExternalAccountProviderCollection | /redfish/v1/AccountService/ExternalAccountProviders /redfish/v1/Managers/{ManagerId}/RemoteAccountService/ExternalAccountProviders |
| FabricAdapterCollection | /redfish/v1/Chassis/{ChassisId}/FabricAdapters /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters /redfish/v1/Systems/{ComputerSystemId}/FabricAdapters |
| FabricCollection | /redfish/v1/Fabrics |
| FacilityCollection | /redfish/v1/Facilities |
| FanCollection | /redfish/v1/Chassis/{ChassisId}/ThermalSubsystem/Fans |
| FilterCollection | /redfish/v1/Chassis/{ChassisId}/ThermalSubsystem/Pumps/{PumpId}/Filters /redfish/v1/ThermalEquipment/CDUs/{CoolingUnitId}/Filters /redfish/v1/ThermalEquipment/CDUs/{CoolingUnitId}/Pumps/{PumpId}/Filters /redfish/v1/ThermalEquipment/CDUs/{CoolingUnitId}/Reservoirs/{ReservoirId}/Filters /redfish/v1/ThermalEquipment/HeatExchangers/{CoolingUnitId}/Filters /redfish/v1/ThermalEquipment/HeatExchangers/{CoolingUnitId}/Pumps/{PumpId}/Filters /redfish/v1/ThermalEquipment/HeatExchangers/{CoolingUnitId}/Reservoirs/{ReservoirId}/Filters /redfish/v1/ThermalEquipment/ImmersionUnits/{CoolingUnitId}/Filters /redfish/v1/ThermalEquipment/ImmersionUnits/{CoolingUnitId}/Pumps/{PumpId}/Filters /redfish/v1/ThermalEquipment/ImmersionUnits/{CoolingUnitId}/Reservoirs/{ReservoirId}/Filters |
| GraphicsControllerCollection | /redfish/v1/Systems/{ComputerSystemId}/GraphicsControllers |
| HeaterCollection | /redfish/v1/Chassis/{ChassisId}/ThermalSubsystem/Heaters |
| HostInterfaceCollection | /redfish/v1/Managers/{ManagerId}/HostInterfaces |
| JobCollection | /redfish/v1/JobService/Jobs /redfish/v1/JobService/Jobs/{JobId}/Steps |
| JsonSchemaFileCollection | /redfish/v1/JsonSchemas |
| KeyCollection | /redfish/v1/AccountService/Accounts/{ManagerAccountId}/Keys /redfish/v1/AggregationService/AggregationSources/{AggregationSourceId}/TrustedPublicHostKeys /redfish/v1/KeyService/NVMeoFSecrets /redfish/v1/Managers/{ManagerId}/RemoteAccountService/Accounts/{ManagerAccountId}/Keys /redfish/v1/UpdateService/RemoteServerSSHKeys |
| KeyPolicyCollection | /redfish/v1/KeyService/NVMeoFKeyPolicies |
| LeakDetectorCollection | /redfish/v1/Chassis/{ChassisId}/ThermalSubsystem/LeakDetection/LeakDetectors /redfish/v1/ThermalEquipment/CDUs/{CoolingUnitId}/LeakDetection/LeakDetectors /redfish/v1/ThermalEquipment/HeatExchangers/{CoolingUnitId}/LeakDetection/LeakDetectors/ /redfish/v1/ThermalEquipment/ImmersionUnits/{CoolingUnitId}/LeakDetection/LeakDetectors |
| LicenseCollection | /redfish/v1/LicenseService/Licenses |
| LogEntryCollection | /redfish/v1/Chassis/{ChassisId}/LogServices/{LogServiceId}/Entries /redfish/v1/Chassis/{ChassisId}/PCIeDevices/{PCIeDeviceId}/CXLLogicalDevices/{CXLLogicalDeviceId}/DeviceLog/Entries /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/LogServices/{LogServiceId}/Entries /redfish/v1/JobService/Log/Entries /redfish/v1/Managers/{ManagerId}/LogServices/{LogServiceId}/Entries /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/LogServices/{LogServiceId}/Entries /redfish/v1/Systems/{ComputerSystemId}/LogServices/{LogServiceId}/Entries /redfish/v1/Systems/{ComputerSystemId}/Memory/{MemoryId}/DeviceLog/Entries /redfish/v1/TelemetryService/LogService/Entries |
| LogServiceCollection | /redfish/v1/Chassis/{ChassisId}/LogServices /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/LogServices /redfish/v1/Managers/{ManagerId}/LogServices /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/LogServices /redfish/v1/Systems/{ComputerSystemId}/LogServices |
| ManagerAccountCollection | /redfish/v1/AccountService/Accounts /redfish/v1/Managers/{ManagerId}/RemoteAccountService/Accounts |
| ManagerCollection | /redfish/v1/Managers |
| MediaControllerCollection | /redfish/v1/Chassis/{ChassisId}/MediaControllers (deprecated) |
| 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 |
| MemoryRegionCollection | /redfish/v1/Chassis/{ChassisId}/PCIeDevices/{PCIeDeviceId}/CXLLogicalDevices/{CXLLogicalDeviceId}/MemoryRegions |
| 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
(deprecated) /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/NetworkInterfaces/{NetworkInterfaceId}/NetworkPorts (deprecated) /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/NetworkInterfaces/{NetworkInterfaceId}/NetworkPorts (deprecated) /redfish/v1/ResourceBlocks/{ResourceBlockId}/NetworkInterfaces/{NetworkInterfaceId}/NetworkPorts (deprecated) /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/NetworkInterfaces/{NetworkInterfaceId}/NetworkPorts (deprecated) /redfish/v1/Systems/{ComputerSystemId}/NetworkInterfaces/{NetworkInterfaceId}/NetworkPorts (deprecated) |
| OperatingConfigCollection | /redfish/v1/Systems/{ComputerSystemId}/Processors/{ProcessorId}/OperatingConfigs |
| OutboundConnectionCollection | /redfish/v1/AccountService/OutboundConnections |
| OutletCollection | /redfish/v1/PowerEquipment/ElectricalBuses/{PowerDistributionId}/Outlets /redfish/v1/PowerEquipment/PowerShelves/{PowerDistributionId}/Outlets /redfish/v1/PowerEquipment/RackPDUs/{PowerDistributionId}/Outlets /redfish/v1/PowerEquipment/TransferSwitches/{PowerDistributionId}/Outlets |
| OutletGroupCollection | /redfish/v1/PowerEquipment/ElectricalBuses/{PowerDistributionId}/OutletGroups /redfish/v1/PowerEquipment/PowerShelves/{PowerDistributionId}/OutletGroups /redfish/v1/PowerEquipment/RackPDUs/{PowerDistributionId}/OutletGroups /redfish/v1/PowerEquipment/TransferSwitches/{PowerDistributionId}/OutletGroups |
| PCIeDeviceCollection | /redfish/v1/Chassis/{ChassisId}/PCIeDevices /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/PCIeDevices /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/PCIeDevices /redfish/v1/Systems/{ComputerSystemId}/PCIeDevices |
| PCIeFunctionCollection | /redfish/v1/Chassis/{ChassisId}/PCIeDevices/{PCIeDeviceId}/PCIeFunctions /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/PCIeDevices/{PCIeDeviceId}/PCIeFunctions /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/PCIeDevices/{PCIeDeviceId}/PCIeFunctions /redfish/v1/Systems/{ComputerSystemId}/PCIeDevices/{PCIeDeviceId}/PCIeFunctions |
| PortCollection | /redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/Ports /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}/Processors/{ProcessorId}/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}/FabricAdapters/{FabricAdapterId}/Ports /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/GraphicsControllers/{ControllerId}/Ports /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/NetworkInterfaces/{NetworkInterfaceId}/Ports /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/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/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/USBControllers/{ControllerId}/Ports /redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports /redfish/v1/Managers/{ManagerId}/DedicatedNetworkPorts /redfish/v1/Managers/{ManagerId}/SharedNetworkPorts /redfish/v1/Managers/{ManagerId}/USBPorts /redfish/v1/ResourceBlocks/{ResourceBlockId}/NetworkInterfaces/{NetworkInterfaceId}/Ports /redfish/v1/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/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}/FabricAdapters/{FabricAdapterId}/Ports /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/GraphicsControllers/{ControllerId}/Ports /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/NetworkInterfaces/{NetworkInterfaceId}/Ports /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/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/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/USBControllers/{ControllerId}/Ports /redfish/v1/Storage/{StorageId}/Controllers/{StorageControllerId}/Ports /redfish/v1/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Ports /redfish/v1/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports /redfish/v1/Systems/{ComputerSystemId}/GraphicsControllers/{ControllerId}/Ports /redfish/v1/Systems/{ComputerSystemId}/NetworkInterfaces/{NetworkInterfaceId}/Ports /redfish/v1/Systems/{ComputerSystemId}/Processors/{ProcessorId}/Ports /redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/Controllers/{StorageControllerId}/Ports /redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Ports /redfish/v1/Systems/{ComputerSystemId}/USBControllers/{ControllerId}/Ports |
| PowerDistributionCollection | /redfish/v1/PowerEquipment/ElectricalBuses /redfish/v1/PowerEquipment/FloorPDUs /redfish/v1/PowerEquipment/PowerShelves /redfish/v1/PowerEquipment/RackPDUs /redfish/v1/PowerEquipment/Switchgear /redfish/v1/PowerEquipment/TransferSwitches |
| PowerDomainCollection | /redfish/v1/Facilities/{FacilityId}/PowerDomains |
| PowerSupplyCollection | /redfish/v1/Chassis/{ChassisId}/PowerSubsystem/PowerSupplies /redfish/v1/PowerEquipment/PowerShelves/{PowerDistributionId}/PowerSupplies (deprecated) |
| ProcessorCollection | /redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/Processors /redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/Processors/{ProcessorId}/SubProcessors /redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors /redfish/v1/Chassis/{ChassisId}/Processors /redfish/v1/Chassis/{ChassisId}/Processors/{ProcessorId}/SubProcessors /redfish/v1/Chassis/{ChassisId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/SubProcessors /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/SubProcessors /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors /redfish/v1/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/SubProcessors /redfish/v1/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/SubProcessors /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors /redfish/v1/Systems/{ComputerSystemId}/Processors /redfish/v1/Systems/{ComputerSystemId}/Processors/{ProcessorId}/SubProcessors /redfish/v1/Systems/{ComputerSystemId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors |
| PumpCollection | /redfish/v1/Chassis/{ChassisId}/ThermalSubsystem/Pumps /redfish/v1/ThermalEquipment/CDUs/{CoolingUnitId}/Pumps /redfish/v1/ThermalEquipment/HeatExchangers/{CoolingUnitId}/Pumps /redfish/v1/ThermalEquipment/ImmersionUnits/{CoolingUnitId}/Pumps |
| RegisteredClientCollection | /redfish/v1/RegisteredClients |
| ReservoirCollection | /redfish/v1/ThermalEquipment/CDUs/{CoolingUnitId}/Reservoirs /redfish/v1/ThermalEquipment/HeatExchangers/{CoolingUnitId}/Reservoirs /redfish/v1/ThermalEquipment/ImmersionUnits/{CoolingUnitId}/Reservoirs |
| 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/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/GenZ/MSDT /redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/GenZ/SSDT /redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/MSDT (deprecated) /redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/GenZ/LPRT /redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/GenZ/MPRT /redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/LPRT (deprecated) /redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/MPRT (deprecated) /redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/SSDT (deprecated) /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/GenZ/MSDT /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/GenZ/SSDT /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/MSDT (deprecated) /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/GenZ/LPRT /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/GenZ/MPRT /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/LPRT (deprecated) /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/MPRT (deprecated) /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/SSDT (deprecated) /redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortId}/GenZ/LPRT /redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortId}/GenZ/MPRT /redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortId}/LPRT (deprecated) /redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortId}/MPRT (deprecated) /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/GenZ/MSDT /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/GenZ/SSDT /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/MSDT (deprecated) /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/GenZ/LPRT /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/GenZ/MPRT /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/LPRT (deprecated) /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/MPRT (deprecated) /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/SSDT (deprecated) /redfish/v1/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/GenZ/MSDT /redfish/v1/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/GenZ/SSDT /redfish/v1/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/MSDT (deprecated) /redfish/v1/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/GenZ/LPRT /redfish/v1/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/GenZ/MPRT /redfish/v1/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/LPRT (deprecated) /redfish/v1/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/MPRT (deprecated) /redfish/v1/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/SSDT (deprecated) |
| RouteSetEntryCollection | /redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/MSDT/{MSDTId}/RouteSet /redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/LPRT/{LPRTId}/RouteSet /redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/MPRT/{MPRTId}/RouteSet /redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/SSDT/{SSDTId}/RouteSet /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/PowerEquipment/FloorPDUs/{PowerDistributionId}/Sensors (deprecated) /redfish/v1/PowerEquipment/PowerShelves/{PowerDistributionId}/Sensors (deprecated) /redfish/v1/PowerEquipment/RackPDUs/{PowerDistributionId}/Sensors (deprecated) /redfish/v1/PowerEquipment/Switchgear/{PowerDistributionId}/Sensors (deprecated) /redfish/v1/PowerEquipment/TransferSwitches/{PowerDistributionId}/Sensors (deprecated) |
| 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 |
| TrustedComponentCollection | /redfish/v1/Chassis/{ChassisId}/TrustedComponents |
| USBControllerCollection | /redfish/v1/Systems/{ComputerSystemId}/USBControllers |
| VCATEntryCollection | /redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/GenZ/REQ-VCAT /redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/GenZ/RSP-VCAT /redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/GenZ/VCAT /redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/VCAT (deprecated) /redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/REQ-VCAT (deprecated) /redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/RSP-VCAT (deprecated) /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/GenZ/REQ-VCAT /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/GenZ/RSP-VCAT /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/GenZ/VCAT /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/VCAT (deprecated) /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/REQ-VCAT (deprecated) /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/RSP-VCAT (deprecated) /redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortId}/GenZ/VCAT /redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortId}/VCAT (deprecated) /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/GenZ/REQ-VCAT /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/GenZ/RSP-VCAT /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/GenZ/VCAT /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/VCAT (deprecated) /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/REQ-VCAT (deprecated) /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/RSP-VCAT (deprecated) /redfish/v1/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/GenZ/REQ-VCAT /redfish/v1/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/GenZ/RSP-VCAT /redfish/v1/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/GenZ/VCAT /redfish/v1/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/VCAT (deprecated) /redfish/v1/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/REQ-VCAT (deprecated) /redfish/v1/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/RSP-VCAT (deprecated) |
| VirtualMediaCollection | /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/VirtualMedia /redfish/v1/Managers/{ManagerId}/VirtualMedia (deprecated) /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/VirtualMedia /redfish/v1/Systems/{ComputerSystemId}/VirtualMedia |
| VLanNetworkInterfaceCollection | /redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/NetworkDeviceFunctions/{NetworkDeviceFunctionId}/Ethernet/VLANs
(deprecated) /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/EthernetInterfaces/{EthernetInterfaceId}/VLANs (deprecated) /redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/EthernetInterfaces/{EthernetInterfaceId}/VLANs (deprecated) /redfish/v1/Managers/{ManagerId}/EthernetInterfaces/{EthernetInterfaceId}/VLANs (deprecated) /redfish/v1/ResourceBlocks/{ResourceBlockId}/EthernetInterfaces/{EthernetInterfaceId}/VLANs (deprecated) /redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/EthernetInterfaces/{EthernetInterfaceId}/VLANs (deprecated) /redfish/v1/Systems/{ComputerSystemId}/EthernetInterfaces/{EthernetInterfaceId}/VLANs (deprecated) |
| 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 DMTF's 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.
- This Resource shall represent the acceleration function that a processor implements in a Redfish implementation. 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.
|
| 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 Using this guide clause. | |
| 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.
|
|
| UUID | string (uuid) |
read-only (null) |
The UUID for this acceleration
function.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ |
| Version | string | read-only | The acceleration function
version.
|
6.1.4 Property details
6.1.4.1 AccelerationFunctionType
The acceleration function type.
- This property shall contain the string that identifies 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": []
},
"@odata.id": "/redfish/v1/Systems/1/Processors/FPGA1/AccelerationFunctions/Compression"
}6.2 AccountService 1.14.0
| Version | v1.14 | v1.13 | v1.12 | v1.11 | v1.10 | v1.9 | v1.8 | v1.7 | v1.6 | v1.5 | v1.4 | ... |
| Release | 2023.2 | 2023.1 | 2022.3 | 2022.1 | 2021.2 | 2021.1 | 2020.4 | 2019.4 | 2019.2 | 2019.1 | 2018.3 | ... |
6.2.1 Description
The AccountService schema defines an account service. The properties are common to, and enable management of, all user accounts. The properties include the password requirements and control features, such as account lockout. Properties and actions in this service specify general behavior that should be followed for typical accounts, however implementations might override these behaviors for special accounts or situations to avoid denial of service or other deadlock situations.
- This resource shall represent an account service for a Redfish implementation. The properties are common to, and enable management of, all user accounts. The properties include the password requirements and control features, such as account lockout. Properties and actions in this service specify general behavior that should be followed for typical accounts, however implementations may override these behaviors for special accounts or situations to avoid denial of service or other deadlock situations.
6.2.2 URIs
/redfish/v1/AccountService
/redfish/v1/Managers/{ManagerId}/RemoteAccountService
6.2.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AccountLockoutCounterResetAfter | integer (seconds) |
read-write | The period of time, in seconds, between
the last failed login attempt and the reset of the lockout threshold
counter. This value must be less than or equal to the
AccountLockoutDuration value. A reset sets the counter to
0.
|
| AccountLockoutCounterResetEnabled (v1.5+) | boolean | read-write | An indication of whether the threshold
counter is reset after AccountLockoutCounterResetAfter expires. If
true, it is reset. If false, only a successful
login resets the threshold counter and if the user reaches the
AccountLockoutThreshold limit, the account will be locked out
indefinitely and only an administrator-issued reset clears the threshold
counter. If this property is absent, the default is
true.
|
| AccountLockoutDuration | integer (seconds) |
read-write (null) |
The period of time, in seconds, that an
account is locked after the number of failed login attempts reaches the
account lockout threshold, within the period between the last failed
login attempt and the reset of the lockout threshold counter. If this
value is 0, no lockout will occur. If the
AccountLockoutCounterResetEnabled value is false, this
property is ignored.
|
| AccountLockoutThreshold | integer | read-write (null) |
The number of allowed failed login
attempts before a user account is locked for a specified duration. If
0, the account is never locked.
|
| Accounts { | object | The collection of manager
accounts.
|
|
| @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.
|
|
| AdditionalExternalAccountProviders (v1.3+) { | object | The additional external account providers
that this account service uses.
|
|
| @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.
|
|
| 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.
|
| MaxPasswordLength | integer | read-write | The maximum password length for this
account service.
|
| MinPasswordLength | integer | read-write | The minimum password length for this
account service.
|
| MultiFactorAuth (v1.12+) { | object | (null) |
The multi-factor authentication settings
that this account service supports.
|
| ClientCertificate (v1.12+) { | object | (null) |
The settings related to client certificate
authentication schemes such as mTLS or CAC/PIV.
|
| CertificateMappingAttribute (v1.12+) | string (enum) |
read-write (null) |
The client certificate attribute to map to
a user.
|
| Certificates (v1.12+) { | object | The link to a collection of CA
certificates used to validate client certificates.
|
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| Enabled (v1.12+) | boolean | read-write (null) |
An indication of whether client
certificate authentication is enabled.
|
| RespondToUnauthenticatedClients (v1.12+) | boolean | read-write (null) |
An indication of whether the service
responds to clients that do not successfully authenticate.
|
| } | |||
| GoogleAuthenticator (v1.12+) { | object | (null) |
The settings related to Google
Authenticator multi-factor authentication.
|
| Enabled (v1.12+) | boolean | read-write (null) |
An indication of whether multi-factor
authentication with Google Authenticator is enabled.
|
| SecretKey (v1.12+) | string | read-write (null) |
The secret key to use when communicating
with the Google Authenticator server. This property is null
in responses.
|
| SecretKeySet (v1.12+) | boolean | read-only | Indicates if the SecretKey property is
set.
|
| } | |||
| MicrosoftAuthenticator (v1.12+) { | object | (null) |
The settings related to Microsoft
Authenticator multi-factor authentication.
|
| Enabled (v1.12+) | boolean | read-write (null) |
An indication of whether multi-factor
authentication with Microsoft Authenticator is enabled.
|
| SecretKey (v1.12+) | string | read-write (null) |
The secret key to use when communicating
with the Microsoft Authenticator server. This property is
null in responses.
|
| SecretKeySet (v1.12+) | boolean | read-only | Indicates if the SecretKey property is
set.
|
| } | |||
| OneTimePasscode (v1.14+) { | object | (null) |
The settings related to one-time passcode
(OTP) multi-factor authentication.
|
| Enabled (v1.14+) | boolean | read-write (null) |
An indication of whether multi-factor
authentication using a one-time passcode is enabled.
|
| } | |||
| SecurID (v1.12+) { | object | (null) |
The settings related to RSA SecurID
multi-factor authentication.
|
| Certificates (v1.12+) { | object | The link to a collection of server
certificates for the RSA SecurID server referenced by the ServerURI
property.
|
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| ClientId (v1.12+) | string | read-write (null) |
The client ID to use when communicating
with the RSA SecurID server.
|
| ClientSecret (v1.12+) | string | read-write (null) |
The client secret to use when
communicating with the RSA SecurID server. This property is
null in responses.
|
| ClientSecretSet (v1.12+) | boolean | read-only | Indicates if the ClientSecret property is
set.
|
| Enabled (v1.12+) | boolean | read-write (null) |
An indication of whether multi-factor
authentication with RSA SecurID is enabled.
|
| ServerURI (v1.12+) | string (URI) |
read-write (null) |
The URI of the RSA SecurID
server.
|
| } | |||
| } | |||
| OAuth2 (v1.10+) {} | object | (null) |
The first OAuth 2.0 external account
provider that this account service supports.
|
| OutboundConnections (v1.14+) { | object | (null) |
The collection of outbound connection
configurations.
|
| @odata.id | string | read-only | Link to Collection of OutboundConnection. See the OutboundConnection schema for details. |
| } | |||
| PasswordExpirationDays (v1.9+) | integer | read-write (null) |
The number of days before account
passwords in this account service will expire.
|
| PrivilegeMap (v1.1+) { | object | The link to the mapping of the privileges
required to complete a requested operation on a URI associated with this
service.
|
|
| @odata.id | string | read-only | Link to a PrivilegeRegistry resource. See the Links section and the PrivilegeRegistry schema for details. |
| } | |||
| RequireChangePasswordAction (v1.14+) | boolean | read-write (null) |
An indication of whether clients are
required to invoke the ChangePassword action to modify account
passwords.
|
| RestrictedOemPrivileges (v1.8+) [ ] | array (string) | read-only | The set of restricted OEM
privileges.
|
| RestrictedPrivileges (v1.8+) [ ] | array (string (enum)) |
read-only |
|
| Roles { | object | The collection of Redfish
roles.
|
|
| @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.
|
|
| SupportedAccountTypes (v1.8+) [ ] | array (string (enum)) |
read-only |
|
| 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.
|
6.2.4 Property details
6.2.4.1 AccountProviderType
The type of external account provider to which this service connects.
- This property shall contain the type of external account provider to which this service connects.
| string | Description |
|---|---|
| ActiveDirectoryService | An external Active Directory
service.
|
| LDAPService | A generic external LDAP
service.
|
| OAuth2 (v1.10+) | An external OAuth 2.0 service.
|
| OEM | An OEM-specific external authentication or directory service. |
| RedfishService | An external Redfish service.
|
| TACACSplus (v1.8+) | An external TACACS+ service.
|
6.2.4.2 Authentication
The information required to authenticate to the external service.
| AuthenticationType (v1.3+) | string (enum) |
read-write (null) |
The type of authentication used to connect
to the external account provider.
|
| EncryptionKey (v1.8+) | string | read-write (null) |
Specifies the encryption key.
^[0-9a-fA-F]+$ |
| 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 Using this guide clause. | |
| 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.
- This property shall contain 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 BypassTypes
- The types of multi-factor authentication this account or role mapping is allowed to bypass.
- This property shall contain the types of multi-factor authentication this account or role mapping is allowed to bypass. An empty array shall indicate this account or role mapping cannot bypass any multi-factor authentication types that are currently enabled.
| string | Description |
|---|---|
| All | Bypass all multi-factor authentication
types.
|
| ClientCertificate | Bypass client certificate
authentication.
|
| GoogleAuthenticator | Bypass Google Authenticator.
|
| MicrosoftAuthenticator | Bypass Microsoft
Authenticator.
|
| OEM | Bypass OEM-defined multi-factor
authentication.
|
| OneTimePasscode | Bypass one-time passcode
authentication.
|
| SecurID | Bypass RSA SecurID.
|
6.2.4.5 CertificateMappingAttribute
The client certificate attribute to map to a user.
- This property shall contain the client certificate attribute to map to a user.
| string | Description |
|---|---|
| CommonName | Match the Common Name (CN) field in the
provided certificate to the username.
|
| UserPrincipalName | Match the User Principal Name (UPN) field
in the provided certificate to the username.
|
| Whole | Match the whole certificate.
|
6.2.4.6 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.
|
| Authentication (v1.3+) {} | object | The authentication information for the
external account provider.
|
|
| Certificates (v1.4+) { | object | The link to a collection of certificates
that the external account provider uses.
|
|
| @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.
|
|
| OAuth2Service (v1.10+) {} | object | (null) |
The additional information needed to parse
an OAuth 2.0 service.
|
| 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.
|
| MFABypass (v1.12+) { | object | (null) |
The multi-factor authentication bypass
settings.
|
| BypassTypes (v1.12+) [ ] | array (string (enum)) |
read-write (null) |
|
| } | |||
| Oem (v1.3+) {} | object | See the OEM object definition in the Using this guide clause. | |
| 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.
|
| } ] | |||
| Retries (v1.13+) | integer | read-write (null) |
The number of times to retry connecting to
an address in the ServiceAddresses property before attempting the next
address in the array.
|
| 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.
|
| TimeoutSeconds (v1.13+) | integer | read-write (null) |
The period of time, in seconds, this
account service will wait for a response from an address of a user
account provider before timing out.
|
6.2.4.7 LDAPService
The settings required to parse a generic LDAP service.
| Oem (v1.3+) {} | object | See the OEM object definition in the Using this guide clause. | |
| 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.
|
| EmailAttribute (v1.14+) | string | read-write (null) |
The attribute name that contains the LDAP
user's email address.
|
| 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.
|
| SSHKeyAttribute (v1.11+) | string | read-write (null) |
The attribute name that contains the LDAP
user's SSH public key entry.
|
| UsernameAttribute (v1.3+) | string | read-write (null) |
The attribute name that contains the LDAP
user name entry.
|
| } |
6.2.4.8 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.
- This property shall govern how the service uses the manager accounts resource 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.9 Mode
The mode of operation for token validation.
- This property shall contain the mode of operation for token validation.
| string | Description |
|---|---|
| Discovery | OAuth 2.0 service information for token
validation is downloaded by the service.
|
| Offline | OAuth 2.0 service information for token
validation is configured by a client. Clients should configure the
Issuer and OAuthServiceSigningKeys properties for this mode.
|
6.2.4.10 OAuth2Service
Various settings to parse an OAuth 2.0 service.
| Audience (v1.10+) [ ] | array (string) | read-only | The allowable audience strings of the
Redfish service.
|
| Issuer (v1.10+) | string | read-write (null) |
The issuer string of the OAuth 2.0
service. Clients should configure this property if Mode contains
Offline.
|
| Mode (v1.10+) | string (enum) |
read-write | The mode of operation for token
validation.
|
| OAuthServiceSigningKeys (v1.10+) | string | read-write (null) |
The Base64-encoded signing keys of the
issuer of the OAuth 2.0 service. Clients should configure this property
if Mode contains Offline.
|
| Oem (v1.13+) {} | object | See the OEM object definition in the Using this guide clause. |
6.2.4.11 PasswordExchangeProtocols
- Indicates the allowed TACACS+ password exchange protocols.
- This property shall indicate all the allowed TACACS+ password exchange protocol described under section 5.4.2 of RFC8907.
| 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.12 RestrictedPrivileges
- The set of restricted Redfish privileges.
- This property shall contain an array of Redfish privileges that are restricted by the service.
| string | Description |
|---|---|
| AdministrateStorage | Administrator for storage subsystems and storage systems found in the storage collection and storage system collection respectively. |
| AdministrateSystems | Administrator for systems found in the systems collection. Able to manage boot configuration, keys, and certificates for systems. |
| 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, log out of their own sessions, and perform operations on resources they created. Services will need to be aware of resource ownership to map this privilege to an operation from a particular user. |
| ConfigureUsers | Can configure users and their accounts. |
| Login | Can log in to the service and read resources. |
| NoAuth | Authentication is not
required.
|
| OperateStorageBackup | Operator for storage backup functionality for storage subsystems and storage systems found in the storage collection and storage system collection respectively. |
| OperateSystems | Operator for systems found in the systems collection. Able to perform resets and configure interfaces. |
6.2.4.13 SupportedAccountTypes
- The account types supported by the service.
- This property shall contain an array of 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.14 TACACSplusService
Various settings to parse a TACACS+ service.
| AuthorizationService (v1.13+) | string | read-write | The TACACS+ service authorization
argument.
|
| Oem (v1.13+) {} | object | See the OEM object definition in the Using this guide clause. | |
| PasswordExchangeProtocols (v1.8+) [ ] | array (string (enum)) |
read-write (null) |
|
| 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_14_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"
},
"RequireChangePasswordAction": false,
"@odata.id": "/redfish/v1/AccountService"
}6.3 ActionInfo 1.4.0
| Version | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2023.2 | 2022.2 | 2021.2 | 2018.2 | 2016.2 |
6.3.1 Description
The ActionInfo schema defines the supported parameters and other information for a Redfish action. Supported parameters can differ among vendors and even among resource instances. This data can ensure that action requests from applications contain supported parameters.
- This resource shall represent the supported parameters and other information for a Redfish action on a target within a Redfish implementation. 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.
|
|
| AllowableNumbers (v1.3+) [ ] | array (string, null) | read-only | The allowable numeric values or duration
values, inclusive ranges of values, and incremental step values for this
parameter as applied to this action target.
|
| AllowablePattern (v1.3+) | string | read-only (null) |
The allowable pattern for this parameter
as applied to this action target.
|
| AllowableValueDescriptions (v1.4+) [ ] | array (string, null) | read-only | Descriptions of allowable values for this
parameter.
|
| AllowableValues [ ] | array (string, null) | read-only | The allowable values for this parameter as
applied to this action target.
|
| ArraySizeMaximum (v1.2+) | integer | read-only (null) |
The maximum number of array elements
allowed for this parameter.
|
| ArraySizeMinimum (v1.2+) | integer | read-only (null) |
The minimum number of array elements
required for this parameter.
|
| DataType | string (enum) |
read-only (null) |
The JSON property type for this
parameter.
|
| 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.
- This property shall contain 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_4_0.ActionInfo",
"Id": "ResetActionInfo",
"Name": "Reset Action Info",
"Parameters": [
{
"Name": "ResetType",
"Required": true,
"DataType": "String",
"AllowableValues": [
"On",
"ForceOff",
"GracefulShutdown",
"GracefulRestart",
"ForceRestart",
"Nmi",
"ForceOn",
"PushPowerButton"
]
}
],
"@odata.id": "/redfish/v1/Systems/1/ResetActionInfo"
}6.4 AddressPool 1.2.3
| Version | v1.2 | v1.1 | v1.0 |
| Release | 2021.2 | 2020.3 | 2019.4 |
6.4.1 Description
The schema definition of an address pool and its configuration.
- This resource shall represent an address pool in a Redfish implementation.
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.
^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$ |
| AnycastGatewayMACAddress (v1.1+) | string | read-write (null) |
The anycast gateway MAC
address.
^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$ |
| 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.
^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$ |
| GatewayIPAddressRange (v1.2+) { | object | (null) |
The IPv4 address range for
gateways.
|
| Lower (v1.2+) | string | read-write (null) |
The lower IPv4 address.
^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$ |
| Upper (v1.2+) | string | read-write (null) |
The upper IPv4 address.
^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$ |
| } | |||
| NDPProxyEnabled (v1.1+) | boolean | read-write (null) |
Network Discovery Protocol (NDP) proxy
status.
|
| NDPSupressionEnabled (v1.1+) | boolean | read-write (null) |
Network Discovery Protocol (NDP)
suppression status.
|
| RouteDistinguisherAdministratorSubfield (v1.2+) | string | read-write (null) |
The Route Distinguisher (RD) Administrator
subfield.
|
| RouteDistinguisherRange (v1.1+) { | object | (null) |
The Route Distinguisher (RD) number range
for the fabric.
|
| Lower (v1.1+) | integer | read-write | Lower Route Distinguisher (RD)
number.
|
| Upper (v1.1+) | integer | read-write | Upper Route Distinguisher (RD)
number.
|
| } | |||
| RouteTargetAdministratorSubfield (v1.2+) | string | read-write (null) |
The Route Target (RT) Administrator
Subfield.
|
| RouteTargetRange (v1.1+) { | object | (null) |
The Route Target (RT) number range for the
fabric.
|
| Lower (v1.1+) | integer | read-write (null) |
Lower Route Target (RT)
number.
|
| Upper (v1.1+) | integer | read-write (null) |
Upper Route Target (RT)
number.
|
| } | |||
| UnderlayMulticastEnabled (v1.1+) | boolean | read-write (null) |
Underlay multicast status.
|
| UnknownUnicastSuppressionEnabled (v1.1+) | boolean | read-write (null) |
Suppression of unknown unicast
packets.
|
| VLANIdentifierAddressRange (v1.1+) { | object | (null) |
Virtual LAN (VLAN) tag related address
range applicable to this Ethernet fabric or for end host
subnets.
|
| Lower (v1.1+) | integer | read-write (null) |
Virtual LAN (VLAN) tag lower
value.
|
| Upper (v1.1+) | integer | read-write (null) |
Virtual LAN (VLAN) tag upper
value.
|
| } | |||
| } | |||
| EBGP (v1.1+) { | object | (null) |
External BGP (eBGP) related properties for
this Ethernet fabric.
|
| AllowDuplicateASEnabled (v1.1+) | boolean | read-write (null) |
Allow duplicate Autonomous System (AS)
path.
|
| AllowOverrideASEnabled (v1.1+) | boolean | read-write (null) |
Option to override an Autonomous System
(AS) number with the AS number of the sending peer .
|
| AlwaysCompareMEDEnabled (v1.1+) | boolean | read-write (null) |
Compare Multi Exit Discriminator (MED)
status.
|
| ASNumberRange (v1.1+) { | object | (null) |
Autonomous System (AS) number
range.
|
| Lower (v1.1+) | integer | read-write | Lower Autonomous System (AS)
number.
|
| Upper (v1.1+) | integer | read-write | Upper Autonomous System (AS)
number.
|
| } | |||
| BGPLocalPreference (v1.1+) | integer | read-write (null) |
Local preference value.
|
| BGPNeighbor (v1.1+) { | object | (null) |
Border Gateway Protocol (BGP) neighbor
related properties.
|
| Address (v1.1+) | string | read-write (null) |
Border Gateway Protocol (BGP) neighbor
address.
^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$ |
| AllowOwnASEnabled (v1.1+) | boolean | read-write (null) |
Allow own Autonomous System (AS)
status.
|
| CIDR (v1.2+) | integer | read-write | The Classless Inter-Domain Routing (CIDR)
value used for neighbor communication. This is the number of ones before
the first zero in the subnet mask.
|
| ConnectRetrySeconds (v1.1+) | integer | read-write (null) |
Border Gateway Protocol (BGP) retry timer
in seconds.
|
| Enabled (v1.2+) | boolean | read-write | An indication of whether BGP neighbor
communication is enabled.
|
| HoldTimeSeconds (v1.1+) | integer | read-write (null) |
Border Gateway Protocol (BGP) hold timer
in seconds.
|
| KeepaliveIntervalSeconds (v1.1+) | integer | read-write (null) |
Border Gateway Protocol (BGP) Keepalive
timer in seconds.
|
| LocalAS (v1.1+) | integer | read-write (null) |
Local Autonomous System (AS)
number.
|
| LogStateChangesEnabled (v1.1+) | boolean | read-write (null) |
Border Gateway Protocol (BGP) neighbor log
state change status.
|
| MaxPrefix (v1.1+) { | object | (null) |
Border Gateway Protocol (BGP) max prefix
properties.
|
| MaxPrefixNumber (v1.1+) | integer | read-write (null) |
Maximum prefix number.
|
| RestartTimerSeconds (v1.1+) | integer | read-write (null) |
Border Gateway Protocol (BGP) restart
timer in seconds.
|
| ShutdownThresholdPercentage (v1.1+) | number (%) |
read-write (null) |
Shutdown threshold status.
|
| ThresholdWarningOnlyEnabled (v1.1+) | boolean | read-write (null) |
Threshold warning only status.
|
| } | |||
| MinimumAdvertisementIntervalSeconds (v1.1+) | integer | read-write (null) |
Minimum Border Gateway Protocol (BGP)
advertisement interval in seconds.
|
| PassiveModeEnabled (v1.1+) | boolean | read-write (null) |
Border Gateway Protocol (BGP) passive mode
status.
|
| PathMTUDiscoveryEnabled (v1.1+) | boolean | read-write (null) |
Path MTU discovery status.
|
| PeerAS (v1.1+) | integer | read-write (null) |
Peer Autonomous System (AS)
number.
|
| ReplacePeerASEnabled (v1.1+) | boolean | read-write (null) |
Replace Border Gateway Protocol (BGP) peer
Autonomous System (AS) status.
|
| TCPMaxSegmentSizeBytes (v1.1+) | integer | read-write (null) |
TCP max segment size in Bytes.
|
| TreatAsWithdrawEnabled (v1.1+) | boolean | read-write (null) |
Border Gateway Protocol (BGP) treat as
withdraw status.
|
| } | |||
| BGPRoute (v1.1+) { | object | (null) |
Border Gateway Protocol (BGP) route
related properties.
|
| AdvertiseInactiveRoutesEnabled (v1.1+) | boolean | read-write (null) |
Advertise inactive route
status.
|
| DistanceExternal (v1.1+) | integer | read-write (null) |
Route distance for external
routes.
|
| DistanceInternal (v1.1+) | integer | read-write (null) |
Route distance for internal
routes.
|
| DistanceLocal (v1.1+) | integer | read-write (null) |
Route distance for local
routes.
|
| ExternalCompareRouterIdEnabled (v1.1+) | boolean | read-write (null) |
Compare router id status.
|
| FlapDampingEnabled (v1.1+) | boolean | read-write (null) |
Route flap dampening status.
|
| SendDefaultRouteEnabled (v1.1+) | boolean | read-write (null) |
Send default route status.
|
| } | |||
| BGPWeight (v1.1+) | integer | read-write (null) |
BGP weight attribute.
|
| GracefulRestart (v1.1+) { | object | (null) |
Graceful restart related
properties.
|
| GracefulRestartEnabled (v1.1+) | boolean | read-write (null) |
Border Gateway Protocol (BGP) graceful
restart status.
|
| HelperModeEnabled (v1.1+) | boolean | read-write (null) |
Graceful restart helper mode
status.
|
| StaleRoutesTimeSeconds (v1.1+) | integer | read-write (null) |
Stale route timer in seconds.
|
| TimeSeconds (v1.1+) | integer | read-write (null) |
Graceful restart timer in
seconds.
|
| } | |||
| MED (v1.1+) | integer | read-write (null) |
BGP Multi Exit Discriminator (MED)
value.
|
| MultihopEnabled (v1.1+) | boolean | read-write (null) |
External BGP (eBGP) multihop
status.
|
| MultihopTTL (v1.1+) | integer | read-write (null) |
External BGP (eBGP) multihop Time to Live
(TTL) value.
|
| MultiplePaths (v1.1+) { | object | (null) |
Multiple path related
properties.
|
| MaximumPaths (v1.1+) | integer | read-write (null) |
Maximum paths number.
|
| UseMultiplePathsEnabled (v1.1+) | boolean | read-write (null) |
Border Gateway Protocol (BGP) multiple
paths status.
|
| } | |||
| SendCommunityEnabled (v1.1+) | boolean | read-write (null) |
Indicates 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.
^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$ |
| AnycastGatewayMACAddress (v1.1+) | string | read-write (null) |
The anycast gateway MAC
address.
^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$ |
| 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.
^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$ |
| EBGPAddressRange (v1.1+) {} | object | (null) |
External BGP (eBGP) related addressing for
this Ethernet fabric.
|
| FabricLinkAddressRange (v1.1+) {} | object | (null) |
Link related IPv4 addressing for this
Ethernet fabric typically applied to connections between spine and leaf
Ethernet switches.
|
| GatewayIPAddress (v1.1+) | string | read-write (null) |
The gateway IPv4 address.
^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$ |
| HostAddressRange (v1.1+) {} | object | (null) |
IPv4 related host subnet addressing for
physical device endpoints that connect to this Ethernet
fabric.
|
| IBGPAddressRange (v1.1+) {} | object | (null) |
Internal BGP (iBGP) related addressing for
this Ethernet fabric.
|
| LoopbackAddressRange (v1.1+) {} | object | (null) |
Loopback related IPv4 addressing for this
Ethernet fabric.
|
| ManagementAddressRange (v1.1+) {} | object | (null) |
Management related addressing for this
Ethernet fabric.
|
| NativeVLAN (v1.1+) | integer | read-write (null) |
The untagged Virtual LAN (VLAN) ID
value.
|
| NTPOffsetHoursMinutes (v1.1+) | integer | read-write (null) |
The Network Time Protocol (NTP) offset
configuration.
|
| NTPServer (v1.1+) [ ] | array (string, null) | read-write | The Network Time Protocol (NTP) servers
for this Ethernet fabric.
|
| NTPTimezone (v1.1+) | string | read-write (null) |
The Network Time Protocol (NTP) timezone
for this Ethernet fabric.
|
| SystemMACRange (v1.2+) { | object | (null) |
The MAC address range for systems in this
subnet.
|
| Lower (v1.2+) | string | read-write (null) |
The lower system MAC address.
^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$ |
| Upper (v1.2+) | string | read-write (null) |
The upper system MAC address.
^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$ |
| } | |||
| 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.
^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$ |
| AllowOwnASEnabled (v1.1+) | boolean | read-write (null) |
Allow own Autonomous System (AS)
status.
|
| CIDR (v1.2+) | integer | read-write | The Classless Inter-Domain Routing (CIDR)
value used for neighbor communication. This is the number of ones before
the first zero in the subnet mask.
|
| ConnectRetrySeconds (v1.1+) | integer | read-write (null) |
Border Gateway Protocol (BGP) retry timer
in seconds.
|
| Enabled (v1.2+) | boolean | read-write | An indication of whether BGP neighbor
communication is enabled.
|
| HoldTimeSeconds (v1.1+) | integer | read-write (null) |
Border Gateway Protocol (BGP) hold timer
in seconds.
|
| KeepaliveIntervalSeconds (v1.1+) | integer | read-write (null) |
Border Gateway Protocol (BGP) Keepalive
timer in seconds.
|
| LocalAS (v1.1+) | integer | read-write (null) |
Local Autonomous System (AS)
number.
|
| LogStateChangesEnabled (v1.1+) | boolean | read-write (null) |
Border Gateway Protocol (BGP) neighbor log
state change status.
|
| MaxPrefix (v1.1+) { | object | (null) |
Border Gateway Protocol (BGP) max prefix
properties.
|
| MaxPrefixNumber (v1.1+) | integer | read-write (null) |
Maximum prefix number.
|
| RestartTimerSeconds (v1.1+) | integer | read-write (null) |
Border Gateway Protocol (BGP) restart
timer in seconds.
|
| ShutdownThresholdPercentage (v1.1+) | number (%) |
read-write (null) |
Shutdown threshold status.
|
| ThresholdWarningOnlyEnabled (v1.1+) | boolean | read-write (null) |
Threshold warning only status.
|
| } | |||
| MinimumAdvertisementIntervalSeconds (v1.1+) | integer | read-write (null) |
Minimum Border Gateway Protocol (BGP)
advertisement interval in seconds.
|
| PassiveModeEnabled (v1.1+) | boolean | read-write (null) |
Border Gateway Protocol (BGP) passive mode
status.
|
| PathMTUDiscoveryEnabled (v1.1+) | boolean | read-write (null) |
Path MTU discovery status.
|
| PeerAS (v1.1+) | integer | read-write (null) |
Peer Autonomous System (AS)
number.
|
| ReplacePeerASEnabled (v1.1+) | boolean | read-write (null) |
Replace Border Gateway Protocol (BGP) peer
Autonomous System (AS) status.
|
| TCPMaxSegmentSizeBytes (v1.1+) | integer | read-write (null) |
TCP max segment size in Bytes.
|
| TreatAsWithdrawEnabled (v1.1+) | boolean | read-write (null) |
Border Gateway Protocol (BGP) treat as
withdraw status.
|
| } | |||
| BGPRoute (v1.1+) { | object | (null) |
Border Gateway Protocol (BGP) route
related properties.
|
| AdvertiseInactiveRoutesEnabled (v1.1+) | boolean | read-write (null) |
Advertise inactive route
status.
|
| DistanceExternal (v1.1+) | integer | read-write (null) |
Route distance for external
routes.
|
| DistanceInternal (v1.1+) | integer | read-write (null) |
Route distance for internal
routes.
|
| DistanceLocal (v1.1+) | integer | read-write (null) |
Route distance for local
routes.
|
| ExternalCompareRouterIdEnabled (v1.1+) | boolean | read-write (null) |
Compare router id status.
|
| FlapDampingEnabled (v1.1+) | boolean | read-write (null) |
Route flap dampening status.
|
| SendDefaultRouteEnabled (v1.1+) | boolean | read-write (null) |
Send default route status.
|
| } | |||
| BGPWeight (v1.1+) | integer | read-write (null) |
BGP weight attribute.
|
| GracefulRestart (v1.1+) { | object | (null) |
Graceful restart related
properties.
|
| GracefulRestartEnabled (v1.1+) | boolean | read-write (null) |
Border Gateway Protocol (BGP) graceful
restart status.
|
| HelperModeEnabled (v1.1+) | boolean | read-write (null) |
Graceful restart helper mode
status.
|
| StaleRoutesTimeSeconds (v1.1+) | integer | read-write (null) |
Stale route timer in seconds.
|
| TimeSeconds (v1.1+) | integer | read-write (null) |
Graceful restart timer in
seconds.
|
| } | |||
| MED (v1.1+) | integer | read-write (null) |
BGP Multi Exit Discriminator (MED)
value.
|
| MultihopEnabled (v1.1+) | boolean | read-write (null) |
External BGP (eBGP) multihop
status.
|
| MultihopTTL (v1.1+) | integer | read-write (null) |
External BGP (eBGP) multihop Time to Live
(TTL) value.
|
| MultiplePaths (v1.1+) { | object | (null) |
Multiple path related
properties.
|
| MaximumPaths (v1.1+) | integer | read-write (null) |
Maximum paths number.
|
| UseMultiplePathsEnabled (v1.1+) | boolean | read-write (null) |
Border Gateway Protocol (BGP) multiple
paths status.
|
| } | |||
| SendCommunityEnabled (v1.1+) | boolean | read-write (null) |
Indicates 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.
^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$ |
| AllowOwnASEnabled (v1.1+) | boolean | read-write (null) |
Allow own Autonomous System (AS)
status.
|
| CIDR (v1.2+) | integer | read-write | The Classless Inter-Domain Routing (CIDR)
value used for neighbor communication. This is the number of ones before
the first zero in the subnet mask.
|
| ConnectRetrySeconds (v1.1+) | integer | read-write (null) |
Border Gateway Protocol (BGP) retry timer
in seconds.
|
| Enabled (v1.2+) | boolean | read-write | An indication of whether BGP neighbor
communication is enabled.
|
| HoldTimeSeconds (v1.1+) | integer | read-write (null) |
Border Gateway Protocol (BGP) hold timer
in seconds.
|
| KeepaliveIntervalSeconds (v1.1+) | integer | read-write (null) |
Border Gateway Protocol (BGP) Keepalive
timer in seconds.
|
| LocalAS (v1.1+) | integer | read-write (null) |
Local Autonomous System (AS)
number.
|
| LogStateChangesEnabled (v1.1+) | boolean | read-write (null) |
Border Gateway Protocol (BGP) neighbor log
state change status.
|
| MaxPrefix (v1.1+) { | object | (null) |
Border Gateway Protocol (BGP) max prefix
properties.
|
| MaxPrefixNumber (v1.1+) | integer | read-write (null) |
Maximum prefix number.
|
| RestartTimerSeconds (v1.1+) | integer | read-write (null) |
Border Gateway Protocol (BGP) restart
timer in seconds.
|
| ShutdownThresholdPercentage (v1.1+) | number (%) |
read-write (null) |
Shutdown threshold status.
|
| ThresholdWarningOnlyEnabled (v1.1+) | boolean | read-write (null) |
Threshold warning only status.
|
| } | |||
| MinimumAdvertisementIntervalSeconds (v1.1+) | integer | read-write (null) |
Minimum Border Gateway Protocol (BGP)
advertisement interval in seconds.
|
| PassiveModeEnabled (v1.1+) | boolean | read-write (null) |
Border Gateway Protocol (BGP) passive mode
status.
|
| PathMTUDiscoveryEnabled (v1.1+) | boolean | read-write (null) |
Path MTU discovery status.
|
| PeerAS (v1.1+) | integer | read-write (null) |
Peer Autonomous System (AS)
number.
|
| ReplacePeerASEnabled (v1.1+) | boolean | read-write (null) |
Replace Border Gateway Protocol (BGP) peer
Autonomous System (AS) status.
|
| TCPMaxSegmentSizeBytes (v1.1+) | integer | read-write (null) |
TCP max segment size in Bytes.
|
| TreatAsWithdrawEnabled (v1.1+) | boolean | read-write (null) |
Border Gateway Protocol (BGP) treat as
withdraw status.
|
| } | |||
| BGPRoute (v1.1+) { | object | (null) |
Border Gateway Protocol (BGP) route
related properties.
|
| AdvertiseInactiveRoutesEnabled (v1.1+) | boolean | read-write (null) |
Advertise inactive route
status.
|
| DistanceExternal (v1.1+) | integer | read-write (null) |
Route distance for external
routes.
|
| DistanceInternal (v1.1+) | integer | read-write (null) |
Route distance for internal
routes.
|
| DistanceLocal (v1.1+) | integer | read-write (null) |
Route distance for local
routes.
|
| ExternalCompareRouterIdEnabled (v1.1+) | boolean | read-write (null) |
Compare router id status.
|
| FlapDampingEnabled (v1.1+) | boolean | read-write (null) |
Route flap dampening status.
|
| SendDefaultRouteEnabled (v1.1+) | boolean | read-write (null) |
Send default route status.
|
| } | |||
| GracefulRestart (v1.1+) { | object | (null) |
Graceful restart related
properties.
|
| GracefulRestartEnabled (v1.1+) | boolean | read-write (null) |
Border Gateway Protocol (BGP) graceful
restart status.
|
| HelperModeEnabled (v1.1+) | boolean | read-write (null) |
Graceful restart helper mode
status.
|
| StaleRoutesTimeSeconds (v1.1+) | integer | read-write (null) |
Stale route timer in seconds.
|
| TimeSeconds (v1.1+) | integer | read-write (null) |
Graceful restart timer in
seconds.
|
| } | |||
| MultiplePaths (v1.1+) { | object | (null) |
Multiple path related
properties.
|
| MaximumPaths (v1.1+) | integer | read-write (null) |
Maximum paths number.
|
| UseMultiplePathsEnabled (v1.1+) | boolean | read-write (null) |
Border Gateway Protocol (BGP) multiple
paths status.
|
| } | |||
| SendCommunityEnabled (v1.1+) | boolean | read-write (null) |
Indicates 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.
^0[xX]([a-fA-F]|[0-9]){2}$ |
| 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 Using this guide clause. | |
| 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.
|
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.
^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$ |
| Upper (v1.1+) | string | read-write (null) |
Upper IPv4 network address.
^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$ |
6.4.5 Example response
{
"@odata.type": "#AddressPool.v1_2_3.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"
}
]
},
"@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.
- This resource shall represent an aggregation service grouping method for a Redfish implementation.
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.
- This action shall add one or more resources to the aggregate, resulting in that the resources are included in the Elements array of the aggregate.
Action URI
{Base URI of target resource}/Actions/Aggregate.AddElements
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| Elements [ { | array | required | An array of resource links to add to the
Elements array.
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] |
Request Example
{
"Elements": [
{
"@odata.id": "/redfish/v1/Systems/cluster-node7"
},
{
"@odata.id": "node8.intranet.contoso.com/redfish/v1/Systems/1"
}
]
}6.5.4.2 RemoveElements
Description
This action is used to remove one or more resources from the aggregate.
- This action shall remove one or more resources from the aggregate, resulting in that the resources are removed from the Elements array of the aggregate.
Action URI
{Base URI of target resource}/Actions/Aggregate.RemoveElements
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| Elements [ { | array | required | An array of resource links to remove from
the Elements array.
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] |
Request Example
{
"Elements": [
{
"@odata.id": "node8.intranet.contoso.com/redfish/v1/Systems/1"
}
]
}6.5.4.3 Reset
Description
This action is used to reset a collection of resources. For example, this could be an aggregate or a list of computer systems.
- This action shall perform a reset of a collection of resources.
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.
|
Request Example
{
"ResetType": "ForceRestart",
"BatchSize": 5,
"DelayBetweenBatchesInSeconds": 30
}6.5.4.4 SetDefaultBootOrder
Description
This action is used to restore the boot order to the default state for the computer systems that are members of this aggregate.
- This action shall 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.
- This parameter shall contain the type of reset. The service can accept a request without the parameter and perform an implementation-specific default reset.
| string | Description |
|---|---|
| ForceOff | Turn off the unit immediately
(non-graceful shutdown).
|
| ForceOn | Turn on the unit immediately.
|
| ForceRestart | Shut down immediately and non-gracefully
and restart the system.
|
| GracefulRestart | Shut down gracefully and restart the
system.
|
| GracefulShutdown | Shut down gracefully and power
off.
|
| Nmi | Generate a diagnostic interrupt, which is
usually an NMI on x86 systems, to stop normal operations, complete
diagnostic actions, and, typically, halt the system.
|
| On | Turn on the unit.
|
| Pause | Pause execution on the unit but do not
remove power. This is typically a feature of virtual machine
hypervisors.
|
| PowerCycle | Power cycle the unit. Behaves like a full
power removal, followed by a power restore to the resource.
|
| PushPowerButton | Simulate the pressing of the physical
power button on this unit.
|
| Resume | Resume execution on the paused unit. This
is typically a feature of virtual machine hypervisors.
|
| Suspend | Write the state of the unit to disk before
powering off. This allows for the state to be restored when powered back
on.
|
6.5.6 Example response
{
"@odata.type": "#Aggregate.v1_0_1.Aggregate",
"Id": "Aggregate1",
"Name": "Aggregate One",
"ElementsCount": 2,
"Elements": [
{
"@odata.id": "/redfish/v1/Systems/cluster-node3"
},
{
"@odata.id": "/redfish/v1/Systems/cluster-node4"
}
],
"Actions": {
"#Aggregate.Reset": {
"target": "/redfish/v1/AggregationService/Aggregates/Aggregate1/Actions/Aggregate.Reset",
"@Redfish.ActionInfo": "/redfish/v1/AggregationService/Aggregates/Aggregate1/ResetActionInfo"
},
"#Aggregate.SetDefaultBootOrder": {
"target": "/redfish/v1/AggregationService/Aggregates/Aggregate1/Actions/Aggregate.SetDefaultBootOrder",
"@Redfish.ActionInfo": "/redfish/v1/AggregationService/Aggregates/Aggregate1/SetDefaultBootOrderActionInfo"
},
"#Aggregate.AddElements": {
"target": "/redfish/v1/AggregationService/Aggregates/Aggregate1/Actions/Aggregate.AddElements",
"@Redfish.ActionInfo": "/redfish/v1/AggregationService/Aggregates/Aggregate1/AddElementsActionInfo"
},
"#Aggregate.RemoveElements": {
"target": "/redfish/v1/AggregationService/Aggregates/Aggregate1/Actions/Aggregate.RemoveElements",
"@Redfish.ActionInfo": "/redfish/v1/AggregationService/Aggregates/Aggregate1/RemoveElementsActionInfo"
}
},
"@odata.id": "/redfish/v1/AggregationService/Aggregates/Aggregate1"
}6.6 AggregationService 1.0.2
| 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.
- This resource shall represent an aggregation service for a Redfish implementation.
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.
|
|
| @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.
|
|
| @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.
|
|
| @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.
|
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.
- This action shall perform a reset of a set of resources.
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.
|
| TargetURIs [ { | array | required | An array of links to the resources being
reset.
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] |
Request Example
{
"ResetType": "ForceRestart",
"BatchSize": 1,
"DelayBetweenBatchesInSeconds": 30,
"TargetURIs": [
{
"@odata.id": "/redfish/v1/Systems/cluster-node3"
},
{
"@odata.id": "/redfish/v1/Systems/cluster-node4"
},
{
"@odata.id": "node7.intranet.contoso.com/redfish/v1/Systems/1"
}
]
}6.6.4.2 SetDefaultBootOrder
Description
This action is used to restore the boot order to the default state for the specified computer systems.
- This action shall restore the boot order to the default state for the specified computer systems.
Action URI
{Base URI of target resource}/Actions/AggregationService.SetDefaultBootOrder
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| Systems [ { | array | required | The computer systems to
restore.
|
| @odata.id | string | read-only | Link to a ComputerSystem resource. See the Links section and the ComputerSystem schema for details. |
| } ] |
Request Example
{
"Systems": [
{
"@odata.id": "/redfish/v1/Systems/cluster-node3"
},
{
"@odata.id": "/redfish/v1/Systems/cluster-node4"
},
{
"@odata.id": "node7.intranet.contoso.com/redfish/v1/Systems/1"
}
]
}6.6.5 Property details
6.6.5.1 ResetType
The type of reset.
- This parameter shall contain the type of reset. The service can accept a request without the parameter and perform an implementation-specific default reset.
| string | Description |
|---|---|
| ForceOff | Turn off the unit immediately
(non-graceful shutdown).
|
| ForceOn | Turn on the unit immediately.
|
| ForceRestart | Shut down immediately and non-gracefully
and restart the system.
|
| GracefulRestart | Shut down gracefully and restart the
system.
|
| GracefulShutdown | Shut down gracefully and power
off.
|
| Nmi | Generate a diagnostic interrupt, which is
usually an NMI on x86 systems, to stop normal operations, complete
diagnostic actions, and, typically, halt the system.
|
| On | Turn on the unit.
|
| Pause | Pause execution on the unit but do not
remove power. This is typically a feature of virtual machine
hypervisors.
|
| PowerCycle | Power cycle the unit. Behaves like a full
power removal, followed by a power restore to the resource.
|
| PushPowerButton | Simulate the pressing of the physical
power button on this unit.
|
| Resume | Resume execution on the paused unit. This
is typically a feature of virtual machine hypervisors.
|
| Suspend | Write the state of the unit to disk before
powering off. This allows for the state to be restored when powered back
on.
|
6.6.6 Example response
{
"@odata.type": "#AggregationService.v1_0_2.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.3.1
| Version | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2022.3 | 2021.3 | 2020.4 | 2020.2 |
6.7.1 Description
The AggregationSource schema is used to represent the source of information for a subset of the resources provided by a Redfish service. It can be thought of as a provider of information. As such, most such interfaces have requirements to support the gathering of information like address and account used to access the information.
- This resource shall represent an aggregation source for a Redfish implementation.
6.7.2 URIs
/redfish/v1/AggregationService/AggregationSources/{AggregationSourceId}
6.7.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AggregationType (v1.2+) | string (enum) |
read-write | The type of aggregation used towards the
aggregation source.
|
| HostName | string (URI) |
read-write (null) |
The URI of the system to be
accessed.
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| ConnectionMethod { | object | (null) |
An array of links to the connection
methods used to contact this aggregation source.
|
| @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 Using this guide clause. | |
| 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.
(^[ !#-~]+$)|(^Passphrase:[ ^[ !#-~]+$)|(^Hex:[0-9A-Fa-f]{24,96})|(^\*+$) |
| 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.
|
| EncryptionKey (v1.1+) | string | read-write (null) |
The secret authentication key for
SNMPv3.
(^[A-Za-z0-9]+$)|(^\*+$) |
| 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.
|
| TrapCommunity (v1.2+) | string | read-write (null) |
The SNMP trap community
string.
|
| } | |||
| SSHSettings (v1.3+) { | object | (null) |
Settings for an aggregation source using
SSH as part of the associated connection method.
|
| PresentedPublicHostKey (v1.3+) { | object | A link to the last public host key
presented by the remote service corresponding to the aggregation source.
A client that trusts this public host key can add the public host key to
the TrustedPublicHostKeys collection to allow SSH communication with the
aggregation source.
|
|
| @odata.id | string | read-only | Link to a Key resource. See the Links section and the Key schema for details. |
| } | |||
| PresentedPublicHostKeyTimestamp (v1.3+) | string (date-time) |
read-only (null) |
The date and time when the key referenced
by the PresentedPublicHostKey property was last updated.
|
| PublicIdentityKey (v1.3+) { | object | A link to the public key that is used with
the aggregation source when the authentication method is configured to
use a public key. The GenerateSSHIdentityKeyPair and
RemoveSSHIdentityKeyPair are used to update the key for this aggregation
source.
|
|
| @odata.id | string | read-only | Link to a Key resource. See the Links section and the Key schema for details. |
| } | |||
| TrustedPublicHostKeys (v1.3+) { | object | A link to the trusted public host keys of
the remote service corresponding to the aggregation source. These
trusted public host keys are used for authentication of the remote
service with SSH. An SSH public host key of the remote service can be
added to this collection to allow for public key-based SSH
authentication.
|
|
| @odata.id | string | read-only | Link to Collection of Key. See the Key schema for details. |
| } | |||
| UserAuthenticationMethod (v1.3+) | string (enum) |
read-write (null) |
The client user authentication
method.
|
| } | |||
| Status (v1.3+) {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| UserName | string | read-write (null) |
The user name for accessing the
aggregation source.
|
6.7.4 Actions
6.7.4.1 GenerateSSHIdentityKeyPair (v1.3+)
Description
This action generates a new SSH identity key-pair to be used with this aggregation source. The generated public key is stored in the Key resource referenced by the PublicIdentityKey property in SSHSettings. Any existing key-pair is deleted and replace by the new key-pair.
- This action shall generate a new SSH identity key-pair to be used with this aggregation source. The service shall store the generated public key in the Key resource referenced by the PublicIdentityKey property in SSHSettings. If the aggregation source already has an associated SSH identity key-pair, the service shall delete the key-pair and replace it with the new key-pair.
Action URI
{Base URI of target resource}/Actions/AggregationSource.GenerateSSHIdentityKeyPair
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| Curve | string (enum) |
optional | The curve to use with the SSH key if the
KeyType parameter contains ECDSA.
|
| KeyLength | integer | optional | The length of the SSH key, in bits, if the
KeyType parameter contains RSA.
|
| KeyType | string (enum) |
required | The type of SSH key.
|
Request Example
{
"KeyType": "Ed25519"
}6.7.4.2 RemoveSSHIdentityKeyPair (v1.3+)
Description
This action removes the SSH identity key-pair used with this aggregation source.
- This action shall remove the private SSH identity key-pair used with this aggregation source.
Action URI
{Base URI of target resource}/Actions/AggregationSource.RemoveSSHIdentityKeyPair
Action parameters
This action takes no parameters.
6.7.5 Property details
6.7.5.1 AggregationType
The type of aggregation used towards the aggregation source.
- This property shall contain the type of aggregation used
for the connection method towards the aggregation source. If this
property is not present, the value shall be assumed to be
Full.
| string | Description |
|---|---|
| Full | Full aggregation according to connection
method.
|
| NotificationsOnly | Only notifications are
aggregated.
|
6.7.5.2 AuthenticationProtocol
The authentication protocol for SNMPv3.
- This property shall contain the SNMPv3 authentication protocol.
| 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.5.3 Curve
The curve to use with the SSH key if the KeyType parameter contains
ECDSA.
- This parameter shall contain the curve to use
with the SSH key. This parameter shall be required if the KeyType
parameter contains
ECDSAand rejected for other values.
| string | Description |
|---|---|
| NISTB233 | NIST B-233.
|
| NISTB409 | NIST B-409.
|
| NISTK163 | NIST K-163.
|
| NISTK233 | NIST K-233.
|
| NISTK283 | NIST K-283.
|
| NISTK409 | NIST K-409.
|
| NISTP192 | NIST P-192.
|
| NISTP224 | NIST P-224.
|
| NISTP256 | NIST P-256.
|
| NISTP384 | NIST P-384.
|
| NISTP521 | NIST P-521.
|
| NISTT571 | NIST T-571.
|
6.7.5.4 EncryptionProtocol
The encryption protocol for SNMPv3.
- This property shall contain the SNMPv3 encryption protocol.
| string | Description |
|---|---|
| CBC_DES | CBC-DES encryption.
|
| CFB128_AES128 | CFB128-AES-128 encryption.
|
| None | No encryption.
|
6.7.5.5 KeyType
The type of SSH key.
- This parameter shall contain the type of SSH key.
| string | Description |
|---|---|
| DSA | DSA.
|
| ECDSA | ECDSA.
|
| Ed25519 | Ed25519.
|
| RSA | RSA.
|
6.7.5.6 UserAuthenticationMethod
The client user authentication method.
- This property shall contain the client user authentication method.
| string | Description |
|---|---|
| Password | SSH user authentication with a
password.
|
| PublicKey | SSH user authentication with a public
key.
|
6.7.6 Example response
{
"@odata.type": "#AggregationSource.v1_3_1.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"
}
]
},
"@odata.id": "/redfish/v1/AggregationService/AggregationSources/AggregationSource1"
}6.8 AllowDeny 1.0.1
| Version | v1.0 |
| Release | 2021.2 |
6.8.1 Description
The AllowDeny schema represents a set of allow or deny configurations.
- This resource shall represent an AllowDeny resource in a Redfish implementation.
6.8.2 URIs
/redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/NetworkDeviceFunctions/{NetworkDeviceFunctionId}/AllowDeny/{AllowDenyId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/NetworkInterfaces/{NetworkInterfaceId}/NetworkDeviceFunctions/{NetworkDeviceFunctionId}/AllowDeny/{AllowDenyId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/NetworkInterfaces/{NetworkInterfaceId}/NetworkDeviceFunctions/{NetworkDeviceFunctionId}/AllowDeny/{AllowDenyId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/NetworkInterfaces/{NetworkInterfaceId}/NetworkDeviceFunctions/{NetworkDeviceFunctionId}/AllowDeny/{AllowDenyId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/NetworkInterfaces/{NetworkInterfaceId}/NetworkDeviceFunctions/{NetworkDeviceFunctionId}/AllowDeny/{AllowDenyId}
/redfish/v1/Systems/{ComputerSystemId}/NetworkInterfaces/{NetworkInterfaceId}/NetworkDeviceFunctions/{NetworkDeviceFunctionId}/AllowDeny/{AllowDenyId}
6.8.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AllowType | string (enum) |
read-write (null) |
Indicates the type of
permission.
|
| DestinationPortLower | integer | read-write (null) |
The TCP, UDP, or other destination port to
which this rule begins to application, inclusive.
|
| DestinationPortUpper | integer | read-write (null) |
The TCP, UDP, or other destination port to
which this rule ends application, inclusive.
|
| Direction | string (enum) |
read-write (null) |
Indicates the direction of the data to
which this permission applies.
|
| IANAProtocolNumber | integer | read-write (null) |
The IANA protocol number to which this
permission applies. For TCP, this is 6. For UDP, this is
17.
|
| IPAddressLower | string | read-write (null) |
The lower IP address to which this
permission applies.
|
| IPAddressType | string (enum) |
read-write (null) |
The type of IP address populated in the
IPAddressLower and IPAddressUpper properties.
|
| IPAddressUpper | string | read-write (null) |
The upper IP address to which this
permission applies.
|
| SourcePortLower | integer | read-write (null) |
The TCP, UDP, or other source port to
which this rule begins application, inclusive.
|
| SourcePortUpper | integer | read-write (null) |
The TCP, UDP or other source port to which
this rule ends application, inclusive.
|
| StatefulSession | boolean | read-write (null) |
Indicates if this is a permission that
only applies to stateful connection.
|
6.8.4 Property details
6.8.4.1 AllowType
Indicates the type of permission.
- This property shall indicate the type of permission.
| string | Description |
|---|---|
| Allow | Indicates that traffic that matches the criteria in this resource is permitted. |
| Deny | Indicates that traffic that matches the criteria in this resource is not permitted. |
6.8.4.2 Direction
Indicates the direction of the data to which this permission applies.
- This value shall indicate the direction of the data to which this permission applies for this network device function.
| string | Description |
|---|---|
| Egress | Indicates that this limit is enforced on packets and bytes transmitted by the network device function. |
| Ingress | Indicates that this limit is enforced on packets and bytes received by the network device function. |
6.8.4.3 IPAddressType
The type of IP address populated in the IPAddressLower and IPAddressUpper properties.
- This property shall contain the type of IP address populated in the IPAddressLower and IPAddressUpper properties. Services shall not permit mixing IPv6 and IPv4 addresses on the same resource.
| string | Description |
|---|---|
| IPv4 | IPv4 addressing is used for all IP-fields in this object. |
| IPv6 | IPv6 addressing is used for all IP-fields in this object. |
6.8.5 Example response
{
"@odata.type": "#AllowDeny.v1_0_1.AllowDeny",
"Id": "AllowDeny Rule 1",
"Name": "Allow Rule 1",
"Direction": "Ingress",
"AllowType": "Allow",
"StatefulSession": true,
"IPAddressType": "IPv4",
"IPAddressLower": "192.168.1.1",
"IPAddressUpper": "192.168.1.100",
"IANAProtocolNumber": 6,
"SourcePortLower": 5,
"SourcePortUpper": 65535,
"DestinationPortLower": 5,
"DestinationPortUpper": 65535,
"@odata.id": "/redfish/v1/Chassis/Card1/NetworkAdapters/Slot1/NetworkDeviceFunctions/SC2KP1F0/AllowDeny/Rule1"
}6.9 Application 1.0.0
| Version | v1.0 |
| Release | 2023.2 |
6.9.1 Description
The Application schema represents an application or service running on a computer system.
- This resource shall represent an application or service running on a computer system.
6.9.2 URIs
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/OperatingSystem/Applications/{ApplicationId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/OperatingSystem/Applications/{ApplicationId}
/redfish/v1/Systems/{ComputerSystemId}/OperatingSystem/Applications/{ApplicationId}
6.9.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| DestinationURIs [ ] | array (URI) (string, null) |
read-only | The URIs to which this application pushes
data.
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| SoftwareImage { | object | The link to the software image for this
application.
|
|
| @odata.id | string | read-only | Link to a SoftwareInventory resource. See the Links section and the SoftwareInventory schema for details. |
| } | |||
| } | |||
| MetricsURIs [ ] | array (URI) (string, null) |
read-only | The URIs that provide access to data or
other information in this application.
|
| StartTime | string (date-time) |
read-only (null) |
The date and time when the application
started running.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| Vendor | string | read-only (null) |
The vendor of this
application.
|
| Version | string | read-only (null) |
The version of this
application.
|
6.9.4 Actions
6.9.4.1 Reset
Description
This action resets the application.
- This action shall reset the application.
Action URI
{Base URI of target resource}/Actions/Application.Reset
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| ResetType | string (enum) |
optional | The type of reset.
|
Request Example
{
"ResetType": "GracefulRestart"
}6.9.5 Property details
6.9.5.1 ResetType
The type of reset.
- This parameter shall contain the type of
reset.
GracefulRestartandForceRestartshall indicate requests to restart the application.GracefulShutdownandForceOffshall indicate requests to stop or disable the application.OnandForceOnshall indicate requests to start or enable the application. The service can accept a request without the parameter and shall perform aGracefulRestart.
| string | Description |
|---|---|
| ForceOff | Turn off the unit immediately
(non-graceful shutdown).
|
| ForceOn | Turn on the unit immediately.
|
| ForceRestart | Shut down immediately and non-gracefully
and restart the system.
|
| GracefulRestart | Shut down gracefully and restart the
system.
|
| GracefulShutdown | Shut down gracefully and power
off.
|
| Nmi | Generate a diagnostic interrupt, which is
usually an NMI on x86 systems, to stop normal operations, complete
diagnostic actions, and, typically, halt the system.
|
| On | Turn on the unit.
|
| Pause | Pause execution on the unit but do not
remove power. This is typically a feature of virtual machine
hypervisors.
|
| PowerCycle | Power cycle the unit. Behaves like a full
power removal, followed by a power restore to the resource.
|
| PushPowerButton | Simulate the pressing of the physical
power button on this unit.
|
| Resume | Resume execution on the paused unit. This
is typically a feature of virtual machine hypervisors.
|
| Suspend | Write the state of the unit to disk before
powering off. This allows for the state to be restored when powered back
on.
|
6.9.6 Example response
{
"@odata.type": "#Application.v1_0_0.Application",
"Id": "Logger",
"Name": "Logging Agent",
"Version": "1.5.1",
"Vendor": "Contoso",
"StartTime": "2021-10-29T10:42:38+06:00",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"DestinationURIs": [
"https://listeners.contoso.org:8000/handler"
],
"MetricsURIs": [
"https://192.168.0.12:7000"
],
"Actions": {
"#Application.Reset": {
"target": "/redfish/v1/Systems/VM1/OperatingSystem/Applications/Logger/Actions/Application.Reset",
"ResetType@Redfish.AllowableValues": [
"On",
"ForceOff",
"GracefulShutdown",
"GracefulRestart",
"ForceRestart",
"ForceOn"
]
}
},
"@odata.id": "/redfish/v1/Systems/VM1/OperatingSystem/Applications/Logger"
}6.10 Assembly 1.4.0
| Version | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2022.2 | 2020.3 | 2018.2 | 2018.1 | 2017.3 |
6.10.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.
- This Resource shall represent an assembly for a Redfish implementation. 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.10.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}/NetworkAdapters/{NetworkAdapterId}/Processors/{ProcessorId}/Assembly
/redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/Assembly
/redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors/{ProcessorId3}/Assembly
/redfish/v1/Chassis/{ChassisId}/PCIeDevices/{PCIeDeviceId}/Assembly
/redfish/v1/Chassis/{ChassisId}/Power/PowerSupplies/{PowerSupplyId}/Assembly
/redfish/v1/Chassis/{ChassisId}/PowerSubsystem/Batteries/{BatteryId}/Assembly
/redfish/v1/Chassis/{ChassisId}/PowerSubsystem/PowerSupplies/{PowerSupplyId}/Assembly
/redfish/v1/Chassis/{ChassisId}/Thermal/Fans/{FanId}/Assembly
/redfish/v1/Chassis/{ChassisId}/ThermalSubsystem/Fans/{FanId}/Assembly
/redfish/v1/Chassis/{ChassisId}/ThermalSubsystem/Heaters/{HeaderId}/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}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors/{ProcessorId3}/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}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors/{ProcessorId3}/Assembly
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Controllers/{StorageControllerId}/Assembly
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Drives/{DriveId}/Assembly
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Assembly
/redfish/v1/PowerEquipment/PowerShelves/{PowerDistributionId}/PowerSupplies/{PowerSupplyId}/Assembly
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Drives/{DriveId}/Assembly
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Memory/{MemoryId}/Assembly
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/Assembly
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/Assembly
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors/{ProcessorId3}/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}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors/{ProcessorId3}/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}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors/{ProcessorId3}/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
/redfish/v1/ThermalEquipment/CDUs/{CoolingUnitId}/Assembly
/redfish/v1/ThermalEquipment/CDUs/{CoolingUnitId}/Filters/{FilterId}/Assembly
/redfish/v1/ThermalEquipment/CDUs/{CoolingUnitId}/Pumps/{PumpId}/Assembly
/redfish/v1/ThermalEquipment/CDUs/{CoolingUnitId}/Pumps/{PumpId}/Filters/{FilterId}/Assembly
/redfish/v1/ThermalEquipment/CDUs/{CoolingUnitId}/Reservoirs/{ReservoirId}/Assembly
/redfish/v1/ThermalEquipment/CDUs/{CoolingUnitId}/Reservoirs/{ReservoirId}/Filters/{FilterId}/Assembly
/redfish/v1/ThermalEquipment/HeatExchangers/{CoolingUnitId}/Assembly
/redfish/v1/ThermalEquipment/HeatExchangers/{CoolingUnitId}/Filters/{FilterId}/Assembly
/redfish/v1/ThermalEquipment/HeatExchangers/{CoolingUnitId}/Pumps/{PumpId}/Assembly
/redfish/v1/ThermalEquipment/HeatExchangers/{CoolingUnitId}/Pumps/{PumpId}/Filters/{FilterId}/Assembly
/redfish/v1/ThermalEquipment/HeatExchangers/{CoolingUnitId}/Reservoirs/{ReservoirId}/Assembly
/redfish/v1/ThermalEquipment/HeatExchangers/{CoolingUnitId}/Reservoirs/{ReservoirId}/Filters/{FilterId}/Assembly
/redfish/v1/ThermalEquipment/ImmersionUnits/{CoolingUnitId}/Assembly
/redfish/v1/ThermalEquipment/ImmersionUnits/{CoolingUnitId}/Filters/{FilterId}/Assembly
/redfish/v1/ThermalEquipment/ImmersionUnits/{CoolingUnitId}/Pumps/{PumpId}/Assembly
/redfish/v1/ThermalEquipment/ImmersionUnits/{CoolingUnitId}/Pumps/{PumpId}/Filters/{FilterId}/Assembly
/redfish/v1/ThermalEquipment/ImmersionUnits/{CoolingUnitId}/Reservoirs/{ReservoirId}/Assembly
/redfish/v1/ThermalEquipment/ImmersionUnits/{CoolingUnitId}/Reservoirs/{ReservoirId}/Filters/{FilterId}/Assembly
6.10.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.
|
|
| LocationIndicatorActive (v1.3+) | boolean | read-write (null) |
An indicator allowing an operator to
physically locate this resource.
|
| MemberId | string | read-only required | The unique identifier for the member
within an array.
|
| 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 Using this guide clause. | |
| 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.
|
| 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.
|
| Replaceable (v1.4+) | boolean | read-only (null) |
An indication of whether the component
associated this assembly can be independently replaced as allowed by the
vendor's replacement policy.
|
| 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.
|
|
| Vendor | string | read-only (null) |
The vendor of the assembly.
|
| Version | string | read-only (null) |
The hardware version of the
assembly.
|
| } ] |
6.10.4 Property details
6.10.4.1 PhysicalContext
The area or device to which the assembly data applies.
- This property shall contain a description of the physical context for the assembly data.
| string | Description |
|---|---|
| Accelerator | An accelerator. |
| ACInput | An AC input. |
| ACMaintenanceBypassInput | An AC maintenance bypass input. |
| ACOutput | An AC output. |
| ACStaticBypassInput | An AC static bypass input. |
| ACUtilityInput | An AC utility input. |
| ASIC | An ASIC device, such as a networking chip or chipset component. |
| Back | The back of the chassis. |
| Backplane | A backplane within the chassis. |
| Battery | A battery. |
| Board | A circuit board.
|
| Chassis | The entire chassis. |
| ComputeBay | Within a compute bay. |
| CoolingSubsystem | The entire cooling, or air and liquid, subsystem. |
| CPU | A processor (CPU). |
| CPUSubsystem | The entire processor (CPU) subsystem. |
| DCBus | A DC bus. |
| Exhaust | The air exhaust point or points or region of the chassis. |
| ExpansionBay | Within an expansion bay. |
| Fan | A fan. |
| FPGA | An FPGA. |
| Front | The front of the chassis. |
| GPU | A graphics processor (GPU). |
| GPUSubsystem | The entire graphics processor (GPU) subsystem. |
| Intake | The air intake point or points or region of the chassis. |
| LiquidInlet | The liquid inlet point of the chassis. |
| LiquidOutlet | The liquid outlet point of the chassis. |
| Lower | The lower portion of the chassis. |
| Memory | A memory device. |
| MemorySubsystem | The entire memory subsystem. |
| Motor | A motor. |
| NetworkBay | Within a networking bay. |
| NetworkingDevice | A networking device. |
| PowerSubsystem | The entire power subsystem. |
| PowerSupply | A power supply. |
| PowerSupplyBay | Within a power supply bay. |
| Pump | A pump. |
| Rectifier | A rectifier device. |
| Room | The room. |
| StorageBay | Within a storage bay. |
| StorageDevice | A storage device. |
| SystemBoard | The system board (PCB). |
| Transceiver | A transceiver.
|
| Transformer | A transformer. |
| TrustedModule | A trusted module. |
| Upper | The upper portion of the chassis. |
| VoltageRegulator | A voltage regulator device. |
6.10.5 Example response
{
"@odata.type": "#Assembly.v1_4_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.11 AttributeRegistry 1.3.7
| Version | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2018.3 | 2018.1 | 2017.1 | 2016.1 |
6.11.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.
- This resource shall represent an attribute registry for a Redfish implementation.
6.11.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.
^[A-Za-z][A-Za-z0-9_]+$ |
| 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 cannot 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 Using this guide clause. | |
| 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.
|
| 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.
^[A-Za-z][A-Za-z0-9_]+$ |
| MapFromCondition | string (enum) |
read-only | The condition to use to evaluate this
dependency expression.
|
| MapFromProperty | string (enum) |
read-only | The metadata property for the attribute
that the MapFromAttribute property specifies to use to evaluate this
dependency expression.
|
| 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.
|
| } ] | |||
| MapToAttribute | string | read-only | The AttributeName of the attribute that is
affected by this dependency expression.
^[A-Za-z][A-Za-z0-9_]+$ |
| MapToProperty | string (enum) |
read-only | The metadata property for the attribute
that contains the map-from condition that evaluates this dependency
expression.
|
| 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.
^[A-Za-z][A-Za-z0-9_]+$ |
| Type | string (enum) |
read-only | The type of the dependency
structure.
|
| } ] | |||
| 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 Using this guide clause. | |
| 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.
^\d+\.\d+\.\d+$ |
| 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.
^[A-Za-z0-9]+$ |
| } ] |
6.11.3 Property details
6.11.3.1 MapFromCondition
The condition to use to evaluate this dependency expression.
- This property shall contain the condition to use to
evaluate this dependency expression. For example,
EQUorNEQ.
| 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.11.3.2 MapFromProperty
The metadata property for the attribute that the MapFromAttribute property specifies to use to evaluate this dependency expression.
- This property shall contain the metadata property for the attribute that the MapFromAttribute property specifies to use to evaluate this dependency expression. For example, this value could be the MapFromAttribute CurrentValue, or ReadOnly state.
| 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.11.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.
- This property shall
contain the logical term that combines two or more MapFrom conditions in
this dependency expression. For example,
ANDfor logical AND, orORfor logical OR. If multiple logical terms are present in a dependency expression, they should be evaluated in array order, meaning they are evaluated left-to-right when displayed as a logic expression.
| string | Description |
|---|---|
| AND | The operation used for logical 'AND' of dependency terms. |
| OR | The operation used for logical 'OR' of dependency terms. |
6.11.3.4 MapToProperty
The metadata property for the attribute that contains the map-from condition that evaluates this dependency expression.
- This property shall contain the metadata property for the attribute that the MapFromAttribute property specifies that evaluates this dependency expression. For example, this value could be the MapFromAttribute CurrentValue or ReadOnly state.
| 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.11.3.5 Type
6.11.3.5.1 In RegistryEntries: Attributes:
The attribute type.
- This property shall contain an enumeration that describes 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 is null in responses. |
| String | Free-form text in their values. |
6.11.3.5.2 In RegistryEntries: Dependencies:
The type of the dependency structure.
- This property shall contain an enumeration that describes the type for the attribute dependency.
| string | Description |
|---|---|
| Map | A simple mapping dependency. If the
condition evaluates to true, the attribute or state changes
to the mapped value. |
6.11.4 Example response
{
"@odata.type": "#AttributeRegistry.v1_3_7.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.12 Battery 1.2.1
| Version | v1.2 | v1.1 |
| Release | 2022.2 | 2021.2 |
6.12.1 Description
The Battery schema describes a battery unit, such as those used to provide systems with power during a power loss event. It also describes the location, such as a slot, socket, or bay, where a unit can be installed, by populating a resource instance with an absent state if a unit is not present.
- This resource shall represent a battery for
a Redfish implementation. It may also represent a location, such as a
slot, socket, or bay, where a unit may be installed, but the State
property within the Status property contains
Absent.
6.12.2 URIs
/redfish/v1/Chassis/{ChassisId}/PowerSubsystem/Batteries/{BatteryId}
6.12.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Assembly { | object | The link to the assembly associated with
this battery.
|
|
| @odata.id | string | read-only | Link to a Assembly resource. See the Links section and the Assembly schema for details. |
| } | |||
| CapacityActualAmpHours | number (A.h) |
read-only (null) |
The actual maximum capacity of this
battery in amp-hours.
|
| CapacityActualWattHours | number (W.h) |
read-only (null) |
The actual maximum capacity of this
battery in watt-hours.
|
| CapacityRatedAmpHours | number (A.h) |
read-only (null) |
The rated maximum capacity of this battery
in amp-hours.
|
| CapacityRatedWattHours | number (W.h) |
read-only (null) |
The rated maximum capacity of this battery
in watt-hours.
|
| ChargeState | string (enum) |
read-only (null) |
The charge state of this
battery.
|
| FirmwareVersion | string | read-only (null) |
The firmware version for this
battery.
|
| HotPluggable | boolean | read-only (null) |
An indication of whether this device can
be inserted or removed while the equipment is in operation.
|
| Links (v1.1+) { | object | The links to other resources that are
related to this resource.
|
|
| Memory (v1.1+) [ { | array | An array of links to the memory devices to
which this battery provides power during a power loss event.
|
|
| @odata.id | string | read-only | Link to a Memory resource. See the Links section and the Memory schema for details. |
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| StorageControllers (v1.1+) [ { | array | An array of links to the storage
controllers to which this battery provides power during a power loss
event.
|
|
| @odata.id | string | read-only | Link to a StorageController resource. See the Links section and the StorageController schema for details. |
| } ] | |||
| } | |||
| Location {} | object | The location of the battery.
|
|
| LocationIndicatorActive | boolean | read-write (null) |
An indicator allowing an operator to
physically locate this resource.
|
| Manufacturer | string | read-only (null) |
The manufacturer of this
battery.
|
| MaxChargeRateAmps | number (A) |
read-only (null) |
The maximum charge rate of this battery in
amps.
|
| MaxChargeVoltage | number (Volts) |
read-only (null) |
The maximum charge voltage of this
battery.
|
| MaxDischargeRateAmps | number (A) |
read-only (null) |
The maximum discharge rate of this battery
in amps.
|
| Metrics { | object | The link to the battery metrics resource
associated with this battery.
|
|
| @odata.id | string | read-only | Link to a BatteryMetrics resource. See the Links section and the BatteryMetrics schema for details. |
| } | |||
| Model | string | read-only (null) |
The model number for this
battery.
|
| PartNumber | string | read-only (null) |
The part number for this
battery.
|
| ProductionDate | string (date-time) |
read-only (null) |
The production or manufacturing date of
this battery.
|
| Replaceable (v1.2+) | boolean | read-only (null) |
An indication of whether this component
can be independently replaced as allowed by the vendor's replacement
policy.
|
| SerialNumber | string | read-only (null) |
The serial number for this
battery.
|
| SparePartNumber | string | read-only (null) |
The spare part number for this
battery.
|
| StateOfHealthPercent { | object (excerpt) |
The state of health (percent) of this
battery.
|
|
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| Reading | number | read-only (null) |
The sensor value.
|
| } | |||
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| Version | string | read-only (null) |
The hardware version of this
battery.
|
6.12.4 Actions
6.12.4.1 Calibrate
Description
This action performs a self-calibration, or learn cycle, of the battery.
- This action shall perform a self-calibration, or learn cycle, of the battery.
Action URI
{Base URI of target resource}/Actions/Battery.Calibrate
Action parameters
This action takes no parameters.
6.12.4.2 Reset
Description
This action resets the battery.
- This action shall reset the battery.
Action URI
{Base URI of target resource}/Actions/Battery.Reset
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| ResetType | string (enum) |
optional | The type of reset.
|
Request Example
{
"ResetType": "PowerCycle"
}6.12.4.3 SelfTest
Description
This action performs a self-test of the battery.
- This action shall perform a self-test of the battery.
Action URI
{Base URI of target resource}/Actions/Battery.SelfTest
Action parameters
This action takes no parameters.
6.12.5 Property details
6.12.5.1 ChargeState
The charge state of this battery.
- This property shall contain the charge state of this battery.
| string | Description |
|---|---|
| Charging | The battery is charging.
|
| Discharging | The battery is discharging.
|
| Idle | The battery is idle.
|
6.12.5.2 ResetType
The type of reset.
- This parameter shall contain the type of
reset. The service can accept a request without the parameter and shall
perform a
GracefulRestart.
| string | Description |
|---|---|
| ForceOff | Turn off the unit immediately
(non-graceful shutdown).
|
| ForceOn | Turn on the unit immediately.
|
| ForceRestart | Shut down immediately and non-gracefully
and restart the system.
|
| GracefulRestart | Shut down gracefully and restart the
system.
|
| GracefulShutdown | Shut down gracefully and power
off.
|
| Nmi | Generate a diagnostic interrupt, which is
usually an NMI on x86 systems, to stop normal operations, complete
diagnostic actions, and, typically, halt the system.
|
| On | Turn on the unit.
|
| Pause | Pause execution on the unit but do not
remove power. This is typically a feature of virtual machine
hypervisors.
|
| PowerCycle | Power cycle the unit. Behaves like a full
power removal, followed by a power restore to the resource.
|
| PushPowerButton | Simulate the pressing of the physical
power button on this unit.
|
| Resume | Resume execution on the paused unit. This
is typically a feature of virtual machine hypervisors.
|
| Suspend | Write the state of the unit to disk before
powering off. This allows for the state to be restored when powered back
on.
|
6.12.6 Example response
{
"@odata.type": "#Battery.v1_2_1.Battery",
"Id": "Module1",
"Name": "Battery 1",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Actions": {
"#Battery.SelfTest": {
"target": "/redfish/v1/Chassis/1U/PowerSubsystem/Batteries/Module1/Actions/Battery.SelfTest"
},
"#Battery.Calibrate": {
"target": "/redfish/v1/Chassis/1U/PowerSubsystem/Batteries/Module1/Actions/Battery.Calibrate"
}
},
"Location": {
"PartLocation": {
"ServiceLabel": "Battery 1",
"LocationType": "Bay",
"LocationOrdinalValue": 0
}
},
"Model": "RKS-440DC",
"Manufacturer": "Contoso Power",
"FirmwareVersion": "1.00",
"Version": "A05",
"ProductionDate": "2019-10-01T06:00:00Z",
"SerialNumber": "3488247",
"PartNumber": "23456-133",
"SparePartNumber": "93284-133",
"LocationIndicatorActive": false,
"HotPluggable": true,
"CapacityRatedWattHours": 20,
"CapacityActualWattHours": 19.41,
"MaxDischargeRateAmps": 10,
"StateOfHealthPercent": {
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/Battery1StateOfHealth",
"Reading": 91
},
"ChargeState": "Idle",
"Metrics": {
"@odata.id": "/redfish/v1/Chassis/1U/PowerSubsystem/Batteries/Module1/Metrics"
},
"@odata.id": "/redfish/v1/Chassis/1U/PowerSubsystem/Batteries/Module1"
}6.13 BatteryMetrics 1.0.2
| Version | v1.0 |
| Release | 2021.2 |
6.13.1 Description
The BatteryMetrics schema contains definitions for the metrics of a battery unit.
- This resource shall be used to represent the metrics of a battery unit for a Redfish implementation.
6.13.2 URIs
/redfish/v1/Chassis/{ChassisId}/PowerSubsystem/Batteries/{BatteryId}/Metrics
6.13.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| CellVoltages [ { | array (excerpt) |
The cell voltages (V) for this
battery.
|
|
| 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 percent (%
THD).
|
| } ] | |||
| ChargePercent {} | object | The amount of charge available (percent)
in this battery.
|
|
| DischargeCycles | number | read-only (null) |
The number of discharges this battery
sustained.
|
| InputCurrentAmps { | object (excerpt) |
The input current (A) for this
battery.
|
|
| 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 percent (%
THD).
|
| } | |||
| InputVoltage { | object (excerpt) |
The input voltage (V) for this
battery.
|
|
| 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 percent (%
THD).
|
| } | |||
| OutputCurrentAmps [ { | array (excerpt) |
The output currents (A) for this
battery.
|
|
| 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 percent (%
THD).
|
| } ] | |||
| OutputVoltages [ { | array (excerpt) |
The output voltages (V) for this
battery.
|
|
| 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 percent (%
THD).
|
| } ] | |||
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| StoredChargeAmpHours {} | object | The charge (Ah) stored in this
battery.
|
|
| StoredEnergyWattHours {} | object | The energy (Wh) stored in this
battery.
|
|
| TemperatureCelsius {} | object | The temperature (C) for this
battery.
|
6.13.4 Property details
6.13.4.1 SensorExcerpt
The Sensor schema describes a sensor and its properties. This object is an excerpt of the Sensor resource located at the URI shown in DataSourceUri.
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| Reading | number | read-only (null) |
The sensor value.
|
6.13.5 Example response
{
"@odata.type": "#BatteryMetrics.v1_0_2.BatteryMetrics",
"Id": "Metrics",
"Name": "Metrics for Battery 1",
"DischargeCycles": 8.67,
"InputVoltage": {
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/Battery1InputVoltage",
"Reading": 12.22
},
"InputCurrentAmps": {
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/Battery1InputCurrent",
"Reading": 0
},
"OutputVoltages": [
{
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/Battery1OutputVoltage",
"Reading": 12.22
}
],
"OutputCurrentAmps": [
{
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/Battery1OutputCurrent",
"Reading": 0
}
],
"StoredEnergyWattHours": {
"Reading": 19.41
},
"TemperatureCelsius": {
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/Battery1Temp",
"Reading": 33
},
"ChargePercent": {
"Reading": 100
},
"CellVoltages": [
{
"Reading": 3.44
},
{
"Reading": 3.45
},
{
"Reading": 3.43
},
{
"Reading": 3.43
},
{
"Reading": 3.45
},
{
"Reading": 3.44
},
{
"Reading": 3.43
},
{
"Reading": 3.44
}
],
"@odata.id": "/redfish/v1/Chassis/1U/PowerSubsystem/Batteries/Module1/Metrics"
}6.14 Bios 1.2.1
| Version | v1.2 | v1.1 | v1.0 |
| Release | 2021.1 | 2019.2 | 2016.1 |
6.14.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.
- This resource shall represent BIOS attributes for a Redfish implementation.
6.14.2 URIs
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Bios
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Bios
/redfish/v1/Systems/{ComputerSystemId}/Bios
6.14.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.
|
|
| @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 Using this guide clause. | |
| 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.14.4 Actions
6.14.4.1 ChangePassword
Description
This action changes a BIOS password.
- This action shall change the selected 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.14.4.2 ResetBios
Description
This action resets the BIOS attributes to default.
- This action shall reset the BIOS attributes to their default values. To apply the default values, a system reset may be required. This action can impact other resources. This action may clear pending values in the settings resource.
Action URI
{Base URI of target resource}/Actions/Bios.ResetBios
Action parameters
This action takes no parameters.
6.14.5 Example response
{
"@odata.type": "#Bios.v1_2_1.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_5.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.15 BootOption 1.0.5
| Version | v1.0 |
| Release | 2017.3 |
6.15.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.
- This resource shall represent a single boot option within a system.
6.15.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.15.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Alias | string (enum) |
read-only (null) |
The alias of this boot source.
|
| 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 influences 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.15.4 Property details
6.15.4.1 Alias
The alias of this boot source.
- This property shall contain the string alias of this boot source that describes the type of boot.
| 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. |
| Recovery | Boot to a system-designated recovery process or image. |
| 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.15.5 Example response
{
"@odata.type": "#BootOption.v1_0_5.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"
}
],
"@odata.id": "/redfish/v1/Systems/1/BootOptions/1"
}6.16 Cable 1.2.1
| Version | v1.2 | v1.1 | v1.0 |
| Release | 2021.4 | 2021.3 | 2021.2 |
6.16.1 Description
The Cable schema contains properties that describe a cable connecting endpoints of a chassis, port, or any other cable-compatible endpoint.
- This resource contains a simple cable for a Redfish implementation.
6.16.2 URIs
/redfish/v1/Cables/{CableId}
6.16.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Assembly { | object | The link to the assembly associated with
this cable.
|
|
| @odata.id | string | read-only | Link to a Assembly resource. See the Links section and the Assembly schema for details. |
| } | |||
| AssetTag | string | read-write (null) |
The user-assigned asset tag for this
cable.
|
| CableClass | string (enum) |
read-write (null) |
The identifier for the downstream
resource.
|
| CableStatus | string (enum) |
read-write | The user-reported status of this
resource.
|
| CableType | string | read-write (null) |
The type of this cable.
|
| DownstreamConnectorTypes [ ] | array (string (enum)) |
read-write |
|
| DownstreamName | string | read-write (null) |
The identifier for the downstream
resource.
|
| LengthMeters | number | read-write (null) |
The length of the cable in
meters.
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| DownstreamChassis [ { | array | An array of links to the downstream
chassis connected to this cable.
|
|
| @odata.id | string | read-write | Link to a Chassis resource. See the Links section and the Chassis schema for details. |
| } ] | |||
| DownstreamPorts [ { | array | An array of links to the downstream ports
connected to this cable.
|
|
| @odata.id | string | read-write | Link to a Port resource. See the Links section and the Port schema for details. |
| } ] | |||
| DownstreamResources [ { | array | An array of links to the downstream
resources connected to this cable.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| UpstreamChassis [ { | array | An array of links to the upstream chassis
connected to this cable.
|
|
| @odata.id | string | read-write | Link to a Chassis resource. See the Links section and the Chassis schema for details. |
| } ] | |||
| UpstreamPorts [ { | array | An array of links to the upstream ports
connected to this cable.
|
|
| @odata.id | string | read-write | Link to a Port resource. See the Links section and the Port schema for details. |
| } ] | |||
| UpstreamResources [ { | array | An array of links to the upstream
resources connected to this cable.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| } | |||
| Location {} | object | The location of the assembly.
|
|
| Manufacturer | string | read-write (null) |
The manufacturer of this
cable.
|
| Model | string | read-write (null) |
The model number of the cable.
|
| PartNumber | string | read-write (null) |
The part number for this
cable.
|
| SerialNumber | string | read-write (null) |
The serial number for this
cable.
|
| SKU | string | read-write (null) |
The SKU for this cable.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| UpstreamConnectorTypes [ ] | array (string (enum)) |
read-write |
|
| UpstreamName | string | read-write (null) |
The identifier for the downstream
resource.
|
| UserDescription | string | read-write (null) |
The description of this cable.
|
| UserLabel (v1.1+) | string | read-write | A user-assigned label.
|
| Vendor | string | read-write (null) |
The manufacturer of this
cable.
|
6.16.4 Property details
6.16.4.1 CableClass
The identifier for the downstream resource.
- The property shall contain the cable class for this cable.
| string | Description |
|---|---|
| Fabric | This cable is used for connecting to a fabric. |
| Fan | This cable is used for connecting to a fan system. |
| General | This cable is used for providing general connectivity. |
| Network | This cable is used for connecting to a networking system. |
| PCIe | This cable is used for connecting to a PCIe endpoint. |
| Power | This cable is used for connecting to a power system. |
| Serial | This cable is used for connecting to a serial endpoint. |
| Storage | This cable is used for connecting to a storage system. |
| USB | This cable is used for connecting to a USB endpoint. |
| Video | This cable is used for connecting to a video system. |
6.16.4.2 CableStatus
The user-reported status of this resource.
- This property shall contain the user-reported status of this resource.
| string | Description |
|---|---|
| Degraded | The cable is degraded.
|
| Disabled | The cable is disabled.
|
| Failed | The cable has failed.
|
| Normal | The cable is operating
normally.
|
| SetByService | The cable status is set by the
service.
|
| Testing | The cable is under test.
|
6.16.4.3 DownstreamConnectorTypes
- The connector types this cable supports.
- The property shall contain an array of connector types this cable supports.
| string | Description |
|---|---|
| ACPower | This cable connects to a AC power connector. |
| CDFP | This cable connects to a CDFP connector. |
| DB9 | This cable connects to a DB9 connector. |
| DCPower | This cable connects to a DC power connector. |
| DisplayPort | This cable connects to a DisplayPort power connector. |
| HDMI | This cable connects to an HDMI connector. |
| ICI | This cable connects to an ICI connector. |
| IPASS | This cable connects to an IPASS connector. |
| OSFP | This cable connects to a OSFP connector. |
| PCIe | This cable connects to a PCIe connector. |
| Proprietary | This cable connects to a proprietary connector. |
| QSFP | This cable connects to a QSFP connector. |
| RJ45 | This cable connects to an RJ45 connector. |
| SATA | This cable connects to a SATA connector. |
| SCSI | This cable connects to a SCSI connector. |
| SFP | This cable connects to a SFP connector. |
| SFPPlus | This cable connects to a SFPPlus connector. |
| SlimSAS | This cable connects to a SlimSAS connector. |
| USBA | This cable connects to a USB-A connector. |
| USBC | This cable connects to a USB-C connector. |
6.16.4.4 UpstreamConnectorTypes
- The connector types this cable supports.
- The property shall contain an array of connector types this cable supports.
| string | Description |
|---|---|
| ACPower | This cable connects to a AC power connector. |
| CDFP | This cable connects to a CDFP connector. |
| DB9 | This cable connects to a DB9 connector. |
| DCPower | This cable connects to a DC power connector. |
| DisplayPort | This cable connects to a DisplayPort power connector. |
| HDMI | This cable connects to an HDMI connector. |
| ICI | This cable connects to an ICI connector. |
| IPASS | This cable connects to an IPASS connector. |
| OSFP | This cable connects to a OSFP connector. |
| PCIe | This cable connects to a PCIe connector. |
| Proprietary | This cable connects to a proprietary connector. |
| QSFP | This cable connects to a QSFP connector. |
| RJ45 | This cable connects to an RJ45 connector. |
| SATA | This cable connects to a SATA connector. |
| SCSI | This cable connects to a SCSI connector. |
| SFP | This cable connects to a SFP connector. |
| SFPPlus | This cable connects to a SFPPlus connector. |
| SlimSAS | This cable connects to a SlimSAS connector. |
| USBA | This cable connects to a USB-A connector. |
| USBC | This cable connects to a USB-C connector. |
6.16.5 Example response
{
"@odata.type": "#Cable.v1_2_1.Cable",
"Id": "hdmi_dp",
"Name": "HDMI to DP Cable",
"UserDescription": "HDMI to DisplayPort Cable",
"UpstreamName": "HDMI0",
"DownstreamName": "Video Out",
"CableType": "HDMI",
"LengthMeters": 0.1,
"CableClass": "Video",
"UpstreamConnectorTypes": [
"HDMI"
],
"DownstreamConnectorTypes": [
"DisplayPort"
],
"Links": {
"UpstreamChassis": [
{
"@odata.id": "/redfish/v1/Chassis/bmc"
}
]
},
"PartNumber": "934AMS02X",
"Manufacturer": "Cable Co.",
"SerialNumber": "2345791",
"Vendor": "Cablestore",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"CableStatus": "Normal",
"@odata.id": "/redfish/v1/Cables/hdmi_dp"
}6.17 Certificate 1.8.0
| Version | v1.8 | v1.7 | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2023.2 | 2023.1 | 2022.1 | 2021.3 | 2021.2 | 2021.1 | 2020.1 | 2019.1 | 2018.3 |
6.17.1 Description
The Certificate schema describes a certificate that proves the identify of a component, account, or service.
- This resource shall represent a certificate for a Redfish implementation.
6.17.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/AccountService/MultiFactorAuth/ClientCertificate/Certificates/{CertificateId}
/redfish/v1/AccountService/MultiFactorAuth/SecurID/Certificates/{CertificateId}
/redfish/v1/AccountService/OutboundConnections/{OutboundConnectionId}/Certificates/{CertificateId}
/redfish/v1/AccountService/OutboundConnections/{OutboundConnectionId}/ClientCertificates/{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/Chassis/{ChassisId}/TrustedComponents/{TrustedComponentId}/Certificates/{CertificateId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Drives/{DriveId}/Certificates/{CertificateId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Memory/{MemoryId}/Certificates/{CertificateId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/Certificates/{CertificateId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Controllers/{StorageControllerId}/Certificates/{CertificateId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Drives/{DriveId}/Certificates/{CertificateId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Certificates/{CertificateId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Boot/Certificates/{CertificateId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Certificates/{CertificateId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/KeyManagement/KMIPCertificates/{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/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/VirtualMedia/{VirtualMediaId}/ClientCertificates/{CertificateId}
/redfish/v1/EventService/Subscriptions/{EventDestinationId}/Certificates/{CertificateId}
/redfish/v1/EventService/Subscriptions/{EventDestinationId}/ClientCertificates/{CertificateId}
/redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Certificates/{CertificateId}
/redfish/v1/Managers/{ManagerId}/Certificates/{CertificateId}
/redfish/v1/Managers/{ManagerId}/NetworkProtocol/HTTPS/Certificates/{CertificateId}
/redfish/v1/Managers/{ManagerId}/RemoteAccountService/Accounts/{ManagerAccountId}/Certificates/{CertificateId}
/redfish/v1/Managers/{ManagerId}/RemoteAccountService/ActiveDirectory/Certificates/{CertificateId}
/redfish/v1/Managers/{ManagerId}/RemoteAccountService/ExternalAccountProviders/{ExternalAccountProviderId}/Certificates/{CertificateId}
/redfish/v1/Managers/{ManagerId}/RemoteAccountService/LDAP/Certificates/{CertificateId}
/redfish/v1/Managers/{ManagerId}/RemoteAccountService/MultiFactorAuth/ClientCertificate/Certificates/{CertificateId}
/redfish/v1/Managers/{ManagerId}/RemoteAccountService/MultiFactorAuth/SecurID/Certificates/{CertificateId}
/redfish/v1/Managers/{ManagerId}/SecurityPolicy/SPDM/RevokedCertificates/{CertificateId}
/redfish/v1/Managers/{ManagerId}/SecurityPolicy/SPDM/TrustedCertificates/{CertificateId}
/redfish/v1/Managers/{ManagerId}/SecurityPolicy/TLS/Client/RevokedCertificates/{CertificateId}
/redfish/v1/Managers/{ManagerId}/SecurityPolicy/TLS/Client/TrustedCertificates/{CertificateId}
/redfish/v1/Managers/{ManagerId}/SecurityPolicy/TLS/Server/RevokedCertificates/{CertificateId}
/redfish/v1/Managers/{ManagerId}/SecurityPolicy/TLS/Server/TrustedCertificates/{CertificateId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Drives/{DriveId}/Certificates/{CertificateId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Memory/{MemoryId}/Certificates/{CertificateId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/Certificates/{CertificateId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Controllers/{StorageControllerId}/Certificates/{CertificateId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Drives/{DriveId}/Certificates/{CertificateId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Certificates/{CertificateId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Boot/Certificates/{CertificateId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Certificates/{CertificateId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/KeyManagement/KMIPCertificates/{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/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/VirtualMedia/{VirtualMediaId}/ClientCertificates/{CertificateId}
/redfish/v1/Storage/{StorageId}/Controllers/{StorageControllerId}/Certificates/{CertificateId}
/redfish/v1/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Certificates/{CertificateId}
/redfish/v1/Systems/{ComputerSystemId}/Boot/Certificates/{CertificateId}
/redfish/v1/Systems/{ComputerSystemId}/Certificates/{CertificateId}
/redfish/v1/Systems/{ComputerSystemId}/KeyManagement/KMIPCertificates/{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/Systems/{ComputerSystemId}/VirtualMedia/{VirtualMediaId}/ClientCertificates/{CertificateId}
/redfish/v1/UpdateService/ClientCertificates/{CertificateId}
/redfish/v1/UpdateService/RemoteServerCertificates/{CertificateId}
6.17.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.
|
| CertificateUsageTypes (v1.4+) [ ] | array (string (enum)) |
read-only (null) |
|
| Fingerprint (v1.3+) | string | read-only | The fingerprint of the
certificate.
^([0-9A-Fa-f]{2}:){0,}([0-9A-Fa-f]{2})$ |
| FingerprintHashAlgorithm (v1.3+) | string | read-only | The hash algorithm for the fingerprint of
the certificate.
|
| Issuer { | object | The issuer of the certificate.
|
|
| AdditionalCommonNames (v1.6+) [ ] | array (string, null) | read-only | Additional common names of the
entity.
|
| AdditionalOrganizationalUnits (v1.6+) [ ] | array (string, null) | read-only | Additional organizational units of the
entity.
|
| AlternativeNames (v1.7+) [ ] | array (string, null) | read-only | The additional host names of the
entity.
|
| City | string | read-only | The city or locality of the organization
of the entity.
|
| CommonName | string | read-only | The common name of the entity.
|
| Country | string | read-only | The country of the organization of the
entity.
|
| DisplayString (v1.6+) | string | read-only (null) |
A human-readable string for this
identifier.
|
| DomainComponents (v1.6+) [ ] | array (string, null) | read-only | The domain components of the
entity.
|
| 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 usages of a key contained within a
certificate.
|
| Links (v1.4+) { | object | The links to other resources that are
related to this resource.
|
|
| Issuer (v1.4+) { | object | (null) |
A link to the certificate of the CA that
issued this certificate.
|
| @odata.id | string | read-write | Link to another Certificate resource. |
| } | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| Subjects (v1.4+) [ { | array | An array of links to certificates that
were issued by the CA that is represented by this
certificate.
|
|
| @odata.id | string | read-write | Link to another Certificate resource. |
| } ] | |||
| } | |||
| SerialNumber (v1.3+) | string | read-only | The serial number of the
certificate.
^([0-9A-Fa-f]{2}:){0,}([0-9A-Fa-f]{2})$ |
| SignatureAlgorithm (v1.3+) | string | read-only | The algorithm used for creating the
signature of the certificate.
|
| SPDM (v1.5+) { | object | (null) |
SPDM-related information for the
certificate.
|
| SlotId (v1.5+) | integer | read-only (null) |
Slot identifier of the
certificate.
|
| } | |||
| Subject { | object | The subject of the
certificate.
|
|
| AdditionalCommonNames (v1.6+) [ ] | array (string, null) | read-only | Additional common names of the
entity.
|
| AdditionalOrganizationalUnits (v1.6+) [ ] | array (string, null) | read-only | Additional organizational units of the
entity.
|
| AlternativeNames (v1.7+) [ ] | array (string, null) | read-only | The additional host names of the
entity.
|
| City | string | read-only | The city or locality of the organization
of the entity.
|
| CommonName | string | read-only | The common name of the entity.
|
| Country | string | read-only | The country of the organization of the
entity.
|
| DisplayString (v1.6+) | string | read-only (null) |
A human-readable string for this
identifier.
|
| DomainComponents (v1.6+) [ ] | array (string, null) | read-only | The domain components of the
entity.
|
| 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 (uuid) |
read-only (null) |
The UEFI signature owner for this
certificate.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ |
| 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.17.4 Actions
6.17.4.1 Rekey (v1.1+)
Description
This action generates a new key-pair for a certificate and produces a certificate signing request.
- This action shall use the certificate data to generate a new key-pair for a certificate. The response shall contain a signing request that a certificate authority (CA) will sign. The service should retain the private key that generated this request for installation of the certificate. The private key should not be part of the response. The private key should not be part of the response.
Action URI
{Base URI of target resource}/Actions/Certificate.Rekey
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| ChallengePassword | string | optional | The challenge password to apply to the
certificate for revocation requests.
|
| KeyBitLength | integer | optional | The length of the key, in bits, if needed
based on the KeyPairAlgorithm parameter value.
|
| KeyCurveId | string | optional | The curve ID to use with the key, if
needed based on the KeyPairAlgorithm parameter value.
|
| KeyPairAlgorithm | string | optional | The type of key-pair for use with signing
algorithms.
|
Response Payload
| { | |||
| Certificate (v1.1+) { | object | required | The link to the certificate being
rekeyed.
|
| @odata.id | string | read-only | Link to another Certificate resource. |
| } | |||
| CSRString (v1.1+) | string | read-only required | The string for the certificate signing
request.
|
| } |
Request Example
{
"KeyPairAlgorithm": "TPM_ALG_RSA",
"KeyBitLength": 4096
}Response Example
{
"CSRString": "-----BEGIN CERTIFICATE REQUEST-----...-----END CERTIFICATE REQUEST-----",
"Certificate": {
"@odata.id": "/redfish/v1/Managers/BMC/NetworkProtocol/HTTPS/Certificates/1"
}
}6.17.4.2 Renew (v1.1+)
Description
This action generates a certificate signing request by using the existing information and key-pair of the certificate.
- This action shall generate a certificate signing request using the existing information and key-pair of the certificate. The response shall contain a signing request that a certificate authority (CA) will sign. The service should retain the private key that this request generates for when the certificate is installed. The private key should not be part of the response.
Action URI
{Base URI of target resource}/Actions/Certificate.Renew
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| ChallengePassword | string | optional | The challenge password to apply to the
certificate for revocation requests.
|
Response Payload
| { | |||
| Certificate (v1.1+) { | object | required | The link to the certificate being
renewed.
|
| @odata.id | string | read-only | Link to another Certificate resource. |
| } | |||
| CSRString (v1.1+) | string | read-only required | The string for the certificate signing
request.
|
| } |
Request Example
{
"ChallengePassword": "p4ssw0rd"
}Response Example
{
"CSRString": "-----BEGIN CERTIFICATE REQUEST-----...-----END CERTIFICATE REQUEST-----",
"Certificate": {
"@odata.id": "/redfish/v1/Managers/BMC/NetworkProtocol/HTTPS/Certificates/1"
}
}6.17.5 Property details
6.17.5.1 CertificateString
The string for the certificate.
- This property shall contain the certificate, and the format shall follow the requirements specified by the CertificateType property value. If the certificate contains any private keys, they shall be removed from the string in responses. If the service does not know the private key for the certificate and is needed to use the certificate, the client shall provide the private key as part of the string in the POST request.
When a certificate of type PEMchain or
PKCS7 is installed, the service may create multiple
resources to represent each of the certificates found in the string. If
the service divides the request into multiple resources, the
service:
- Shall provide the response with the resource that represents the first certificate in the string.
- Shall apply the appropriate value for
CertificateTypefor each of the new resources. - Should populate the
Issuerproperty within theLinksproperty. - May populate the
Subjectsproperty within theLinksproperty.
To satisfy JSON encoding requirements, newlines in the string shall
be replaced with \n. Standard JSON libraries typically
manage this conversion automatically.
6.17.5.2 CertificateType
The format of the certificate.
- This property shall contain the format type for the certificate.
6.17.5.2.1 PEMchain
When the value of CertificateType is
PEMchain, the format represents a series of certificates.
The format shall be a concatenation, in order, of the following:
- The private key of the leaf certificate.
- The private key may be omitted.
- The leaf certificate for the end entity.
- The leaf certificate may be omitted.
- If the leaf certificate is omitted, the private key shall be omitted.
- A set of certificate authorithy (CA) certificates in order of issuance.
The private key shall be encoded as described in section 10 of RFC7468.
The leaf certificate and CA certificates shall be certificates as defined by RFC5280 and shall be encoded as described in section 5 of RFC7468.
Each certificate in the set of CA certificates shall be the issuer of the preceding certificate. For example, the first CA certificate is the issuer of the leaf certificate, the second CA certificate is the issuer of the first CA certificate, and so on. The last CA certificate typically represents the root CA and is self-signed. The set of certificates should contain all certificates leading to the root CA.
The following example for a PEMchain certificate
contains three certificates: the leaf certificate for "*.dmtf.org", the
CA certificate "Go Daddy Secure Certificate Authorithy - G2", and the
root CA certificate "Go Daddy Root Certificate Authority - G2".
-----BEGIN CERTIFICATE-----
MIIGpzCCBY+gAwIBAgIJAO3nRphCG8xGMA0GCSqGSIb3DQEBCwUAMIG0MQswCQYD
VQQGEwJVUzEQMA4GA1UECBMHQXJpem9uYTETMBEGA1UEBxMKU2NvdHRzZGFsZTEa
MBgGA1UEChMRR29EYWRkeS5jb20sIEluYy4xLTArBgNVBAsTJGh0dHA6Ly9jZXJ0
cy5nb2RhZGR5LmNvbS9yZXBvc2l0b3J5LzEzMDEGA1UEAxMqR28gRGFkZHkgU2Vj
dXJlIENlcnRpZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTE5MDYxNTE1MDIyNFoX
DTIxMDgxNDE5MDQ0M1owODEhMB8GA1UECxMYRG9tYWluIENvbnRyb2wgVmFsaWRh
dGVkMRMwEQYDVQQDDAoqLmRtdGYub3JnMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A
MIIBCgKCAQEAvEVrgkWuoz0kAEMqa3mna38MlN41vztntdE3Glm1IB5cHL1igJm0
PKnlvF0ShxBCOXKRMn8Z3HsbfQ4IQRD20meT6LWnMHCHE5+DKhDdzvz6SSlwmOF+
arAqDdBRXRkyvVVvpw2YLGTWc572t2WqhgKOrC7eaT9D/kxJmhVIt4NwNGj4Awl6
5fqNxxqWLDEJw9HYgxXMyv78gZaV66wZmE0MiypSKI0VtlZs8gryHdDG8iWbP0At
n098jcrkOkI5ewDq/jBHXdFfTgJtSkBIR4wpgmM+tL8pgEplyntWM/0xPBphJf6k
LjcoulHeW8r5Fv6II85fnNR7gW5pxnFz1wIDAQABo4IDNTCCAzEwDAYDVR0TAQH/
BAIwADAdBgNVHSUEFjAUBggrBgEFBQcDAQYIKwYBBQUHAwIwDgYDVR0PAQH/BAQD
AgWgMDgGA1UdHwQxMC8wLaAroCmGJ2h0dHA6Ly9jcmwuZ29kYWRkeS5jb20vZ2Rp
ZzJzMS0xMTc1LmNybDBdBgNVHSAEVjBUMEgGC2CGSAGG/W0BBxcBMDkwNwYIKwYB
BQUHAgEWK2h0dHA6Ly9jZXJ0aWZpY2F0ZXMuZ29kYWRkeS5jb20vcmVwb3NpdG9y
eS8wCAYGZ4EMAQIBMHYGCCsGAQUFBwEBBGowaDAkBggrBgEFBQcwAYYYaHR0cDov
L29jc3AuZ29kYWRkeS5jb20vMEAGCCsGAQUFBzAChjRodHRwOi8vY2VydGlmaWNh
dGVzLmdvZGFkZHkuY29tL3JlcG9zaXRvcnkvZ2RpZzIuY3J0MB8GA1UdIwQYMBaA
FEDCvSeOzDSDMKIz1/tss/C0LIDOMB8GA1UdEQQYMBaCCiouZG10Zi5vcmeCCGRt
dGYub3JnMB0GA1UdDgQWBBQZ2f2Fj14M4O81b6l5o+91idrySDCCAX4GCisGAQQB
1nkCBAIEggFuBIIBagFoAHYApLkJkLQYWBSHuxOizGdwCjw1mAT5G9+443fNDsgN
3BAAAAFrW6lKdgAABAMARzBFAiAJcqOn6x917jSYgE1Dot7wcN//5XMbi6ZVO4Ke
D5tEdAIhAK8iYDLb6rHEscWcPOu7XHUj3l/oqtez4KBh4wvCsn3GAHYA7ku9t3XO
YLrhQmkfq+GeZqMPfl+wctiDAMR7iXqo/csAAAFrW6lQOQAABAMARzBFAiEAqohS
sSlGBdXgemmfXuthuox/T8kKNwqmsTwtMNG2J9MCIBQBQTwmO/C7W4g+U/J0B4vU
LKWPGOYrnoOwHLdWpXOqAHYARJRlLrDuzq/EQAfYqP4owNrmgr7YyzG1P9MzlrW2
gagAAAFrW6lSdwAABAMARzBFAiEA44PR+UD/fXG57Edi/WdAiutVuO3xsN2dJKA2
yGl6TVMCIEP4D0A4C/3avvjo+Tc7IAPm98yF4gQhpxyevFFVGw+YMA0GCSqGSIb3
DQEBCwUAA4IBAQCx/1p1gal19B0+jg+0SdtFtSC81pF1Fkp/QQ2/9cvo6eklC3Hl
kvAIzu4+MzB77o+y47WJICX90Flk/xVWXKp3Nq6XoQQgJc9hbzdLHErZqE0t+3bB
4/ZNBpxeE2aOl/8QhKiA0ibYuAJn8acH5dVfk7Yy7Uv1LqyGw/YyRdPtukA4s7NA
8YLhFK5LfMKm/9HAi4Q7XJ6blnFKppemhqSqdarJ48u6qlLUcm64EmhZjwjUaE6f
1ML5qtGn57EZla3sfB7xjZ0KbfYY3IOA1XLP/bVKewjopQve2FR/rZ4KW9wrR0GS
0EyYN7gphrtSoWwCJDk8zRDfzOf1TOevaNLx
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
MIIE0DCCA7igAwIBAgIBBzANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMCVVMx
EDAOBgNVBAgTB0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxGjAYBgNVBAoT
EUdvRGFkZHkuY29tLCBJbmMuMTEwLwYDVQQDEyhHbyBEYWRkeSBSb290IENlcnRp
ZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTExMDUwMzA3MDAwMFoXDTMxMDUwMzA3
MDAwMFowgbQxCzAJBgNVBAYTAlVTMRAwDgYDVQQIEwdBcml6b25hMRMwEQYDVQQH
EwpTY290dHNkYWxlMRowGAYDVQQKExFHb0RhZGR5LmNvbSwgSW5jLjEtMCsGA1UE
CxMkaHR0cDovL2NlcnRzLmdvZGFkZHkuY29tL3JlcG9zaXRvcnkvMTMwMQYDVQQD
EypHbyBEYWRkeSBTZWN1cmUgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IC0gRzIwggEi
MA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC54MsQ1K92vdSTYuswZLiBCGzD
BNliF44v/z5lz4/OYuY8UhzaFkVLVat4a2ODYpDOD2lsmcgaFItMzEUz6ojcnqOv
K/6AYZ15V8TPLvQ/MDxdR/yaFrzDN5ZBUY4RS1T4KL7QjL7wMDge87Am+GZHY23e
cSZHjzhHU9FGHbTj3ADqRay9vHHZqm8A29vNMDp5T19MR/gd71vCxJ1gO7GyQ5HY
pDNO6rPWJ0+tJYqlxvTV0KaudAVkV4i1RFXULSo6Pvi4vekyCgKUZMQWOlDxSq7n
eTOvDCAHf+jfBDnCaQJsY1L6d8EbyHSHyLmTGFBUNUtpTrw700kuH9zB0lL7AgMB
AAGjggEaMIIBFjAPBgNVHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBBjAdBgNV
HQ4EFgQUQMK9J47MNIMwojPX+2yz8LQsgM4wHwYDVR0jBBgwFoAUOpqFBxBnKLbv
9r0FQW4gwZTaD94wNAYIKwYBBQUHAQEEKDAmMCQGCCsGAQUFBzABhhhodHRwOi8v
b2NzcC5nb2RhZGR5LmNvbS8wNQYDVR0fBC4wLDAqoCigJoYkaHR0cDovL2NybC5n
b2RhZGR5LmNvbS9nZHJvb3QtZzIuY3JsMEYGA1UdIAQ/MD0wOwYEVR0gADAzMDEG
CCsGAQUFBwIBFiVodHRwczovL2NlcnRzLmdvZGFkZHkuY29tL3JlcG9zaXRvcnkv
MA0GCSqGSIb3DQEBCwUAA4IBAQAIfmyTEMg4uJapkEv/oV9PBO9sPpyIBslQj6Zz
91cxG7685C/b+LrTW+C05+Z5Yg4MotdqY3MxtfWoSKQ7CC2iXZDXtHwlTxFWMMS2
RJ17LJ3lXubvDGGqv+QqG+6EnriDfcFDzkSnE3ANkR/0yBOtg2DZ2HKocyQetawi
DsoXiWJYRBuriSUBAA/NxBti21G00w9RKpv0vHP8ds42pM3Z2Czqrpv1KrKQ0U11
GIo/ikGQI31bS/6kA1ibRrLDYGCD+H1QQc7CoZDDu+8CL9IVVO5EFdkKrqeKM+2x
LXY2JtwE65/3YR8V3Idv7kaWKK2hJn0KCacuBKONvPi8BDAB
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
MIIDxTCCAq2gAwIBAgIBADANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMCVVMx
EDAOBgNVBAgTB0FyaXpvbmExEzARBgNVBAcTClNjb3R0c2RhbGUxGjAYBgNVBAoT
EUdvRGFkZHkuY29tLCBJbmMuMTEwLwYDVQQDEyhHbyBEYWRkeSBSb290IENlcnRp
ZmljYXRlIEF1dGhvcml0eSAtIEcyMB4XDTA5MDkwMTAwMDAwMFoXDTM3MTIzMTIz
NTk1OVowgYMxCzAJBgNVBAYTAlVTMRAwDgYDVQQIEwdBcml6b25hMRMwEQYDVQQH
EwpTY290dHNkYWxlMRowGAYDVQQKExFHb0RhZGR5LmNvbSwgSW5jLjExMC8GA1UE
AxMoR28gRGFkZHkgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgLSBHMjCCASIw
DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAL9xYgjx+lk09xvJGKP3gElY6SKD
E6bFIEMBO4Tx5oVJnyfq9oQbTqC023CYxzIBsQU+B07u9PpPL1kwIuerGVZr4oAH
/PMWdYA5UXvl+TW2dE6pjYIT5LY/qQOD+qK+ihVqf94Lw7YZFAXK6sOoBJQ7Rnwy
DfMAZiLIjWltNowRGLfTshxgtDj6AozO091GB94KPutdfMh8+7ArU6SSYmlRJQVh
GkSBjCypQ5Yj36w6gZoOKcUcqeldHraenjAKOc7xiID7S13MMuyFYkMlNAJWJwGR
tDtwKj9useiciAF9n9T521NtYJ2/LOdYq7hfRvzOxBsDPAnrSTFcaUaz4EcCAwEA
AaNCMEAwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAQYwHQYDVR0OBBYE
FDqahQcQZyi27/a9BUFuIMGU2g/eMA0GCSqGSIb3DQEBCwUAA4IBAQCZ21151fmX
WWcDYfF+OwYxdS2hII5PZYe096acvNjpL9DbWu7PdIxztDhC2gV7+AJ1uP2lsdeu
9tfeE8tTEH6KRtGX+rcuKxGrkLAngPnon1rpN5+r5N9ss4UXnT3ZJE95kTXWXwTr
gIOrmgIttRD02JDHBHNA7XIloKmf7J6raBKZV8aPEjoJpL1E/QYVN8Gb5DKj7Tjo
2GTzLH4U/ALqn83/B2gX2yKQOC16jdFU8WnjXzPKej17CuPKf1855eJ1usV2GDPO
LPAvTK33sefOT6jEm0pUBsV/fdUID+Ic/n4XuKxe9tQWskMJDE32p2u0mYRlynqI
4uJEvlz36hz1
-----END CERTIFICATE-----6.17.5.2.2 PEM
When the value of CertificateType is PEM,
the format represents a single certificate and an optional private key.
The format shall be an order independent concatenation of the
following:
- The private key of the leaf certificate.
- The private key may be omitted.
- The leaf certificate for the end entity.
The private key shall be encoded as described in section 10 of RFC7468.
The leaf certificate shall be a certificate as defined by RFC5280 and shall be encoded as described in section 5 of RFC7468.
6.17.5.2.3 PKCS7
When the value of CertificateType is PKCS7,
the format represents a PKCS7 bundle and an optional private key. The
format shall be an order independent concatenation of the following:
- The private key of the PKCS7 bundle.
- The private key may be omitted.
- The PKCS7 bundle containing one or more certificates.
The private key shall be encoded as described in section 10 of RFC7468.
The PKCS7 bundle shall contain one or more certificates as defined by RFC5280 and shall be encoded as described in section 8 of RFC7468.
| string | Description |
|---|---|
| PEM | A Privacy Enhanced Mail (PEM)-encoded
single certificate.
|
| PEMchain (v1.4+) | A Privacy Enhanced Mail (PEM)-encoded
certificate chain.
|
| PKCS7 | A Privacy Enhanced Mail (PEM)-encoded
PKCS7 certificate.
|
6.17.5.3 CertificateUsageTypes
- The types or purposes for this certificate.
- The value of this property shall contain an array describing the types or purposes for this certificate.
| string | Description |
|---|---|
| BIOS | This certificate is a BIOS certificate like those associated with UEFI. |
| Device | This certificate is a device type certificate like those associated with SPDM and other standards. |
| IAK | This certificate is an IAK certificate like those associated with TCG TPMs. |
| IDevID | This certificate is an IDevID certificate like those associated with TCG TPMs. |
| LAK | This certificate is an LAK certificate like those associated with TCG TPMs. |
| LDevID | This certificate is an LDevID certificate like those associated with TCG TPMs. |
| Platform | This certificate is a platform type certificate like those associated with SPDM and other standards. |
| SSH | This certificate is used for SSH. |
| User | This certificate is a user certificate like those associated with a manager account. |
| Web | This certificate is a web or HTTPS certificate like those used for event destinations. |
6.17.5.4 KeyUsage
The usages of a key contained within a certificate.
- The key
usage extension, which defines the purpose of the public keys in this
certificate.
- This property shall contain 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.17.6 Example response
{
"@odata.type": "#Certificate.v1_8_0.Certificate",
"Id": "1",
"Name": "HTTPS Certificate",
"CertificateString": "-----BEGIN CERTIFICATE-----\nMIIFsTCC [*truncated*] GXG5zljlu\n-----END CERTIFICATE-----",
"CertificateType": "PEM",
"Issuer": {
"Country": "US",
"State": "Oregon",
"City": "Portland",
"Organization": "Contoso",
"OrganizationalUnit": "ABC",
"CommonName": "manager.contoso.org"
},
"Subject": {
"Country": "US",
"State": "Oregon",
"City": "Portland",
"Organization": "Contoso",
"OrganizationalUnit": "ABC",
"CommonName": "manager.contoso.org"
},
"ValidNotBefore": "2018-09-07T13:22:05Z",
"ValidNotAfter": "2019-09-07T13:22:05Z",
"KeyUsage": [
"KeyEncipherment",
"ServerAuthentication"
],
"SerialNumber": "5d:7a:d8:df:f6:fc:c1:b3:ca:fe:fb:cc:38:f3:01:64:51:ea:05:cb",
"Fingerprint": "A6:E9:D2:5C:DC:52:DA:4B:3B:14:97:F3:A4:53:D9:99:A1:0B:56:41",
"FingerprintHashAlgorithm": "TPM_ALG_SHA1",
"SignatureAlgorithm": "sha256WithRSAEncryption",
"@odata.id": "/redfish/v1/Managers/BMC/NetworkProtocol/HTTPS/Certificates/1"
}6.18 CertificateLocations 1.0.2
| Version | v1.0 |
| Release | 2018.3 |
6.18.1 Description
The CertificateLocations schema describes a Resource that an administrator can use in order to locate all certificates installed on a given service.
- This Resource shall represent the Certificate Location Properties for a Redfish implementation.
6.18.2 URIs
/redfish/v1/CertificateService/CertificateLocations
6.18.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 Using this guide clause. | |
| } |
6.18.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"
}
]
},
"@odata.id": "/redfish/v1/CertificateService/CertificateLocations"
}6.19 CertificateService 1.0.4
| Version | v1.0 |
| Release | 2018.3 |
6.19.1 Description
The CertificateService schema describes a certificate service that represents the actions available to manage certificates and links to the certificates.
- This resource shall represent the certificate service properties for a Redfish implementation.
6.19.2 URIs
/redfish/v1/CertificateService
6.19.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| CertificateLocations { | object | The information about the location of
certificates.
|
|
| @odata.id | string | read-only | Link to a CertificateLocations resource. See the Links section and the CertificateLocations schema for details. |
| } |
6.19.4 Actions
6.19.4.1 GenerateCSR
Description
This action makes a certificate signing request.
- This action shall make a certificate signing request. The response shall contain a signing request that a certificate authority (CA) will sign. The service should retain the private key that was generated during this request for installation of the certificate. The private key should not be part of the response.
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.
|
| @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.
|
| 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 usages of a key contained within a
certificate.
|
| 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.
|
| @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.org",
"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.19.4.2 ReplaceCertificate
Description
This action replaces a certificate.
- This action shall replace
a certificate. The
Locationheader in the response shall contain the URI of the new certificate resource.
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.
|
| CertificateUri { | object | required | The link to the certificate that is being
replaced.
|
| @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.19.5 Property details
6.19.5.1 CertificateType
The format of the certificate.
- This parameter shall contain the format type for the certificate.
| string | Description |
|---|---|
| PEM | A Privacy Enhanced Mail (PEM)-encoded
single certificate.
|
| PEMchain | A Privacy Enhanced Mail (PEM)-encoded
certificate chain.
|
| PKCS7 | A Privacy Enhanced Mail (PEM)-encoded
PKCS7 certificate.
|
6.19.5.2 KeyUsage
The usages of a key contained within a certificate.
- The usage
of the key contained in the certificate.
- This parameter shall contain the usage of the key contained in the certificate. If the client does not provide this value, the service can determine the appropriate key usage settings in the certificate signing request.
| 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.19.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"
},
"@odata.id": "/redfish/v1/CertificateService"
}6.20 Chassis 1.24.0
| Version | v1.24 | v1.23 | v1.22 | v1.21 | v1.20 | v1.19 | v1.18 | v1.17 | v1.16 | v1.15 | v1.14 | ... |
| Release | 2023.2 | 2023.1 | 2022.3 | 2022.2 | 2022.1 | 2021.4 | 2021.3 | 2021.2 | 2021.1 | 2020.4 | 2020.3 | ... |
6.20.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. It also describes the location, such as a slot, socket, or bay, where a unit can be installed, by populating a resource instance with an absent state if a unit is not present.
- This resource shall represent a chassis or other
physical enclosure for a Redfish implementation. It may also represent a
location, such as a slot, socket, or bay, where a unit may be installed,
but the State property within the Status property contains
Absent.
6.20.2 URIs
/redfish/v1/Chassis/{ChassisId}
6.20.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Assembly (v1.6+) { | object | The link to the assembly associated with
this chassis.
|
|
| @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.
|
|
| @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.
|
| Controls (v1.17+) { | object | The link to the collection of controls
located in this chassis.
|
|
| @odata.id | string | read-only | Link to Collection of Control. See the Control schema for details. |
| } | |||
| DepthMm (v1.4+) | number (mm) |
read-only (null) |
The depth of the chassis.
|
| Doors (v1.24+) { | object | The doors or access panels of the
chassis.
|
|
| Front (v1.24+) { | object | (null) |
The front door of the chassis.
|
| DoorState (v1.24+) | string (enum) |
read-only (null) |
The state of the door.
|
| Locked (v1.24+) | boolean | read-write (null) |
Indicates if the door is
locked.
|
| UserLabel (v1.24+) | string | read-write | A user-assigned label.
|
| } | |||
| Rear (v1.24+) { | object | (null) |
The rear door of the chassis.
|
| DoorState (v1.24+) | string (enum) |
read-only (null) |
The state of the door.
|
| Locked (v1.24+) | boolean | read-write (null) |
Indicates if the door is
locked.
|
| UserLabel (v1.24+) | string | read-write | A user-assigned label.
|
| } | |||
| } | |||
| Drives (v1.14+) { | object | The link to the collection of drives
within this chassis.
|
|
| @odata.id | string | read-only | Link to Collection of Drive. See the Drive schema for details. |
| } | |||
| ElectricalSourceManagerURIs (v1.18+) [ ] | array (URI) (string, null) |
read-write | The URIs of the management interfaces for
the upstream electrical source connections for this chassis.
|
| ElectricalSourceNames (v1.18+) [ ] | array (string, null) | read-write | The names of the upstream electrical
sources, such as circuits or outlets, connected to this
chassis.
|
| EnvironmentalClass (v1.9+) | string (enum) |
read-write (null) |
The ASHRAE Environmental Class for this
chassis.
|
| EnvironmentMetrics (v1.15+) { | object | The link to the environment metrics for
this chassis.
|
|
| @odata.id | string | read-only | Link to a EnvironmentMetrics resource. See the Links section and the EnvironmentMetrics schema for details. |
| } | |||
| FabricAdapters (v1.20+) { | object | The link to the collection of fabric
adapters located in this chassis that provide access to fabric-related
resource pools.
|
|
| @odata.id | string | read-only | Link to Collection of FabricAdapter. See the FabricAdapter schema for details. |
| } | |||
| HeightMm (v1.4+) | number (mm) |
read-only (null) |
The height of the chassis.
|
| HotPluggable (v1.21+) | boolean | read-only (null) |
An indication of whether this component
can be inserted or removed while the equipment is in
operation.
|
| IndicatorLED (deprecated v1.14) | string (enum) |
read-write (null) |
The state of the indicator LED, which
identifies the chassis.
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| Cables (v1.17+) [ { | array | An array of links to the cables connected
to this chassis.
|
|
| @odata.id | string | read-only | Link to a Cable resource. See the Links section and the Cable schema for details. |
| } ] | |||
| ComputerSystems [ { | array | An array of links to the computer systems
that this chassis directly and wholly contains.
|
|
| @odata.id | string | read-only | Link to a ComputerSystem resource. See the Links section and the ComputerSystem schema for details. |
| } ] | |||
| ConnectedCoolingLoops (v1.23+) [ { | array | An array of links to cooling loops
connected to this chassis.
|
|
| @odata.id | string | read-write | Link to a CoolingLoop resource. See the Links section and the CoolingLoop 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 (deprecated v1.20) [ { | 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.
|
| } ] | |||
| CoolingUnits (v1.23+) [ { | array | An arrays of links to cooling unit
functionality contained in this chassis.
|
|
| @odata.id | string | read-write | Link to a CoolingUnit resource. See the Links section and the CoolingUnit schema for details. |
| } ] | |||
| 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.
|
|
| @odata.id | string | read-write | Link to a Facility resource. See the Links section and the Facility schema for details. |
| } | |||
| Fans (v1.20+) [ { | array | An array of links to the fans that cool
this chassis.
|
|
| @odata.id | string | read-only | Link to a Fan resource. See the Links section and the Fan 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 Using this guide clause. | |
| PCIeDevices (v1.4+, deprecated v1.10 [ { | array | An array of links to the PCIe devices
located in this chassis.
|
|
| @odata.id | string | read-only | Link to a PCIeDevice resource. See the Links section and the PCIeDevice schema for details. |
| } ] | |||
| PowerDistribution (v1.20+) { | object | (null) |
A link to power distribution functionality
contained in this chassis.
|
| @odata.id | string | read-only | Link to a PowerDistribution resource. See the Links section and the PowerDistribution schema for details. |
| } | |||
| PoweredBy (deprecated v1.20) [ { | array | An array of links to resources or objects
that power this chassis. Normally, the link is for either a chassis or a
specific set of power supplies.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| PowerOutlets (v1.18+) [ { | array | An array of links to the outlets that
provide power to this chassis.
|
|
| @odata.id | string | read-write | Link to a Outlet resource. See the Links section and the Outlet schema for details. |
| } ] | |||
| PowerSupplies (v1.20+) [ { | array | An array of links to the power supplies
that provide power to this chassis.
|
|
| @odata.id | string | read-only | Link to a PowerSupply resource. See the Links section and the PowerSupply schema for details. |
| } ] | |||
| Processors (v1.9+) [ { | array | An array of links to the processors
located in this chassis.
|
|
| @odata.id | string | read-only | Link to a Processor resource. See the Links section and the Processor schema for details. |
| } ] | |||
| ResourceBlocks (v1.5+) [ { | array | An array of links to the resource blocks
located in this chassis.
|
|
| @odata.id | string | read-only | Link to a ResourceBlock resource. See the Links section and the ResourceBlock schema for details. |
| } ] | |||
| Storage (v1.2+) [ { | array | An array of links to the storage
subsystems connected to or inside this chassis.
|
|
| @odata.id | string | read-only | Link to a Storage resource. See the Links section and the Storage schema for details. |
| } ] | |||
| Switches (v1.7+) [ { | array | An array of links to the switches located
in this chassis.
|
|
| @odata.id | string | read-only | Link to a Switch resource. See the Links section and the Switch schema for details. |
| } ] | |||
| } | |||
| Location (v1.2+) {} | object | The location of the chassis.
|
|
| 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.
|
|
| @odata.id | string | read-only | Link to Collection of LogService. See the LogService schema for details. |
| } | |||
| Manufacturer | string | read-only (null) |
The manufacturer of this
chassis.
|
| MaxPowerWatts (v1.12+) | number (Watts) |
read-only (null) |
The upper bound of the total power
consumed by the chassis.
|
| Measurements (v1.15+, deprecated v1.19 [ { | array | An array of DSP0274-defined measurement
blocks.
|
|
| @odata.id | string | read-only | Link to a MeasurementBlock resource. See the Links section and the SoftwareInventory schema for details. |
| } ] | |||
| MediaControllers (v1.11+, deprecated v1.20 { | object | The link to the collection of media
controllers located in this chassis.
|
|
| @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 that belong to fabric-related resource
pools.
|
|
| @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 that belong to fabric-related resource
pools.
|
|
| @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.
|
|
| @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.
|
|
| @odata.id | string | read-only | Link to Collection of PCIeDevice. See the PCIeDevice schema for details. |
| } | |||
| PCIeSlots (v1.8+, deprecated v1.24 { | object | The link to the PCIe slot properties for
this chassis.
Absent
value of the State property within Status. |
|
| @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 physical security state of the
chassis.
|
|
| IntrusionSensor (v1.1+) | string (enum) |
read-write (null) |
The physical security state of the
chassis, such as if hardware intrusion is detected.
|
| IntrusionSensorNumber (v1.1+, deprecated v1.22 | integer | read-only (null) |
A numerical identifier to represent the
physical security sensor.
|
| IntrusionSensorReArm (v1.1+) | string (enum) |
read-only (null) |
The policy that describes how the physical
security state of the chassis returns to a normal state.
|
| } | |||
| Power (deprecated v1.15) { | object | The link to the power properties, or power
supplies, power policies, and sensors, for this chassis.
|
|
| @odata.id | string | read-only | Link to a Power resource. See the Links section and the Power schema for details. |
| } | |||
| PoweredByParent (v1.20+) | boolean | read-only (null) |
Indicates that the chassis receives power
from the containing chassis.
|
| PowerState (v1.0.1+) | string (enum) |
read-only (null) |
The current power state of the
chassis.
|
| PowerSubsystem (v1.15+) { | object | The link to the power subsystem properties
for this chassis.
|
|
| @odata.id | string | read-only | Link to a PowerSubsystem resource. See the Links section and the PowerSubsystem schema for details. |
| } | |||
| Processors (v1.22+) { | object | The link to the collection of processors
located in this chassis that belong to fabric-related resource
pools.
|
|
| @odata.id | string | read-only | Link to Collection of Processor. See the Processor schema for details. |
| } | |||
| Replaceable (v1.21+) | boolean | read-only (null) |
An indication of whether this component
can be independently replaced as allowed by the vendor's replacement
policy.
|
| Sensors (v1.9+) { | object | The link to the collection of sensors
located in the equipment and sub-components.
|
|
| @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.
|
|
| Thermal (deprecated v1.15) { | object | The link to the thermal properties, such
as fans, cooling, and sensors, for this chassis.
|
|
| @odata.id | string | read-only | Link to a Thermal resource. See the Links section and the Thermal schema for details. |
| } | |||
| ThermalDirection (v1.20+) | string (enum) |
read-only (null) |
Indicates the thermal management path
through the chassis.
|
| ThermalManagedByParent (v1.20+) | boolean | read-only (null) |
Indicates that the chassis is thermally
managed by the parent chassis.
|
| ThermalSubsystem (v1.15+) { | object | The link to the thermal subsystem
properties for this chassis.
|
|
| @odata.id | string | read-only | Link to a ThermalSubsystem resource. See the Links section and the ThermalSubsystem schema for details. |
| } | |||
| TrustedComponents (v1.21+) { | object | The link to the trusted components in this
chassis.
|
|
| @odata.id | string | read-only | Link to Collection of TrustedComponent. See the TrustedComponent schema for details. |
| } | |||
| UUID (v1.7+) | string (uuid) |
read-only (null) |
The UUID for this chassis.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ |
| Version (v1.21+) | string | read-only (null) |
The hardware version of 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.20.4 Actions
6.20.4.1 Reset
Description
This action resets the chassis. Additionally, it could reset systems or other contained resources depending on the ResetType used to invoke this action.
- This action shall reset the chassis. Additionally, it may reset systems or other contained resources depending on the ResetType used to invoke this action.
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.
|
Request Example
{
"ResetType": "ForceRestart"
}6.20.5 Property details
6.20.5.1 ChassisType
The type of physical form factor of the chassis.
- This property shall indicate the physical form factor for the type of 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. |
| HeatExchanger (v1.23+) | A heat exchanger. |
| ImmersionTank (v1.23+) | An immersion cooling tank. |
| 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.20.5.2 DoorState
The state of the door.
- This property shall contain the current state of the door.
| string | Description |
|---|---|
| Closed | Door is closed.
|
| Locked | Door is closed and locked.
|
| LockedAndOpen | Door is open and locked.
|
| Open | Door is open.
|
6.20.5.3 EnvironmentalClass
The ASHRAE Environmental Class for this chassis.
- This property shall contain the ASHRAE Environmental Class for this chassis, as defined by ASHRAE Thermal Guidelines for Data Processing Environments. These classes define respective environmental limits that include temperature, relative humidity, dew point, and maximum allowable elevation.
| string | Description |
|---|---|
| A1 | ASHRAE Environmental Class 'A1'. |
| A2 | ASHRAE Environmental Class 'A2'. |
| A3 | ASHRAE Environmental Class 'A3'. |
| A4 | ASHRAE Environmental Class 'A4'. |
6.20.5.4 IndicatorLED
The state of the indicator LED, which identifies the chassis.
- This property shall contain the indicator light state for the indicator light associated with this system.
| 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.
|
6.20.5.5 IntrusionSensor
The physical security state of the chassis, such as if hardware intrusion is detected.
- This property shall contain the physical
security state of the chassis. If the IntrusionSensorReArm property
contains
Manual, a client may set this property toNormalto reset the physical security state.
| 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 physical security condition is detected at this time. |
| TamperingDetected | Physical tampering of the monitored entity is detected. |
6.20.5.6 IntrusionSensorReArm
The policy that describes how the physical security state of the chassis returns to a normal state.
- This property shall contain
the policy that describes how the IntrusionSensor property returns to
the
Normalvalue.
| string | Description |
|---|---|
| Automatic | The sensor is automatically restored to
the normal state when no security condition is detected.
|
| Manual | A user is required to clear the sensor to
restore it to the normal state.
|
6.20.5.7 PowerState
The current power state of the chassis.
- This property shall contain the power state of the chassis.
| string | Description |
|---|---|
| Off | The resource is powered off. The components within the resource might continue to have AUX power. |
| On | The resource is powered on. |
| Paused | The resource is paused. |
| PoweringOff | A temporary state between on and off. The components within the resource can take time to process the power off action. |
| PoweringOn | A temporary state between off and on. The components within the resource can take time to process the power on action. |
6.20.5.8 ResetType
The type of reset.
- This parameter shall contain the type of reset. The service can accept a request without the parameter and complete an implementation-specific default reset. Services should include the @Redfish.AllowableValues annotation for this parameter to ensure compatibility with clients, even when ActionInfo has been implemented.
| string | Description |
|---|---|
| ForceOff | Turn off the unit immediately
(non-graceful shutdown).
|
| ForceOn | Turn on the unit immediately.
|
| ForceRestart | Shut down immediately and non-gracefully
and restart the system.
|
| GracefulRestart | Shut down gracefully and restart the
system.
|
| GracefulShutdown | Shut down gracefully and power
off.
|
| Nmi | Generate a diagnostic interrupt, which is
usually an NMI on x86 systems, to stop normal operations, complete
diagnostic actions, and, typically, halt the system.
|
| On | Turn on the unit.
|
| Pause | Pause execution on the unit but do not
remove power. This is typically a feature of virtual machine
hypervisors.
|
| PowerCycle | Power cycle the unit. Behaves like a full
power removal, followed by a power restore to the resource.
|
| PushPowerButton | Simulate the pressing of the physical
power button on this unit.
|
| Resume | Resume execution on the paused unit. This
is typically a feature of virtual machine hypervisors.
|
| Suspend | Write the state of the unit to disk before
powering off. This allows for the state to be restored when powered back
on.
|
6.20.5.9 ThermalDirection
Indicates the thermal management path through the chassis.
- This property shall indicate the general direction of the thermal management path through the chassis.
| string | Description |
|---|---|
| BackToFront | A chassis with the air intake in the back
and exhaust out the front.
|
| FrontToBack | A chassis with the air intake in the front
and exhaust out the back.
|
| Sealed | A sealed chassis with no air
pathway.
|
| TopExhaust | A chassis with air exhaust on the
top.
|
6.20.6 Example response
{
"@odata.type": "#Chassis.v1_24_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"
}
]
},
"@odata.id": "/redfish/v1/Chassis/1U"
}6.21 Circuit 1.7.0
| Version | v1.7 | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2022.2 | 2022.1 | 2021.4 | 2021.3 | 2021.2 | 2020.4 | 2020.3 | 2019.4 |
6.21.1 Description
This is the schema definition for an electrical circuit.
- This resource shall be used to represent an electrical circuit for a Redfish implementation.
6.21.2 URIs
/redfish/v1/PowerEquipment/ElectricalBuses/{PowerDistributionId}/Branches/{CircuitId}
/redfish/v1/PowerEquipment/ElectricalBuses/{PowerDistributionId}/Mains/{CircuitId}
/redfish/v1/PowerEquipment/FloorPDUs/{PowerDistributionId}/Branches/{CircuitId}
/redfish/v1/PowerEquipment/FloorPDUs/{PowerDistributionId}/Mains/{CircuitId}
/redfish/v1/PowerEquipment/FloorPDUs/{PowerDistributionId}/Subfeeds/{CircuitId}
/redfish/v1/PowerEquipment/PowerShelves/{PowerDistributionId}/Branches/{CircuitId}
/redfish/v1/PowerEquipment/PowerShelves/{PowerDistributionId}/Mains/{CircuitId}
/redfish/v1/PowerEquipment/RackPDUs/{PowerDistributionId}/Branches/{CircuitId}
/redfish/v1/PowerEquipment/RackPDUs/{PowerDistributionId}/Mains/{CircuitId}
/redfish/v1/PowerEquipment/Switchgear/{PowerDistributionId}/Branches/{CircuitId}
/redfish/v1/PowerEquipment/Switchgear/{PowerDistributionId}/Feeders/{CircuitId}
/redfish/v1/PowerEquipment/Switchgear/{PowerDistributionId}/Mains/{CircuitId}
/redfish/v1/PowerEquipment/Switchgear/{PowerDistributionId}/Subfeeds/{CircuitId}
/redfish/v1/PowerEquipment/TransferSwitches/{PowerDistributionId}/Branches/{CircuitId}
/redfish/v1/PowerEquipment/TransferSwitches/{PowerDistributionId}/Feeders/{CircuitId}
/redfish/v1/PowerEquipment/TransferSwitches/{PowerDistributionId}/Mains/{CircuitId}
6.21.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| BreakerState | string (enum) |
read-only (null) |
The state of the over current protection
device.
|
| CircuitType | string (enum) |
read-only (null) |
The type of circuit.
|
| ConfigurationLocked (v1.5+) | boolean | read-write | Indicates whether the configuration is
locked.
|
| CriticalCircuit | boolean | read-write (null) |
Designates if this is a critical
circuit.
|
| CurrentAmps {} | object | The current (A) for this single phase
circuit.
|
|
| ElectricalConsumerNames (v1.4+) [ ] | array (string, null) | read-write | An array of names of downstream devices
that are powered by this circuit.
|
| ElectricalContext | string (enum) |
read-only (null) |
The combination of current-carrying
conductors.
|
| ElectricalSourceManagerURI (v1.4+) | string (URI) |
read-write | The URI of the management interface for
the upstream electrical source connection for this circuit.
|
| ElectricalSourceName (v1.4+) | string | read-write | The name of the upstream electrical
source, such as a circuit or outlet, connected to this
circuit.
|
| EnergykWh {} | object | The energy (kWh) for this
circuit.
|
|
| FrequencyHz {} | object | The frequency (Hz) for this
circuit.
|
|
| IndicatorLED (deprecated v1.1) | string (enum) |
read-write (null) |
The state of the indicator LED, which
identifies the circuit.
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| BranchCircuit { | object | (null) |
A reference to the branch circuit related
to this circuit.
|
| @odata.id | string | read-only | Link to another Circuit resource. |
| } | |||
| DistributionCircuits (v1.4+) [ { | array | An array of links to the circuits powered
by this circuit.
|
|
| @odata.id | string | read-write | Link to another Circuit resource. |
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| Outlets [ { | array | An array of references to the outlets
contained by this circuit.
|
|
| @odata.id | string | read-only | Link to a Outlet resource. See the Links section and the Outlet schema for details. |
| } ] | |||
| PowerOutlet (v1.4+) { | object | (null) |
A link to the power outlet that provides
power to this circuit.
|
| @odata.id | string | read-write | Link to a Outlet resource. See the Links section and the Outlet schema for details. |
| } | |||
| SourceCircuit (v1.4+) { | object | (null) |
A link to the circuit that provides power
to this circuit.
|
| @odata.id | string | read-write | Link to another Circuit resource. |
| } | |||
| } | |||
| LocationIndicatorActive (v1.1+) | boolean | read-write (null) |
An indicator allowing an operator to
physically locate this resource.
|
| NominalVoltage | string (enum) |
read-only (null) |
The nominal voltage for this
circuit.
|
| PhaseWiringType | string (enum) |
read-only (null) |
The number of ungrounded current-carrying
conductors (phases) and the total number of conductors
(wires).
|
| PlugType | string (enum) |
read-only (null) |
The type of plug according to NEMA, IEC,
or regional standards.
|
| PolyPhaseCurrentAmps { | object | (null) |
The current readings for this
circuit.
|
| Line1 {} | object | Line 1 current (A).
|
|
| Line2 {} | object | Line 2 current (A).
|
|
| Line3 {} | object | Line 3 current (A).
|
|
| Neutral {} | object | Neutral line current (A).
|
|
| } | |||
| PolyPhaseEnergykWh { | object | (null) |
The energy readings for this
circuit.
|
| Line1ToLine2 {} | object | The Line 1 to Line 2 energy (kWh) for this
circuit.
|
|
| Line1ToNeutral {} | object | The Line 1 to Neutral energy (kWh) for
this circuit.
|
|
| Line2ToLine3 {} | object | The Line 2 to Line 3 energy (kWh) for this
circuit.
|
|
| Line2ToNeutral {} | object | The Line 2 to Neutral energy (kWh) for
this circuit.
|
|
| Line3ToLine1 {} | object | The Line 3 to Line 1 energy (kWh) for this
circuit.
|
|
| Line3ToNeutral {} | object | The Line 3 to Neutral energy (kWh) for
this circuit.
|
|
| } | |||
| PolyPhasePowerWatts { | object | (null) |
The power readings for this
circuit.
|
| Line1ToLine2 {} | object | The Line 1 to Line 2 power (W) for this
circuit.
|
|
| Line1ToNeutral {} | object | The Line 1 to Neutral power (W) for this
circuit.
|
|
| Line2ToLine3 {} | object | The Line 2 to Line 3 power (W) for this
circuit.
|
|
| Line2ToNeutral {} | object | The Line 2 to Neutral power (W) for this
circuit.
|
|
| Line3ToLine1 {} | object | The Line 3 to Line 1 power (W) for this
circuit.
|
|
| Line3ToNeutral {} | object | The Line 3 to Neutral power (W) for this
circuit.
|
|
| } | |||
| PolyPhaseVoltage { | object | (null) |
The voltage readings for this
circuit.
|
| Line1ToLine2 {} | object | The Line 1 to Line 2 voltage (V) for this
circuit.
|
|
| Line1ToNeutral {} | object | The Line 1 to Neutral voltage (V) for this
circuit.
|
|
| Line2ToLine3 {} | object | The Line 2 to Line 3 voltage (V) for this
circuit.
|
|
| Line2ToNeutral {} | object | The Line 2 to Neutral voltage (V) for this
circuit.
|
|
| Line3ToLine1 {} | object | The Line 3 to Line 1 voltage (V) for this
circuit.
|
|
| Line3ToNeutral {} | object | The Line 3 to Neutral voltage (V) for this
circuit.
|
|
| } | |||
| PowerControlLocked (v1.5+) | boolean | read-write | Indicates whether power control requests
are locked.
|
| PowerCycleDelaySeconds | number | read-write (null) |
The number of seconds to delay power on
after a PowerControl action to cycle power. Zero seconds indicates no
delay.
|
| PowerEnabled | boolean | read-only (null) |
Indicates if the circuit can be
powered.
|
| PowerLoadPercent (v1.3+) {} | object | The power load (percent) for this
circuit.
|
|
| 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.
|
| PowerState | string (enum) |
read-only (null) |
The power state of the
circuit.
|
| PowerStateInTransition (v1.5+) | boolean | read-only | Indicates whether the power state is
undergoing a delayed transition.
|
| PowerWatts {} | object | The power (W) for this
circuit.
|
|
| 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.
|
|
| UnbalancedCurrentPercent (v1.5+) {} | object | The current imbalance (percent) between
phases.
|
|
| UnbalancedVoltagePercent (v1.5+) {} | object | The voltage imbalance (percent) between
phases.
|
|
| UserLabel (v1.4+) | string | read-write | A user-assigned label.
|
| Voltage {} | object | The voltage (V) for this single phase
circuit.
|
|
| VoltageType | string (enum) |
read-only (null) |
The type of voltage applied to the
circuit.
|
6.21.4 Actions
6.21.4.1 BreakerControl
Description
This action attempts to reset the circuit breaker.
- This action shall control the state of the circuit breaker or over-current protection device.
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.
|
Request Example
{
"PowerState": "On"
}6.21.4.2 PowerControl
Description
This action turns the circuit on or off.
- This action shall control the power state of the circuit.
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.
|
Request Example
{
"PowerState": "Off"
}6.21.4.3 ResetMetrics
Description
This action resets metrics related to this circuit.
- This action shall reset any time intervals or counted values for this circuit.
Action URI
{Base URI of target resource}/Actions/Circuit.ResetMetrics
Action parameters
This action takes no parameters.
6.21.5 Property details
6.21.5.1 BreakerState
The state of the over current protection device.
- This property shall contain 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.21.5.2 CircuitType
The type of circuit.
- This property shall contain the type of circuit.
| string | Description |
|---|---|
| Branch | A branch (output) circuit. |
| Bus (v1.3+) | An electrical bus circuit. |
| Feeder | A feeder (output) circuit. |
| Mains | A mains input or utility circuit. |
| Subfeed | A subfeed (output) circuit. |
6.21.5.3 ElectricalContext
The combination of current-carrying conductors.
- This property shall contain the combination of current-carrying conductors that distribute power.
| 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.21.5.4 IndicatorLED
The state of the indicator LED, which identifies the circuit.
- This property shall contain the indicator light state for the indicator light associated with this circuit.
| string | Description |
|---|---|
| Blinking | The indicator LED is blinking.
|
| Lit | The indicator LED is lit.
|
| Off | The indicator LED is off.
|
6.21.5.5 NominalVoltage
The nominal voltage for this circuit.
- This property shall contain the nominal voltage for this circuit, in Volts.
| string | Description |
|---|---|
| AC100To127V (v1.6+) | AC 100-127V nominal.
|
| 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.
|
| DC12V (v1.7+) | DC 12V nominal.
|
| DC16V (v1.7+) | DC 16V nominal.
|
| DC1_8V (v1.7+) | DC 1.8V nominal.
|
| DC240V | DC 240V nominal.
|
| DC380V | High Voltage DC (380V).
|
| DC3_3V (v1.7+) | DC 3.3V nominal.
|
| DC48V (v1.2+) | DC 48V nominal.
|
| DC5V (v1.7+) | DC 5V nominal.
|
| DC9V (v1.7+) | DC 9V nominal.
|
| DCNeg48V | -48V DC.
|
6.21.5.6 PhaseWiringType
The number of ungrounded current-carrying conductors (phases) and the total number of conductors (wires).
- This property shall contain 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.21.5.7 PlugType
The type of plug according to NEMA, IEC, or regional standards.
- This property shall contain the type of physical plug used for this circuit, as defined by IEC, NEMA, or regional standard.
| 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.21.5.8 PowerRestorePolicy
The desired power state of the circuit when power is restored after a power loss.
- This property shall contain the desired PowerState of
the circuit when power is applied. The value
LastStateshall return the circuit to the PowerState it was in when power was lost.
| 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.21.5.9 PowerState
6.21.5.9.1 In top level:
The power state of the circuit.
- This property shall contain the power state of the circuit.
| string | Description |
|---|---|
| Off | The resource is powered off. The components within the resource might continue to have AUX power. |
| On | The resource is powered on. |
| Paused | The resource is paused. |
| PoweringOff | A temporary state between on and off. The components within the resource can take time to process the power off action. |
| PoweringOn | A temporary state between off and on. The components within the resource can take time to process the power on action. |
6.21.5.9.2 In Actions: BreakerControl, Actions: PowerControl:
The desired power state of the circuit if the breaker is reset successfully.
- This parameter shall contain the desired power state of the circuit.
| string | Description |
|---|---|
| Off | Power off. |
| On | Power on. |
| PowerCycle (v1.5+) | Power cycle.
|
6.21.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 percent (%
THD).
|
6.21.5.11 SensorEnergykWhExcerpt
The Sensor schema describes a sensor and its properties. This object is an excerpt of the Sensor resource located at the URI shown in DataSourceUri.
| ApparentkVAh (v1.5+) | number (kV.A.h) |
read-only (null) |
Apparent energy (kVAh).
|
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| LifetimeReading (v1.1+) | number | read-only (null) |
The total accumulation value for this
sensor.
|
| ReactivekVARh (v1.5+) | number (kV.A.h) |
read-only (null) |
Reactive energy (kVARh).
|
| Reading | number | read-only (null) |
The sensor value.
|
| SensorResetTime | string (date-time) |
read-only (null) |
The date and time when the time-based
properties were last reset.
|
6.21.5.12 SensorExcerpt
The Sensor schema describes a sensor and its properties. This object is an excerpt of the Sensor resource located at the URI shown in DataSourceUri.
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| Reading | number | read-only (null) |
The sensor value.
|
6.21.5.13 SensorPowerExcerpt
The Sensor schema describes a sensor and its properties. This object is an excerpt of the Sensor resource located at the URI shown in DataSourceUri.
| ApparentVA | number (V.A) |
read-only (null) |
The product of voltage and current for an
AC circuit, in volt-ampere units.
|
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| PhaseAngleDegrees (v1.5+) | number | read-only (null) |
The phase angle (degrees) between the
current and voltage waveforms.
|
| PowerFactor | number | read-only (null) |
The power factor for this
sensor.
|
| ReactiveVAR | number (V.A) |
read-only (null) |
The square root of the difference term of
squared apparent VA and squared power (Reading) for a circuit, in VAR
units.
|
| Reading | number | read-only (null) |
The sensor value.
|
6.21.5.14 SensorVoltageExcerpt
The Sensor schema describes a sensor and its properties. This object is an excerpt of the Sensor resource located at the URI shown in DataSourceUri.
| CrestFactor (v1.1+) | number | read-only (null) |
The crest factor for this
sensor.
|
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| Reading | number | read-only (null) |
The sensor value.
|
| THDPercent (v1.1+) | number (%) |
read-only (null) |
The total harmonic distortion percent (%
THD).
|
6.21.5.15 VoltageType
The type of voltage applied to the circuit.
- This property shall contain the type of voltage applied to the circuit.
| string | Description |
|---|---|
| AC | Alternating Current (AC) circuit. |
| DC | Direct Current (DC) circuit. |
6.21.6 Example response
{
"@odata.type": "#Circuit.v1_7_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.22 ComponentIntegrity 1.2.1
| Version | v1.2 | v1.1 | v1.0 |
| Release | 2022.2 | 2022.1 | 2021.4 |
6.22.1 Description
The ComponentIntegrity resource provides critical and pertinent security information about a specific device, system, software element, or other managed entity.
- This resource shall represent critical and pertinent security information about a specific device, system, software element, or other managed entity.
6.22.2 URIs
/redfish/v1/ComponentIntegrity/{ComponentIntegrityId}
6.22.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| ComponentIntegrityEnabled | boolean | read-write | An indication of whether security
protocols are enabled for the component.
|
| ComponentIntegrityType | string (enum) |
read-only required | The type of security technology for the
component.
|
| ComponentIntegrityTypeVersion | string | read-only required | The version of the security
technology.
|
| LastUpdated | string (date-time) |
read-only (null) |
The date and time when information for the
component was last updated.
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| ComponentsProtected [ { | array | An array of links to resources that the
target component protects.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| } | |||
| SPDM { | object | Integrity information about the SPDM
Responder as reported by an SPDM Requester.
|
|
| ComponentCommunication { | object | (null) |
Information about communication between
the SPDM Requester and SPDM Responder.
|
| Sessions [ { | array | The active sessions or communication
channels between two components.
|
|
| SessionId | integer | read-only (null) |
The identifier for an active session or
communication channel between two components.
|
| SessionType | string (enum) |
read-only (null) |
The type of session or communication
channel between two components.
|
| } ] | |||
| } | |||
| IdentityAuthentication { | object | (null) |
Identity authentication information about
the SPDM Requester and SPDM Responder.
|
| RequesterAuthentication { | object | (null) |
Authentication information of the identity
of the SPDM Requester.
|
| ProvidedCertificate { | object | A link to the certificate that represents
the identify of the SPDM Requester provided in mutual
authentication.
|
|
| @odata.id | string | read-only | Link to a Certificate resource. See the Links section and the Certificate schema for details. |
| } | |||
| } | |||
| ResponderAuthentication { | object | (null) |
Authentication information of the identity
of the SPDM Responder.
|
| ComponentCertificate { | object | A link to the certificate that represents
the identify of the component.
|
|
| @odata.id | string | read-only | Link to a Certificate resource. See the Links section and the Certificate schema for details. |
| } | |||
| VerificationStatus | string (enum) |
read-only (null) |
The status of the verification of the
identity of the component.
|
| } | |||
| } | |||
| MeasurementSet { | object | (null) |
Measurement information about the SPDM
Responder.
|
| Measurements [ { | array | Measurements from an SPDM
Responder.
|
|
| LastUpdated | string (date-time) |
read-only (null) |
The date and time when information for the
measurement was last updated.
|
| Measurement | string | read-only (null) |
The measurement data.
^[A-Za-z0-9+/]+={0,2}$ |
| MeasurementHashAlgorithm | string | read-only (null) |
The hash algorithm used to compute the
measurement.
|
| MeasurementIndex | integer | read-only (null) |
The index of the measurement.
|
| MeasurementType | string (enum) |
read-only (null) |
The type or characteristics of the data
that this measurement represents.
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| PartofSummaryHash | boolean | read-only (null) |
Indicates whether this measurement is part
of the measurement summary.
|
| SecurityVersionNumber (v1.1+) | string | read-only (null) |
The security version number the
measurement represents.
^[A-Za-z0-9]{16}$ |
| } ] | |||
| MeasurementSpecification | string (enum) |
read-only (null) |
The measurement specification negotiated
between the SPDM Requester and SPDM Responder.
|
| MeasurementSummary | string | read-only (null) |
The measurement summary data.
^[A-Za-z0-9+/]+={0,2}$ |
| MeasurementSummaryHashAlgorithm | string | read-only (null) |
The hash algorithm used to compute the
measurement summary.
|
| MeasurementSummaryType | string (enum) |
read-only (null) |
The type of measurement
summary.
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| } | |||
| Requester { | object | required | The link to the the component that is
reporting the integrity information of the target component.
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } | |||
| } | |||
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| TargetComponentURI | string | read-only required | The link to the the component whose
integrity that this resource reports.
|
| TPM { | object | Integrity information about the Trusted
Platform Module (TPM).
|
|
| ComponentCommunication { | object | (null) |
Information about communication with the
TPM.
|
| Sessions [ { | array | The active sessions or communication
channels between two components.
|
|
| SessionId | integer | read-only (null) |
The identifier for an active session or
communication channel between two components.
|
| SessionType | string (enum) |
read-only (null) |
The type of session or communication
channel between two components.
|
| } ] | |||
| } | |||
| IdentityAuthentication { | object | (null) |
Identity authentication information about
the TPM.
|
| ComponentCertificate { | object | A link to the certificate that represents
the identify of the component.
|
|
| @odata.id | string | read-only | Link to a Certificate resource. See the Links section and the Certificate schema for details. |
| } | |||
| VerificationStatus | string (enum) |
read-only (null) |
The status of the verification of the
identity of the component.
|
| } | |||
| MeasurementSet { | object | (null) |
Measurement information from the
TPM.
|
| Measurements [ { | array | Measurements from a TPM.
|
|
| LastUpdated | string (date-time) |
read-only (null) |
The date and time when information for the
measurement was last updated.
|
| Measurement | string | read-only (null) |
The measurement data.
^[A-Za-z0-9+/]+={0,2}$ |
| MeasurementHashAlgorithm | string | read-only (null) |
The hash algorithm used to compute the
measurement.
|
| PCR | integer | read-only (null) |
The Platform Configuration Register (PCR)
bank of the measurement.
|
| } ] | |||
| } | |||
| NonceSizeBytesMaximum (v1.2+) | integer | read-only (null) |
The maximum number of bytes that can be
specified in the Nonce parameter of the TPMGetSignedMeasurements
action.
|
| } |
6.22.4 Actions
6.22.4.1 SPDMGetSignedMeasurements
Description
This action generates an SPDM cryptographic signed statement over the given nonce and measurements of the SPDM Responder.
- This action
shall generate a cryptographic signed statement over the given nonce and
measurements corresponding to the SPDM Responder. This action shall not
be present if the ComponentIntegrityType property does not contain the
value
SPDM. The SPDM Requester shall issue one or more SPDM 'GET_MEASUREMENTS' requests for each of the requested measurement indices to the SPDM Responder. When the SPDM 'GET_MEASUREMENTS' requests are made for version 1.2, the parameter 'RawBitStreamRequested' shall contain0. The SPDM Requester shall provide the nonce for the action to the SPDM Responder in the last SPDM 'GET_MEASUREMENTS' request. The SPDM Requester shall request a signature in the last SPDM 'GET_MEASUREMENTS' request.
Action URI
{Base URI of target resource}/Actions/ComponentIntegrity.SPDMGetSignedMeasurements
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| MeasurementIndices [ ] | array (integer) | optional | An array of indices that identify the
measurement blocks to sign.
|
| Nonce | string | optional | A 32-byte hex-encoded string that is
signed with the measurements. The value should be unique.
^[0-9a-fA-F]{64}$ |
| SlotId | integer | optional | The slot identifier for the certificate
containing the private key to generate the signature over the
measurements.
|
Response Payload
| { | |||
| Certificate { | object | A link to the certificate corresponding to
the SPDM slot identifier that can be used to validate the
signature.
|
|
| @odata.id | string | read-only | Link to a Certificate resource. See the Links section and the Certificate schema for details. |
| } | |||
| HashingAlgorithm | string | read-only required | The hashing algorithm used for generating
the cryptographic signed statement.
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| PublicKey | string | read-only | A Privacy Enhanced Mail (PEM)-encoded
public key that can be used to validate the signature.
|
| SignedMeasurements | string | read-only required | Base64 encoded cryptographic signed
statement generated by the signer.
|
| SigningAlgorithm | string | read-only required | The asymmetric signing algorithm used for
generating the cryptographic signed statement.
|
| Version | string | read-only required | The SPDM version used by the SPDM
Responder to generate the cryptographic signed statement.
|
| } |
Request Example
{
"Nonce": "4f2359ee609824d33d35c2968b6c56b702a692ab0d8a441f25c7d81fbe833a78",
"SlotId": 0,
"MeasurementIndices": [
0,
1,
2
]
}Response Example
{
"@odata.type": "#ComponentIntegrity.v1_0_0.SPDMGetSignedMeasurementsResponse",
"Version": "1.1",
"HashingAlgorithm": "SHA256",
"SigningAlgorithm": "TPM_ALG_RSAPSS_3072",
"SignedMeasurements": "EeAQx8PJWv9CbeGdmlPaARrrMw... TRUNCATED (TYPICALLY KB or MB)",
"Certificate": {
"@odata.id": "/redfish/v1/Systems/437XR1138R2/Certificates/SScert"
}
}6.22.4.2 TPMGetSignedMeasurements (v1.2+)
Description
This action generates a TPM cryptographic signed statement over the given nonce and PCRs of the TPM for TPM 2.0 devices.
- This action
shall generate a cryptographic signed statement over the given nonce and
PCRs of the TPM for TPM 2.0 devices. This action shall not be present if
the ComponentIntegrityType property does not contain the value
TPM.
Action URI
{Base URI of target resource}/Actions/ComponentIntegrity.TPMGetSignedMeasurements
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| Certificate { | object | required | The URI for the certificate that
represents the TPM attestation key.
|
| @odata.id | string | read-only | Link to a Certificate resource. See the Links section and the Certificate schema for details. |
| } | |||
| Nonce | string | optional | A set of bytes as a hex-encoded string
that is signed with the measurements. The value should be
unique.
^[0-9a-fA-F]$ |
| PCRSelection | string | required | An object that identify the PCRs to
sign.
|
| Scheme | string | required | The signing scheme to use for the TPM
attestation key.
|
Response Payload
| { | |||
| Oem (v1.2+) {} | object | See the OEM object definition in the Using this guide clause. | |
| SignedMeasurements (v1.2+) | string | read-only required | The Base64-encoded cryptographic signed
statement generated by the signer.
|
| } |
Request Example
{
"Nonce": "4f2359ee609824d33d35c2968b6c56b702a692ab0d8a441f25c7d81fbe833a78",
"Certificate": {
"@odata.id": "/redfish/v1/Chassis/1/TrustedComponents/TPM1/Certificates/1"
},
"Scheme": "MzI5NDg=",
"PCRSelection": "MjM3NDA4MjM5ODQ="
}Response Example
{
"SignedMeasurements": "EeAQx8PJWv9CbeGdmlPaARrrMw... TRUNCATED (TYPICALLY KB or MB)"
}6.22.5 Property details
6.22.5.1 ComponentIntegrityType
The type of security technology for the component.
- This value of this property shall contain the underlying security technology providing integrity information for the component.
| string | Description |
|---|---|
| OEM | OEM-specific.
|
| SPDM | Security Protocol and Data Model (SPDM)
protocol.
|
| TPM | Trusted Platform Module (TPM).
|
6.22.5.2 MeasurementSpecification
The measurement specification negotiated between the SPDM Requester and SPDM Responder.
- This property shall contain the measurement specification negotiated between the SPDM Requester and SPDM Responder.
| string | Description |
|---|---|
| DMTF | DMTF.
|
6.22.5.3 MeasurementSummaryType
The type of measurement summary.
- This property shall contain the type of measurement summary.
| string | Description |
|---|---|
| All | The measurement summary covers all measurements in SPDM. |
| TCB | The measurement summary covers the TCB. |
6.22.5.4 MeasurementType
The type or characteristics of the data that this measurement represents.
- This property shall contain the type or
characteristics of the data that this measurement represents. This
property shall not be present if MeasurementSpecification does not
contain
DMTF.
| string | Description |
|---|---|
| FirmwareConfiguration | Firmware configuration, such as configurable firmware policy. |
| HardwareConfiguration | Hardware configuration, such as straps. |
| ImmutableROM | Immutable ROM. |
| MeasurementManifest | Measurement Manifest. |
| MutableFirmware | Mutable firmware or any mutable code. |
| MutableFirmwareSecurityVersionNumber | Mutable firmware security version number. |
| MutableFirmwareVersion | Mutable firmware version. |
6.22.5.5 SessionType
The type of session or communication channel between two components.
- This property shall contain the type of session or communication channel between two components.
| string | Description |
|---|---|
| AuthenticatedOnly | An established session where only authentication is protecting the communication. |
| EncryptedAuthenticated | An established session where both encryption and authentication are protecting the communication. |
| Plain | A plain text session without any protection. |
6.22.5.6 VerificationStatus
The status of the verification of the identity of the component.
- This property shall contain the status of the verification of the identity of the component referenced by the TargetComponentURI property..
| string | Description |
|---|---|
| Failed | Unsuccessful verification. |
| Success | Successful verification. |
6.22.6 Example response
{
"@odata.type": "#ComponentIntegrity.v1_2_1.ComponentIntegrity",
"Id": "TPM-0",
"Description": "TPM physically attached to a GPU.",
"Status": {
"Health": "OK",
"State": "Enabled"
},
"ComponentIntegrityType": "TPM",
"ComponentIntegrityTypeVersion": "1.2.0",
"ComponentIntegrityEnabled": true,
"LastUpdated": "2021-11-02T14:09:54-07:00",
"TargetComponentURI": "/redvish/v1/Systems/437XR1138R2#/TrustedModules/0",
"Links": {
"ComponentsProtected": [
{
"@odata.id": "/redfish/v1/Systems/437XR1138R2/GraphicsControllers/GPU1"
}
]
},
"TPM": {
"MeasurementSet": {
"Measurements": [
{
"PCR": 1,
"Measurement": "h6spEuxbyOtGhP35UoGhTcVX3iRaZQGDw4Yk5oQcabw=",
"LastUpdated": "2021-10-31T20:14:27-07:00",
"MeasurementHashAlgorithm": "TPM_ALG_SHA256"
},
{
"PCR": 3,
"Measurement": "GnbzS4ToNQb+Y7SxXw4AvRDTf4SzO5eeAlAlDca28AA=",
"LastUpdated": "2021-10-31T20:14:27-07:00",
"MeasurementHashAlgorithm": "TPM_ALG_SHA256"
},
{
"PCR": 1,
"Measurement": "pLJa5Dyh8CDYFZ1WNOrsiSG1eyCPBlre42CD7CTywg7VkcC4afw4ZG3gQxi2XEFCt5jxz6tN1/cbx/DNx2/tOg==",
"LastUpdated": "2021-10-31T20:14:27-07:00",
"MeasurementHashAlgorithm": "TPM_ALG_SHA512"
},
{
"PCR": 3,
"Measurement": "GBgEucATV8omirTmYqY+vvbbisHR1jBKfVAEK1XSifBHnnIYXopsc0NExURDSSyPjO21NrPqnwiq5LhI1p6rzQ==",
"LastUpdated": "2021-10-31T20:14:27-07:00",
"MeasurementHashAlgorithm": "TPM_ALG_SHA512"
}
]
},
"IdentityAuthentication": {
"VerificationStatus": "Success",
"ComponentCertificate": {
"@odata.id": "/redfish/v1/Systems/437XR1138R2/Certificates/TPMcert"
}
},
"ComponentCommunication": {
"Sessions": [
{
"SessionId": 4556,
"SessionType": "Plain"
}
]
}
},
"@odata.id": "/redfish/v1/ComponentIntegrity/TPM-0"
}6.23 CompositionReservation 1.0.0
| Version | v1.0 |
| Release | 2021.1 |
6.23.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.
- This resource represents the composition reservation of the composition service for a Redfish implementation.
6.23.2 URIs
/redfish/v1/CompositionService/CompositionReservations/{CompositionReservationId}
6.23.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.
|
| 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.
|
| } ] | |||
| 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.23.4 Property details
6.23.4.1 Expand
The expansion control for references in manifest responses, similar
to the $expand=. query parameter.
- This property shall contain the expansion control for references in manifest responses.
| string | Description |
|---|---|
| All | Expand all subordinate
references.
|
| None | Do not expand any references.
|
| Relevant | Expand relevant subordinate references.
Relevant references are those that are tied to a constrained composition
request, such as a request for a quantity of processors.
|
6.23.4.2 StanzaType
The type of stanza.
- This property shall contain 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.
|
| RegisterResourceBlock (v1.1+) | A stanza that references a resource, such
as a computer system, in order to create a resource block that
references the resource and add it to the free pool.
|
6.23.5 Example response
{
"@odata.type": "#CompositionReservation.v1_0_0.CompositionReservation",
"Id": "1",
"Name": "Composition Reservation 1",
"ReservationTime": "2019-08-22T10:35:16+06:00",
"Client": "VCF1001",
"ReservedResourceBlocks": [
{
"@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/BladeServer-2"
}
],
"Manifest": {
"Description": "Description for this Manifest document.",
"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-2"
}
]
}
}
}
]
},
"@odata.id": "/redfish/v1/CompositionService/CompositionReservations/1"
}6.24 CompositionService 1.2.1
| Version | v1.2 | v1.1 | v1.0 |
| Release | 2021.1 | 2018.2 | 2017.1 |
6.24.1 Description
The CompositionService schema describes a composition service and its properties and links to the resources available for composition.
- This resource shall represent the composition service and its properties for a Redfish implementation.
6.24.2 URIs
/redfish/v1/CompositionService
6.24.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.
|
|
| @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.
|
|
| @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.
|
|
| @odata.id | string | read-only | Link to Collection of ResourceBlock. See the ResourceBlock schema for details. |
| } | |||
| ReservationDuration (v1.2+) | string (duration) |
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.
^P(\d+D)?(T(\d+H)?(\d+M)?(\d+(.\d+)?S)?)?$ |
| ResourceBlocks { | object | The resource blocks available on the
service.
|
|
| @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.
|
|
| @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.
|
6.24.4 Actions
6.24.4.1 Compose (v1.2+)
Description
This action performs a set of operations specified by a manifest.
- This action shall perform a set of operations specified by a manifest. Services shall not apply any part of the manifest unless all operations specified by the manifest are successful.
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.
|
| 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.
|
| } ] | |||
| 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.
|
| RequestType | string (enum) |
required | The type of request.
|
| 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.
|
| 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.
|
| } ] | |||
| 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.
|
| RequestType (v1.2+) | string (enum) |
read-only required | The type of request.
|
| 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.24.5 Property details
6.24.5.1 Expand
The expansion control for references in manifest responses, similar
to the $expand=. query parameter.
- This property shall contain the expansion control for references in manifest responses.
| 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.24.5.2 RequestFormat
The format of the request.
- This parameter shall contain the format of the request.
| string | Description |
|---|---|
| Manifest | The request body contains a
manifest.
|
6.24.5.3 RequestType
The type of request.
- This parameter shall contain 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.24.5.4 StanzaType
The type of stanza.
- This property shall contain 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.
|
| RegisterResourceBlock (v1.1+) | A stanza that references a resource, such
as a computer system, in order to create a resource block that
references the resource and add it to the free pool.
|
6.24.6 Example response
{
"@odata.type": "#CompositionService.v1_2_1.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"
},
"@odata.id": "/redfish/v1/CompositionService"
}6.25 ComputerSystem 1.21.0
| Version | v1.21 | v1.20 | v1.19 | v1.18 | v1.17 | v1.16 | v1.15 | v1.14 | v1.13 | v1.12 | v1.11 | ... |
| Release | 2023.2 | 2022.3 | 2022.2 | 2022.1 | 2021.4 | 2021.2 | 2021.1 | 2020.4 | 2020.3 | 2020.2 | 2020.1 | ... |
6.25.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.
- This resource shall represent a computing system in the Redfish Specification.
6.25.2 URIs
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}
/redfish/v1/Systems/{ComputerSystemId}
6.25.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.
|
|
| @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) |
|
| 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.
|
| 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.
|
|
| @odata.id | string | read-only | Link to Collection of BootOption. See the BootOption schema for details. |
| } | |||
| BootOrder (v1.5+) [ ] | array (string, null) | read-write | An array of BootOptionReference strings
that represent the persistent boot order for with this computer system.
Changes to the boot order typically require a system reset before they
take effect. It is likely that a client finds the
@Redfish.Settings term in this resource, and if it is
found, the client makes requests to change boot order settings by
modifying the resource identified by the @Redfish.Settings
term.
|
| BootOrderPropertySelection (v1.6+) | string (enum) |
read-write (null) |
The name of the boot order property that
the system uses for the persistent boot order.
|
| BootSourceOverrideEnabled | string (enum) |
read-write (null) |
The state of the boot source override
feature.
|
| BootSourceOverrideMode (v1.1+) | string (enum) |
read-write (null) |
The BIOS boot mode to use when the system
boots from the BootSourceOverrideTarget boot source.
|
| BootSourceOverrideTarget | string (enum) |
read-write (null) |
The current boot source to use at the next
boot instead of the normal boot device, if BootSourceOverrideEnabled
does not contain Disabled.
|
| Certificates (v1.7+) { | object | The link to a collection of certificates
used for booting through HTTPS by this computer system.
|
|
| @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.
|
| TrustedModuleRequiredToBoot (v1.14+) | string (enum) |
read-write (null) |
The Trusted Module boot
requirement.
|
| 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.
|
| LastBootTimeSeconds (v1.18+) | number | read-only (null) |
The number of seconds the system spent
booting to the operating system during the last boot.
|
| LastState (v1.13+) | string (enum) |
read-only (null) |
The last boot progress state.
|
| 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 Using this guide clause. | |
| 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.
|
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| Composition (v1.18+) { | object | (null) |
Information about the composition
capabilities and state of the computer system.
|
| UseCases (v1.18+) [ ] | array (string (enum)) |
read-only (null) |
|
| } | |||
| EthernetInterfaces { | object | The link to the collection of Ethernet
interfaces associated with this system.
|
|
| @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.
|
|
| @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 |
|
| 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.
|
|
| @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 Using this guide clause. | |
| 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 enumerations of HostingRoles specify
different features that the hosting ComputerSystem supports.
|
| 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 Using this guide clause. | |
| Status (v1.5+) {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| TimeoutAction (v1.5+) | string (enum) |
read-write
required (null) |
The action to perform when the watchdog
timer reaches its timeout value.
|
| 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.
|
| } | |||
| IdlePowerSaver (v1.16+) { | object | (null) |
The idle power saver settings of the
computer system.
|
| Enabled (v1.16+) | boolean | read-write | An indication of whether idle power saver
is enabled.
|
| EnterDwellTimeSeconds (v1.16+) | integer (seconds) |
read-write (null) |
The duration in seconds the computer
system is below the EnterUtilizationPercent value before the idle power
save is activated.
|
| EnterUtilizationPercent (v1.16+) | number (%) |
read-write (null) |
The percentage of utilization when the
computer system enters idle power save. If the computer system's
utilization goes below this value, it enters idle power
save.
|
| ExitDwellTimeSeconds (v1.16+) | integer (seconds) |
read-write (null) |
The duration in seconds the computer
system is above the ExitUtilizationPercent value before the idle power
save is stopped.
|
| ExitUtilizationPercent (v1.16+) | number (%) |
read-write (null) |
The percentage of utilization when the
computer system exits idle power save. If the computer system's
utilization goes above this value, it exits idle power save.
|
| } | |||
| IndicatorLED (deprecated v1.13) | string (enum) |
read-write (null) |
The state of the indicator LED, which
identifies the system.
|
| KeyManagement (v1.16+) { | object | (null) |
The key management settings of the
computer system.
|
| KMIPCertificates (v1.16+) { | object | The link to a collection of server
certificates for the servers referenced by the KMIPServers
property.
|
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| KMIPServers (v1.16+) [ { | array | The KMIP servers to which this computer
system is subscribed.
|
|
| Address (v1.16+) | string | read-write (null) |
The KMIP server address.
|
| CacheDuration (v1.20+) | string (duration) |
read-write (null) |
The duration the system caches KMIP
data.
^P(\d+D)?(T(\d+H)?(\d+M)?(\d+(.\d+)?S)?)?$ |
| CachePolicy (v1.20+) | string (enum) |
read-write (null) |
The cache policy to control how KMIP data
is cached.
|
| Password (v1.16+) | string | read-write (null) |
The password to access the KMIP server.
The value is null in responses.
|
| Port (v1.16+) | integer | read-write (null) |
The KMIP server port.
|
| Username (v1.16+) | string | read-write (null) |
The username to access the KMIP
server.
|
| } ] | |||
| } | |||
| 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. |
| } ] | |||
| HostingComputerSystem (v1.21+) { | object | (null) |
The link to the system that is hosting
this virtual machine.
|
| @odata.id | string | read-only | Link to another ComputerSystem resource. |
| } | |||
| 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 Using this guide clause. | |
| OffloadedNetworkDeviceFunctions (v1.17+) [ { | array | The network device functions to which this
system performs offload computation, such as with a
SmartNIC.
|
|
| @odata.id | string | read-only | Link to a NetworkDeviceFunction resource. See the Links section and the NetworkDeviceFunction schema for details. |
| } ] | |||
| 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. |
| } ] | |||
| TrustedComponents (v1.19+) [ { | array | An array of links to the trusted
components for this system.
|
|
| @odata.id | string | read-only | Link to a TrustedComponent resource. See the Links section and the TrustedComponent schema for details. |
| } ] | |||
| VirtualMachines (v1.21+) [ { | array | An array of links to the virtual machines
this system is hosting.
|
|
| @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.
|
|
| @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.
|
| ManufacturingMode (v1.18+) | boolean | read-only (null) |
An indication of whether the system is in
manufacturing mode. Manufacturing mode is a special boot mode, not
normally available to end users, that modifies features and settings for
use while the system is being manufactured and tested.
|
| Measurements (v1.14+, deprecated v1.17 [ { | 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.
|
|
| @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.
|
|
| @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.
|
| Metrics (v1.8+) { | object | The link to the metrics associated with
all memory in this system.
|
|
| @odata.id | string | read-only | Link to a MemoryMetrics resource. See the Links section and the MemoryMetrics schema for details. |
| } | |||
| Status (deprecated v1.16) {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| 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.
|
|
| @odata.id | string | read-only | Link to Collection of NetworkInterface. See the NetworkInterface schema for details. |
| } | |||
| OperatingSystem (v1.21+) { | object | The link to the operating system
information associated with this system.
|
|
| @odata.id | string | read-only | Link to a OperatingSystem resource. See the Links section and the OperatingSystem 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.
|
| 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.
|
| PowerState | string (enum) |
read-only (null) |
The current power state of the
system.
|
| Processors { | object | The link to the collection of processors
associated with this system.
|
|
| @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.
|
|
| @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 (deprecated v1.16) {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| 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 common redundancy definition and
structure used in other Redfish schemas.
|
|
| SecureBoot (v1.1+) { | object | The link to the UEFI Secure Boot
associated with this system.
|
|
| @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.
|
|
| 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.
|
|
| Telnet (v1.13+) {} | object | The connection details for a Telnet serial
console service.
|
|
| } | |||
| 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.
|
|
| @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.
|
|
| Storage (v1.1+) { | object | The link to the collection of storage
devices associated with this system.
|
|
| @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.
|
| TrustedModules (v1.1+, deprecated v1.19 [ { | 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.
|
| InterfaceTypeSelection (v1.3+) | string (enum) |
read-only (null) |
The interface type selection supported by
this Trusted Module.
|
| Oem (v1.1+) {} | object | See the OEM object definition in the Using this guide clause. | |
| Status (v1.1+) {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| } ] | |||
| USBControllers (v1.15+) { | object | The link to a collection of USB
controllers for this system.
|
|
| @odata.id | string | read-only | Link to Collection of USBController. See the USBController schema for details. |
| } | |||
| UUID | string (uuid) |
read-only (null) |
The UUID for this system.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
For more information about this property, see Property
details. |
| VirtualMedia (v1.13+) { | object | The link to the virtual media services for
this system.
|
|
| @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.25.4 Actions
6.25.4.1 AddResourceBlock (v1.6+)
Description
This action adds a resource block to a system.
- This action shall add 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.
|
| @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.
|
Request Example
{
"ResourceBlock": {
"@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/Offload-GPU1"
},
"ResourceBlockETag": "W/\"19472363938\"",
"ComputerSystemETag": "W/\"99374369273\""
}6.25.4.2 Decommission (v1.21+)
Description
This action decommissions a system.
- This action shall remove all specified data from a system in preparation to decommission the system.
Action URI
{Base URI of target resource}/Actions/ComputerSystem.Decommission
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| ComputerSystemETag | string | optional | The current ETag of the
system.
|
| DecommissionTypes [ ] | array (string (enum)) |
read-write |
|
| OEMDecommissionTypes [ ] | array (string) | optional | The OEM-specific types of data to remove
from the system.
|
| RequireSecureErase | boolean | optional | Ensure secure erasure of all devices and
fail the request if not possible.
|
Request Example
{
"DecommissionTypes": [
"All"
],
"RequireSecureErase": false
}6.25.4.3 RemoveResourceBlock (v1.6+)
Description
This action removes a resource block from a system.
- This action shall remove 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.
|
| @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.
|
Request Example
{
"ResourceBlock": {
"@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/Offload-GPU1"
},
"ResourceBlockETag": "W/\"19472363938\"",
"ComputerSystemETag": "W/\"99374369273\""
}6.25.4.4 Reset
Description
This action resets the system.
- This action shall reset the system represented by the resource. For systems that implement ACPI Power Button functionality, the PushPowerButton value shall perform or emulate an ACPI Power Button Push, and the ForceOff value shall perform an ACPI Power Button Override, commonly known as a four-second hold of the power button.
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.
|
Request Example
{
"ResetType": "ForceRestart"
}6.25.4.5 SetDefaultBootOrder (v1.5+)
Description
This action sets the BootOrder to the default settings.
- This action shall set the BootOrder array to the default settings.
Action URI
{Base URI of target resource}/Actions/ComputerSystem.SetDefaultBootOrder
Action parameters
This action takes no parameters.
6.25.5 Property details
6.25.5.1 AliasBootOrder
- Ordered array of boot source aliases representing the persistent boot order associated with this computer system.
- This property shall contain an ordered array of boot source aliases of the BootSource type that represents the persistent boot order of this computer system. This array shall not contain duplicate values. Virtual devices for an alias should take precedence over a physical device. Systems may attempt to boot from multiple devices that share an alias.
| 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. |
| Recovery | Boot to a system-designated recovery process or image. |
| 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.25.5.2 AutomaticRetryConfig
The configuration of how the system retries booting automatically.
- This property shall contain the configuration of how the system retry 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.25.5.3 BootOrderPropertySelection
The name of the boot order property that the system uses for the persistent boot order.
- This property shall indicate which boot order property 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.25.5.4 BootSourceOverrideEnabled
The state of the boot source override feature.
- This property
shall contain
Oncefor a one-time boot override, andContinuousfor a remain-active-until-cancelled override. If set toOnce, the value is reset toDisabledafter the BootSourceOverrideTarget actions have completed successfully. Changes to this property do not alter the BIOS persistent boot order configuration.
| 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.25.5.5 BootSourceOverrideMode
The BIOS boot mode to use when the system boots from the BootSourceOverrideTarget boot source.
- This property shall contain 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.25.5.6 BootSourceOverrideTarget
The current boot source to use at the next boot instead of the normal
boot device, if BootSourceOverrideEnabled does not contain
Disabled.
- This property shall contain the source to
boot the system from, overriding the normal boot order. The
@Redfish.AllowableValues annotation specifies the valid values for this
property.
UefiTargetindicates to boot from the UEFI device path found in UefiTargetBootSourceOverride.UefiBootNextindicates to boot from the UEFI BootOptionReference found in BootNext. Virtual devices for a target should take precedence over a physical device. Systems may attempt to boot from multiple devices that share a target identifier. Changes to this property do not alter the BIOS persistent boot order configuration.
| 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. |
| Recovery (v1.19+) | Boot to a system-designated recovery process or image. |
| 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.25.5.7 CachePolicy
The cache policy to control how KMIP data is cached.
- This property shall contain the cache policy to control how KMIP data is cached.
| string | Description |
|---|---|
| AfterFirstUse | The system caches KMIP data after first use for the duration specified by the CacheDuration property. |
| None | The system does not cache KMIP data. |
6.25.5.8 ConnectTypesSupported
- This property enumerates the graphical console connection types that the implementation allows.
- This property shall contain an array of the enumerations. KVMIP shall be included if a vendor-define KVM-IP protocol is supported.
| 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.25.5.9 DecommissionTypes
- The types of data to remove from the system.
- This parameter shall contain a list of the types of data to remove from the system.
| string | Description |
|---|---|
| All | Remove all possible data from the
server.
|
| BIOSConfig | Reset all BIOS settings to factory
defaults.
|
| Logs | Clear all logs.
|
| ManagerConfig | Reset all manager settings to factory
defaults.
|
| NetworkConfig | Reset all network settings to factory
defaults.
|
| StorageConfig | Reset all storage controller settings to
factory defaults. This will leave the user data intact unless that is
also specified.
|
| UserData | Remove all possible data from block
devices and other user or operating system accessible storage attached
to the system.
|
6.25.5.10 HostingRoles
The enumerations of HostingRoles specify different features that the hosting ComputerSystem supports.
- The hosting roles that this
computer system supports.
- This property shall contain 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.25.5.11 IndicatorLED
The state of the indicator LED, which identifies the system.
- This property shall contain the state of the indicator light, which identifies this 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.
|
6.25.5.12 InterfaceType
The interface type of the Trusted Module.
- This property shall contain the interface type of the installed 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.25.5.13 InterfaceTypeSelection
The interface type selection supported by this Trusted Module.
- This property shall contain the interface type Selection method (for example to switch between TPM1_2 and TPM2_0) that is supported by this TrustedModule.
| 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.25.5.14 LastState
The last boot progress state.
- This property shall contain 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.25.5.15 MemoryMirroring
The ability and type of memory mirroring that this computer system supports.
- This property shall contain 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.25.5.16 PowerMode
The power mode setting of the computer system.
- This property shall contain the computer system power mode setting.
| 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.25.5.17 PowerRestorePolicy
The desired power state of the system when power is restored after a power loss.
- This property shall indicate the desired PowerState
of the system when power is applied to the system. The
LastStatevalue shall return the system to the PowerState it was in when power was lost.
| 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.25.5.18 PowerState
The current power state of the system.
- This property shall contain the power state of the system.
| string | Description |
|---|---|
| Off | The resource is powered off. The components within the resource might continue to have AUX power. |
| On | The resource is powered on. |
| Paused | The resource is paused. |
| PoweringOff | A temporary state between on and off. The components within the resource can take time to process the power off action. |
| PoweringOn | A temporary state between off and on. The components within the resource can take time to process the power on action. |
6.25.5.19 ResetType
The type of reset.
- This parameter shall contain the type of reset. The service can accept a request without the parameter and perform an implementation-specific default reset. Services should include the @Redfish.AllowableValues annotation for this parameter to ensure compatibility with clients, even when ActionInfo has been implemented.
| string | Description |
|---|---|
| ForceOff | Turn off the unit immediately
(non-graceful shutdown).
|
| ForceOn | Turn on the unit immediately.
|
| ForceRestart | Shut down immediately and non-gracefully
and restart the system.
|
| GracefulRestart | Shut down gracefully and restart the
system.
|
| GracefulShutdown | Shut down gracefully and power
off.
|
| Nmi | Generate a diagnostic interrupt, which is
usually an NMI on x86 systems, to stop normal operations, complete
diagnostic actions, and, typically, halt the system.
|
| On | Turn on the unit.
|
| Pause | Pause execution on the unit but do not
remove power. This is typically a feature of virtual machine
hypervisors.
|
| PowerCycle | Power cycle the unit. Behaves like a full
power removal, followed by a power restore to the resource.
|
| PushPowerButton | Simulate the pressing of the physical
power button on this unit.
|
| Resume | Resume execution on the paused unit. This
is typically a feature of virtual machine hypervisors.
|
| Suspend | Write the state of the unit to disk before
powering off. This allows for the state to be restored when powered back
on.
|
6.25.5.20 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.25.5.21 StopBootOnFault
If the boot should stop on a fault.
- This property shall contain the setting 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.25.5.22 SystemType
The type of computer system that this resource represents.
- An enumeration that indicates the kind of system that this resource represents.
| string | Description |
|---|---|
| Composed (v1.4+) | A computer system constructed by binding
resource blocks together.
|
| DPU (v1.16+) | A computer system that performs the
functions of a data processing unit, such as a SmartNIC.
|
| OS (deprecated v1.21) | 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.25.5.23 TimeoutAction
The action to perform when the watchdog timer reaches its timeout value.
- This property shall contain 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.25.5.24 TrustedModuleRequiredToBoot
The Trusted Module boot requirement.
- This property shall contain the Trusted Module boot requirement.
| string | Description |
|---|---|
| Disabled | No Trusted Module requirement to
boot.
|
| Required | A functional Trusted Module is required to
boot.
|
6.25.5.25 UseCases
- The composition use cases in which this computer system can participate.
- This property shall contain the composition use cases in which this computer system can participate.
| string | Description |
|---|---|
| ExpandableSystem | This computer system supports expandable
system composition and is associated with a resource block.
|
| ResourceBlockCapable | This computer system supports being
registered as a resource block in order for it to participate in
composition requests.
|
6.25.5.26 UUID
The UUID for this system.
- This property shall contain the
universal unique identifier number for this system. RFC4122 describes
methods to create this value. The value should be considered to be
opaque. Client software should only treat the overall value as a UUID
and should not interpret any sub-fields within the UUID. If the system
supports SMBIOS, the property value should follow the SMBIOS 2.6 and
later recommendation for converting the SMBIOS 16-byte UUID structure
into the Redfish canonical
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxstring format, so that the property value matches the byte order presented by current OS APIs, such as WMI and dmidecode.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
The UUID property contains the value of the Universally Unique IDentifier (UUID) of a system, also known in some systems as GUIDs (Globally Unique IDentifier). A UUID is 128 bits long (16 bytes).
Redfish clients should consider the value of the property to be opaque and should not interpret any sub-fields within the UUID.
The UUID property is a string data type. The RFC4122-specified
36-character string format is
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, where each
x represents a hexadecimal value from 0 to
f.
If the computer system supports SMBIOS, the UUID string should be formed from the raw binary 16-byte SMBIOS UUID structure. This allows out-of-band clients to correlate the UUID that in-band agents are reading from SMBIOS. The UUID is represented out-of-band through the Redfish API.
6.25.5.26.1 Case sensitivity
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.
Comparisons between UUID values should always be case-insensitive.
For new Redfish implementations, the recommendation is to follow RFC4122 guidelines: output using lower-case hex values when converting from the SMBIOS raw binary data.
Redfish implementations and operating system APIs are permitted to output in uppercase. For that reason, Redfish clients MUST compare UUIDs using a case-insensitive comparison (as recommended by RFC4122).
6.25.5.26.2 Conversion of UUID format
The SMBIOS 2.6 and later specification specifies the proper algorithm
for converting the raw binary SMBIOS 16-byte structure into the
canonical string format of xxxxxx-xxxx-xxxx-xxxx-xxxxxx).
Redfish services should follow the SMBIOS 2.6 and later specification
for implementing this conversion.
WMI and Linux dmidecode also follow the SMBIOS guidelines.
Specifically, RFC4122 defines that the canonical string value should follow network byte ordering. The SMBIOS represents the UUID as these fields:
{
DWORD time_low,
WORD time_mid,
WORD time_hi_and_version,
BYTE clock_seq_hi_and_reserved,
BYTE clock_seq_low,
BYTE[6] node
}Little-endian systems (including x86 systems) require a little-endian to network-byte-order conversion for the first three fields in order to convert the SMBIOS binary UUID to network byte order.
As specified in the SMBIOS 2.6 and later specifications, if the canonical UUID string is:
00112233-4455-6677-8899-aabbccddeeffThe corresponding raw representation in the SMBIOS UUID structure is:
raw_smbios_uuid = {
0x33,
0x22,
0x11,
0x00,
0x55,
0x44,
0x77,
0x66,
0x88,
0x99,
0xAA,
0xBB,
0xCC,
0xDD,
0xEE,
0xFF
}Notice in the above SMBIOS representation that each of the first three words boundaries are in little-endian order. For example, the hex digits '00112233' are represented by the first raw SMBIOS 4-byte DWORD '0x33, 0x22, 0x11, 0x00'. The following sample code (written in C) could be used to convert the raw SMBIOS UUID struct in a little-endian system to the 35-character canonical string:
/* routine to convert raw little-endian smbios structure to canonical string */
sprintf(
redfishUUID,
"%02x%02x%02x%02x-%02x%02x-%02x%02x-%02x%02x-%02x%02x%02x%02x%02x%02x",
raw_smbios_uuid[3], raw_smbios_uuid[2],
raw_smbios_uuid[1], raw_smbios_uuid[0],
raw_smbios_uuid[5],raw_smbios_uuid[4],
raw_smbios_uuid[7], raw_smbios_uuid[6],
raw_smbios_uuid[8], raw_smbios_uuid[9],
raw_smbios_uuid[10], raw_smbios_uuid[11],
raw_smbios_uuid[12], raw_smbios_uuid[13],
raw_smbios_uuid[14], raw_smbios_uuid[15]
);The previous sample code creates the same canonical-formated string as WMI and dmidecode for little-endian X86 systems.
If the computer architecture is not little-endian, then the conversion and canonical representation should be the same as the operating system's APIs, such as WMI and dmidecode.
Note: As specified in RFC4122, the fields in the string should be zero-filled hexadecimal values, as shown in the previous conversion code, so that the overall string length and format is
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx.
6.25.5.27 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.
- This property shall contain the action to perform before the watchdog timer expires. 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.25.6 Example response
{
"@odata.type": "#ComputerSystem.v1_21_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"
],
"LocationIndicatorActive": false,
"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"
},
"MemorySummary": {
"TotalSystemMemoryGiB": 96,
"TotalSystemPersistentMemoryGiB": 0,
"MemoryMirroring": "None"
},
"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.26 Connection 1.3.0
| Version | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2023.2 | 2023.1 | 2021.1 | 2020.3 |
6.26.1 Description
The Connection schema describes the access permissions endpoints, or groups of endpoints, have with other resources in the service.
- This resource shall represent a connection information in the Redfish Specification.
6.26.2 URIs
/redfish/v1/Fabrics/{FabricId}/Connections/{ConnectionId}
6.26.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| ConnectionKeys (v1.1+) { | object | The permission keys required to access the
specified resources for this connection.
|
|
| CHAP (v1.2+) { | object | (null) |
The CHAP-specific permission key
information for this connection.
|
| CHAPPassword (v1.2+) | string | read-write (null) |
The password for CHAP authentication. The
value is null in responses.
|
| CHAPUsername (v1.2+) | string | read-write (null) |
The username for CHAP
authentication.
|
| InitiatorCHAPPassword (v1.2+) | string | read-write (null) |
The initiator shared secret for mutual
(2-way) CHAP authentication. The value is null in
responses.
|
| InitiatorCHAPUsername (v1.2+) | string | read-write (null) |
The initiator username for mutual (2-way)
CHAP authentication.
|
| TargetCHAPPassword (v1.2+) | string | read-write (null) |
The target shared secret for mutual
(2-way) CHAP authentication. The value is null in
responses.
|
| } | |||
| DHCHAP (v1.2+) { | object | (null) |
The DHCHAP-specific permission key
information for this connection.
|
| LocalDHCHAPAuthSecret (v1.2+) | string | read-write (null) |
The local DHCHAP authentication secret.
The value is null in responses.
|
| PeerDHCHAPAuthSecret (v1.2+) | string | read-write (null) |
The peer DHCHAP authentication secret. The
value is null in responses.
|
| } | |||
| 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.
^0[xX]([a-fA-F]|[0-9]){2}$ |
| 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.
^0[xX](([a-fA-F]|[0-9]){2}){4}$ |
| RKeyReadWriteKey (v1.1+) | string | read-write | The read-write Region Key for this
connection.
^0[xX](([a-fA-F]|[0-9]){2}){4}$ |
| } | |||
| } | |||
| ConnectionType | string (enum) |
read-only (null) |
The type of resources this connection
specifies.
|
| 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 Using this guide clause. | |
| 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) |
|
| AccessState (v1.1+) | string (enum) |
read-write (null) |
The access state for this
connection.
|
| MemoryChunk (v1.1+) { | object | (null) |
The specified memory chunk.
|
| @odata.id | string | read-write | Link to a MemoryChunks resource. See the Links section and the MemoryChunks schema for details. |
| } | |||
| } ] | |||
| MemoryRegionInfo (v1.3+) [ { | array | The set of memory regions and access
capabilities specified for this connection.
|
|
| AccessCapabilities (v1.3+) [ ] | array (string (enum)) |
read-write (null) |
|
| AccessState (v1.3+) | string (enum) |
read-write (null) |
The access state for this
connection.
|
| MemoryRegion (v1.3+) { | object | (null) |
The specified memory region.
|
| @odata.id | string | read-write | Link to a MemoryRegion resource. See the Links section and the MemoryRegion schema for details. |
| } | |||
| } ] | |||
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| VolumeInfo [ { | array | The set of volumes and access capabilities
specified for this connection.
|
|
| AccessCapabilities [ ] | array (string (enum)) |
read-write (null) |
|
| AccessState | string (enum) |
read-write (null) |
The access state for this
connection.
|
| LUN (v1.2+) | integer | read-write (null) |
The initiator-visible logical unit number
(LUN) assigned to this volume.
|
| Volume { | object | The specified volume.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } | |||
| } ] |
6.26.4 Property details
6.26.4.1 AccessCapabilities
- Supported IO access capabilities.
- Each entry shall specify a current memory access capability.
| 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.26.4.2 AccessState
The access state for this connection.
- The value of this property shall contain the access state for the associated resource in 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.26.4.3 ConnectionType
The type of resources this connection specifies.
- This property shall contain 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.26.5 Example response
{
"@odata.type": "#Connection.v1_3_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.27 ConnectionMethod 1.1.0
| Version | v1.1 | v1.0 |
| Release | 2022.3 | 2020.2 |
6.27.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.
- This resource shall represent a connection method for a Redfish implementation.
6.27.2 URIs
/redfish/v1/AggregationService/ConnectionMethods/{ConnectionMethodId}
6.27.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| ConnectionMethodType | string (enum) |
read-only (null) |
The type of connection method.
|
| 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 Using this guide clause. | |
| } | |||
| TunnelingProtocol (v1.1+) | string (enum) |
read-only (null) |
The tunneling protocol used for this
connection method.
|
6.27.4 Property details
6.27.4.1 ConnectionMethodType
The type of connection method.
- This property shall contain an identifier of the 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.27.4.2 TunnelingProtocol
The tunneling protocol used for this connection method.
- This property shall contain the tunneling protocol used for this connection method.
| string | Description |
|---|---|
| OEM | OEM tunneling.
|
| SSH | SSH tunneling.
|
6.27.5 Example response
{
"@odata.type": "#ConnectionMethod.v1_1_0.ConnectionMethod",
"Id": "ConnectionMethod1",
"Name": "ConnectionMethod One",
"ConnectionMethodType": "Redfish",
"ConnectionMethodVariant": "Contoso",
"Links": {
"AggregationSources": [
{
"@odata.id": "/redfish/v1/AggregationService/AggregationSources/AggregationSource1"
}
]
},
"@odata.id": "/redfish/v1/AggregationService/ConnectionMethods/ConnectionMethod1"
}6.28 Container 1.0.0
| Version | v1.0 |
| Release | 2023.2 |
6.28.1 Description
The Container schema represents an instance of a container that is running on a computer system.
- This resource shall represent an instance of a container that is running on a computer system.
6.28.2 URIs
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/OperatingSystem/Containers/{ContainerId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/OperatingSystem/Containers/{ContainerId}
/redfish/v1/Systems/{ComputerSystemId}/OperatingSystem/Containers/{ContainerId}
6.28.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| EthernetInterfaces { | object | The link to the collection of Ethernet
interfaces associated with this container.
|
|
| @odata.id | string | read-only | Link to Collection of EthernetInterface. See the EthernetInterface schema for details. |
| } | |||
| Limits { | object | (null) |
The resource limits allocated to this
container.
|
| CPUCount | number | read-only (null) |
The number of processors available to this
container.
|
| MemoryBytes | integer (bytes) |
read-only (null) |
The amount of memory available to this
container in bytes.
|
| } | |||
| Links { | object | The links to other resources that are
related to this resource.
|
|
| ContainerImage { | object | The link to the container image for this
container.
|
|
| @odata.id | string | read-only | Link to a ContainerImage resource. See the Links section and the ContainerImage schema for details. |
| } | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| } | |||
| MountPoints [ { | array | The file system mount points configured
for this container.
|
|
| Destination | string | read-only (null) |
The file system path in the container that
is provided as the mount point to access the files and folders contained
in the source path.
|
| Source | string | read-only (null) |
The file system path from the hosting
system that is provided to this container.
|
| } ] | |||
| ProgrammaticId | string | read-only (null) |
The programmatic identifier for this
container.
|
| StartTime | string (date-time) |
read-only (null) |
The date and time when the container
started running.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
6.28.4 Actions
6.28.4.1 Reset
Description
This action resets the container.
- This action shall reset the container.
Action URI
{Base URI of target resource}/Actions/Container.Reset
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| ResetType | string (enum) |
optional | The type of reset.
|
Request Example
{
"ResetType": "GracefulRestart"
}6.28.5 Property details
6.28.5.1 ResetType
The type of reset.
- This parameter shall contain the type of
reset.
GracefulRestartandForceRestartshall indicate requests to restart the container.GracefulShutdownandForceOffshall indicate requests to stop or disable the container.OnandForceOnshall indicate requests to start or enable the container. The service can accept a request without the parameter and shall perform aGracefulRestart.
| string | Description |
|---|---|
| ForceOff | Turn off the unit immediately
(non-graceful shutdown).
|
| ForceOn | Turn on the unit immediately.
|
| ForceRestart | Shut down immediately and non-gracefully
and restart the system.
|
| GracefulRestart | Shut down gracefully and restart the
system.
|
| GracefulShutdown | Shut down gracefully and power
off.
|
| Nmi | Generate a diagnostic interrupt, which is
usually an NMI on x86 systems, to stop normal operations, complete
diagnostic actions, and, typically, halt the system.
|
| On | Turn on the unit.
|
| Pause | Pause execution on the unit but do not
remove power. This is typically a feature of virtual machine
hypervisors.
|
| PowerCycle | Power cycle the unit. Behaves like a full
power removal, followed by a power restore to the resource.
|
| PushPowerButton | Simulate the pressing of the physical
power button on this unit.
|
| Resume | Resume execution on the paused unit. This
is typically a feature of virtual machine hypervisors.
|
| Suspend | Write the state of the unit to disk before
powering off. This allows for the state to be restored when powered back
on.
|
6.28.6 Example response
{
"@odata.type": "#Container.v1_0_0.Container",
"Id": "WebBusinessLogic",
"Name": "Internal Web Business Logic",
"StartTime": "2021-02-06T22:49:02Z",
"Limits": {
"MemoryBytes": 4294967296,
"CPUCount": 1.5
},
"Status": {
"State": "Enabled"
},
"MountPoints": [
{
"Source": "/opt/MyContainerStorage/WebConfig",
"Destination": "/config"
}
],
"ProgrammaticId": "5584c257aba833892e1841cb77d898edc1f942f3bf901e7e0c390a504b9897a0",
"EthernetInterfaces": {
"@odata.id": "/redfish/v1/Systems/VM1/OperatingSystem/Containers/WebBusinessLogic/EthernetInterfaces"
},
"Links": {
"ContainerImage": {
"@odata.id": "/redfish/v1/Systems/VM1/OperatingSystem/ContainerImages/WebLogic"
}
},
"@odata.id": "/redfish/v1/Systems/VM1/OperatingSystem/Containers/WebBusinessLogic"
}6.29 ContainerImage 1.0.0
| Version | v1.0 |
| Release | 2023.2 |
6.29.1 Description
The ContainerImage schema represents a container image available to a computer system.
- This resource shall represent a container image available to a computer system.
6.29.2 URIs
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/OperatingSystem/ContainerImages/{ContainerImageId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/OperatingSystem/ContainerImages/{ContainerImageId}
/redfish/v1/Systems/{ComputerSystemId}/OperatingSystem/ContainerImages/{ContainerImageId}
6.29.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| CreateTime | string (date-time) |
read-only (null) |
The date and time when the container image
was created.
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| Containers [ { | array | The array of links to the containers
running from this container image.
|
|
| @odata.id | string | read-only | Link to a Container resource. See the Links section and the Container schema for details. |
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| SoftwareImage { | object | The link to the software image for this
container image.
|
|
| @odata.id | string | read-only | Link to a SoftwareInventory resource. See the Links section and the SoftwareInventory schema for details. |
| } | |||
| } | |||
| ProgrammaticId | string | read-only (null) |
The programmatic identifier for this
container image.
|
| SizeBytes | integer (bytes) |
read-only (null) |
The size of this container image in
bytes.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| Type | string (enum) |
read-only (null) |
The image type of this container
image.
|
| Version | string | read-only (null) |
The version of this
application.
|
6.29.4 Property details
6.29.4.1 Type
The image type of this container image.
- This property shall contain the supported image types for this container engine.
| string | Description |
|---|---|
| DockerV1 | Docker V1.
|
| DockerV2 | Docker V2.
|
| OCI | OCI (Open Container
Initiative).
|
6.29.5 Example response
{
"@odata.type": "#ContainerImage.v1_0_0.ContainerImage",
"Id": "WebLogic",
"Name": "Contoso Internal Web Business Logic 1.0",
"CreateTime": "2021-02-06T22:49:02Z",
"Type": "OCI",
"Version": "1.0.0",
"Status": {
"State": "Enabled"
},
"ProgrammaticId": "2fbd319a987e5265aae45b7e786dead51d1aae48b7bea42bcfc91a62934ca37f",
"SizeBytes": 373293056,
"Links": {
"Containers": [
{
"@odata.id": "/redfish/v1/Systems/VM1/OperatingSystem/Containers/WebBusinessLogic"
}
]
},
"@odata.id": "/redfish/v1/Systems/VM1/OperatingSystem/ContainerImages/WebLogic"
}6.30 Control 1.4.0
| Version | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2023.2 | 2023.1 | 2022.2 | 2021.4 | 2021.2 |
6.30.1 Description
The Control schema describes a control point and its properties.
- This resource shall represent a control point for a Redfish implementation.
6.30.2 URIs
/redfish/v1/Chassis/{ChassisId}/Controls/{ControlId}
6.30.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Accuracy (deprecated v1.4) | number (%) |
read-only (null) |
The estimated percent error of measured
versus actual values.
|
| AllowableMax | number | read-only (null) |
The maximum possible setting for this
control.
|
| AllowableMin | number | read-only (null) |
The minimum possible setting for this
control.
|
| AllowableNumericValues [ ] | array (number, null) | read-only | The supported values for the set
point.
|
| AssociatedSensors [ { | array | An array of links to the sensors
associated with this control.
|
|
| @odata.id | string | read-only | Link to a Sensor resource. See the Links section and the Sensor schema for details. |
| } ] | |||
| ControlDelaySeconds | number | read-write (null) |
The time delay in seconds before the
control will activate once the value has deviated from the set
point.
|
| ControlLoop { | object | (null) |
The control loop details.
|
| CoefficientUpdateTime | string (date-time) |
read-only (null) |
The date and time that the control loop
coefficients were changed.
|
| Differential | number | read-write (null) |
The differential coefficient.
|
| Integral | number | read-write (null) |
The integral coefficient.
|
| Proportional | number | read-write (null) |
The proportional coefficient.
|
| } | |||
| ControlMode | string (enum) |
read-write (null) |
The current operating mode of the
control.
|
| ControlType | string (enum) |
read-only (null) |
The type of control.
|
| DeadBand | number | read-write (null) |
The maximum deviation from the set point
allowed before the control will activate.
|
| DefaultSetPoint (v1.3+) | number | read-only (null) |
The default set point of the
control.
|
| Implementation | string (enum) |
read-only (null) |
The implementation of the
control.
|
| Increment | number | read-only (null) |
The smallest increment supported for the
set point.
|
| Location {} | object | The location information for this
control.
|
|
| PhysicalContext | string (enum) |
read-only (null) |
The area or device to which this control
applies.
|
| PhysicalSubContext | string (enum) |
read-only (null) |
The usage or location within a device to
which this control applies.
|
| RelatedItem [ { | array | An array of links to resources that this
control services.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| Sensor { | object (excerpt) |
The sensor reading associated with this
control.
|
|
| 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.
|
| } | |||
| SetPoint | number | read-write (null) |
The desired set point of the
control.
|
| SetPointAccuracy (v1.4+) | number | read-only (null) |
Accuracy (+/-) of the set
point.
|
| SetPointType | string (enum) |
read-only (null) |
The set point type used to operate the
control.
|
| SetPointUnits | string | read-only (null) |
The units of the set point.
|
| SetPointUpdateTime | string (date-time) |
read-only (null) |
The date and time that the set point was
changed.
|
| SettingMax | number | read-write (null) |
The maximum set point in the allowed
range.
|
| SettingMin | number | read-write (null) |
The minimum set point in the allowed
range.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
6.30.4 Actions
6.30.4.1 ResetToDefaults (v1.2+)
Description
The action resets the values of writable properties to factory defaults.
- This action shall reset the values of writable properties in this resource to their default values as specified by the manufacturer.
Action URI
{Base URI of target resource}/Actions/Control.ResetToDefaults
Action parameters
This action takes no parameters.
6.30.5 Property details
6.30.5.1 ControlMode
The current operating mode of the control.
- This property shall contain the operating mode of the control.
| string | Description |
|---|---|
| Automatic | Automatically adjust control to meet the set point. |
| Disabled | The control has been disabled. |
| Manual | No automatic adjustments are made to the control. |
| Override | User override of the automatic set point value. |
6.30.5.2 ControlType
The type of control.
- This property shall contain the type of the control.
| string | Description |
|---|---|
| Frequency | Frequency (Hz) control.
|
| FrequencyMHz (v1.1+) | Frequency (MHz) control.
|
| Power | Power (W) control or power
limit.
|
| Pressure (v1.1+, deprecated v1.3) | Pressure (kPa) control.
PressurekPa for units
consistency with the equivalent Sensor resource ReadingType
value. |
| PressurekPa (v1.3+) | Pressure (kPa) control.
|
| Temperature | Temperature (C) control or
thermostat.
|
| Valve (v1.3+) | Valve (% open) control.
|
6.30.5.3 Implementation
The implementation of the control.
- This property shall contain the implementation of the control.
| string | Description |
|---|---|
| Direct | The set point directly affects the control value. |
| Monitored | A physical control that cannot be adjusted through this interface. |
| Programmable | The set point can be adjusted through this interface. |
6.30.5.4 PhysicalContext
The area or device to which this control applies.
- This property shall contain a description of the affected component or region within the equipment to which this control applies.
| string | Description |
|---|---|
| Accelerator | An accelerator. |
| ACInput | An AC input. |
| ACMaintenanceBypassInput | An AC maintenance bypass input. |
| ACOutput | An AC output. |
| ACStaticBypassInput | An AC static bypass input. |
| ACUtilityInput | An AC utility input. |
| ASIC | An ASIC device, such as a networking chip or chipset component. |
| Back | The back of the chassis. |
| Backplane | A backplane within the chassis. |
| Battery | A battery. |
| Board | A circuit board.
|
| Chassis | The entire chassis. |
| ComputeBay | Within a compute bay. |
| CoolingSubsystem | The entire cooling, or air and liquid, subsystem. |
| CPU | A processor (CPU). |
| CPUSubsystem | The entire processor (CPU) subsystem. |
| DCBus | A DC bus. |
| Exhaust | The air exhaust point or points or region of the chassis. |
| ExpansionBay | Within an expansion bay. |
| Fan | A fan. |
| FPGA | An FPGA. |
| Front | The front of the chassis. |
| GPU | A graphics processor (GPU). |
| GPUSubsystem | The entire graphics processor (GPU) subsystem. |
| Intake | The air intake point or points or region of the chassis. |
| LiquidInlet | The liquid inlet point of the chassis. |
| LiquidOutlet | The liquid outlet point of the chassis. |
| Lower | The lower portion of the chassis. |
| Memory | A memory device. |
| MemorySubsystem | The entire memory subsystem. |
| Motor | A motor. |
| NetworkBay | Within a networking bay. |
| NetworkingDevice | A networking device. |
| PowerSubsystem | The entire power subsystem. |
| PowerSupply | A power supply. |
| PowerSupplyBay | Within a power supply bay. |
| Pump | A pump. |
| Rectifier | A rectifier device. |
| Room | The room. |
| StorageBay | Within a storage bay. |
| StorageDevice | A storage device. |
| SystemBoard | The system board (PCB). |
| Transceiver | A transceiver.
|
| Transformer | A transformer. |
| TrustedModule | A trusted module. |
| Upper | The upper portion of the chassis. |
| VoltageRegulator | A voltage regulator device. |
6.30.5.5 PhysicalSubContext
The usage or location within a device to which this control applies.
- This property shall contain a description of the usage or sub-region within the equipment to which this control applies. This property generally differentiates multiple controls within the same PhysicalContext instance.
| string | Description |
|---|---|
| Input | The input. |
| Output | The output. |
6.30.5.6 SetPointType
The set point type used to operate the control.
- This property shall contain the type of set point definitions used to describe this control.
| string | Description |
|---|---|
| Range | Control uses a range of
values.
|
| Single | Control uses a single set
point.
|
6.30.6 Example response
{
"@odata.type": "#Control.v1_4_0.Control",
"Id": "PowerLimit",
"Name": "System Power Limit",
"PhysicalContext": "Chassis",
"ControlType": "Power",
"ControlMode": "Automatic",
"SetPoint": 500,
"SetPointUnits": "W",
"AllowableMax": 1000,
"AllowableMin": 150,
"Sensor": {
"Reading": 374,
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/TotalPower"
},
"Status": {
"Health": "OK",
"State": "Enabled"
},
"@odata.id": "/redfish/v1/Chassis/1U/Controls/PowerLimit"
}6.31 CoolantConnector 1.0.0
| Version | v1.0 |
| Release | 2023.1 |
6.31.1 Description
This schema describes a liquid coolant connector, including any associated instrumentation.
- This resource shall represent an coolant connector for a Redfish implementation.
6.31.2 URIs
/redfish/v1/Chassis/{ChassisId}/ThermalSubsystem/CoolantConnectors/{CoolantConnectorId}
/redfish/v1/ThermalEquipment/CDUs/{CoolingUnitId}/PrimaryCoolantConnectors/{CoolantConnectorId}
/redfish/v1/ThermalEquipment/CDUs/{CoolingUnitId}/SecondaryCoolantConnectors/{CoolantConnectorId}
/redfish/v1/ThermalEquipment/CoolingLoops/{CoolingUnitId}/PrimaryCoolantConnectors/{CoolantConnectorId}
/redfish/v1/ThermalEquipment/CoolingLoops/{CoolingUnitId}/SecondaryCoolantConnectors/{CoolantConnectorId}
/redfish/v1/ThermalEquipment/HeatExchangers/{CoolingUnitId}/PrimaryCoolantConnectors/{CoolantConnectorId}
/redfish/v1/ThermalEquipment/HeatExchangers/{CoolingUnitId}/SecondaryCoolantConnectors/{CoolantConnectorId}
/redfish/v1/ThermalEquipment/ImmersionUnits/{CoolingUnitId}/PrimaryCoolantConnectors/{CoolantConnectorId}
/redfish/v1/ThermalEquipment/ImmersionUnits/{CoolingUnitId}/SecondaryCoolantConnectors/{CoolantConnectorId}
6.31.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Coolant { | object | Details about the coolant used in this
unit.
|
|
| @odata.id | string | read-only | Link to a Coolant resource. See the Links section and the CoolingLoop schema for details. |
| } | |||
| CoolantConnectorType | string (enum) |
read-only (null) |
The type of coolant connector.
|
| CoolingLoopName | string | read-write (null) |
The name of the cooling loop attached to
this interface.
|
| CoolingManagerURI | string (URI) |
read-write (null) |
The link to the application that manages
the cooling loop.
|
| DeltaPressurekPa {} | object | The differential pressure
(kPa).
|
|
| DeltaTemperatureCelsius {} | object | The differential temperature
(C).
|
|
| FlowLitersPerMinute {} | object | The liquid flow (L/min).
|
|
| HeatRemovedkW {} | object | The heat removed (kW) through this
connector.
|
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| ConnectedChassis [ { | array | Any array of links to chassis at the other
end of the connection.
|
|
| @odata.id | string | read-write | Link to a Chassis resource. See the Links section and the Chassis schema for details. |
| } ] | |||
| ConnectedCoolingLoop { | object | (null) |
A link to the cooling loop at the other
end of the connection.
|
| @odata.id | string | read-write | Link to a CoolingLoop resource. See the Links section and the CoolingLoop schema for details. |
| } | |||
| ConnectedCoolingUnit { | object | (null) |
A link to the cooling unit at the other
end of the connection.
|
| @odata.id | string | read-write | Link to a CoolingUnit resource. See the Links section and the CoolingUnit schema for details. |
| } | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| } | |||
| LocationIndicatorActive | boolean | read-write (null) |
An indicator allowing an operator to
physically locate this resource.
|
| RatedFlowLitersPerMinute | number (L/min) |
read-only (null) |
The rated liquid flow (L/min) for this
loop interface.
|
| RatedFlowPressurekPa | number (kPa) |
read-only (null) |
The pressure (kPa) at which the rated
liquid flow is valid.
|
| RatedPressurekPa | number (kPa) |
read-only (null) |
The rated pressure (kPa) for this
connector.
|
| ReturnPressurekPa {} | object | The return pressure (kPa).
|
|
| ReturnTemperatureCelsius {} | object | The return temperature (C).
|
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| SupplyPressurekPa {} | object | The supply pressure (kPa).
|
|
| SupplyTemperatureCelsius {} | object | The supply temperature (C).
|
6.31.4 Property details
6.31.4.1 CoolantConnectorType
The type of coolant connector.
- This property shall contain the type of coolant connector.
| string | Description |
|---|---|
| Closed | A closed or self-contained loop. |
| Inline | An inline connection or measurement point. |
| Pair | A connection pair. |
| Return | A return or outflow connection. |
| Supply | A supply or intake connection. |
6.31.4.2 SensorExcerpt
The Sensor schema describes a sensor and its properties. This object is an excerpt of the Sensor resource located at the URI shown in DataSourceUri.
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| Reading | number | read-only (null) |
The sensor value.
|
6.31.5 Example response
{
"@odata.type": "#CoolantConnector.v1_0_0.CoolantConnector",
"Id": "A",
"Name": "Rack Cooling Loop A",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"CoolantConnectorType": "Pair",
"RatedFlowLitersPerMinute": 30,
"FlowLitersPerMinute": {
"Reading": 24.3
},
"SupplyTemperatureCelsius": {
"Reading": 14.8
},
"ReturnTemperatureCelsius": {
"Reading": 38.2
},
"DeltaTemperatureCelsius": {
"Reading": 23.4
},
"SupplyPressurekPa": {
"Reading": 426.6
},
"ReturnPressurekPa": {
"Reading": 409.9
},
"DeltaPressurekPa": {
"Reading": 31.7
},
"Links": {
"ConnectedCoolingLoop": {
"@odata.id": "/redfish/v1/ThermalEquipment/CoolingLoops/Rack4"
}
},
"@odata.id": "/redfish/v1/ThermalEquipment/CDUs/1/SecondaryCoolantConnectors/A"
}6.32 CoolingLoop 1.0.1
| Version | v1.0 |
| Release | 2023.1 |
6.32.1 Description
This schema describes a cooling loop. A cooling loop might be any coolant-carrying vessel, such as facility-level pipe work, an immersion cooling tank, or a manifold. A loop might describe its connectors and instrumentation, but does not generally include active cooling components or subsystems.
- This resource shall represent a cooling loop for a Redfish implementation.
6.32.2 URIs
/redfish/v1/ThermalEquipment/CoolingLoops/{CoolingLoopId}
6.32.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| ConsumingEquipmentNames [ ] | array (string, null) | read-write | An array of names of downstream devices
that receive coolant from this cooling loop.
|
| Coolant { | object | The coolant details for this cooling
loop.
|
|
| AdditiveName | string | read-write (null) |
The name of the additive.
|
| AdditivePercent | number (%) |
read-write (null) |
The percent additives contained in the
coolant.
|
| CoolantType | string (enum) |
read-write (null) |
The type of coolant.
|
| DensityKgPerCubicMeter | number (kg/m3) |
read-write (null) |
The density (kg/m^3) of the
coolant.
|
| RatedServiceHours | number | read-write (null) |
The rated hours of service life for this
coolant.
|
| ServicedDate | string (date-time) |
read-write (null) |
The date the coolant was last
serviced.
|
| ServiceHours | number | read-write (null) |
The hours of service this coolant has
provided.
|
| SpecificHeatkJoulesPerKgK | number (kJ/kg/K) |
read-write (null) |
The specific heat capacity (kJ/(kg*K)) of
the coolant.
|
| } | |||
| CoolantLevelPercent { | object (excerpt) |
The coolant capacity filled
(percent).
|
|
| 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.
|
| } | |||
| CoolantLevelStatus | string (enum) |
read-only (null) |
The status of the coolant level in this
cooling loop.
|
| CoolantQuality | string (enum) |
read-only (null) |
The quality of the coolant.
|
| CoolingManagerURI | string (URI) |
read-write (null) |
The link to the application that manages
the cooling loop.
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| Chassis { | object | (null) |
A link to the chassis that contains this
equipment.
|
| @odata.id | string | read-only | Link to a Chassis resource. See the Links section and the Chassis schema for details. |
| } | |||
| Facility { | object | A link to the facility that contains this
equipment.
|
|
| @odata.id | string | read-only | 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 equipment.
|
|
| @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 Using this guide clause. | |
| } | |||
| LocationIndicatorActive | boolean | read-write (null) |
An indicator allowing an operator to
physically locate this resource.
|
| PrimaryCoolantConnectors { | object | A link to the primary coolant connectors
for this equipment.
|
|
| @odata.id | string | read-only | Link to Collection of CoolantConnector. See the CoolantConnector schema for details. |
| } | |||
| RatedFlowLitersPerMinute | number (L/min) |
read-only (null) |
The rated liquid flow (L/min) for this
cooling loop.
|
| RatedPressurekPa | number (kPa) |
read-only (null) |
The rated pressure (kPa) for this cooling
loop.
|
| SecondaryCoolantConnectors { | object | A link to the secondary coolant connectors
for this equipment.
|
|
| @odata.id | string | read-only | Link to Collection of CoolantConnector. See the CoolantConnector schema for details. |
| } | |||
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| SupplyEquipmentNames [ ] | array (string, null) | read-write | An array of names of upstream devices that
supply coolant to this cooling loop.
|
| UserLabel | string | read-write | A user-assigned label.
|
6.32.4 Property details
6.32.4.1 CoolantLevelStatus
The status of the coolant level in this cooling loop.
- This property shall indicate the status of the coolant level in this cooling loop.
| string | Description |
|---|---|
| Critical | A critical condition requires immediate attention. |
| OK | Normal. |
| Warning | A condition requires attention. |
6.32.4.2 CoolantQuality
The quality of the coolant.
- This property shall indicate the quality of the coolant contained in this cooling loop.
| string | Description |
|---|---|
| Critical | A critical condition requires immediate attention. |
| OK | Normal. |
| Warning | A condition requires attention. |
6.32.4.3 CoolantType
The type of coolant.
- This property shall contain the type of coolant used by this resource.
| string | Description |
|---|---|
| Dielectric | Dielectric fluid. |
| Fluorocarbon | Fluorocarbon-based. |
| Hydrocarbon | Hydrocarbon-based. |
| Water | Water or glycol mixture, including additives. |
6.32.5 Example response
{
"@odata.type": "#CoolingLoop.v1_0_1.CoolingLoop",
"Id": "BuildingChiller",
"Name": "Feed from building chiller",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"UserLabel": "Building Chiller",
"Coolant": {
"CoolantType": "Water",
"AdditiveName": "Generic cooling water biocide",
"AdditivePercent": 0
},
"CoolantLevelStatus": "OK",
"CoolantQuality": "OK",
"CoolantLevelPercent": {
"Reading": 95
},
"SupplyEquipmentNames": [
"Chiller"
],
"ConsumingEquipmentNames": [
"Rack #1 CDU",
"Rack #2 CDU",
"Rack #3 CDU",
"Rack #4 CDU"
],
"@odata.id": "/redfish/v1/ThermalEquipment/CoolingLoops/BuildingChiller"
}6.33 CoolingUnit 1.1.0
| Version | v1.1 | v1.0 |
| Release | 2023.2 | 2023.1 |
6.33.1 Description
This is the schema definition for a cooling distribution component or unit, such as a cooling distribution unit (CDU) or a heat exchanger.
- This resource shall represent a cooling distribution component or unit for a Redfish implementation.
6.33.2 URIs
/redfish/v1/ThermalEquipment/CDUs/{CoolingUnitId}
/redfish/v1/ThermalEquipment/HeatExchangers/{CoolingUnitId}
/redfish/v1/ThermalEquipment/ImmersionUnits/{CoolingUnitId}
6.33.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Assembly { | object | The link to the assembly associated with
this cooling unit.
|
|
| @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
equipment.
|
| Coolant { | object | Details about the coolant used in this
unit.
|
|
| @odata.id | string | read-only | Link to a Coolant resource. See the Links section and the CoolingLoop schema for details. |
| } | |||
| CoolantConnectorRedundancy (v1.1+) [ { } ] | array (object) | The redundancy information for the devices
in a redundancy group.
|
|
| CoolingCapacityWatts | integer | read-only (null) |
The cooling capacity (W) of this
equipment.
|
| EnvironmentMetrics { | object | The link to the environment metrics for
this equipment.
|
|
| @odata.id | string | read-only | Link to a EnvironmentMetrics resource. See the Links section and the EnvironmentMetrics schema for details. |
| } | |||
| EquipmentType | string (enum) |
read-only required | The type of equipment this resource
represents.
|
| FilterRedundancy [ { } ] | array (object) | The redundancy information for the devices
in a redundancy group.
|
|
| Filters { | object | A link to the filters for this
equipment.
|
|
| @odata.id | string | read-only | Link to Collection of Filter. See the Filter schema for details. |
| } | |||
| FirmwareVersion | string | read-only | The firmware version of this
equipment.
|
| LeakDetection { | object | A link to the leak detection components
associated with this equipment.
|
|
| @odata.id | string | read-only | Link to a LeakDetection resource. See the Links section and the LeakDetection schema for details. |
| } | |||
| Links { | object | The links to other resources that are
related to this resource.
|
|
| Chassis [ { | array | An array of links to the chassis that
contain this equipment.
|
|
| @odata.id | string | read-only | Link to a Chassis resource. See the Links section and the Chassis schema for details. |
| } ] | |||
| Facility { | object | A link to the facility that contains this
equipment.
|
|
| @odata.id | string | read-only | 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 equipment.
|
|
| @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 Using this guide clause. | |
| } | |||
| Location {} | object | The location of the equipment.
|
|
| Manufacturer | string | read-only (null) |
The manufacturer of this
equipment.
|
| Model | string | read-only (null) |
The product model number of this
equipment.
|
| PartNumber | string | read-only (null) |
The part number for this
equipment.
|
| PrimaryCoolantConnectors { | object | A link to the primary coolant connectors
for this equipment.
|
|
| @odata.id | string | read-only | Link to Collection of CoolantConnector. See the CoolantConnector schema for details. |
| } | |||
| ProductionDate | string (date-time) |
read-only (null) |
The production or manufacturing date of
this equipment.
|
| PumpRedundancy [ { } ] | array (object) | The redundancy information for the devices
in a redundancy group.
|
|
| Pumps { | object | A link to the pumps for this
equipment.
|
|
| @odata.id | string | read-only | Link to Collection of Pump. See the Pump schema for details. |
| } | |||
| Reservoirs { | object | A link to the reservoirs for this
equipment.
|
|
| @odata.id | string | read-only | Link to Collection of Reservoir. See the Reservoir schema for details. |
| } | |||
| SecondaryCoolantConnectors { | object | A link to the secondary coolant connectors
for this equipment.
|
|
| @odata.id | string | read-only | Link to Collection of CoolantConnector. See the CoolantConnector schema for details. |
| } | |||
| SerialNumber | string | read-only (null) |
The serial number for this
equipment.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| UserLabel | string | read-write | A user-assigned label.
|
| Version | string | read-only (null) |
The hardware version of this
equipment.
|
6.33.4 Property details
6.33.4.1 EquipmentType
The type of equipment this resource represents.
- This property shall contain the type of equipment this resource represents.
| string | Description |
|---|---|
| CDU | A cooling distribution unit. |
| HeatExchanger | A heat exchanger. |
| ImmersionUnit | An immersion cooling unit. |
6.33.5 Example response
{
"@odata.type": "#CoolingUnit.v1_1_0.CoolingUnit",
"Id": "1",
"EquipmentType": "CDU",
"Name": "Rack #4 Cooling Distribution Unit",
"FirmwareVersion": "3.2.0",
"Version": "1.03b",
"ProductionDate": "2020-12-24T08:00:00Z",
"Manufacturer": "Contoso",
"Model": "BRRR4000",
"SerialNumber": "29347ZT536",
"PartNumber": "ICE-9",
"AssetTag": "PDX5-92381",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Location": {
"Placement": {
"Row": "North 1"
}
},
"PrimaryCoolantConnectors": {
"@odata.id": "/redfish/v1/ThermalEquipment/CDUs/1/PrimaryCoolantConnectors"
},
"SecondaryCoolantConnectors": {
"@odata.id": "/redfish/v1/ThermalEquipment/CDUs/1/SecondaryCoolantConnectors"
},
"Pumps": {
"@odata.id": "/redfish/v1/ThermalEquipment/CDUs/1/Pumps"
},
"Filters": {
"@odata.id": "/redfish/v1/ThermalEquipment/CDUs/1/Filters"
},
"EnvironmentMetrics": {
"@odata.id": "/redfish/v1/ThermalEquipment/CDUs/1/EnvironmentMetrics"
},
"LeakDetection": {
"@odata.id": "/redfish/v1/ThermalEquipment/CDUs/1/LeakDetection"
},
"Links": {
"Facility": {
"@odata.id": "/redfish/v1/Facilities/Room237"
}
},
"@odata.id": "/redfish/v1/ThermalEquipment/CDUs/1"
}6.34 CXLLogicalDevice 1.1.0
| Version | v1.1 | v1.0 |
| Release | 2023.2 | 2022.3 |
6.34.1 Description
The schema definition for the CXLLogicalDevice resource. It represents the properties of a CXL logical device within PCIe device.
- This resource shall represent a CXL logical device that is a part of PCIe device.
6.34.2 URIs
/redfish/v1/Chassis/{ChassisId}/PCIeDevices/{PCIeDeviceId}/CXLLogicalDevices/{CXLLogicalDeviceId}
6.34.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Identifiers [ { } ] | array (object) | Any additional identifiers for a
resource.
|
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| Endpoints [ { | array | An array of links to the endpoints
associated with this CXL logical device.
|
|
| @odata.id | string | read-only | Link to a Endpoint resource. See the Links section and the Endpoint schema for details. |
| } ] | |||
| MemoryChunks [ { | array | An array of links to the memory chunks
owned by this CXL logical device.
|
|
| @odata.id | string | read-only | Link to a MemoryChunks resource. See the Links section and the MemoryChunks schema for details. |
| } ] | |||
| MemoryDomains [ { | array | An array of links to the memory domains
associated with this CXL logical device.
|
|
| @odata.id | string | read-only | Link to a MemoryDomain resource. See the Links section and the MemoryDomain schema for details. |
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| PCIeFunctions [ { | array | An array of links to the PCIe functions
assigned to this CXL logical device.
|
|
| @odata.id | string | read-only | Link to a PCIeFunction resource. See the Links section and the PCIeFunction schema for details. |
| } ] | |||
| } | |||
| Log { | object | The link to the log service associated
with this CXL logical device.
|
|
| @odata.id | string | read-only | Link to a LogService resource. See the Links section and the LogService schema for details. |
| } | |||
| MemoryRegions (v1.1+) { | object | The link to the collection of memory
regions associated with this CXL logical device.
|
|
| @odata.id | string | read-only | Link to Collection of MemoryRegion. See the MemoryRegion schema for details. |
| } | |||
| MemorySizeMiB | integer (mebibytes) |
read-only | The memory region size defined in this CXL
logical device.
|
| QoS { | object | The quality of service configuration for
this CXL logical device.
|
|
| AllocatedBandwidth | integer | read-write (null) |
The bandwidth allocated for this CXL
logical device in multiples of 256.
|
| LimitPercent | integer (%) |
read-write (null) |
The bandwidth limit to this CXL logical
device as a percentage.
|
| } | |||
| QoSTelemetryCapabilities { | object | The quality of service telemetry
capabilities for this CXL logical device.
|
|
| EgressPortBackpressureSupported | boolean | read-only (null) |
Indicates whether the device supports the
CXL Specification-defined 'Egress Port Backpressure'
mechanism.
|
| TemporaryThroughputReductionSupported | boolean | read-only (null) |
Indicates whether the device supports the
CXL Specification-defined 'Temporary Throughput Reduction'
mechanism.
|
| } | |||
| SemanticsSupported [ ] | array (string (enum)) |
read-only |
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
6.34.4 Property details
6.34.4.1 SemanticsSupported
- The semantics supported by this CXL logical device.
- This property shall contain the CXL Specification-defined semantics that are supported by this CXL logical device.
| string | Description |
|---|---|
| CXLcache | CXL caching protocol semantic.
|
| CXLio | CXL I/O semantic.
|
| CXLmem | CXL memory access semantic.
|
6.34.5 Example response
{
"@odata.type": "#CXLLogicalDevice.v1_1_0.CXLLogicalDevice",
"Id": "1",
"Name": "CXL Logical Device Type 1",
"Description": "Locally attached CXL Logical Device Type 1",
"Status": {
"State": "Enabled",
"Health": "OK",
"HealthRollup": "OK"
},
"Identifiers": [
{
"DurableName": "4C-1D-96-FF-FE-DD-D8-35:0001",
"DurableNameFormat": "GCXLID"
}
],
"SemanticsSupported": [
"CXLio",
"CXLcache"
],
"Links": {
"PCIeFunctions": [
{
"@odata.id": "/redfish/v1/Chassis/CXL1/PCIeDevices/1/PCIeFunctions/1"
}
]
},
"@odata.id": "/redfish/v1/Chassis/CXL1/PCIeDevices/1/CXLLogicalDevices/1"
}6.35 Drive 1.17.1
| Version | v1.17 | v1.16 | v1.15 | v1.14 | v1.13 | v1.12 | v1.11 | v1.10 | v1.9 | v1.8 | v1.7 | ... |
| Release | 2023.1 | 2022.3 | 2022.1 | 2021.4 | 2021.2 | 2020.4 | 2020.3 | 2020.2 | 2019.4 | 2019.3 | 2019.2 | ... |
6.35.1 Description
The Drive schema represents a single physical drive for a system, including links to associated volumes. It also describes the location, such as a slot, socket, or bay, where a unit can be installed, by populating a resource instance with an absent state if a unit is not present.
- This resource shall represent a drive or other physical
storage medium for a Redfish implementation. It may also represent a
location, such as a slot, socket, or bay, where a unit may be installed,
but the State property within the Status property contains
Absent.
6.35.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.35.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Assembly (v1.3+) { | object | The link to the assembly associated with
this drive.
|
|
| @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.
|
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| DriveFormFactor (v1.16+) | string (enum) |
read-only (null) |
The form factor of the drive inserted in
this slot.
|
| EncryptionAbility | string (enum) |
read-only (null) |
The encryption ability of this
drive.
|
| EncryptionStatus | string (enum) |
read-only (null) |
The status of the encryption of this
drive.
|
| EnvironmentMetrics (v1.12+) { | object | The link to the environment metrics for
this drive.
|
|
| @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.
|
| FirmwareVersion (v1.17+) | string | read-only (null) |
The firmware version for this
drive.
|
| HotspareReplacementMode (v1.5+) | string (enum) |
read-write (null) |
The replacement mode for the hot spare
drive.
|
| HotspareType | string (enum) |
read-write (null) |
The type of hot spare that this drive
serves as.
|
| Identifiers [ { } ] | array (object) | Any additional identifiers for a
resource.
|
|
| IndicatorLED (deprecated v1.11) | string (enum) |
read-write (null) |
The state of the indicator LED, that
identifies the drive.
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| ActiveSoftwareImage (v1.16+) { | object | The link to the software inventory that
represents the active drive firmware image.
|
|
| @odata.id | string | read-write | Link to a SoftwareInventory resource. See the Links section and the SoftwareInventory schema for details. |
| } | |||
| Chassis (v1.2+) { | object | The link to the chassis that contains this
drive.
|
|
| @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. |
| } ] | |||
| NetworkDeviceFunctions (v1.14+) [ { | array | An array of links to the network device
functions that provide network connectivity for this drive.
|
|
| @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 Using this guide clause. | |
| 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. |
| } ] | |||
| SoftwareImages (v1.16+) [ { | array | The images that are associated with this
drive.
|
|
| @odata.id | string | read-only | Link to a SoftwareInventory resource. See the Links section and the SoftwareInventory schema for details. |
| } ] | |||
| Storage (v1.13+) { | object | A link to the storage subsystem to which
this drive belongs.
|
|
| @odata.id | string | read-only | Link to a Storage resource. See the Links section and the Storage 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 a resource.
|
|
| 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+, deprecated 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. |
| } ] | |||
| MediaType | string (enum) |
read-only (null) |
The type of media contained in this
drive.
|
| Metrics (v1.17+) { | object | (null) |
The link to the metrics associated with
this drive.
|
| @odata.id | string | read-only | Link to a DriveMetrics resource. See the Links section and the DriveMetrics schema for 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.
|
|
| @odata.id | string | read-only | Link to a Task resource. See the Links section and the Task schema for details. |
| } | |||
| Operation (v1.17+) | string (enum) |
read-only (null) |
The type of the operation.
|
| OperationName (v1.1+, deprecated v1.17 | 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.
|
|
| 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.
|
| 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. For SCSI-based
drives, this is the version of the drive from the 'Inquiry' command,
which can be the firmware or hardware version. For other types of
drives, this is the hardware version.
|
| RotationSpeedRPM | number ({rev}/min) |
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.
|
| SlotCapableProtocols (v1.16+) [ ] | array (string (enum)) |
read-only (null) |
|
| SlotFormFactor (v1.16+) | string (enum) |
read-only (null) |
The form factor of the slot.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| StatusIndicator | string (enum) |
read-write (null) |
The state of the status indicator, which
communicates status information about this drive.
|
| WriteCacheEnabled (v1.7+) | boolean | read-write (null) |
An indication of whether the drive write
cache is enabled.
|
6.35.4 Actions
6.35.4.1 Reset (v1.7+)
Description
This action resets this drive.
- This action shall reset 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.
|
Request Example
{
"ResetType": "On"
}6.35.4.2 SecureErase
Description
This action securely erases the contents of the drive.
- This action shall securely erase the drive.
Action URI
{Base URI of target resource}/Actions/Drive.SecureErase
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| OverwritePasses (v1.15+) | integer | optional | The number of times to overwrite the drive
if performing an overwrite type of sanitization.
|
| SanitizationType (v1.15+) | string (enum) |
optional | The type of data sanitization to
perform.
|
Request Example
{
"SanitizationType": "CryptographicErase"
}6.35.5 Property details
6.35.5.1 DriveFormFactor
The form factor of the drive inserted in this slot.
- This property shall contain the form factor of the drive inserted in this slot.
| string | Description |
|---|---|
| Drive2_5 | A 2.5 inch drive.
|
| Drive3_5 | A 3.5 inch drive.
|
| EDSFF_1U_Long | An EDSFF 1U Long (E1.L) drive.
|
| EDSFF_1U_Short | An EDSFF 1U Short (E1.S)
drive.
|
| EDSFF_E3_Long | An EDSFF E3 Long (E3.L) drive.
|
| EDSFF_E3_Short | An EDSFF E3 Short (E3.S)
drive.
|
| M2_22110 | An M.2 22110 drive.
|
| M2_2230 | An M.2 2230 drive.
|
| M2_2242 | An M.2 2242 drive.
|
| M2_2260 | An M.2 2260 drive.
|
| M2_2280 | An M.2 2280 drive.
|
| OEM | An OEM-defined form factor.
|
| PCIeHalfLength | A half length PCIe add in
card.
|
| PCIeSlotFullLength | A full length PCIe add in
card.
|
| PCIeSlotLowProfile | A low profile PCIe add in
card.
|
| U2 | A U.2 drive.
|
6.35.5.2 EncryptionAbility
The encryption ability of this drive.
- This property shall contain the encryption ability for the associated 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.35.5.3 EncryptionStatus
The status of the encryption of this drive.
- This property shall contain the encryption status for the associated 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.35.5.4 HotspareReplacementMode
The replacement mode for the hot spare drive.
- This property shall indicate whether a commissioned hot spare continues to serve as a hot spare after the failed drive is replaced.
| 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.35.5.5 HotspareType
The type of hot spare that this drive serves as.
- This property shall contain the hot spare type for the associated drive. If the drive currently serves as a hot spare, its Status.State field shall be 'StandbySpare' and 'Enabled' when it is part of a volume.
| string | Description |
|---|---|
| Chassis | The drive is serving as a hot spare for all other drives in this storage domain that are contained in the same chassis. |
| Dedicated | The drive is serving as a hot spare for a user-defined set of drives or volumes. Clients cannot specify this value when modifying the HotspareType property. This value is reported as a result of configuring the spare drives within a volume. |
| Global | The drive is serving as a hot spare for all other drives in this storage domain. |
| None | The drive is not a hot spare. |
6.35.5.6 IndicatorLED
The state of the indicator LED, that identifies the drive.
- This property shall contain the state for the indicator light associated with this drive.
| string | Description |
|---|---|
| Blinking | The indicator LED is blinking.
|
| Lit | The indicator LED is lit.
|
| Off | The indicator LED is off.
|
6.35.5.7 MediaType
The type of media contained in this drive.
- This property shall contain the type of media contained in the associated 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.35.5.8 Operation
The type of the operation.
- This property shall contain the type of the operation.
| string | Description |
|---|---|
| ChangeRAIDType | A ChangeRAIDType operation is being performed. |
| ChangeStripSize | A ChangeStripSize operation is being performed. |
| CheckConsistency | A CheckConsistency operation is being performed. |
| Compress | A Compress operation is being performed. |
| Decrypt | A Decrypt operation is being performed. |
| Deduplicate | A Deduplicate operation is being performed. |
| Delete | A Delete operation is being performed. |
| Encrypt | An Encrypt operation is being performed. |
| Format | A Format operation is being performed. |
| Initialize | An Initialize operation is being performed. |
| Rebuild | A Rebuild operation is being performed. |
| Replicate | A Replicate operation is being performed. |
| Resize | A Resize operation is being performed. |
| Sanitize | A Sanitize operation is being performed. |
6.35.5.9 Protocol
The protocol that this drive currently uses to communicate to the storage controller.
- This property shall contain the protocol that the associated drive currently uses to communicate to the storage controller for this system.
| string | Description |
|---|---|
| AHCI | Advanced Host Controller Interface
(AHCI).
|
| CXL | Compute Express Link.
|
| 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.
|
| QPI | Intel QuickPath Interconnect
(QPI).
|
| 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).
|
| UPI | Intel UltraPath Interconnect
(UPI).
|
| USB | Universal Serial Bus (USB).
|
| VGA | VGA.
|
6.35.5.10 ResetType
The type of reset.
- This parameter shall contain the type of reset. The service can accept a request without the parameter and perform an implementation specific default reset.
| string | Description |
|---|---|
| ForceOff | Turn off the unit immediately
(non-graceful shutdown).
|
| ForceOn | Turn on the unit immediately.
|
| ForceRestart | Shut down immediately and non-gracefully
and restart the system.
|
| GracefulRestart | Shut down gracefully and restart the
system.
|
| GracefulShutdown | Shut down gracefully and power
off.
|
| Nmi | Generate a diagnostic interrupt, which is
usually an NMI on x86 systems, to stop normal operations, complete
diagnostic actions, and, typically, halt the system.
|
| On | Turn on the unit.
|
| Pause | Pause execution on the unit but do not
remove power. This is typically a feature of virtual machine
hypervisors.
|
| PowerCycle | Power cycle the unit. Behaves like a full
power removal, followed by a power restore to the resource.
|
| PushPowerButton | Simulate the pressing of the physical
power button on this unit.
|
| Resume | Resume execution on the paused unit. This
is typically a feature of virtual machine hypervisors.
|
| Suspend | Write the state of the unit to disk before
powering off. This allows for the state to be restored when powered back
on.
|
6.35.5.11 SanitizationType
The type of data sanitization to perform.
- This parameter shall contain the type of data sanitization to perform for the secure erase request. The service can accept a request without the parameter and perform an implementation specific default secure erase.
| string | Description |
|---|---|
| BlockErase | Delete all logical block addresses,
including those that are not currently mapping to active addresses, but
leaving the data on the drive.
|
| CryptographicErase | Erase the target data's encryption key
leaving only the ciphertext on the drive. For more information, see
NIST800-88 and ISO/IEC 27040.
|
| Overwrite | Overwrite data by writing an
implementation specific pattern onto all sectors of the
drive.
|
6.35.5.12 SlotCapableProtocols
- The drive protocols capable in this slot.
- This property shall contain the drive protocols capable in this slot. The value of this property depends upon the connector in this slot, the storage controllers connected to this slot, the configuration of the system, and other constraints that determine if a particular protocol is capable at a given time.
| string | Description |
|---|---|
| AHCI | Advanced Host Controller Interface
(AHCI).
|
| CXL | Compute Express Link.
|
| 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.
|
| QPI | Intel QuickPath Interconnect
(QPI).
|
| 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).
|
| UPI | Intel UltraPath Interconnect
(UPI).
|
| USB | Universal Serial Bus (USB).
|
| VGA | VGA.
|
6.35.5.13 SlotFormFactor
The form factor of the slot.
- This property shall contain the form factor of the slot.
| string | Description |
|---|---|
| Drive2_5 | A 2.5 inch drive.
|
| Drive3_5 | A 3.5 inch drive.
|
| EDSFF_1U_Long | An EDSFF 1U Long (E1.L) drive.
|
| EDSFF_1U_Short | An EDSFF 1U Short (E1.S)
drive.
|
| EDSFF_E3_Long | An EDSFF E3 Long (E3.L) drive.
|
| EDSFF_E3_Short | An EDSFF E3 Short (E3.S)
drive.
|
| M2_22110 | An M.2 22110 drive.
|
| M2_2230 | An M.2 2230 drive.
|
| M2_2242 | An M.2 2242 drive.
|
| M2_2260 | An M.2 2260 drive.
|
| M2_2280 | An M.2 2280 drive.
|
| OEM | An OEM-defined form factor.
|
| PCIeHalfLength | A half length PCIe add in
card.
|
| PCIeSlotFullLength | A full length PCIe add in
card.
|
| PCIeSlotLowProfile | A low profile PCIe add in
card.
|
| U2 | A U.2 drive.
|
6.35.5.14 StatusIndicator
The state of the status indicator, which communicates status information about this drive.
- This property shall contain the status indicator state for the status indicator associated with this drive. The Redfish.AllowableValues annotation specifies the valid values for this property.
| 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.35.6 Example response
{
"@odata.type": "#Drive.v1_17_1.Drive",
"Id": "3D58ECBC375FD9F2",
"Name": "Drive Sample",
"LocationIndicatorActive": true,
"Model": "C123",
"Revision": "100A",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"CapacityBytes": 899527000064,
"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.36 DriveMetrics 1.1.0
| Version | v1.1 | v1.0 |
| Release | 2023.2 | 2023.1 |
6.36.1 Description
The usage and health statistics for a drive.
- The DriveMetrics schema shall contain the usage and health statistics for a drive in a Redfish implementation.
6.36.2 URIs
/redfish/v1/Chassis/{ChassisId}/Drives/{DriveId}/Metrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Drives/{DriveId}/Metrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Drives/{DriveId}/Metrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Drives/{DriveId}/Metrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Drives/{DriveId}/Metrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Drives/{DriveId}/Metrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Drives/{DriveId}/Metrics
/redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/Drives/{DriveId}/Metrics
6.36.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| BadBlockCount | integer | read-only (null) |
The total number of bad blocks reported by
the drive.
|
| CorrectableIOReadErrorCount | integer | read-only (null) |
The number of the correctable read errors
for the lifetime of the drive.
|
| CorrectableIOWriteErrorCount | integer | read-only (null) |
The number of the correctable write errors
for the lifetime of the drive.
|
| NativeCommandQueueDepth (v1.1+) | integer | read-only (null) |
The current depth of the Native Command
Queue.
|
| NVMeSMART { | object | The NVMe SMART metrics for the
drive.
|
|
| @odata.id | string | read-only | Link to a NVMeSMARTMetrics resource. See the Links section and the StorageControllerMetrics schema for details. |
| } | |||
| PowerOnHours | number | read-only (null) |
The number of power-on hours for the
lifetime of the drive.
|
| UncorrectableIOReadErrorCount | integer | read-only (null) |
The number of the uncorrectable read
errors for the lifetime of the drive.
|
| UncorrectableIOWriteErrorCount | integer | read-only (null) |
The number of the uncorrectable write
errors for the lifetime of the drive.
|
6.36.4 Example response
{
"@odata.type": "#DriveMetrics.v1_1_0.DriveMetrics",
"Id": "Metrics",
"Name": "Drive Metrics",
"CorrectableIOReadErrorCount": 184,
"UncorrectableIOReadErrorCount": 0,
"CorrectableIOWriteErrorCount": 18,
"UncorrectableIOWriteErrorCount": 0,
"BadBlockCount": 123098,
"PowerOnHours": 3,
"NVMeSMART": {
"CriticalWarnings": {
"PMRUnreliable": false,
"PowerBackupFailed": false,
"MediaInReadOnly": false,
"OverallSubsystemDegraded": false,
"SpareCapacityWornOut": false
},
"CompositeTemperatureCelsius": 34,
"AvailableSparePercent": 50,
"AvailableSpareThresholdPercent": 30,
"PercentageUsed": 50,
"EGCriticalWarningSummary": {
"NamespacesInReadOnlyMode": false,
"ReliabilityDegraded": false,
"SpareCapacityUnderThreshold": false
},
"DataUnitsRead": 0,
"DataUnitsWritten": 0,
"HostReadCommands": 0,
"HostWriteCommands": 0,
"ControllerBusyTimeMinutes": 20,
"PowerCycles": 49,
"PowerOnHours": 3,
"UnsafeShutdowns": 4,
"MediaAndDataIntegrityErrors": 0,
"NumberOfErrorInformationLogEntries": 100,
"WarningCompositeTempTimeMinutes": 0,
"CriticalCompositeTempTimeMinutes": 0,
"TemperatureSensorsCelsius": [
34,
34,
34,
34,
34,
35,
33,
32
],
"ThermalMgmtTemp1TransitionCount": 10,
"ThermalMgmtTemp2TransitionCount": 2,
"ThermalMgmtTemp1TotalTimeSeconds": 20,
"ThermalMgmtTemp2TotalTimeSeconds": 42
},
"@odata.id": "/redfish/v1/Chassis/StorageEnclosure1/Drives/0THGR0KP/Metrics"
}6.37 Endpoint 1.8.0
| Version | v1.8 | v1.7 | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2022.3 | 2022.1 | 2021.1 | 2020.3 | 2019.4 | 2018.3 | 2018.2 | 2017.3 | 2016.2 |
6.37.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.
- This resource contains a fabric endpoint for a Redfish implementation.
6.37.2 URIs
/redfish/v1/Fabrics/{FabricId}/Endpoints/{EndpointId}
/redfish/v1/Storage/{StorageId}/Endpoints/{EndpointId}
/redfish/v1/StorageServices/{StorageServiceId}/Endpoints/{EndpointId}
6.37.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.
^0[xX](([a-fA-F]|[0-9]){2}){3}$ |
| DeviceId | string | read-only (null) |
The Device ID of this PCIe
function.
^0[xX](([a-fA-F]|[0-9]){2}){2}$ |
| 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.
^0[xX](([a-fA-F]|[0-9]){2}){2}$ |
| SubsystemVendorId | string | read-only (null) |
The Subsystem Vendor ID of this PCIe
function.
^0[xX](([a-fA-F]|[0-9]){2}){2}$ |
| VendorId | string | read-only (null) |
The Vendor ID of this PCIe
function.
^0[xX](([a-fA-F]|[0-9]){2}){2}$ |
| } | |||
| EntityRole | string (enum) |
read-only (null) |
The role of the connected
entity.
|
| EntityType | string (enum) |
read-only (null) |
The type of the connected
entity.
|
| 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.
^0[xX]([a-fA-F]|[0-9]){2}$ 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.
^0[xX]([a-fA-F]|[0-9]){3}$ |
| SID (v1.4+) | string | read-write (null) |
The subnet identifier portion of the GCID
for the entity.
^0[xX](([a-fA-F]|[0-9]){2}){2}$ |
| } | |||
| RegionKey (v1.4+, deprecated v1.6 | string | read-write (null) |
The Region Key for the entity.
^0[xX](([a-fA-F]|[0-9]){2}){4}$ Deprecated in v1.6 and
later. This property has been deprecated in favor of the ConnectionKeys
property in the Connection resource. |
| } | |||
| Identifiers [ { } ] | array (object) | Any additional identifiers for a
resource.
|
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| PciClassCode (deprecated v1.2) | string | read-only (null) |
The Class Code, Subclass, and Programming
Interface code of this PCIe function.
^0[xX](([a-fA-F]|[0-9]){2}){3}$ 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.
|
| } ] | |||
| EndpointProtocol | string (enum) |
read-only (null) |
The protocol supported by this
endpoint.
|
| 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) | Any additional identifiers for a
resource.
|
|
| 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.
|
|
| IPv6Address (v1.1+) {} | object | The IPv6 addresses assigned to the
endpoint.
|
|
| 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.
|
| } ] | |||
| 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 switch ports or
remote device ports at the other end of the link.
|
|
| @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. |
| } ] | |||
| LocalPorts (v1.7+) [ { | array | An array of links to the device ports that
this endpoint represents.
|
|
| @odata.id | string | read-only | Link to a Port resource. See the Links section and the Port 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 Using this guide clause. | |
| Ports (deprecated v1.7) [ { | 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.
^0[xX](([a-fA-F]|[0-9]){2}){3}$ |
| DeviceId | string | read-only (null) |
The Device ID of this PCIe
function.
^0[xX](([a-fA-F]|[0-9]){2}){2}$ |
| 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.
^0[xX](([a-fA-F]|[0-9]){2}){2}$ |
| SubsystemVendorId | string | read-only (null) |
The Subsystem Vendor ID of this PCIe
function.
^0[xX](([a-fA-F]|[0-9]){2}){2}$ |
| VendorId | string | read-only (null) |
The Vendor ID of this PCIe
function.
^0[xX](([a-fA-F]|[0-9]){2}){2}$ |
| } | |||
| Redundancy [ { } ] | array (object) | The common redundancy definition and
structure used in other Redfish schemas.
|
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
6.37.4 Property details
6.37.4.1 EndpointProtocol
The protocol supported by this endpoint.
- This property shall contain the protocol this endpoint uses to communicate with other endpoints on this fabric.
| string | Description |
|---|---|
| AHCI | Advanced Host Controller Interface
(AHCI).
|
| CXL | Compute Express Link.
|
| 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.
|
| QPI | Intel QuickPath Interconnect
(QPI).
|
| 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).
|
| UPI | Intel UltraPath Interconnect
(UPI).
|
| USB | Universal Serial Bus (USB).
|
| VGA | VGA.
|
6.37.4.2 EntityRole
The role of the connected entity.
- This property shall indicate if the specified entity is an initiator, target, or both.
| 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.37.4.3 EntityType
The type of the connected entity.
- This property shall indicate if type of 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.
|
| CXLDevice (v1.8+) | The entity is a CXL logical
device.
|
| 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.
|
| Memory (v1.8+) | The entity is a memory device.
|
| 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.37.4.4 TransportProtocol
The protocol used by the connection entity.
- This property shall contain the protocol used by the connection entity.
| string | Description |
|---|---|
| AHCI | Advanced Host Controller Interface
(AHCI).
|
| CXL | Compute Express Link.
|
| 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.
|
| QPI | Intel QuickPath Interconnect
(QPI).
|
| 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).
|
| UPI | Intel UltraPath Interconnect
(UPI).
|
| USB | Universal Serial Bus (USB).
|
| VGA | VGA.
|
6.37.5 Example response
{
"@odata.type": "#Endpoint.v1_8_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"
}
]
}
],
"Links": {
"MutuallyExclusiveEndpoints": [
{
"@odata.id": "/redfish/v1/Fabrics/SAS/Endpoints/Enclosure2"
}
],
"ConnectedPorts": [
{
"@odata.id": "/redfish/v1/Fabrics/SAS/Switches/Switch1/Ports/8"
},
{
"@odata.id": "/redfish/v1/Fabrics/SAS/Switches/Switch2/Ports/8"
}
]
},
"@odata.id": "/redfish/v1/Fabrics/SAS/Endpoints/Drive1"
}6.38 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.38.1 Description
The EndpointGroup schema describes group of endpoints that are managed as a unit.
- This resource shall represent a group of endpoints that are managed as a unit for a Redfish implementation.
6.38.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.38.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AccessState (deprecated v1.3) | string (enum) |
read-write (null) |
The access state for this
group.
|
| Endpoints (deprecated 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. |
| } ] | |||
| GroupType | string (enum) |
read-write (null) |
The endpoint group type.
|
| Identifier {} | object | The durable name for the endpoint
group.
|
|
| 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 Using this guide clause. | |
| } | |||
| Preferred (deprecated v1.2) | boolean | read-write (null) |
An indication if access to the resources
through the endpoint group is preferred.
|
| TargetEndpointGroupIdentifier | integer | read-write (null) |
The SCSI-defined identifier for this
group.
|
6.38.4 Property details
6.38.4.1 AccessState
The access state for this group.
- The value of this property shall contain the access state for all associated resources in this endpoint 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.38.4.2 GroupType
The endpoint group type.
- The value of this property shall
contain the endpoint group type. If this endpoint group represents a
SCSI target group, the value of this property shall contain
ServerorTarget.
| string | Description |
|---|---|
| Client (deprecated v1.3) | The group contains the client (initiator)
endpoints.
Initiator. |
| Initiator (v1.3+) | The group contains the initiator
endpoints.
|
| Server (deprecated v1.3) | The group contains the server (target)
endpoints.
Target. |
| Target (v1.3+) | The group contains the target
endpoints.
|
6.38.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.39 EnvironmentMetrics 1.3.0
| Version | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2022.2 | 2021.4 | 2021.2 | 2020.4 |
6.39.1 Description
The EnvironmentMetrics schema represents the environmental metrics of a device.
- This resource shall represent the environmental metrics for a Redfish implementation.
6.39.2 URIs
/redfish/v1/Chassis/{ChassisId}/Drives/{DriveId}/EnvironmentMetrics
/redfish/v1/Chassis/{ChassisId}/EnvironmentMetrics
/redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/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}/Processors/{ProcessorId}/Ports/{PortId}/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}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/EnvironmentMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/GraphicsControllers/{ControllerId}/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}/Processors/{ProcessorId}/Ports/{PortId}/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/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/USBControllers/{ControllerId}/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/Managers/{ManagerId}/DedicatedNetworkPorts/{PortId}/EnvironmentMetrics
/redfish/v1/Managers/{ManagerId}/USBPorts/{PortId}/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}/Processors/{ProcessorId}/Ports/{PortId}/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}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/EnvironmentMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/GraphicsControllers/{ControllerId}/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}/Processors/{ProcessorId}/Ports/{PortId}/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/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/USBControllers/{ControllerId}/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}/GraphicsControllers/{ControllerId}/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}/Processors/{ProcessorId}/Ports/{PortId}/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
/redfish/v1/Systems/{ComputerSystemId}/USBControllers/{ControllerId}/Ports/{PortId}/EnvironmentMetrics
/redfish/v1/ThermalEquipment/CDUs/{CoolingUnitId}/EnvironmentMetrics
/redfish/v1/ThermalEquipment/HeatExchangers/{CoolingUnitId}/EnvironmentMetrics
/redfish/v1/ThermalEquipment/ImmersionUnits/{CoolingUnitId}/EnvironmentMetrics
6.39.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AbsoluteHumidity (v1.2+) {} | object | Absolute humidity (g/cu m).
|
|
| DewPointCelsius (v1.1+) {} | object | The dew point temperature (C).
|
|
| EnergyJoules (v1.2+) {} | object | Energy consumption (J).
|
|
| EnergykWh { | object (excerpt) |
Energy consumption (kWh).
|
|
| ApparentkVAh (v1.5+) | number (kV.A.h) |
read-only (null) |
Apparent energy (kVAh).
|
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| LifetimeReading (v1.1+) | number | read-only (null) |
The total accumulation value for this
sensor.
|
| ReactivekVARh (v1.5+) | number (kV.A.h) |
read-only (null) |
Reactive energy (kVARh).
|
| Reading | number | read-only (null) |
The sensor value.
|
| SensorResetTime | string (date-time) |
read-only (null) |
The date and time when the time-based
properties were last reset.
|
| } | |||
| FanSpeedsPercent [ { | array (excerpt) |
Fan speeds (percent).
|
|
| 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.
|
| PhysicalSubContext | string (enum) |
read-only (null) |
The usage or location within a device to
which this sensor measurement applies.
|
| Reading | number | read-only (null) |
The sensor value.
|
| SpeedRPM (v1.2+) | number ({rev}/min) |
read-only (null) |
The rotational speed.
|
| } ] | |||
| HumidityPercent {} | object | Humidity (percent).
|
|
| PowerLimitWatts (v1.1+) { | object (excerpt) |
Power limit (W).
|
|
| AllowableMax | number | read-only (null) |
The maximum possible setting for this
control.
|
| AllowableMin | number | read-only (null) |
The minimum possible setting for this
control.
|
| ControlMode | string (enum) |
read-write (null) |
The current operating mode of the
control.
|
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this control.
|
| DefaultSetPoint (v1.3+) | number | read-only (null) |
The default set point of the
control.
|
| Reading | number | read-only (null) |
The reading of the sensor associated with
this control.
|
| ReadingUnits | string | read-only (null) |
The units of the sensor reading associated
with this control.
|
| SetPoint | number | read-write (null) |
The desired set point of the
control.
|
| } | |||
| PowerLoadPercent (v1.1+) {} | object | The power load (percent) for this
device.
|
|
| PowerWatts { | object (excerpt) |
Power consumption (W).
|
|
| ApparentVA | number (V.A) |
read-only (null) |
The product of voltage and current for an
AC circuit, in volt-ampere units.
|
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| PhaseAngleDegrees (v1.5+) | number | read-only (null) |
The phase angle (degrees) between the
current and voltage waveforms.
|
| PowerFactor | number | read-only (null) |
The power factor for this
sensor.
|
| ReactiveVAR | number (V.A) |
read-only (null) |
The square root of the difference term of
squared apparent VA and squared power (Reading) for a circuit, in VAR
units.
|
| Reading | number | read-only (null) |
The sensor value.
|
| } | |||
| TemperatureCelsius {} | object | Temperature (Celsius).
|
6.39.4 Actions
6.39.4.1 ResetMetrics
Description
This action resets the summary metrics related to this equipment.
- This action shall reset any time intervals or counted values for this equipment.
Action URI
{Base URI of target resource}/Actions/EnvironmentMetrics.ResetMetrics
Action parameters
This action takes no parameters.
6.39.4.2 ResetToDefaults (v1.3+)
Description
The action resets the values of writable properties to factory defaults.
- This action shall reset the values of writable properties in this resource to their default values as specified by the manufacturer.
Action URI
{Base URI of target resource}/Actions/EnvironmentMetrics.ResetToDefaults
Action parameters
This action takes no parameters.
6.39.5 Property details
6.39.5.1 ControlMode
The current operating mode of the control.
- This property shall contain the operating mode of the control.
| string | Description |
|---|---|
| Automatic | Automatically adjust control to meet the set point. |
| Disabled | The control has been disabled. |
| Manual | No automatic adjustments are made to the control. |
| Override | User override of the automatic set point value. |
6.39.5.2 PhysicalContext
The area or device to which this sensor measurement applies.
- This property shall contain a description of the affected component or region within the equipment 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. |
| Battery | A battery. |
| Board | A circuit board.
|
| Chassis | The entire chassis. |
| ComputeBay | Within a compute bay. |
| CoolingSubsystem | The entire cooling, or air and liquid, subsystem. |
| CPU | A processor (CPU). |
| CPUSubsystem | The entire processor (CPU) subsystem. |
| DCBus | A DC bus. |
| Exhaust | The air exhaust point or points or region of the chassis. |
| ExpansionBay | Within an expansion bay. |
| Fan | A fan. |
| FPGA | An FPGA. |
| Front | The front of the chassis. |
| GPU | A graphics processor (GPU). |
| GPUSubsystem | The entire graphics processor (GPU) subsystem. |
| Intake | The air intake point or points or region of the chassis. |
| LiquidInlet | The liquid inlet point of the chassis. |
| LiquidOutlet | The liquid outlet point of the chassis. |
| Lower | The lower portion of the chassis. |
| Memory | A memory device. |
| MemorySubsystem | The entire memory subsystem. |
| Motor | A motor. |
| NetworkBay | Within a networking bay. |
| NetworkingDevice | A networking device. |
| PowerSubsystem | The entire power subsystem. |
| PowerSupply | A power supply. |
| PowerSupplyBay | Within a power supply bay. |
| Pump | A pump. |
| Rectifier | A rectifier device. |
| Room | The room. |
| StorageBay | Within a storage bay. |
| StorageDevice | A storage device. |
| SystemBoard | The system board (PCB). |
| Transceiver | A transceiver.
|
| Transformer | A transformer. |
| TrustedModule | A trusted module. |
| Upper | The upper portion of the chassis. |
| VoltageRegulator | A voltage regulator device. |
6.39.5.3 PhysicalSubContext
The usage or location within a device to which this sensor measurement applies.
- This property shall contain a description of the usage or sub-region within the equipment to which this sensor measurement applies. This property generally differentiates multiple sensors within the same PhysicalContext instance.
| string | Description |
|---|---|
| Input | The input. |
| Output | The output. |
6.39.5.4 SensorExcerpt
The Sensor schema describes a sensor and its properties. This object is an excerpt of the Sensor resource located at the URI shown in DataSourceUri.
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| Reading | number | read-only (null) |
The sensor value.
|
6.39.6 Example response
{
"@odata.type": "#EnvironmentMetrics.v1_3_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
}
],
"@odata.id": "/redfish/v1/Systems/437XR1138R2/Processors/1/EnvironmentMetrics"
}6.40 EthernetInterface 1.11.0
| Version | v1.11 | v1.10 | v1.9 | v1.8 | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2023.2 | 2023.1 | 2022.2 | 2021.2 | 2020.1 | 2019.1 | 2017.3 | 2017.1 | 2016.3 | 2016.2 | 1.0 |
6.40.1 Description
The EthernetInterface schema represents a single, logical Ethernet interface or network interface controller (NIC).
- This resource contains NIC resources as part of the Redfish Specification.
6.40.2 URIs
/redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/NetworkDeviceFunctions/{NetworkDeviceFunctionId}/EthernetInterfaces/{EthernetInterfaceId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/EthernetInterfaces/{EthernetInterfaceId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/EthernetInterfaces/{EthernetInterfaceId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/OperatingSystem/Containers/EthernetInterfaces/{EthernetInterfaceId}
/redfish/v1/Managers/{ManagerId}/EthernetInterfaces/{EthernetInterfaceId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/EthernetInterfaces/{EthernetInterfaceId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/EthernetInterfaces/{EthernetInterfaceId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/OperatingSystem/Containers/EthernetInterfaces/{EthernetInterfaceId}
/redfish/v1/Systems/{ComputerSystemId}/EthernetInterfaces/{EthernetInterfaceId}
/redfish/v1/Systems/{ComputerSystemId}/OperatingSystem/Containers/EthernetInterfaces/{EthernetInterfaceId}
6.40.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.
|
| 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.
|
| 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 this interface
uses a DHCP v6-supplied domain name.
|
| 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.
|
| 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) | This type describes an IPv4
address.
|
|
| IPv4StaticAddresses (v1.4+) [ { } ] | array (object) | (null) |
This type describes an IPv4
address.
|
| IPv6Addresses [ { } ] | array (object) | This type describes an IPv6
address.
|
|
| 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) |
This type represents a single IPv6 static
address to be assigned on a network interface.
|
| IPv6StaticDefaultGateways (v1.4+) [ { } ] | array (object) | (null) |
This type represents a single IPv6 static
address to be assigned on a network interface.
|
| Links (v1.1+) { | object | required on create | The links to other resources that are
related to this resource.
|
| AffiliatedInterfaces (v1.10+) [ { | array | The links to the Ethernet interfaces that
are affiliated with this interface, such as a VLAN or a team that uses
this interface.
|
|
| @odata.id | string | read-only | Link to another EthernetInterface resource. |
| } ] | |||
| Chassis (v1.3+) { | object | The link to the chassis that contains this
Ethernet interface.
|
|
| @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.
|
|
| @odata.id | string | read-only | Link to a HostInterface resource. See the Links section and the HostInterface schema for details. |
| } | |||
| NetworkDeviceFunction (v1.6+, deprecated v1.7 { | 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.
|
| @odata.id | string | read-only | Link to a NetworkDeviceFunction resource. See the Links section and the NetworkDeviceFunction schema for details. |
| } | |||
| NetworkDeviceFunctions (v1.7+) [ { | array | The link to the network device functions
that comprise this Ethernet interface.
|
|
| @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 Using this guide clause. | |
| Ports (v1.9+) [ { | array | The links to the ports providing this
Ethernet interface.
|
|
| @odata.id | string | read-only | Link to a Port resource. See the Links section and the Port schema for details. |
| } ] | |||
| RelatedInterfaces (v1.9+) [ { | array | required on create | The links to the Ethernet interfaces that
comprise this Ethernet interface.
|
| @odata.id | string | read-write | Link to another EthernetInterface resource. |
| } ] | |||
| } | |||
| LinkStatus (v1.1+) | string (enum) |
read-only (null) |
The link status of this interface, or
port.
|
| MACAddress | string | read-write (null) |
The currently configured MAC address of
the interface, or logical port.
^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$ |
| 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.
^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$ |
| RoutingScope (v1.11+) | string (enum) |
read-only (null) |
The routing scope for this
interface.
|
| 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.
|
|
| TeamMode (v1.9+) | string (enum) |
read-write (null) |
The team mode for this
interface.
|
| 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.
|
|
| Tagged (v1.3+) | boolean | read-write (null) |
An indication of whether this VLAN is
tagged or untagged for this interface.
|
| 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 (deprecated v1.7) { | 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.
|
|
| @odata.id | string | read-only | Link to Collection of VLanNetworkInterface. See the VLanNetworkInterface schema for details. |
| } |
6.40.4 Property details
6.40.4.1 EthernetInterfaceType
The type of interface.
- This property shall contain the type of interface.
| string | Description |
|---|---|
| Physical | A physical Ethernet interface.
|
| Virtual | A virtual Ethernet interface.
|
6.40.4.2 FallbackAddress
DHCPv4 fallback address method for this interface.
- This property shall contain the fallback address method of DHCPv4.
| 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.40.4.3 LinkStatus
The link status of this interface, or port.
- This property shall contain 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.40.4.4 OperatingMode
Determines the DHCPv6 operating mode for this interface.
- This property shall control the operating mode of DHCPv6 on this interface.
| string | Description |
|---|---|
| Disabled | DHCPv6 is disabled.
|
| Enabled (v1.8+) | DHCPv6 is enabled.
|
| Stateful (deprecated v1.8) | DHCPv6 stateful mode.
Enabled. The
control between 'stateful' and 'stateless' is managed by the DHCP server
and not the client. |
| Stateless (deprecated v1.8) | DHCPv6 stateless mode.
Enabled. The
control between 'stateful' and 'stateless' is managed by the DHCP server
and not the client. |
6.40.4.5 RoutingScope
The routing scope for this interface.
- This property shall contain the routing scope for this interface. This property shall only be present if this interface belongs to a virtual machine or container.
| string | Description |
|---|---|
| External | Externally accessible.
|
| HostOnly | Only accessible to a dedicated interface
on the host.
|
| Internal | Only accessible to internal networking on
the host, such as when virtual machines or containers are allowed to
communicate with each other on the same host system as well as a
dedicated interface on the hosting system.
|
| Limited | Accessible through IP translation provided
by the hosting system.
|
6.40.4.6 TeamMode
The team mode for this interface.
- This property shall contain
the team mode for this interface. If this property is not present, the
value shall be assumed to be
None.
| string | Description |
|---|---|
| ActiveBackup | One interface in the team is active and the others are kept in standby until a failure occurs. |
| AdaptiveLoadBalancing | Packets are transmitted and received based upon the current load of each interface in the team. |
| AdaptiveTransmitLoadBalancing | Packets are transmitted based upon the current load of each interface in the team. |
| Broadcast | Packets are transmitted on all interfaces in the team. |
| IEEE802_3ad | The interfaces in the team create an IEEE802.3ad link aggregation group. |
| None | No teaming. |
| RoundRobin | Packets are transmitted in sequential order from the teamed interfaces. |
| XOR | Transmitting is determined based upon a hash policy. |
6.40.5 Example response
{
"@odata.type": "#EthernetInterface.v1_11_0.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": "Enabled",
"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"
},
{
"Address": "fc00:1234::a:b:c:d",
"PrefixLength": 64,
"AddressOrigin": "Static",
"AddressState": "Preferred"
},
{
"Address": "2001:1:3:5::100",
"PrefixLength": 64,
"AddressOrigin": "DHCPv6",
"AddressState": "Preferred"
},
{
"Address": "2002:2:5::1ec1:deff:fe6f:1e24",
"PrefixLength": 64,
"AddressOrigin": "SLAAC",
"AddressState": "Preferred"
}
],
"StaticNameServers": [
"192.168.150.1",
"fc00:1234:200:2500"
],
"VLAN": {
"VLANEnable": true,
"VLANId": 101
},
"@odata.id": "/redfish/v1/Systems/437XR1138R2/EthernetInterfaces/12446A3B0411"
}6.41 Event 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 | 2023.2 | 2023.1 | 2021.2 | 2020.3 | 2020.2 | 2019.1 | 2018.2 | 2017.1 | 2016.1 | 1.0 |
6.41.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.
- This resource contains an event for a Redfish implementation.
6.41.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.
|
|
| AdditionalDataSizeBytes (v1.8+) | integer (bytes) |
read-only (null) |
The size of the additional data for this
event.
|
| AdditionalDataURI (v1.8+) | string (URI) |
read-only (null) |
The URI at which to access the additional
data for the event, such as diagnostic data, image captures, or other
files.
|
| 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.
|
| CPER (v1.8+) { | object | Details for a CPER section or record
associated with this event.
|
|
| NotificationType (v1.8+) | string (uuid) |
read-only (null) |
The CPER Notification Type for a CPER
record.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ |
| Oem (v1.8+) {} | object | See the OEM object definition in the Using this guide clause. | |
| SectionType (v1.8+) | string (uuid) |
read-only (null) |
The CPER Section Type.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ |
| } | |||
| DiagnosticData (v1.8+) | string | read-only (null) |
A Base64-encoded set of diagnostic data
associated with this event.
|
| DiagnosticDataType (v1.8+) | string (enum) |
read-only (null) |
The type of data available in the
DiagnosticData property or retrieved from the URI specified by the
AdditionalDataURI property.
|
| 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.
|
| LogEntry (v1.7+) { | object | The link to a log entry if an entry was
created for this event.
|
|
| @odata.id | string | read-only | Link to a LogEntry resource. See the Links section and the LogEntry schema for details. |
| } | |||
| MemberId | string | read-only required | The unique identifier for the member
within an array.
|
| 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.
^[A-Za-z0-9]+\.\d+\.\d+\.[A-Za-z0-9.]+$ |
| MessageSeverity (v1.5+) | string (enum) |
read-only | The severity of the message in this
event.
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| OEMDiagnosticDataType (v1.9+) | string | read-only (null) |
The OEM-defined type of data available in
the DiagnosticData property or retrieved from the URI specified by the
AdditionalDataURI property.
|
| 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.
|
| } | |||
| Resolution (v1.9+) | string | read-only | Used to provide suggestions on how to
resolve the situation that caused the event.
|
| Severity (deprecated v1.5) | string | read-only | The severity of the event.
|
| SpecificEventExistsInGroup (v1.6+) | boolean | read-only | Indicates this event is equivalent to a
more specific event in this Event Group.
|
| } ] |
6.41.3 Property details
6.41.3.1 DiagnosticDataType
The type of data available in the DiagnosticData property or retrieved from the URI specified by the AdditionalDataURI property.
- This property shall contain the type of data available in the DiagnosticData property or retrieved from the URI specified by the AdditionalDataURI property.
| string | Description |
|---|---|
| CPER | UEFI Common Platform Error
Record.
|
| CPERSection | A Section of a UEFI Common Platform Error
Record.
|
| Manager | Manager diagnostic data. |
| OEM | OEM diagnostic data. |
| OS | Operating system (OS) diagnostic data. |
| PreOS | Pre-OS diagnostic data. |
6.41.3.2 EventType
The type of event.
- This property shall indicate 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.41.3.3 MessageSeverity
The severity of the message in this event.
- This property shall contain the severity of the message in this event. Services can replace the value defined in the message registry with a value more applicable to the implementation.
| string | Description |
|---|---|
| Critical | A critical condition requires immediate attention. |
| OK | Normal. |
| Warning | A condition requires attention. |
6.41.4 Example response
{
"@odata.type": "#Event.v1_7_0.Event",
"Id": "1",
"Name": "Event Array",
"Context": "ContosoWebClient",
"Events": [
{
"EventType": "Other",
"EventId": "4593",
"Severity": "Warning",
"Message": "A cable has been removed from network adapter '1' port '1'.",
"MessageId": "NetworkDevice.1.0.CableRemoved",
"MessageArgs": [
"1",
"1"
],
"OriginOfCondition": {
"@odata.id": "/redfish/v1/Systems/1/EthernetInterfaces/1"
},
"LogEntry": {
"@odata.id": "/redfish/v1/Managers/BMC/LogServices/EventLog/Entries/532"
}
}
]
}6.42 EventDestination 1.13.2
| Version | v1.13 | v1.12 | v1.11 | v1.10 | v1.9 | v1.8 | v1.7 | v1.6 | v1.5 | v1.4 | v1.3 | ... |
| Release | 2022.3 | 2022.1 | 2021.2 | 2020.4 | 2020.3 | 2020.1 | 2019.3 | 2019.2 | 2019.1 | 2018.2 | 2018.1 | ... |
6.42.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.
- This resource shall represent the target of an event subscription, including the event types and context to provide to the target in the event payload.
6.42.2 URIs
/redfish/v1/EventService/Subscriptions/{EventDestinationId}
6.42.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.
|
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| ClientCertificates (v1.11+) { | object | The link to a collection of client
identity certificates provided to the server referenced by the
Destination property.
|
|
| @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.
|
| 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.
|
| EventTypes (deprecated v1.5) [ ] | array (string (enum)) |
read-only |
Other. |
| ExcludeMessageIds (v1.12+) [ ] | array (string, null) | read-only | The list of MessageIds that are not sent
to this event destination.
|
| ExcludeRegistryPrefixes (v1.12+) [ ] | array (string, null) | read-only | The list of prefixes for the message
registries that contain the MessageIds that are not sent to this event
destination.
|
| HeartbeatIntervalMinutes (v1.11+) | integer | read-only (null) |
Interval for sending heartbeat events to
the destination in minutes.
|
| 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 are sent to
this event destination.
|
| 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.
|
|
| @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.
|
| RegistryPrefixes (v1.4+) [ ] | array (string, null) | read-only | The list of 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.
|
| SendHeartbeat (v1.11+) | boolean | read-only (null) |
Send a heartbeat event periodically to the
destination.
|
| Severities (v1.13+) [ ] | array (string (enum)) |
read-only (null) |
|
| SNMP (v1.7+) { | object | Settings for an SNMP event
destination.
|
|
| AuthenticationKey (v1.7+) | string | read-write (null) |
The secret authentication key for
SNMPv3.
(^[ !#-~]+$)|(^Passphrase:[ ^[ !#-~]+$)|(^Hex:[0-9A-Fa-f]{24,96})|(^\*+$) |
| 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.
|
| EncryptionKey (v1.7+) | string | read-write (null) |
The secret authentication key for
SNMPv3.
(^[A-Za-z0-9]+$)|(^\*+$) |
| 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.
|
| TrapCommunity (v1.7+) | string | read-write (null) |
The SNMP trap community
string.
|
| } | |||
| Status (v1.6+) {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| 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 is for
events in the OriginResources array only. If the OriginResources array
is not present, this property has no relevance.
|
| SubscriptionType (v1.3+) | string (enum) |
read-only required (null) |
The subscription type for
events.
|
| SyslogFilters (v1.9+) [ { | array | A list of filters applied to syslog
messages before sending to a remote syslog server. An empty list
indicates all syslog messages are sent.
|
|
| LogFacilities (v1.9+) [ ] | array (string (enum)) |
read-write (null) |
The syslog facility code is an enumeration
of program types.
|
| LowestSeverity (v1.9+) | string (enum) |
read-write (null) |
The lowest severity level message that
will be forwarded.
|
| } ] | |||
| 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.42.4 Actions
6.42.4.1 ResumeSubscription
Description
This action resumes a suspended event subscription.
- This action shall resume a suspended event subscription, which affects the subscription status. The service may deliver buffered events when the subscription is resumed.
Action URI
{Base URI of target resource}/Actions/EventDestination.ResumeSubscription
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| DeliverBufferedEventDuration (v1.12+) | string (duration) |
optional | The maximum age of buffered events that
should be delivered when resuming the subscription.
^P(\d+D)?(T(\d+H)?(\d+M)?(\d+(.\d+)?S)?)?$ |
Request Example
{
"DeliverBufferedEventDuration": "PT8H"
}6.42.4.2 SuspendSubscription (v1.12+)
Description
This action suspends an event subscription.
- This action shall
suspend an event subscription. No events shall be sent to the event
destination until invocation of the ResumeSubscription action. The value
of the State property within Status shall contain
Disabledfor a suspended subscription. The service may buffer events while the subscription is suspended.
Action URI
{Base URI of target resource}/Actions/EventDestination.SuspendSubscription
Action parameters
This action takes no parameters.
6.42.5 Property details
6.42.5.1 AuthenticationProtocol
The authentication protocol for SNMPv3.
- This property shall contain the SNMPv3 authentication protocol.
| 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.42.5.2 DeliveryRetryPolicy
The subscription delivery retry policy for events, where the subscription type is RedfishEvent.
- This property shall indicate 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 continues
regardless of the number of retries.
|
| RetryForeverWithBackoff (v1.10+) | The subscription is not suspended or
terminated, and attempts at delivery of future events continues
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.42.5.3 EncryptionProtocol
The encryption protocol for SNMPv3.
- This property shall contain the SNMPv3 encryption protocol.
| string | Description |
|---|---|
| CBC_DES | CBC-DES encryption.
|
| CFB128_AES128 | CFB128-AES-128 encryption.
|
| None | No encryption.
|
6.42.5.4 EventFormatType
The content types of the message that are sent to the EventDestination.
- This property shall indicate the content types of the message that this service sends to the EventDestination. If this property is not present, the EventFormatType shall be assumed to be Event.
| string | Description |
|---|---|
| Event | The subscription destination receives an
event payload.
|
| MetricReport | The subscription destination receives a
metric report.
|
6.42.5.5 EventTypes
- The types of events that are sent to the destination.
- This property shall contain an array that contains the types of events that shall be sent to the destination. To specify that a client is subscribing for metric reports, the EventTypes property should include 'MetricReport'. If the subscription does not include this property, the service shall use a single element with a default of `Other`.
| 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.42.5.6 LogFacilities
The syslog facility code is an enumeration of program types.
- The types of programs that can log messages.
- This property shall contain the types of programs that can log messages. If this property contains an empty array or is absent, all facilities shall be indicated.
| 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 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.42.5.7 LowestSeverity
The lowest severity level message that will be forwarded.
- This
property shall contain the lowest syslog severity level that will be
forwarded. The service shall forward all messages equal to or greater
than the value in this property. The value
Allshall indicate all severities.
| 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 might require special handling. |
| Warning | A Warning. |
6.42.5.8 Protocol
The protocol type of the event connection.
- This property shall
contain the protocol type that the event uses to send the event to the
destination. A
Redfishvalue shall indicate that the event type shall adhere to the type defined in the Redfish Specification.
| string | Description |
|---|---|
| Kafka (v1.13+) | The destination follows the Kafka protocol
for event notifications.
|
| 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.42.5.9 Severities
- The list of severities that are sent to this event destination.
- This property shall contain an array of severities that are the allowable values for the MessageSeverity property within an event sent to the subscriber. If this property is an empty array or is absent, no filtering based upon the MessageSeverity of an event is performed.
| string | Description |
|---|---|
| Critical | A critical condition requires immediate attention. |
| OK | Normal. |
| Warning | A condition requires attention. |
6.42.5.10 SubscriptionType
The subscription type for events.
- This property shall indicate the type of subscription for events. If this property is not present, the SubscriptionType shall be assumed to be RedfishEvent.
| 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.42.6 Example response
{
"@odata.type": "#EventDestination.v1_13_2.EventDestination",
"Id": "1",
"Name": "WebUser3 subscribes to all Redfish events",
"Destination": "http://www.dnsname.com/Destination1",
"SubscriptionType": "RedfishEvent",
"DeliveryRetryPolicy": "TerminateAfterRetries",
"RegistryPrefixes": [],
"MessageIds": [],
"OriginResources": [],
"ResourceTypes": [],
"Status": {
"State": "Enabled"
},
"Actions": {
"#EventDestination.ResumeSubscription": {
"target": "/redfish/v1/EventService/Subscriptions/1/Actions/EventDestination.ResumeSubscription"
}
},
"Context": "WebUser3",
"Protocol": "Redfish",
"@odata.id": "/redfish/v1/EventService/Subscriptions/1"
}6.43 EventService 1.10.0
| Version | v1.10 | v1.9 | v1.8 | v1.7 | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2023.1 | 2022.3 | 2022.1 | 2020.2 | 2020.1 | 2019.3 | 2019.2 | 2019.1 | 2018.2 | 2018.1 | 1.0 |
6.43.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.
- This resource shall represent an event service for a Redfish implementation.
6.43.2 URIs
/redfish/v1/EventService
6.43.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) |
|
| EventTypesForSubscription (deprecated v1.3) [ ] | array (string (enum)) |
read-only |
|
| ExcludeMessageId (v1.8+) | boolean | read-only | An indication of whether the service
supports filtering by the ExcludeMessageIds property.
|
| ExcludeRegistryPrefix (v1.8+) | boolean | read-only | An indication of whether the service
supports filtering by the ExcludeRegistryPrefixes 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 RegistryPrefixes or
ExcludeRegistryPrefixes properties 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. If false, events are no longer published, new SSE
connections cannot be established, and existing SSE connections are
terminated.
|
| Severities (v1.9+) [ ] | array (string (enum)) |
read-only (null) |
|
| SMTP (v1.5+) { | object | Settings for SMTP event
delivery.
|
|
| Authentication (v1.5+) | string (enum) |
read-write (null) |
The authentication method for the SMTP
server.
|
| ConnectionProtocol (v1.5+) | string (enum) |
read-write (null) |
The connection type to the outgoing SMTP
server.
|
| 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.
|
| PasswordSet (v1.9+) | boolean | read-only | Indicates if the Password property is
set.
|
| 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 EventTypes property.
|
| MessageId (v1.2+) | boolean | read-only | An indication of whether the service
supports filtering by the MessageIds property.
|
| MetricReportDefinition (v1.2+) | boolean | read-only | An indication of whether the service
supports filtering by the MetricReportDefinitions property.
|
| OriginResource (v1.2+) | boolean | read-only | An indication of whether the service
supports filtering by the OriginResources property.
|
| RegistryPrefix (v1.2+) | boolean | read-only | An indication of whether the service
supports filtering by the RegistryPrefixes property.
|
| ResourceType (v1.2+) | boolean | read-only | An indication of whether the service
supports filtering by the ResourceTypes 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.
|
|
| 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.
|
|
| @odata.id | string | read-only | Link to Collection of EventDestination. See the EventDestination schema for details. |
| } |
6.43.4 Actions
6.43.4.1 SubmitTestEvent
Description
This action generates a test event.
- This action shall add a test event to the event service with the event data specified in the action parameters. Then, this message should be sent to any appropriate event destinations.
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.
|
| 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.
^\w+\.\d+\.\d+\.\w+$ |
| MessageSeverity (v1.10+) | string (enum) |
optional | The severity 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.
|
Request Example
{
"EventId": "5",
"EventTimestamp": "2016-01-10T18:02:00Z",
"Severity": "Critical",
"Message": "Fan 2 crossed Lower Fatal Threshold; fans are no longer redundant",
"MessageId": "Event.1.0.FanWayTooSlow",
"MessageArgs": [
"2"
],
"OriginOfCondition": "/redfish/v1/Chassis/MultiBladeEncl/Thermal"
}6.43.4.2 TestEventSubscription (v1.10+)
Description
This action generates a test event using the pre-defined test message.
- This action shall send an event containing the TestMessage message from the Resource Event Message Registry to all appropriate event destinations.
Action URI
{Base URI of target resource}/Actions/EventService.TestEventSubscription
Action parameters
This action takes no parameters.
6.43.5 Property details
6.43.5.1 Authentication
The authentication method for the SMTP server.
- This property shall contain the authentication method for the SMTP server.
| string | Description |
|---|---|
| AutoDetect | Auto-detect.
|
| CRAM_MD5 | CRAM-MD5 authentication.
|
| Login (deprecated v1.7) | LOGIN authentication.
Plain, which supersedes the
LOGIN authentication method for SASL. |
| None | No authentication.
|
| Plain | PLAIN authentication.
|
6.43.5.2 ConnectionProtocol
The connection type to the outgoing SMTP server.
- This property shall contain the connection type to the outgoing SMTP server.
| string | Description |
|---|---|
| AutoDetect | Auto-detect.
|
| None | Clear text.
|
| StartTLS | StartTLS.
|
| TLS_SSL | TLS/SSL.
|
6.43.5.3 EventFormatTypes
- The content types of the message that this service can send to the event destination.
- This property shall contain the content types of the message that this service can send to the event destination. If this property is not present, the EventFormatType shall be assumed to be `Event`.
| string | Description |
|---|---|
| Event | The subscription destination receives an
event payload.
|
| MetricReport | The subscription destination receives a
metric report.
|
6.43.5.4 EventType
The type for the event to add.
- This parameter shall contain the property name for which the following allowable values apply. If not provided by the client, the resulting event should not contain the EventType property.
| 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.43.5.5 EventTypesForSubscription
- The types of events to which a client can subscribe.
- This property shall contain the types of events to which a client can subscribe. The semantics associated with the enumeration values are defined in the Redfish Specification.
| 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.43.5.6 MessageSeverity
The severity for the event to add.
- This property shall contain the severity for the event to add and and have the same semantics as the MessageSeverity property in the Event schema for Redfish. If not provided by the client, the resulting event should not contain the MessageSeverity property.
| string | Description |
|---|---|
| Critical | A critical condition requires immediate attention. |
| OK | Normal. |
| Warning | A condition requires attention. |
6.43.5.7 Severities
- The list of severities that can be specified in the Severities array in a subscription.
- This property shall specify an array of the allowable severities that can be used for an event subscription. If this property is absent or contains an empty array, the service does not support severity-based subscriptions.
| string | Description |
|---|---|
| Critical | A critical condition requires immediate attention. |
| OK | Normal. |
| Warning | A condition requires attention. |
6.43.6 Example response
{
"@odata.type": "#EventService.v1_10_0.EventService",
"Id": "EventService",
"Name": "Event Service",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"ServiceEnabled": true,
"DeliveryRetryAttempts": 3,
"DeliveryRetryIntervalSeconds": 60,
"EventTypesForSubscription": [
"StatusChange",
"ResourceUpdated",
"ResourceAdded",
"ResourceRemoved",
"Alert",
"Other"
],
"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"
}
},
"@odata.id": "/redfish/v1/EventService"
}6.44 ExternalAccountProvider 1.7.0
| Version | v1.7 | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2023.2 | 2023.1 | 2022.3 | 2022.1 | 2021.2 | 2020.4 | 2018.3 | 2018.1 |
6.44.1 Description
The ExternalAccountProvider schema represents a remote service that provides accounts for this manager to use for authentication.
- This resource shall represent a remote authentication service in the Redfish Specification.
6.44.2 URIs
/redfish/v1/AccountService/ExternalAccountProviders/{ExternalAccountProviderId}
/redfish/v1/Managers/{ManagerId}/RemoteAccountService/ExternalAccountProviders/{ExternalAccountProviderId}
6.44.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.
|
| 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.
|
| EncryptionKey (v1.2+) | string | read-write (null) |
Specifies the encryption key.
^[0-9a-fA-F]+$ |
| 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 Using this guide clause. | |
| 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.
|
|
| @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 Using this guide clause. | |
| 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.
|
| EmailAttribute (v1.7+) | string | read-write (null) |
The attribute name that contains the LDAP
user's email address.
|
| 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.
|
| SSHKeyAttribute (v1.4+) | string | read-write (null) |
The attribute name that contains the LDAP
user's SSH public key 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 Using this guide clause. | |
| } | |||
| OAuth2Service (v1.3+) { | object | (null) |
The additional information needed to parse
an OAuth 2.0 service.
|
| Audience (v1.3+) [ ] | array (string) | read-only | The allowable audience strings of the
Redfish service.
|
| Issuer (v1.3+) | string | read-write (null) |
The issuer string of the OAuth 2.0
service. Clients should configure this property if Mode contains
Offline.
|
| Mode (v1.3+) | string (enum) |
read-write | The mode of operation for token
validation.
|
| OAuthServiceSigningKeys (v1.3+) | string | read-write (null) |
The Base64-encoded signing keys of the
issuer of the OAuth 2.0 service. Clients should configure this property
if Mode contains Offline.
|
| Oem (v1.6+) {} | object | See the OEM object definition in the Using this guide clause. | |
| } | |||
| 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.
|
| MFABypass (v1.5+) { | object | (null) |
The multi-factor authentication bypass
settings.
|
| @odata.id | string | read-only | Link to a MFABypass resource. See the Links section and the AccountService schema for details. |
| } | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| 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.
|
| } ] | |||
| Retries (v1.6+) | integer | read-write (null) |
The number of times to retry connecting to
an address in the ServiceAddresses property before attempting the next
address in the array.
|
| 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.
|
| AuthorizationService (v1.6+) | string | read-write | The TACACS+ service authorization
argument.
|
| Oem (v1.6+) {} | object | See the OEM object definition in the Using this guide clause. | |
| PasswordExchangeProtocols (v1.2+) [ ] | array (string (enum)) |
read-write (null) |
|
| PrivilegeLevelArgument (v1.2+) | string | read-write (null) |
Indicates the name of the TACACS+ argument
name in an authorization request.
|
| } | |||
| TimeoutSeconds (v1.6+) | integer | read-write (null) |
The period of time, in seconds, this
account service will wait for a response from an address of a user
account provider before timing out.
|
6.44.4 Property details
6.44.4.1 AccountProviderType
The type of external account provider to which this service connects.
- This property shall contain the type of external account provider to which this service connects.
| string | Description |
|---|---|
| ActiveDirectoryService | An external Active Directory
service.
|
| LDAPService | A generic external LDAP
service.
|
| OAuth2 (v1.3+) | An external OAuth 2.0 service.
|
| OEM | An OEM-specific external authentication or directory service. |
| RedfishService | An external Redfish service.
|
| TACACSplus (v1.3+) | An external TACACS+ service.
|
6.44.4.2 AuthenticationType
The type of authentication used to connect to the external account provider.
- This property shall contain 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.44.4.3 Mode
The mode of operation for token validation.
- This property shall contain the mode of operation for token validation.
| string | Description |
|---|---|
| Discovery | OAuth 2.0 service information for token
validation is downloaded by the service.
|
| Offline | OAuth 2.0 service information for token
validation is configured by a client. Clients should configure the
Issuer and OAuthServiceSigningKeys properties for this mode.
|
6.44.4.4 PasswordExchangeProtocols
- Indicates the allowed TACACS+ password exchange protocols.
- This property shall indicate all the allowed TACACS+ password exchange protocol described under section 5.4.2 of RFC8907.
| 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.44.5 Example response
{
"@odata.type": "#ExternalAccountProvider.v1_7_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.45 Fabric 1.3.0
| Version | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2021.4 | 2020.3 | 2019.4 | 2016.2 |
6.45.1 Description
The Fabric schema represents a simple fabric consisting of one or more switches, zero or more endpoints, and zero or more zones.
- This resource shall represent a simple switchable fabric for a Redfish implementation.
6.45.2 URIs
/redfish/v1/Fabrics/{FabricId}
6.45.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AddressPools (v1.1+) { | object | The collection of links to the address
pools that this fabric contains.
|
|
| @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.
|
|
| @odata.id | string | read-only | Link to Collection of Connection. See the Connection schema for details. |
| } | |||
| EndpointGroups (v1.2+) { | object | The collection of links to the endpoint
groups that this fabric contains.
|
|
| @odata.id | string | read-only | Link to Collection of EndpointGroup. See the EndpointGroup schema for details. |
| } | |||
| Endpoints { | object | The collection of links to the endpoints
that this fabric contains.
|
|
| @odata.id | string | read-only | Link to Collection of Endpoint. See the Endpoint schema for details. |
| } | |||
| FabricType | string (enum) |
read-only (null) |
The protocol being sent over this
fabric.
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| } | |||
| MaxZones | integer | read-only (null) |
The maximum number of zones the switch can
currently configure.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| Switches { | object | The collection of links to the switches
that this fabric contains.
|
|
| @odata.id | string | read-only | Link to Collection of Switch. See the Switch schema for details. |
| } | |||
| UUID (v1.3+) | string (uuid) |
read-write (null) |
The UUID for this fabric.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ |
| Zones { | object | The collection of links to the zones that
this fabric contains.
|
|
| @odata.id | string | read-only | Link to Collection of Zone. See the Zone schema for details. |
| } |
6.45.4 Property details
6.45.4.1 FabricType
The protocol being sent over this fabric.
- This property shall contain the type of fabric being represented by this simple fabric.
| string | Description |
|---|---|
| AHCI | Advanced Host Controller Interface
(AHCI).
|
| CXL | Compute Express Link.
|
| 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.
|
| QPI | Intel QuickPath Interconnect
(QPI).
|
| 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).
|
| UPI | Intel UltraPath Interconnect
(UPI).
|
| USB | Universal Serial Bus (USB).
|
| VGA | VGA.
|
6.45.5 Example response
{
"@odata.type": "#Fabric.v1_3_0.Fabric",
"Id": "SAS",
"Name": "SAS Fabric",
"FabricType": "SAS",
"Description": "A SAS Fabric with redundant switches connected to two initiators",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Zones": {
"@odata.id": "/redfish/v1/Fabrics/SAS/Zones"
},
"Endpoints": {
"@odata.id": "/redfish/v1/Fabrics/SAS/Endpoints"
},
"Switches": {
"@odata.id": "/redfish/v1/Fabrics/SAS/Switches"
},
"@odata.id": "/redfish/v1/Fabrics/SAS"
}6.46 FabricAdapter 1.5.1
| Version | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2022.3 | 2022.2 | 2022.1 | 2021.3 | 2021.2 | 2019.4 |
6.46.1 Description
A fabric adapter represents the physical fabric adapter capable of connecting to an interconnect fabric. Examples include, but are not limited to, Ethernet, NVMe over Fabrics, Gen-Z, and SAS fabric adapters.
- This resource shall represent a physical fabric adapter capable of connecting to an interconnect fabric.
6.46.2 URIs
/redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}
/redfish/v1/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}
6.46.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| ASICManufacturer | string | read-only (null) |
The manufacturer name for the ASIC of this
fabric adapter.
|
| ASICPartNumber | string | read-only (null) |
The part number for the ASIC on this
fabric adapter.
|
| ASICRevisionIdentifier | string | read-only (null) |
The revision identifier for the ASIC on
this fabric adapter.
|
| FabricType (v1.3+) | string (enum) |
read-write | The configured fabric type of this fabric
adapter.
|
| FabricTypeCapabilities (v1.3+) [ ] | array (string (enum)) |
read-only |
|
| FirmwareVersion | string | read-only (null) |
The firmware version of this fabric
adapter.
|
| GenZ { | object | The Gen-Z specific properties for this
fabric adapter.
|
|
| MSDT { | object | The Multi Subnet Destination Table for the
component.
|
|
| @odata.id | string | read-only | Link to Collection of RouteEntry. See the RouteEntry schema for details. |
| } | |||
| PIDT [ ] | array (string, null) | read-write | An array of table entry values for the
Packet Injection Delay Table.
|
| RequestorVCAT { | object | The Requestor Virtual Channel Action Table
for the component.
|
|
| @odata.id | string | read-only | Link to Collection of VCATEntry. See the VCATEntry schema for details. |
| } | |||
| ResponderVCAT { | object | The Responder Virtual Channel Action Table
for the component.
|
|
| @odata.id | string | read-only | Link to Collection of VCATEntry. See the VCATEntry schema for details. |
| } | |||
| RITable [ ] | array (string, null) | read-write | An array of table entry values for the
Responder Interface Table.
|
| SSDT { | object | The Single Subnet Destination Table for
the component.
|
|
| @odata.id | string | read-only | Link to Collection of RouteEntry. See the RouteEntry schema for details. |
| } | |||
| } | |||
| Links { | object | The links to other resources that are
related to this resource.
|
|
| Endpoints [ { | array | An array of links to the endpoints that
represent the logical fabric connection to this fabric
adapter.
|
|
| @odata.id | string | read-only | Link to a Endpoint resource. See the Links section and the Endpoint schema for details. |
| } ] | |||
| MemoryDomains (v1.3+) [ { | array | An array of links to the memory domains
associated with this fabric adapter.
|
|
| @odata.id | string | read-write | Link to a MemoryDomain resource. See the Links section and the MemoryDomain schema for details. |
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| PCIeDevices (v1.2+) [ { | array | An array of links to the PCIe devices
associated with this fabric adapter.
|
|
| @odata.id | string | read-only | Link to a PCIeDevice resource. See the Links section and the PCIeDevice schema for details. |
| } ] | |||
| Processors (v1.5+) [ { | array | An array of links to the processors that
this fabric adapter provides to a fabric.
|
|
| @odata.id | string | read-only | Link to a Processor resource. See the Links section and the Processor schema for details. |
| } ] | |||
| } | |||
| Location (v1.1+) {} | object | The location of the fabric
adapter.
|
|
| LocationIndicatorActive (v1.4+) | boolean | read-write (null) |
An indicator allowing an operator to
physically locate this resource.
|
| Manufacturer | string | read-only (null) |
The manufacturer or OEM of this fabric
adapter.
|
| Model | string | read-only (null) |
The model string for this fabric
adapter.
|
| PartNumber | string | read-only (null) |
The part number for this fabric
adapter.
|
| PCIeInterface { | object | The PCIe interface details for this fabric
adapter.
|
|
| LanesInUse (v1.3+) | integer | read-only (null) |
The number of PCIe lanes in use by this
device.
|
| MaxLanes (v1.3+) | integer | read-only (null) |
The number of PCIe lanes supported by this
device.
|
| MaxPCIeType (v1.3+) | string (enum) |
read-only (null) |
The highest version of the PCIe
specification supported by this device.
|
| Oem (v1.3+) {} | object | See the OEM object definition in the Using this guide clause. | |
| PCIeType (v1.3+) | string (enum) |
read-only (null) |
The version of the PCIe specification in
use by this device.
|
| } | |||
| Ports { | object | The link to the collection of ports that
exist on the fabric adapter.
|
|
| @odata.id | string | read-only | Link to Collection of Port. See the Port schema for details. |
| } | |||
| SerialNumber | string | read-only (null) |
The serial number for this fabric
adapter.
|
| SKU | string | read-only (null) |
The manufacturer SKU for this fabric
adapter.
|
| SparePartNumber | string | read-only (null) |
The spare part number for this fabric
adapter.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| UUID | string (uuid) |
read-only (null) |
The UUID for this fabric
adapter.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ |
6.46.4 Property details
6.46.4.1 FabricType
The configured fabric type of this fabric adapter.
- This property shall contain the configured fabric type of this fabric adapter.
| string | Description |
|---|---|
| AHCI | Advanced Host Controller Interface
(AHCI).
|
| CXL | Compute Express Link.
|
| 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.
|
| QPI | Intel QuickPath Interconnect
(QPI).
|
| 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).
|
| UPI | Intel UltraPath Interconnect
(UPI).
|
| USB | Universal Serial Bus (USB).
|
| VGA | VGA.
|
6.46.4.2 FabricTypeCapabilities
- An array of fabric types supported by this fabric adapter.
- This property shall contain an array of fabric types supported by this fabric adapter.
| string | Description |
|---|---|
| AHCI | Advanced Host Controller Interface
(AHCI).
|
| CXL | Compute Express Link.
|
| 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.
|
| QPI | Intel QuickPath Interconnect
(QPI).
|
| 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).
|
| UPI | Intel UltraPath Interconnect
(UPI).
|
| USB | Universal Serial Bus (USB).
|
| VGA | VGA.
|
6.46.4.3 MaxPCIeType
The highest version of the PCIe specification supported by this device.
- This property shall contain the maximum PCIe specification that this device supports.
| string | Description |
|---|---|
| Gen1 | A PCIe v1.0 slot. |
| Gen2 | A PCIe v2.0 slot. |
| Gen3 | A PCIe v3.0 slot. |
| Gen4 | A PCIe v4.0 slot. |
| Gen5 | A PCIe v5.0 slot. |
6.46.4.4 PCIeType
The version of the PCIe specification in use by this device.
- This property shall contain the negotiated PCIe interface version in use by this device.
| string | Description |
|---|---|
| Gen1 | A PCIe v1.0 slot. |
| Gen2 | A PCIe v2.0 slot. |
| Gen3 | A PCIe v3.0 slot. |
| Gen4 | A PCIe v4.0 slot. |
| Gen5 | A PCIe v5.0 slot. |
6.46.5 Example response
{
"@odata.type": "#FabricAdapter.v1_5_1.FabricAdapter",
"Id": "Bridge",
"Name": "Gen-Z Bridge",
"Manufacturer": "Contoso",
"Model": "Gen-Z Bridge Model X",
"PartNumber": "975999-001",
"SparePartNumber": "152111-A01",
"SKU": "Contoso 2-port Gen-Z Bridge",
"SerialNumber": "2M220100SL",
"ASICRevisionIdentifier": "A0",
"ASICPartNumber": "53312",
"ASICManufacturer": "Contoso",
"FirmwareVersion": "7.4.10",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Ports": {
"@odata.id": "/redfish/v1/Systems/GenZ-example/FabricAdapters/1/Ports"
},
"PCIeInterface": {
"MaxPCIeType": "Gen4",
"MaxLanes": 64,
"PCIeType": "Gen4",
"LanesInUse": 64
},
"UUID": "45724775-ed3b-2214-1313-9865200c1cc1",
"Links": {
"Endpoints": [
{
"@odata.id": "/redfish/v1/Fabrics/GenZ/Endpoints/3"
}
]
},
"GenZ": {
"SSDT": {
"@odata.id": "/redfish/v1/Systems/GenZ-example/FabricAdapters/1/SSDT"
},
"MSDT": {
"@odata.id": "/redfish/v1/Systems/GenZ-example/FabricAdapters/1/MSDT"
},
"RequestorVCAT": {
"@odata.id": "/redfish/v1/Systems/GenZ-example/FabricAdapters/1/REQ-VCAT"
},
"ResponderVCAT": {
"@odata.id": "/redfish/v1/Systems/GenZ-example/FabricAdapters/1/RSP-VCAT"
},
"RITable": [
"0x12",
"0x3E",
"0x12",
"0x3E",
"0x12",
"0x3E",
"0x12",
"0x3E",
"0x12",
"0x3E",
"0x12",
"0x3E",
"0x12",
"0x3E",
"0x12",
"0x3E"
],
"PIDT": [
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568",
"0x12234568"
]
},
"@odata.id": "/redfish/v1/Systems/GenZ-example/FabricAdapters/1"
}6.47 Facility 1.4.0
| Version | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2023.1 | 2021.3 | 2021.2 | 2020.4 | 2019.4 |
6.47.1 Description
The Facility schema represents the physical location containing equipment, such as a room, building, or campus.
- This resource shall be used to represent a location containing equipment, such as a room, building, or campus, for a Redfish implementation.
6.47.2 URIs
/redfish/v1/Facilities/{FacilityId}
6.47.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AmbientMetrics (v1.1+) { | object | The link to the ambient environment
metrics for this facility.
|
|
| @odata.id | string | read-only | Link to a EnvironmentMetrics resource. See the Links section and the EnvironmentMetrics schema for details. |
| } | |||
| EnvironmentMetrics (v1.1+) { | object | The link to the environment metrics for
this facility.
|
|
| @odata.id | string | read-only | Link to a EnvironmentMetrics resource. See the Links section and the EnvironmentMetrics schema for details. |
| } | |||
| FacilityType | string (enum) |
read-only required | The type of location this resource
represents.
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| CDUs (v1.4+) [ { | array | An array of links to the cooling
distribution units in this facility.
|
|
| @odata.id | string | read-write | Link to a CoolingUnit resource. See the Links section and the CoolingUnit schema for details. |
| } ] | |||
| ContainedByFacility { | object | The link to the facility that contains
this facility.
|
|
| @odata.id | string | read-write | Link to another Facility resource. |
| } | |||
| ContainsChassis [ { | array | An array of links to outermost chassis
contained within this facility.
|
|
| @odata.id | string | read-write | Link to a Chassis resource. See the Links section and the Chassis schema for details. |
| } ] | |||
| ContainsFacilities [ { | array | An array of links to other facilities
contained within this facility.
|
|
| @odata.id | string | read-write | Link to another Facility resource. |
| } ] | |||
| CoolingLoops (v1.4+) [ { | array | An array of links to the cooling loops in
this facility.
|
|
| @odata.id | string | read-write | Link to a CoolingLoop resource. See the Links section and the CoolingLoop schema for details. |
| } ] | |||
| ElectricalBuses (v1.3+) [ { | array | An array of links to the electrical buses
in this facility.
|
|
| @odata.id | string | read-write | Link to a PowerDistribution resource. See the Links section and the PowerDistribution schema for details. |
| } ] | |||
| FloorPDUs [ { | array | An array of links to the floor power
distribution units in this facility.
|
|
| @odata.id | string | read-write | Link to a PowerDistribution resource. See the Links section and the PowerDistribution schema for details. |
| } ] | |||
| ImmersionUnits (v1.4+) [ { | array | An array of links to the immersion cooling
units in this facility.
|
|
| @odata.id | string | read-write | Link to a CoolingUnit resource. See the Links section and the CoolingUnit schema for details. |
| } ] | |||
| ManagedBy [ { | array | An array of links to the managers
responsible for managing this facility.
|
|
| @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 Using this guide clause. | |
| PowerShelves (v1.2+) [ { | array | An array of links to the power shelves in
this facility.
|
|
| @odata.id | string | read-write | Link to a PowerDistribution resource. See the Links section and the PowerDistribution schema for details. |
| } ] | |||
| RackPDUs [ { | array | An array of links to the rack-level power
distribution units in this facility.
|
|
| @odata.id | string | read-write | Link to a PowerDistribution resource. See the Links section and the PowerDistribution schema for details. |
| } ] | |||
| Switchgear [ { | array | An array of links to the switchgear in
this facility.
|
|
| @odata.id | string | read-write | Link to a PowerDistribution resource. See the Links section and the PowerDistribution schema for details. |
| } ] | |||
| TransferSwitches [ { | array | An array of links to the transfer switches
in this facility.
|
|
| @odata.id | string | read-write | Link to a PowerDistribution resource. See the Links section and the PowerDistribution schema for details. |
| } ] | |||
| } | |||
| Location {} | object | The location of the facility.
|
|
| PowerDomains { | object | Link to the power domains in this
facility.
|
|
| @odata.id | string | read-only | Link to Collection of PowerDomain. See the PowerDomain schema for details. |
| } | |||
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
6.47.4 Property details
6.47.4.1 FacilityType
The type of location this resource represents.
- This property shall contain the type of location this resource represents.
| string | Description |
|---|---|
| Building | A structure with a roof and walls. |
| Floor | A floor inside of a building. |
| Room | A room inside of a building or floor. |
| Site | A small area consisting of several buildings. |
6.47.5 Example response
{
"@odata.type": "#Facility.v1_4_0.Facility",
"Id": "Room237",
"Name": "Room #237, 2nd Floor",
"FacilityType": "Room",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Location": {
"PostalAddress": {
"Country": "US",
"Territory": "OR",
"City": "Portland",
"Street": "1001 SW 5th Avenue",
"HouseNumber": 1100,
"Name": "DMTF, Inc.",
"PostalCode": "97204",
"Floor": "2",
"Room": "237"
}
},
"PowerDomains": {
"@odata.id": "/redfish/v1/Facilities/Room237/PowerDomains"
},
"Links": {
"ContainedByFacility": {
"@odata.id": "/redfish/v1/Facilities/Building"
},
"RackPDUs": [
{
"@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1"
}
]
},
"@odata.id": "/redfish/v1/Facilities/Room237"
}6.48 Fan 1.5.0
| Version | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2023.2 | 2023.1 | 2022.2 | 2022.1 | 2021.1 | 2020.4 |
6.48.1 Description
The Fan schema describes a cooling fan unit for a computer system or similar devices contained within a chassis. It also describes the location, such as a slot, socket, or bay, where a unit can be installed, by populating a resource instance with an absent state if a unit is not present.
- This resource shall represent a cooling fan for a
Redfish implementation. It may also represent a location, such as a
slot, socket, or bay, where a unit may be installed, but the State
property within the Status property contains
Absent.
6.48.2 URIs
/redfish/v1/Chassis/{ChassisId}/ThermalSubsystem/Fans/{FanId}
6.48.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Assembly { | object | The link to the assembly associated with
this fan.
|
|
| @odata.id | string | read-only | Link to a Assembly resource. See the Links section and the Assembly schema for details. |
| } | |||
| FanDiameterMm (v1.4+) | integer (mm) |
read-only (null) |
The diameter of the fan assembly in
millimeters.
|
| HotPluggable | boolean | read-only (null) |
An indication of whether this device can
be inserted or removed while the equipment is in operation.
|
| Links (v1.2+) { | object | The links to other resources that are
related to this resource.
|
|
| CoolingChassis (v1.2+) [ { | array | An array of links to the chassis that are
directly cooled by this fan.
|
|
| @odata.id | string | read-only | Link to a Chassis resource. See the Links section and the Chassis schema for details. |
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| } | |||
| Location {} | object | The location of the fan.
|
|
| LocationIndicatorActive | boolean | read-write (null) |
An indicator allowing an operator to
physically locate this resource.
|
| Manufacturer | string | read-only (null) |
The manufacturer of this fan.
|
| Model | string | read-only (null) |
The model number for this fan.
|
| PartNumber | string | read-only (null) |
The part number for this fan.
|
| PhysicalContext | string (enum) |
read-only | The area or device associated with this
fan.
|
| PowerWatts (v1.1+) { | object (excerpt) |
Power consumption (W).
|
|
| ApparentVA | number (V.A) |
read-only (null) |
The product of voltage and current for an
AC circuit, in volt-ampere units.
|
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| PhaseAngleDegrees (v1.5+) | number | read-only (null) |
The phase angle (degrees) between the
current and voltage waveforms.
|
| PowerFactor | number | read-only (null) |
The power factor for this
sensor.
|
| ReactiveVAR | number (V.A) |
read-only (null) |
The square root of the difference term of
squared apparent VA and squared power (Reading) for a circuit, in VAR
units.
|
| Reading | number | read-only (null) |
The sensor value.
|
| } | |||
| Replaceable (v1.3+) | boolean | read-only (null) |
An indication of whether this component
can be independently replaced as allowed by the vendor's replacement
policy.
|
| SecondarySpeedPercent (v1.5+) { | object (excerpt) |
The fan speed (percent) of the second
rotor in a multi-rotor fan.
|
|
| 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.
|
| SpeedRPM (v1.2+) | number ({rev}/min) |
read-only (null) |
The rotational speed.
|
| } | |||
| SerialNumber | string | read-only (null) |
The serial number for this
fan.
|
| SparePartNumber | string | read-only (null) |
The spare part number for this
fan.
|
| SpeedPercent { | object (excerpt) |
The fan speed (percent).
|
|
| 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.
|
| SpeedRPM (v1.2+) | number ({rev}/min) |
read-only (null) |
The rotational speed.
|
| } | |||
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
6.48.4 Property details
6.48.4.1 PhysicalContext
The area or device associated with this fan.
- This property shall contain a description of the affected device or region within the chassis with which this fan is associated.
| string | Description |
|---|---|
| Accelerator | An accelerator. |
| ACInput | An AC input. |
| ACMaintenanceBypassInput | An AC maintenance bypass input. |
| ACOutput | An AC output. |
| ACStaticBypassInput | An AC static bypass input. |
| ACUtilityInput | An AC utility input. |
| ASIC | An ASIC device, such as a networking chip or chipset component. |
| Back | The back of the chassis. |
| Backplane | A backplane within the chassis. |
| Battery | A battery. |
| Board | A circuit board.
|
| Chassis | The entire chassis. |
| ComputeBay | Within a compute bay. |
| CoolingSubsystem | The entire cooling, or air and liquid, subsystem. |
| CPU | A processor (CPU). |
| CPUSubsystem | The entire processor (CPU) subsystem. |
| DCBus | A DC bus. |
| Exhaust | The air exhaust point or points or region of the chassis. |
| ExpansionBay | Within an expansion bay. |
| Fan | A fan. |
| FPGA | An FPGA. |
| Front | The front of the chassis. |
| GPU | A graphics processor (GPU). |
| GPUSubsystem | The entire graphics processor (GPU) subsystem. |
| Intake | The air intake point or points or region of the chassis. |
| LiquidInlet | The liquid inlet point of the chassis. |
| LiquidOutlet | The liquid outlet point of the chassis. |
| Lower | The lower portion of the chassis. |
| Memory | A memory device. |
| MemorySubsystem | The entire memory subsystem. |
| Motor | A motor. |
| NetworkBay | Within a networking bay. |
| NetworkingDevice | A networking device. |
| PowerSubsystem | The entire power subsystem. |
| PowerSupply | A power supply. |
| PowerSupplyBay | Within a power supply bay. |
| Pump | A pump. |
| Rectifier | A rectifier device. |
| Room | The room. |
| StorageBay | Within a storage bay. |
| StorageDevice | A storage device. |
| SystemBoard | The system board (PCB). |
| Transceiver | A transceiver.
|
| Transformer | A transformer. |
| TrustedModule | A trusted module. |
| Upper | The upper portion of the chassis. |
| VoltageRegulator | A voltage regulator device. |
6.48.5 Example response
{
"@odata.type": "#Fan.v1_5_0.Fan",
"Id": "Bay1",
"Name": "Fan Bay 1",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"PhysicalContext": "Chassis",
"Model": "RKS-440DC",
"Manufacturer": "Contoso Fans",
"PartNumber": "23456-133",
"SparePartNumber": "93284-133",
"LocationIndicatorActive": true,
"HotPluggable": true,
"SpeedPercent": {
"Reading": 45,
"SpeedRPM": 2200,
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/FanBay1"
},
"Location": {
"PartLocation": {
"ServiceLabel": "Chassis Fan Bay 1",
"LocationType": "Bay",
"LocationOrdinalValue": 0
}
},
"@odata.id": "/redfish/v1/Chassis/1U/ThermalSubsystem/Fans/Bay1"
}6.49 Filter 1.0.0
| Version | v1.0 |
| Release | 2023.1 |
6.49.1 Description
The Filter schema describes a filter unit for a cooling system or similar device.
- This resource shall represent the management properties for monitoring and management of filters for a Redfish implementation.
6.49.2 URIs
/redfish/v1/Chassis/{ChassisId}/ThermalSubsystem/Pumps/{PumpId}/Filters/{FilterId}
/redfish/v1/ThermalEquipment/CDUs/{CoolingUnitId}/Filters/{FilterId}
/redfish/v1/ThermalEquipment/CDUs/{CoolingUnitId}/Pumps/{PumpId}/Filters/{FilterId}
/redfish/v1/ThermalEquipment/CDUs/{CoolingUnitId}/Reservoirs/{ReservoirId}/Filters/{FilterId}
/redfish/v1/ThermalEquipment/HeatExchangers/{CoolingUnitId}/Filters/{FilterId}
/redfish/v1/ThermalEquipment/HeatExchangers/{CoolingUnitId}/Pumps/{PumpId}/Filters/{FilterId}
/redfish/v1/ThermalEquipment/HeatExchangers/{CoolingUnitId}/Reservoirs/{ReservoirId}/Filters/{FilterId}
/redfish/v1/ThermalEquipment/ImmersionUnits/{CoolingUnitId}/Filters/{FilterId}
/redfish/v1/ThermalEquipment/ImmersionUnits/{CoolingUnitId}/Pumps/{PumpId}/Filters/{FilterId}
/redfish/v1/ThermalEquipment/ImmersionUnits/{CoolingUnitId}/Reservoirs/{ReservoirId}/Filters/{FilterId}
6.49.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Assembly { | object | The link to the assembly associated with
this filter.
|
|
| @odata.id | string | read-only | Link to a Assembly resource. See the Links section and the Assembly schema for details. |
| } | |||
| HotPluggable | boolean | read-only (null) |
An indication of whether this device can
be inserted or removed while the equipment is in operation.
|
| Location {} | object | The location of the filter.
|
|
| LocationIndicatorActive | boolean | read-write (null) |
An indicator allowing an operator to
physically locate this resource.
|
| Manufacturer | string | read-only (null) |
The manufacturer of this
filter.
|
| Model | string | read-only (null) |
The model number for this
filter.
|
| PartNumber | string | read-only (null) |
The part number for this
filter.
|
| PhysicalContext | string (enum) |
read-only | The area or device associated with this
filter.
|
| RatedServiceHours | number | read-only (null) |
The rated hours of service life for this
filter.
|
| Replaceable | boolean | read-only (null) |
An indication of whether this component
can be independently replaced as allowed by the vendor's replacement
policy.
|
| SerialNumber | string | read-only (null) |
The serial number for this
filter.
|
| ServicedDate | string (date-time) |
read-write (null) |
The date this filter was put into
service.
|
| ServiceHours | number | read-write (null) |
The hours of service this filter has
provided.
|
| SparePartNumber | string | read-only (null) |
The spare part number for this
filter.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| UserLabel | string | read-write | A user-assigned label.
|
6.49.4 Property details
6.49.4.1 PhysicalContext
The area or device associated with this filter.
- This property shall contain a description of the affected device or region within the chassis with which this filter is associated.
| string | Description |
|---|---|
| Accelerator | An accelerator. |
| ACInput | An AC input. |
| ACMaintenanceBypassInput | An AC maintenance bypass input. |
| ACOutput | An AC output. |
| ACStaticBypassInput | An AC static bypass input. |
| ACUtilityInput | An AC utility input. |
| ASIC | An ASIC device, such as a networking chip or chipset component. |
| Back | The back of the chassis. |
| Backplane | A backplane within the chassis. |
| Battery | A battery. |
| Board | A circuit board.
|
| Chassis | The entire chassis. |
| ComputeBay | Within a compute bay. |
| CoolingSubsystem | The entire cooling, or air and liquid, subsystem. |
| CPU | A processor (CPU). |
| CPUSubsystem | The entire processor (CPU) subsystem. |
| DCBus | A DC bus. |
| Exhaust | The air exhaust point or points or region of the chassis. |
| ExpansionBay | Within an expansion bay. |
| Fan | A fan. |
| FPGA | An FPGA. |
| Front | The front of the chassis. |
| GPU | A graphics processor (GPU). |
| GPUSubsystem | The entire graphics processor (GPU) subsystem. |
| Intake | The air intake point or points or region of the chassis. |
| LiquidInlet | The liquid inlet point of the chassis. |
| LiquidOutlet | The liquid outlet point of the chassis. |
| Lower | The lower portion of the chassis. |
| Memory | A memory device. |
| MemorySubsystem | The entire memory subsystem. |
| Motor | A motor. |
| NetworkBay | Within a networking bay. |
| NetworkingDevice | A networking device. |
| PowerSubsystem | The entire power subsystem. |
| PowerSupply | A power supply. |
| PowerSupplyBay | Within a power supply bay. |
| Pump | A pump. |
| Rectifier | A rectifier device. |
| Room | The room. |
| StorageBay | Within a storage bay. |
| StorageDevice | A storage device. |
| SystemBoard | The system board (PCB). |
| Transceiver | A transceiver.
|
| Transformer | A transformer. |
| TrustedModule | A trusted module. |
| Upper | The upper portion of the chassis. |
| VoltageRegulator | A voltage regulator device. |
6.49.5 Example response
{
"@odata.type": "#Filter.v1_0_0.Filter",
"Id": "1",
"Name": "Cooling Loop Filter",
"ServicedDate": "2020-12-24T08:00:00Z",
"ServiceHours": 5791,
"RatedServiceHours": 10000,
"Manufacturer": "Contoso",
"Model": "MyCoffee",
"PartNumber": "Cone4",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Location": {
"Placement": {
"Row": "North 1"
}
},
"@odata.id": "/redfish/v1/ThermalEquipment/CDUs/1/Filters/1"
}6.50 GraphicsController 1.0.0
| Version | v1.0 |
| Release | 2021.1 |
6.50.1 Description
The GraphicsController schema defines a graphics controller that can be used to drive one or more display devices.
- This resource shall represent a graphics output device in a Redfish implementation.
6.50.2 URIs
/redfish/v1/Systems/{ComputerSystemId}/GraphicsControllers/{ControllerId}
6.50.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AssetTag | string | read-write (null) |
The user-assigned asset tag for this
graphics controller.
|
| BiosVersion | string | read-only (null) |
The version of the graphics controller
BIOS or primary graphics controller firmware.
|
| DriverVersion | string | read-only (null) |
The version of the graphics controller
driver loaded in the operating system.
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| PCIeDevice { | object | (null) |
A link to the PCIe device that represents
this graphics controller.
|
| @odata.id | string | read-only | Link to a PCIeDevice resource. See the Links section and the PCIeDevice schema for details. |
| } | |||
| Processors [ { | array | An array of links to the processors that
are a part of this graphics controller.
|
|
| @odata.id | string | read-only | Link to a Processor resource. See the Links section and the Processor schema for details. |
| } ] | |||
| } | |||
| Location {} | object | The location of the graphics
controller.
|
|
| Manufacturer | string | read-only (null) |
The manufacturer of this graphics
controller.
|
| Model | string | read-only (null) |
The product model number of this graphics
controller.
|
| PartNumber | string | read-only (null) |
The part number for this graphics
controller.
|
| Ports { | object | The ports of the graphics
controller.
|
|
| @odata.id | string | read-only | Link to Collection of Port. See the Port schema for details. |
| } | |||
| SerialNumber | string | read-only (null) |
The serial number for this graphics
controller.
|
| SKU | string | read-only (null) |
The SKU for this graphics
controller.
|
| SparePartNumber | string | read-only (null) |
The spare part number of the graphics
controller.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
6.50.4 Example response
{
"@odata.type": "#GraphicsController.v1_0_0.GraphicsController",
"Id": "GPU1",
"Name": "Contoso Graphics Controller 1",
"AssetTag": "",
"Manufacturer": "Contoso",
"Model": "GPU1",
"SKU": "80937",
"SerialNumber": "2M220100SL",
"PartNumber": "G37891",
"SparePartNumber": "G37890",
"BiosVersion": "90.02.17.00.7D",
"DriverVersion": "27.21.14.6079 (Contoso 460.79) DCH / Win 10 64",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Location": {
"PartLocation": {
"ServiceLabel": "Slot 1",
"LocationOrdinalValue": 1,
"LocationType": "Slot",
"Orientation": "LeftToRight",
"Reference": "Rear"
}
},
"Ports": {
"@odata.id": "/redfish/v1/Systems/1/GraphicsControllers/GPU1/Ports"
},
"Links": {
"Processors": [
{
"@odata.id": "/redfish/v1/Systems/1/Processors/GPU"
}
]
},
"@odata.id": "/redfish/v1/Systems/1/GraphicsControllers/GPU1"
}6.51 Heater 1.0.0
| Version | v1.0 |
| Release | 2022.3 |
6.51.1 Description
The Heater schema describes a heating unit for devices contained within a chassis.
- This resource shall represent the management properties for monitoring and management of heaters for a Redfish implementation.
6.51.2 URIs
/redfish/v1/Chassis/{ChassisId}/ThermalSubsystem/Heaters/{HeaterId}
6.51.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Assembly { | object | The link to the assembly associated with
this heater.
|
|
| @odata.id | string | read-only | Link to a Assembly resource. See the Links section and the Assembly schema for details. |
| } | |||
| HotPluggable | boolean | read-only (null) |
An indication of whether this device can
be inserted or removed while the equipment is in operation.
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| Managers [ { | array | An array of links to the managers heated
by this heater.
|
|
| @odata.id | string | read-only | Link to a Manager resource. See the Links section and the Manager schema for details. |
| } ] | |||
| Memory [ { | array | An array of links to the memory devices
heated by this heater.
|
|
| @odata.id | string | read-only | Link to a Memory resource. See the Links section and the Memory schema for details. |
| } ] | |||
| NetworkAdapters [ { | array | An array of links to the network adapters
heated by this heater.
|
|
| @odata.id | string | read-only | Link to a NetworkAdapter resource. See the Links section and the NetworkAdapter schema for details. |
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| Processors [ { | array | An array of links to the processors heated
by this heater.
|
|
| @odata.id | string | read-only | Link to a Processor resource. See the Links section and the Processor schema for details. |
| } ] | |||
| StorageControllers [ { | array | An array of links to the storage
controllers heated by this heater.
|
|
| @odata.id | string | read-only | Link to a StorageController resource. See the Links section and the StorageController schema for details. |
| } ] | |||
| } | |||
| Location {} | object | The location of the heater.
|
|
| LocationIndicatorActive | boolean | read-write (null) |
An indicator allowing an operator to
physically locate this resource.
|
| Manufacturer | string | read-only (null) |
The manufacturer of this
heater.
|
| Metrics { | object | The link to the heater metrics resource
associated with this heater.
|
|
| @odata.id | string | read-only | Link to a HeaterMetrics resource. See the Links section and the HeaterMetrics schema for details. |
| } | |||
| Model | string | read-only (null) |
The model number for this
heater.
|
| PartNumber | string | read-only (null) |
The part number for this
heater.
|
| PhysicalContext | string (enum) |
read-only | The area or device associated with this
heater.
|
| SerialNumber | string | read-only (null) |
The serial number for this
heater.
|
| SparePartNumber | string | read-only (null) |
The spare part number for this
heater.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
6.51.4 Property details
6.51.4.1 PhysicalContext
The area or device associated with this heater.
- This property shall contain a description of the affected device or region within the chassis with which this heater is associated.
| string | Description |
|---|---|
| Accelerator | An accelerator. |
| ACInput | An AC input. |
| ACMaintenanceBypassInput | An AC maintenance bypass input. |
| ACOutput | An AC output. |
| ACStaticBypassInput | An AC static bypass input. |
| ACUtilityInput | An AC utility input. |
| ASIC | An ASIC device, such as a networking chip or chipset component. |
| Back | The back of the chassis. |
| Backplane | A backplane within the chassis. |
| Battery | A battery. |
| Board | A circuit board.
|
| Chassis | The entire chassis. |
| ComputeBay | Within a compute bay. |
| CoolingSubsystem | The entire cooling, or air and liquid, subsystem. |
| CPU | A processor (CPU). |
| CPUSubsystem | The entire processor (CPU) subsystem. |
| DCBus | A DC bus. |
| Exhaust | The air exhaust point or points or region of the chassis. |
| ExpansionBay | Within an expansion bay. |
| Fan | A fan. |
| FPGA | An FPGA. |
| Front | The front of the chassis. |
| GPU | A graphics processor (GPU). |
| GPUSubsystem | The entire graphics processor (GPU) subsystem. |
| Intake | The air intake point or points or region of the chassis. |
| LiquidInlet | The liquid inlet point of the chassis. |
| LiquidOutlet | The liquid outlet point of the chassis. |
| Lower | The lower portion of the chassis. |
| Memory | A memory device. |
| MemorySubsystem | The entire memory subsystem. |
| Motor | A motor. |
| NetworkBay | Within a networking bay. |
| NetworkingDevice | A networking device. |
| PowerSubsystem | The entire power subsystem. |
| PowerSupply | A power supply. |
| PowerSupplyBay | Within a power supply bay. |
| Pump | A pump. |
| Rectifier | A rectifier device. |
| Room | The room. |
| StorageBay | Within a storage bay. |
| StorageDevice | A storage device. |
| SystemBoard | The system board (PCB). |
| Transceiver | A transceiver.
|
| Transformer | A transformer. |
| TrustedModule | A trusted module. |
| Upper | The upper portion of the chassis. |
| VoltageRegulator | A voltage regulator device. |
6.51.5 Example response
{
"@odata.type": "#Heater.v1_0_0.Heater",
"Id": "CPU1Heater",
"Description": "Heater for CPU1",
"Name": "Heater 1",
"PhysicalContext": "CPU",
"Manufacturer": "Contoso Heaters",
"Model": "CPUHeater",
"SerialNumber": "SNDHM0123456789",
"PartNumber": "12345-123",
"SparePartNumber": "54321-321",
"LocationIndicatorActive": false,
"HotPluggable": true,
"Status": {
"Health": "OK",
"State": "Enabled"
},
"Links": {
"Processors": [
{
"@odata.id": "/redfish/v1/Systems/437XR1138R2/Processors/CPU1"
}
]
},
"Metrics": {
"@odata.id": "/redfish/v1/Chassis/1U/ThermalSubsystem/Heaters/CPU1Heater/Metrics"
},
"@odata.id": "/redfish/v1/Chassis/1U/ThermalSubsystem/Heaters/CPU1Heater"
}6.52 HeaterMetrics 1.0.0
| Version | v1.0 |
| Release | 2022.3 |
6.52.1 Description
The HeaterMetrics schema contains definitions for the metrics of a heater.
- This resource shall be used to represent the metrics of a heater unit for a Redfish implementation.
6.52.2 URIs
/redfish/v1/Chassis/{ChassisId}/ThermalSubsystem/Heaters/{HeaderId}/Metrics
6.52.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| PowerWatts { | object (excerpt) |
Power consumption (W).
|
|
| ApparentVA | number (V.A) |
read-only (null) |
The product of voltage and current for an
AC circuit, in volt-ampere units.
|
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| PhaseAngleDegrees (v1.5+) | number | read-only (null) |
The phase angle (degrees) between the
current and voltage waveforms.
|
| PowerFactor | number | read-only (null) |
The power factor for this
sensor.
|
| ReactiveVAR | number (V.A) |
read-only (null) |
The square root of the difference term of
squared apparent VA and squared power (Reading) for a circuit, in VAR
units.
|
| Reading | number | read-only (null) |
The sensor value.
|
| } | |||
| PrePowerOnHeatingTimeSeconds | integer | read-only (null) |
The total number of seconds the heater was
active while the device it heats was powered off.
|
| RuntimeHeatingTimeSeconds | integer | read-only (null) |
The total number of seconds the heater was
active while the device it heats was powered on.
|
| TemperatureReadingsCelsius [ { | array (excerpt) |
The temperatures (Celsius) from all
related sensors for this device.
|
|
| 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.
|
| PhysicalSubContext | string (enum) |
read-only (null) |
The usage or location within a device to
which this sensor measurement applies.
|
| Reading | number | read-only (null) |
The sensor value.
|
| } ] |
6.52.4 Actions
6.52.4.1 ResetMetrics
Description
This action resets the summary metrics related to this equipment.
- This action shall reset any time intervals or counted values for this equipment.
Action URI
{Base URI of target resource}/Actions/HeaterMetrics.ResetMetrics
Action parameters
This action takes no parameters.
6.52.5 Property details
6.52.5.1 PhysicalContext
The area or device to which this sensor measurement applies.
- This property shall contain a description of the affected component or region within the equipment 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. |
| Battery | A battery. |
| Board | A circuit board.
|
| Chassis | The entire chassis. |
| ComputeBay | Within a compute bay. |
| CoolingSubsystem | The entire cooling, or air and liquid, subsystem. |
| CPU | A processor (CPU). |
| CPUSubsystem | The entire processor (CPU) subsystem. |
| DCBus | A DC bus. |
| Exhaust | The air exhaust point or points or region of the chassis. |
| ExpansionBay | Within an expansion bay. |
| Fan | A fan. |
| FPGA | An FPGA. |
| Front | The front of the chassis. |
| GPU | A graphics processor (GPU). |
| GPUSubsystem | The entire graphics processor (GPU) subsystem. |
| Intake | The air intake point or points or region of the chassis. |
| LiquidInlet | The liquid inlet point of the chassis. |
| LiquidOutlet | The liquid outlet point of the chassis. |
| Lower | The lower portion of the chassis. |
| Memory | A memory device. |
| MemorySubsystem | The entire memory subsystem. |
| Motor | A motor. |
| NetworkBay | Within a networking bay. |
| NetworkingDevice | A networking device. |
| PowerSubsystem | The entire power subsystem. |
| PowerSupply | A power supply. |
| PowerSupplyBay | Within a power supply bay. |
| Pump | A pump. |
| Rectifier | A rectifier device. |
| Room | The room. |
| StorageBay | Within a storage bay. |
| StorageDevice | A storage device. |
| SystemBoard | The system board (PCB). |
| Transceiver | A transceiver.
|
| Transformer | A transformer. |
| TrustedModule | A trusted module. |
| Upper | The upper portion of the chassis. |
| VoltageRegulator | A voltage regulator device. |
6.52.5.2 PhysicalSubContext
The usage or location within a device to which this sensor measurement applies.
- This property shall contain a description of the usage or sub-region within the equipment to which this sensor measurement applies. This property generally differentiates multiple sensors within the same PhysicalContext instance.
| string | Description |
|---|---|
| Input | The input. |
| Output | The output. |
6.52.6 Example response
{
"@odata.type": "#HeaterMetrics.v1_0_0.HeaterMetrics",
"Id": "HeaterMetrics",
"Description": "Heater Metrics for CPU1 Heater",
"Name": "CPU1 Heater Metrics",
"PrePowerOnHeatingTimeSeconds": 600,
"RuntimeHeatingTimeSeconds": 3600,
"PowerWatts": {
"Reading": 200.3
},
"TemperatureReadingsCelsius": [
{
"DeviceName": "Heater Average Temperature",
"Reading": 2.5
}
],
"Actions": {
"#HeaterMetrics.ResetMetrics": {
"target": "/redfish/v1/Chassis/1U/ThermalSubsystem/Heaters/CPU1Heater/Metrics/HeaterMetrics.ResetMetrics"
}
},
"@odata.id": "/redfish/v1/Chassis/1U/ThermalSubsystem/Heaters/CPU1Heater/Metrics"
}6.53 HostInterface 1.3.0
| Version | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2020.3 | 2018.2 | 2017.1 | 2016.3 |
6.53.1 Description
The properties associated with a Host Interface. A Host Interface is a connection between host software and a Redfish Service.
- This Resource shall represent a Host Interface as part of the Redfish Specification.
6.53.2 URIs
/redfish/v1/Managers/{ManagerId}/HostInterfaces/{HostInterfaceId}
6.53.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AuthenticationModes [ ] | array (string (enum)) |
read-write |
|
| AuthNoneRoleId (v1.2+) | string | read-write | The role when no authentication on this
interface is used.
|
| CredentialBootstrapping (v1.3+) { | object | The credential bootstrapping settings for
this interface.
|
|
| EnableAfterReset (v1.3+) | boolean | read-write (null) |
An indication of whether credential
bootstrapping is enabled after a reset for this interface.
|
| Enabled (v1.3+) | boolean | read-write (null) |
An indication of whether credential
bootstrapping is enabled for this interface.
|
| RoleId (v1.3+) | string | read-write | The role used for the bootstrap account
created for this interface.
|
| } | |||
| ExternallyAccessible | boolean | read-only (null) |
An indication of whether external entities
can access this interface. External entities are non-host entities. For
example, if the host and manager are connected through a switch and the
switch also exposes an external port on the system, external clients can
also use the interface, and this property value is
true.
|
| FirmwareAuthEnabled (deprecated v1.3) | boolean | read-write (null) |
An indication of whether this firmware
authentication is enabled for this interface.
|
| FirmwareAuthRoleId (deprecated v1.3) | string | read-write | The Role used for firmware authentication
on this interface.
|
| HostEthernetInterfaces { | object | A link to the collection of network
interface controllers or cards (NICs) that a computer system uses to
communicate with this Host Interface.
|
|
| @odata.id | string | read-only | Link to Collection of EthernetInterface. See the EthernetInterface schema for details. |
| } | |||
| HostInterfaceType | string (enum) |
read-only (null) |
The Host Interface type for this
interface.
|
| InterfaceEnabled | boolean | read-write (null) |
An indication of whether this interface is
enabled.
|
| KernelAuthEnabled (deprecated v1.3) | boolean | read-write (null) |
An indication of whether this kernel
authentication is enabled for this interface.
|
| KernelAuthRoleId (deprecated v1.3) | string | read-write | The Role used for kernel authentication on
this interface.
|
| Links { | object | The links to other Resources that are
related to this Resource.
|
|
| AuthNoneRole (v1.2+) { | object | The link to the Redfish Role that contains
the privileges on this Host Interface when no authentication is
performed.
|
|
| @odata.id | string | read-only | Link to a Role resource. See the Links section and the Role schema for details. |
| } | |||
| ComputerSystems [ { | array | An array of links to the computer systems
connected to this Host Interface.
|
|
| @odata.id | string | read-only | Link to a ComputerSystem resource. See the Links section and the ComputerSystem schema for details. |
| } ] | |||
| CredentialBootstrappingRole (v1.3+) { | object | The link to the role that contains the
privileges for the bootstrap account created for this
interface.
|
|
| @odata.id | string | read-only | Link to a Role resource. See the Links section and the Role schema for details. |
| } | |||
| FirmwareAuthRole (deprecated v1.3) { | object | The link to the Redfish Role that has
firmware authentication privileges on this Host Interface.
|
|
| @odata.id | string | read-only | Link to a Role resource. See the Links section and the Role schema for details. |
| } | |||
| KernelAuthRole (deprecated v1.3) { | object | The link to the Redfish Role defining
privileges for this Host Interface when using kernel
authentication.
|
|
| @odata.id | string | read-only | Link to a Role resource. See the Links section and the Role schema for details. |
| } | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| } | |||
| ManagerEthernetInterface { | object | A link to a single network interface
controllers or cards (NIC) that this manager uses for network
communication with this Host Interface.
|
|
| @odata.id | string | read-only | Link to a EthernetInterface resource. See the Links section and the EthernetInterface schema for details. |
| } | |||
| NetworkProtocol { | object | A link to the network services and their
settings that the manager controls. In this property, clients find
configuration options for the network and network services.
|
|
| @odata.id | string | read-only | Link to a ManagerNetworkProtocol resource. See the Links section and the ManagerNetworkProtocol schema for details. |
| } | |||
| Status {} | object | The status and health of the Resource and
its subordinate or dependent Resources.
|
6.53.4 Property details
6.53.4.1 AuthenticationModes
- The authentication modes available on this interface.
- This property shall contain an array consisting of the authentication modes allowed on this interface.
| string | Description |
|---|---|
| AuthNone | Requests without any sort of authentication are allowed. |
| BasicAuth | Requests using HTTP Basic Authentication are allowed. |
| OemAuth | Requests using OEM authentication mechanisms are allowed. |
| RedfishSessionAuth | Requests using Redfish Session Authentication are allowed. |
6.53.4.2 HostInterfaceType
The Host Interface type for this interface.
- This property shall contain an enumeration that describes the type of the interface.
| string | Description |
|---|---|
| NetworkHostInterface | This interface is a Network Host Interface. |
6.53.5 Example response
{
"@odata.type": "#HostInterface.v1_3_0.HostInterface",
"Id": "1",
"Name": "Host Interface",
"Description": "Management Host Interface",
"HostInterfaceType": "NetworkHostInterface",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"InterfaceEnabled": true,
"ExternallyAccessible": false,
"AuthenticationModes": [
"AuthNone",
"BasicAuth",
"RedfishSessionAuth",
"OemAuth"
],
"CredentialBootstrapping": {
"EnableAfterReset": true,
"Enabled": true,
"RoleId": "User"
},
"HostEthernetInterfaces": {
"@odata.id": "/redfish/v1/Managers/BMC/HostInterfaces/1/HostEthernetInterfaces"
},
"ManagerEthernetInterface": {
"@odata.id": "/redfish/v1/Managers/BMC/EthernetInterfaces/ToHost"
},
"NetworkProtocol": {
"@odata.id": "/redfish/v1/Managers/BMC/NetworkProtocol"
},
"Links": {
"ComputerSystems": [
{
"@odata.id": "/redfish/v1/Systems/ORD144"
}
],
"CredentialBootstrappingRole": {
"@odata.id": "/redfish/v1/AccountService/Roles/User"
}
},
"@odata.id": "/redfish/v1/Managers/BMC/HostInterfaces/1"
}6.54 Job 1.2.2
| Version | v1.2 | v1.1 | v1.0 |
| Release | 2022.3 | 2022.1 | 2018.2 |
6.54.1 Description
The Job schema contains information about a job that a Redfish job service schedules or executes. Clients create jobs to describe a series of operations that occur at periodic intervals.
- This resource shall contain a job in a Redfish implementation.
6.54.2 URIs
/redfish/v1/JobService/Jobs/{JobId}
/redfish/v1/JobService/Jobs/{JobId}/Steps/{JobId2}
6.54.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| CreatedBy | string | read-only | The person or program that created this
job entry.
|
| EndTime | string (date-time) |
read-only | The date and time when the job was
completed.
|
| EstimatedDuration (v1.1+) | string (duration) |
read-only (null) |
The estimated total time required to
complete the job.
^P(\d+D)?(T(\d+H)?(\d+M)?(\d+(.\d+)?S)?)?$ |
| HidePayload | boolean | read-only | An indication of whether the contents of
the payload should be hidden from view after the job has been created.
If true, responses do not return the payload. If
false, responses return the payload. If this property is
not present when the job is created, the default is
false.
|
| JobState | string (enum) |
read-write | The state of the job.
|
| JobStatus | string (enum) |
read-only | The status of the job.
|
| Links (v1.2+) { | object | Contains references to other resources
that are related to this resource.
|
|
| CreatedResources (v1.2+) [ { | array | An array of URIs referencing the resources
created as the result of this job.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| } | |||
| MaxExecutionTime | string | read-write (null) |
The maximum amount of time the job is
allowed to execute.
|
| Messages [ { } ] | array (object) | The message that the Redfish service
returns.
|
|
| Payload { | object | The HTTP and JSON request payload details
for this job.
|
|
| HttpHeaders [ ] | array (string) | read-only | An array of HTTP headers in this
job.
|
| HttpOperation | string | read-only | The HTTP operation that executes this
job.
|
| JsonBody | string | read-only | The JSON payload to use in the execution
of this job.
|
| TargetUri | string (URI) |
read-only | The link to the target for this
job.
|
| } | |||
| PercentComplete | integer (%) |
read-only (null) |
The completion percentage of this
job.
|
| Schedule {} | object | The schedule settings for this
job.
|
|
| StartTime | string (date-time) |
read-only | The date and time when the job was started
or is scheduled to start.
|
| StepOrder [ ] | array (string) | read-only | The serialized execution order of the job
steps.
|
| Steps { | object | The link to a collection of steps for this
job.
|
|
| @odata.id | string | read-only | Link to Collection of Job. See the Job schema for details. |
| } |
6.54.4 Property details
6.54.4.1 JobState
The state of the job.
- This property shall indicate the state of the job.
| string | Description |
|---|---|
| Cancelled | Job was cancelled.
|
| Completed | Job was completed.
|
| Continue | Job is to resume operation.
|
| Exception | Job has stopped due to an exception
condition.
|
| Interrupted | Job has been interrupted.
|
| New | A new job.
|
| Pending | Job is pending and has not
started.
|
| Running | Job is running normally.
|
| Service | Job is running as a service.
|
| Starting | Job is starting.
|
| Stopping | Job is in the process of
stopping.
|
| Suspended | Job has been suspended.
|
| UserIntervention | Job is waiting for user
intervention.
|
6.54.4.2 JobStatus
The status of the job.
- This property shall indicate the health
status of the job. This property should contain
Criticalif one or more messages in the Messages array contains the severityCritical. This property should containWarningif one or more messages in the Messages array contains the severityWarningand no messages contain the severityCritical. This property should containOKif all messages in the Messages array contain the severityOKor the array is empty.
| string | Description |
|---|---|
| Critical | A critical condition requires immediate attention. |
| OK | Normal. |
| Warning | A condition requires attention. |
6.54.5 Example response
{
"@odata.type": "#Job.v1_2_2.Job",
"Id": "RebootRack",
"Name": "Scheduled Nightly Reboot of the rack",
"JobStatus": "OK",
"JobState": "Running",
"StartTime": "2018-04-01T00:01+6:00",
"PercentComplete": 24,
"Schedule": {
"Lifetime": "P4Y",
"InitialStartTime": "2018-01-01T01:00:00+06:00",
"RecurrenceInterval": "P1D",
"EnabledDaysOfWeek": [
"Monday",
"Tuesday",
"Wednesday",
"Thursday",
"Friday"
]
},
"Steps": {
"@odata.id": "/redfish/v1/JobService/Jobs/RebootRack/Steps"
},
"StepOrder": [
"Red",
"Orange",
"Yellow",
"Green",
"Blue",
"Indigo",
"Violet"
],
"@odata.id": "/redfish/v1/JobService/Jobs/RebootRack"
}6.55 JobService 1.0.4
| Version | v1.0 |
| Release | 2018.2 |
6.55.1 Description
The JobService schema contains properties for scheduling and execution of operations, represents the properties for the job service itself, and has links to jobs managed by the job service.
- This resource shall represent a job service for a Redfish implementation.
6.55.2 URIs
/redfish/v1/JobService
6.55.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| DateTime | string (date-time) |
read-only (null) |
The current date and time setting for the
job service.
|
| Jobs { | object | The links to the jobs
collection.
|
|
| @odata.id | string | read-only | Link to Collection of Job. See the Job schema for details. |
| } | |||
| Log { | object | The link to a log service that the job
service uses. This service can be a dedicated log service or a pointer a
log service under another resource, such as a manager.
|
|
| @odata.id | string | read-only | Link to a LogService resource. See the Links section and the LogService schema for details. |
| } | |||
| ServiceCapabilities { | object | The supported capabilities of this job
service implementation.
|
|
| MaxJobs | integer | read-only (null) |
The maximum number of jobs
supported.
|
| MaxSteps | integer | read-only (null) |
The maximum number of job steps
supported.
|
| Scheduling | boolean | read-only (null) |
An indication of whether scheduling of
jobs is supported.
|
| } | |||
| 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.
|
6.55.4 Example response
{
"@odata.type": "#JobService.v1_0_4.JobService",
"Id": "JobService",
"Name": "Job Service",
"DateTime": "2018-06-13T04:14+06:00",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"ServiceEnabled": true,
"ServiceCapabilities": {
"MaxJobs": 100,
"MaxSteps": 50,
"Scheduling": true
},
"Jobs": {
"@odata.id": "/redfish/v1/JobService/Jobs"
},
"Log": {
"@odata.id": "/redfish/v1/JobService/Log"
},
"Actions": {
"Oem": {
"#Contoso.EasyButton": {
"target": "/redfish/v1/JobService/Contoso.EasyButton",
"@Redfish.ActionInfo": "/redfish/v1/JobService/EasyButtonActionInfo"
}
}
},
"@odata.id": "/redfish/v1/JobService"
}6.56 JsonSchemaFile 1.1.4
| Version | v1.1 | v1.0 |
| Release | 2017.1 | 1.0 |
6.56.1 Description
The JsonSchemaFile schema contains the properties that describe the locations, as URIs, of a Redfish Schema definition that a Redfish Service implements or references.
- This Resource shall represent the schema file locator Resource for a Redfish implementation.
6.56.2 URIs
/redfish/v1/JsonSchemas/{JsonSchemaFileId}
6.56.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Languages [ ] | array (string) | read-only required | The RFC5646-conformant language codes for
the available schemas.
|
| Location [ { | array | required | Location information for this schema
file.
|
| ArchiveFile | string | read-only | The name of the file in the archive, if
the schema is hosted on the service in an archive file.
|
| ArchiveUri | string (URI) |
read-only | The link to an archive file, if the schema
is hosted on the service in an archive file.
|
| Language | string | read-only | The language code for the schema
file.
|
| PublicationUri | string (URI) |
read-only | The link to publicly available (canonical)
URI for schema.
|
| Uri | string (URI) |
read-only | The link to locally available URI for
schema.
|
| } ] | |||
| Schema | string | read-only required | The @odata.type name this schema
describes.
|
6.56.4 Example response
{
"@odata.type": "#JsonSchemaFile.v1_1_4.JsonSchemaFile",
"Id": "Chassis.v1_11_0",
"Name": "Chassis Schema File",
"Description": "Chassis Schema File Location",
"Languages": [
"en"
],
"Schema": "#Chassis.v1_11_0.Chassis",
"Location": [
{
"Language": "en",
"ArchiveUri": "/Schemas.gz",
"PublicationUri": "http://redfish.dmtf.org/schemas/v1/Chassis.v1_11_0.json",
"ArchiveFile": "Chassis.v1_11_0.json"
},
{
"Language": "zh",
"ArchiveUri": "/Schemas.zh.gz",
"PublicationUri": "http://schemas.contoso.com/Chassis.v1_11_0.zh.json",
"ArchiveFile": "Chassis.v1_11_0.zh.json"
},
{
"Language": "xy",
"Uri": "/redfish/v1/JsonSchemas/Chassis.v1_11_0.xy.json",
"PublicationUri": "http://schemas.contoso.com/Chassis.v1_11_0.xy.json"
}
],
"@odata.id": "/redfish/v1/JsonSchemas/Chassis.v1_11_0"
}6.57 Key 1.3.0
| Version | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2023.2 | 2022.3 | 2022.1 | 2021.2 |
6.57.1 Description
The Key schema describes sensitive data for accessing devices or services.
- This resource shall represent a key for a Redfish implementation.
6.57.2 URIs
/redfish/v1/AccountService/Accounts/{ManagerAccountId}/Keys/{KeyId}
/redfish/v1/AggregationService/AggregationSources/{AggregationSourceId}/PresentedPublicHostKey
/redfish/v1/AggregationService/AggregationSources/{AggregationSourceId}/PublicIdentityKey
/redfish/v1/AggregationService/AggregationSources/{AggregationSourceId}/TrustedPublicHostKeys/{KeyId}
/redfish/v1/KeyService/NVMeoFSecrets/{KeyId}
/redfish/v1/Managers/{ManagerId}/RemoteAccountService/Accounts/{ManagerAccountId}/Keys/{KeyId}
/redfish/v1/UpdateService/RemoteServerSSHKeys/{KeyId}
6.57.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| KeyString | string | read-only required on
create (null) |
The string for the key.
|
| KeyType | string (enum) |
read-only required on
create (null) |
The format of the key.
|
| NVMeoF { | object | (null) |
NVMe-oF specific properties.
|
| HostKeyId | string | read-write (null) |
The identifier of the host key paired with
this target key.
|
| NQN | string | read-only required on
create (null) |
The NVMe Qualified Name (NQN) of the host
or target subsystem associated with this key.
|
| OEMSecurityProtocolType | string | read-only (null) |
The OEM security protocol that this key
uses.
|
| SecureHashAllowList [ ] | array (string (enum)) |
read-only (null) |
The NVMe secure hash algorithms that a key
is allowed to use.
|
| SecurityProtocolType | string (enum) |
read-only (null) |
The security protocol that this key
uses.
|
| } | |||
| SSH (v1.2+) { | object | (null) |
SSH specific properties.
|
| Fingerprint (v1.2+) | string | read-only (null) |
A fingerprint of the key.
(^MD5(:[0-9a-f]{2})+$)|(^SHA256:[A-Za-z0-9+/=]+$) |
| RemoteServerHostName (v1.3+) | string | read-only (null) |
The host name of the remote server
associated with this key.
|
| } | |||
| UserDescription (v1.1+) | string | read-write (null) |
A user-defined string to describe this
key.
|
6.57.4 Property details
6.57.4.1 KeyType
The format of the key.
- This property shall contain the format type for the key.
| string | Description |
|---|---|
| NVMeoF | An NVMe-oF key.
|
| SSH (v1.1+) | An SSH public key.
|
6.57.4.2 SecureHashAllowList
The NVMe secure hash algorithms that a key is allowed to use.
- The secure hash algorithms allowed with the usage of this
key.
- This property shall contain the secure hash algorithms allowed with the usage of this key. An empty list or the absence of this property shall indicate any secure hash algorithms are allowed with this key.
| string | Description |
|---|---|
| SHA256 | SHA-256.
|
| SHA384 | SHA-384.
|
| SHA512 | SHA-512.
|
6.57.4.3 SecurityProtocolType
The security protocol that this key uses.
- This property shall contain the security protocol that this key uses. The value shall be derived from the contents of the KeyString property.
| string | Description |
|---|---|
| DHHC | Diffie-Hellman Hashed Message
Authentication Code Challenge Handshake Authentication Protocol
(DH-HMAC-CHAP).
|
| OEM | OEM.
|
| TLS_PSK | Transport Layer Security Pre-Shared Key
(TLS PSK).
|
6.57.5 Example response
{
"@odata.type": "#Key.v1_3_0.Key",
"Id": "0",
"Name": "NVMeoF key 0, target subsystem",
"KeyType": "NVMeoF",
"KeyString": "DHHC-1:00:ia6zGodOr4SEG0Zzaw398rpY0wqipUWj4jWjUh4HWUz6aQ2n:",
"NVMeoF": {
"NQN": "nqn.corp.com:nvme:target-subsystem-0001",
"SecurityProtocolType": "DHHC",
"HostKeyId": "1",
"SecureHashAllowList": [
"SHA384",
"SHA512"
]
},
"@odata.id": "/redfish/v1/KeyService/NVMeoFSecrets/0"
}6.58 KeyPolicy 1.0.0
| Version | v1.0 |
| Release | 2021.2 |
6.58.1 Description
The KeyPolicy schema describes settings for how keys are allowed to be used for accessing devices or services.
- This resource shall represent a key policy for a Redfish implementation.
6.58.2 URIs
/redfish/v1/KeyService/NVMeoFKeyPolicies/{KeyPolicyId}
6.58.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| IsDefault | boolean | read-write (null) |
Indicates if this is the default key
policy.
|
| KeyPolicyType | string (enum) |
read-only required on
create (null) |
The type of key policy.
|
| NVMeoF { | object | (null) |
NVMe-oF specific properties.
|
| CipherSuiteAllowList [ ] | array (string (enum)) |
read-write (null) |
The NVMe cipher suites that a key is
allowed to use.
|
| DHGroupAllowList [ ] | array (string (enum)) |
read-write (null) |
The NVMe Diffie-Hellman (DH) groups that a
key is allowed to use.
|
| OEMSecurityProtocolAllowList [ ] | array (string, null) | read-write | The OEM security protocols that this key
policy allows.
|
| SecureHashAllowList [ ] | array (string (enum)) |
read-write (null) |
The NVMe secure hash algorithms that a key
is allowed to use.
|
| SecurityProtocolAllowList [ ] | array (string (enum)) |
read-write (null) |
The NVMe security protocols that a key is
allowed to use.
|
| SecurityTransportAllowList [ ] | array (string (enum)) |
read-write (null) |
The NVMe security transports that a key is
allowed to use.
|
| } |
6.58.4 Property details
6.58.4.1 CipherSuiteAllowList
The NVMe cipher suites that a key is allowed to use.
- The
cipher suites that this key policy allows.
- This property shall contain the cipher suites that this key policy allows. The absence of the property shall indicate any cipher suite is allowed. An empty list shall indicate no cipher suites are allowed.
| string | Description |
|---|---|
| TLS_AES_128_GCM_SHA256 | TLS_AES_128_GCM_SHA256.
|
| TLS_AES_256_GCM_SHA384 | TLS_AES_256_GCM_SHA384.
|
6.58.4.2 DHGroupAllowList
The NVMe Diffie-Hellman (DH) groups that a key is allowed to use.
- The Diffie-Hellman (DH) groups that this key policy
allows.
- This property shall contain the Diffie-Hellman (DH) groups that this key policy allows. The absence of the property shall indicate any DH group is allowed. An empty list shall indicate no DH groups are allowed.
| string | Description |
|---|---|
| FFDHE2048 | 2048-bit Diffie-Hellman (DH)
group.
|
| FFDHE3072 | 3072-bit Diffie-Hellman (DH)
group.
|
| FFDHE4096 | 4096-bit Diffie-Hellman (DH)
group.
|
| FFDHE6144 | 6144-bit Diffie-Hellman (DH)
group.
|
| FFDHE8192 | 8192-bit Diffie-Hellman (DH)
group.
|
6.58.4.3 KeyPolicyType
The type of key policy.
- This property shall contain the type of key policy.
| string | Description |
|---|---|
| NVMeoF | An NVMe-oF key policy.
|
6.58.4.4 SecureHashAllowList
The NVMe secure hash algorithms that a key is allowed to use.
- The secure hash algorithms that this key policy
allows.
- This property shall contain the secure hash algorithms that this key policy allows. The absence of the property shall indicate any secure hash algorithm is allowed. An empty list shall indicate no secure hash algorithms are allowed.
| string | Description |
|---|---|
| SHA256 | SHA-256.
|
| SHA384 | SHA-384.
|
| SHA512 | SHA-512.
|
6.58.4.5 SecurityProtocolAllowList
The NVMe security protocols that a key is allowed to use.
- The
security protocols that this key policy allows.
- This property shall contain the security protocols that this key policy allows. NVMe-oF channels are restricted to security protocols in this list. The absence of the property shall indicate any security protocol is allowed. An empty list shall indicate no security protocols are allowed.
| string | Description |
|---|---|
| DHHC | Diffie-Hellman Hashed Message
Authentication Code Challenge Handshake Authentication Protocol
(DH-HMAC-CHAP).
|
| OEM | OEM.
|
| TLS_PSK | Transport Layer Security Pre-Shared Key
(TLS PSK).
|
6.58.4.6 SecurityTransportAllowList
The NVMe security transports that a key is allowed to use.
- The
security transports that this key policy allows.
- This property shall contain the security transports that this key policy allows. The absence of the property shall indicate any security transport is allowed. An empty list shall indicate no security transports are allowed.
| string | Description |
|---|---|
| TLSv2 | Transport Layer Security (TLS)
v2.
|
| TLSv3 | Transport Layer Security (TLS)
v3.
|
6.58.5 Example response
{
"@odata.type": "#KeyPolicy.v1_0_0.KeyPolicy",
"Id": "0",
"Name": "Default NVMeoF Key Policy",
"IsDefault": true,
"KeyPolicyType": "NVMeoF",
"NVMeoF": {
"SecurityTransportAllowList": [
"TLSv2",
"TLSv3"
],
"CipherSuiteAllowList": [
"TLS_AES_128_GCM_SHA256",
"TLS_AES_256_GCM_SHA384"
],
"SecurityProtocolAllowList": [
"DHHC",
"TLS_PSK"
],
"DHGroupAllowList": [
"FFDHE2048",
"FFDHE3072",
"FFDHE4096",
"FFDHE6144",
"FFDHE8192"
],
"SecureHashAllowList": [
"SHA384",
"SHA512"
]
},
"@odata.id": "/redfish/v1/KeyService/NVMeoFKeyPolicies/0"
}6.59 KeyService 1.0.0
| Version | v1.0 |
| Release | 2021.2 |
6.59.1 Description
The KeyService schema describes a key service that represents the actions available to manage keys.
- This resource shall represent the key service properties for a Redfish implementation.
6.59.2 URIs
/redfish/v1/KeyService
6.59.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| NVMeoFKeyPolicies { | object | The NVMe-oF key policies maintained by
this service.
|
|
| @odata.id | string | read-only | Link to Collection of KeyPolicy. See the KeyPolicy schema for details. |
| } | |||
| NVMeoFSecrets { | object | The NVMe-oF keys maintained by this
service.
|
|
| @odata.id | string | read-only | Link to Collection of Key. See the Key schema for details. |
| } |
6.59.4 Example response
{
"@odata.type": "#KeyService.v1_0_0.KeyService",
"Id": "KeyService",
"Name": "Key Service",
"NVMeoFSecrets": {
"@odata.id": "/redfish/v1/KeyService/NVMeoFSecrets"
},
"NVMeoFKeyPolicies": {
"@odata.id": "/redfish/v1/KeyService/NVMeoFKeyPolicies"
},
"@odata.id": "/redfish/v1/KeyService"
}6.60 LeakDetection 1.0.0
| Version | v1.0 |
| Release | 2023.1 |
6.60.1 Description
The LeakDetection schema contains definitions for reporting leaks in liquid cooling systems or other equipment.
- This resource shall represent the leak detection functionality present in a service for a Redfish implementation.
6.60.2 URIs
/redfish/v1/Chassis/{ChassisId}/ThermalSubsystem/LeakDetection
/redfish/v1/ThermalEquipment/CDUs/{CoolingUnitId}/LeakDetection
/redfish/v1/ThermalEquipment/HeatExchangers/{CoolingUnitId}/LeakDetection
/redfish/v1/ThermalEquipment/ImmersionUnits/{CoolingUnitId}/LeakDetection
6.60.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| LeakDetectorGroups [ { | array | The groups of leak detection
equipment.
|
|
| Detectors [ { | array (excerpt) |
The leak detection states from all related
leak detection devices in this group.
|
|
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this leak detector.
|
| DetectorState | string (enum) |
read-only (null) |
The state of the leak
detector.
|
| PhysicalContext | string (enum) |
read-only (null) |
The area or device to which this leak
detector applies.
|
| PhysicalSubContext | string (enum) |
read-only (null) |
The usage or location within a device to
which this leak detector applies.
|
| } ] | |||
| GroupName | string | read-only | The name of this leak detector
group.
|
| HumidityPercent { | object (excerpt) |
Humidity (percent).
|
|
| 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.
|
| } | |||
| } ] | |||
| LeakDetectors { | object | The link to the collection of leak
detectors within this subsystem.
|
|
| @odata.id | string | read-only | Link to Collection of LeakDetector. See the LeakDetector schema for details. |
| } | |||
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
6.60.4 Property details
6.60.4.1 DetectorState
The state of the leak detector.
- This property shall contain the state of the leak detector.
| string | Description |
|---|---|
| Critical | A critical condition requires immediate attention. |
| OK | Normal. |
| Warning | A condition requires attention. |
6.60.4.2 PhysicalContext
The area or device to which this leak detector applies.
- This property shall contain a description of the affected component or region within the equipment to which this leak detector applies.
| string | Description |
|---|---|
| Accelerator | An accelerator. |
| ACInput | An AC input. |
| ACMaintenanceBypassInput | An AC maintenance bypass input. |
| ACOutput | An AC output. |
| ACStaticBypassInput | An AC static bypass input. |
| ACUtilityInput | An AC utility input. |
| ASIC | An ASIC device, such as a networking chip or chipset component. |
| Back | The back of the chassis. |
| Backplane | A backplane within the chassis. |
| Battery | A battery. |
| Board | A circuit board.
|
| Chassis | The entire chassis. |
| ComputeBay | Within a compute bay. |
| CoolingSubsystem | The entire cooling, or air and liquid, subsystem. |
| CPU | A processor (CPU). |
| CPUSubsystem | The entire processor (CPU) subsystem. |
| DCBus | A DC bus. |
| Exhaust | The air exhaust point or points or region of the chassis. |
| ExpansionBay | Within an expansion bay. |
| Fan | A fan. |
| FPGA | An FPGA. |
| Front | The front of the chassis. |
| GPU | A graphics processor (GPU). |
| GPUSubsystem | The entire graphics processor (GPU) subsystem. |
| Intake | The air intake point or points or region of the chassis. |
| LiquidInlet | The liquid inlet point of the chassis. |
| LiquidOutlet | The liquid outlet point of the chassis. |
| Lower | The lower portion of the chassis. |
| Memory | A memory device. |
| MemorySubsystem | The entire memory subsystem. |
| Motor | A motor. |
| NetworkBay | Within a networking bay. |
| NetworkingDevice | A networking device. |
| PowerSubsystem | The entire power subsystem. |
| PowerSupply | A power supply. |
| PowerSupplyBay | Within a power supply bay. |
| Pump | A pump. |
| Rectifier | A rectifier device. |
| Room | The room. |
| StorageBay | Within a storage bay. |
| StorageDevice | A storage device. |
| SystemBoard | The system board (PCB). |
| Transceiver | A transceiver.
|
| Transformer | A transformer. |
| TrustedModule | A trusted module. |
| Upper | The upper portion of the chassis. |
| VoltageRegulator | A voltage regulator device. |
6.60.4.3 PhysicalSubContext
The usage or location within a device to which this leak detector applies.
- This property shall contain a description of the usage or sub-region within the equipment to which this leak detector applies. This property generally differentiates multiple leak detectors within the same PhysicalContext instance.
| string | Description |
|---|---|
| Input | The input. |
| Output | The output. |
6.60.5 Example response
{
"@odata.type": "#LeakDetection.v1_0_0.LeakDetection",
"Id": "LeakDetection",
"Name": "Leak Detection Systems",
"Status": {
"State": "Enabled",
"Health": "OK",
"Conditions": []
},
"LeakDetectorGroups": [
{
"GroupName": "Detectors under and around the CDU",
"HumidityPercent": {
"Reading": 45
},
"Detectors": [
{
"DataSourceUri": "/redfish/v1/ThermalEquipment/CDUs/1/LeakDetection/LeakDetectors/Moisture",
"DeviceName": "Moisture-type Leak Detector",
"DetectorState": "OK"
},
{
"DeviceName": "Leak Detection Rope 1",
"DetectorState": "OK"
},
{
"DataSourceUri": "/redfish/v1/ThermalEquipment/CDUs/1/LeakDetection/LeakDetectors/Overflow",
"DeviceName": "Overflow Float Switch",
"DetectorState": "OK"
}
]
}
],
"LeakDetectors": {
"@odata.id": "/redfish/v1/ThermalEquipment/CDUs/1/LeakDetection/LeakDetectors"
},
"@odata.id": "/redfish/v1/ThermalEquipment/CDUs/1/LeakDetection"
}6.61 LeakDetector 1.0.0
| Version | v1.0 |
| Release | 2023.1 |
6.61.1 Description
The LeakDetector schema describes a state-based or digital value leak detector and its properties.
- This resource shall represent a state-based or digital value leak detector for a Redfish implementation.
6.61.2 URIs
/redfish/v1/Chassis/{ChassisId}/ThermalSubsystem/LeakDetection/LeakDetectors/{LeakDetectorId}
/redfish/v1/ThermalEquipment/CDUs/{CoolingUnitId}/LeakDetection/LeakDetectors/{LeakDetectorId}
/redfish/v1/ThermalEquipment/HeatExchangers/{CoolingUnitId}/LeakDetection/LeakDetectors/{LeakDetectorId}
/redfish/v1/ThermalEquipment/ImmersionUnits/{CoolingUnitId}/LeakDetection/LeakDetectors/{LeakDetectorId}
6.61.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| DetectorState | string (enum) |
read-only (null) |
The state of the leak
detector.
|
| LeakDetectorType | string (enum) |
read-only (null) |
The type of leak detection
sensor.
|
| Location {} | object | The location information for this leak
detector.
|
|
| Manufacturer | string | read-only (null) |
The manufacturer of this leak
detector.
|
| Model | string | read-only (null) |
The model number of the leak
detector.
|
| PartNumber | string | read-only (null) |
The part number of the leak
detector.
|
| PhysicalContext | string (enum) |
read-only (null) |
The area or device to which this leak
detector applies.
|
| PhysicalSubContext | string (enum) |
read-only (null) |
The usage or location within a device to
which this leak detector applies.
|
| SensingFrequency | number | read-only (null) |
The time interval between readings of the
physical leak detector.
|
| SerialNumber | string | read-only (null) |
The serial number of the leak
detector.
|
| SKU | string | read-only (null) |
The SKU of the leak detector.
|
| SparePartNumber | string | read-only (null) |
The spare part number of the leak
detector.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
6.61.4 Property details
6.61.4.1 DetectorState
The state of the leak detector.
- This property shall contain the state of the leak detector.
| string | Description |
|---|---|
| Critical | A critical condition requires immediate attention. |
| OK | Normal. |
| Warning | A condition requires attention. |
6.61.4.2 LeakDetectorType
The type of leak detection sensor.
- This property shall contain the reading type of the leak detection sensor.
| string | Description |
|---|---|
| FloatSwitch | A float switch. |
| Moisture | A moisture sensor. |
6.61.4.3 PhysicalContext
The area or device to which this leak detector applies.
- This property shall contain a description of the affected component or region within the equipment to which this leak detector applies.
| string | Description |
|---|---|
| Accelerator | An accelerator. |
| ACInput | An AC input. |
| ACMaintenanceBypassInput | An AC maintenance bypass input. |
| ACOutput | An AC output. |
| ACStaticBypassInput | An AC static bypass input. |
| ACUtilityInput | An AC utility input. |
| ASIC | An ASIC device, such as a networking chip or chipset component. |
| Back | The back of the chassis. |
| Backplane | A backplane within the chassis. |
| Battery | A battery. |
| Board | A circuit board.
|
| Chassis | The entire chassis. |
| ComputeBay | Within a compute bay. |
| CoolingSubsystem | The entire cooling, or air and liquid, subsystem. |
| CPU | A processor (CPU). |
| CPUSubsystem | The entire processor (CPU) subsystem. |
| DCBus | A DC bus. |
| Exhaust | The air exhaust point or points or region of the chassis. |
| ExpansionBay | Within an expansion bay. |
| Fan | A fan. |
| FPGA | An FPGA. |
| Front | The front of the chassis. |
| GPU | A graphics processor (GPU). |
| GPUSubsystem | The entire graphics processor (GPU) subsystem. |
| Intake | The air intake point or points or region of the chassis. |
| LiquidInlet | The liquid inlet point of the chassis. |
| LiquidOutlet | The liquid outlet point of the chassis. |
| Lower | The lower portion of the chassis. |
| Memory | A memory device. |
| MemorySubsystem | The entire memory subsystem. |
| Motor | A motor. |
| NetworkBay | Within a networking bay. |
| NetworkingDevice | A networking device. |
| PowerSubsystem | The entire power subsystem. |
| PowerSupply | A power supply. |
| PowerSupplyBay | Within a power supply bay. |
| Pump | A pump. |
| Rectifier | A rectifier device. |
| Room | The room. |
| StorageBay | Within a storage bay. |
| StorageDevice | A storage device. |
| SystemBoard | The system board (PCB). |
| Transceiver | A transceiver.
|
| Transformer | A transformer. |
| TrustedModule | A trusted module. |
| Upper | The upper portion of the chassis. |
| VoltageRegulator | A voltage regulator device. |
6.61.4.4 PhysicalSubContext
The usage or location within a device to which this leak detector applies.
- This property shall contain a description of the usage or sub-region within the equipment to which this leak detector applies. This property generally differentiates multiple leak detectors within the same PhysicalContext instance.
| string | Description |
|---|---|
| Input | The input. |
| Output | The output. |
6.61.5 Example response
{
"@odata.type": "#LeakDetector.v1_0_0.LeakDetector",
"Id": "Moisture",
"Name": "Moisture-type Leak Detector",
"LeakDetectorType": "Moisture",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"DetectorState": "OK",
"PartNumber": "3493-A44",
"SerialNumber": "916239",
"Manufacturer": "Contoso Water Detection Systems",
"Model": "Depends 3000",
"Location": {
"PartLocation": {
"Reference": "Bottom",
"ServiceLabel": "Leak Detector"
}
},
"PhysicalContext": "Chassis",
"@odata.id": "/redfish/v1/ThermalEquipment/CDUs/1/LeakDetection/LeakDetectors/Moisture"
}6.62 License 1.1.1
| Version | v1.1 | v1.0 |
| Release | 2022.3 | 2021.3 |
6.62.1 Description
The License schema describes a license for a feature.
- This resource shall represent a license for a Redfish implementation.
6.62.2 URIs
/redfish/v1/LicenseService/Licenses/{LicenseId}
6.62.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AuthorizationScope | string (enum) |
read-only (null) |
The authorization scope of the
license.
|
| Contact { | object | The contact of the license.
|
|
| ContactName | string | read-only (null) |
Name of this contact.
|
| EmailAddress | string | read-only (null) |
Email address for this
contact.
|
| PhoneNumber | string | read-only (null) |
Phone number for this contact.
|
| } | |||
| DownloadURI | string (URI) |
read-only | The URI at which to download the license
file.
|
| EntitlementId | string | read-only (null) |
The entitlement identifier for this
license.
|
| ExpirationDate | string (date-time) |
read-only (null) |
The date and time when the license
expires.
|
| GracePeriodDays | integer | read-only (null) |
The grace days of this license.
|
| InstallDate | string (date-time) |
read-only (null) |
The date and time when the license was
installed.
|
| LicenseInfoURI | string (URI) |
read-only (null) |
The URI at which more information about
this license can be obtained.
|
| LicenseOrigin | string (enum) |
read-only (null) |
This indicates the origin of the
license.
|
| LicenseString | string | read-only required on
create (null) |
The Base64-encoded string of the
license.
|
| LicenseType | string (enum) |
read-only (null) |
The type of the license.
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| AuthorizedDevices [ { | array | An array of links to the devices
authorized by the license.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| TargetServices (v1.1+) [ { | array | An array of links to the managers where
the license is installed.
|
|
| @odata.id | string | read-only | Link to a Manager resource. See the Links section and the Manager schema for details. |
| } ] | |||
| } | |||
| Manufacturer | string | read-only (null) |
The manufacturer or producer of this
license.
|
| MaxAuthorizedDevices | integer | read-only (null) |
The maximum number of devices authorized
by the license.
|
| PartNumber | string | read-only (null) |
The part number for this
license.
|
| RemainingDuration | string (duration) |
read-only (null) |
The remaining usage duration before the
license expires.
^P(\d+D)?(T(\d+H)?(\d+M)?(\d+(.\d+)?S)?)?$ |
| RemainingUseCount | integer | read-only (null) |
The remaining usage count before the
license expires.
|
| Removable | boolean | read-only (null) |
An indication of whether the license is
removable.
|
| SerialNumber | string | read-only (null) |
The serial number for this
license.
|
| SKU | string | read-only (null) |
The SKU for this license.
|
| Status {} | object | The status of the license.
|
6.62.4 Property details
6.62.4.1 AuthorizationScope
The authorization scope of the license.
- This property shall contain the authorization scope of the license.
| string | Description |
|---|---|
| Capacity | The license authorizes functionality to a
number of devices, but not restricted to specific device
instances.
|
| Device | The license authorizes functionality for
specific device instances.
|
| Service | The license authorizes functionality to a
service.
|
6.62.4.2 LicenseOrigin
This indicates the origin of the license.
- This property shall contain the origin for the license.
| string | Description |
|---|---|
| BuiltIn | A license was provided with the product. |
| Installed | A license installed by user. |
6.62.4.3 LicenseType
The type of the license.
- This property shall contain the type for the license.
| string | Description |
|---|---|
| Production | A license for use in production
environments.
|
| Prototype | A prototype version of
license.
|
| Trial | A trial license.
|
6.62.5 Example response
{
"@odata.type": "#License.v1_1_1.License",
"Id": "KVM",
"Name": "Blade KVM-IP License 3-Pack",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"EntitlementId": "LIC20180820LDLM5C",
"LicenseType": "Production",
"Removable": false,
"LicenseOrigin": "BuiltIn",
"AuthorizationScope": "Device",
"GracePeriodDays": 60,
"Manufacturer": "Contoso",
"InstallDate": "2020-08-20T20:13:44Z",
"ExpirationDate": "2022-08-20T20:13:43Z",
"Links": {
"AuthorizedDevices": [
{
"@odata.id": "/redfish/v1/Managers/Blade1"
},
{
"@odata.id": "/redfish/v1/Managers/Blade4"
},
{
"@odata.id": "/redfish/v1/Managers/Blade5"
}
]
},
"Contact": {
"ContactName": "Bob Johnson",
"EmailAddress": "bjohnson@contoso.com"
},
"DownloadURI": "/dumpster/license111",
"LicenseInfoURI": "http://shop.contoso.com/licenses/blade-kvm",
"@odata.id": "/redfish/v1/LicenseService/Licenses/KVM"
}6.63 LicenseService 1.1.0
| Version | v1.1 | v1.0 |
| Release | 2022.3 | 2021.3 |
6.63.1 Description
The LicenseService schema describes the license service and the properties for the service itself with a link to the collection of licenses. The license service also provides methods for installing licenses in a Redfish service.
- This resource shall represent an license service and the properties that affect the service itself for a Redfish implementation.
6.63.2 URIs
/redfish/v1/LicenseService
6.63.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| LicenseExpirationWarningDays | integer | read-write (null) |
The number of days prior to a license
expiration that a warning message is sent. A value of zero indicates no
warning message is sent.
|
| Licenses { | object | (null) |
The link to the collection of
licenses.
|
| @odata.id | string | read-only | Link to Collection of License. See the License schema for details. |
| } | |||
| ServiceEnabled | boolean | read-write (null) |
An indication of whether this service is
enabled.
|
6.63.4 Actions
6.63.4.1 Install
Description
This action installs one or more licenses from a remote file.
- This action shall install one or more licenses from a
remote file. The service may update an existing License resource. The
Locationheader in the response shall contain the URI of the new or updated License resource.
Action URI
{Base URI of target resource}/Actions/LicenseService.Install
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| AuthorizedDevices (v1.1+) [ { | array | optional | An array of links to the devices to be
authorized by the license.
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| LicenseFileURI | string | required | The URI of the license file to
install.
|
| Password | string | optional | The password to access the URI specified
by the LicenseFileURI parameter.
|
| TargetServices (v1.1+) [ { | array | optional | An array of links to the managers where
the license will be installed.
|
| @odata.id | string | read-only | Link to a Manager resource. See the Links section and the Manager schema for details. |
| } ] | |||
| TransferProtocol | string (enum) |
optional | The network protocol that the license
service uses to retrieve the license file located at the URI provided in
LicenseFileURI. This parameter is ignored if the URI provided in
LicenseFileURI contains a scheme.
|
| Username | string | optional | The user name to access the URI specified
by the LicenseFileURI parameter.
|
Request Example
{
"LicenseFileURI": "ftp://licensing.contoso.org/bmc_kvmip_8RS247MKRQ8027.bin",
"Username": "operations",
"Password": "Pa55w0rd"
}6.63.5 Property details
6.63.5.1 TransferProtocol
The network protocol that the license service uses to retrieve the license file located at the URI provided in LicenseFileURI. This parameter is ignored if the URI provided in LicenseFileURI contains a scheme.
- This parameter shall contain the network protocol that the license service shall use to retrieve the license file located at the LicenseFileURI. Services should ignore this parameter if the URI provided in LicenseFileURI contains a scheme. If this parameter is not provided or supported, and a transfer protocol is not specified by a scheme contained within this URI, the service shall use HTTP to retrieve the file.
| string | Description |
|---|---|
| CIFS | Common Internet File System (CIFS). |
| FTP | File Transfer Protocol (FTP). |
| HTTP | Hypertext Transfer Protocol (HTTP). |
| HTTPS | Hypertext Transfer Protocol Secure (HTTPS). |
| NFS | Network File System (NFS). |
| OEM | A manufacturer-defined protocol. |
| SCP | Secure Copy Protocol (SCP). |
| SFTP | Secure File Transfer Protocol (SFTP). |
| TFTP | Trivial File Transfer Protocol (TFTP). |
6.63.6 Example response
{
"@odata.type": "#LicenseService.v1_1_0.LicenseService",
"Name": "License Service",
"ServiceEnabled": true,
"LicenseExpirationWarningDays": 14,
"Actions": {
"#LicenseService.Install": {
"target": "/redfish/v1/LicenseService/Actions/LicenseService.Install",
"@Redfish.ActionInfo": "/redfish/v1/LicenseService/InstallActionInfo"
}
},
"Licenses": {
"@odata.id": "/redfish/v1/LicenseService/Licenses"
},
"@odata.id": "/redfish/v1/LicenseService"
}6.64 LogEntry 1.15.1
| Version | v1.15 | v1.14 | v1.13 | v1.12 | v1.11 | v1.10 | v1.9 | v1.8 | v1.7 | v1.6 | v1.5 | ... |
| Release | 2023.1 | 2022.3 | 2022.2 | 2022.1 | 2021.4 | 2021.3 | 2021.1 | 2020.4 | 2020.3 | 2020.1 | 2019.3 | ... |
6.64.1 Description
The LogEntry schema defines the record format for a log. It is designed for Redfish event logs, OEM-specific log formats, and the IPMI System Event Log (SEL). The EntryType field indicates the type of log and the resource includes several additional properties dependent on the EntryType.
- This resource shall represent the log format for log services in a Redfish implementation.
6.64.2 URIs
/redfish/v1/Chassis/{ChassisId}/LogServices/{LogServiceId}/Entries/{LogEntryId}
/redfish/v1/Chassis/{ChassisId}/PCIeDevices/{PCIeDeviceId}/CXLLogicalDevices/{CXLLogicalDeviceId}/DeviceLog/Entries/{LogEntryId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/LogServices/{LogServiceId}/Entries/{LogEntryId}
/redfish/v1/JobService/Log/Entries/{LogEntryId}
/redfish/v1/Managers/{ManagerId}/LogServices/{LogServiceId}/Entries/{LogEntryId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/LogServices/{LogServiceId}/Entries/{LogEntryId}
/redfish/v1/Systems/{ComputerSystemId}/LogServices/{LogServiceId}/Entries/{LogEntryId}
/redfish/v1/Systems/{ComputerSystemId}/Memory/{MemoryId}/DeviceLog/Entries/{LogEntryId}
/redfish/v1/TelemetryService/LogService/Entries/{LogEntryId}
6.64.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AdditionalDataSizeBytes (v1.7+) | integer (bytes) |
read-only (null) |
The size of the additional data for this
log entry.
|
| AdditionalDataURI (v1.7+) | string (URI) |
read-only (null) |
The URI at which to access the additional
data for this log entry, such as diagnostic data, image captures, or
other files.
|
| CPER (v1.15+) { | object | Details for a CPER section or record
associated with this log entry.
|
|
| NotificationType (v1.15+) | string (uuid) |
read-only (null) |
The CPER Notification Type for a CPER
record.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ |
| Oem (v1.15+) {} | object | See the OEM object definition in the Using this guide clause. | |
| SectionType (v1.15+) | string (uuid) |
read-only (null) |
The CPER Section Type.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ |
| } | |||
| Created | string (date-time) |
read-only | The date and time when the log entry was
created.
|
| CXLEntryType (v1.14+) | string (enum) |
read-only | The specific CXL entry type.
|
| DiagnosticData (v1.15+) | string | read-only (null) |
A Base64-encoded set of diagnostic data
associated with this log entry.
|
| DiagnosticDataType (v1.7+) | string (enum) |
read-only (null) |
The type of data available in the
DiagnosticData property or retrieved from the URI specified by the
AdditionalDataURI property.
|
| EntryCode | string (enum) |
read-only (null) |
The entry code for the log entry if the
entry type is SEL.
|
| EntryType | string (enum) |
read-only required | The type of log entry.
|
| EventGroupId (v1.4+) | integer | read-only (null) |
An identifier that correlates events with
the same cause.
|
| EventId (v1.1+) | string | read-only | The unique instance identifier for an
event.
|
| EventTimestamp (v1.1+) | string (date-time) |
read-only | The date and time when the event
occurred.
|
| EventType (v1.1+, deprecated v1.4 | string (enum) |
read-only | The type of event recorded in this
log.
|
| FirstOverflowTimestamp (v1.14+) | string (date-time) |
read-only | The timestamp of the first overflow
captured after this log entry.
|
| GeneratorId (v1.5+) | string | read-only (null) |
An identifier of the device that has
generated the IPMI SEL Event Record.
^0[xX](([a-fA-F]|[0-9]){2}){2}$ |
| LastOverflowTimestamp (v1.14+) | string (date-time) |
read-only | The timestamp of the last overflow
captured after this log entry.
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| OriginOfCondition { | object | The link to the resource that caused the
log entry.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } | |||
| RelatedItem (v1.12+) [ { | array | An array of links to resources associated
with this log entry.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| RelatedLogEntries (v1.12+) [ { | array | An array of links to other log entries
that are related to this log entry.
|
|
| @odata.id | string | read-only | Link to another LogEntry resource. |
| } ] | |||
| } | |||
| Message | string | read-only (null) |
The message of the log entry. This
property decodes from the entry type. If the entry type is
Event, this property contains a message. If the entry type
is SEL, this property contains an SEL-specific message. If
the entry type is CXL, this property contains a CXL event
record. Otherwise, this property contains an OEM-specific log entry. In
most cases, this property contains the actual log entry.
|
| 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 | The MessageId, event data, or OEM-specific
information. This property decodes from the entry type. If the entry
type is Event, this property contains a Redfish
Specification-defined MessageId. If the entry type is SEL,
this property contains the Event Data. Otherwise, this property contains
OEM-specific information.
|
| Modified (v1.6+) | string (date-time) |
read-only | The date and time when the log entry was
last modified.
|
| OEMDiagnosticDataType (v1.7+) | string | read-only (null) |
The OEM-defined type of data available in
the DiagnosticData property or retrieved from the URI specified by the
AdditionalDataURI property.
|
| OemLogEntryCode (v1.3+) | string | read-only (null) |
The OEM-specific entry code, if the
LogEntryCode type is OEM.
|
| OemRecordFormat | string | read-only (null) |
The OEM-specific format of the entry. If
the entry type is Oem, this property contains more
information about the record format from the OEM.
|
| OemSensorType (v1.3+) | string | read-only (null) |
The OEM-specific sensor type if the sensor
type is OEM.
|
| Originator (v1.11+) | string | read-only | The source of the log entry.
|
| OriginatorType (v1.11+) | string (enum) |
read-only | The type of originator data.
|
| OverflowErrorCount (v1.14+) | integer | read-only | The count of overflow errors that occurred
after this log entry.
|
| Persistency (v1.14+) | boolean | read-only | Indicates whether the log entry is
persistent across a cold reset of the device.
|
| Resolution (v1.9+) | string | read-only | Used to provide suggestions on how to
resolve the situation that caused the log entry.
|
| Resolved (v1.8+) | boolean | read-write (null) |
Indicates if the cause of the log entry
has been resolved or repaired.
|
| SensorNumber | integer | read-only (null) |
The IPMI-defined sensor
number.
|
| SensorType | string (enum) |
read-only (null) |
The sensor type to which the log entry
pertains if the entry type is SEL.
|
| ServiceProviderNotified (v1.9+) | boolean | read-only (null) |
Indicates if the log entry has been sent
to the service provider.
|
| Severity | string (enum) |
read-only (null) |
The severity of the log entry.
|
| SpecificEventExistsInGroup (v1.13+) | boolean | read-only | Indicates this log entry is equivalent to
a more specific log entry within the same EventGroupId.
|
6.64.4 Property details
6.64.4.1 CXLEntryType
The specific CXL entry type.
- This property shall contain the
specific CXL entry type. This property shall only be present if
EntryType contains
CXL.
| string | Description |
|---|---|
| DynamicCapacity | A CXL Dynamic Capacity log entry. |
| Failure | A CXL failure log entry. |
| Fatal | A CXL fatal log entry. |
| Informational | A CXL informational log entry. |
| Warning | A CXL warning log entry. |
6.64.4.2 DiagnosticDataType
The type of data available in the DiagnosticData property or retrieved from the URI specified by the AdditionalDataURI property.
- This property shall contain the type of data available in the DiagnosticData property or retrieved from the URI specified by the AdditionalDataURI property.
| string | Description |
|---|---|
| CPER (v1.10+) | UEFI Common Platform Error
Record.
|
| CPERSection (v1.10+) | A Section of a UEFI Common Platform Error
Record.
|
| Manager | Manager diagnostic data. |
| OEM | OEM diagnostic data. |
| OS | Operating system (OS) diagnostic data. |
| PreOS | Pre-OS diagnostic data. |
6.64.4.3 EntryCode
The entry code for the log entry if the entry type is
SEL.
- This property shall contain the entry code for
the log entry if the EntryType is
SEL. Tables 42-1 and 42-2 of the IPMI Specification v2.0 revision 1.1 describe these enumerations.
| string | Description |
|---|---|
| Assert | The condition has been asserted. |
| D0 Power State | The ACPI-defined D0 power state. |
| D1 Power State | The ACPI-defined D1 power state. |
| D2 Power State | The ACPI-defined D2 power state. |
| D3 Power State | The ACPI-defined D3 power state. |
| Deassert | The condition has been deasserted. |
| Device Disabled | A device has been disabled. |
| Device Enabled | A device has been enabled. |
| Device Inserted / Device Present | A device has been inserted or is present. |
| Device Removed / Device Absent | A device has been removed or is absent. |
| Fully Redundant | Indicates that full redundancy has been regained. |
| Informational | An informational event. |
| Install Error | An install error has been detected. |
| Limit Exceeded | A limit has been exceeded. |
| Limit Not Exceeded | A limit has not been exceeded. |
| Lower Critical - going high | The reading crossed the Lower Critical threshold while going high. |
| Lower Critical - going low | The reading crossed the Lower Critical threshold while going low. |
| Lower Non-critical - going high | The reading crossed the Lower Non-critical threshold while going high. |
| Lower Non-critical - going low | The reading crossed the Lower Non-critical threshold while going low. |
| Lower Non-recoverable - going high | The reading crossed the Lower Non-recoverable threshold while going high. |
| Lower Non-recoverable - going low | The reading crossed the Lower Non-recoverable threshold while going low. |
| Monitor | A monitor event. |
| Non-redundant:Insufficient Resources | Unit is non-redundant and has insufficient resources to maintain normal operation. |
| Non-redundant:Sufficient Resources from Insufficient Resources | Unit has regained minimum resources needed for normal operation. |
| Non-redundant:Sufficient Resources from Redundant | Redundancy has been lost but unit is functioning with minimum resources needed for normal operation. |
| OEM (v1.3+) | An OEM-defined event. |
| Performance Lags | Performance does not meet expectations. |
| Performance Met | Performance meets expectations. |
| Predictive Failure asserted | A Predictive Failure has been detected. |
| Predictive Failure deasserted | A Predictive Failure is no longer present. |
| Redundancy Degraded | Redundancy still exists, but at less than full level. |
| Redundancy Degraded from Fully Redundant | Unit has lost some redundant resource(s) but is still in a redundant state. |
| Redundancy Degraded from Non-redundant | Unit has regained some resource(s) and is redundant but not fully redundant. |
| Redundancy Lost | Entered any non-redundant state, including Non-redundant: Insufficient Resources. |
| State Asserted | The state has been asserted. |
| State Deasserted | The state has been deasserted. |
| Transition to Active | The state transitioned to active. |
| Transition to Busy | The state transitioned to busy. |
| Transition to Critical from less severe | A state has changed to Critical from less severe. |
| Transition to Critical from Non-recoverable | A state has changed to Critical from Non-recoverable. |
| Transition to Degraded | A state has transitioned to Degraded. |
| Transition to Idle | The state transitioned to idle. |
| Transition to In Test | A state has transitioned to In Test. |
| Transition to Non-Critical from more severe | A state has changed to Non-Critical from more severe. |
| Transition to Non-Critical from OK | A state has changed to Non-Critical from OK. |
| Transition to Non-recoverable | A state has changed to Non-recoverable. |
| Transition to Non-recoverable from less severe | A state has changed to Non-recoverable from less severe. |
| Transition to Off Duty | A state has transitioned to Off Duty. |
| Transition to Off Line | A state has transitioned to Off Line. |
| Transition to OK | A state has changed to OK. |
| Transition to On Line | A state has transitioned to On Line. |
| Transition to Power Off | A state has transitioned to Power Off. |
| Transition to Power Save | A state has transitioned to Power Save. |
| Transition to Running | A state has transitioned to Running. |
| Upper Critical - going high | The reading crossed the Upper Critical threshold while going high. |
| Upper Critical - going low | The reading crossed the Upper Critical threshold while going low. |
| Upper Non-critical - going high | The reading crossed the Upper Non-critical threshold while going high. |
| Upper Non-critical - going low | The reading crossed the Upper Non-critical threshold while going low. |
| Upper Non-recoverable - going high | The reading crossed the Upper Non-recoverable threshold while going high. |
| Upper Non-recoverable - going low | The reading crossed the Upper Non-recoverable threshold while going low. |
6.64.4.4 EntryType
The type of log entry.
- This property shall represent the type
of log entry. If the resource represents an IPMI SEL entry, the value
shall contain
SEL. If the resource represents a Redfish event log entry, the value shall containEvent. If the resource represents a CXL event record, the value shall containCXL. If the resource represents an OEM log entry format, the value shall containOem.
| string | Description |
|---|---|
| CXL (v1.14+) | A CXL log entry. |
| Event | A Redfish-defined message. |
| Oem | An entry in an OEM-defined format. |
| SEL | A legacy IPMI System Event Log (SEL) entry. |
6.64.4.5 EventType
The type of event recorded in this log.
- If present, this LogEntry records an event and the value shall indicate the type of event.
| 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.64.4.6 OriginatorType
The type of originator data.
- This property shall contain the type of originator data.
| string | Description |
|---|---|
| Client | A client of the service created this log entry. |
| Internal | A process running on the service created this log entry. |
| SupportingService | A process not running on the service but running on a supporting service, such as RDE implementations, UEFI, or host processes, created this log entry. |
6.64.4.7 SensorType
The sensor type to which the log entry pertains if the entry type is
SEL.
- This property shall contain the sensor type to
which the log entry pertains if the entry type is
SEL. Table 42-3, Sensor Type Codes, in the IPMI Specification v2.0 revision 1.1 describes these enumerations.
| string | Description |
|---|---|
| Add-in Card | A sensor for an add-in card. |
| BaseOSBoot/InstallationStatus | A sensor for a base OS boot or installation status event. |
| Battery | A sensor for a battery. |
| Boot Error | A sensor for a boot error event. |
| Button/Switch | A sensor for a button or switch. |
| Cable/Interconnect | A sensor for a cable or interconnect device type. |
| Chassis | A sensor for a chassis. |
| ChipSet | A sensor for a chipset. |
| CoolingDevice | A sensor for a cooling device. |
| Critical Interrupt | A sensor for a critical interrupt event. |
| Current | A current sensor. |
| Drive Slot/Bay | A sensor for a drive slot or bay. |
| Entity Presence | A sensor for an entity presence event. |
| Event Logging Disabled | A sensor for the event log. |
| Fan | A fan sensor. |
| FRUState | A sensor for a FRU state event. |
| LAN | A sensor for a LAN device. |
| Management Subsystem Health | A sensor for a management subsystem health event. |
| Memory | A sensor for a memory device. |
| Microcontroller/Coprocessor | A sensor for a microcontroller or coprocessor. |
| Module/Board | A sensor for a module or board. |
| Monitor ASIC/IC | A sensor for a monitor ASIC or IC. |
| OEM (v1.3+) | An OEM-defined sensor. |
| OS Stop/Shutdown | A sensor for an OS stop or shutdown event |
| Other FRU | A sensor for another type of FRU. |
| Other Units-based Sensor | A sensor for a miscellaneous analog sensor. |
| Physical Chassis Security | A physical security sensor. |
| Platform Alert | A sensor for a platform alert event. |
| Platform Security Violation Attempt | A platform security sensor. |
| POST Memory Resize | A sensor for a POST memory resize event. |
| Power Supply / Converter | A sensor for a power supply or DC-to-DC converter. |
| PowerUnit | A sensor for a power unit. |
| Processor | A sensor for a processor. |
| Session Audit | A sensor for a session audit event. |
| Slot/Connector | A sensor for a slot or connector. |
| System ACPI PowerState | A sensor for an ACPI power state event. |
| System Event | A sensor for a system event. |
| System Firmware Progress | A sensor for a system firmware progress event. |
| SystemBoot/Restart | A sensor for a system boot or restart event. |
| Temperature | A temperature sensor. |
| Terminator | A sensor for a terminator. |
| Version Change | A sensor for a version change event. |
| Voltage | A voltage sensor. |
| Watchdog | A sensor for a watchdog event. |
6.64.4.8 Severity
The severity of the log entry.
- This property shall contain the
severity of the condition that created the log entry. If EntryType
contains
Event, services can replace the value defined in the message registry with a value more applicable to the implementation.
| string | Description |
|---|---|
| Critical | A critical condition that requires immediate attention. |
| OK | Informational or operating normally. |
| Warning | A condition that requires attention. |
6.64.5 Example response
{
"@odata.type": "#LogEntry.v1_15_1.LogEntry",
"Id": "1",
"Name": "Log Entry 1",
"EntryType": "Event",
"Severity": "Critical",
"Created": "2012-03-07T14:44:00Z",
"Resolved": false,
"Message": "Temperature threshold exceeded",
"MessageId": "Contoso.1.0.TempAssert",
"MessageArgs": [
"42"
],
"Links": {
"OriginOfCondition": {
"@odata.id": "/redfish/v1/Chassis/1U/Thermal"
}
},
"@odata.id": "/redfish/v1/Systems/437XR1138R2/LogServices/Log1/Entries/1"
}6.65 LogService 1.5.1
| Version | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2023.2 | 2022.3 | 2021.2 | 2020.3 | 2017.3 | 1.0 |
6.65.1 Description
The LogService schema contains properties for monitoring and
configuring a log service. When the Id property contains
DeviceLog, the log contains device-resident log entries
that follow the physical device when moved from system-to-system, and
not a replication or subset of a system event log.
- This resource
shall represent a log service for a Redfish implementation. When the Id
property contains
DeviceLog, the log shall contain log entries that migrate with the device.
6.65.2 URIs
/redfish/v1/Chassis/{ChassisId}/LogServices/{LogServiceId}
/redfish/v1/Chassis/{ChassisId}/PCIeDevices/{PCIeDeviceId}/CXLLogicalDevices/{CXLLogicalDeviceId}/DeviceLog
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/LogServices/{LogServiceId}
/redfish/v1/JobService/Log
/redfish/v1/Managers/{ManagerId}/LogServices/{LogServiceId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/LogServices/{LogServiceId}
/redfish/v1/Systems/{ComputerSystemId}/LogServices/{LogServiceId}
/redfish/v1/Systems/{ComputerSystemId}/Memory/{MemoryId}/DeviceLog
/redfish/v1/TelemetryService/LogService
6.65.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AutoDSTEnabled (v1.3+) | boolean | read-write | An indication of whether the log service
is configured for automatic Daylight Saving Time (DST)
adjustment.
|
| DateTime | string (date-time) |
read-write (null) |
The current date and time with UTC offset
of the log service.
|
| DateTimeLocalOffset | string | read-write (null) |
The time offset from UTC that the DateTime
property is in +HH:MM format.
^([-+][0-1][0-9]:[0-5][0-9])$ |
| Entries { | object | The link to the log entry
collection.
|
|
| @odata.id | string | read-only | Link to Collection of LogEntry. See the LogEntry schema for details. |
| } | |||
| LogEntryType (v1.1+) | string (enum) |
read-only (null) |
The format of the log entries.
|
| LogPurposes (v1.4+) [ ] | array (string (enum)) |
read-only (null) |
|
| MaxNumberOfRecords | integer | read-only | The maximum number of log entries that
this service can have.
|
| OEMLogPurpose (v1.4+) | string | read-only (null) |
The OEM-specified purpose of the log if
LogPurposes contains OEM.
|
| Overflow (v1.4+) | boolean | read-only | Indicates whether the log service has
overflowed.
|
| OverWritePolicy | string (enum) |
read-only | The overwrite policy for this service that
takes place when the log is full.
|
| Persistency (v1.4+) | boolean | read-only | Indicates whether the log service is
persistent across a cold reset.
|
| 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.
|
|
| SyslogFilters (v1.2+) [ { | array | A list of syslog message filters to be
logged locally.
|
|
| LogFacilities (v1.2+) [ ] | array (string (enum)) |
read-write (null) |
The syslog facility code is an enumeration
of program types.
|
| LowestSeverity (v1.2+) | string (enum) |
read-write (null) |
The lowest severity level message that
will be logged.
|
| } ] |
6.65.4 Actions
6.65.4.1 ClearLog
Description
The action to clear the log for this log service.
- This action shall delete all entries found in the LogEntryCollection resource for this log service.
Action URI
{Base URI of target resource}/Actions/LogService.ClearLog
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| LogEntriesETag (v1.3+) | string | optional | The ETag of the log entry collection
within this log service. If the provided ETag does not match the current
ETag of the log entry collection, the request is rejected.
|
Request Example
{
"LogEntriesEtag": "W/\"2A90423A\""
}6.65.4.2 CollectDiagnosticData (v1.2+)
Description
The action to collect the diagnostic data for the given type. When the diagnostic data is collected, a new log entry will be created and the additional data referenced by the new log entry will contain the diagnostic data.
- This action shall collect the diagnostic data
for the given type. The
Locationheader in the response shall contain a URI to a resource of type LogEntry that contains the diagnostic data. The AdditionalDataURI property in the referenced LogEntry resource shall contain the URI to download the diagnostic data.
Action URI
{Base URI of target resource}/Actions/LogService.CollectDiagnosticData
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| DiagnosticDataType | string (enum) |
required | The type of diagnostic data to
collect.
|
| OEMDiagnosticDataType | string | optional | The OEM-defined type of diagnostic data to
collect.
|
Request Example
{
"DiagnosticDataType": "Manager"
}6.65.5 Property details
6.65.5.1 DiagnosticDataType
The type of diagnostic data to collect.
- This parameter shall contain the type of diagnostic data to collect.
| string | Description |
|---|---|
| Manager | Manager diagnostic data. |
| OEM | OEM diagnostic data. |
| OS | Operating system (OS) diagnostic data. |
| PreOS | Pre-OS diagnostic data. |
6.65.5.2 LogEntryType
The format of the log entries.
- This property shall contain the
value for the EntryType property of all LogEntry resources contained in
the LogEntryCollection resource for this log service. If the service
cannot determine or guarantee a single EntryType value for all LogEntry
resources, this property shall contain the value
Multiple.
| string | Description |
|---|---|
| CXL (v1.5+) | The log contains CXL log entries. |
| Event | The log contains Redfish-defined messages. |
| Multiple | The log contains multiple log entry types and, therefore, the log service cannot guarantee a single entry type. |
| OEM | The log contains entries in an OEM-defined format. |
| SEL | The log contains legacy IPMI System Event Log (SEL) entries. |
6.65.5.3 LogFacilities
The syslog facility code is an enumeration of program types.
- The types of programs that can log messages.
- This property shall contain the types of programs that can log messages. If this property contains an empty array or is absent, all facilities shall be indicated.
| 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 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.65.5.4 LogPurposes
- The purposes of the log.
- This property shall contain the purposes of the log.
| string | Description |
|---|---|
| Diagnostic | The log provides information for diagnosing hardware or software issues, such as error conditions, sensor threshold trips, or exception cases. |
| ExternalEntity | The log exposes log entries provided by external entities, such as external users, system firmware, operating systems, or management applications. |
| OEM | The log is used for an OEM-defined purpose. |
| Operations | The log provides information about management operations that have a significant impact on the system, such as firmware updates, system resets, and storage volume creation. |
| Security | The log provides security-related information such as authentication, authorization, and data access logging required for security audits. |
| Telemetry | The log provides telemetry history, typically collected on a regular basis. |
6.65.5.5 LowestSeverity
The lowest severity level message that will be logged.
- This
property shall contain the lowest syslog severity level that will be
logged. The service shall log all messages equal to or greater than the
value in this property. The value
Allshall indicate all severities.
| 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 might require special handling. |
| Warning | A Warning. |
6.65.5.6 OverWritePolicy
The overwrite policy for this service that takes place when the log is full.
- This property shall indicate the policy of the log service when the MaxNumberOfRecords has been reached.
| string | Description |
|---|---|
| NeverOverWrites | When full, new entries to the log are discarded. |
| Unknown | The overwrite policy is not known or is undefined. |
| WrapsWhenFull | When full, new entries to the log overwrite earlier entries. |
6.65.6 Example response
{
"@odata.type": "#LogService.v1_5_1.LogService",
"Id": "Log1",
"Name": "System Log Service",
"Description": "This log contains entries related to the operation of the host Computer System.",
"MaxNumberOfRecords": 1000,
"OverWritePolicy": "WrapsWhenFull",
"DateTime": "2015-03-13T04:14:33+06:00",
"DateTimeLocalOffset": "+06:00",
"ServiceEnabled": true,
"LogEntryType": "Event",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Actions": {
"#LogService.ClearLog": {
"target": "/redfish/v1/Managers/1/LogServices/Log1/Actions/LogService.ClearLog"
}
},
"Entries": {
"@odata.id": "/redfish/v1/Managers/1/LogServices/Log1/Entries"
},
"@odata.id": "/redfish/v1/Managers/1/LogServices/Log1"
}6.66 Manager 1.18.0
| Version | v1.18 | v1.17 | v1.16 | v1.15 | v1.14 | v1.13 | v1.12 | v1.11 | v1.10 | v1.9 | v1.8 | ... |
| Release | 2023.1 | 2022.3 | 2022.2 | 2022.1 | 2021.4 | 2021.2 | 2021.1 | 2020.4 | 2020.3 | 2020.2 | 2020.1 | ... |
6.66.1 Description
In Redfish, a manager is a systems management entity that can implement or provide access to a Redfish service. Examples of managers are BMCs, enclosure managers, management controllers, and other subsystems that are assigned manageability functions. An implementation can have multiple managers, which might be directly accessible through a Redfish-defined interface.
- This resource shall represent a management subsystem for a Redfish implementation.
6.66.2 URIs
/redfish/v1/Managers/{ManagerId}
6.66.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AdditionalFirmwareVersions (v1.15+) { | object | The additional firmware versions of the
manager.
|
|
| Bootloader (v1.7+) | string | read-only (null) |
The bootloader version contained in this
software, such as U-Boot or UEFI.
|
| Kernel (v1.7+) | string | read-only (null) |
The kernel version contained in this
software.
|
| Microcode (v1.7+) | string | read-only (null) |
The microcode version contained in this
software, such as processor microcode.
|
| Oem (v1.7+) {} | object | See the OEM object definition in the Using this guide clause. | |
| OSDistribution (v1.8+) | string | read-only (null) |
The operating system name of this
software.
|
| } | |||
| AutoDSTEnabled (v1.4+) | boolean | read-write | An indication of whether the manager is
configured for automatic Daylight Saving Time (DST)
adjustment.
|
| Certificates (v1.13+) { | object | The link to a collection of certificates
for device identity and attestation.
|
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| CommandShell { | object | The command shell service that this
manager provides.
|
|
| ConnectTypesSupported [ ] | array (string (enum)) |
read-only |
|
| MaxConcurrentSessions | integer | read-only | The maximum number of service sessions,
regardless of protocol, that this manager can support.
|
| ServiceEnabled | boolean | read-write | An indication of whether the service is
enabled for this manager.
|
| } | |||
| DateTime | string (date-time) |
read-write (null) |
The current date and time with UTC offset
of the manager.
|
| DateTimeLocalOffset | string | read-write (null) |
The time offset from UTC that the DateTime
property is in +HH:MM format.
^([-+][0-1][0-9]:[0-5][0-9])$ |
| DedicatedNetworkPorts (v1.16+) { | object | The dedicated network ports of the
manager.
|
|
| @odata.id | string | read-only | Link to Collection of Port. See the Port schema for details. |
| } | |||
| EthernetInterfaces { | object | The link to a collection of NICs that this
manager uses for network communication.
|
|
| @odata.id | string | read-only | Link to Collection of EthernetInterface. See the EthernetInterface schema for details. |
| } | |||
| FirmwareVersion | string | read-only (null) |
The firmware version of this
manager.
|
| GraphicalConsole { | object | The information about the graphical
console service of this manager.
|
|
| ConnectTypesSupported [ ] | array (string (enum)) |
read-only |
|
| MaxConcurrentSessions | integer | read-only | The maximum number of service sessions,
regardless of protocol, that this manager can support.
|
| ServiceEnabled | boolean | read-write | An indication of whether the service is
enabled for this manager.
|
| } | |||
| HostInterfaces (v1.3+) { | object | The link to a collection of host
interfaces that this manager uses for local host communication. Clients
can find host interface configuration options and settings in this
navigation property.
|
|
| @odata.id | string | read-only | Link to Collection of HostInterface. See the HostInterface schema for details. |
| } | |||
| LastResetTime (v1.9+) | string (date-time) |
read-only | The date and time when the manager was
last reset or rebooted.
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| ActiveSoftwareImage (v1.6+) { | object | The link to the software inventory
resource that represents the active firmware image for this
manager.
|
|
| @odata.id | string | read-write | Link to a SoftwareInventory resource. See the Links section and the SoftwareInventory schema for details. |
| } | |||
| ManagedBy (v1.9+) [ { | array | The array of links to the managers
responsible for managing this manager.
|
|
| @odata.id | string | read-only | Link to another Manager resource. |
| } ] | |||
| ManagerForChassis [ { | array | An array of links to the chassis this
manager controls.
|
|
| @odata.id | string | read-only | Link to a Chassis resource. See the Links section and the Chassis schema for details. |
| } ] | |||
| ManagerForManagers (v1.9+) [ { | array | An array of links to the managers that are
managed by this manager.
|
|
| @odata.id | string | read-only | Link to another Manager resource. |
| } ] | |||
| ManagerForServers [ { | array | An array of links to the systems that this
manager controls.
|
|
| @odata.id | string | read-only | Link to a ComputerSystem resource. See the Links section and the ComputerSystem schema for details. |
| } ] | |||
| ManagerForSwitches (v1.4+) [ { | array | An array of links to the switches that
this manager controls.
|
|
| @odata.id | string | read-only | Link to a Switch resource. See the Links section and the Switch schema for details. |
| } ] | |||
| ManagerInChassis (v1.1+) { | object | The link to the chassis where this manager
is located.
|
|
| @odata.id | string | read-only | Link to a Chassis resource. See the Links section and the Chassis schema for details. |
| } | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| SelectedNetworkPort (v1.18+) { | object | (null) |
The network port currently used by this
manager. This allows selection of shared or dedicated ports for managers
that support one or the other. For managers that always have their
dedicated port enabled this allows the selection of which shared port to
use.
|
| @odata.id | string | read-write | Link to a Port resource. See the Links section and the Port schema for details. |
| } | |||
| SoftwareImages (v1.6+) [ { | array | The images that are associated with this
manager.
|
|
| @odata.id | string | read-only | Link to a SoftwareInventory resource. See the Links section and the SoftwareInventory schema for details. |
| } ] | |||
| } | |||
| Location (v1.11+) {} | object | The location of the manager.
|
|
| LocationIndicatorActive (v1.11+) | boolean | read-write (null) |
An indicator allowing an operator to
physically locate this resource.
|
| LogServices { | object | The link to a collection of logs that the
manager uses.
|
|
| @odata.id | string | read-only | Link to Collection of LogService. See the LogService schema for details. |
| } | |||
| ManagerDiagnosticData (v1.14+) { | object | (null) |
The diagnostic data for this
manager.
|
| @odata.id | string | read-only | Link to a ManagerDiagnosticData resource. See the Links section and the ManagerDiagnosticData schema for details. |
| } | |||
| ManagerType | string (enum) |
read-only | The type of manager that this resource
represents.
|
| Manufacturer (v1.7+) | string | read-only (null) |
The manufacturer of this
manager.
|
| Measurements (v1.13+, deprecated 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. |
| } ] | |||
| Model | string | read-only (null) |
The model information of this manager, as
defined by the manufacturer.
|
| NetworkProtocol { | object | The link to the network services and their
settings that the manager controls.
|
|
| @odata.id | string | read-only | Link to a ManagerNetworkProtocol resource. See the Links section and the ManagerNetworkProtocol schema for details. |
| } | |||
| PartNumber (v1.7+) | string | read-only (null) |
The part number of the
manager.
|
| PowerState (v1.2+) | string (enum) |
read-only (null) |
The current power state of the
manager.
|
| Redundancy [ { } ] | array (object) | The common redundancy definition and
structure used in other Redfish schemas.
|
|
| RemoteAccountService (v1.5+) { | object | The link to the account service resource
for the remote manager that this resource represents.
|
|
| @odata.id | string | read-only | Link to a AccountService resource. See the Links section and the AccountService schema for details. |
| } | |||
| RemoteRedfishServiceUri (v1.5+) | string (URI) |
read-only (null) |
The URI of the Redfish service root for
the remote manager that this resource represents.
|
| SecurityPolicy (v1.16+) { | object | (null) |
The security policy settings for this
manager.
|
| @odata.id | string | read-only | Link to a SecurityPolicy resource. See the Links section and the SecurityPolicy schema for details. |
| } | |||
| SerialConsole (deprecated v1.10) { | object | The serial console service that this
manager provides.
|
|
| ConnectTypesSupported [ ] | array (string (enum)) |
read-only |
|
| MaxConcurrentSessions | integer | read-only | The maximum number of service sessions,
regardless of protocol, that this manager can support.
|
| ServiceEnabled | boolean | read-write | An indication of whether the service is
enabled for this manager.
|
| } | |||
| SerialInterfaces { | object | The link to a collection of serial
interfaces that this manager uses for serial and console
communication.
|
|
| @odata.id | string | read-only | Link to Collection of SerialInterface. See the SerialInterface schema for details. |
| } | |||
| SerialNumber (v1.7+) | string | read-only (null) |
The serial number of the
manager.
|
| ServiceEntryPointUUID | string (uuid) |
read-only (null) |
The UUID of the Redfish service that is
hosted by this manager.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ |
| ServiceIdentification (v1.15+) | string | read-write (null) |
A product instance identifier displayed in
the Redfish service root.
|
| SharedNetworkPorts (v1.16+) { | object | The shared network ports of the
manager.
|
|
| @odata.id | string | read-only | Link to Collection of Port. See the Port schema for details. |
| } | |||
| SparePartNumber (v1.11+) | string | read-only (null) |
The spare part number of the
manager.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| TimeZoneName (v1.10+) | string | read-write | The time zone of the manager.
|
| USBPorts (v1.12+) { | object | The USB ports of the manager.
|
|
| @odata.id | string | read-only | Link to Collection of Port. See the Port schema for details. |
| } | |||
| UUID | string (uuid) |
read-only (null) |
The UUID for this manager.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ |
| Version (v1.17+) | string | read-only (null) |
The hardware version of this
manager.
|
| VirtualMedia (deprecated v1.10) { | object | The link to the Virtual Media services for
this particular manager.
|
|
| @odata.id | string | read-only | Link to Collection of VirtualMedia. See the VirtualMedia schema for details. |
| } |
6.66.4 Actions
6.66.4.1 ForceFailover
Description
The ForceFailover action forces a failover of this manager to the manager used in the parameter.
- This action shall perform a forced failover of the manager's redundancy to the manager supplied as a parameter.
Action URI
{Base URI of target resource}/Actions/Manager.ForceFailover
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| NewManager { | object | required | The manager to which to fail
over.
|
| @odata.id | string | read-only | Link to another Manager resource. |
| } |
Request Example
{
"NewManager": [
{
"@odata.id": "/redfish/v1/Managers/3"
}
]
}6.66.4.2 ModifyRedundancySet
Description
The ModifyRedundancySet operation adds members to or removes members from a redundant group of managers.
- The ModifyRedundancySet operation shall add members to or remove members from a redundant group of managers.
Action URI
{Base URI of target resource}/Actions/Manager.ModifyRedundancySet
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| Add [ { | array | optional | An array of managers to add to the
redundancy set.
|
| @odata.id | string | read-only | Link to another Manager resource. |
| } ] | |||
| Remove [ { | array | optional | An array of managers to remove from the
redundancy set.
|
| @odata.id | string | read-only | Link to another Manager resource. |
| } ] |
Request Example
{
"Add": [
{
"@odata.id": "/redfish/v1/Managers/4"
}
]
}6.66.4.3 Reset
Description
The reset action resets/reboots the manager.
- This action shall reset the manager.
Action URI
{Base URI of target resource}/Actions/Manager.Reset
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| ResetType | string (enum) |
optional | The type of reset.
|
Request Example
{
"ResetType": "ForceRestart"
}6.66.4.4 ResetToDefaults (v1.8+)
Description
The reset action resets the manager settings to factory defaults. This can cause the manager to reset.
- This action shall reset the manager settings. This action can impact other resources.
Action URI
{Base URI of target resource}/Actions/Manager.ResetToDefaults
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| ResetType | string (enum) |
required | The type of reset to defaults.
|
Request Example
{
"ResetType": "PreserveNetworkAndUsers"
}6.66.5 Property details
6.66.5.1 ConnectTypesSupported
6.66.5.1.1 In CommandShell:
- This property enumerates the command shell connection types that the implementation allows.
- This property shall contain an array of the enumerations. SSH shall be included if the Secure Shell (SSH) protocol is supported. Telnet shall be included if the Telnet protocol is supported. IPMI shall be included if the IPMI Serial Over LAN (SOL) protocol is supported.
| string | Description |
|---|---|
| IPMI | The controller supports a command shell connection through the IPMI Serial Over LAN (SOL) protocol. |
| Oem | The controller supports a command shell connection through an OEM-specific protocol. |
| SSH | The controller supports a command shell connection through the SSH protocol. |
| Telnet | The controller supports a command shell connection through the Telnet protocol. |
6.66.5.1.2 In GraphicalConsole:
- This property enumerates the graphical console connection types that the implementation allows.
- This property shall contain an array of the enumerations. RDP shall be included if the Remote Desktop (RDP) protocol is supported. KVMIP shall be included if a vendor-define KVM-IP protocol is supported.
| 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.66.5.1.3 In SerialConsole:
- This property enumerates the serial console connection types that the implementation allows.
- This property shall contain an array of the enumerations. SSH shall be included if the Secure Shell (SSH) protocol is supported. Telnet shall be included if the Telnet protocol is supported. IPMI shall be included if the IPMI Serial Over LAN (SOL) protocol is supported.
| string | Description |
|---|---|
| IPMI | The controller supports a serial console connection through the IPMI Serial Over LAN (SOL) protocol. |
| Oem | The controller supports a serial console connection through an OEM-specific protocol. |
| SSH | The controller supports a serial console connection through the SSH protocol. |
| Telnet | The controller supports a serial console connection through the Telnet protocol. |
6.66.5.2 ManagerType
The type of manager that this resource represents.
- This
property shall describe the function of this manager. The
ManagementControllervalue shall be used if none of the other enumerations apply.
| string | Description |
|---|---|
| AuxiliaryController | A controller that provides management functions for a particular subsystem or group of devices. |
| BMC | A controller that provides management functions for a single computer system. |
| EnclosureManager | A controller that provides management functions for a chassis or group of devices or systems. |
| ManagementController | A controller that primarily monitors or manages the operation of a device or system. |
| RackManager | A controller that provides management functions for a whole or part of a rack. |
| Service (v1.4+) | A software-based service that provides management functions. |
6.66.5.3 PowerState
The current power state of the manager.
- This property shall contain the power state of the manager.
| string | Description |
|---|---|
| Off | The resource is powered off. The components within the resource might continue to have AUX power. |
| On | The resource is powered on. |
| Paused | The resource is paused. |
| PoweringOff | A temporary state between on and off. The components within the resource can take time to process the power off action. |
| PoweringOn | A temporary state between off and on. The components within the resource can take time to process the power on action. |
6.66.5.4 ResetType
6.66.5.4.1 In Actions: Reset:
The type of reset.
- This parameter shall contain the type of reset. The service can accept a request without the parameter and perform an implementation specific default reset. Services should include the @Redfish.AllowableValues annotation for this parameter to ensure compatibility with clients, even when ActionInfo has been implemented.
| string | Description |
|---|---|
| ForceOff | Turn off the unit immediately
(non-graceful shutdown).
|
| ForceOn | Turn on the unit immediately.
|
| ForceRestart | Shut down immediately and non-gracefully
and restart the system.
|
| GracefulRestart | Shut down gracefully and restart the
system.
|
| GracefulShutdown | Shut down gracefully and power
off.
|
| Nmi | Generate a diagnostic interrupt, which is
usually an NMI on x86 systems, to stop normal operations, complete
diagnostic actions, and, typically, halt the system.
|
| On | Turn on the unit.
|
| Pause | Pause execution on the unit but do not
remove power. This is typically a feature of virtual machine
hypervisors.
|
| PowerCycle | Power cycle the unit. Behaves like a full
power removal, followed by a power restore to the resource.
|
| PushPowerButton | Simulate the pressing of the physical
power button on this unit.
|
| Resume | Resume execution on the paused unit. This
is typically a feature of virtual machine hypervisors.
|
| Suspend | Write the state of the unit to disk before
powering off. This allows for the state to be restored when powered back
on.
|
6.66.5.4.2 In Actions: ResetToDefaults:
The type of reset to defaults.
- This parameter shall contain the type of reset to defaults.
| string | Description |
|---|---|
| PreserveNetwork | Reset all settings except network settings to factory defaults. |
| PreserveNetworkAndUsers | Reset all settings except network and local user names/passwords to factory defaults. |
| ResetAll | Reset all settings to factory defaults. |
6.66.6 Example response
{
"@odata.type": "#Manager.v1_18_0.Manager",
"Id": "BMC",
"Name": "Manager",
"ManagerType": "BMC",
"Description": "Contoso BMC",
"ServiceEntryPointUUID": "92384634-2938-2342-8820-489239905423",
"UUID": "58893887-8974-2487-2389-841168418919",
"Model": "Joo Janta 200",
"FirmwareVersion": "4.4.6521",
"DateTime": "2015-03-13T04:14:33+06:00",
"DateTimeLocalOffset": "+06:00",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"PowerState": "On",
"GraphicalConsole": {
"ServiceEnabled": true,
"MaxConcurrentSessions": 2,
"ConnectTypesSupported": [
"KVMIP"
]
},
"CommandShell": {
"ServiceEnabled": true,
"MaxConcurrentSessions": 4,
"ConnectTypesSupported": [
"Telnet",
"SSH"
]
},
"HostInterfaces": {
"@odata.id": "/redfish/v1/Managers/9/HostInterfaces"
},
"NetworkProtocol": {
"@odata.id": "/redfish/v1/Managers/BMC/NetworkProtocol"
},
"EthernetInterfaces": {
"@odata.id": "/redfish/v1/Managers/BMC/NICs"
},
"SerialInterfaces": {
"@odata.id": "/redfish/v1/Managers/BMC/SerialInterfaces"
},
"LogServices": {
"@odata.id": "/redfish/v1/Managers/BMC/LogServices"
},
"VirtualMedia": {
"@odata.id": "/redfish/v1/Systems/437XR1138R2/VirtualMedia"
},
"Links": {
"ManagerForServers": [
{
"@odata.id": "/redfish/v1/Systems/437XR1138R2"
}
],
"ManagerForChassis": [
{
"@odata.id": "/redfish/v1/Chassis/1U"
}
],
"ManagerInChassis": {
"@odata.id": "/redfish/v1/Chassis/1U"
}
},
"Actions": {
"#Manager.Reset": {
"target": "/redfish/v1/Managers/BMC/Actions/Manager.Reset",
"ResetType@Redfish.AllowableValues": [
"ForceRestart",
"GracefulRestart"
]
}
},
"@odata.id": "/redfish/v1/Managers/BMC"
}6.67 ManagerAccount 1.11.0
| Version | v1.11 | v1.10 | v1.9 | v1.8 | v1.7 | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | ... |
| Release | 2023.2 | 2022.3 | 2022.1 | 2021.1 | 2020.4 | 2020.1 | 2019.4 | 2019.3 | 2019.1 | 2018.3 | 2017.1 | ... |
6.67.1 Description
The ManagerAccount schema defines the user accounts that are owned by a manager. Changes to a manager account might affect the current Redfish service connection if this manager is responsible for the Redfish service.
- This resource shall represent a user account for the manager in a Redfish implementation. The account shall indicate the allowed access to one of more services in the manager.
6.67.2 URIs
/redfish/v1/AccountService/Accounts/{ManagerAccountId}
/redfish/v1/Managers/{ManagerId}/RemoteAccountService/Accounts/{ManagerAccountId}
6.67.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AccountExpiration (v1.8+) | string (date-time) |
read-write (null) |
Indicates the date and time when this
account expires. If null, the account never
expires.
|
| AccountTypes (v1.4+) [ ] | array (string (enum)) |
read-write
required (null) |
|
| Certificates (v1.2+) { | object | The link to a collection of user identity
certificates for this account.
|
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| EmailAddress (v1.11+) | string | read-write (null) |
The email address associated with this
account.
|
| Enabled | boolean | read-write | An indication of whether an account is
enabled. An administrator can disable it without deleting the user
information. If true, the account is enabled and the user
can log in. If false, the account is disabled and, in the
future, the user cannot log in.
|
| HostBootstrapAccount (v1.8+) | boolean | read-only | An indication of whether this account is a
bootstrap account for the host interface.
|
| Keys (v1.9+) { | object | The link to the collection of keys that
can be used to authenticate this account. For example, an SSH public key
could be added to this collection to allow for SSH public key
authentication.
|
|
| @odata.id | string | read-only | Link to Collection of Key. See the Key schema for details. |
| } | |||
| Links { | object | The links to other resources that are
related to this resource.
|
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| Role { | object | The link to the Redfish role that defines
the privileges for this account.
|
|
| @odata.id | string | read-only | Link to a Role resource. See the Links section and the Role schema for details. |
| } | |||
| } | |||
| Locked | boolean | read-write | An indication of whether the account
service automatically locked the account because the lockout threshold
was exceeded. To manually unlock the account before the lockout duration
period, an administrator can change the property to false
to clear the lockout condition.
|
| MFABypass (v1.10+) { | object | (null) |
The multi-factor authentication bypass
settings for this account.
|
| @odata.id | string | read-only | Link to a MFABypass resource. See the Links section and the AccountService schema for details. |
| } | |||
| OEMAccountTypes (v1.4+) [ ] | array (string, null) | read-write | The OEM account types.
|
| OneTimePasscodeDeliveryAddress (v1.11+) | string | read-write (null) |
The address used to receive one-time
passcode messages for multi-factor authentication.
|
| Password | string | read-write required on
create (null) |
The password. Use this property with a
PATCH or PUT to write the password for the account. This property is
null in responses.
|
| PasswordChangeRequired (v1.3+) | boolean | read-write (null) |
An indication of whether the service
requires that the password for this account be changed before further
access to the account is allowed.
|
| PasswordExpiration (v1.6+) | string (date-time) |
read-write (null) |
Indicates the date and time when this
account password expires. If null, the account password
never expires.
|
| PhoneNumber (v1.11+) | string | read-write (null) |
The contact phone number associated with
this account.
|
| RoleId | string | read-write required on create | The role for this account.
|
| SNMP (v1.4+) { | object | (null) |
The SNMP settings for this
account.
|
| AuthenticationKey (v1.4+) | string | read-write (null) |
The secret authentication key for
SNMPv3.
(^[ !#-~]+$)|(^Passphrase:[ ^[ !#-~]+$)|(^Hex:[0-9A-Fa-f]{24,96})|(^\*+$) |
| AuthenticationKeySet (v1.5+) | boolean | read-only | Indicates if the AuthenticationKey
property is set.
|
| AuthenticationProtocol (v1.4+) | string (enum) |
read-write (null) |
The authentication protocol for
SNMPv3.
|
| EncryptionKey (v1.4+) | string | read-write (null) |
The secret encryption key used in
SNMPv3.
(^[ !#-~]+$)|(^Passphrase:[ ^[ !#-~]+$)|(^Hex:[0-9A-Fa-f]{32})|(^\*+$) |
| EncryptionKeySet (v1.5+) | boolean | read-only | Indicates if the EncryptionKey property is
set.
|
| EncryptionProtocol (v1.4+) | string (enum) |
read-write (null) |
The encryption protocol for
SNMPv3.
|
| } | |||
| StrictAccountTypes (v1.7+) | boolean | read-write (null) |
Indicates if the service needs to use the
account types exactly as specified when the account is created or
updated.
|
| UserName | string | read-write required on create | The user name for the account.
|
6.67.4 Actions
6.67.4.1 ChangePassword (v1.11+)
Description
This action changes the account password.
- This action shall change the account password while requiring password for the current session. This action prevents session hijacking.
Action URI
{Base URI of target resource}/Actions/ManagerAccount.ChangePassword
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| NewPassword | string | required | The new account password.
|
| SessionAccountPassword | string | required | The password of the account tied to the
current session.
|
Request Example
{
"SessionAccountPassword": "secret123",
"NewPassword": "B3tterS3cur1tY!"
}6.67.5 Property details
6.67.5.1 AccountTypes
- The list of services in the manager that the account is allowed to access.
- This property shall contain an array of the various manager services that the account is allowed to access. This shall not include functionality for receiving events or other notifications. If this property is not provided by the client, the default value shall be an array that contains the value `Redfish`. The service may add additional values when this property is set or updated if allowed by the value of the StrictAccountTypes property.
| 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.67.5.2 AuthenticationProtocol
The authentication protocol for SNMPv3.
- This property shall contain the SNMPv3 authentication protocol.
| string | Description |
|---|---|
| HMAC128_SHA224 (v1.7+) | HMAC-128-SHA-224
authentication.
|
| HMAC192_SHA256 (v1.7+) | HMAC-192-SHA-256
authentication.
|
| HMAC256_SHA384 (v1.7+) | HMAC-256-SHA-384
authentication.
|
| HMAC384_SHA512 (v1.7+) | HMAC-384-SHA-512
authentication.
|
| HMAC_MD5 | HMAC-MD5-96 authentication.
|
| HMAC_SHA96 | HMAC-SHA-96 authentication.
|
| None | No authentication.
|
6.67.5.3 EncryptionProtocol
The encryption protocol for SNMPv3.
- This property shall contain the SNMPv3 encryption protocol.
| string | Description |
|---|---|
| CBC_DES | CBC-DES encryption.
|
| CFB128_AES128 | CFB128-AES-128 encryption.
|
| None | No encryption.
|
6.67.6 Example response
{
"@odata.type": "#ManagerAccount.v1_11_0.ManagerAccount",
"Id": "1",
"Name": "User Account",
"Description": "User Account",
"Enabled": true,
"Password": null,
"PasswordChangeRequired": false,
"AccountTypes": [
"Redfish"
],
"UserName": "Administrator",
"RoleId": "Administrator",
"Locked": false,
"Links": {
"Role": {
"@odata.id": "/redfish/v1/AccountService/Roles/Administrator"
}
},
"Actions": {
"#ManagerAccount.ChangePassword": {
"target": "/redfish/v1/AccountService/Accounts/1/Actions/ManagerAccount.ChangePassword"
}
},
"@odata.id": "/redfish/v1/AccountService/Accounts/1"
}6.68 ManagerDiagnosticData 1.2.1
| Version | v1.2 | v1.1 |
| Release | 2022.3 | 2021.4 |
6.68.1 Description
The ManagerDiagnosticData schema defines internal diagnostic data for a manager. It contains information that might be used by vendors to collect debug information about the manager. Clients should not make decisions for raising alerts, creating service events, or other actions based on information in this resource.
- This resource shall represent internal diagnostic data for a manager for a Redfish implementation. Clients should not make decisions for raising alerts, creating service events, or other actions based on information in this resource.
6.68.2 URIs
/redfish/v1/Managers/{ManagerId}/ManagerDiagnosticData
6.68.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| BootTimeStatistics { | object | The boot time statistics of the
manager.
|
|
| FirmwareTimeSeconds | number | read-only (null) |
The number of seconds the manager spent in
the firmware stage.
|
| InitrdTimeSeconds | number | read-only (null) |
The number of seconds the manager spent in
the initrd boot stage.
|
| KernelTimeSeconds | number | read-only (null) |
The number of seconds the manager spent in
the kernel stage.
|
| LoaderTimeSeconds | number | read-only (null) |
The number of seconds the manager spent in
the loader stage.
|
| UserSpaceTimeSeconds | number | read-only (null) |
The number of seconds the manager spent in
the user space boot stage.
|
| } | |||
| FreeStorageSpaceKiB | integer (KiBy) |
read-only (null) |
The available storage space on this
manager in kibibytes (KiB).
|
| I2CBuses [ { | array | The statistics of the I2C
buses.
|
|
| BusErrorCount | integer | read-only (null) |
The number of bus errors on this I2C
bus.
|
| I2CBusName | string | read-only | The name of the I2C bus.
|
| NACKCount | integer | read-only (null) |
The number of NACKs on this I2C
bus.
|
| TotalTransactionCount | integer | read-only (null) |
The total number of transactions on this
I2C bus.
|
| } ] | |||
| MemoryECCStatistics { | object | The memory ECC statistics of the
manager.
|
|
| CorrectableECCErrorCount | integer | read-only (null) |
The number of the correctable errors since
reset.
|
| UncorrectableECCErrorCount | integer | read-only (null) |
The number of the uncorrectable errors
since reset.
|
| } | |||
| MemoryStatistics { | object | The memory statistics of the
manager.
|
|
| AvailableBytes | integer (bytes) |
read-only (null) |
The amount of memory available in bytes
for starting new processes without swapping.
|
| BuffersAndCacheBytes | integer (bytes) |
read-only (null) |
The amount of memory used in bytes by
kernel buffers, page caches, and slabs.
|
| FreeBytes | integer (bytes) |
read-only (null) |
The amount of free memory in
bytes.
|
| SharedBytes | integer (bytes) |
read-only (null) |
The amount of shared memory in
bytes.
|
| TotalBytes | integer (bytes) |
read-only (null) |
The total amount of memory in
bytes.
|
| UsedBytes | integer (bytes) |
read-only (null) |
The amount of used memory in
bytes.
|
| } | |||
| ProcessorStatistics { | object | The processor statistics of the
manager.
|
|
| KernelPercent | number (%) |
read-only (null) |
The percentage of CPU time spent in kernel
mode.
|
| UserPercent | number (%) |
read-only (null) |
The percentage of CPU time spent in user
mode.
|
| } | |||
| ServiceRootUptimeSeconds (v1.2+) | number | read-only (null) |
The wall-clock time the service root
hosted by this manager has been running in seconds.
|
| TopProcesses [ { | array | The statistics of the top processes of
this manager.
|
|
| CommandLine | string | read-only | The command line of this
process.
|
| KernelTimeSeconds | number | read-only (null) |
The number of seconds this process
executed in kernel space.
|
| ResidentSetSizeBytes | integer (bytes) |
read-only (null) |
The resident set size of this process in
bytes.
|
| RestartAfterFailureCount (v1.1+) | integer | read-only (null) |
The number of times this process has
restarted unexpectedly.
|
| RestartCount (v1.1+) | integer | read-only (null) |
The number of times this process has
restarted.
|
| UptimeSeconds (v1.1+) | number | read-only (null) |
The wall-clock time this process has been
running in seconds.
|
| UserTimeSeconds | number | read-only (null) |
The number of seconds this process
executed in user space.
|
| } ] |
6.68.4 Actions
6.68.4.1 ResetMetrics
Description
Resets time intervals or counted values of the diagnostic data for this manager.
- This action shall reset any time intervals or counted values of the diagnostic data for this manager.
Action URI
{Base URI of target resource}/Actions/ManagerDiagnosticData.ResetMetrics
Action parameters
This action takes no parameters.
6.68.5 Example response
{
"@odata.type": "#ManagerDiagnosticData.v1_2_1.ManagerDiagnosticData",
"Id": "ManagerDiagnosticData",
"Name": "Manager Diagnostic Data",
"I2CBuses": [
{
"I2CBusName": "i2c-0",
"TotalTransactionCount": 10000,
"BusErrorCount": 12,
"NACKCount": 34
},
{
"I2CBusName": "i2c-1",
"TotalTransactionCount": 20000,
"BusErrorCount": 56,
"NACKCount": 78
}
],
"MemoryStatistics": {
"TotalBytes": 1013052000,
"UsedBytes": 45084000,
"FreeBytes": 894820000,
"SharedBytes": 19864000,
"BuffersAndCacheBytes": 73148000,
"AvailableBytes": 928248000
},
"ProcessorStatistics": {
"KernelPercent": 12.34,
"UserPercent": 23.45
},
"TopProcesses": [
{
"CommandLine": "dbus-broker",
"UserTimeSeconds": 14400,
"KernelTimeSeconds": 10800,
"ResidentSetSizeBytes": 2300000
},
{
"CommandLine": "swampd",
"UserTimeSeconds": 13200,
"KernelTimeSeconds": 8441,
"ResidentSetSizeBytes": 8883000
},
{
"CommandLine": "ipmid",
"UserTimeSeconds": 13100,
"KernelTimeSeconds": 6650,
"ResidentSetSizeBytes": 23400000
},
{
"CommandLine": "phosphor-hwmon-readd -i iface1",
"UserTimeSeconds": 5100,
"KernelTimeSeconds": 3200,
"ResidentSetSizeBytes": 564000
}
],
"BootTimeStatistics": {
"FirmwareTimeSeconds": 42.3,
"LoaderTimeSeconds": 12.3,
"KernelTimeSeconds": 33.1,
"InitrdTimeSeconds": 3.2,
"UserSpaceTimeSeconds": 81.1
},
"MemoryECCStatistics": {
"CorrectableECCErrorCount": 1,
"UncorrectableECCErrorCount": 2
},
"@odata.id": "/redfish/v1/Managers/BMC/ManagerDiagnosticData"
}6.69 ManagerNetworkProtocol 1.9.1
| Version | v1.9 | v1.8 | v1.7 | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2022.2 | 2021.2 | 2020.4 | 2020.1 | 2019.3 | 2018.3 | 2018.2 | 2017.1 | 2016.3 | 1.0 |
6.69.1 Description
The network service settings for the manager.
- This Resource shall represent the network service settings for the manager.
6.69.2 URIs
/redfish/v1/Managers/{ManagerId}/NetworkProtocol
6.69.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| DHCP (v1.1+) {} | object | The settings for this manager's DHCPv4
protocol support.
|
|
| DHCPv6 (v1.3+) {} | object | The settings for this manager's DHCPv6
protocol support.
|
|
| FQDN | string | read-only (null) |
The fully qualified domain name for the
manager obtained by DNS including the host name and top-level domain
name.
|
| HostName | string | read-only (null) |
The DNS host name of this manager, without
any domain information.
|
| HTTP {} | object | The settings for this manager's HTTP
protocol support.
|
|
| HTTPS { | object | The settings for this manager's HTTPS
protocol support.
|
|
| Certificates (v1.4+) { | object | The link to a collection of certificates
used for HTTPS by this manager.
|
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| Port | integer | read-write (null) |
The protocol port.
|
| ProtocolEnabled | boolean | read-write (null) |
An indication of whether the protocol is
enabled.
|
| } | |||
| IPMI {} | object | The settings for this manager's
IPMI-over-LAN protocol support.
|
|
| KVMIP {} | object | The settings for this manager's KVM-IP
protocol support that apply to all system instances controlled by this
manager.
|
|
| NTP (v1.2+) { | object | The settings for this manager's NTP
protocol support.
|
|
| NetworkSuppliedServers (v1.9+) [ ] | array (string, null) | read-only | The NTP servers supplied by other network
protocols to this manager.
|
| NTPServers (v1.2+) [ ] | array (string, null) | read-write | Indicates to which user-supplied NTP
servers this manager is subscribed.
|
| Port | integer | read-write (null) |
The protocol port.
|
| ProtocolEnabled | boolean | read-write (null) |
An indication of whether the protocol is
enabled.
|
| } | |||
| Proxy (v1.8+) { | object | (null) |
The HTTP/HTTPS proxy information for this
manager.
|
| Enabled (v1.8+) | boolean | read-write | Indicates if the manager uses the proxy
server.
|
| ExcludeAddresses (v1.8+) [ ] | array (string, null) | read-write | Addresses that do not require the proxy
server to access.
|
| Password (v1.8+) | string | read-write (null) |
The password for the proxy. The value is
null in responses.
|
| PasswordSet (v1.8+) | boolean | read-only | Indicates if the Password property is
set.
|
| ProxyAutoConfigURI (v1.8+) | string (URI) |
read-write (null) |
The URI used to access a proxy
auto-configuration (PAC) file.
|
| ProxyServerURI (v1.8+) | string (URI) |
read-write | The URI of the proxy server, including the
scheme and any non-default port value.
|
| Username (v1.8+) | string | read-write | The username for the proxy.
|
| } | |||
| RDP (v1.3+) {} | object | The settings for this manager's Remote
Desktop Protocol support.
|
|
| RFB (v1.3+) {} | object | The settings for this manager's Remote
Frame Buffer protocol support, which can support VNC.
|
|
| SNMP { | object | The settings for this manager's SNMP
support.
|
|
| AuthenticationProtocol (v1.5+) | string (enum) |
read-write (null) |
The authentication protocol used for SNMP
access to this manager.
|
| CommunityAccessMode (v1.5+) | string (enum) |
read-write (null) |
The access level of the SNMP
community.
|
| CommunityStrings (v1.5+) [ { | array | The SNMP community strings.
|
|
| AccessMode (v1.5+) | string (enum) |
read-write (null) |
The access level of the SNMP
community.
|
| CommunityString (v1.5+) | string | read-write (null) |
The SNMP community string.
|
| Name (v1.5+) | string | read-write (null) |
The name of the SNMP
community.
|
| } ] | |||
| EnableSNMPv1 (v1.5+) | boolean | read-write (null) |
Indicates if access via SNMPv1 is
enabled.
|
| EnableSNMPv2c (v1.5+) | boolean | read-write (null) |
Indicates if access via SNMPv2c is
enabled.
|
| EnableSNMPv3 (v1.5+) | boolean | read-write (null) |
Indicates if access via SNMPv3 is
enabled.
|
| EncryptionProtocol (v1.5+) | string (enum) |
read-write (null) |
The encryption protocol used for SNMPv3
access to this manager.
|
| EngineId (v1.5+) { | object | (null) |
The engine ID.
|
| ArchitectureId (v1.6+) | string | read-write (null) |
The architecture identifier.
^([A-Fa-f0-9]{2} ){0,27}[A-Fa-f0-9]{2}$ |
| EnterpriseSpecificMethod (v1.5+) | string | read-write (null) |
The enterprise specific
method.
^([A-Fa-f0-9]{2} ){7}[A-Fa-f0-9]{2}$ |
| PrivateEnterpriseId (v1.5+) | string | read-only (null) |
The private enterprise ID.
^([A-Fa-f0-9]{2} ){3}[A-Fa-f0-9]{2}$ |
| } | |||
| HideCommunityStrings (v1.5+) | boolean | read-write (null) |
Indicates if the community strings should
be hidden.
|
| Port | integer | read-write (null) |
The protocol port.
|
| ProtocolEnabled | boolean | read-write (null) |
An indication of whether the protocol is
enabled.
|
| } | |||
| SSDP { | object | The settings for this manager's SSDP
support.
|
|
| NotifyIPv6Scope | string (enum) |
read-write (null) |
The IPv6 scope for multicast NOTIFY
messages for SSDP.
|
| NotifyMulticastIntervalSeconds | integer (seconds) |
read-write (null) |
The time interval, in seconds, between
transmissions of the multicast NOTIFY ALIVE message from this service
for SSDP.
|
| NotifyTTL | integer | read-write (null) |
The time-to-live hop count for SSDP
multicast NOTIFY messages.
|
| Port | integer | read-write (null) |
The protocol port.
|
| ProtocolEnabled | boolean | read-write (null) |
An indication of whether the protocol is
enabled.
|
| } | |||
| SSH {} | object | The settings for this manager's Secure
Shell (SSH) protocol support.
|
|
| Status {} | object | The status and health of the Resource and
its subordinate or dependent Resources.
|
|
| Telnet {} | object | The settings for this manager's Telnet
protocol support.
|
|
| VirtualMedia {} | object | The settings for this manager's virtual
media support that apply to all system instances controlled by this
manager.
|
6.69.4 Property details
6.69.4.1 AccessMode
The access level of the SNMP community.
- This property shall contain the access/privilege level of the SNMP community used to access an SNMP manager.
| string | Description |
|---|---|
| Full | READ-WRITE access mode.
|
| Limited | READ-ONLY access mode.
|
6.69.4.2 AuthenticationProtocol
The authentication protocol used for SNMP access to this manager.
- This property shall contain the SNMP authentication
protocol used to access this manager. When the property contains the
value
Account, the SNMP settings in each manager account are used for authentication.
| string | Description |
|---|---|
| Account | Authentication is determined by account
settings.
|
| CommunityString | SNMP community string
authentication.
|
| HMAC128_SHA224 (v1.7+) | HMAC-128-SHA-224
authentication.
|
| HMAC192_SHA256 (v1.7+) | HMAC-192-SHA-256
authentication.
|
| HMAC256_SHA384 (v1.7+) | HMAC-256-SHA-384
authentication.
|
| HMAC384_SHA512 (v1.7+) | HMAC-384-SHA-512
authentication.
|
| HMAC_MD5 | HMAC-MD5-96 authentication.
|
| HMAC_SHA96 | HMAC-SHA-96 authentication.
|
6.69.4.3 CommunityAccessMode
The access level of the SNMP community.
- This property shall contain the access/privilege level of the SNMP community used to access an SNMP manager.
| string | Description |
|---|---|
| Full | READ-WRITE access mode.
|
| Limited | READ-ONLY access mode.
|
6.69.4.4 EncryptionProtocol
The encryption protocol used for SNMPv3 access to this manager.
- This property shall contain the SNMPv3 encryption
protocol used to access this manager, unless AuthenticationProtocol
contains the value
Account.
| string | Description |
|---|---|
| Account | Encryption is determined by account
settings.
|
| CBC_DES | CBC-DES encryption.
|
| CFB128_AES128 | CFB128-AES-128 encryption.
|
| None | No encryption.
|
6.69.4.5 NotifyIPv6Scope
The IPv6 scope for multicast NOTIFY messages for SSDP.
- This property shall contain the IPv6 scope for multicast NOTIFY messages. The valid enumerations are a subset of the available IPv6 scope types.
| string | Description |
|---|---|
| Link | SSDP NOTIFY messages are sent to addresses in the IPv6 local link scope. |
| Organization | SSDP NOTIFY messages are sent to addresses in the IPv6 local organization scope. |
| Site | SSDP NOTIFY messages are sent to addresses in the IPv6 local site scope. |
6.69.4.6 Protocol
The settings for a network protocol associated with a manager.
| Port | integer | read-write (null) |
The protocol port.
|
| ProtocolEnabled | boolean | read-write (null) |
An indication of whether the protocol is
enabled.
|
6.69.5 Example response
{
"@odata.type": "#ManagerNetworkProtocol.v1_9_1.ManagerNetworkProtocol",
"Id": "NetworkProtocol",
"Name": "Manager Network Protocol",
"Description": "Manager Network Service",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"HostName": "web483-bmc",
"FQDN": "web483-bmc.dmtf.org",
"HTTP": {
"ProtocolEnabled": true,
"Port": 80
},
"HTTPS": {
"ProtocolEnabled": true,
"Port": 443
},
"IPMI": {
"ProtocolEnabled": true,
"Port": 623
},
"SSH": {
"ProtocolEnabled": true,
"Port": 22
},
"SNMP": {
"ProtocolEnabled": true,
"Port": 161
},
"VirtualMedia": {
"ProtocolEnabled": true,
"Port": 17988
},
"SSDP": {
"ProtocolEnabled": true,
"Port": 1900,
"NotifyMulticastIntervalSeconds": 600,
"NotifyTTL": 5,
"NotifyIPv6Scope": "Site"
},
"Telnet": {
"ProtocolEnabled": true,
"Port": 23
},
"KVMIP": {
"ProtocolEnabled": true,
"Port": 5288
},
"@odata.id": "/redfish/v1/Managers/BMC/NetworkProtocol"
}6.70 MediaController 1.3.0 (deprecated)
| Version | v1.3 Deprecated | v1.2 Deprecated | v1.1 | v1.0 |
| Release | 2022.1 | 2021.1 | 2020.2 | 2019.4 |
This schema has been deprecated and use in new implementations is discouraged except to retain compatibility with existing products. This schema has been deprecated in favor of the FabricAdapter schema.
6.70.1 Description
The MediaController schema contains the definition of the media controller and its configuration.
- This resource contains the media controller in a Redfish implementation.
6.70.2 URIs
/redfish/v1/Chassis/{ChassisId}/MediaControllers/{MediaControllerId}
(deprecated)
6.70.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| EnvironmentMetrics (v1.2+) { | object | The link to the environment metrics for
this media controller.
|
|
| @odata.id | string | read-only | Link to a EnvironmentMetrics resource. See the Links section and the EnvironmentMetrics schema for details. |
| } | |||
| 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 media controller.
|
|
| @odata.id | string | read-only | Link to a Endpoint resource. See the Links section and the Endpoint schema for details. |
| } ] | |||
| MemoryDomains [ { | array | An array of links to the memory domains
associated with this media controller.
|
|
| @odata.id | string | read-only | Link to a MemoryDomain resource. See the Links section and the MemoryDomain schema for details. |
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| } | |||
| Manufacturer | string | read-only (null) |
The manufacturer of this media
controller.
|
| MediaControllerType | string (enum) |
read-only (null) |
The type of media controller.
|
| Model | string | read-only (null) |
The model of this media
controller.
|
| PartNumber | string | read-only (null) |
The part number of this media
controller.
|
| Ports { | object | The link to the collection of ports
associated with this media controller.
|
|
| @odata.id | string | read-only | Link to Collection of Port. See the Port schema for details. |
| } | |||
| SerialNumber | string | read-only (null) |
The serial number of this media
controller.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| UUID (v1.1+) | string (uuid) |
read-only (null) |
The UUID for this media
controller.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ |
6.70.4 Actions
6.70.4.1 Reset
Description
This action resets this media controller.
- This action shall reset this media controller.
Action URI
{Base URI of target resource}/Actions/MediaController.Reset
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| ResetType | string (enum) |
optional | The type of reset.
|
Request Example
{
"ResetType": "ForceRestart"
}6.70.5 Property details
6.70.5.1 MediaControllerType
The type of media controller.
- This property shall contain the type of media controller.
| string | Description |
|---|---|
| Memory | The media controller is for
memory.
|
6.70.5.2 ResetType
The type of reset.
- This parameter shall contain the type of reset. The service can accept a request without the parameter and perform an implementation-specific default reset.
| string | Description |
|---|---|
| ForceOff | Turn off the unit immediately
(non-graceful shutdown).
|
| ForceOn | Turn on the unit immediately.
|
| ForceRestart | Shut down immediately and non-gracefully
and restart the system.
|
| GracefulRestart | Shut down gracefully and restart the
system.
|
| GracefulShutdown | Shut down gracefully and power
off.
|
| Nmi | Generate a diagnostic interrupt, which is
usually an NMI on x86 systems, to stop normal operations, complete
diagnostic actions, and, typically, halt the system.
|
| On | Turn on the unit.
|
| Pause | Pause execution on the unit but do not
remove power. This is typically a feature of virtual machine
hypervisors.
|
| PowerCycle | Power cycle the unit. Behaves like a full
power removal, followed by a power restore to the resource.
|
| PushPowerButton | Simulate the pressing of the physical
power button on this unit.
|
| Resume | Resume execution on the paused unit. This
is typically a feature of virtual machine hypervisors.
|
| Suspend | Write the state of the unit to disk before
powering off. This allows for the state to be restored when powered back
on.
|
6.70.6 Example response
{
"@odata.type": "#MediaController.v1_3_0.MediaController",
"Id": "MediaController1",
"Name": "Media Controller 1",
"MediaControllerType": "Memory",
"Manufacturer": "Contoso",
"Model": "Contoso MediaController",
"SerialNumber": "2M220100SL",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"UUID": "41784113-ed6b-2284-1414-916520dc1dd1",
"Ports": {
"@odata.id": "/redfish/v1/Chassis/GenZ/MediaControllers/1/Ports"
},
"Actions": {
"#MediaController.Reset": {
"target": "/redfish/v1/Chassis/GenZ/MediaControllers/1/Actions/MediaController.Reset",
"ResetType@Redfish.AllowableValues": [
"ForceRestart"
]
}
},
"Links": {
"Endpoints": [
{
"@odata.id": "/redfish/v1/Fabrics/GenZ/Endpoints/1"
}
],
"MemoryDomains": [
{
"@odata.id": "/redfish/v1/Chassis/GenZ/MemoryDomains/1"
}
]
},
"@odata.id": "/redfish/v1/Chassis/GenZ/MediaControllers/1"
}6.71 Memory 1.18.0
| Version | v1.18 | v1.17 | v1.16 | v1.15 | v1.14 | v1.13 | v1.12 | v1.11 | v1.10 | v1.9 | v1.8 | ... |
| Release | 2023.2 | 2022.3 | 2022.2 | 2022.1 | 2021.4 | 2021.2 | 2021.1 | 2020.4 | 2020.3 | 2019.4 | 2019.2 | ... |
6.71.1 Description
The Memory schema represents a memory device, such as a DIMM, and its configuration. It also describes the location, such as a slot, socket, or bay, where a unit can be installed, by populating a resource instance with an absent state if a unit is not present.
- This resource
shall represent a memory device in a Redfish implementation. It may also
represent a location, such as a slot, socket, or bay, where a unit may
be installed, but the State property within the Status property contains
Absent.
6.71.2 URIs
/redfish/v1/Chassis/{ChassisId}/Memory/{MemoryId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Memory/{MemoryId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Memory/{MemoryId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Memory/{MemoryId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Memory/{MemoryId}
/redfish/v1/Systems/{ComputerSystemId}/Memory/{MemoryId}
6.71.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AllocationAlignmentMiB (v1.2+) | integer (mebibytes) |
read-only (null) |
The boundary that memory regions are
allocated on, measured in mebibytes (MiB).
|
| AllocationIncrementMiB (v1.2+) | integer (mebibytes) |
read-only (null) |
The size of the smallest unit of
allocation for a memory region in mebibytes (MiB).
|
| AllowedSpeedsMHz [ ] | array (MHz) (integer) |
read-only | Speeds supported by this memory
device.
|
| Assembly (v1.4+) { | object | The link to the assembly resource
associated with this memory device.
|
|
| @odata.id | string | read-only | Link to a Assembly resource. See the Links section and the Assembly schema for details. |
| } | |||
| BaseModuleType | string (enum) |
read-only (null) |
The base module type of the memory
device.
|
| BusWidthBits | integer | read-only (null) |
The bus width, in bits.
|
| CacheSizeMiB (v1.4+) | integer (mebibytes) |
read-only (null) |
Total size of the cache portion memory in
MiB.
|
| CapacityMiB | integer (mebibytes) |
read-only (null) |
Memory capacity in mebibytes
(MiB).
|
| Certificates (v1.11+) { | object | The link to a collection of certificates
for device identity and attestation.
|
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| ConfigurationLocked (v1.7+) | boolean | read-only (null) |
An indication of whether the configuration
of this memory device is locked and cannot be altered.
|
| CXL (v1.17+) { | object | CXL properties for this memory
device.
|
|
| LabelStorageSizeBytes (v1.17+) | integer (bytes) |
read-only | The size of the label storage area in
bytes of this memory device.
|
| StagedNonVolatileSizeMiB (v1.17+) | integer (mebibytes) |
read-write | Total device non-volatile memory capacity
in MiB staged for next activation. The value is in multiples of
256MiB.
|
| StagedVolatileSizeMiB (v1.17+) | integer (mebibytes) |
read-write | Total device volatile memory capacity in
MiB staged for next activation. This value is in multiples of 256
MiB.
|
| } | |||
| DataWidthBits | integer | read-only (null) |
Data width in bits.
|
| DeviceID (deprecated v1.3) | string | read-only (null) |
Device ID.
|
| DeviceLocator (deprecated v1.9) | string | read-only (null) |
Location of the memory device in the
platform.
|
| Enabled (v1.12+) | boolean | read-write | An indication of whether this memory is
enabled.
|
| EnvironmentMetrics (v1.11+) { | object | The link to the environment metrics for
this memory.
|
|
| @odata.id | string | read-only | Link to a EnvironmentMetrics resource. See the Links section and the EnvironmentMetrics schema for details. |
| } | |||
| ErrorCorrection | string (enum) |
read-only (null) |
Error correction scheme supported for this
memory device.
|
| FirmwareApiVersion | string | read-only (null) |
Version of API supported by the
firmware.
|
| FirmwareRevision | string | read-only (null) |
Revision of firmware on the memory
controller.
|
| FunctionClasses (deprecated v1.3) [ ] | array (string) | read-only | Function classes by the memory
device.
|
| HealthData (v1.17+) { | object | The health data of this memory
device.
|
|
| PredictedMediaLifeLeftPercent (v1.17+) | number (%) |
read-only (null) |
The current health of the memory device as
a percentage.
|
| } | |||
| IsRankSpareEnabled | boolean | read-only (null) |
An indication of whether rank spare is
enabled for this memory device.
|
| IsSpareDeviceEnabled | boolean | read-only (null) |
An indication of whether a spare device is
enabled for this memory device.
|
| Links (v1.2+) { | object | The links to other resources that are
related to this resource.
|
|
| Batteries (v1.15+) [ { | array | The batteries that provide power to this
memory device during a power loss event.
|
|
| @odata.id | string | read-only | Link to a Battery resource. See the Links section and the Battery schema for details. |
| } ] | |||
| Chassis (v1.2+) { | object | The link to the chassis that contains this
memory device.
|
|
| @odata.id | string | read-only | Link to a Chassis resource. See the Links section and the Chassis schema for details. |
| } | |||
| Endpoints (v1.17+) [ { | array | An array of links to the endpoints
associated with this memory.
|
|
| @odata.id | string | read-only | Link to a Endpoint resource. See the Links section and the Endpoint schema for details. |
| } ] | |||
| MemoryMediaSources (v1.17+) [ { | array | An array of memory chunks providing media
for this memory.
|
|
| @odata.id | string | read-only | Link to a MemoryChunks resource. See the Links section and the MemoryChunks schema for details. |
| } ] | |||
| MemoryRegionMediaSources (v1.18+) [ { | array | An array of memory regions providing media
for this memory.
|
|
| @odata.id | string | read-only | Link to a MemoryRegion resource. See the Links section and the MemoryRegion schema for details. |
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| Processors (v1.11+) [ { | array | An array of links to the processors
associated with this memory device.
|
|
| @odata.id | string | read-only | Link to a Processor resource. See the Links section and the Processor schema for details. |
| } ] | |||
| } | |||
| Location (v1.4+) {} | object | The location of the memory
device.
|
|
| LocationIndicatorActive (v1.10+) | boolean | read-write (null) |
An indicator allowing an operator to
physically locate this resource.
|
| Log (v1.13+) { | object | The link to the log service associated
with this memory.
|
|
| @odata.id | string | read-only | Link to a LogService resource. See the Links section and the LogService schema for details. |
| } | |||
| LogicalSizeMiB (v1.4+) | integer (mebibytes) |
read-only (null) |
Total size of the logical memory in
MiB.
|
| Manufacturer | string | read-only (null) |
The memory device
manufacturer.
|
| MaxTDPMilliWatts [ ] | array (milliWatts) (integer) |
read-only | Set of maximum power budgets supported by
the memory device in milliwatts.
|
| Measurements (v1.11+, deprecated 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. |
| } ] | |||
| MemoryDeviceType | string (enum) |
read-only (null) |
Type details of the memory
device.
|
| MemoryLocation { | object | Memory connection information to sockets
and memory controllers.
|
|
| Channel | integer | read-only (null) |
The channel number to which the memory
device is connected.
|
| MemoryController | integer | read-only (null) |
The memory controller number to which the
memory device is connected.
|
| Slot | integer | read-only (null) |
The slot number to which the memory device
is connected.
|
| Socket | integer | read-only (null) |
The socket number to which the memory
device is connected.
|
| } | |||
| MemoryMedia [ ] | array (string (enum)) |
read-only |
|
| MemorySubsystemControllerManufacturerID (v1.3+) | string | read-only (null) |
The manufacturer ID of the memory
subsystem controller of this memory device.
^0[xX](([a-fA-F]|[0-9]){2}){2}$ |
| MemorySubsystemControllerProductID (v1.3+) | string | read-only (null) |
The product ID of the memory subsystem
controller of this memory device.
^0[xX](([a-fA-F]|[0-9]){2}){2}$ |
| MemoryType | string (enum) |
read-only (null) |
The type of memory device.
|
| Metrics { | object | The link to the metrics associated with this memory device. 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. |
| } | |||
| Model (v1.11+) | string | read-only (null) |
The product model number of this
device.
|
| ModuleManufacturerID (v1.3+) | string | read-only (null) |
The manufacturer ID of this memory
device.
^0[xX](([a-fA-F]|[0-9]){2}){2}$ |
| ModuleProductID (v1.3+) | string | read-only (null) |
The product ID of this memory
device.
^0[xX](([a-fA-F]|[0-9]){2}){2}$ |
| NonVolatileSizeLimitMiB (v1.17+) | integer (mebibytes) |
read-write | The total non-volatile memory capacity in
mebibytes (MiB).
|
| NonVolatileSizeMiB (v1.4+) | integer (mebibytes) |
read-only (null) |
Total size of the non-volatile portion
memory in MiB.
|
| OperatingMemoryModes [ ] | array (string (enum)) |
read-only |
|
| OperatingSpeedMhz | integer (MHz) |
read-only (null) |
Operating speed of the memory device in
MHz or MT/s as appropriate.
|
| OperatingSpeedRangeMHz (v1.13+) { | object (excerpt) |
Range of allowed operating speeds
(MHz).
|
|
| AllowableMax | number | read-only (null) |
The maximum possible setting for this
control.
|
| AllowableMin | number | read-only (null) |
The minimum possible setting for this
control.
|
| AllowableNumericValues [ ] | array (number, null) | read-only | The supported values for the set
point.
|
| ControlMode | string (enum) |
read-write (null) |
The current operating mode of the
control.
|
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this control.
|
| Reading | number | read-only (null) |
The reading of the sensor associated with
this control.
|
| ReadingUnits | string | read-only (null) |
The units of the sensor reading associated
with this control.
|
| SettingMax | number | read-write (null) |
The maximum set point in the allowed
range.
|
| SettingMin | number | read-write (null) |
The minimum set point in the allowed
range.
|
| } | |||
| PartNumber | string | read-only (null) |
The product part number of this
device.
|
| PersistentRegionNumberLimit (v1.2+) | integer | read-only (null) |
Total number of persistent regions this
memory device can support.
|
| PersistentRegionSizeLimitMiB | integer (mebibytes) |
read-only (null) |
Total size of persistent regions in
mebibytes (MiB).
|
| PersistentRegionSizeMaxMiB (v1.2+) | integer (mebibytes) |
read-only (null) |
Maximum size of a single persistent region
in mebibytes (MiB).
|
| PoisonListMaxMediaErrorRecords (v1.17+) | integer | read-write | The maximum number of media error records
this device can track in its poison list.
|
| PowerManagementPolicy { | object | Power management policy
information.
|
|
| AveragePowerBudgetMilliWatts | integer (milliWatts) |
read-only (null) |
Average power budget, in
milliwatts.
|
| MaxTDPMilliWatts | integer (milliWatts) |
read-only (null) |
Maximum TDP in milliwatts.
|
| PeakPowerBudgetMilliWatts | integer (milliWatts) |
read-only (null) |
Peak power budget, in
milliwatts.
|
| PolicyEnabled | boolean | read-only (null) |
An indication of whether the power
management policy is enabled.
|
| } | |||
| RankCount | integer | read-only (null) |
Number of ranks available in the memory
device.
|
| Regions [ { | array | Memory regions information within the
memory device.
|
|
| MasterPassphraseEnabled (v1.17+) | boolean | read-only (null) |
An indication of whether the master
passphrase is enabled for this region.
|
| MemoryClassification | string (enum) |
read-only (null) |
The classification of memory that the
memory region occupies.
|
| OffsetMiB | integer (mebibytes) |
read-only (null) |
Offset within the memory that corresponds
to the start of this memory region in mebibytes (MiB).
|
| PassphraseEnabled (v1.5+) | boolean | read-only (null) |
An indication of whether the passphrase is
enabled for this region.
|
| PassphraseState (deprecated v1.5) | boolean | read-only (null) |
An indication of whether the state of the
passphrase for this region is enabled.
|
| RegionId | string | read-only (null) |
Unique region ID representing a specific
region within the memory device.
|
| SizeMiB | integer (mebibytes) |
read-only (null) |
Size of this memory region in mebibytes
(MiB).
|
| } ] | |||
| SecurityCapabilities { | object | Security capabilities of the memory
device.
|
|
| ConfigurationLockCapable (v1.7+) | boolean | read-only (null) |
An indication of whether this memory
device supports the locking, or freezing, of the
configuration.
|
| DataLockCapable (v1.7+) | boolean | read-only (null) |
An indication of whether this memory
device supports data locking.
|
| MaxPassphraseCount | integer | read-only (null) |
Maximum number of passphrases supported
for this memory device.
|
| PassphraseCapable | boolean | read-only (null) |
An indication of whether the memory device
is passphrase capable.
|
| PassphraseLockLimit (v1.7+) | integer | read-only (null) |
The maximum number of incorrect passphrase
attempts allowed before memory device is locked.
|
| SecurityStates (deprecated v1.7) [ ] | array (string (enum)) |
read-only |
|
| } | |||
| SecurityState (v1.7+) | string (enum) |
read-write (null) |
The current security state of this memory
device.
|
| SecurityStates (v1.17+) { | object | The security states of this memory
device.
|
|
| MasterPassphraseAttemptCountReached (v1.17+) | boolean | read-only (null) |
An indication of whether an incorrect
master passphrase attempt count has been reached.
|
| UserPassphraseAttemptCountReached (v1.17+) | boolean | read-only (null) |
An indication of whether an incorrect user
passphrase attempt count has been reached.
|
| } | |||
| SerialNumber | string | read-only (null) |
The product serial number of this
device.
|
| SpareDeviceCount | integer | read-only (null) |
Number of unused spare devices available
in the memory device.
|
| SparePartNumber (v1.11+) | string | read-only (null) |
The spare part number of the
memory.
|
| Status (v1.1+) {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| SubsystemDeviceID (deprecated v1.3) | string | read-only (null) |
Subsystem device ID.
|
| SubsystemVendorID (deprecated v1.3) | string | read-only (null) |
SubSystem vendor ID.
|
| VendorID (deprecated v1.3) | string | read-only (null) |
Vendor ID.
|
| VolatileRegionNumberLimit (v1.2+) | integer | read-only (null) |
Total number of volatile regions this
memory device can support.
|
| VolatileRegionSizeLimitMiB | integer (mebibytes) |
read-only (null) |
Total size of volatile regions in
mebibytes (MiB).
|
| VolatileRegionSizeMaxMiB (v1.2+) | integer (mebibytes) |
read-only (null) |
Maximum size of a single volatile region
in mebibytes (MiB).
|
| VolatileSizeLimitMiB (v1.17+) | integer (mebibytes) |
read-write | The total volatile memory capacity in
mebibytes (MiB).
|
| VolatileSizeMiB (v1.4+) | integer (mebibytes) |
read-only (null) |
Total size of the volatile portion memory
in MiB.
|
6.71.4 Actions
6.71.4.1 DisableMasterPassphrase (v1.17+)
Description
Disables the master passphrase for given region.
- This action shall disable the master passphrase on the supplied region provided the supplied master passphrase matches that of the region.
Action URI
{Base URI of target resource}/Actions/Memory.DisableMasterPassphrase
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| Passphrase | string | required | The master passphrase for the specified
region.
|
| RegionId | string | required | The memory region ID to which to disable
the master passphrase.
|
Request Example
{
"Passphrase": "FluffyBunny",
"RegionId": 2
}6.71.4.2 DisablePassphrase
Description
Disable passphrase for given regions.
- This action shall disable the need for passphrases on the supplied region provided the supplied passphrase matches that of the region.
Action URI
{Base URI of target resource}/Actions/Memory.DisablePassphrase
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| Passphrase | string | required | Passphrase for doing the
operation.
|
| RegionId | string | required | The memory region ID to which to apply
this action.
|
Request Example
{
"Passphrase": "FluffyBunny",
"RegionId": 2
}6.71.4.3 FreezeSecurityState (v1.17+)
Description
Freezes the security state of the memory device.
- This action shall freeze the security state of the memory device.
Action URI
{Base URI of target resource}/Actions/Memory.FreezeSecurityState
Action parameters
This action takes no parameters.
6.71.4.4 InjectPersistentPoison (v1.17+)
Description
Injects poison to a specific persistent memory address in the memory device.
- This action shall inject poison to a specific persistent memory address in the memory device.
Action URI
{Base URI of target resource}/Actions/Memory.InjectPersistentPoison
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| PhysicalAddress | string | required | The device persistent physical address in
which to perform a poison injection as a hex-encoded string.
^0x[0-9a-fA-F]+$ |
Request Example
{
"PhysicalAddress": "0x8000000"
}6.71.4.5 OverwriteUnit (v1.6+)
Description
This contains the action for securely erasing given regions using the NIST SP800-88 Purge: Overwrite.
- This action shall securely erase the supplied region provided the supplied passphrase matches that of the given region using the NIST SP800-88 Purge: Overwrite. Use the SecureEraseUnit method to perform NIST SP800-88 Purge: Cryptographic Erase.
Action URI
{Base URI of target resource}/Actions/Memory.OverwriteUnit
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| Passphrase | string | required | Passphrase for doing the
operation.
|
| RegionId | string | required | The memory region ID to which to apply
this action.
|
Request Example
{
"Passphrase": "FluffyBunny",
"RegionId": 2
}6.71.4.6 Reset (v1.8+)
Description
This action resets this memory device.
- This action shall reset this memory device.
Action URI
{Base URI of target resource}/Actions/Memory.Reset
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| ResetType | string (enum) |
optional | The type of reset.
|
Request Example
{
"ResetType": "ForceRestart"
}6.71.4.7 ResetToDefaults (v1.16+)
Description
The action resets the values of writable properties to factory defaults.
- This action shall reset the values of writable properties in this resource to their default values as specified by the manufacturer.
Action URI
{Base URI of target resource}/Actions/Memory.ResetToDefaults
Action parameters
This action takes no parameters.
6.71.4.8 ScanMedia (v1.17+)
Description
Scans the media of the memory device.
- This action shall scan the media of the memory device.
Action URI
{Base URI of target resource}/Actions/Memory.ScanMedia
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| Length | integer | required | The length of the target region to scan in
bytes from the physical address.
|
| NoEventLog | boolean | optional | Indicates whether events related to the
media scan are not logged.
|
| PhysicalAddress | string | required | The starting device physical address to
scan as a hex-encoded string.
^0x[0-9a-fA-F]+$ |
Request Example
{
"PhysicalAddress": "0x8000000",
"Length": 2097152
}6.71.4.9 SecureEraseUnit
Description
This contains the action for securely erasing given regions using the NIST SP800-88 Purge: Cryptographic Erase.
- This action shall securely erase the supplied region provided the supplied passphrase matches that of the given region using the NIST SP800-88 Purge: Cryptographic Erase. Use the OverwriteUnit method to perform NIST SP800-88 Purge: Overwrite.
Action URI
{Base URI of target resource}/Actions/Memory.SecureEraseUnit
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| Passphrase | string | required | Passphrase for doing the
operation.
|
| RegionId | string | required | The memory region ID to which to apply
this action.
|
Request Example
{
"Passphrase": "FluffyBunny",
"RegionId": 2
}6.71.4.10 SetMasterPassphrase (v1.17+)
Description
Sets the master passphrase for the given region.
- This action shall set the supplied master passphrase to the supplied region.
Action URI
{Base URI of target resource}/Actions/Memory.SetMasterPassphrase
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| Passphrase | string | required | The master passphrase to set for the
specified region.
|
| RegionId | string | required | The memory region ID to which to apply the
master passphrase.
|
Request Example
{
"Passphrase": "FluffyBunny",
"RegionId": 2
}6.71.4.11 SetPassphrase
Description
Set passphrase for the given regions.
- This action shall apply the supplied passphrase to the supplied region.
Action URI
{Base URI of target resource}/Actions/Memory.SetPassphrase
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| Passphrase | string | required | Passphrase for doing the
operation.
|
| RegionId | string | required | The memory region ID to which to apply
this action.
|
Request Example
{
"Passphrase": "FluffyBunny",
"RegionId": 2
}6.71.4.12 UnlockUnit
Description
This contains the action for unlocking given regions.
- This action shall apply the supplied passphrase to the supplied region for the purpose of unlocking the given regions.
Action URI
{Base URI of target resource}/Actions/Memory.UnlockUnit
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| Passphrase | string | required | The passphrase required to complete the
operation.
|
| RegionId | string | required | The memory region ID to which to apply
this action.
|
Request Example
{
"Passphrase": "FluffyBunny",
"RegionId": 2
}6.71.5 Property details
6.71.5.1 BaseModuleType
The base module type of the memory device.
- This property shall contain the base module type of the memory device.
| string | Description |
|---|---|
| Die (v1.7+) | A die within a package. |
| LRDIMM | Load Reduced. |
| Mini_RDIMM | Mini_RDIMM. |
| Mini_UDIMM | Mini_UDIMM. |
| RDIMM | Registered DIMM. |
| SO_DIMM | SO_DIMM. |
| SO_DIMM_16b | SO_DIMM_16b. |
| SO_DIMM_32b | SO_DIMM_32b. |
| SO_RDIMM_72b | SO_RDIMM_72b. |
| SO_UDIMM_72b | SO_UDIMM_72b. |
| UDIMM | UDIMM. |
6.71.5.2 ControlMode
The current operating mode of the control.
- This property shall contain the operating mode of the control.
| string | Description |
|---|---|
| Automatic | Automatically adjust control to meet the set point. |
| Disabled | The control has been disabled. |
| Manual | No automatic adjustments are made to the control. |
| Override | User override of the automatic set point value. |
6.71.5.3 ErrorCorrection
Error correction scheme supported for this memory device.
- This property shall contain the error correction scheme supported for this memory device.
| string | Description |
|---|---|
| AddressParity | Address parity errors can be corrected. |
| MultiBitECC | Multibit data errors can be corrected by ECC. |
| NoECC | No ECC available. |
| SingleBitECC | Single bit data errors can be corrected by ECC. |
6.71.5.4 MemoryClassification
The classification of memory that the memory region occupies.
- This property shall contain the classification of memory that the memory region occupies.
| string | Description |
|---|---|
| Block | Block-accessible memory. |
| ByteAccessiblePersistent | Byte-accessible persistent memory. |
| Volatile | Volatile memory. |
6.71.5.5 MemoryDeviceType
Type details of the memory device.
- This property shall contain the Memory Device Type as defined by SMBIOS.
| string | Description |
|---|---|
| DDR | DDR. |
| DDR2 | DDR2. |
| DDR2_SDRAM | DDR2 SDRAM. |
| DDR2_SDRAM_FB_DIMM | DDR2 SDRAM FB_DIMM. |
| DDR2_SDRAM_FB_DIMM_PROBE | DDR2 SDRAM FB_DIMM PROBE. |
| DDR3 | DDR3. |
| DDR3_SDRAM | DDR3 SDRAM. |
| DDR4 | DDR4. |
| DDR4_SDRAM | DDR4 SDRAM. |
| DDR4E_SDRAM | DDR4E SDRAM. |
| DDR5 (v1.11+) | Double data rate type five synchronous dynamic random-access memory. |
| DDR_SDRAM | DDR SDRAM. |
| DDR_SGRAM | DDR SGRAM. |
| EDO | EDO. |
| FastPageMode | Fast Page Mode. |
| GDDR (v1.11+) | Synchronous graphics random-access memory. |
| GDDR2 (v1.11+) | Double data rate type two synchronous graphics random-access memory. |
| GDDR3 (v1.11+) | Double data rate type three synchronous graphics random-access memory. |
| GDDR4 (v1.11+) | Double data rate type four synchronous graphics random-access memory. |
| GDDR5 (v1.11+) | Double data rate type five synchronous graphics random-access memory. |
| GDDR5X (v1.11+) | Double data rate type five X synchronous graphics random-access memory. |
| GDDR6 (v1.11+) | Double data rate type six synchronous graphics random-access memory. |
| HBM (v1.7+) | High Bandwidth Memory. |
| HBM2 (v1.7+) | The second generation of High Bandwidth Memory. |
| HBM2E (v1.17+) | An updated version of the second generation of High Bandwidth Memory. |
| HBM3 (v1.11+) | The third generation of High Bandwidth Memory. |
| Logical (v1.4+) | Logical device, such as when the memory is fabric-attached. |
| LPDDR3_SDRAM | LPDDR3 SDRAM. |
| LPDDR4_SDRAM | LPDDR4 SDRAM. |
| OEM (v1.11+) | OEM-defined. |
| PipelinedNibble | Pipelined Nibble. |
| ROM | ROM. |
| SDRAM | SDRAM. |
6.71.5.6 MemoryMedia
- Media of this memory device.
- This property shall contain the media types of this memory device.
| string | Description |
|---|---|
| DRAM | DRAM media. |
| Intel3DXPoint | Intel 3D XPoint media. |
| NAND | NAND media. |
| Proprietary | Proprietary media. |
6.71.5.7 MemoryType
The type of memory device.
- This property shall contain the type of memory device that this resource represents.
| string | Description |
|---|---|
| DRAM | The memory device is comprised of volatile
memory.
|
| IntelOptane (v1.6+) | The memory device is an Intel Optane
Persistent Memory Module.
|
| NVDIMM_F | The memory device is comprised of
non-volatile memory.
|
| NVDIMM_N | The memory device is comprised of volatile
memory backed by non-volatile memory.
|
| NVDIMM_P | The memory device is comprised of a
combination of non-volatile and volatile memory.
|
6.71.5.8 OperatingMemoryModes
- Memory modes supported by the memory device.
- This property shall contain the memory modes supported by the memory device.
| string | Description |
|---|---|
| Block | Block-accessible system memory. |
| PMEM | Persistent memory, byte-accessible through system address space. |
| Volatile | Volatile memory. |
6.71.5.9 ResetType
The type of reset.
- This parameter shall contain the type of reset. The service can accept a request without the parameter and perform an implementation specific default reset.
| string | Description |
|---|---|
| ForceOff | Turn off the unit immediately
(non-graceful shutdown).
|
| ForceOn | Turn on the unit immediately.
|
| ForceRestart | Shut down immediately and non-gracefully
and restart the system.
|
| GracefulRestart | Shut down gracefully and restart the
system.
|
| GracefulShutdown | Shut down gracefully and power
off.
|
| Nmi | Generate a diagnostic interrupt, which is
usually an NMI on x86 systems, to stop normal operations, complete
diagnostic actions, and, typically, halt the system.
|
| On | Turn on the unit.
|
| Pause | Pause execution on the unit but do not
remove power. This is typically a feature of virtual machine
hypervisors.
|
| PowerCycle | Power cycle the unit. Behaves like a full
power removal, followed by a power restore to the resource.
|
| PushPowerButton | Simulate the pressing of the physical
power button on this unit.
|
| Resume | Resume execution on the paused unit. This
is typically a feature of virtual machine hypervisors.
|
| Suspend | Write the state of the unit to disk before
powering off. This allows for the state to be restored when powered back
on.
|
6.71.5.10 SecurityState
The current security state of this memory device.
- This property shall contain the current security state of this memory device.
| string | Description |
|---|---|
| Disabled | Secure mode is disabled. |
| Enabled | Secure mode is enabled and access to the data is allowed. |
| Frozen (deprecated v1.7) | Secure state is frozen and cannot be modified until reset. Deprecated in v1.7 and later. This value has been deprecated in favor of using the ConfigurationLocked to indicate that the configuration has been frozen. |
| Locked | Secure mode is enabled and access to the data is locked. |
| Passphraselimit | Number of attempts to unlock the memory exceeded limit. |
| Unlocked (deprecated v1.7) | Secure mode is enabled and access to the data is unlocked. Deprecated in v1.7 and later. This value has been deprecated in favor of 'Enabled' to indicate normal security operation. |
6.71.5.11 SecurityStates
- Security states supported by the memory device.
- This property shall contain the security states supported by the memory device.
| string | Description |
|---|---|
| Disabled | Secure mode is disabled. |
| Enabled | Secure mode is enabled and access to the data is allowed. |
| Frozen | Secure state is frozen and cannot be modified until reset. |
| Locked | Secure mode is enabled and access to the data is locked. |
| Passphraselimit | Number of attempts to unlock the memory exceeded limit. |
| Unlocked | Secure mode is enabled and access to the data is unlocked. |
6.71.6 Example response
{
"@odata.type": "#Memory.v1_18_0.Memory",
"Name": "Regular Memory",
"Id": "1",
"RankCount": 1,
"MaxTDPMilliWatts": [
12000
],
"CapacityMiB": 8192,
"DataWidthBits": 64,
"BusWidthBits": 72,
"ErrorCorrection": "MultiBitECC",
"MemoryLocation": {
"Socket": 1,
"MemoryController": 1,
"Channel": 1,
"Slot": 1
},
"MemoryType": "DRAM",
"MemoryDeviceType": "DDR4",
"BaseModuleType": "RDIMM",
"MemoryMedia": [
"DRAM"
],
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Metrics": {
"@odata.id": "/redfish/v1/Systems/437XR1138R2/Memory/1/MemoryMetrics"
},
"EnvironmentMetrics": {
"@odata.id": "/redfish/v1/Systems/437XR1138R2/Memory/1/EnvironmentMetrics"
},
"Location": {
"PartLocation": {
"ServiceLabel": "Socket 1_A",
"LocationType": "Socket",
"LocationOrdinalValue": 0
}
},
"@odata.id": "/redfish/v1/Systems/437XR1138R2/Memory/1"
}6.72 MemoryChunks 1.6.0
| Version | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2023.2 | 2022.3 | 2020.3 | 2019.4 | 2017.3 | 2017.1 | 2016.2 |
6.72.1 Description
The schema definition of a memory chunk and its configuration.
- This resource shall represent memory chunks and interleave sets in a Redfish implementation.
6.72.2 URIs
/redfish/v1/Chassis/{ChassisId}/MemoryDomains/{MemoryDomainId}/MemoryChunks/{MemoryChunksId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/MemoryDomains/{MemoryDomainId}/MemoryChunks/{MemoryChunksId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/MemoryDomains/{MemoryDomainId}/MemoryChunks/{MemoryChunksId}
/redfish/v1/Systems/{ComputerSystemId}/MemoryDomains/{MemoryDomainId}/MemoryChunks/{MemoryChunksId}
6.72.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AddressRangeOffsetMiB (v1.3+) | integer (mebibytes) |
read-only (null) |
Offset of the memory chunk in the address
range in MiB.
|
| AddressRangeType | string (enum) |
read-only required (null) |
Memory type of this memory
chunk.
|
| DisplayName (v1.4+) | string | read-write (null) |
A user-configurable string to name the
memory chunk.
|
| InterleaveSets [ { | array | The interleave sets for the memory
chunk.
|
|
| Memory { | object | Describes a memory device of the
interleave set.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } | |||
| MemoryLevel | integer | read-only (null) |
Level of the interleave set for
multi-level tiered memory.
|
| OffsetMiB | integer (mebibytes) |
read-only (null) |
Offset within the DIMM that corresponds to
the start of this memory region, measured in mebibytes
(MiB).
|
| RegionId | string | read-only (null) |
DIMM region identifier.
|
| SizeMiB | integer (mebibytes) |
read-only (null) |
Size of this memory region measured in
mebibytes (MiB).
|
| } ] | |||
| IsMirrorEnabled | boolean | read-only (null) |
An indication of whether memory mirroring
is enabled for this memory chunk.
|
| IsSpare | boolean | read-only (null) |
An indication of whether sparing is
enabled for this memory chunk.
|
| Links (v1.3+) { | object | The links to other resources that are
related to this resource.
|
|
| CXLLogicalDevices (v1.5+) [ { | array | An array of links to the CXL logical
devices associated with this memory chunk.
|
|
| @odata.id | string | read-only | Link to a CXLLogicalDevice resource. See the Links section and the CXLLogicalDevice schema for details. |
| } ] | |||
| Endpoints (v1.3+) [ { | array | An array of links to the endpoints that
connect to this memory chunk.
|
|
| @odata.id | string | read-only | Link to a Endpoint resource. See the Links section and the Endpoint schema for details. |
| } ] | |||
| MemoryRegions (v1.6+) [ { | array | An array of links to the memory regions
for which this memory chunk provides capacity.
|
|
| @odata.id | string | read-only | Link to a MemoryRegion resource. See the Links section and the MemoryRegion schema for details. |
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| } | |||
| MediaLocation (v1.5+) | string (enum) |
read-write (null) |
The location of the memory media for this
memory chunk.
|
| MemoryChunkSizeMiB | integer (mebibytes) |
read-only (null) |
Size of the memory chunk measured in
mebibytes (MiB).
|
| RequestedOperationalState (v1.5+) | string (enum) |
read-write (null) |
The requested operational state of this
memory chunk.
|
| Status (v1.2+) {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
6.72.4 Property details
6.72.4.1 AddressRangeType
Memory type of this memory chunk.
- This property shall contain the type of memory chunk.
| string | Description |
|---|---|
| Block | Block accessible memory. |
| PMEM | Byte accessible persistent memory. |
| Volatile | Volatile memory. |
6.72.4.2 MediaLocation
The location of the memory media for this memory chunk.
- This property shall contain the location of the memory media for this memory chunk.
| string | Description |
|---|---|
| Local | The memory chunk was created using local media. |
| Mixed | The memory chunk was created using both local media and remote media accessible through a fabric. |
| Remote | The memory chunk was created using remote media accessible through a fabric. |
6.72.4.3 RequestedOperationalState
The requested operational state of this memory chunk.
- This property shall contain the requested operational state of this memory chunk.
| string | Description |
|---|---|
| Offline | Memory chunk cannot be used. Consumers of this memory chunk should perform cleanup operations as needed to prepare for the removal of this memory chunk. |
| Online | Memory chunk can be used. |
6.72.5 Example response
{
"@odata.type": "#MemoryChunks.v1_6_0.MemoryChunks",
"Name": "Memory Chunk - Whole System",
"Id": "1",
"MemoryChunkSizeMiB": 32768,
"AddressRangeType": "Volatile",
"IsMirrorEnabled": false,
"IsSpare": false,
"InterleaveSets": [
{
"Memory": {
"@odata.id": "/redfish/v1/Systems/2/Memory/1"
}
},
{
"Memory": {
"@odata.id": "/redfish/v1/Systems/2/Memory/2"
}
},
{
"Memory": {
"@odata.id": "/redfish/v1/Systems/2/Memory/3"
}
},
{
"Memory": {
"@odata.id": "/redfish/v1/Systems/2/Memory/4"
}
}
],
"@Redfish.Settings": {
"@odata.type": "#Settings.v1_3_5.Settings",
"SettingsObject": {
"@odata.id": "/redfish/v1/Systems/2/MemoryDomains/1/MemoryChunks/1/SD"
},
"Time": "2012-03-07T14:44.30-05:00",
"ETag": "someetag",
"Messages": [
{
"MessageId": "Base.1.0.Success"
}
]
},
"@odata.id": "/redfish/v1/Systems/2/MemoryDomains/1/MemoryChunks/1"
}6.73 MemoryDomain 1.5.0
| Version | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2022.3 | 2022.1 | 2019.4 | 2017.1 | 2016.3 | 2016.2 |
6.73.1 Description
The MemoryDomain schema describes a memory domain and its configuration. Memory domains indicate to the client which memory, or DIMMs, can be grouped together in memory chunks to represent addressable memory.
- This Resource shall represent memory domains in a Redfish implementation.
6.73.2 URIs
/redfish/v1/Chassis/{ChassisId}/MemoryDomains/{MemoryDomainId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/MemoryDomains/{MemoryDomainId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/MemoryDomains/{MemoryDomainId}
/redfish/v1/Systems/{ComputerSystemId}/MemoryDomains/{MemoryDomainId}
6.73.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AllowsBlockProvisioning | boolean | read-only (null) |
An indication of whether this memory
domain supports the provisioning of blocks of memory.
|
| AllowsMemoryChunkCreation | boolean | read-only (null) |
An indication of whether this memory
domain supports the creation of memory chunks.
|
| AllowsMirroring (v1.1+) | boolean | read-only (null) |
An indication of whether this memory
domain supports the creation of memory chunks with mirroring
enabled.
|
| AllowsSparing (v1.1+) | boolean | read-only (null) |
An indication of whether this memory
domain supports the creation of memory chunks with sparing
enabled.
|
| InterleavableMemorySets [ { | array | The interleave sets for the memory
chunk.
|
|
| MemorySet [ { | array | The set of memory for a particular
interleave set.
|
|
| @odata.id | string | read-only | Link to a Memory resource. See the Links section and the Memory schema for details. |
| } ] | |||
| } ] | |||
| Links (v1.3+) { | object | The links to other Resources that are
related to this Resource.
|
|
| CXLLogicalDevices (v1.5+) [ { | array | An array of links to the CXL logical
devices associated with this memory domain.
|
|
| @odata.id | string | read-only | Link to a CXLLogicalDevice resource. See the Links section and the CXLLogicalDevice schema for details. |
| } ] | |||
| FabricAdapters (v1.5+) [ { | array | An array of links to the fabric adapters
that present this memory domain to a fabric.
|
|
| @odata.id | string | read-only | Link to a FabricAdapter resource. See the Links section and the FabricAdapter schema for details. |
| } ] | |||
| MediaControllers (v1.3+, deprecated v1.4 [ { | array | An array of links to the media controllers
for this memory domain.
|
|
| @odata.id | string | read-only | Link to a MediaController resource. See the Links section and the MediaController schema for details. |
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| PCIeFunctions (v1.5+) [ { | array | An array of links to the PCIe functions
representing this memory domain.
|
|
| @odata.id | string | read-only | Link to a PCIeFunction resource. See the Links section and the PCIeFunction schema for details. |
| } ] | |||
| } | |||
| MemoryChunkIncrementMiB (v1.5+) | integer (mebibytes) |
read-only (null) |
The incremental size, from the minimum
size, allowed for a memory chunk within this domain in mebibytes
(MiB).
|
| MemoryChunks { | object | The link to the collection of memory
chunks associated with this memory domain.
|
|
| @odata.id | string | read-only | Link to Collection of MemoryChunks. See the MemoryChunks schema for details. |
| } | |||
| MemorySizeMiB (v1.5+) | integer (mebibytes) |
read-only (null) |
The total size of the memory domain in
mebibytes (MiB).
|
| MinMemoryChunkSizeMiB (v1.5+) | integer (mebibytes) |
read-only (null) |
The minimum size allowed for a memory
chunk within this domain in mebibytes (MiB).
|
| Status (v1.5+) {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
6.73.4 Example response
{
"@odata.type": "#MemoryDomain.v1_5_0.MemoryDomain",
"Name": "Memory Domain - Whole System Mirroring Only",
"Id": "1",
"MemoryChunks": {
"@odata.id": "/redfish/v1/Systems/4/MemoryDomains/1/MemoryChunks"
},
"AllowsMemoryChunkCreation": false,
"AllowsBlockProvisioning": false,
"InterleavableMemorySets": [
{
"MemorySet": [
{
"@odata.id": "/redfish/v1/Systems/2/Memory/1"
},
{
"@odata.id": "/redfish/v1/Systems/2/Memory/2"
},
{
"@odata.id": "/redfish/v1/Systems/2/Memory/3"
},
{
"@odata.id": "/redfish/v1/Systems/2/Memory/4"
}
]
}
],
"@odata.id": "/redfish/v1/Systems/2/MemoryDomains/1"
}6.74 MemoryMetrics 1.7.1
| Version | v1.7 | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2023.1 | 2022.3 | 2022.1 | 2020.3 | 2020.1 | 2019.2 | 2016.2 | 2016.1 |
6.74.1 Description
The usage and health statistics for a memory device or system memory summary.
- The MemoryMetrics schema shall contain the memory metrics for a memory device or system memory summary in a Redfish implementation.
6.74.2 URIs
/redfish/v1/Chassis/{ChassisId}/Memory/{MemoryId}/MemoryMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Memory/{MemoryId}/MemoryMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/MemorySummary/MemoryMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Memory/{MemoryId}/MemoryMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/MemorySummary/MemoryMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/MemorySummary/MemoryMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Memory/{MemoryId}/MemoryMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/MemorySummary/MemoryMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Memory/{MemoryId}/MemoryMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/MemorySummary/MemoryMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/MemorySummary/MemoryMetrics
/redfish/v1/Systems/{ComputerSystemId}/Memory/{MemoryId}/MemoryMetrics
/redfish/v1/Systems/{ComputerSystemId}/MemorySummary/MemoryMetrics
/redfish/v1/Systems/{ComputerSystemId}/Processors/{ProcessorId}/MemorySummary/MemoryMetrics
6.74.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| BandwidthPercent (v1.2+) | number (%) |
read-only (null) |
The memory bandwidth utilization as a
percentage.
|
| BlockSizeBytes | integer (bytes) |
read-only (null) |
The block size, in bytes.
|
| CapacityUtilizationPercent (v1.7+) | number (%) |
read-only (null) |
The memory capacity utilization as a
percentage.
|
| CorrectedPersistentErrorCount (v1.6+) | integer | read-only (null) |
The number of corrected errors in
persistent memory.
|
| CorrectedVolatileErrorCount (v1.6+) | integer | read-only (null) |
The number of corrected errors in volatile
memory.
|
| CurrentPeriod { | object | The memory metrics since the last reset or
ClearCurrentPeriod action.
|
|
| BlocksRead | integer | read-only (null) |
The number of blocks read since
reset.
|
| BlocksWritten | integer | read-only (null) |
The number of blocks written since
reset.
|
| CorrectableECCErrorCount (v1.4+) | integer | read-only (null) |
The number of the correctable errors since
reset.
|
| IndeterminateCorrectableErrorCount (v1.5+) | integer | read-only (null) |
The number of indeterminate correctable
errors since reset.
|
| IndeterminateUncorrectableErrorCount (v1.5+) | integer | read-only (null) |
The number of indeterminate uncorrectable
errors since reset.
|
| UncorrectableECCErrorCount (v1.4+) | integer | read-only (null) |
The number of the uncorrectable errors
since reset.
|
| } | |||
| CXL (v1.6+) { | object | (null) |
The memory metrics specific to CXL
devices.
|
| AlertCapabilities (v1.6+) { | object | (null) |
The conditions that would generate an
alert to the CXL Fabric Manager or host.
|
| CorrectableECCError (v1.6+) | boolean | read-only (null) |
Indicates whether correctable ECC errors
generate an alert to the CXL Fabric Manager or host.
|
| SpareBlock (v1.6+) | boolean | read-only (null) |
Indicates whether spare block conditions
generate an alert to the CXL Fabric Manager or host.
|
| Temperature (v1.6+) | boolean | read-only (null) |
Indicates whether temperature conditions
generate an alert to the CXL Fabric Manager or host.
|
| UncorrectableECCError (v1.6+) | boolean | read-only (null) |
Indicates whether uncorrectable ECC errors
generate an alert to the CXL Fabric Manager or host.
|
| } | |||
| } | |||
| DirtyShutdownCount (v1.6+) | integer | read-only (null) |
The number of shutdowns while outstanding
writes have not completed to persistent memory.
|
| HealthData { | object | The health information of the
memory.
|
|
| AlarmTrips { | object | Alarm trip information about the
memory.
|
|
| AddressParityError | boolean | read-only (null) |
An indication of whether an address parity
error was detected that a retry could not correct.
|
| CorrectableECCError | boolean | read-only (null) |
An indication of whether the correctable
error threshold crossing alarm trip was detected.
|
| SpareBlock | boolean | read-only (null) |
An indication of whether the spare block
capacity crossing alarm trip was detected.
|
| Temperature | boolean | read-only (null) |
An indication of whether a temperature
threshold alarm trip was detected.
|
| UncorrectableECCError | boolean | read-only (null) |
An indication of whether the uncorrectable
error threshold alarm trip was detected.
|
| } | |||
| DataLossDetected | boolean | read-only (null) |
An indication of whether data loss was
detected.
|
| LastShutdownSuccess | boolean | read-only (null) |
An indication of whether the last shutdown
succeeded.
|
| PerformanceDegraded | boolean | read-only (null) |
An indication of whether performance has
degraded.
|
| PredictedMediaLifeLeftPercent (v1.1+) | number (%) |
read-only (null) |
The percentage of reads and writes that
are predicted to still be available for the media.
|
| RemainingSpareBlockPercentage | number (%) |
read-only (null) |
The remaining spare blocks, as a
percentage.
|
| } | |||
| LifeTime { | object | The memory metrics for the lifetime of the
memory.
|
|
| BlocksRead | integer | read-only (null) |
The number of blocks read for the lifetime
of the memory.
|
| BlocksWritten | integer | read-only (null) |
The number of blocks written for the
lifetime of the memory.
|
| CorrectableECCErrorCount (v1.4+) | integer | read-only (null) |
The number of the correctable errors for
the lifetime of the memory.
|
| IndeterminateCorrectableErrorCount (v1.5+) | integer | read-only (null) |
The number of indeterminate correctable
errors for the lifetime of the memory.
|
| IndeterminateUncorrectableErrorCount (v1.5+) | integer | read-only (null) |
The number of indeterminate uncorrectable
errors for the lifetime of the memory.
|
| UncorrectableECCErrorCount (v1.4+) | integer | read-only (null) |
The number of the uncorrectable errors for
the lifetime of the memory.
|
| } | |||
| OperatingSpeedMHz (v1.3+) | integer (MHz) |
read-only (null) |
Operating speed of memory in MHz or MT/s
as appropriate.
|
6.74.4 Actions
6.74.4.1 ClearCurrentPeriod
Description
This action sets the CurrentPeriod property's values to 0.
- This action shall set the CurrentPeriod property's values to 0.
Action URI
{Base URI of target resource}/Actions/MemoryMetrics.ClearCurrentPeriod
Action parameters
This action takes no parameters.
6.74.5 Example response
{
"@odata.type": "#MemoryMetrics.v1_7_1.MemoryMetrics",
"Name": "Memory Metrics",
"Id": "Metrics",
"BlockSizeBytes": 4096,
"CurrentPeriod": {
"BlocksRead": 0,
"BlocksWritten": 0
},
"LifeTime": {
"BlocksRead": 0,
"BlocksWritten": 0
},
"HealthData": {
"RemainingSpareBlockPercentage": 50,
"LastShutdownSuccess": true,
"DataLossDetected": false,
"PerformanceDegraded": false,
"AlarmTrips": {
"Temperature": true,
"SpareBlock": false,
"UncorrectableECCError": false,
"CorrectableECCError": false
}
},
"Actions": {
"#MemoryMetrics.ClearCurrentPeriod": {
"target": "/redfish/v1/Systems/1/Memory/1/Actions/MemoryMetrics.ClearCurrentPeriod"
}
},
"@odata.id": "/redfish/v1/Systems/1/Memory/1/MemoryMetrics"
}6.75 MemoryRegion 1.0.0
| Version | v1.0 |
| Release | 2023.2 |
6.75.1 Description
The schema definition of a memory region and its configuration.
- This resource shall represent memory region in a Redfish implementation.
6.75.2 URIs
/redfish/v1/Chassis/{ChassisId}/PCIeDevices/{PCIeDeviceId}/CXLLogicalDevices/{CXLLogicalDeviceId}/MemoryRegions/{MemoryRegionId}
6.75.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| BlockSizeMiB | integer (mebibytes) |
read-write | The memory region block size in mebibytes
(MiB).
|
| ExtentsCount | integer | read-only (null) |
The number of extents defined for this
memory region.
|
| HardwareManagedCoherencyRegion | boolean | read-only (null) |
An indication of whether the device
manages the cache coherency across hosts for this memory
region.
|
| MemoryChunks [ { | array | The set of memory chunks providing
capacity for this memory region.
|
|
| ChunkLink { | object | The link to the memory chunk providing
capacity to the memory region.
|
|
| @odata.id | string | read-only | Link to a MemoryChunks resource. See the Links section and the MemoryChunks schema for details. |
| } | |||
| ChunkOffsetMiB | integer (mebibytes) |
read-only | Offset of the memory chunk within the
memory region in mebibytes (MiB).
|
| } ] | |||
| MemoryExtents [ { | array | The set of memory extents defined for this
memory region.
|
|
| ExtentOffsetMiB | integer (mebibytes) |
read-only | Offset of the memory extent within the
memory region in mebibytes (MiB).
|
| ExtentSizeMiB | integer (mebibytes) |
read-only | Size of the memory extent in mebibytes
(MiB).
|
| SequenceNumber | integer | read-only (null) |
The memory extent sequence
number.
|
| Tag | string | read-only | The user-assigned tag of this memory
extent.
|
| } ] | |||
| NonVolatileRegion | boolean | read-only (null) |
An indication of whether memory region
represents non-volatile memory.
|
| RegionBaseOffetMiB | integer (mebibytes) |
read-only | The offset of the memory region in the
device address range in mebibytes (MiB).
|
| RegionNumber | integer | read-only | The memory region number.
|
| RegionSizeMiB | integer (mebibytes) |
read-only | The size of the memory region in mebibytes
(MiB).
|
| RegionType | string (enum) |
read-only required | The type of memory region.
|
| SanitizeOnRelease | boolean | read-write (null) |
An indication of whether the capacity
released from this memory region will be sanitized before it is made
available to any host.
|
| ShareableRegion | boolean | read-only (null) |
An indication of whether memory region can
be shared across multiple hosts.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
6.75.4 Property details
6.75.4.1 RegionType
The type of memory region.
- This property shall contain the type of memory region.
| string | Description |
|---|---|
| Dynamic | Dynamic memory region. The address range coverage may be changes in the runtime. |
| Static | Static memory region. The whole address range is always covered by memory. |
6.75.5 Example response
{
"@odata.type": "#MemoryRegion.v1_0_0.MemoryRegion",
"Id": "1",
"Name": "Dynamic Memory Region 1",
"Description": "CXL Dynamic Memory Region 1 of LD 1 in Device 1",
"Status": {
"State": "Enabled",
"Health": "OK",
"HealthRollup": "OK"
},
"RegionType": "Dynamic",
"RegionNumber": 0,
"RegionBaseOffetMiB": 0,
"RegionSizeMiB": 65536,
"ShareableRegion": false,
"SanitizeOnRelease": true,
"BlockSizeMiB": 128,
"ExtentsCount": 1,
"MemoryExtents": [
{
"ExtentOffsetMiB": 0,
"ExtentSizeMiB": 4096,
"Tag": "User Defined Tag",
"SequenceNumber": 0
}
],
"MemoryChunks": [
{
"ChunkOffsetMiB": 0,
"ChunkLink": {
"@odata.id": "/redfish/v1/Chassis/1/MemoryDomains/1/MemoryChunks/1"
}
}
],
"@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/1/CXLLogicalDevices/1/MemoryRegions/1"
}6.76 MessageRegistry 1.6.1
| Version | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2022.3 | 2021.3 | 2020.1 | 2019.1 | 2018.2 | 2017.1 | 1.0 |
6.76.1 Description
The MessageRegistry schema describes all message registries. It represents the properties for the message registries themselves.
- This resource shall represent a message registry for a Redfish implementation.
6.76.2 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Language | string | read-only required | The RFC5646-conformant language code for
the message registry.
|
| Messages { | object | required | The message keys contained in the message
registry.
|
| (pattern) { | object | Property names follow regular expression pattern "[A-Za-z0-9]+" | |
| ArgDescriptions (v1.3+) [ ] | array (string, null) | read-only | The MessageArg descriptions, in order,
used for this message.
|
| ArgLongDescriptions (v1.3+) [ ] | array (string, null) | read-only | The MessageArg normative descriptions, in
order, used for this message.
|
| ClearingLogic (v1.2+) { | object | The clearing logic associated with this
message. The properties within indicate that what messages are cleared
by this message as well as under what conditions.
|
|
| ClearsAll (v1.2+) | boolean | read-only (null) |
An indication of whether all prior
conditions and messages are cleared, provided the ClearsIf condition is
met.
|
| ClearsIf (v1.2+) | string (enum) |
read-only (null) |
The condition when the event is
cleared.
|
| ClearsMessage (v1.2+) [ ] | array (string, null) | read-only | The array of MessageIds that this message
clears when the other conditions are met.
|
| } | |||
| Deprecated (v1.5+) | string | read-only (null) |
The reason the message has been
deprecated.
|
| Description | string | read-only required | A short description of how and when to use
this message.
|
| LongDescription (v1.3+) | string | read-only (null) |
The normative language that describes this
message's usage.
|
| MapsToGeneralMessages (v1.6+) [ ] | array (string, null) | read-only | The general or less-specific messages
related to this message.
^[A-Z]\w+\.[A-Z]\w+$ |
| Message | string | read-only required | The actual message.
|
| MessageSeverity (v1.4+) | string (enum) |
read-only required (null) |
The severity of the message.
|
| NumberOfArgs | integer | read-only required | The number of arguments in the
message.
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| ParamTypes [ ] | array (string (enum)) |
read-only |
|
| ReplacedBy (v1.6+) | string | read-only (null) |
The message identifier that replaces this
message.
^[A-Z]\w+\.[A-Z]\w+$ |
| Resolution | string | read-only required | Used to provide suggestions on how to
resolve the situation that caused the error.
|
| Severity (deprecated v1.4) | string | read-only required | The severity of the message.
|
| VersionAdded (v1.5+) | string | read-only (null) |
The registry version which added this
message.
^\d+\.\d+\.\d+$ |
| VersionDeprecated (v1.5+) | string | read-only (null) |
The registry version when the the message
was deprecated.
^\d+\.\d+\.\d+$ |
| } | |||
| } | |||
| OwningEntity | string | read-only required | The organization or company that publishes
this message registry.
|
| RegistryPrefix | string | read-only required | The single-word prefix that is used in
forming and decoding MessageIds.
|
| RegistryVersion | string | read-only required | The message registry version in the middle
portion of a MessageId.
^\d+\.\d+\.\d+$ |
6.76.3 Property details
6.76.3.1 ClearsIf
The condition when the event is cleared.
- This property shall contain the condition the event is cleared.
| string | Description |
|---|---|
| SameOriginOfCondition | Indicates the message for an event is cleared by the other messages in the ClearingLogic property, provided the OriginOfCondition for both events are the same. |
6.76.3.2 MessageSeverity
The severity of the message.
- This property shall contain the severity of the message. Services can replace the severity defined in the message registry with a value more applicable to the implementation in message payloads and event payloads.
| string | Description |
|---|---|
| Critical | A critical condition requires immediate attention. |
| OK | Normal. |
| Warning | A condition requires attention. |
6.76.3.3 ParamTypes
- The data types of the message arguments, prior to conversion to strings for inclusion in a message.
- This property shall contain an ordered array of the data types of the values in MessageArgs, prior to their conversion to strings for inclusion in a message.
| string | Description |
|---|---|
| number | The argument is a number converted to a string. |
| string | The argument is a string. |
6.76.4 Example response
{
"@odata.type": "#MessageRegistry.v1_3_1.MessageRegistry",
"Id": "Basic.1.2.0",
"Name": "Simple Message Registry",
"Language": "en",
"Description": "Collection of Basic messages for numerous use cases",
"RegistryPrefix": "Basic",
"RegistryVersion": "1.2.0",
"OwningEntity": "Contoso",
"Messages": {
"Success": {
"Description": "Indicates that all conditions of a successful operation have been met.",
"Message": "Successfully Completed Request",
"Severity": "OK",
"NumberOfArgs": 0,
"Resolution": "None"
},
"GeneralError": {
"Description": "Indicates that a general error has occurred.",
"Message": "A general error has occurred. See ExtendedInfo for more information.",
"Severity": "Critical",
"NumberOfArgs": 0,
"Resolution": "See ExtendedInfo for more information."
},
"ResourceAtUriUnauthorized": {
"Description": "Indicates that the attempt to access the resource/file/image at the URI was unauthorized.",
"Message": "While accessing the resource at %1, the service received an authorization error %2.",
"Severity": "Critical",
"NumberOfArgs": 2,
"ParamTypes": [
"string",
"string"
],
"Resolution": "Ensure that the appropriate access is provided for the service in order for it to access the URI."
}
}
}6.77 MessageRegistryFile 1.1.3
| Version | v1.1 | v1.0 |
| Release | 2017.1 | 2016.1 |
6.77.1 Description
The MessageRegistryFile schema describes the Message Registry file locator Resource.
- This Resource shall represent the Message Registry file locator for a Redfish implementation.
6.77.2 URIs
/redfish/v1/Registries/{MessageRegistryFileId}
6.77.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Languages [ ] | array (string) | read-only required | The RFC5646-conformant language codes for
the available Message Registries.
|
| Location [ { | array | required | The location information for this Message
Registry file.
|
| ArchiveFile | string | read-only | If the service hosts the Message Registry
in an archive file, the name of the file within the archive.
|
| ArchiveUri | string (URI) |
read-only | If the Message Registry is hosted on the
service in an archive file, the link to the archive file.
|
| Language | string | read-only | The language code for the Message Registry
file.
|
| PublicationUri | string (URI) |
read-only | The link to publicly available (canonical)
URI for the Message Registry.
|
| Uri | string (URI) |
read-only | The link to locally available URI for the
Message Registry.
|
| } ] | |||
| Registry | string | read-only required | The registry name and its major and minor
versions. This registry can be any type of registry, such as a Message
Registry, Privilege Registry, or Attribute Registry.
|
6.77.4 Example response
{
"@odata.type": "#MessageRegistryFile.v1_1_3.MessageRegistryFile",
"Id": "Base.1.0.0",
"Name": "Base Message Registry File",
"Description": "Base Message Registry File locations",
"Languages": [
"en"
],
"Registry": "Base.1.0",
"Location": [
{
"Language": "en",
"ArchiveUri": "/FileRepo/Registries.gz",
"PublicationUri": "http://redfish.dmtf.org/registries/v1/Base.1.0.0.json",
"ArchiveFile": "Base.1.0.0.json"
},
{
"Language": "zh",
"ArchiveUri": "/FileRepo/Registries.zh.gz",
"PublicationUri": "http://redfish.dmtf.org/registries/v1/zh/Base.1.0.0.zh.json",
"ArchiveFile": "Base.1.0.0.zh.json"
}
],
"@odata.id": "/redfish/v1/Registries/Base.1.0.0"
}6.78 MetricDefinition 1.3.2
| Version | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2022.1 | 2021.1 | 2020.3 | 2018.2 |
6.78.1 Description
The MetricDefinition schema describes the metadata information for a metric.
- This resource shall contain the metadata information for a metric in a Redfish implementation.
6.78.2 URIs
/redfish/v1/TelemetryService/MetricDefinitions/{MetricDefinitionId}
6.78.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Accuracy | number | read-only (null) |
The estimated percent error of measured
versus actual values.
|
| Calculable | string (enum) |
read-write (null) |
An indication of whether the metric can be
used in a calculation.
|
| CalculationAlgorithm | string (enum) |
read-only (null) |
The calculation that is performed on a
source metric to obtain the metric being defined.
|
| CalculationParameters [ { | array | The metric properties that are part of a
calculation that this metric definition defines.
|
|
| ResultMetric | string | read-only (null) |
The URI with wildcards and property
identifiers of the metric property that stores the result of the
calculation. If the URI has wildcards, the wildcards are substituted as
specified in the Wildcards property.
|
| SourceMetric | string | read-only (null) |
The URI with wildcards and property
identifiers of the metric property used as the input into the
calculation. If the URI has wildcards, the wildcards are substituted as
specified in the Wildcards property.
|
| } ] | |||
| CalculationTimeInterval | string (duration) |
read-write (null) |
The time interval over which the metric
calculation is performed.
^P(\d+D)?(T(\d+H)?(\d+M)?(\d+(.\d+)?S)?)?$ |
| Calibration | number | read-only (null) |
The calibration offset added to the metric
reading.
|
| DiscreteValues [ ] | array (string, null) | read-write | This array property specifies possible
values of a discrete metric.
|
| Implementation | string (enum) |
read-only (null) |
The implementation of the
metric.
|
| IsLinear | boolean | read-write (null) |
An indication of whether the metric values
are linear versus non-linear.
|
| LogicalContexts (v1.3+) [ ] | array (string (enum)) |
read-only |
|
| MaxReadingRange | number | read-only (null) |
Maximum value for metric
reading.
|
| MetricDataType | string (enum) |
read-write (null) |
The data type of the metric.
|
| MetricProperties [ ] | array (URI) (string, null) |
read-write | The list of URIs with wildcards and
property identifiers that this metric definition defines. If a URI has
wildcards, the wildcards are substituted as specified in the Wildcards
property.
|
| MetricType | string (enum) |
read-write (null) |
The type of metric.
|
| MinReadingRange | number | read-only (null) |
Minimum value for metric
reading.
|
| OEMCalculationAlgorithm (v1.1+) | string | read-only (null) |
The OEM-defined calculation that is
performed on a source metric to obtain the metric being
defined.
|
| PhysicalContext | string (enum) |
read-only (null) |
The physical context of the
metric.
|
| Precision | integer | read-only (null) |
Number of significant digits in the metric
reading.
|
| SensingInterval | string (duration) |
read-write (null) |
The time interval between when a metric is
updated.
^P(\d+D)?(T(\d+H)?(\d+M)?(\d+(.\d+)?S)?)?$ |
| TimestampAccuracy | string (duration) |
read-only (null) |
The accuracy of the timestamp.
^P(\d+D)?(T(\d+H)?(\d+M)?(\d+(.\d+)?S)?)?$ |
| Units | string | read-write (null) |
The units of measure for this
metric.
|
| Wildcards [ { | array | The wildcards and their substitution
values for the entries in the MetricProperties array
property.
|
|
| Name | string | read-only (null) |
The string used as a wildcard.
|
| Values [ ] | array (string, null) | read-only | An array of values to substitute for the
wildcard.
|
| } ] |
6.78.4 Property details
6.78.4.1 Calculable
An indication of whether the metric can be used in a calculation.
- This property shall specify whether the metric can be used in a calculation.
| string | Description |
|---|---|
| NonCalculatable | No calculations should be performed on the metric reading. |
| NonSummable | The sum of the metric reading across multiple instances is not meaningful. |
| Summable | The sum of the metric reading across multiple instances is meaningful. |
6.78.4.2 CalculationAlgorithm
The calculation that is performed on a source metric to obtain the metric being defined.
- This property shall contain the calculation performed to obtain the metric.
| string | Description |
|---|---|
| Average | The metric is calculated as the average
metric reading over a sliding time interval.
|
| Maximum | The metric is calculated as the maximum
metric reading over during a time interval.
|
| Minimum | The metric is calculated as the minimum
metric reading over a sliding time interval.
|
| OEM (v1.1+) | The metric is calculated as specified by
an OEM.
|
6.78.4.3 Implementation
The implementation of the metric.
- This property shall specify the implementation of the metric.
| string | Description |
|---|---|
| Calculated | The metric is implemented by applying a calculation on another metric property. The calculation is specified in the CalculationAlgorithm property. |
| DigitalMeter | The metric is implemented as digital meter. |
| PhysicalSensor | The metric is implemented as a physical sensor. |
| Synthesized | The metric is implemented by applying a calculation on one or more metric properties. The calculation is not provided. |
6.78.4.4 LogicalContexts
- The logical contexts related to the metric.
- This property shall contain the logical contexts related to the metric. This property should be present when the PhysicalContext property does not provide complete information and additional context information is needed. For example, if the metric refers to capacity or performance.
| string | Description |
|---|---|
| Capacity | Capacity related logical context. |
| Environment | Environment related logical context. |
| Network | Network related logical context. |
| Performance | Performance related logical context. |
| Security | Security related logical context. |
| Storage | Storage related logical context. |
6.78.4.5 MetricDataType
The data type of the metric.
- This property shall specify the data-type of the metric.
| string | Description |
|---|---|
| Boolean | The JSON boolean definition. |
| DateTime | The JSON string definition with the date-time format. |
| Decimal | The JSON decimal definition. |
| Enumeration | The JSON string definition with a set of defined enumerations. |
| Integer | The JSON integer definition. |
| String | The JSON string definition. |
6.78.4.6 MetricType
The type of metric.
- This property shall specify the type of metric.
| string | Description |
|---|---|
| Countdown | The metric is a countdown metric. The metric reading is a non-negative integer that decreases monotonically. When a counter reaches its minimum, the value resets to preset value and resumes counting down. |
| Counter | The metric is a counter metric. The metric reading is a non-negative integer that increases monotonically. When a counter reaches its maximum, the value resets to 0 and resumes counting. |
| Discrete | The metric is a discrete metric. The
metric value is discrete. The possible values are listed in the
DiscreteValues property.
|
| Gauge | The metric is a gauge metric. The metric value is a real number. When the metric value reaches the gauge's extrema, it stays at that value, until the reading falls within the extrema. |
| Numeric | The metric is a numeric metric. The metric value is any real number. |
| String (v1.2+) | The metric is a non-discrete string metric. The metric reading is a non-discrete string that displays some non-discrete, non-numeric data. |
6.78.4.7 PhysicalContext
The physical context of the metric.
- This property shall contain the physical context of the metric.
| string | Description |
|---|---|
| Accelerator | An accelerator. |
| ACInput | An AC input. |
| ACMaintenanceBypassInput | An AC maintenance bypass input. |
| ACOutput | An AC output. |
| ACStaticBypassInput | An AC static bypass input. |
| ACUtilityInput | An AC utility input. |
| ASIC | An ASIC device, such as a networking chip or chipset component. |
| Back | The back of the chassis. |
| Backplane | A backplane within the chassis. |
| Battery | A battery. |
| Board | A circuit board.
|
| Chassis | The entire chassis. |
| ComputeBay | Within a compute bay. |
| CoolingSubsystem | The entire cooling, or air and liquid, subsystem. |
| CPU | A processor (CPU). |
| CPUSubsystem | The entire processor (CPU) subsystem. |
| DCBus | A DC bus. |
| Exhaust | The air exhaust point or points or region of the chassis. |
| ExpansionBay | Within an expansion bay. |
| Fan | A fan. |
| FPGA | An FPGA. |
| Front | The front of the chassis. |
| GPU | A graphics processor (GPU). |
| GPUSubsystem | The entire graphics processor (GPU) subsystem. |
| Intake | The air intake point or points or region of the chassis. |
| LiquidInlet | The liquid inlet point of the chassis. |
| LiquidOutlet | The liquid outlet point of the chassis. |
| Lower | The lower portion of the chassis. |
| Memory | A memory device. |
| MemorySubsystem | The entire memory subsystem. |
| Motor | A motor. |
| NetworkBay | Within a networking bay. |
| NetworkingDevice | A networking device. |
| PowerSubsystem | The entire power subsystem. |
| PowerSupply | A power supply. |
| PowerSupplyBay | Within a power supply bay. |
| Pump | A pump. |
| Rectifier | A rectifier device. |
| Room | The room. |
| StorageBay | Within a storage bay. |
| StorageDevice | A storage device. |
| SystemBoard | The system board (PCB). |
| Transceiver | A transceiver.
|
| Transformer | A transformer. |
| TrustedModule | A trusted module. |
| Upper | The upper portion of the chassis. |
| VoltageRegulator | A voltage regulator device. |
6.78.5 Example response
{
"@odata.type": "#MetricDefinition.v1_3_2.MetricDefinition",
"Id": "PowerConsumedWatts",
"Name": "Power Consumed Watts Metric Definition",
"MetricType": "Numeric",
"Implementation": "PhysicalSensor",
"PhysicalContext": "PowerSupply",
"MetricDataType": "Decimal",
"Units": "W",
"Precision": 4,
"Accuracy": 1,
"Calibration": 2,
"MinReadingRange": 0,
"MaxReadingRange": 50,
"SensingInterval": "PT1S",
"TimestampAccuracy": "PT1S",
"Wildcards": [
{
"Name": "ChassisID",
"Values": [
"1"
]
}
],
"MetricProperties": [
"/redfish/v1/Chassis/{ChassisID}/Power#/PowerControl/0/PowerConsumedWatts"
],
"@odata.id": "/redfish/v1/TelemetryService/MetricDefinitions/PowerConsumedWatts"
}6.79 MetricReport 1.5.0
| Version | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2022.2 | 2020.2 | 2019.4 | 2019.2 | 2018.3 | 2018.2 |
6.79.1 Description
The MetricReport schema represents a set of collected metrics.
- This resource shall represent a metric report in a Redfish implementation. When a metric report is deleted, the historic metric data used to generate the report shall be deleted as well unless other metric reports are consuming the data.
6.79.2 URIs
/redfish/v1/TelemetryService/MetricReports/{MetricReportId}
6.79.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Context (v1.4+) | string | read-only | A context can be supplied at subscription
time. This property is the context value supplied by the
subscriber.
|
| MetricReportDefinition { | object | The link to the definition of this metric
report.
|
|
| @odata.id | string | read-only | Link to a MetricReportDefinition resource. See the Links section and the MetricReportDefinition schema for details. |
| } | |||
| MetricValues [ { | array | An array of metric values for the metered
items of this metric report.
|
|
| MetricDefinition (deprecated v1.5) { | object | The link to the metric definition for this
metric.
|
|
| @odata.id | string | read-only | Link to a MetricDefinition resource. See the Links section and the MetricDefinition schema for details. |
| } | |||
| MetricId | string | read-only (null) |
The metric definitions identifier that
contains additional information for the source metric.
|
| MetricProperty | string (URI) |
read-only (null) |
The URI for the property from which this
metric is derived.
|
| MetricValue | string | read-only (null) |
The metric value, as a string.
|
| Oem (v1.2+) {} | object | See the OEM object definition in the Using this guide clause. | |
| Timestamp | string (date-time) |
read-only (null) |
The date and time when the metric is
obtained. A management application can establish a time series of metric
data by retrieving the instances of metric value and sorting them
according to their timestamp.
|
| } ] | |||
| ReportSequence (deprecated v1.3) | string | read-only | The current sequence identifier for this
metric report.
|
| Timestamp (v1.1+) | string (date-time) |
read-only (null) |
The time associated with the metric report
in its entirety. The time of the metric report can be relevant when the
time of individual metrics are minimally different.
|
6.79.4 Example response
{
"@odata.type": "#MetricReport.v1_5_0.MetricReport",
"Id": "AvgPlatformPowerUsage",
"Name": "Average Platform Power Usage metric report",
"MetricReportDefinition": {
"@odata.id": "/redfish/v1/TelemetryService/MetricReportDefinitions/AvgPlatformPowerUsage"
},
"MetricValues": [
{
"MetricId": "AverageConsumedWatts",
"MetricValue": "100",
"Timestamp": "2016-11-08T12:25:00-05:00",
"MetricProperty": "/redfish/v1/Chassis/Tray_1/Power#/0/PowerConsumedWatts"
},
{
"MetricId": "AverageConsumedWatts",
"MetricValue": "94",
"Timestamp": "2016-11-08T13:25:00-05:00",
"MetricProperty": "/redfish/v1/Chassis/Tray_1/Power#/0/PowerConsumedWatts"
},
{
"MetricId": "AverageConsumedWatts",
"MetricValue": "100",
"Timestamp": "2016-11-08T14:25:00-05:00",
"MetricProperty": "/redfish/v1/Chassis/Tray_1/Power#/0/PowerConsumedWatts"
}
],
"@odata.id": "/redfish/v1/TelemetryService/MetricReports/AvgPlatformPowerUsage"
}6.80 MetricReportDefinition 1.4.4
| Version | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2020.4 | 2019.2 | 2019.1 | 2018.3 | 2018.2 |
6.80.1 Description
The MetricReportDefinition schema describes set of metrics that are collected into a metric report.
- This resource shall specify a set of metrics that shall be collected into a metric report in a Redfish implementation.
6.80.2 URIs
/redfish/v1/TelemetryService/MetricReportDefinitions/{MetricReportDefinitionId}
6.80.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AppendLimit | integer | read-only | The maximum number of entries that can be
appended to a metric report. When the metric report reaches its limit,
its behavior is dictated by the ReportUpdates property.
|
| Links (v1.2+) { | object | The links to other resources that are
related to this resource.
|
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| Triggers (v1.2+) [ { | array | The triggers that cause this metric report
definition to generate a new metric report upon a trigger occurrence
when the TriggerActions property contains
RedfishMetricReport.
|
|
| @odata.id | string | read-only | Link to a Triggers resource. See the Links section and the Triggers schema for details. |
| } ] | |||
| } | |||
| MetricProperties [ ] | array (URI) (string, null) |
read-write | The list of URIs with wildcards and
property identifiers to include in the metric report. If a URI has
wildcards, the wildcards are substituted as specified in the Wildcards
property.
|
| MetricReport { | object | The most recent metric report produced by
this metric report definition.
|
|
| @odata.id | string | read-only | Link to a MetricReport resource. See the Links section and the MetricReport schema for details. |
| } | |||
| MetricReportDefinitionEnabled (v1.2+) | boolean | read-write (null) |
An indication of whether the generation of
new metric reports is enabled.
|
| MetricReportDefinitionType | string (enum) |
read-write (null) |
Specifies when the metric report is
generated.
|
| MetricReportHeartbeatInterval (v1.2+) | string (duration) |
read-write (null) |
The interval at which to send the complete
metric report because the Redfish client wants refreshed metric data
even when the data has not changed. This property value is always
greater than the recurrence interval of a metric report, and it only
applies when the SuppressRepeatedMetricValue property is
true.
^P(\d+D)?(T(\d+H)?(\d+M)?(\d+(.\d+)?S)?)?$ |
| Metrics [ { | array | The list of metrics to include in the
metric report. The metrics might include calculations to apply to metric
properties.
|
|
| CollectionDuration | string (duration) |
read-write (null) |
The duration over which the function is
computed.
^P(\d+D)?(T(\d+H)?(\d+M)?(\d+(.\d+)?S)?)?$ |
| CollectionFunction | string (enum) |
read-write (null) |
Specifies the function to perform on each
of the metric properties listed in the MetricProperties property or the
metric properties specified in the MetricDefinition referenced by the
MetricId property. If not specified, calculations are not performed on
the metric properties.
|
| CollectionTimeScope | string (enum) |
read-write (null) |
The scope of time over which the function
is applied.
|
| MetricId | string | read-write (null) |
The metric definition identifier that
contains the metric properties to include in the metric
report.
|
| MetricProperties [ ] | array (URI) (string, null) |
read-write | The list of URIs with wildcards and
property identifiers to include in the metric report. If a URI has
wildcards, the wildcards are substituted as specified in the Wildcards
property.
|
| Oem (v1.4+) {} | object | See the OEM object definition in the Using this guide clause. | |
| } ] | |||
| ReportActions [ ] | array (string (enum)) |
read-write | Actions to perform when a metric report is
generated.
|
| ReportTimespan (v1.3+) | string (duration) |
read-write (null) |
The maximum timespan that a metric report
can cover.
^P(\d+D)?(T(\d+H)?(\d+M)?(\d+(.\d+)?S)?)?$ |
| ReportUpdates | string (enum) |
read-write | The behavior for how subsequent metric
reports are handled in relationship to an existing metric report created
from the metric report definition. Namely, whether to overwrite, append,
or create a metric report.
|
| Schedule {} | object | The schedule for generating the metric
report.
|
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| SuppressRepeatedMetricValue (v1.2+) | boolean | read-write (null) |
An indication of whether any metrics are
suppressed from the generated metric report. If true, any
metric that equals the same value in the previously generated metric
report is suppressed from the current report. Also, duplicate metrics
are suppressed. If false, no metrics are suppressed from
the current report. The current report might contain no metrics if all
metrics equal the values in the previously generated metric
report.
|
| Wildcards [ { | array | The set of wildcards and their
substitution values for the entries in the MetricProperties
property.
|
|
| Keys (deprecated v1.1) [ ] | array (string, null) | read-write | An array of values to substitute for the
wildcard.
|
| Name | string | read-write (null) |
The string used as a wildcard.
|
| Values (v1.1+) [ ] | array (string, null) | read-write | An array of values to substitute for the
wildcard.
|
| } ] |
6.80.4 Property details
6.80.4.1 CollectionFunction
Specifies the function to perform on each of the metric properties listed in the MetricProperties property or the metric properties specified in the MetricDefinition referenced by the MetricId property. If not specified, calculations are not performed on the metric properties.
- The property shall specify the function to perform on each of the metric properties listed in the MetricProperties property or the metric properties specified in the MetricDefinition referenced by the MetricId property. If not specified, calculations shall not be performed on the metric properties.
| string | Description |
|---|---|
| Average | The metric is calculated as the average
metric reading over a duration.
|
| Maximum | The metric is calculated as the maximum
metric reading over a duration.
|
| Minimum | The metric is calculated as the minimum
metric reading over a duration.
|
| Summation | The metric is calculated as the sum of the
values over a duration.
|
6.80.4.2 CollectionTimeScope
The scope of time over which the function is applied.
- This property shall specify the scope of time over which the function is applied.
| string | Description |
|---|---|
| Interval | The corresponding metric values apply to a
time interval. On the corresponding metric value instances, the
Timestamp property value in the metric report specifies the end of the
time interval and the CollectionDuration property specifies its
duration.
|
| Point | The corresponding metric values apply to a
point in time. On the corresponding metric value instances, the
Timestamp property value in the metric report specifies the point in
time.
|
| StartupInterval | The corresponding metric values apply to a
time interval that began at the startup of the measured resource. On the
corresponding metric value instances, the Timestamp property value in
the metric report specifies the end of the time interval. The
CollectionDuration property value specifies the duration between the
startup of resource and timestamp.
|
6.80.4.3 MetricReportDefinitionType
Specifies when the metric report is generated.
- This property
shall specify when the metric report is generated. If the value is
Periodic, the Schedule property shall be present.
| string | Description |
|---|---|
| OnChange | The metric report is generated when any of the metric values change. |
| OnRequest | The metric report is generated when a HTTP GET is performed on the specified metric report. |
| Periodic | The metric report is generated at a periodic time interval, specified in the Schedule property. |
6.80.4.4 ReportActions
Actions to perform when a metric report is generated.
- The set
of actions to perform when a metric report is generated.
- This
property shall contain the set of actions to perform when the metric
report is generated. This property should be ignored if
MetricReportDefinitionType contains the value
OnRequest.
- This
property shall contain the set of actions to perform when the metric
report is generated. This property should be ignored if
MetricReportDefinitionType contains the value
| string | Description |
|---|---|
| LogToMetricReportsCollection | Record the occurrence to the metric report
collection.
|
| RedfishEvent | Send a Redfish event message containing
the metric report.
|
6.80.4.5 ReportUpdates
The behavior for how subsequent metric reports are handled in relationship to an existing metric report created from the metric report definition. Namely, whether to overwrite, append, or create a metric report.
- This property shall contain the behavior for how
subsequent metric reports are handled in relationship to an existing
metric report created from the metric report definition. This property
should be ignored if MetricReportDefinitionType contains the value
OnRequest.
| string | Description |
|---|---|
| AppendStopsWhenFull | New information is appended to the metric
report. The service stops adding entries when the metric report has
reached its maximum capacity.
|
| AppendWrapsWhenFull | New information is appended to the metric
report. The metric report entries are overwritten with new entries when
the metric report has reached its maximum capacity.
|
| NewReport | A new metric report is created, whose
identifier is a service-defined identifier concatenated with the
timestamp.
|
| Overwrite | Overwrite the metric report.
|
6.80.5 Example response
{
"@odata.type": "#MetricReportDefinition.v1_4_4.MetricReportDefinition",
"Id": "PlatformPowerUsage",
"Name": "Transmit and Log Platform Power Usage",
"MetricReportDefinitionType": "Periodic",
"Schedule": {
"RecurrenceInterval": "PT1H"
},
"ReportActions": [
"RedfishEvent",
"LogToMetricReportsCollection"
],
"ReportUpdates": "AppendWrapsWhenFull",
"AppendLimit": 256,
"MetricReport": {
"@odata.id": "/redfish/v1/TelemetryService/MetricReports/PlatformPowerUsage"
},
"Status": {
"State": "Enabled"
},
"Wildcards": [
{
"Name": "PWild",
"Values": [
"0"
]
},
{
"Name": "TWild",
"Values": [
"Tray_1",
"Tray_2"
]
}
],
"MetricProperties": [
"/redfish/v1/Chassis/{TWild}/Power#/PowerControl/{PWild}/PowerConsumedWatts"
],
"@odata.id": "/redfish/v1/TelemetryService/MetricReportDefinitions/PlatformPowerUsage"
}6.81 NetworkAdapter 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.4 | 2021.2 | 2021.1 | 2020.4 | 2020.3 | 2020.2 | 2019.2 | 2018.2 | 2017.3 | 2016.3 |
6.81.1 Description
The NetworkAdapter schema represents a physical network adapter capable of connecting to a computer network. Examples include but are not limited to Ethernet, Fibre Channel, and converged network adapters.
- This resource shall represent a physical network adapter capable of connecting to a computer network in a Redfish implementation.
6.81.2 URIs
/redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}
6.81.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Assembly (v1.1+) { | object | The link to the assembly resource
associated with this adapter.
|
|
| @odata.id | string | read-only | Link to a Assembly resource. See the Links section and the Assembly schema for details. |
| } | |||
| Certificates (v1.6+) { | object | The link to a collection of certificates
for device identity and attestation.
|
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| Controllers [ { | array | The set of network controllers ASICs that
make up this NetworkAdapter.
|
|
| ControllerCapabilities { | object | The capabilities of this
controller.
|
|
| DataCenterBridging { | object | Data center bridging (DCB) for this
controller.
|
|
| Capable | boolean | read-only (null) |
An indication of whether this controller
is capable of data center bridging (DCB).
|
| } | |||
| NetworkDeviceFunctionCount | integer | read-only (null) |
The maximum number of physical functions
available on this controller.
|
| NetworkPortCount | integer | read-only (null) |
The number of physical ports on this
controller.
|
| NPAR (v1.2+) { | object | NIC Partitioning (NPAR) capabilities for
this controller.
|
|
| NparCapable (v1.2+) | boolean | read-only (null) |
An indication of whether the controller
supports NIC function partitioning.
|
| NparEnabled (v1.2+) | boolean | read-write (null) |
An indication of whether NIC function
partitioning is active on this controller.
|
| } | |||
| NPIV { | object | N_Port ID Virtualization (NPIV)
capabilities for this controller.
|
|
| MaxDeviceLogins | integer | read-only (null) |
The maximum number of N_Port ID
Virtualization (NPIV) logins allowed simultaneously from all ports on
this controller.
|
| MaxPortLogins | integer | read-only (null) |
The maximum number of N_Port ID
Virtualization (NPIV) logins allowed per physical port on this
controller.
|
| } | |||
| VirtualizationOffload { | object | Virtualization offload for this
controller.
|
|
| SRIOV { | object | Single-root input/output virtualization
(SR-IOV) capabilities.
|
|
| SRIOVVEPACapable | boolean | read-only (null) |
An indication of whether this controller
supports single root input/output virtualization (SR-IOV) in Virtual
Ethernet Port Aggregator (VEPA) mode.
|
| } | |||
| VirtualFunction { | object | The virtual function of the
controller.
|
|
| DeviceMaxCount | integer | read-only (null) |
The maximum number of virtual functions
supported by this controller.
|
| MinAssignmentGroupSize | integer | read-only (null) |
The minimum number of virtual functions
that can be allocated or moved between physical functions for this
controller.
|
| NetworkPortMaxCount | integer | read-only (null) |
The maximum number of virtual functions
supported per network port for this controller.
|
| } | |||
| } | |||
| } | |||
| FirmwarePackageVersion | string | read-only (null) |
The version of the user-facing firmware
package.
|
| Identifiers (v1.3+) [ { } ] | array (object) | Any additional identifiers for a
resource.
|
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| NetworkDeviceFunctions [ { | array | An array of links to the network device
functions associated with this network controller.
|
|
| @odata.id | string | read-only | Link to a NetworkDeviceFunction resource. See the Links section and the NetworkDeviceFunction schema for details. |
| } ] | |||
| NetworkPorts (deprecated v1.5) [ { | array | An array of links to the network ports
associated with this network controller.
|
|
| @odata.id | string | read-only | Link to a NetworkPort resource. See the Links section and the NetworkPort schema for details. |
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| PCIeDevices [ { | array | An array of links to the PCIe devices
associated with this network controller.
|
|
| @odata.id | string | read-only | Link to a PCIeDevice resource. See the Links section and the PCIeDevice schema for details. |
| } ] | |||
| Ports (v1.5+) [ { | array | An array of links to the ports associated
with this network controller.
|
|
| @odata.id | string | read-only | Link to a Port resource. See the Links section and the Port schema for details. |
| } ] | |||
| } | |||
| Location (v1.1+) {} | object | The location of the network adapter
controller.
|
|
| PCIeInterface (v1.2+) { | object | The PCIe interface details for this
controller.
|
|
| LanesInUse (v1.3+) | integer | read-only (null) |
The number of PCIe lanes in use by this
device.
|
| MaxLanes (v1.3+) | integer | read-only (null) |
The number of PCIe lanes supported by this
device.
|
| MaxPCIeType (v1.3+) | string (enum) |
read-only (null) |
The highest version of the PCIe
specification supported by this device.
|
| Oem (v1.3+) {} | object | See the OEM object definition in the Using this guide clause. | |
| PCIeType (v1.3+) | string (enum) |
read-only (null) |
The version of the PCIe specification in
use by this device.
|
| } | |||
| } ] | |||
| EnvironmentMetrics (v1.7+) { | object | The link to the environment metrics for
this network adapter.
|
|
| @odata.id | string | read-only | Link to a EnvironmentMetrics resource. See the Links section and the EnvironmentMetrics schema for details. |
| } | |||
| Identifiers (v1.4+) [ { } ] | array (object) | Any additional identifiers for a
resource.
|
|
| LLDPEnabled (v1.7+) | boolean | read-write | Enable or disable LLDP globally for an
adapter.
|
| Location (v1.4+) {} | object | The location of the network
adapter.
|
|
| Manufacturer | string | read-only (null) |
The manufacturer or OEM of this network
adapter.
|
| Measurements (v1.6+, deprecated v1.9 [ { | 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. |
| } ] | |||
| Metrics (v1.7+) { | object | (null) |
The link to the metrics associated with
this adapter.
|
| @odata.id | string | read-only | Link to a NetworkAdapterMetrics resource. See the Links section and the NetworkAdapterMetrics schema for details. |
| } | |||
| Model | string | read-only (null) |
The model string for this network
adapter.
|
| NetworkDeviceFunctions { | object | The link to the collection of network
device functions associated with this network adapter.
|
|
| @odata.id | string | read-only | Link to Collection of NetworkDeviceFunction. See the NetworkDeviceFunction schema for details. |
| } | |||
| NetworkPorts (deprecated v1.5) { | object | The link to the collection of network
ports associated with this network adapter.
|
|
| @odata.id | string | read-only | Link to Collection of NetworkPort. See the NetworkPort schema for details. |
| } | |||
| PartNumber | string | read-only (null) |
Part number for this network
adapter.
|
| Ports (v1.5+) { | object | The link to the collection of ports
associated with this network adapter.
|
|
| @odata.id | string | read-only | Link to Collection of Port. See the Port schema for details. |
| } | |||
| Processors (v1.8+) { | object | The link to the collection of offload
processors contained in this network adapter.
|
|
| @odata.id | string | read-only | Link to Collection of Processor. See the Processor schema for details. |
| } | |||
| SerialNumber | string | read-only (null) |
The serial number for this network
adapter.
|
| SKU | string | read-only (null) |
The manufacturer SKU for this network
adapter.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
6.81.4 Actions
6.81.4.1 ResetSettingsToDefault
Description
This action is to clear the settings back to factory defaults.
- This action shall reset of all active and pending settings back to factory default settings upon reset of the network adapter.
Action URI
{Base URI of target resource}/Actions/NetworkAdapter.ResetSettingsToDefault
Action parameters
This action takes no parameters.
6.81.5 Property details
6.81.5.1 MaxPCIeType
The highest version of the PCIe specification supported by this device.
- This property shall contain the maximum PCIe specification that this device supports.
| string | Description |
|---|---|
| Gen1 | A PCIe v1.0 slot. |
| Gen2 | A PCIe v2.0 slot. |
| Gen3 | A PCIe v3.0 slot. |
| Gen4 | A PCIe v4.0 slot. |
| Gen5 | A PCIe v5.0 slot. |
6.81.5.2 PCIeType
The version of the PCIe specification in use by this device.
- This property shall contain the negotiated PCIe interface version in use by this device.
| string | Description |
|---|---|
| Gen1 | A PCIe v1.0 slot. |
| Gen2 | A PCIe v2.0 slot. |
| Gen3 | A PCIe v3.0 slot. |
| Gen4 | A PCIe v4.0 slot. |
| Gen5 | A PCIe v5.0 slot. |
6.81.6 Example response
{
"@odata.type": "#NetworkAdapter.v1_9_0.NetworkAdapter",
"Id": "9fa725a1",
"Name": "Network Adapter View",
"Manufacturer": "Contoso",
"Model": "599TPS-T",
"SKU": "Contoso TPS-Net 2-Port Base-T",
"SerialNumber": "003BFLRT00023234",
"PartNumber": "975421-B20",
"Ports": {
"@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/9fd725a1/Ports"
},
"NetworkDeviceFunctions": {
"@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/9fd725a1/NetworkDeviceFunctions"
},
"Controllers": [
{
"FirmwarePackageVersion": "7.4.10",
"Links": {
"PCIeDevices": [
{
"@odata.id": "/redfish/v1/Systems/1/PCIeDevices/NIC"
}
],
"Ports": [
{
"@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/9fd725a1/Ports/1"
}
],
"NetworkDeviceFunctions": [
{
"@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/9fd725a1/NetworkDeviceFunctions/111111111100"
}
]
},
"ControllerCapabilities": {
"NetworkPortCount": 2,
"NetworkDeviceFunctionCount": 8,
"DataCenterBridging": {
"Capable": true
},
"VirtualizationOffload": {
"VirtualFunction": {
"DeviceMaxCount": 256,
"NetworkPortMaxCount": 128,
"MinAssignmentGroupSize": 4
},
"SRIOV": {
"SRIOVVEPACapable": true
}
},
"NPIV": {
"MaxDeviceLogins": 4,
"MaxPortLogins": 2
},
"NPAR": {
"NparCapable": true,
"NparEnabled": false
}
},
"PCIeInterface": {
"PCIeType": "Gen2",
"MaxPCIeType": "Gen3",
"LanesInUse": 1,
"MaxLanes": 4
},
"Location": {
"PartLocation": {
"ServiceLabel": "Slot 1",
"LocationType": "Slot",
"LocationOrdinalValue": 0,
"Reference": "Rear",
"Orientation": "LeftToRight"
}
}
}
],
"Actions": {
"#NetworkAdapter.ResetSettingsToDefault": {
"target": "/redfish/v1/Chassis/1/NetworkAdapters/9fd725a1/Actions/NetworkAdapter.ResetSettingsToDefault"
}
},
"@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/9fd725a1"
}6.82 NetworkAdapterMetrics 1.0.1
| Version | v1.0 |
| Release | 2021.1 |
6.82.1 Description
The NetworkAdapterMetrics schema contains usage and health statistics for a network adapter.
- This resource shall represent the network metrics for a single network adapter in a Redfish implementation.
6.82.2 URIs
/redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/Metrics
6.82.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| CPUCorePercent | number (%) |
read-only (null) |
The device CPU core utilization as a
percentage.
|
| HostBusRXPercent | number (%) |
read-only (null) |
The host bus, such as PCIe, RX utilization
as a percentage.
|
| HostBusTXPercent | number (%) |
read-only (null) |
The host bus, such as PCIe, TX utilization
as a percentage.
|
| NCSIRXBytes | integer (bytes) |
read-only (null) |
The total number of NC-SI bytes received
since reset.
|
| NCSIRXFrames | integer | read-only (null) |
The total number of NC-SI frames received
since reset.
|
| NCSITXBytes | integer (bytes) |
read-only (null) |
The total number of NC-SI bytes sent since
reset.
|
| NCSITXFrames | integer | read-only (null) |
The total number of NC-SI frames sent
since reset.
|
| RXBytes | integer (bytes) |
read-only (null) |
The total number of bytes received since
reset.
|
| RXMulticastFrames | integer | read-only (null) |
The total number of good multicast frames
received since reset.
|
| RXUnicastFrames | integer | read-only (null) |
The total number of good unicast frames
received since reset.
|
| TXBytes | integer (bytes) |
read-only (null) |
The total number of bytes transmitted
since reset.
|
| TXMulticastFrames | integer | read-only (null) |
The total number of good multicast frames
transmitted since reset.
|
| TXUnicastFrames | integer | read-only (null) |
The total number of good unicast frames
transmitted since reset.
|
6.82.4 Example response
{
"@odata.type": "#NetworkAdapterMetrics.v1_0_1.NetworkAdapterMetrics",
"Id": "NetworkAdapterMetrics",
"Name": "Network Adapter Metrics",
"HostBusRXPercent": 35.53,
"HostBusTXPercent": 14.17,
"CPUCorePercent": 8.35,
"NCSIRXFrames": 0,
"NCSITXFrames": 0,
"NCSIRXBytes": 0,
"NCSITXBytes": 0,
"RXBytes": 7754199970,
"RXMulticastFrames": 1941,
"RXUnicastFrames": 27193387,
"TXBytes": 9436506547,
"TXMulticastFrames": 153,
"TXUnicastFrames": 18205770,
"@odata.id": "/redfish/v1/Chassis/1U/NetworkAdapters/Slot1/Metrics"
}6.83 NetworkDeviceFunction 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 | 2022.2 | 2021.4 | 2021.2 | 2021.1 | 2020.3 | 2020.1 | 2018.2 | 2017.3 | 2017.1 | 2016.3 |
6.83.1 Description
The NetworkDeviceFunction schema represents a logical interface that a network adapter exposes.
- This resource shall represent a logical interface that a network adapter exposes in a Redfish implementation.
6.83.2 URIs
/redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/NetworkDeviceFunctions/{NetworkDeviceFunctionId}
6.83.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AllowDeny (v1.7+) { | object | The link to the collection of allow and
deny permissions for packets leaving and arriving to this network device
function.
|
|
| @odata.id | string | read-only | Link to Collection of AllowDeny. See the AllowDeny schema for details. |
| } | |||
| AssignablePhysicalNetworkPorts (v1.5+) [ { | array | An array of physical ports to which this
network device function can be assigned.
|
|
| @odata.id | string | read-only | Link to a Port resource. See the Links section and the Port schema for details. |
| } ] | |||
| AssignablePhysicalPorts (deprecated v1.5) [ { | array | An array of physical ports to which this
network device function can be assigned.
|
|
| @odata.id | string | read-only | Link to a NetworkPort resource. See the Links section and the NetworkPort schema for details. |
| } ] | |||
| BootMode | string (enum) |
read-write (null) |
The boot mode configured for this network
device function.
|
| DeviceEnabled | boolean | read-write (null) |
An indication of whether the network
device function is enabled.
|
| Ethernet { | object | The Ethernet capabilities, status, and
configuration values for this network device function.
|
|
| EthernetInterfaces (v1.7+) { | object | (null) |
The Ethernet interface collection that
represents all the Ethernet Interfaces on this network device
function.
|
| @odata.id | string | read-only | Link to Collection of EthernetInterface. See the EthernetInterface schema for details. |
| } | |||
| MACAddress | string | read-write (null) |
The currently configured MAC
address.
^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$ |
| MTUSize | integer | read-write (null) |
The maximum transmission unit (MTU)
configured for this network device function.
|
| MTUSizeMaximum (v1.5+) | integer | read-only (null) |
The largest maximum transmission unit
(MTU) size supported for this network device function.
|
| PermanentMACAddress | string | read-only (null) |
The permanent MAC address assigned to this
function.
^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$ |
| VLAN (v1.3+) { | object | The VLAN information for this interface.
If this network interface supports more than one VLAN, this property is
not present.
|
|
| Tagged (v1.3+) | boolean | read-write (null) |
An indication of whether this VLAN is
tagged or untagged for this interface.
|
| 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 (v1.3+, deprecated v1.7 { | object | The link to a collection of VLANs. This
property is used only if the interface supports more than one
VLAN.
|
|
| @odata.id | string | read-only | Link to Collection of VLanNetworkInterface. See the VLanNetworkInterface schema for details. |
| } | |||
| } | |||
| FibreChannel { | object | The Fibre Channel capabilities, status,
and configuration values for this network device function.
|
|
| AllowFIPVLANDiscovery | boolean | read-write (null) |
An indication of whether the FCoE
Initialization Protocol (FIP) populates the FCoE VLAN ID.
|
| BootTargets [ { | array | An array of Fibre Channel boot targets
configured for this network device function.
|
|
| BootPriority | integer | read-write (null) |
The relative priority for this entry in
the boot targets array.
|
| LUNID | string | read-write (null) |
The logical unit number (LUN) ID from
which to boot on the device to which the corresponding WWPN
refers.
|
| WWPN | string | read-write (null) |
The World Wide Port Name (WWPN) from which
to boot.
|
| } ] | |||
| FCoEActiveVLANId | integer | read-only (null) |
The active FCoE VLAN ID.
|
| FCoELocalVLANId | integer | read-write (null) |
The locally configured FCoE VLAN
ID.
|
| FibreChannelId (v1.3+) | string | read-only (null) |
The Fibre Channel ID that the switch
assigns for this interface.
|
| PermanentWWNN | string | read-only (null) |
The permanent World Wide Node Name (WWNN)
address assigned to this function.
^([0-9A-Fa-f]{2}[:-]){7}([0-9A-Fa-f]{2})$ |
| PermanentWWPN | string | read-only (null) |
The permanent World Wide Port Name (WWPN)
address assigned to this function.
|
| WWNN | string | read-write (null) |
The currently configured World Wide Node
Name (WWNN) address of this function.
^([0-9A-Fa-f]{2}[:-]){7}([0-9A-Fa-f]{2})$ |
| WWNSource | string (enum) |
read-write (null) |
The configuration source of the World Wide
Names (WWN) for this World Wide Node Name (WWNN) and World Wide Port
Name (WWPN) connection.
|
| WWPN | string | read-write (null) |
The currently configured World Wide Port
Name (WWPN) address of this function.
^([0-9A-Fa-f]{2}[:-]){7}([0-9A-Fa-f]{2})$ |
| } | |||
| HTTPBoot (v1.9+) { | object | The HTTP and HTTPS boot capabilities,
status, and configuration values for this network device
function.
|
|
| BootMediaURI (v1.9+) | string (URI) |
read-write (null) |
The URI of the boot media loaded with this
network device function.
|
| } | |||
| InfiniBand (v1.5+) { | object | The InfiniBand capabilities, status, and
configuration values for this network device function.
|
|
| MTUSize (v1.5+) | integer | read-write (null) |
The maximum transmission unit (MTU) configured for this network device function. |
| NodeGUID (v1.5+) | string | read-only (null) |
This is the currently configured node GUID
of the network device function.
^([0-9A-Fa-f]{4}[:-]){3}([0-9A-Fa-f]{4})$ |
| PermanentNodeGUID (v1.5+) | string | read-only (null) |
The permanent node GUID assigned to this
network device function.
^([0-9A-Fa-f]{4}[:-]){3}([0-9A-Fa-f]{4})$ |
| PermanentPortGUID (v1.5+) | string | read-only (null) |
The permanent port GUID assigned to this
network device function.
^([0-9A-Fa-f]{4}[:-]){3}([0-9A-Fa-f]{4})$ |
| PermanentSystemGUID (v1.5+) | string | read-only (null) |
The permanent system GUID assigned to this
network device function.
^([0-9A-Fa-f]{4}[:-]){3}([0-9A-Fa-f]{4})$ |
| PortGUID (v1.5+) | string | read-only (null) |
The currently configured port GUID of the
network device function.
^([0-9A-Fa-f]{4}[:-]){3}([0-9A-Fa-f]{4})$ |
| SupportedMTUSizes (v1.5+) [ ] | array (integer, null) | read-only | The maximum transmission unit (MTU) sizes
supported for this network device function.
|
| SystemGUID (v1.5+) | string | read-only (null) |
This is the currently configured system
GUID of the network device function.
^([0-9A-Fa-f]{4}[:-]){3}([0-9A-Fa-f]{4})$ |
| } | |||
| iSCSIBoot { | object | The iSCSI boot capabilities, status, and
configuration values for this network device function.
|
|
| AuthenticationMethod | string (enum) |
read-write (null) |
The iSCSI boot authentication method for
this network device function.
|
| CHAPSecret | string | read-write (null) |
The shared secret for CHAP
authentication.
|
| CHAPUsername | string | read-write (null) |
The user name for CHAP
authentication.
|
| InitiatorDefaultGateway | string | read-write (null) |
The IPv6 or IPv4 iSCSI boot default
gateway.
|
| InitiatorIPAddress | string | read-write (null) |
The IPv6 or IPv4 address of the iSCSI
initiator.
|
| InitiatorName | string | read-write (null) |
The iSCSI initiator name.
|
| InitiatorNetmask | string | read-write (null) |
The IPv6 or IPv4 netmask of the iSCSI boot
initiator.
|
| IPAddressType | string (enum) |
read-write (null) |
The type of IP address being populated in
the iSCSIBoot IP address fields.
|
| IPMaskDNSViaDHCP | boolean | read-write (null) |
An indication of whether the iSCSI boot
initiator uses DHCP to obtain the initiator name, IP address, and
netmask.
|
| MutualCHAPSecret | string | read-write (null) |
The CHAP secret for two-way CHAP
authentication.
|
| MutualCHAPUsername | string | read-write (null) |
The CHAP user name for two-way CHAP
authentication.
|
| PrimaryDNS | string | read-write (null) |
The IPv6 or IPv4 address of the primary
DNS server for the iSCSI boot initiator.
|
| PrimaryLUN | integer | read-write (null) |
The logical unit number (LUN) for the
primary iSCSI boot target.
|
| PrimaryTargetIPAddress | string | read-write (null) |
The IPv4 or IPv6 address for the primary
iSCSI boot target.
|
| PrimaryTargetName | string | read-write (null) |
The name of the iSCSI primary boot
target.
|
| PrimaryTargetTCPPort | integer | read-write (null) |
The TCP port for the primary iSCSI boot
target.
|
| PrimaryVLANEnable | boolean | read-write (null) |
An indication of whether the primary VLAN
is enabled.
|
| PrimaryVLANId | integer | read-write (null) |
The 802.1q VLAN ID to use for iSCSI boot
from the primary target.
|
| RouterAdvertisementEnabled | boolean | read-write (null) |
An indication of whether IPv6 router
advertisement is enabled for the iSCSI boot target.
|
| SecondaryDNS | string | read-write (null) |
The IPv6 or IPv4 address of the secondary
DNS server for the iSCSI boot initiator.
|
| SecondaryLUN | integer | read-write (null) |
The logical unit number (LUN) for the
secondary iSCSI boot target.
|
| SecondaryTargetIPAddress | string | read-write (null) |
The IPv4 or IPv6 address for the secondary
iSCSI boot target.
|
| SecondaryTargetName | string | read-write (null) |
The name of the iSCSI secondary boot
target.
|
| SecondaryTargetTCPPort | integer | read-write (null) |
The TCP port for the secondary iSCSI boot
target.
|
| SecondaryVLANEnable | boolean | read-write (null) |
An indication of whether the secondary
VLAN is enabled.
|
| SecondaryVLANId | integer | read-write (null) |
The 802.1q VLAN ID to use for iSCSI boot
from the secondary target.
|
| TargetInfoViaDHCP | boolean | read-write (null) |
An indication of whether the iSCSI boot
target name, LUN, IP address, and netmask should be obtained from
DHCP.
|
| } | |||
| Limits (v1.7+) [ { | array | The byte and packet limits for this
network device function.
|
|
| BurstBytesPerSecond (v1.7+) | integer | read-write (null) |
The maximum number of bytes per second in
a burst for this network device function.
|
| BurstPacketsPerSecond (v1.7+) | integer | read-write (null) |
The maximum number of packets per second
in a burst for this network device function.
|
| Direction (v1.7+) | string (enum) |
read-write (null) |
Indicates the direction of the data to
which this limit applies.
|
| SustainedBytesPerSecond (v1.7+) | integer | read-write (null) |
The maximum number of sustained bytes per
second for this network device function.
|
| SustainedPacketsPerSecond (v1.7+) | integer | read-write (null) |
The maximum number of sustained packets
per second for this network device function.
|
| } ] | |||
| Links { | object | The links to other resources that are
related to this resource.
|
|
| Endpoints (v1.2+) [ { | array | An array of links to endpoints associated
with this network device function.
|
|
| @odata.id | string | read-only | Link to a Endpoint resource. See the Links section and the Endpoint schema for details. |
| } ] | |||
| EthernetInterface (v1.4+, deprecated v1.7 { | object | The link to a virtual Ethernet interface
that was created when one of the network device function VLANs is
represented as a virtual NIC for the purpose of showing the IP address
associated with that VLAN.
|
|
| @odata.id | string | read-only | Link to a EthernetInterface resource. See the Links section and the EthernetInterface schema for details. |
| } | |||
| EthernetInterfaces (v1.7+) [ { | array | The links to Ethernet interfaces that were
created when one of the network device function VLANs is represented as
a virtual NIC for the purpose of showing the IP address associated with
that VLAN.
|
|
| @odata.id | string | read-only | Link to a EthernetInterface resource. See the Links section and the EthernetInterface schema for details. |
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| OffloadProcessors (v1.7+) [ { | array | The processors that perform offload
computation for this network function, such as with a
SmartNIC.
|
|
| @odata.id | string | read-only | Link to a Processor resource. See the Links section and the Processor schema for details. |
| } ] | |||
| OffloadSystem (v1.7+) { | object | The system that performs offload
computation for this network function, such as with a
SmartNIC.
|
|
| @odata.id | string | read-only | Link to a ComputerSystem resource. See the Links section and the ComputerSystem schema for details. |
| } | |||
| PCIeFunction { | object | The link to the PCIe function associated
with this network device function.
|
|
| @odata.id | string | read-only | Link to a PCIeFunction resource. See the Links section and the PCIeFunction schema for details. |
| } | |||
| PhysicalNetworkPortAssignment (v1.5+) { | object | The physical port to which this network
device function is currently assigned.
|
|
| @odata.id | string | read-only | Link to a Port resource. See the Links section and the Port schema for details. |
| } | |||
| PhysicalPortAssignment (v1.3+, deprecated v1.5 { | object | The physical port to which this network
device function is currently assigned.
|
|
| @odata.id | string | read-only | Link to a NetworkPort resource. See the Links section and the NetworkPort schema for details. |
| } | |||
| } | |||
| MaxVirtualFunctions | integer | read-only (null) |
The number of virtual functions that are
available for this network device function.
|
| Metrics (v1.6+) { | object | (null) |
The link to the metrics associated with
this network function.
|
| @odata.id | string | read-only | Link to a NetworkDeviceFunctionMetrics resource. See the Links section and the NetworkDeviceFunctionMetrics schema for details. |
| } | |||
| NetDevFuncCapabilities [ ] | array (string (enum)) |
read-only (null) |
|
| NetDevFuncType | string (enum) |
read-write (null) |
The configured capability of this network
device function.
|
| PhysicalNetworkPortAssignment (v1.5+, deprecated v1.8 { | object | The physical port to which this network
device function is currently assigned.
|
|
| @odata.id | string | read-only | Link to a Port resource. See the Links section and the Port schema for details. |
| } | |||
| PhysicalPortAssignment (deprecated v1.3) { | object | The physical port to which this network
device function is currently assigned.
|
|
| @odata.id | string | read-only | Link to a NetworkPort resource. See the Links section and the NetworkPort schema for details. |
| } | |||
| SAVIEnabled (v1.7+) | boolean | read-write (null) |
Indicates if Source Address Validation
Improvement (SAVI) is enabled for this network device
function.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| VirtualFunctionsEnabled | boolean | read-only (null) |
An indication of whether single root
input/output virtualization (SR-IOV) virtual functions are enabled for
this network device function.
|
6.83.4 Property details
6.83.4.1 AuthenticationMethod
The iSCSI boot authentication method for this network device function.
- This property shall contain the iSCSI boot authentication method for this network device function.
| string | Description |
|---|---|
| CHAP | iSCSI Challenge Handshake Authentication Protocol (CHAP) authentication is used. |
| MutualCHAP | iSCSI Mutual Challenge Handshake Authentication Protocol (CHAP) authentication is used. |
| None | No iSCSI authentication is used. |
6.83.4.2 BootMode
The boot mode configured for this network device function.
- This property shall contain the boot mode configured
for this network device function. If the value is not
Disabled, this network device function shall be configured for boot by using the specified technology.
| string | Description |
|---|---|
| Disabled | Do not indicate to UEFI/BIOS that this device is bootable. |
| FibreChannel | Boot this device by using the embedded
Fibre Channel support and configuration. Only applicable if the
NetDevFuncType is FibreChannel. |
| FibreChannelOverEthernet | Boot this device by using the embedded
Fibre Channel over Ethernet (FCoE) boot support and configuration. Only
applicable if the NetDevFuncType is
FibreChannelOverEthernet. |
| HTTP (v1.9+) | Boot this device by using the embedded
HTTP/HTTPS support. Only applicable if the NetDevFuncType is
Ethernet. |
| iSCSI | Boot this device by using the embedded
iSCSI boot support and configuration. Only applicable if the
NetDevFuncType is iSCSI or Ethernet. |
| PXE | Boot this device by using the embedded PXE
support. Only applicable if the NetDevFuncType is Ethernet
or InfiniBand. |
6.83.4.3 Direction
Indicates the direction of the data to which this limit applies.
- This property shall indicate the direction of the data to which this limit applies for this network device function.
| string | Description |
|---|---|
| Egress | Indicates that this limit is enforced on packets and bytes transmitted by the network device function. |
| Ingress | Indicates that this limit is enforced on packets and bytes received by the network device function. |
| None | Indicates that this limit not enforced. |
6.83.4.4 IPAddressType
The type of IP address being populated in the iSCSIBoot IP address fields.
- This property shall contain the type of IP address being populated in the iSCSIBoot IP address fields. Mixing IPv6 and IPv4 addresses on the same network device function shall not be permissible.
| string | Description |
|---|---|
| IPv4 | IPv4 addressing is used for all IP-fields in this object. |
| IPv6 | IPv6 addressing is used for all IP-fields in this object. |
6.83.4.5 NetDevFuncCapabilities
- An array of capabilities for this network device function.
- This property shall contain an array of capabilities for this network device function.
| string | Description |
|---|---|
| Disabled | Neither enumerated nor visible to the operating system. |
| Ethernet | Appears to the operating system as an Ethernet device. |
| FibreChannel | Appears to the operating system as a Fibre Channel device. |
| FibreChannelOverEthernet | Appears to the operating system as an FCoE device. |
| InfiniBand | Appears to the operating system as an InfiniBand device. |
| iSCSI | Appears to the operating system as an iSCSI device. |
6.83.4.6 NetDevFuncType
The configured capability of this network device function.
- This property shall contain the configured capability of this network device function.
| string | Description |
|---|---|
| Disabled | Neither enumerated nor visible to the operating system. |
| Ethernet | Appears to the operating system as an Ethernet device. |
| FibreChannel | Appears to the operating system as a Fibre Channel device. |
| FibreChannelOverEthernet | Appears to the operating system as an FCoE device. |
| InfiniBand (v1.5+) | Appears to the operating system as an InfiniBand device. |
| iSCSI | Appears to the operating system as an iSCSI device. |
6.83.4.7 WWNSource
The configuration source of the World Wide Names (WWN) for this World Wide Node Name (WWNN) and World Wide Port Name (WWPN) connection.
- This property shall contain the configuration source of the World Wide Name (WWN) for this World Wide Node Name (WWNN) and World Wide Port Name (WWPN) connection.
| string | Description |
|---|---|
| ConfiguredLocally | The set of FC/FCoE boot targets was applied locally through API or UI. |
| ProvidedByFabric | The set of FC/FCoE boot targets was applied by the Fibre Channel fabric. |
6.83.5 Example response
{
"@odata.type": "#NetworkDeviceFunction.v1_9_0.NetworkDeviceFunction",
"Id": "111111111100",
"Name": "Network Device Function View",
"NetDevFuncType": "Ethernet",
"DeviceEnabled": true,
"NetDevFuncCapabilities": [
"Ethernet",
"FibreChannel"
],
"Ethernet": {
"PermanentMACAddress": "00:0C:29:9A:98:ED",
"MACAddress": "00:0C:29:9A:98:ED",
"MTUSize": 1500,
"VLAN": {
"VLANEnable": true,
"VLANId": 101
}
},
"iSCSIBoot": {
"IPAddressType": "IPv4",
"InitiatorIPAddress": "16.0.11.6",
"InitiatorName": "iqn.2005-03.com.acme:database-server",
"InitiatorDefaultGateway": "169.0.16.1",
"InitiatorNetmask": "255.255.252.0",
"TargetInfoViaDHCP": false,
"PrimaryTargetName": "iqn.2005-03.com.acme:image-server",
"PrimaryTargetIPAddress": "169.0.15.1",
"PrimaryTargetTCPPort": 3260,
"PrimaryLUN": 5,
"PrimaryVLANEnable": true,
"PrimaryVLANId": 1001,
"PrimaryDNS": "16.0.10.21",
"SecondaryTargetName": "iqn.2005-03.com.acme:image-server",
"SecondaryTargetIPAddress": "16.0.11.5",
"SecondaryTargetTCPPort": 3260,
"SecondaryLUN": 5,
"SecondaryVLANEnable": true,
"SecondaryVLANId": 1002,
"SecondaryDNS": "169.0.10.22",
"IPMaskDNSViaDHCP": false,
"RouterAdvertisementEnabled": false,
"AuthenticationMethod": "CHAP",
"CHAPUsername": "yosemite",
"CHAPSecret": "usrpasswd",
"MutualCHAPUsername": "yosemite",
"MutualCHAPSecret": "usrpasswd"
},
"FibreChannel": {
"PermanentWWPN": "10:00:B0:5A:DD:BB:74:E0",
"PermanentWWNN": "10:00:B0:5A:DD:BB:A1:B3",
"WWPN": "10:00:B0:5A:DD:BB:74:E0",
"WWNN": "10:00:B0:5A:DD:C4:D3:BB",
"WWNSource": "ConfiguredLocally",
"FCoELocalVLANId": 1001,
"AllowFIPVLANDiscovery": true,
"FCoEActiveVLANId": 2001,
"BootTargets": [
{
"WWPN": "10:00:B0:5A:DD:BB:74:FA",
"LUNID": "3",
"BootPriority": 0
}
]
},
"AssignablePhysicalNetworkPorts": [
{
"@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/9fd725a1/Ports/1"
}
],
"BootMode": "Disabled",
"VirtualFunctionsEnabled": true,
"MaxVirtualFunctions": 16,
"Links": {
"PCIeFunction": {
"@odata.id": "/redfish/v1/Systems/1/PCIeDevices/NIC/PCIeFunctions/1"
},
"PhysicalNetworkPortAssignment": {
"@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/9fd725a1/Ports/1"
}
},
"@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/9fd725a1/NetworkDeviceFunctions/111111111100"
}6.84 NetworkDeviceFunctionMetrics 1.1.1
| Version | v1.1 | v1.0 |
| Release | 2021.2 | 2021.1 |
6.84.1 Description
The NetworkDeviceFunctionMetrics schema contains usage and health statistics for a network function of a network adapter.
- This resource shall represent the network metrics for a single network function of a network adapter in a Redfish implementation.
6.84.2 URIs
/redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/NetworkDeviceFunctions/{NetworkDeviceFunctionId}/Metrics
6.84.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Ethernet { | object | The network function metrics specific to
Ethernet adapters.
|
|
| NumOffloadedIPv4Conns | integer | read-only (null) |
The total number of offloaded TCP/IPv4
connections.
|
| NumOffloadedIPv6Conns | integer | read-only (null) |
The total number of offloaded TCP/IPv6
connections.
|
| } | |||
| FibreChannel (v1.1+) { | object | The network function metrics specific to
Fibre Channel adapters.
|
|
| PortLoginAccepts (v1.1+) | integer | read-only (null) |
The total number of port login (PLOGI)
accept (ACC) responses.
|
| PortLoginRejects (v1.1+) | integer | read-only (null) |
The total number of port login (PLOGI)
reject (RJT) responses.
|
| PortLoginRequests (v1.1+) | integer | read-only (null) |
The total number of port login (PLOGI)
requests transmitted.
|
| RXCongestionFPINs (v1.1+) | integer | read-only (null) |
The total number of Congestion Fabric
Performance Impact Notifications (FPINs) received.
|
| RXDeliveryFPINs (v1.1+) | integer | read-only (null) |
The total number of Delivery Fabric
Performance Impact Notifications (FPINs) received.
|
| RXExchanges (v1.1+) | integer | read-only (null) |
The total number of Fibre Channel
exchanges received.
|
| RXLinkIntegrityFPINs (v1.1+) | integer | read-only (null) |
The total number of Link Integrity Fabric
Performance Impact Notifications (FPINs) received.
|
| RXPeerCongestionFPINs (v1.1+) | integer | read-only (null) |
The total number of Peer Congestion Fabric
Performance Impact Notifications (FPINs) received.
|
| RXSequences (v1.1+) | integer | read-only (null) |
The total number of Fibre Channel
sequences received.
|
| TXCongestionFPINs (v1.1+) | integer | read-only (null) |
The total number of Congestion Fabric
Performance Impact Notifications (FPINs) sent.
|
| TXDeliveryFPINs (v1.1+) | integer | read-only (null) |
The total number of Delivery Fabric
Performance Impact Notifications (FPINs) sent.
|
| TXExchanges (v1.1+) | integer | read-only (null) |
The total number of Fibre Channel
exchanges transmitted.
|
| TXLinkIntegrityFPINs (v1.1+) | integer | read-only (null) |
The total number of Link Integrity Fabric
Performance Impact Notifications (FPINs) sent.
|
| TXPeerCongestionFPINs (v1.1+) | integer | read-only (null) |
The total number of Peer Congestion Fabric
Performance Impact Notifications (FPINs) sent.
|
| TXSequences (v1.1+) | integer | read-only (null) |
The total number of Fibre Channel
sequences transmitted.
|
| } | |||
| RXAvgQueueDepthPercent | number (%) |
read-only (null) |
The average RX queue depth as the
percentage.
|
| RXBytes | integer (bytes) |
read-only (null) |
The total number of bytes received on a
network function.
|
| RXFrames | integer | read-only (null) |
The total number of frames received on a
network function.
|
| RXMulticastFrames | integer | read-only (null) |
The total number of good multicast frames
received on a network function since reset.
|
| RXQueuesEmpty | boolean | read-only (null) |
Whether nothing is in a network function's
RX queues to DMA.
|
| RXQueuesFull | integer | read-only (null) |
The number of RX queues that are
full.
|
| RXUnicastFrames | integer | read-only (null) |
The total number of good unicast frames
received on a network function since reset.
|
| TXAvgQueueDepthPercent | number (%) |
read-only (null) |
The average TX queue depth as the
percentage.
|
| TXBytes | integer (bytes) |
read-only (null) |
The total number of bytes sent on a
network function.
|
| TXFrames | integer | read-only (null) |
The total number of frames sent on a
network function.
|
| TXMulticastFrames | integer | read-only (null) |
The total number of good multicast frames
transmitted on a network function since reset.
|
| TXQueuesEmpty | boolean | read-only (null) |
Whether all TX queues for a network
function are empty.
|
| TXQueuesFull | integer | read-only (null) |
The number of TX queues that are
full.
|
| TXUnicastFrames | integer | read-only (null) |
The total number of good unicast frames
transmitted on a network function since reset.
|
6.84.4 Example response
{
"@odata.type": "#NetworkDeviceFunctionMetrics.v1_1_1.NetworkDeviceFunctionMetrics",
"Id": "NetworkDeviceFunctionMetrics",
"Name": "Network Device Function Metrics",
"TXAvgQueueDepthPercent": 13.7,
"RXAvgQueueDepthPercent": 21.2,
"RXFrames": 27193387,
"RXBytes": 7754199970,
"RXUnicastFrames": 26193387,
"RXMulticastFrames": 1000000,
"TXFrames": 18205770,
"TXBytes": 9436506547,
"TXUnicastFrames": 17205770,
"TXMulticastFrames": 1000000,
"TXQueuesEmpty": false,
"RXQueuesEmpty": false,
"TXQueuesFull": 0,
"RXQueuesFull": 0,
"Ethernet": {
"NumOffloadedIPv4Conns": 0,
"NumOffloadedIPv6Conns": 0
},
"@odata.id": "/redfish/v1/Chassis/1U/NetworkAdapters/Slot1/NetworkDeviceFunctions/SC2KP1F0/Metrics"
}6.85 NetworkInterface 1.2.1
| Version | v1.2 | v1.1 | v1.0 |
| Release | 2020.3 | 2017.1 | 2016.3 |
6.85.1 Description
The NetworkInterface schema describes links to the network adapters, network ports, and network device functions, and represents the functionality available to the containing system.
- This resource contains links to the network adapters, network ports, and network device functions, and represents the functionality available to the containing system.
6.85.2 URIs
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/NetworkInterfaces/{NetworkInterfaceId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/NetworkInterfaces/{NetworkInterfaceId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/NetworkInterfaces/{NetworkInterfaceId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/NetworkInterfaces/{NetworkInterfaceId}
/redfish/v1/Systems/{ComputerSystemId}/NetworkInterfaces/{NetworkInterfaceId}
6.85.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| NetworkAdapter { | object | The link to the network adapter that
contains this network interface.
|
|
| @odata.id | string | read-only | Link to a NetworkAdapter resource. See the Links section and the NetworkAdapter schema for details. |
| } | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| } | |||
| NetworkDeviceFunctions { | object | The link to the network device functions
associated with this network interface.
|
|
| @odata.id | string | read-only | Link to Collection of NetworkDeviceFunction. See the NetworkDeviceFunction schema for details. |
| } | |||
| NetworkPorts (deprecated v1.2) { | object | The link to the network ports associated
with this network interface.
|
|
| @odata.id | string | read-only | Link to Collection of NetworkPort. See the NetworkPort schema for details. |
| } | |||
| Ports (v1.2+) { | object | The link to the ports associated with this
network interface.
|
|
| @odata.id | string | read-only | Link to Collection of Port. See the Port schema for details. |
| } | |||
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
6.85.4 Example response
{
"@odata.type": "#NetworkInterface.v1_2_1.NetworkInterface",
"Id": "9fa725a1",
"Name": "Network Device View",
"NetworkPorts": {
"@odata.id": "/redfish/v1/Systems/1/NetworkInterfaces/9fd725a1/NetworkPorts"
},
"NetworkDeviceFunctions": {
"@odata.id": "/redfish/v1/Systems/1/NetworkInterfaces/9fd725a1/NetworkDeviceFunctions"
},
"Links": {
"NetworkAdapter": {
"@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/9fd725a1"
}
},
"@odata.id": "/redfish/v1/Systems/1/NetworkInterfaces/9fd725a1"
}6.86 NetworkPort 1.4.1 (deprecated)
| Version | v1.4 Deprecated | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2020.4 | 2020.3 | 2018.2 | 2017.1 | 2016.3 |
This schema has been deprecated and use in new implementations is discouraged except to retain compatibility with existing products. This schema has been deprecated in favor of the Port schema.
6.86.1 Description
The NetworkPort schema describes a network port, which is a discrete physical port that can connect to a network.
- This resource shall represent a discrete physical port that can connect to a network in a Redfish implementation.
6.86.2 URIs
/redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/NetworkPorts/{NetworkPortId}
(deprecated)
6.86.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| ActiveLinkTechnology | string (enum) |
read-write (null) |
Network port active link
technology.
|
| AssociatedNetworkAddresses [ ] | array (string, null) | read-only | An array of configured MAC or WWN network
addresses that are associated with this network port, including the
programmed address of the lowest numbered network device function, the
configured but not active address, if applicable, the address for
hardware port teaming, or other network addresses.
|
| CurrentLinkSpeedMbps (v1.2+) | integer (Mbit/s) |
read-write (null) |
Network port current link
speed.
|
| EEEEnabled | boolean | read-write (null) |
An indication of whether IEEE 802.3az
Energy-Efficient Ethernet (EEE) is enabled for this network
port.
|
| FCFabricName (v1.2+) | string | read-only (null) |
The FC Fabric Name provided by the
switch.
|
| FCPortConnectionType (v1.2+) | string (enum) |
read-only (null) |
The connection type of this
port.
|
| FlowControlConfiguration | string (enum) |
read-write (null) |
The locally configured 802.3x flow control
setting for this network port.
|
| FlowControlStatus | string (enum) |
read-only (null) |
The 802.3x flow control behavior
negotiated with the link partner for this network port
(Ethernet-only).
|
| LinkStatus | string (enum) |
read-only (null) |
The status of the link between this port
and its link partner.
|
| MaxFrameSize (v1.2+) | integer (bytes) |
read-only (null) |
The maximum frame size supported by the
port.
|
| NetDevFuncMaxBWAlloc [ { | array | An array of maximum bandwidth allocation
percentages for the network device functions associated with this
port.
|
|
| MaxBWAllocPercent | integer (%) |
read-write (null) |
The maximum bandwidth allocation
percentage allocated to the corresponding network device function
instance.
|
| NetworkDeviceFunction { | object | The link to the network device function
associated with this bandwidth setting of this network port.
|
|
| @odata.id | string | read-only | Link to a NetworkDeviceFunction resource. See the Links section and the NetworkDeviceFunction schema for details. |
| } | |||
| } ] | |||
| NetDevFuncMinBWAlloc [ { | array | An array of minimum bandwidth allocation
percentages for the network device functions associated with this
port.
|
|
| MinBWAllocPercent | integer (%) |
read-write (null) |
The minimum bandwidth allocation
percentage allocated to the corresponding network device function
instance.
|
| NetworkDeviceFunction { | object | The link to the network device function
associated with this bandwidth setting of this network port.
|
|
| @odata.id | string | read-only | Link to a NetworkDeviceFunction resource. See the Links section and the NetworkDeviceFunction schema for details. |
| } | |||
| } ] | |||
| NumberDiscoveredRemotePorts (v1.2+) | integer | read-only (null) |
The number of ports not on this adapter
that this port has discovered.
|
| PhysicalPortNumber | string | read-only (null) |
The physical port number label for this
port.
|
| PortMaximumMTU | integer | read-only (null) |
The largest maximum transmission unit
(MTU) that can be configured for this network port.
|
| SignalDetected | boolean | read-only (null) |
An indication of whether the port has
detected enough signal on enough lanes to establish a link.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| SupportedEthernetCapabilities [ ] | array (string (enum)) |
read-only (null) |
|
| SupportedLinkCapabilities [ { | array | The link capabilities of this
port.
|
|
| AutoSpeedNegotiation (v1.2+) | boolean | read-only (null) |
An indication of whether the port is
capable of autonegotiating speed.
|
| CapableLinkSpeedMbps (v1.2+) [ ] | array (integer, null) | read-only | The set of link speed capabilities of this
port.
|
| LinkNetworkTechnology | string (enum) |
read-only (null) |
The link network technology capabilities
of this port.
|
| LinkSpeedMbps (deprecated v1.2) | integer (Mbit/s) |
read-only (null) |
The speed of the link in Mbit/s when this
link network technology is active.
|
| } ] | |||
| VendorId (v1.2+) | string | read-only (null) |
The vendor Identification for this
port.
|
| WakeOnLANEnabled | boolean | read-write (null) |
An indication of whether Wake on LAN (WoL)
is enabled for this network port.
|
6.86.4 Property details
6.86.4.1 ActiveLinkTechnology
Network port active link technology.
- This property shall contain the configured link technology of this port.
| string | Description |
|---|---|
| Ethernet | The port is capable of connecting to an Ethernet network. |
| FibreChannel | The port is capable of connecting to a Fibre Channel network. |
| InfiniBand | The port is capable of connecting to an InfiniBand network. |
6.86.4.2 FCPortConnectionType
The connection type of this port.
- This property shall contain the connection type for this port.
| string | Description |
|---|---|
| ExtenderFabric | This port connection type is an extender fabric port. |
| Generic | This port connection type is a generic fabric port. |
| NotConnected | This port is not connected. |
| NPort | This port connects through an N-port to a switch. |
| PointToPoint | This port connects in a point-to-point configuration. |
| PrivateLoop | This port connects in a private loop configuration. |
| PublicLoop | This port connects in a public configuration. |
6.86.4.3 FlowControlConfiguration
The locally configured 802.3x flow control setting for this network port.
- This property shall contain the locally configured 802.3x flow control setting for this network port.
| string | Description |
|---|---|
| None | No IEEE 802.3x flow control is enabled on this port. |
| RX | The link partner can initiate IEEE 802.3x flow control. |
| TX | This station can initiate IEEE 802.3x flow control. |
| TX_RX | This station or the link partner can initiate IEEE 802.3x flow control. |
6.86.4.4 FlowControlStatus
The 802.3x flow control behavior negotiated with the link partner for this network port (Ethernet-only).
- This property shall contain the 802.3x flow control behavior negotiated with the link partner for this network port (Ethernet-only).
| string | Description |
|---|---|
| None | No IEEE 802.3x flow control is enabled on this port. |
| RX | The link partner can initiate IEEE 802.3x flow control. |
| TX | This station can initiate IEEE 802.3x flow control. |
| TX_RX | This station or the link partner can initiate IEEE 802.3x flow control. |
6.86.4.5 LinkNetworkTechnology
The link network technology capabilities of this port.
- This property shall contain a network technology capability of this port.
| string | Description |
|---|---|
| Ethernet | The port is capable of connecting to an Ethernet network. |
| FibreChannel | The port is capable of connecting to a Fibre Channel network. |
| InfiniBand | The port is capable of connecting to an InfiniBand network. |
6.86.4.6 LinkStatus
The status of the link between this port and its link partner.
- This property shall contain the link status between this port and its link partner.
| string | Description |
|---|---|
| Down | The port is enabled but link is down. |
| Starting (v1.3+) | This link on this interface is starting. A physical link has been established, but the port is not able to transfer data. |
| Training (v1.3+) | This physical link on this interface is training. |
| Up | The port is enabled and link is good (up). |
6.86.4.7 SupportedEthernetCapabilities
- The set of Ethernet capabilities that this port supports.
- This property shall contain an array of zero or more Ethernet capabilities supported by this port.
| string | Description |
|---|---|
| EEE | IEEE 802.3az Energy-Efficient Ethernet (EEE) is supported on this port. |
| WakeOnLAN | Wake on LAN (WoL) is supported on this port. |
6.86.5 Example response
{
"@odata.type": "#NetworkPort.v1_4_1.NetworkPort",
"Id": "1",
"Name": "Network Port View",
"PhysicalPortNumber": "1",
"LinkStatus": "Up",
"SupportedLinkCapabilities": [
{
"AutoSpeedNegotiation": true,
"LinkNetworkTechnology": "Ethernet",
"CapableLinkSpeedMbps": [
10,
100,
10000
]
}
],
"ActiveLinkTechnology": "Ethernet",
"SupportedEthernetCapabilities": [
"WakeOnLAN",
"EEE"
],
"NetDevFuncMinBWAlloc": [
{
"NetworkDeviceFunction": {
"@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/9fd725a1/NetworkDeviceFunctions/111111111100"
},
"MinBWAllocPercent": 25
}
],
"NetDevFuncMaxBWAlloc": [
{
"NetworkDeviceFunction": {
"@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/9fd725a1/NetworkDeviceFunctions/111111111100"
},
"MaxBWAllocPercent": 100
}
],
"AssociatedNetworkAddresses": [
"00:0C:29:9A:98:ED",
"00:0C:29:9A:98:EF"
],
"EEEEnabled": true,
"WakeOnLANEnabled": true,
"PortMaximumMTU": 1500,
"FlowControlStatus": "None",
"FlowControlConfiguration": "None",
"SignalDetected": true,
"@odata.id": "/redfish/v1/Chassis/1/NetworkAdapters/9fd725a1/NetworkPorts/1"
}6.87 OperatingConfig 1.0.2
| Version | v1.0 |
| Release | 2020.2 |
6.87.1 Description
The OperatingConfig schema specifies a configuration that can be used when the processor is operational.
- This resource shall represent an operational configuration for a processor in the Redfish Specification.
6.87.2 URIs
/redfish/v1/Systems/{ComputerSystemId}/Processors/{ProcessorId}/OperatingConfigs/{OperatingConfigId}
6.87.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| BaseSpeedMHz | integer (MHz) |
read-only (null) |
The base (nominal) clock speed of the
processor in MHz.
|
| BaseSpeedPrioritySettings [ { | array | The clock speed for sets of cores when the
configuration is operational.
|
|
| BaseSpeedMHz | integer (MHz) |
read-only (null) |
The clock speed to configure the set of
cores in MHz.
|
| CoreCount | integer | read-only (null) |
The number of cores to configure with a
specified speed.
|
| CoreIDs [ ] | array (integer, null) | read-only | The identifier of the cores to configure
with the specified speed.
|
| } ] | |||
| MaxJunctionTemperatureCelsius | integer (Celsius) |
read-only (null) |
The maximum temperature of the junction in
degrees Celsius.
|
| MaxSpeedMHz | integer (MHz) |
read-only (null) |
The maximum clock speed to which the
processor can be configured in MHz.
|
| TDPWatts | integer (Watts) |
read-only (null) |
The thermal design point of the processor
in watts.
|
| TotalAvailableCoreCount | integer | read-only (null) |
The number of cores in the processor that
can be configured.
|
| TurboProfile [ { | array | The turbo profiles for the processor. A
turbo profile is the maximum turbo clock speed as a function of the
number of active cores.
|
|
| ActiveCoreCount | integer | read-only (null) |
The number of active cores to be
configured with the specified maximum clock speed.
|
| MaxSpeedMHz | integer (MHz) |
read-only (null) |
The maximum turbo clock speed that
correspond to the number of active cores in MHz.
|
| } ] |
6.87.4 Example response
{
"@odata.type": "#OperatingConfig.v1_0_2.OperatingConfig",
"Id": "0",
"Name": "Processor Profile",
"TotalAvailableCoreCount": 28,
"TDPWatts": 150,
"BaseSpeedMHz": 2500,
"MaxSpeedMHz": 4100,
"MaxJunctionTemperatureCelsius": 90,
"TurboProfile": [
{
"ActiveCoreCount": 2,
"MaxSpeedMHz": 4100
},
{
"ActiveCoreCount": 4,
"MaxSpeedMHz": 4000
},
{
"ActiveCoreCount": 8,
"MaxSpeedMHz": 3800
},
{
"ActiveCoreCount": 28,
"MaxSpeedMHz": 3200
}
],
"BaseSpeedPrioritySettings": [
{
"CoreCount": 8,
"CoreIDs": [
0,
2,
3,
4,
5,
6,
7,
8
],
"BaseSpeedMHz": 2900
},
{
"CoreCount": 20,
"BaseSpeedMHz": 2200
}
],
"@odata.id": "/redfish/v1/Systems/operating-config-example/Processors/CPU1/OperatingConfigs/0"
}6.88 OperatingSystem 1.0.0
| Version | v1.0 |
| Release | 2023.2 |
6.88.1 Description
The OperatingSystem schema represents the operating system and software running on a computer system.
- This resource shall represent the operating system and software running on a computer system.
6.88.2 URIs
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/OperatingSystem
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/OperatingSystem
/redfish/v1/Systems/{ComputerSystemId}/OperatingSystem
6.88.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Applications { | object | The link to the collection of applications
running under this operating system.
|
|
| @odata.id | string | read-only | Link to Collection of Application. See the Application schema for details. |
| } | |||
| ContainerEngines [ { | array | The container engines running in this
operating system.
|
|
| ManagementURIs [ ] | array (URI) (string, null) |
read-only | The URIs to manage this container
engine.
|
| SupportedImageTypes [ ] | array (string (enum)) |
read-only (null) |
|
| Type | string (enum) |
read-only (null) |
The type of container engine.
|
| Version | string | read-only (null) |
The version of this container
engine.
|
| } ] | |||
| ContainerImages { | object | The link to the collection of container
images available to container engines on this operating
system.
|
|
| @odata.id | string | read-only | Link to Collection of ContainerImage. See the ContainerImage schema for details. |
| } | |||
| Containers { | object | The link to the collection of containers
running under this operating system.
|
|
| @odata.id | string | read-only | Link to Collection of Container. See the Container schema for details. |
| } | |||
| Kernel { | object | (null) |
The kernel information for this operating
system.
|
| Machine | string | read-only (null) |
The machine hardware name of the
kernel.
|
| Name | string | read-only (null) |
The name of the kernel.
|
| Release | string | read-only (null) |
The release of the kernel.
|
| Version | string | read-only (null) |
The version of the kernel.
|
| } | |||
| Links { | object | The links to other resources that are
related to this resource.
|
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| SoftwareImage { | object | The link to the software image for this
operating system.
|
|
| @odata.id | string | read-only | Link to a SoftwareInventory resource. See the Links section and the SoftwareInventory schema for details. |
| } | |||
| } | |||
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| Type | string (enum) |
read-only (null) |
The type of operating system.
|
| UptimeSeconds | integer | read-only (null) |
The wall-clock time this operating system
has been running in seconds.
|
| VirtualMachineEngines [ { | array | The virtual machine engines running in
this operating system.
|
|
| ManagementURIs [ ] | array (URI) (string, null) |
read-only | The URIs to manage this virtual machine
engine.
|
| SupportedImageTypes [ ] | array (string (enum)) |
read-only (null) |
|
| Type | string (enum) |
read-only (null) |
The type of virtual machine
engine.
|
| Version | string | read-only (null) |
The version of this virtual machine
engine.
|
| } ] |
6.88.4 Property details
6.88.4.1 SupportedImageTypes
6.88.4.1.1 In ContainerEngines:
- The supported image types for this container engine.
- This property shall contain the supported image types for this container engine.
| string | Description |
|---|---|
| DockerV1 | Docker V1.
|
| DockerV2 | Docker V2.
|
| OCI | OCI (Open Container
Initiative).
|
6.88.4.1.2 In VirtualMachineEngines:
- The supported image types for this container engine.
- This property shall contain the supported image types for this container engine.
| string | Description |
|---|---|
| OVA | OVA (Open Virtual Appliance).
|
| OVF | OVF (Open Virtualization
Format).
|
| QCOW | QCOW (QEMU Copy-on-Write).
|
| QCOW2 | QCOW2 (QEMU Copy-on-Write version
2).
|
| Raw | Raw disk image.
|
| VDI | VDI (Virtual Disk Image).
|
| VHD | VHD (Virtual Hard Disk).
|
| VMDK | VMDK (Virtual Machine Disk).
|
6.88.4.2 Type
6.88.4.2.1 In top level:
The type of operating system.
- This property shall contain the type for this operating system.
| string | Description |
|---|---|
| AIX | IBM AIX. |
| BSD | Berkeley Software Distribution. |
| HPUX | HPE HP-UX. |
| Hypervisor | A bare metal hypervisor. |
| IBMi | IBM i. |
| Linux | Linux. |
| macOS | Apple macOS. |
| Solaris | Oracle Solaris. |
| Windows | Microsoft Windows. |
6.88.4.2.2 In ContainerEngines:
The type of container engine.
- This property shall contain the type for this container engine.
| string | Description |
|---|---|
| containerd | containerd.
|
| CRIO | CRI-O .
|
| Docker | Docker.
|
6.88.4.2.3 In VirtualMachineEngines:
The type of virtual machine engine.
- This property shall contain the type for this virtual machine engine.
| string | Description |
|---|---|
| HyperV | Microsoft Hyper-V.
|
| KVM | KVM (Kernel-based Virtual
Machine).
|
| PowerVM | IBM PowerVM.
|
| QEMU | QEMU (Quick Emulator).
|
| VirtualBox | Oracle VM VirtualBox.
|
| VMwareESX | VMware ESX or ESXi.
|
| Xen | Xen.
|
6.88.5 Example response
{
"@odata.type": "#OperatingSystem.v1_0_0.OperatingSystem",
"Id": "OperatingSystem",
"Name": "OperatingSystem running on web-srv344",
"UptimeSeconds": 6720,
"Kernel": {
"Name": "Linux",
"Release": "5.10.13-x86_64",
"Version": "#1 SMP Thu Feb 4 13:56:42 EST 2021",
"Machine": "x86_64"
},
"Type": "Linux",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Applications": {
"@odata.id": "/redfish/v1/Systems/VM1/OperatingSystem/Applications"
},
"ContainerEngines": [
{
"Type": "Docker",
"Version": "20.10.5",
"SupportedImageTypes": [
"DockerV1",
"DockerV2",
"OCI"
],
"ManagementURIs": [
"https://192.168.0.12:5555"
]
}
],
"ContainerImages": {
"@odata.id": "/redfish/v1/Systems/VM1/OperatingSystem/ContainerImages"
},
"Containers": {
"@odata.id": "/redfish/v1/Systems/VM1/OperatingSystem/Containers"
},
"Links": {
"SoftwareImage": {
"@odata.id": "/redfish/v1/UpdateService/SoftwareInventory/ContosoLinux"
}
},
"@odata.id": "/redfish/v1/Systems/VM1/OperatingSystem"
}6.89 OutboundConnection 1.0.0
| Version | v1.0 |
| Release | 2023.2 |
6.89.1 Description
The OutboundConnection schema defines how the Redfish service connects to a remote client over a WebSocket connection. This allows a service behind a firewall to establish a connection to a remote client outside of the firewall.
- This resource shall represent the connection configuration necessary to connect to a remote client. Services shall initiate the outbound connection over a WebSocket defined in the 'Outbound connections' clause of the Redfish Specification.
6.89.2 URIs
/redfish/v1/AccountService/OutboundConnections/{OutboundConnectionId}
6.89.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Authentication | string (enum) |
read-only required on
create (null) |
The authentication mechanism for the
WebSocket connection.
|
| Certificates { | object | The link to a collection of server
certificates for the remote client referenced by the EndpointURI
property.
|
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| ClientCertificates { | object | The link to a collection of client
identity certificates provided to the remote client referenced by the
EndpointURI property.
|
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| ConnectionEnabled | boolean | read-write (null) |
Indicates if the outbound connection is
enabled.
|
| EndpointURI | string (URI) |
read-only required on create | The URI of the WebSocket connection to the
remote client.
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| Session { | object | (null) |
The link to the session for this outbound
connection.
|
| @odata.id | string | read-only | Link to a Session resource. See the Links section and the Session schema for details. |
| } | |||
| } | |||
| PreUpgradeHTTPHeaders { | object | The HTTP headers to send to the remote
client during the initial connection prior to the WebSocket upgrade.
This property is an empty object in responses.
|
|
| (pattern) | string | read-write | Property names follow regular expression pattern "^[^:\\s]+$" |
| } | |||
| RetryPolicy { | object | The retry policy for this outbound
connection.
|
|
| ConnectionRetryPolicy | string (enum) |
read-only (null) |
The type of retry policy for this outbound
connection.
|
| RetryCount | integer | read-write (null) |
The number of retries to attempt if the
retry policy specifies a maximum number of retries.
|
| RetryIntervalMinutes | integer | read-write (null) |
The retry interval in minutes.
|
| } | |||
| Roles [ ] | array (string, null) | read-only required on create | The Redfish roles that contain the
privileges of the remote client for the outbound connection.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| WebSocketPingIntervalMinutes | integer | read-write required on
create (null) |
Interval for sending the WebSocket ping
opcode in minutes. The value 0 indicates the ping opcode is
not sent.
|
6.89.4 Property details
6.89.4.1 Authentication
The authentication mechanism for the WebSocket connection.
- This property shall contain the authentication mechanism for the WebSocket connection.
| string | Description |
|---|---|
| JWT | JSON Web Token.
|
| MTLS | Mutual TLS.
|
| None | No authentication.
|
| OEM | OEM-specific.
|
6.89.4.2 ConnectionRetryPolicy
The type of retry policy for this outbound connection.
- This property shall contain the type of retry policy for this outbound connection.
| string | Description |
|---|---|
| None | No retries.
|
| RetryCount | Retry until a maximum count is
reached.
|
| RetryForever | Retry forever.
|
6.89.5 Example response
{
"@odata.type": "#OutboundConnection.v1_0_0.OutboundConnection",
"Id": "1",
"Name": "Outbound Connection to contoso app",
"Status": {
"Health": "OK",
"HealthRollup": "OK",
"State": "Enabled"
},
"Authentication": "MTLS",
"Certificates": {
"@odata.id": "/redfish/v1/AccountService/OutboundConnections/1/Certificates"
},
"ClientCertificates": {
"@odata.id": "/redfish/v1/AccountService/OutboundConnections/1/ClientCertificates"
},
"ConnectionEnabled": true,
"EndpointURI": "wss://ws.contoso.com:443",
"RetryPolicy": {
"ConnectionRetryPolicy": "RetryCount",
"RetryIntervalMinutes": 5,
"RetryCount": 60
},
"Roles": [
"Administrator"
],
"WebSocketPingIntervalMinutes": 10,
"@odata.id": "/redfish/v1/AccountService/OutboundConnections/1"
}6.90 Outlet 1.4.1
| Version | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2021.4 | 2021.3 | 2021.2 | 2020.3 | 2019.4 |
6.90.1 Description
The Outlet schema contains definition for an electrical outlet.
- This resource shall be used to represent an electrical outlet for a Redfish implementation.
6.90.2 URIs
/redfish/v1/PowerEquipment/ElectricalBuses/{PowerDistributionId}/Outlets/{OutletId}
/redfish/v1/PowerEquipment/FloorPDUs/{PowerDistributionId}/Outlets/{OutletId}
/redfish/v1/PowerEquipment/PowerShelves/{PowerDistributionId}/Outlets/{OutletId}
/redfish/v1/PowerEquipment/RackPDUs/{PowerDistributionId}/Outlets/{OutletId}
/redfish/v1/PowerEquipment/TransferSwitches/{PowerDistributionId}/Outlets/{OutletId}
6.90.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| ConfigurationLocked (v1.4+) | boolean | read-write | Indicates whether the configuration is
locked.
|
| CurrentAmps {} | object | The current (A) for this single phase
outlet.
|
|
| ElectricalConsumerNames (v1.3+) [ ] | array (string, null) | read-write | An array of names of downstream devices
that are powered by this outlet.
|
| ElectricalContext | string (enum) |
read-only (null) |
The combination of current-carrying
conductors.
|
| EnergykWh { | object (excerpt) |
The energy (kWh) for this
outlet.
|
|
| ApparentkVAh (v1.5+) | number (kV.A.h) |
read-only (null) |
Apparent energy (kVAh).
|
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| LifetimeReading (v1.1+) | number | read-only (null) |
The total accumulation value for this
sensor.
|
| ReactivekVARh (v1.5+) | number (kV.A.h) |
read-only (null) |
Reactive energy (kVARh).
|
| Reading | number | read-only (null) |
The sensor value.
|
| SensorResetTime | string (date-time) |
read-only (null) |
The date and time when the time-based
properties were last reset.
|
| } | |||
| FrequencyHz { | object (excerpt) |
The frequency (Hz) for this
outlet.
|
|
| 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 outlet.
|
| 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 outlet.
|
| @odata.id | string | read-only | Link to a Circuit resource. See the Links section and the Circuit schema for details. |
| } | |||
| Chassis (v1.3+) [ { | array | Any array of links to chassis connected to
this outlet.
|
|
| @odata.id | string | read-write | Link to a Chassis resource. See the Links section and the Chassis schema for details. |
| } ] | |||
| DistributionCircuits (v1.3+) [ { | array | An array of links to mains or input
circuits powered by this outlet.
|
|
| @odata.id | string | read-write | Link to a Circuit resource. See the Links section and the Circuit schema for details. |
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| PowerSupplies (v1.3+) [ { | array | An array of links to the power supplies
connected to this outlet.
|
|
| @odata.id | string | read-write | Link to a PowerSupply resource. See the Links section and the PowerSupply 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
outlet.
|
| OutletType | string (enum) |
read-only (null) |
The type of receptacle according to NEMA,
IEC, or regional standards.
|
| PhaseWiringType | string (enum) |
read-only (null) |
The number of ungrounded current-carrying
conductors (phases) and the total number of conductors
(wires).
|
| PolyPhaseCurrentAmps { | object | (null) |
The current readings for this
outlet.
|
| Line1 {} | object | Line 1 current (A).
|
|
| Line2 {} | object | Line 2 current (A).
|
|
| Line3 {} | object | Line 3 current (A).
|
|
| Neutral {} | object | Neutral line current (A).
|
|
| } | |||
| PolyPhaseVoltage { | object | (null) |
The voltage readings for this
outlet.
|
| Line1ToLine2 {} | object | The Line 1 to Line 2 voltage (V) for this
outlet.
|
|
| Line1ToNeutral {} | object | The Line 1 to Neutral voltage (V) for this
outlet.
|
|
| Line2ToLine3 {} | object | The Line 2 to Line 3 voltage (V) for this
outlet.
|
|
| Line2ToNeutral {} | object | The Line 2 to Neutral voltage (V) for this
outlet.
|
|
| Line3ToLine1 {} | object | The Line 3 to Line 1 voltage (V) for this
outlet.
|
|
| Line3ToNeutral {} | object | The Line 3 to Neutral voltage (V) for this
outlet.
|
|
| } | |||
| PowerControlLocked (v1.4+) | boolean | read-write | Indicates whether power control requests
are locked.
|
| PowerCycleDelaySeconds | number | read-write (null) |
The number of seconds to delay power on
after a PowerControl action to cycle power. Zero seconds indicates no
delay.
|
| PowerEnabled | boolean | read-only (null) |
Indicates if the outlet can be
powered.
|
| PowerLoadPercent (v1.2+) { | object (excerpt) |
The power load (percent) for this
outlet.
|
|
| 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.
|
| } | |||
| 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 outlet when
power is restored after a power loss.
|
| PowerState | string (enum) |
read-only (null) |
The power state of the outlet.
|
| PowerStateInTransition (v1.4+) | boolean | read-only | Indicates whether the power state is
undergoing a delayed transition.
|
| PowerWatts { | object (excerpt) |
The power (W) for this outlet.
|
|
| ApparentVA | number (V.A) |
read-only (null) |
The product of voltage and current for an
AC circuit, in volt-ampere units.
|
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| PhaseAngleDegrees (v1.5+) | number | read-only (null) |
The phase angle (degrees) between the
current and voltage waveforms.
|
| PowerFactor | number | read-only (null) |
The power factor for this
sensor.
|
| ReactiveVAR | number (V.A) |
read-only (null) |
The square root of the difference term of
squared apparent VA and squared power (Reading) for a circuit, in VAR
units.
|
| Reading | number | read-only (null) |
The sensor value.
|
| } | |||
| RatedCurrentAmps | number (A) |
read-only (null) |
The rated maximum current allowed for this
outlet.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| UserLabel (v1.3+) | string | read-write | A user-assigned label.
|
| Voltage {} | object | The voltage (V) for this single phase
outlet.
|
|
| VoltageType | string (enum) |
read-only (null) |
The type of voltage applied to the
outlet.
|
6.90.4 Actions
6.90.4.1 PowerControl
Description
This action turns the outlet on or off.
- This action shall control the power state of the outlet.
Action URI
{Base URI of target resource}/Actions/Outlet.PowerControl
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| PowerState | string (enum) |
optional | The desired power state of the
outlet.
|
Request Example
{
"PowerState": "PowerCycle"
}6.90.4.2 ResetMetrics
Description
This action resets metrics related to this outlet.
- This action shall reset any time intervals or counted values for this outlet.
Action URI
{Base URI of target resource}/Actions/Outlet.ResetMetrics
Action parameters
This action takes no parameters.
6.90.5 Property details
6.90.5.1 ElectricalContext
The combination of current-carrying conductors.
- This property shall contain the combination of current-carrying conductors that distribute power.
| 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.90.5.2 IndicatorLED
The state of the indicator LED, which identifies the outlet.
- This property shall contain the indicator light state for the indicator light associated with this outlet.
| string | Description |
|---|---|
| Blinking | The indicator LED is blinking.
|
| Lit | The indicator LED is lit.
|
| Off | The indicator LED is off.
|
6.90.5.3 NominalVoltage
The nominal voltage for this outlet.
- This property shall contain the nominal voltage for this outlet, in Volts.
| string | Description |
|---|---|
| AC100To127V | AC 100-127V nominal.
|
| 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.
|
| DC12V | DC 12V nominal.
|
| DC16V | DC 16V nominal.
|
| DC1_8V | DC 1.8V nominal.
|
| DC240V | DC 240V nominal.
|
| DC380V | High Voltage DC (380V).
|
| DC3_3V | DC 3.3V nominal.
|
| DC48V | DC 48V nominal.
|
| DC5V | DC 5V nominal.
|
| DC9V | DC 9V nominal.
|
| DCNeg48V | -48V DC.
|
6.90.5.4 OutletType
The type of receptacle according to NEMA, IEC, or regional standards.
- This property shall contain the type of physical receptacle used for this outlet, as defined by IEC, NEMA, or regional standard.
| string | Description |
|---|---|
| BS_1363_Type_G | BS 1363 Type G (250V; 13A).
|
| BusConnection (v1.3+) | Electrical bus connection.
|
| CEE_7_Type_E | CEE 7/7 Type E (250V; 16A).
|
| CEE_7_Type_F | CEE 7/7 Type F (250V; 16A).
|
| IEC_60320_C13 | IEC C13 (250V; 10A or 15A).
|
| IEC_60320_C19 | IEC C19 (250V; 16A or 20A).
|
| NEMA_5_15R | NEMA 5-15R (120V; 15A).
|
| NEMA_5_20R | NEMA 5-20R (120V; 20A).
|
| NEMA_L5_20R | NEMA L5-20R (120V; 20A).
|
| NEMA_L5_30R | NEMA L5-30R (120V; 30A).
|
| NEMA_L6_20R | NEMA L6-20R (250V; 20A).
|
| NEMA_L6_30R | NEMA L6-30R (250V; 30A).
|
| SEV_1011_TYPE_12 | SEV 1011 Type 12 (250V; 10A).
|
| SEV_1011_TYPE_23 | SEV 1011 Type 23 (250V; 16A).
|
6.90.5.5 PhaseWiringType
The number of ungrounded current-carrying conductors (phases) and the total number of conductors (wires).
- This property shall contain 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.90.5.6 PowerRestorePolicy
The desired power state of the outlet when power is restored after a power loss.
- This property shall contain the desired PowerState of
the outlet when power is applied. The value
LastStateshall return the outlet to the PowerState it was in when power was lost.
| 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.90.5.7 PowerState
6.90.5.7.1 In top level:
The power state of the outlet.
- This property shall contain the power state of the outlet.
| string | Description |
|---|---|
| Off | The resource is powered off. The components within the resource might continue to have AUX power. |
| On | The resource is powered on. |
| Paused | The resource is paused. |
| PoweringOff | A temporary state between on and off. The components within the resource can take time to process the power off action. |
| PoweringOn | A temporary state between off and on. The components within the resource can take time to process the power on action. |
6.90.5.7.2 In Actions: PowerControl:
The desired power state of the outlet.
- This parameter shall contain the desired power state of the outlet.
| string | Description |
|---|---|
| Off | Power off. |
| On | Power on. |
| PowerCycle | Power cycle.
|
6.90.5.8 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 percent (%
THD).
|
6.90.5.9 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 percent (%
THD).
|
6.90.5.10 VoltageType
The type of voltage applied to the outlet.
- This property shall contain the type of voltage applied to the outlet.
| string | Description |
|---|---|
| AC | Alternating Current (AC) outlet. |
| DC | Direct Current (DC) outlet. |
6.90.6 Example response
{
"@odata.type": "#Outlet.v1_4_1.Outlet",
"Id": "A1",
"Name": "Outlet A1, Branch Circuit A",
"Status": {
"Health": "OK",
"State": "Enabled"
},
"PhaseWiringType": "OnePhase3Wire",
"VoltageType": "AC",
"OutletType": "NEMA_5_20R",
"RatedCurrentAmps": 20,
"NominalVoltage": "AC120V",
"LocationIndicatorActive": true,
"PowerOnDelaySeconds": 4,
"PowerOffDelaySeconds": 0,
"PowerState": "On",
"PowerEnabled": true,
"Voltage": {
"DataSourceUri": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/VoltageA1",
"Reading": 117.5
},
"PolyPhaseVoltage": {
"Line1ToNeutral": {
"DataSourceUri": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/VoltageA1",
"Reading": 117.5
}
},
"CurrentAmps": {
"DataSourceUri": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/CurrentA1",
"Reading": 1.68
},
"PolyPhaseCurrentAmps": {
"Line1": {
"DataSourceUri": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/CurrentA1",
"Reading": 1.68
}
},
"PowerWatts": {
"DataSourceUri": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/PowerA1",
"Reading": 197.4,
"ApparentVA": 197.4,
"ReactiveVAR": 0,
"PowerFactor": 1
},
"FrequencyHz": {
"DataSourceUri": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/FrequencyA1",
"Reading": 60
},
"EnergykWh": {
"DataSourceUri": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/EnergyA1",
"Reading": 36166
},
"Actions": {
"#Outlet.PowerControl": {
"target": "/redfish/v1/PowerEquipment/RackPDUs/1/Outlets/A1/Outlet.PowerControl"
},
"#Outlet.ResetMetrics": {
"target": "/redfish/v1/PowerEquipment/RackPDUs/1/Outlets/A1/Outlet.ResetMetrics"
}
},
"Links": {
"BranchCircuit": {
"@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Branches/A"
}
},
"@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Outlets/A1"
}6.91 OutletGroup 1.1.1
| Version | v1.1 | v1.0 |
| Release | 2021.4 | 2019.4 |
6.91.1 Description
The OutletGroup schema contains definitions for an electrical outlet group.
- This resource shall be used to represent an electrical outlet group for a Redfish implementation.
6.91.2 URIs
/redfish/v1/PowerEquipment/ElectricalBuses/{PowerDistributionId}/OutletGroups/{OutletGroupId}
/redfish/v1/PowerEquipment/PowerShelves/{PowerDistributionId}/OutletGroups/{OutletGroupId}
/redfish/v1/PowerEquipment/RackPDUs/{PowerDistributionId}/OutletGroups/{OutletGroupId}
/redfish/v1/PowerEquipment/TransferSwitches/{PowerDistributionId}/OutletGroups/{OutletGroupId}
6.91.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| ConfigurationLocked (v1.1+) | boolean | read-write | Indicates whether the configuration is
locked.
|
| CreatedBy | string | read-write (null) |
The creator of this outlet
group.
|
| EnergykWh { | object (excerpt) |
The energy (kWh) for this outlet
group.
|
|
| ApparentkVAh (v1.5+) | number (kV.A.h) |
read-only (null) |
Apparent energy (kVAh).
|
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| LifetimeReading (v1.1+) | number | read-only (null) |
The total accumulation value for this
sensor.
|
| ReactivekVARh (v1.5+) | number (kV.A.h) |
read-only (null) |
Reactive energy (kVARh).
|
| Reading | number | read-only (null) |
The sensor value.
|
| SensorResetTime | string (date-time) |
read-only (null) |
The date and time when the time-based
properties were last reset.
|
| } | |||
| Links { | object | The links to other resources that are
related to this resource.
|
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| Outlets [ { | array | The set of outlets in this outlet
group.
|
|
| @odata.id | string | read-write | Link to a Outlet resource. See the Links section and the Outlet schema for details. |
| } ] | |||
| } | |||
| PowerControlLocked (v1.1+) | boolean | read-write | Indicates whether power control requests
are locked.
|
| PowerCycleDelaySeconds | number | read-write (null) |
The number of seconds to delay power on
after a PowerControl action to cycle power. Zero seconds indicates no
delay.
|
| PowerEnabled | boolean | read-only (null) |
Indicates if the outlet group 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 outlet
group when power is restored after a power loss.
|
| PowerState | string (enum) |
read-only (null) |
The power state of the outlet
group.
|
| PowerStateInTransition (v1.1+) | boolean | read-only | Indicates whether the power state is
undergoing a delayed transition.
|
| PowerWatts { | object (excerpt) |
The power (W) for this outlet
group.
|
|
| ApparentVA | number (V.A) |
read-only (null) |
The product of voltage and current for an
AC circuit, in volt-ampere units.
|
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| PhaseAngleDegrees (v1.5+) | number | read-only (null) |
The phase angle (degrees) between the
current and voltage waveforms.
|
| PowerFactor | number | read-only (null) |
The power factor for this
sensor.
|
| ReactiveVAR | number (V.A) |
read-only (null) |
The square root of the difference term of
squared apparent VA and squared power (Reading) for a circuit, in VAR
units.
|
| Reading | number | read-only (null) |
The sensor value.
|
| } | |||
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
6.91.4 Actions
6.91.4.1 PowerControl
Description
This action turns the outlet group on or off.
- This action shall control the power state of the outlet group.
Action URI
{Base URI of target resource}/Actions/OutletGroup.PowerControl
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| PowerState | string (enum) |
optional | The desired power state of the outlet
group.
|
Request Example
{
"PowerState": "Off"
}6.91.4.2 ResetMetrics
Description
This action resets metrics related to this outlet group.
- This action shall reset any time intervals or counted values for this outlet group.
Action URI
{Base URI of target resource}/Actions/OutletGroup.ResetMetrics
Action parameters
This action takes no parameters.
6.91.5 Property details
6.91.5.1 PowerRestorePolicy
The desired power state of the outlet group when power is restored after a power loss.
- This property shall contain the desired
PowerState of the outlet group when power is applied. The value
LastStateshall return the outlet group to the PowerState it was in when power was lost.
| 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.91.5.2 PowerState
6.91.5.2.1 In top level:
The power state of the outlet group.
- This property shall contain the power state of the outlet group.
| string | Description |
|---|---|
| Off | The resource is powered off. The components within the resource might continue to have AUX power. |
| On | The resource is powered on. |
| Paused | The resource is paused. |
| PoweringOff | A temporary state between on and off. The components within the resource can take time to process the power off action. |
| PoweringOn | A temporary state between off and on. The components within the resource can take time to process the power on action. |
6.91.5.2.2 In Actions: PowerControl:
The desired power state of the outlet group.
- This parameter shall contain the desired power state of the outlet group.
| string | Description |
|---|---|
| Off | Power off. |
| On | Power on. |
| PowerCycle | Power cycle.
|
6.91.6 Example response
{
"@odata.type": "#OutletGroup.v1_1_1.OutletGroup",
"Id": "Rack5Storage",
"Name": "Outlet Group Rack5Storage",
"Status": {
"Health": "OK",
"State": "Enabled"
},
"CreatedBy": "Bob",
"PowerOnDelaySeconds": 4,
"PowerOffDelaySeconds": 0,
"PowerState": "On",
"PowerEnabled": true,
"PowerWatts": {
"DataSourceUri": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/GroupPowerA",
"Reading": 412.36
},
"EnergykWh": {
"DataSourceUri": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/GroupEnergyA",
"Reading": 26880
},
"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": {
"#OutletGroup.PowerControl": {
"target": "/redfish/v1/PowerEquipment/RackPDUs/1/OutletGroups/Rack5Storage/OutletGroup.PowerControl"
},
"#OutletGroup.ResetMetrics": {
"target": "/redfish/v1/PowerEquipment/RackPDUs/1/OutletGroups/Rack5Storage/OutletGroup.ResetMetrics"
}
},
"@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/OutletGroups/Rack5Storage"
}6.92 PCIeDevice 1.12.0
| Version | v1.12 | v1.11 | v1.10 | v1.9 | v1.8 | v1.7 | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 | ... |
| Release | 2023.2 | 2022.3 | 2022.2 | 2021.4 | 2021.3 | 2021.1 | 2020.4 | 2020.3 | 2019.2 | 2018.2 | 2017.3 | ... |
6.92.1 Description
The PCIeDevice schema describes the properties of a PCIe device that is attached to a system. It also describes the location, such as a slot, socket, or bay, where a unit can be installed, by populating a resource instance with an absent state if a unit is not present.
- This
resource shall represent a PCIe device in a Redfish implementation. It
may also represent a location, such as a slot, socket, or bay, where a
unit may be installed, but the State property within the Status property
contains
Absent.
6.92.2 URIs
/redfish/v1/Chassis/{ChassisId}/PCIeDevices/{PCIeDeviceId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/PCIeDevices/{PCIeDeviceId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/PCIeDevices/{PCIeDeviceId}
/redfish/v1/Systems/{ComputerSystemId}/PCIeDevices/{PCIeDeviceId}
6.92.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Assembly (v1.2+) { | object | The link to the assembly associated with
this PCIe device.
|
|
| @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 PCIe
device.
|
| CXLDevice (v1.11+) { | object | (null) |
The CXL-specific properties of this PCIe
device.
|
| DeviceType (v1.11+) | string (enum) |
read-only (null) |
The CXL device type.
|
| DynamicCapacity (v1.12+) { | object | (null) |
The CXL dynamic capacity device (DCD)
information for this CXL device.
|
| AddCapacityPoliciesSupported (v1.12+) [ ] | array (string (enum)) |
read-only (null) |
|
| MaxDynamicCapacityRegions (v1.12+) | integer | read-only (null) |
The maximum number of dynamic capacity
memory regions available per host from this CXL device.
|
| MaxHosts (v1.12+) | integer | read-only (null) |
The maximum number of hosts supported by
this CXL device.
|
| MemoryBlockSizesSupported (v1.12+) [ { | array | The set of memory block sizes supported by
memory regions in this CXL device.
|
|
| BlockSizeMiB (v1.12+) [ ] | array (mebibytes) (integer, null) |
read-only | Set of memory block sizes supported by
this memory region defined in mebibytes (MiB).
|
| RegionNumber (v1.12+) | integer | read-only (null) |
The memory region number.
|
| } ] | |||
| ReleaseCapacityPoliciesSupported (v1.12+) [ ] | array (string (enum)) |
read-only (null) |
|
| SanitizationOnReleaseSupport (v1.12+) [ { | array | An indication of whether the sanitization
on capacity release is configurable for the memory regions in this CXL
device.
|
|
| RegionNumber (v1.12+) | integer | read-only (null) |
The memory region number.
|
| SanitizationOnReleaseSupported (v1.12+) | boolean | read-only (null) |
An indication of whether the sanitization
on capacity release is configurable for this memory region.
|
| } ] | |||
| TotalDynamicCapacityMiB (v1.12+) | integer (mebibytes) |
read-only (null) |
The total memory media capacity of the CXL
device available for dynamic assignment in mebibytes (MiB).
|
| } | |||
| EgressPortCongestionSupport (v1.11+) | boolean | read-only (null) |
Indicates whether the CXL device supports
egress port congestion management.
|
| MaxNumberLogicalDevices (v1.11+) | number | read-only (null) |
The maximum number of logical devices
supported by this CXL device.
|
| ThroughputReductionSupport (v1.11+) | boolean | read-only (null) |
Indicates whether the CXL device supports
throughput reduction.
|
| Timestamp (v1.11+) | string (date-time) |
read-write | The timestamp set on the CXL
device.
|
| } | |||
| CXLLogicalDevices (v1.11+) { | object | The link to the collection of CXL logical
devices within this PCIe device.
|
|
| @odata.id | string | read-only | Link to Collection of CXLLogicalDevice. See the CXLLogicalDevice schema for details. |
| } | |||
| DeviceType | string (enum) |
read-only | The device type for this PCIe
device.
|
| EnvironmentMetrics (v1.7+) { | object | The link to the environment metrics for
this PCIe device.
|
|
| @odata.id | string | read-only | Link to a EnvironmentMetrics resource. See the Links section and the EnvironmentMetrics schema for details. |
| } | |||
| FirmwareVersion | string | read-only (null) |
The version of firmware for this PCIe
device.
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| Chassis [ { | array | An array of links to the chassis in which
the PCIe device is contained.
|
|
| @odata.id | string | read-only | Link to a Chassis resource. See the Links section and the Chassis schema for details. |
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| PCIeFunctions (deprecated v1.4) [ { | array | An array of links to PCIe functions
exposed by this device.
|
|
| @odata.id | string | read-only | Link to a PCIeFunction resource. See the Links section and the PCIeFunction schema for details. |
| } ] | |||
| Processors (v1.12+) [ { | array | An array of links to the processors that
are directly connected or directly bridged to this PCIe
device.
|
|
| @odata.id | string | read-only | Link to a Processor resource. See the Links section and the Processor schema for details. |
| } ] | |||
| Switch (v1.10+) { | object | (null) |
The link to a switch that is associated
with this PCIe device.
|
| @odata.id | string | read-only | Link to a Switch resource. See the Links section and the Switch schema for details. |
| } | |||
| } | |||
| LocationIndicatorActive (v1.12+) | boolean | read-write (null) |
An indicator allowing an operator to
physically locate this resource.
|
| Manufacturer | string | read-only (null) |
The manufacturer of this PCIe
device.
|
| Model | string | read-only (null) |
The model number for the PCIe
device.
|
| PartNumber | string | read-only (null) |
The part number for this PCIe
device.
|
| PCIeFunctions (v1.4+) { | object | The link to the collection of PCIe
functions associated with this PCIe device.
|
|
| @odata.id | string | read-only | Link to Collection of PCIeFunction. See the PCIeFunction schema for details. |
| } | |||
| PCIeInterface (v1.3+) { | object | The PCIe interface details for this PCIe
device.
|
|
| LanesInUse (v1.3+) | integer | read-only (null) |
The number of PCIe lanes in use by this
device.
|
| MaxLanes (v1.3+) | integer | read-only (null) |
The number of PCIe lanes supported by this
device.
|
| MaxPCIeType (v1.3+) | string (enum) |
read-only (null) |
The highest version of the PCIe
specification supported by this device.
|
| Oem (v1.3+) {} | object | See the OEM object definition in the Using this guide clause. | |
| PCIeType (v1.3+) | string (enum) |
read-only (null) |
The version of the PCIe specification in
use by this device.
|
| } | |||
| ReadyToRemove (v1.7+) | boolean | read-write (null) |
An indication of whether the PCIe device
is prepared by the system for removal.
|
| SerialNumber | string | read-only (null) |
The serial number for this PCIe
device.
|
| SKU | string | read-only (null) |
The SKU for this PCIe device.
|
| Slot (v1.9+) { | object | (null) |
Information about the slot for this PCIe
device.
|
| HotPluggable (v1.12+) | boolean | read-only (null) |
An indication of whether this PCIe slot
supports hotplug.
|
| Lanes (v1.9+) | integer | read-only (null) |
The number of PCIe lanes supported by this
slot.
|
| LaneSplitting (v1.9+) | string (enum) |
read-only (null) |
The lane splitting strategy used in the
PCIe slot.
|
| Location (v1.9+) {} | object | The location of the PCIe slot.
|
|
| PCIeType (v1.9+) | string (enum) |
read-only (null) |
The PCIe specification this slot
supports.
|
| SlotType (v1.9+) | string (enum) |
read-only (null) |
The PCIe slot type.
|
| } | |||
| SparePartNumber (v1.6+) | string | read-only (null) |
The spare part number of the PCIe
device.
|
| StagedVersion (v1.11+) | string | read-only | The staged firmware version for this PCIe
device, but is not yet active.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| UUID (v1.5+) | string (uuid) |
read-only (null) |
The UUID for this PCIe device.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ |
6.92.4 Property details
6.92.4.1 AddCapacityPoliciesSupported
- The set of selection policies supported by the CXL device when dynamic capacity is added.
- This property shall contain the CXL Specification-defined dynamic capacity policies that are supported by this CXL device when dynamic capacity is added.
| string | Description |
|---|---|
| Contiguous | Contiguous add capacity
policy.
|
| Free | Free add capacity policy.
|
| Prescriptive | Prescriptive add or release
policy.
|
| TagBased | Tag-based release policy.
|
6.92.4.2 DeviceType
6.92.4.2.1 In top level:
The device type for this PCIe device.
- This property shall
contain the device type of the PCIe device such as
SingleFunctionorMultiFunction.
| string | Description |
|---|---|
| MultiFunction | A multi-function PCIe device. |
| Retimer (v1.10+) | A PCIe retimer device. |
| Simulated | A PCIe device that is not currently physically present, but is being simulated by the PCIe infrastructure. |
| SingleFunction | A single-function PCIe device. |
6.92.4.2.2 In CXLDevice:
The CXL device type.
- This property shall contain the CXL device type.
| string | Description |
|---|---|
| Type1 | A CXL Type 1 device.
|
| Type2 | A CXL Type 2 device.
|
| Type3 | A CXL Type 3 device.
|
6.92.4.3 LaneSplitting
The lane splitting strategy used in the PCIe slot.
- This property shall contain lane splitting information of the associated PCIe slot.
| string | Description |
|---|---|
| Bifurcated | The slot is bifurcated to split the lanes with associated devices. |
| Bridged | The slot has a bridge to share the lanes with associated devices. |
| None | The slot has no lane splitting. |
6.92.4.4 MaxPCIeType
The highest version of the PCIe specification supported by this device.
- This property shall contain the maximum PCIe specification that this device supports.
| string | Description |
|---|---|
| Gen1 | A PCIe v1.0 slot. |
| Gen2 | A PCIe v2.0 slot. |
| Gen3 | A PCIe v3.0 slot. |
| Gen4 | A PCIe v4.0 slot. |
| Gen5 | A PCIe v5.0 slot. |
6.92.4.5 PCIeType
The version of the PCIe specification in use by this device.
- This property shall contain the negotiated PCIe interface version in use by this device.
| string | Description |
|---|---|
| Gen1 | A PCIe v1.0 slot. |
| Gen2 | A PCIe v2.0 slot. |
| Gen3 | A PCIe v3.0 slot. |
| Gen4 | A PCIe v4.0 slot. |
| Gen5 | A PCIe v5.0 slot. |
6.92.4.6 ReleaseCapacityPoliciesSupported
- The set of removal policies supported by the CXL device when dynamic capacity is released.
- This property shall contain the CXL Specification-defined dynamic capacity policies that are supported by this CXL device when dynamic capacity is released.
| string | Description |
|---|---|
| Contiguous | Contiguous add capacity
policy.
|
| Free | Free add capacity policy.
|
| Prescriptive | Prescriptive add or release
policy.
|
| TagBased | Tag-based release policy.
|
6.92.4.7 SlotType
The PCIe slot type.
- This property shall contain the PCIe slot type.
| string | Description |
|---|---|
| FullLength | Full-Length PCIe slot. |
| HalfLength | Half-Length PCIe slot. |
| LowProfile | Low-Profile or Slim PCIe slot. |
| M2 | PCIe M.2 slot. |
| Mini | Mini PCIe slot. |
| OCP3Large | Open Compute Project 3.0 large form factor slot. |
| OCP3Small | Open Compute Project 3.0 small form factor slot. |
| OEM | An OEM-specific slot. |
| U2 | U.2 / SFF-8639 slot or bay. |
6.92.5 Example response
{
"@odata.type": "#PCIeDevice.v1_12_0.PCIeDevice",
"Id": "NIC",
"Name": "Simple Two-Port NIC",
"Description": "Simple Two-Port NIC PCIe Device",
"AssetTag": "ORD-4302015-18432RS",
"Manufacturer": "Contoso",
"Model": "SuperNIC 2000",
"SKU": "89587433",
"SerialNumber": "2M220100SL",
"PartNumber": "232-4598D7",
"DeviceType": "MultiFunction",
"FirmwareVersion": "12.342-343",
"Status": {
"State": "Enabled",
"Health": "OK",
"HealthRollup": "OK"
},
"PCIeInterface": {
"PCIeType": "Gen2",
"MaxPCIeType": "Gen3",
"LanesInUse": 4,
"MaxLanes": 4
},
"PCIeFunctions": {
"@odata.id": "/redfish/v1/Systems/1/PCIeDevices/NIC/PCIeFunctions"
},
"Links": {
"Chassis": [
{
"@odata.id": "/redfish/v1/Chassis/1"
}
]
},
"@odata.id": "/redfish/v1/Systems/1/PCIeDevices/NIC"
}6.93 PCIeFunction 1.5.0
| Version | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2022.3 | 2022.2 | 2021.1 | 2018.1 | 2017.1 | 2016.2 |
6.93.1 Description
The PCIeFunction schema describes the properties of a PCIe function that is attached to a system.
- This resource shall represent a PCIe function in a Redfish implementation.
6.93.2 URIs
/redfish/v1/Chassis/{ChassisId}/PCIeDevices/{PCIeDeviceId}/PCIeFunctions/{PCIeFunctionId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/PCIeDevices/{PCIeDeviceId}/PCIeFunctions/{PCIeFunctionId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/PCIeDevices/{PCIeDeviceId}/PCIeFunctions/{PCIeFunctionId}
/redfish/v1/Systems/{ComputerSystemId}/PCIeDevices/{PCIeDeviceId}/PCIeFunctions/{PCIeFunctionId}
6.93.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| ClassCode | string | read-only (null) |
The Class Code of this PCIe
function.
^0[xX]([0-9A-Fa-f]{2}){3}$ |
| DeviceClass | string (enum) |
read-only | The class for this PCIe
function.
|
| DeviceId | string | read-only (null) |
The Device ID of this PCIe
function.
^0[xX]([0-9A-Fa-f]{2}){2}$ |
| Enabled (v1.3+) | boolean | read-write | An indication of whether this PCIe device
function is enabled.
|
| FunctionId | integer | read-only (null) |
The PCIe function number.
|
| FunctionProtocol (v1.5+) | string (enum) |
read-only (null) |
The PCIe function protocol.
|
| FunctionType | string (enum) |
read-only | The type of the PCIe function.
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| CXLLogicalDevice (v1.5+) { | object | (null) |
The link to the CXL logical device to
which this function is assigned.
|
| @odata.id | string | read-only | Link to a CXLLogicalDevice resource. See the Links section and the CXLLogicalDevice schema for details. |
| } | |||
| Drives [ { | array | An array of links to the drives that this
PCIe function produces.
|
|
| @odata.id | string | read-only | Link to a Drive resource. See the Links section and the Drive schema for details. |
| } ] | |||
| EthernetInterfaces [ { | array | An array of links to the Ethernet
interfaces that this PCIe function produces.
|
|
| @odata.id | string | read-only | Link to a EthernetInterface resource. See the Links section and the EthernetInterface schema for details. |
| } ] | |||
| MemoryDomains (v1.5+) [ { | array | An array of links to the memory domains
that the PCIe function produces.
|
|
| @odata.id | string | read-only | Link to a MemoryDomain resource. See the Links section and the MemoryDomain schema for details. |
| } ] | |||
| NetworkDeviceFunctions (v1.2+) [ { | array | An array of links to the network device
functions that the PCIe function produces.
|
|
| @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 Using this guide clause. | |
| PCIeDevice { | object | The link to the PCIe device on which this
function resides.
|
|
| @odata.id | string | read-only | Link to a PCIeDevice resource. See the Links section and the PCIeDevice schema for details. |
| } | |||
| Processor (v1.4+) { | object | (null) |
The link to a processor that is hosted on
this PCIe function.
|
| @odata.id | string | read-only | Link to a Processor resource. See the Links section and the Processor schema for details. |
| } | |||
| StorageControllers [ { | array | An array of links to the storage
controllers that this PCIe function produces.
|
|
| @odata.id | string | read-only | Link to a StorageController resource. See the Links section and the Storage schema for details. |
| } ] | |||
| } | |||
| RevisionId | string | read-only (null) |
The Revision ID of this PCIe
function.
^0[xX]([0-9A-Fa-f]{2}){1}$ |
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| SubsystemId | string | read-only (null) |
The Subsystem ID of this PCIe
function.
^0[xX]([0-9A-Fa-f]{2}){2}$ |
| SubsystemVendorId | string | read-only (null) |
The Subsystem Vendor ID of this PCIe
function.
^0[xX]([0-9A-Fa-f]{2}){2}$ |
| VendorId | string | read-only (null) |
The Vendor ID of this PCIe
function.
^0[xX]([0-9A-Fa-f]{2}){2}$ |
6.93.4 Property details
6.93.4.1 DeviceClass
The class for this PCIe function.
- This property shall contain the device class of the PCIe device function, such as storage, network, or memory.
| string | Description |
|---|---|
| Bridge | A bridge. |
| CommunicationController | A communication controller. |
| Coprocessor | A coprocessor. |
| DisplayController | A display controller. |
| DockingStation | A docking station. |
| EncryptionController | An encryption controller. |
| GenericSystemPeripheral | A generic system peripheral. |
| InputDeviceController | An input device controller. |
| IntelligentController | An intelligent controller. |
| MassStorageController | A mass storage controller. |
| MemoryController | A memory controller. |
| MultimediaController | A multimedia controller. |
| NetworkController | A network controller. |
| NonEssentialInstrumentation | A non-essential instrumentation. |
| Other | Other class. The function Class Code needs to be verified. |
| ProcessingAccelerators | A processing accelerators. |
| Processor | A processor. |
| SatelliteCommunicationsController | A satellite communications controller. |
| SerialBusController | A serial bus controller. |
| SignalProcessingController | A signal processing controller. |
| UnassignedClass | An unassigned class. |
| UnclassifiedDevice | An unclassified device. |
| WirelessController | A wireless controller. |
6.93.4.2 FunctionProtocol
The PCIe function protocol.
- This property shall contain the protocol supported by this PCIe function.
| string | Description |
|---|---|
| CXL | A PCIe function supporting CXL extensions. |
| PCIe | A standard PCIe function. |
6.93.4.3 FunctionType
The type of the PCIe function.
- This property shall contain the function type of the PCIe device function such as physical or virtual.
| string | Description |
|---|---|
| Physical | A physical PCIe function. |
| Virtual | A virtual PCIe function. |
6.93.5 Example response
{
"@odata.type": "#PCIeFunction.v1_5_0.PCIeFunction",
"Id": "2",
"Name": "FC Port 2",
"Description": "FC Port 2",
"FunctionId": 2,
"FunctionType": "Physical",
"DeviceClass": "NetworkController",
"DeviceId": "0xABCD",
"VendorId": "0xABCD",
"ClassCode": "0x010802",
"RevisionId": "0x00",
"SubsystemId": "0xABCD",
"SubsystemVendorId": "0xABCD",
"Status": {
"State": "Enabled",
"Health": "OK",
"HealthRollup": "OK"
},
"Links": {
"PCIeDevice": {
"@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/FC"
}
},
"@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/FC/PCIeFunctions/2"
}6.94 PCIeSlots 1.6.0 (deprecated)
| Version | v1.6 Deprecated | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2023.2 | 2021.3 | 2020.3 | 2020.1 | 2019.4 | 2019.1 | 2018.2 |
This schema has been deprecated and use in new implementations is
discouraged except to retain compatibility with existing products.
This schema has been deprecated in favor of the PCIeDevice schema. Empty
PCIe slots should be represented by PCIeDevice resources using the
Absent value of the State property within Status.
6.94.1 Description
The PCIeSlots schema describes PCIe slot properties.
- This Resource shall represent a set of PCIe slot information for a Redfish implementation.
6.94.2 URIs
/redfish/v1/Chassis/{ChassisId}/PCIeSlots
6.94.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Slots [ { | array | An array of PCI Slot
information.
|
|
| HotPluggable (v1.1+) | boolean | read-only (null) |
An indication of whether this PCIe slot
supports hotplug.
|
| Lanes | integer | read-only (null) |
The number of PCIe lanes supported by this
slot.
|
| Links { | object | The links to other Resources that are
related to this Resource.
|
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| PCIeDevice [ { | array | An array of links to the PCIe devices
contained in this slot.
|
|
| @odata.id | string | read-only | Link to a PCIeDevice resource. See the Links section and the PCIeDevice schema for details. |
| } ] | |||
| Processors (v1.5+) [ { | array | An array of links to the processors that
are directly connected or directly bridged to this PCIe
slot.
|
|
| @odata.id | string | read-only | Link to a Processor resource. See the Links section and the Processor schema for details. |
| } ] | |||
| } | |||
| Location {} | object | The location of the PCIe slot.
|
|
| LocationIndicatorActive (v1.4+) | boolean | read-write (null) |
An indicator allowing an operator to
physically locate this resource.
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| PCIeType | string (enum) |
read-only (null) |
The PCIe specification supported by this
slot.
|
| SlotType | string (enum) |
read-only (null) |
The PCIe slot type for this
slot.
|
| Status {} | object | The status and health of the Resource and
its subordinate or dependent Resources.
|
|
| } ] |
6.94.4 Property details
6.94.4.1 PCIeType
The PCIe specification supported by this slot.
- This property shall contain the maximum PCIe specification that this slot supports.
| string | Description |
|---|---|
| Gen1 | A PCIe v1.0 slot. |
| Gen2 | A PCIe v2.0 slot. |
| Gen3 | A PCIe v3.0 slot. |
| Gen4 | A PCIe v4.0 slot. |
| Gen5 | A PCIe v5.0 slot. |
6.94.4.2 SlotType
The PCIe slot type for this slot.
- This property shall contain the slot type as specified by the PCIe specification.
| string | Description |
|---|---|
| FullLength | Full-Length PCIe slot. |
| HalfLength | Half-Length PCIe slot. |
| LowProfile | Low-Profile or Slim PCIe slot. |
| M2 | PCIe M.2 slot. |
| Mini | Mini PCIe slot. |
| OCP3Large (v1.2+) | Open Compute Project 3.0 large form factor slot. |
| OCP3Small (v1.2+) | Open Compute Project 3.0 small form factor slot. |
| OEM | An OEM-specific slot. |
| U2 (v1.3+) | U.2 / SFF-8639 slot or bay. |
6.94.5 Example response
{
"@odata.type": "#PCIeSlots.v1_6_0.PCIeSlots",
"Id": "1",
"Name": "PCIe Slot Information",
"Slots": [
{
"PCIeType": "Gen3",
"Lanes": 16,
"SlotType": "FullLength",
"Status": {
"State": "Enabled"
},
"Location": {
"PartLocation": {
"ServiceLabel": "Slot 1",
"LocationOrdinalValue": 1,
"LocationType": "Slot",
"Orientation": "LeftToRight",
"Reference": "Rear"
}
},
"Links": {
"PCIeDevice": [
{
"@odata.id": "/redfish/v1/Systems/1/PCIeDevices/NIC"
}
]
}
},
{
"PCIeType": "Gen4",
"Lanes": 4,
"SlotType": "FullLength",
"Status": {
"State": "Absent"
},
"Location": {
"PartLocation": {
"ServiceLabel": "Slot 2",
"LocationOrdinalValue": 2,
"LocationType": "Slot",
"Orientation": "LeftToRight",
"Reference": "Rear"
}
}
},
{
"PCIeType": "Gen3",
"Lanes": 1,
"SlotType": "HalfLength",
"Status": {
"State": "Absent"
},
"Location": {
"PartLocation": {
"ServiceLabel": "Slot 3",
"LocationOrdinalValue": 3,
"LocationType": "Slot",
"Orientation": "LeftToRight",
"Reference": "Rear"
}
}
}
],
"@odata.id": "/redfish/v1/Chassis/1/PCIeSlots"
}6.95 Port 1.10.0
| Version | v1.10 | v1.9 | v1.8 | v1.7 | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2023.2 | 2023.1 | 2022.3 | 2022.2 | 2021.4 | 2021.2 | 2021.1 | 2020.3 | 2019.4 | 2017.3 | 2016.2 |
6.95.1 Description
The Port schema contains properties that describe a port of a switch, controller, chassis, or any other device that could be connected to another entity.
- This resource contains a simple port for a Redfish implementation.
6.95.2 URIs
/redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}
/redfish/v1/Chassis/{ChassisId}/MediaControllers/{MediaControllerId}/Ports/{PortId}
/redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/Ports/{PortId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/Ports/{PortId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Controllers/{StorageControllerId}/Ports/{PortId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Ports/{PortId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/GraphicsControllers/{ControllerId}/Ports/{PortId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/Ports/{PortId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Controllers/{StorageControllerId}/Ports/{PortId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Ports/{PortId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/USBControllers/{ControllerId}/Ports/{PortId}
/redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortId}
/redfish/v1/Managers/{ManagerId}/DedicatedNetworkPorts/{PortId}
/redfish/v1/Managers/{ManagerId}/USBPorts/{PortId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/Ports/{PortId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Controllers/{StorageControllerId}/Ports/{PortId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Ports/{PortId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/GraphicsControllers/{ControllerId}/Ports/{PortId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/Ports/{PortId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Controllers/{StorageControllerId}/Ports/{PortId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Ports/{PortId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/USBControllers/{ControllerId}/Ports/{PortId}
/redfish/v1/Storage/{StorageId}/Controllers/{StorageControllerId}/Ports/{PortId}
/redfish/v1/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Ports/{PortId}
/redfish/v1/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}
/redfish/v1/Systems/{ComputerSystemId}/GraphicsControllers/{ControllerId}/Ports/{PortId}
/redfish/v1/Systems/{ComputerSystemId}/Processors/{ProcessorId}/Ports/{PortId}
/redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/Controllers/{StorageControllerId}/Ports/{PortId}
/redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Ports/{PortId}
/redfish/v1/Systems/{ComputerSystemId}/USBControllers/{ControllerId}/Ports/{PortId}
6.95.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| ActiveWidth (v1.2+) | integer | read-only | The number of active lanes for this
interface.
|
| CapableProtocolVersions (v1.4+) [ ] | array (string, null) | read-only | The protocol versions capable of being
sent over this port.
|
| CurrentProtocolVersion (v1.4+) | string | read-only (null) |
The protocol version being sent over this
port.
|
| CurrentSpeedGbps | number (Gbit/s) |
read-only (null) |
The current speed of this
port.
|
| CXL (v1.8+) { | object | (null) |
CXL properties for this port.
|
| Congestion (v1.8+) { | object | (null) |
The congestion properties for this CXL
port.
|
| BackpressureSampleInterval (v1.8+) | integer | read-write (null) |
The interval for the CXL
Specification-defined 'Egress Port Congestion' mechanism to take samples
in nanoseconds.
|
| CompletionCollectionInterval (v1.8+) | integer | read-write (null) |
The interval for the CXL
Specification-defined 'Completion Counting' mechanism to collect the
number of transmitted responses in a single counter in
nanoseconds.
|
| CongestionTelemetryEnabled (v1.8+) | boolean | read-write (null) |
Indicates whether congestion telemetry
collection is enabled for this port.
|
| EgressModeratePercentage (v1.8+) | integer (%) |
read-write (null) |
The threshold for moderate egress port
congestion as a percentage.
|
| EgressSeverePercentage (v1.8+) | integer (%) |
read-write (null) |
The threshold for severe egress port
congestion as a percentage.
|
| MaxSustainedRequestCmpBias (v1.8+) | integer | read-write (null) |
The estimated maximum sustained sum of
requests and recent responses across the entire device, serving as the
basis for the CXL Specification-defined 'QoS Limit
Fraction'.
|
| } | |||
| ConnectedDeviceMode (v1.8+) | string (enum) |
read-only (null) |
The connected device mode.
|
| ConnectedDeviceType (v1.8+) | string (enum) |
read-only (null) |
The connected device type.
|
| CurrentPortConfigurationState (v1.8+) | string (enum) |
read-only (null) |
The current port configuration
state.
|
| MaxLogicalDeviceCount (v1.8+) | integer | read-only (null) |
The maximum number of logical devices
supported.
|
| QoSTelemetryCapabilities (v1.8+) { | object | (null) |
The quality of service telemetry
capabilities for this CXL port.
|
| EgressPortBackpressureSupported (v1.8+) | boolean | read-only (null) |
Indicates whether the port supports the
CXL Specification-defined 'Egress Port Backpressure'
mechanism.
|
| TemporaryThroughputReductionSupported (v1.8+) | boolean | read-only (null) |
Indicates whether the port supports the
CXL Specification-defined 'Temporary Throughput Reduction'
mechanism.
|
| } | |||
| TemporaryThroughputReductionEnabled (v1.8+) | boolean | read-write (null) |
Indicates whether temporary throughput
reduction is enabled.
|
| } | |||
| Enabled (v1.4+, deprecated v1.10 | boolean | read-write | An indication of whether this port is
enabled.
|
| EnvironmentMetrics (v1.4+) { | object | The link to the environment metrics for
this port or any attached small form-factor pluggable (SFP)
device.
|
|
| @odata.id | string | read-only | Link to a EnvironmentMetrics resource. See the Links section and the EnvironmentMetrics schema for details. |
| } | |||
| Ethernet (v1.3+) { | object | (null) |
Ethernet properties for this
port.
|
| AssociatedMACAddresses (v1.4+) [ ] | array (string, null) | read-only | An array of configured MAC addresses that
are associated with this network port, including the programmed address
of the lowest numbered network device function, the configured but not
active address, if applicable, the address for hardware port teaming, or
other network addresses.
^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$ |
| EEEEnabled (v1.5+) | boolean | read-write (null) |
Indicates whether IEEE 802.3az
Energy-Efficient Ethernet (EEE) is enabled on this port.
|
| FlowControlConfiguration (v1.3+) | string (enum) |
read-write (null) |
The locally configured 802.3x flow control
setting for this port.
|
| FlowControlStatus (v1.3+) | string (enum) |
read-only (null) |
The 802.3x flow control behavior
negotiated with the link partner for this port.
|
| LLDPEnabled (v1.4+) | boolean | read-write | Enable/disable LLDP for this
port.
|
| LLDPReceive (v1.4+) { | object | (null) |
LLDP data being received on this
link.
|
| ChassisId (v1.4+) | string | read-only (null) |
Link Layer Data Protocol (LLDP) chassis ID
received from the remote partner across this link.
|
| ChassisIdSubtype (v1.4+) | string (enum) |
read-only (null) |
The type of identifier used for the
chassis ID received from the remote partner across this
link.
|
| ManagementAddressIPv4 (v1.4+) | string | read-only (null) |
The IPv4 management address received from
the remote partner across this link.
^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$ |
| ManagementAddressIPv6 (v1.4+) | string | read-only (null) |
The IPv6 management address received from
the remote partner across this link.
|
| ManagementAddressMAC (v1.4+) | string | read-only (null) |
The management MAC address received from
the remote partner across this link.
^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$ |
| ManagementVlanId (v1.4+) | integer | read-only (null) |
The management VLAN ID received from the
remote partner across this link.
|
| PortId (v1.4+) | string | read-only (null) |
A colon delimited string of hexadecimal
octets identifying a port.
^([0-9A-F]{2})([:]([0-9A-F]){2}){0,63}$ |
| PortIdSubtype (v1.4+) | string (enum) |
read-only (null) |
The port ID subtype received from the
remote partner across this link.
|
| SystemCapabilities (v1.8+) [ ] | array (string (enum)) |
read-only (null) |
|
| SystemDescription (v1.8+) | string | read-only (null) |
The system description received from the
remote partner across this link.
|
| SystemName (v1.8+) | string | read-only (null) |
The system name received from the remote
partner across this link.
|
| } | |||
| LLDPTransmit (v1.4+) { | object | (null) |
LLDP data being transmitted on this
link.
|
| ChassisId (v1.4+) | string | read-write (null) |
Link Layer Data Protocol (LLDP) chassis
ID.
|
| ChassisIdSubtype (v1.4+) | string (enum) |
read-write (null) |
The type of identifier used for the
chassis ID.
|
| ManagementAddressIPv4 (v1.4+) | string | read-write (null) |
The IPv4 management address to be
transmitted from this endpoint.
(^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$)|(^$) |
| ManagementAddressIPv6 (v1.4+) | string | read-write (null) |
The IPv6 management address to be
transmitted from this endpoint.
|
| ManagementAddressMAC (v1.4+) | string | read-write (null) |
The management MAC address to be
transmitted from this endpoint.
(^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$)|(^$) |
| ManagementVlanId (v1.4+) | integer | read-write (null) |
The management VLAN ID to be transmitted
from this endpoint.
|
| PortId (v1.4+) | string | read-write (null) |
A colon delimited string of hexadecimal
octets identifying a port to be transmitted from this
endpoint.
(^([0-9A-F]{2})([:]([0-9A-F]){2}){0,63}$)|(^$) |
| PortIdSubtype (v1.4+) | string (enum) |
read-write (null) |
The port ID subtype to be transmitted from
this endpoint.
|
| SystemCapabilities (v1.8+) [ ] | array (string (enum)) |
read-write (null) |
|
| SystemDescription (v1.8+) | string | read-write (null) |
The system description to be transmitted
from this endpoint.
|
| SystemName (v1.8+) | string | read-write (null) |
The system name to be transmitted from
this endpoint.
|
| } | |||
| SupportedEthernetCapabilities (v1.3+, deprecated v1.5 [ ] | array (string (enum)) |
read-only (null) |
|
| WakeOnLANEnabled (v1.5+) | boolean | read-write (null) |
Indicates whether Wake on LAN (WoL) is
enabled on this port.
|
| } | |||
| FibreChannel (v1.3+) { | object | (null) |
Fibre Channel properties for this
port.
|
| AssociatedWorldWideNames (v1.4+) [ ] | array (string, null) | read-only | An array of configured World Wide Names
(WWN) that are associated with this network port, including the
programmed address of the lowest numbered network device function, the
configured but not active address, if applicable, the address for
hardware port teaming, or other network addresses.
^([0-9A-Fa-f]{2}[:-]){7}([0-9A-Fa-f]{2})$ |
| FabricName (v1.3+) | string | read-only (null) |
The Fibre Channel Fabric Name provided by
the switch.
|
| NumberDiscoveredRemotePorts (v1.3+) | integer | read-only (null) |
The number of ports not on the associated
device that the associated device has discovered through this
port.
|
| PortConnectionType (v1.3+) | string (enum) |
read-only (null) |
The connection type of this
port.
|
| } | |||
| FunctionMaxBandwidth (v1.4+) [ { | array | An array of maximum bandwidth allocation
percentages for the functions associated with this port.
|
|
| AllocationPercent (v1.4+) | integer (%) |
read-write (null) |
The maximum bandwidth allocation
percentage allocated to the corresponding network device function
instance.
|
| NetworkDeviceFunction (v1.4+) { | object | The link to the network device function
associated with this bandwidth setting of this network port.
|
|
| @odata.id | string | read-only | Link to a NetworkDeviceFunction resource. See the Links section and the NetworkDeviceFunction schema for details. |
| } | |||
| } ] | |||
| FunctionMinBandwidth (v1.4+) [ { | array | An array of minimum bandwidth allocation
percentages for the functions associated with this port.
|
|
| AllocationPercent (v1.4+) | integer (%) |
read-write (null) |
The minimum bandwidth allocation
percentage allocated to the corresponding network device function
instance.
|
| NetworkDeviceFunction (v1.4+) { | object | The link to the network device function
associated with this bandwidth setting of this network port.
|
|
| @odata.id | string | read-only | Link to a NetworkDeviceFunction resource. See the Links section and the NetworkDeviceFunction schema for details. |
| } | |||
| } ] | |||
| GenZ (v1.2+) { | object | Gen-Z specific properties.
|
|
| LPRT (v1.2+) { | object | The Linear Packet Relay Table for the
port.
|
|
| @odata.id | string | read-only | Link to Collection of RouteEntry. See the RouteEntry schema for details. |
| } | |||
| MPRT (v1.2+) { | object | the Multi-subnet Packet Relay Table for
the port.
|
|
| @odata.id | string | read-only | Link to Collection of RouteEntry. See the RouteEntry schema for details. |
| } | |||
| VCAT (v1.2+) { | object | the Virtual Channel Action Table for the
port.
|
|
| @odata.id | string | read-only | Link to Collection of VCATEntry. See the VCATEntry schema for details. |
| } | |||
| } | |||
| InfiniBand (v1.6+) { | object | (null) |
InfiniBand properties for this
port.
|
| AssociatedNodeGUIDs (v1.6+) [ ] | array (string, null) | read-only | An array of configured node GUIDs that are
associated with this network port, including the programmed address of
the lowest numbered network device function, the configured but not
active address, if applicable, the address for hardware port teaming, or
other network addresses.
^([0-9A-Fa-f]{4}[:-]){3}([0-9A-Fa-f]{4})$ |
| AssociatedPortGUIDs (v1.6+) [ ] | array (string, null) | read-only | An array of configured port GUIDs that are
associated with this network port, including the programmed address of
the lowest numbered network device function, the configured but not
active address, if applicable, the address for hardware port teaming, or
other network addresses.
^([0-9A-Fa-f]{4}[:-]){3}([0-9A-Fa-f]{4})$ |
| AssociatedSystemGUIDs (v1.6+) [ ] | array (string, null) | read-only | An array of configured system GUIDs that
are associated with this network port, including the programmed address
of the lowest numbered network device function, the configured but not
active address, if applicable, the address for hardware port teaming, or
other network addresses.
^([0-9A-Fa-f]{4}[:-]){3}([0-9A-Fa-f]{4})$ |
| } | |||
| InterfaceEnabled (v1.2+) | boolean | read-write (null) |
An indication of whether the port is
enabled.
|
| LinkConfiguration (v1.3+) [ { | array | The link configuration of this
port.
|
|
| AutoSpeedNegotiationCapable (v1.3+) | boolean | read-only (null) |
An indication of whether the port is
capable of autonegotiating speed.
|
| AutoSpeedNegotiationEnabled (v1.3+) | boolean | read-write (null) |
Controls whether this port is configured
to enable autonegotiating speed.
|
| CapableLinkSpeedGbps (v1.3+) [ ] | array (Gbit/s) (number, null) |
read-only | The set of link speed capabilities of this
port.
|
| ConfiguredNetworkLinks (v1.3+) [ { | array | The set of link speed and width pairs this
port is configured to use for autonegotiation.
|
|
| ConfiguredLinkSpeedGbps (v1.3+) | number (Gbit/s) |
read-write (null) |
The link speed per lane this port is
configured to use for autonegotiation.
|
| ConfiguredWidth (v1.3+) | integer | read-write (null) |
The link width this port is configured to
use for autonegotiation in conjunction with the link speed.
|
| } ] | |||
| } ] | |||
| LinkNetworkTechnology (v1.2+) | string (enum) |
read-only (null) |
The link network technology capabilities
of this port.
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| AssociatedEndpoints [ { | array | An array of links to the endpoints at the
other end of the link.
|
|
| @odata.id | string | read-only | Link to a Endpoint resource. See the Links section and the Endpoint schema for details. |
| } ] | |||
| Cables (v1.5+) [ { | array | An array of links to the cables connected
to this port.
|
|
| @odata.id | string | read-only | Link to a Cable resource. See the Links section and the Cable schema for details. |
| } ] | |||
| ConnectedPorts (v1.2+) [ { | array | An array of links to the remote device
ports at the other end of the link.
|
|
| @odata.id | string | read-only | Link to another Port resource. |
| } ] | |||
| ConnectedSwitches [ { | array | An array of links to the switches at the
other end of the link.
|
|
| @odata.id | string | read-only | Link to a Switch resource. See the Links section and the Switch schema for details. |
| } ] | |||
| ConnectedSwitchPorts [ { | array | An array of links to the switch ports at
the other end of the link.
|
|
| @odata.id | string | read-only | Link to another Port resource. |
| } ] | |||
| EthernetInterfaces (v1.7+) [ { | array | The links to the Ethernet interfaces this
port provides.
|
|
| @odata.id | string | read-only | Link to a EthernetInterface resource. See the Links section and the EthernetInterface schema for details. |
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| } | |||
| LinkState (v1.2+) | string (enum) |
read-write | The desired link state for this
interface.
|
| LinkStatus (v1.2+) | string (enum) |
read-only | The link status for this
interface.
|
| LinkTransitionIndicator (v1.2+) | integer | read-write | The number of link state transitions for
this interface.
|
| Location (v1.1+) {} | object | The location of the port.
|
|
| LocationIndicatorActive (v1.3+) | boolean | read-write (null) |
An indicator allowing an operator to
physically locate this resource.
|
| MaxFrameSize (v1.3+) | integer (bytes) |
read-only (null) |
The maximum frame size supported by the
port.
|
| MaxSpeedGbps | number (Gbit/s) |
read-only (null) |
The maximum speed of this port as
currently configured.
|
| Metrics (v1.2+) { | object | (null) |
The link to the metrics associated with
this port.
|
| @odata.id | string | read-only | Link to a PortMetrics resource. See the Links section and the PortMetrics schema for details. |
| } | |||
| PortId | string | read-only (null) |
The label of this port on the physical
package for this port.
|
| PortMedium (v1.2+) | string (enum) |
read-only (null) |
The physical connection medium for this
port.
|
| PortProtocol | string (enum) |
read-only (null) |
The protocol being sent over this
port.
|
| PortType | string (enum) |
read-only (null) |
The type of this port.
|
| RemotePortId (v1.8+) | string | read-only (null) |
The identifier of the remote port to which
this port is connected.
|
| SFP (v1.4+) { | object | (null) |
The small form-factor pluggable (SFP)
device associated with this port.
|
| FiberConnectionType (v1.4+) | string (enum) |
read-only (null) |
The type of fiber connection currently
used by this SFP.
|
| Manufacturer (v1.4+) | string | read-only (null) |
The manufacturer of this SFP.
|
| MediumType (v1.4+) | string (enum) |
read-only (null) |
The medium type connected to this
SFP.
|
| PartNumber (v1.4+) | string | read-only (null) |
The part number for this SFP.
|
| SerialNumber (v1.4+) | string | read-only (null) |
The serial number for this
SFP.
|
| Status (v1.4+) {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| SupportedSFPTypes (v1.4+) [ ] | array (string (enum)) |
read-only (null) |
|
| Type (v1.4+) | string (enum) |
read-only (null) |
The type of SFP device that is attached to
this port.
|
| } | |||
| SignalDetected (v1.2+) | boolean | read-only (null) |
An indication of whether a signal is
detected on this interface.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| Width | integer | read-only (null) |
The number of lanes, phys, or other
physical transport links that this port contains.
|
6.95.4 Actions
6.95.4.1 Reset
Description
This action resets this port.
- This action shall reset this port.
Action URI
{Base URI of target resource}/Actions/Port.Reset
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| ResetType | string (enum) |
optional | The type of reset.
|
Request Example
{
"ResetType": "ForceRestart"
}6.95.4.2 ResetPPB (v1.8+)
Description
This action resets the PCI-to-PCI bridge (PPB) for this port.
- This action shall reset the PCI-to-PCI bridge (PPB) for this port.
Action URI
{Base URI of target resource}/Actions/Port.ResetPPB
Action parameters
This action takes no parameters.
6.95.5 Property details
6.95.5.1 ChassisIdSubtype
The type of identifier used for the chassis ID received from the remote partner across this link.
- This property shall contain the IEEE 802.1AB-2009 chassis ID subtype received from the remote partner across this link. If no such chassis ID subtype has been received, this property should not be present.
| string | Description |
|---|---|
| AgentId | Agent circuit ID, based on the agent-local identifier of the circuit as defined in RFC3046. |
| ChassisComp | Chassis component, based in the value of entPhysicalAlias in RFC4133. |
| IfAlias | Interface alias, based on the ifAlias MIB object. |
| IfName | Interface name, based on the ifName MIB object. |
| LocalAssign | Locally assigned, based on a alpha-numeric value locally assigned. |
| MacAddr | MAC address, based on an agent detected unicast source address as defined in IEEE standard 802. |
| NetworkAddr | Network address, based on an agent detected network address. |
| NotTransmitted | No data to be sent to/received from remote partner. |
| PortComp | Port component, based in the value of entPhysicalAlias in RFC4133. |
6.95.5.2 ConnectedDeviceMode
The connected device mode.
- This property shall contain the CXL Specification-defined 'Connected Device Mode'.
| string | Description |
|---|---|
| CXL68BFlitAndVH | CXL 68B flit and VH.
|
| CXLLatencyOptimized256BFlit | CXL latency-optimized 256B
flit.
|
| Disconnected | The connection is not CXL or is
disconnected.
|
| PBR | Port-based routing (PBR).
|
| RCD | Restricted CXL device (RCD).
|
| Standard256BFlit | Standard 256B flit.
|
6.95.5.3 ConnectedDeviceType
The connected device type.
- This property shall contain the CXL Specification-defined 'Connected Device Type'.
| string | Description |
|---|---|
| None | No device detected.
|
| PCIeDevice | PCIe device.
|
| Type1 | CXL Type 1 device.
|
| Type2 | CXL Type 2 device.
|
| Type3MLD | CXL Type 3 multi-logical device
(MLD).
|
| Type3SLD | CXL Type 3 single logical device
(SLD).
|
6.95.5.4 CurrentPortConfigurationState
The current port configuration state.
- This property shall contain the CXL Specification-defined 'Current Port Configuration State'.
| string | Description |
|---|---|
| BindInProgress | Bind in progress.
|
| Disabled | Disabled.
|
| DSP | Downstream port (DSP).
|
| Reserved | Reserved.
|
| UnbindInProgress | Unbind in progress.
|
| USP | Upstream port (USP).
|
6.95.5.5 FiberConnectionType
The type of fiber connection currently used by this SFP.
- This property shall contain the fiber connection type used by the SFP.
| string | Description |
|---|---|
| MultiMode | The connection is using multi mode operation. |
| SingleMode | The connection is using single mode operation. |
6.95.5.6 FlowControlConfiguration
The locally configured 802.3x flow control setting for this port.
- This property shall contain the locally configured 802.3x flow control setting for this port.
| string | Description |
|---|---|
| None | No IEEE 802.3x flow control is enabled on this port. |
| RX | IEEE 802.3x flow control might be initiated by the link partner. |
| TX | IEEE 802.3x flow control might be initiated by this station. |
| TX_RX | IEEE 802.3x flow control might be initiated by this station or the link partner. |
6.95.5.7 FlowControlStatus
The 802.3x flow control behavior negotiated with the link partner for this port.
- This property shall contain the 802.3x flow control behavior negotiated with the link partner for this port.
| string | Description |
|---|---|
| None | No IEEE 802.3x flow control is enabled on this port. |
| RX | IEEE 802.3x flow control might be initiated by the link partner. |
| TX | IEEE 802.3x flow control might be initiated by this station. |
| TX_RX | IEEE 802.3x flow control might be initiated by this station or the link partner. |
6.95.5.8 LinkNetworkTechnology
The link network technology capabilities of this port.
- This property shall contain a network technology capability of this port.
| string | Description |
|---|---|
| Ethernet | The port is capable of connecting to an Ethernet network. |
| FibreChannel | The port is capable of connecting to a Fibre Channel network. |
| GenZ | The port is capable of connecting to a Gen-Z fabric. |
| InfiniBand | The port is capable of connecting to an InfiniBand network. |
| PCIe (v1.8+) | The port is capable of connecting to PCIe and CXL fabrics. |
6.95.5.9 LinkState
The desired link state for this interface.
- This property shall contain the desired link state for this interface.
| string | Description |
|---|---|
| Disabled | The link is disabled and not
operational.
|
| Enabled | The link is enabled and
operational.
|
6.95.5.10 LinkStatus
The link status for this interface.
- This property shall contain the link status for this interface.
| string | Description |
|---|---|
| LinkDown | The link on this interface is down. |
| LinkUp | This link on this interface is up. |
| NoLink | No physical link detected on this interface. |
| Starting | This link on this interface is starting. A physical link has been established, but the port is not able to transfer data. |
| Training | This physical link on this interface is training. |
6.95.5.11 MediumType
The medium type connected to this SFP.
- This property shall contain the medium type used by the SFP.
| string | Description |
|---|---|
| Copper | The medium connected is copper. |
| FiberOptic | The medium connected is fiber optic. |
6.95.5.12 PortConnectionType
The connection type of this port.
- This property shall contain the connection type for this port.
| string | Description |
|---|---|
| DPort (v1.5+) | This port connection type is a diagnostic port. |
| EPort (v1.5+) | This port connection type is an extender fabric port. |
| EXPort (v1.5+) | This port connection type is an external fabric port. |
| ExtenderFabric | This port connection type is an extender fabric port. |
| FLPort (v1.5+) | This port connects in a fabric loop configuration. |
| FPort (v1.5+) | This port connection type is a fabric port. |
| Generic | This port connection type is a generic fabric port. |
| GPort (v1.5+) | This port connection type is a generic fabric port. |
| NLPort (v1.5+) | This port connects in a node loop configuration. |
| NotConnected | This port is not connected. |
| NPort | This port connects through an N-Port to a switch. |
| NPPort (v1.5+) | This port connection type is a proxy N port for N-Port virtualization. |
| PointToPoint | This port connects in a Point-to-point configuration. |
| PrivateLoop | This port connects in a private loop configuration. |
| PublicLoop | This port connects in a public configuration. |
| TEPort (v1.5+) | This port connection type is an trunking extender fabric port. |
| UPort (v1.5+) | This port connection type is unassigned. |
6.95.5.13 PortIdSubtype
The port ID subtype received from the remote partner across this link.
- This property shall contain the port ID subtype from IEEE 802.1AB-2009 Table 8-3 received from the remote partner across this link. If no such port ID subtype has been received, this property should not be present.
| string | Description |
|---|---|
| AgentId | Agent circuit ID, based on the agent-local identifier of the circuit as defined in RFC3046. |
| ChassisComp | Chassis component, based in the value of entPhysicalAlias in RFC4133. |
| IfAlias | Interface alias, based on the ifAlias MIB object. |
| IfName | Interface name, based on the ifName MIB object. |
| LocalAssign | Locally assigned, based on a alpha-numeric value locally assigned. |
| MacAddr | MAC address, based on an agent detected unicast source address as defined in IEEE standard 802. |
| NetworkAddr | Network address, based on an agent detected network address. |
| NotTransmitted | No data to be sent to/received from remote partner. |
| PortComp | Port component, based in the value of entPhysicalAlias in RFC4133. |
6.95.5.14 PortMedium
The physical connection medium for this port.
- This property shall contain the physical connection medium for this port.
| string | Description |
|---|---|
| Electrical | This port has an electrical cable connection. |
| Optical | This port has an optical cable connection. |
6.95.5.15 PortProtocol
The protocol being sent over this port.
- This property shall contain the protocol being sent over this port.
| string | Description |
|---|---|
| AHCI | Advanced Host Controller Interface
(AHCI).
|
| CXL | Compute Express Link.
|
| 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.
|
| QPI | Intel QuickPath Interconnect
(QPI).
|
| 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).
|
| UPI | Intel UltraPath Interconnect
(UPI).
|
| USB | Universal Serial Bus (USB).
|
| VGA | VGA.
|
6.95.5.16 PortType
The type of this port.
- This property shall contain the port type for this port.
| string | Description |
|---|---|
| BidirectionalPort | This port connects to any type of device. |
| DownstreamPort | This port connects to a target device. |
| InterswitchPort | This port connects to another switch. |
| ManagementPort | This port connects to a switch manager. |
| UnconfiguredPort | This port has not yet been configured. |
| UpstreamPort | This port connects to a host device. |
6.95.5.17 ResetType
The type of reset.
- This parameter shall contain the type of reset. The service can accept a request without the parameter and perform an implementation specific default reset.
| string | Description |
|---|---|
| ForceOff | Turn off the unit immediately
(non-graceful shutdown).
|
| ForceOn | Turn on the unit immediately.
|
| ForceRestart | Shut down immediately and non-gracefully
and restart the system.
|
| GracefulRestart | Shut down gracefully and restart the
system.
|
| GracefulShutdown | Shut down gracefully and power
off.
|
| Nmi | Generate a diagnostic interrupt, which is
usually an NMI on x86 systems, to stop normal operations, complete
diagnostic actions, and, typically, halt the system.
|
| On | Turn on the unit.
|
| Pause | Pause execution on the unit but do not
remove power. This is typically a feature of virtual machine
hypervisors.
|
| PowerCycle | Power cycle the unit. Behaves like a full
power removal, followed by a power restore to the resource.
|
| PushPowerButton | Simulate the pressing of the physical
power button on this unit.
|
| Resume | Resume execution on the paused unit. This
is typically a feature of virtual machine hypervisors.
|
| Suspend | Write the state of the unit to disk before
powering off. This allows for the state to be restored when powered back
on.
|
6.95.5.18 SupportedEthernetCapabilities
- The set of Ethernet capabilities that this port supports.
- This property shall contain an array of Ethernet capabilities supported by this port.
| string | Description |
|---|---|
| EEE | IEEE 802.3az Energy-Efficient Ethernet (EEE) is supported on this port. |
| WakeOnLAN | Wake on LAN (WoL) is supported on this port. |
6.95.5.19 SupportedSFPTypes
- The types of SFP devices that can be attached to this port.
- This property shall contain an array of SFP device types supported by this port.
| string | Description |
|---|---|
| cSFP | The SFP conforms to the CSFP MSA Specification. |
| MiniSASHD | The SFP conforms to the SFF Specification SFF-8644. |
| OSFP | The SFP conforms to the OSFP Specification. |
| QSFP | The SFP conforms to the SFF Specification for QSFP. |
| QSFP14 | The SFP conforms to the SFF Specification for QSFP14. |
| QSFP28 | The SFP conforms to the SFF Specification for QSFP28. |
| QSFP56 | The SFP conforms to the SFF Specification for QSFP56. |
| QSFPDD | The SFP conforms to the QSFP Double Density Specification. |
| QSFPPlus | The SFP conforms to the SFF Specification for QSFP+. |
| SFP | The SFP conforms to the SFF Specification for SFP. |
| SFP28 | The SFP conforms to the SFF Specification for SFP+ and IEEE 802.3by Specification. |
| SFPDD | The SFP conforms to the SFP-DD MSA Specification. |
| SFPPlus | The SFP conforms to the SFF Specification for SFP+. |
6.95.5.20 SystemCapabilities
- The system capabilities received from the remote partner across this link.
- This property shall contain the system capabilities received from the remote partner across this link. If no such system capabilities have been received, this property shall not be present. This property shall not contain the value `None`.
| string | Description |
|---|---|
| Bridge | Bridge.
|
| DOCSISCableDevice | DOCSIS cable device.
|
| None | The system capabilities are transmitted,
but no capabilities are set.
|
| Other | Other.
|
| Repeater | Repeater.
|
| Router | Router.
|
| Station | Station.
|
| Telephone | Telephone.
|
| WLANAccessPoint | WLAN access point.
|
6.95.5.21 Type
The type of SFP device that is attached to this port.
- This property shall contain the SFP device type currently attached to this port.
| string | Description |
|---|---|
| cSFP | The SFP conforms to the CSFP MSA Specification. |
| MiniSASHD | The SFP conforms to the SFF Specification SFF-8644. |
| OSFP (v1.9+) | The SFP conforms to the OSFP Specification. |
| QSFP | The SFP conforms to the SFF Specification for QSFP. |
| QSFP14 | The SFP conforms to the SFF Specification for QSFP14. |
| QSFP28 | The SFP conforms to the SFF Specification for QSFP28. |
| QSFP56 | The SFP conforms to the SFF Specification for QSFP56. |
| QSFPDD (v1.9+) | The SFP conforms to the QSFP Double Density Specification. |
| QSFPPlus | The SFP conforms to the SFF Specification for QSFP+. |
| SFP | The SFP conforms to the SFF Specification for SFP. |
| SFP28 | The SFP conforms to the SFF Specification for SFP+ and IEEE 802.3by Specification. |
| SFPDD | The SFP conforms to the SFP-DD MSA Specification. |
| SFPPlus | The SFP conforms to the SFF Specification for SFP+. |
6.95.6 Example response
{
"@odata.type": "#Port.v1_10_0.Port",
"Id": "1",
"Name": "SAS Port 1",
"Description": "SAS Port 1",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"PortId": "1",
"PortProtocol": "SAS",
"PortType": "BidirectionalPort",
"CurrentSpeedGbps": 48,
"Width": 4,
"MaxSpeedGbps": 48,
"Links": {
"AssociatedEndpoints": [
{
"@odata.id": "/redfish/v1/Fabrics/SAS/Endpoints/Initiator1"
}
]
},
"@odata.id": "/redfish/v1/Fabrics/SAS/Switches/Switch1/Ports/1"
}6.96 PortMetrics 1.5.0
| Version | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2023.2 | 2022.3 | 2022.1 | 2021.2 | 2021.1 | 2019.4 |
6.96.1 Description
The PortMetrics schema contains usage and health statistics for a switch device or component port summary.
- This resource shall represent the port metrics for a switch device or component port summary in a Redfish implementation.
6.96.2 URIs
/redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/Metrics
/redfish/v1/Chassis/{ChassisId}/MediaControllers/{MediaControllerId}/Ports/{PortId}/Metrics
/redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/Ports/{PortId}/Metrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/Ports/{PortId}/Metrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Controllers/{StorageControllerId}/Ports/{PortId}/Metrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Ports/{PortId}/Metrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/Metrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/GraphicsControllers/{ControllerId}/Ports/{PortId}/Metrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/Ports/{PortId}/Metrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Controllers/{StorageControllerId}/Ports/{PortId}/Metrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Ports/{PortId}/Metrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/USBControllers/{ControllerId}/Ports/{PortId}/Metrics
/redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortId}/Metrics
/redfish/v1/Managers/{ManagerId}/DedicatedNetworkPorts/{PortId}/Metrics
/redfish/v1/Managers/{ManagerId}/USBPorts/{PortId}/Metrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/Ports/{PortId}/Metrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Controllers/{StorageControllerId}/Ports/{PortId}/Metrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Ports/{PortId}/Metrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/Metrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/GraphicsControllers/{ControllerId}/Ports/{PortId}/Metrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/Ports/{PortId}/Metrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Controllers/{StorageControllerId}/Ports/{PortId}/Metrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Ports/{PortId}/Metrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/USBControllers/{ControllerId}/Ports/{PortId}/Metrics
/redfish/v1/Storage/{StorageId}/Controllers/{StorageControllerId}/Ports/{PortId}/Metrics
/redfish/v1/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Ports/{PortId}/Metrics
/redfish/v1/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/Metrics
/redfish/v1/Systems/{ComputerSystemId}/GraphicsControllers/{ControllerId}/Ports/{PortId}/Metrics
/redfish/v1/Systems/{ComputerSystemId}/Processors/{ProcessorId}/Ports/{PortId}/Metrics
/redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/Controllers/{StorageControllerId}/Ports/{PortId}/Metrics
/redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/StorageControllers/{StorageControllerId}/Ports/{PortId}/Metrics
/redfish/v1/Systems/{ComputerSystemId}/USBControllers/{ControllerId}/Ports/{PortId}/Metrics
6.96.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| CXL (v1.4+) { | object | The port metrics specific to CXL
ports.
|
|
| BackpressureAveragePercentage (v1.4+) | integer (%) |
read-only | The average congestion of the port as a
percentage.
|
| } | |||
| FibreChannel (v1.2+) { | object | The Fibre Channel-specific port metrics
for network ports.
|
|
| CorrectableFECErrors (v1.2+) | integer | read-only (null) |
The total number of correctable forward
error correction (FEC) errors.
|
| InvalidCRCs (v1.2+) | integer | read-only (null) |
The total number of invalid cyclic
redundancy checks (CRCs).
|
| InvalidTXWords (v1.2+) | integer | read-only (null) |
The total number of invalid transmission
words.
|
| LinkFailures (v1.2+) | integer | read-only (null) |
The total number of link
failures.
|
| LossesOfSignal (v1.2+) | integer | read-only (null) |
The total number of losses of
signal.
|
| LossesOfSync (v1.2+) | integer | read-only (null) |
The total number of losses of
sync.
|
| RXBBCreditZero (v1.2+) | integer | read-only (null) |
The number of times the receive
buffer-to-buffer credit count transitioned to zero.
|
| RXExchanges (v1.2+) | integer | read-only (null) |
The total number of Fibre Channel
exchanges received.
|
| RXSequences (v1.2+) | integer | read-only (null) |
The total number of Fibre Channel
sequences received.
|
| TXBBCredits (v1.2+) | integer | read-only (null) |
The number of transmit buffer-to-buffer
credits the port is configured to use.
|
| TXBBCreditZero (v1.2+) | integer | read-only (null) |
The number of times the transmit
buffer-to-buffer credit count transitioned to zero.
|
| TXBBCreditZeroDurationMilliseconds (v1.2+) | integer (ms) |
read-only (null) |
The total amount of time the port has been
blocked from transmitting due to lack of buffer credits.
|
| TXExchanges (v1.2+) | integer | read-only (null) |
The total number of Fibre Channel
exchanges transmitted.
|
| TXSequences (v1.2+) | integer | read-only (null) |
The total number of Fibre Channel
sequences transmitted.
|
| UncorrectableFECErrors (v1.2+) | integer | read-only (null) |
The total number of uncorrectable forward
error correction (FEC) errors.
|
| } | |||
| GenZ { | object | The port metrics specific to Gen-Z
ports.
|
|
| AccessKeyViolations | integer | read-only (null) |
The total number of Access Key Violations
detected.
|
| EndToEndCRCErrors | integer | read-only (null) |
The total number of ECRC transient errors
detected.
|
| LinkNTE | integer | read-only (null) |
The total number of link-local
non-transient errors detected.
|
| LLRRecovery | integer | read-only (null) |
The total number of times Link-Level
Reliability (LLR) recovery has been initiated.
|
| MarkedECN | integer | read-only (null) |
The number of packets with the Congestion
ECN bit set.
|
| NonCRCTransientErrors | integer | read-only (null) |
The total number transient errors detected
that are unrelated to CRC validation.
|
| PacketCRCErrors | integer | read-only (null) |
The total number of PCRC transient errors
detected.
|
| PacketDeadlineDiscards | integer | read-only (null) |
The number of packets discarded due to the
Congestion Deadline sub-field reaching zero.
|
| ReceivedECN | integer | read-only (null) |
The number of packets received on this
interface with the Congestion ECN bit set.
|
| RXStompedECRC | integer | read-only (null) |
The total number of packets received with
a stomped ECRC field.
|
| TXStompedECRC | integer | read-only (null) |
The total number of packets that this
interface stomped the ECRC field.
|
| } | |||
| Networking (v1.1+) { | object | The port metrics for network ports,
including Ethernet, Fibre Channel, and InfiniBand, that are not specific
to one of these protocols.
|
|
| RDMAProtectionErrors (v1.1+) | integer | read-only (null) |
The total number of RDMA protection
errors.
|
| RDMAProtocolErrors (v1.1+) | integer | read-only (null) |
The total number of RDMA protocol
errors.
|
| RDMARXBytes (v1.1+) | integer | read-only (null) |
The total number of RDMA bytes received on
a port since reset.
|
| RDMARXRequests (v1.1+) | integer | read-only (null) |
The total number of RDMA requests received
on a port since reset.
|
| RDMATXBytes (v1.1+) | integer | read-only (null) |
The total number of RDMA bytes transmitted
on a port since reset.
|
| RDMATXReadRequests (v1.1+) | integer | read-only (null) |
The total number of RDMA read requests
transmitted on a port since reset.
|
| RDMATXRequests (v1.1+) | integer | read-only (null) |
The total number of RDMA requests
transmitted on a port since reset.
|
| RDMATXSendRequests (v1.1+) | integer | read-only (null) |
The total number of RDMA send requests
transmitted on a port since reset.
|
| RDMATXWriteRequests (v1.1+) | integer | read-only (null) |
The total number of RDMA write requests
transmitted on a port since reset.
|
| RXBroadcastFrames (v1.1+) | integer | read-only (null) |
The total number of valid broadcast frames
received on a port since reset.
|
| RXDiscards (v1.1+) | integer | read-only (null) |
The total number of frames discarded in a
port's receive path since reset.
|
| RXFalseCarrierErrors (v1.1+) | integer | read-only (null) |
The total number of false carrier errors
received from phy on a port since reset.
|
| RXFCSErrors (v1.1+) | integer | read-only (null) |
The total number of frames received with
frame check sequence (FCS) errors on a port since reset.
|
| RXFrameAlignmentErrors (v1.1+) | integer | read-only (null) |
The total number of frames received with
alignment errors on a port since reset.
|
| RXFrames (v1.1+) | integer | read-only (null) |
The total number of frames received on a
port since reset.
|
| RXMulticastFrames (v1.1+) | integer | read-only (null) |
The total number of valid multicast frames
received on a port since reset.
|
| RXOversizeFrames (v1.1+) | integer | read-only (null) |
The total number of frames that exceed the
maximum frame size.
|
| RXPauseXOFFFrames (v1.1+) | integer | read-only (null) |
The total number of flow control frames
from the network to pause transmission.
|
| RXPauseXONFrames (v1.1+) | integer | read-only (null) |
The total number of flow control frames
from the network to resume transmission.
|
| RXPFCFrames (v1.1+) | integer | read-only (null) |
The total number of priority flow control
(PFC) frames received on a port since reset.
|
| RXUndersizeFrames (v1.1+) | integer | read-only (null) |
The total number of frames that are
smaller than the minimum frame size of 64 bytes.
|
| RXUnicastFrames (v1.1+) | integer | read-only (null) |
The total number of valid unicast frames
received on a port since reset.
|
| TXBroadcastFrames (v1.1+) | integer | read-only (null) |
The total number of good broadcast frames
transmitted on a port since reset.
|
| TXDiscards (v1.1+) | integer | read-only (null) |
The total number of frames discarded in a
port's transmit path since reset.
|
| TXExcessiveCollisions (v1.1+) | integer | read-only (null) |
The number of times a single transmitted
frame encountered more than 15 collisions.
|
| TXFrames (v1.1+) | integer | read-only (null) |
The total number of frames transmitted on
a port since reset.
|
| TXLateCollisions (v1.1+) | integer | read-only (null) |
The total number of collisions that
occurred after one slot time as defined by IEEE 802.3.
|
| TXMulticastFrames (v1.1+) | integer | read-only (null) |
The total number of good multicast frames
transmitted on a port since reset.
|
| TXMultipleCollisions (v1.1+) | integer | read-only (null) |
The times that a transmitted frame
encountered 2-15 collisions.
|
| TXPauseXOFFFrames (v1.1+) | integer | read-only (null) |
The total number of XOFF frames
transmitted to the network.
|
| TXPauseXONFrames (v1.1+) | integer | read-only (null) |
The total number of XON frames transmitted
to the network.
|
| TXPFCFrames (v1.1+) | integer | read-only (null) |
The total number of priority flow control
(PFC) frames sent on a port since reset.
|
| TXSingleCollisions (v1.1+) | integer | read-only (null) |
The times that a successfully transmitted
frame encountered a single collision.
|
| TXUnicastFrames (v1.1+) | integer | read-only (null) |
The total number of good unicast frames
transmitted on a port since reset.
|
| } | |||
| PCIeErrors (v1.3+) { | object | The PCIe errors associated with this
port.
|
|
| CorrectableErrorCount (v1.8+) | integer | read-only (null) |
The total number of the PCIe correctable
errors for this device.
|
| FatalErrorCount (v1.8+) | integer | read-only (null) |
The total number of the PCIe fatal errors
for this device.
|
| L0ToRecoveryCount (v1.8+) | integer | read-only (null) |
The total number of times the PCIe link
states transitioned from L0 to the recovery state for this
device.
|
| NAKReceivedCount (v1.8+) | integer | read-only (null) |
The total number of NAKs issued on the
PCIe link by the receiver.
|
| NAKSentCount (v1.8+) | integer | read-only (null) |
The total number of NAKs issued on the
PCIe link by this device.
|
| NonFatalErrorCount (v1.8+) | integer | read-only (null) |
The total number of the PCIe non-fatal
errors for this device.
|
| ReplayCount (v1.8+) | integer | read-only (null) |
The total number of the PCIe replays
issued by this device.
|
| ReplayRolloverCount (v1.8+) | integer | read-only (null) |
The total number of the PCIe replay
rollovers issued by this device.
|
| } | |||
| RXBytes (v1.1+) | integer (bytes) |
read-only (null) |
The total number of bytes received on a
port since reset.
|
| RXErrors (v1.1+) | integer | read-only (null) |
The total number of received errors on a
port since reset.
|
| SAS (v1.1+) [ { | array | The physical (phy) metrics for Serial
Attached SCSI (SAS). Each member represents a single phy.
|
|
| InvalidDwordCount (v1.1+) | integer | read-only (null) |
The number of invalid dwords that have
been received by the phy outside of phy reset sequences.
|
| LossOfDwordSynchronizationCount (v1.1+) | integer | read-only (null) |
The number of times the phy has restarted
the link reset sequence because it lost dword
synchronization.
|
| PhyResetProblemCount (v1.5+) | integer | read-only (null) |
The number of times a phy reset problem
has occurred.
|
| RunningDisparityErrorCount (v1.1+) | integer | read-only (null) |
The number of dwords containing running
disparity errors that have been received by the phy outside of phy reset
sequences.
|
| } ] | |||
| Transceivers (v1.1+) [ { | array | The metrics for the transceivers in this
port. Each member represents a single transceiver.
|
|
| RXInputPowerMilliWatts (v1.1+) | number (milliWatts) |
read-only (null) |
The RX input power value of a small
form-factor pluggable (SFP) transceiver.
|
| SupplyVoltage (v1.1+) | number (Volts) |
read-only (null) |
The supply voltage of a small form-factor
pluggable (SFP) transceiver.
|
| TXBiasCurrentMilliAmps (v1.1+) | number (mA) |
read-only (null) |
The TX bias current value of a small
form-factor pluggable (SFP) transceiver.
|
| TXOutputPowerMilliWatts (v1.1+) | number (milliWatts) |
read-only (null) |
The TX output power value of a small
form-factor pluggable (SFP) transceiver.
|
| } ] | |||
| TXBytes (v1.1+) | integer (bytes) |
read-only (null) |
The total number of bytes transmitted on a
port since reset.
|
| TXErrors (v1.1+) | integer | read-only (null) |
The total number of transmission errors on
a port since reset.
|
6.96.4 Example response
{
"@odata.type": "#PortMetrics.v1_5_0.PortMetrics",
"Id": "Metrics",
"Name": "Gen-Z Port 1 Metrics",
"GenZ": {
"PacketCRCErrors": 24,
"EndToEndCRCErrors": 3,
"RXStompedECRC": 1,
"TXStompedECRC": 2,
"NonCRCTransientErrors": 2,
"LLRRecovery": 1,
"MarkedECN": 1,
"PacketDeadlineDiscards": 1,
"AccessKeyViolations": 1,
"LinkNTE": 1,
"ReceivedECN": 1
},
"@odata.id": "/redfish/v1/Fabrics/GenZ/Switches/Switch1/Ports/1/Metrics"
}6.97 Power 1.7.1 (deprecated)
| Version | v1.7 Deprecated | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2020.4 | 2019.3 | 2017.3 | 2017.2 | 2017.1 | 2016.2 | 2016.1 | 1.0 |
This schema has been deprecated and use in new implementations is discouraged except to retain compatibility with existing products. This schema has been deprecated in favor of the PowerSubsystem schema.
6.97.1 Description
The Power schema describes power metrics and represents the properties for power consumption and power limiting.
- This resource shall contain the power metrics for a Redfish implementation.
6.97.2 URIs
/redfish/v1/Chassis/{ChassisId}/Power (deprecated)
6.97.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| PowerControl [ { | array | The set of power control functions,
including power reading and limiting.
|
|
| @odata.id | string (URI) |
read-only required | The unique identifier for a
resource.
|
| Actions (v1.3+) {} | object | The available actions for this
resource.
|
|
| MemberId | string | read-only required | The identifier for the member within the
collection.
|
| Name | string | read-only (null) |
The power control function
name.
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| PhysicalContext (v1.4+) | string (enum) |
read-only | The area, device, or set of devices to
which this power control applies.
|
| PowerAllocatedWatts | number (Watts) |
read-only (null) |
The total amount of power that has been
allocated or budgeted to chassis.
|
| PowerAvailableWatts | number (Watts) |
read-only (null) |
The amount of reserve power capacity, in
watts, that remains. This value is the PowerCapacityWatts value minus
the PowerAllocatedWatts value.
|
| PowerCapacityWatts | number (Watts) |
read-only (null) |
The total amount of power that can be
allocated to the chassis. This value can be either the power supply
capacity or the power budget that an upstream chassis assigns to this
chassis.
|
| PowerConsumedWatts | number (Watts) |
read-only (null) |
The actual power that the chassis
consumes, in watts.
|
| PowerLimit { | object | The power limit status and configuration
information for this chassis.
|
|
| CorrectionInMs | integer (ms) |
read-write (null) |
The time required for the limiting process
to reduce power consumption to below the limit.
|
| LimitException | string (enum) |
read-write (null) |
The action that is taken if the power
cannot be maintained below the LimitInWatts.
|
| LimitInWatts | number (Watts) |
read-write (null) |
The power limit, in watts. If
null, power capping is disabled.
|
| } | |||
| PowerMetrics { | object | The power readings for this
chassis.
|
|
| AverageConsumedWatts | number (Watts) |
read-only (null) |
The average power level over the
measurement window over the last IntervalInMin minutes.
|
| IntervalInMin | integer (min) |
read-only (null) |
The time interval, or window, over which
the power metrics are measured.
|
| MaxConsumedWatts | number (Watts) |
read-only (null) |
The highest power consumption level, in
watts, that has occurred over the measurement window within the last
IntervalInMin minutes.
|
| MinConsumedWatts | number (Watts) |
read-only (null) |
The lowest power consumption level, in
watts, over the measurement window that occurred within the last
IntervalInMin minutes.
|
| } | |||
| PowerRequestedWatts | number (Watts) |
read-only (null) |
The potential power, in watts, that the
chassis requests, which might be higher than the current level being
consumed because the requested power includes a budget that the chassis
wants for future use.
|
| RelatedItem [ { | array | An array of links to resources or objects
associated with this power limit.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| } ] | |||
| PowerSupplies [ { | array | The set of power supplies associated with
this system or device.
|
|
| @odata.id | string (URI) |
read-only required | The unique identifier for a
resource.
|
| Actions (v1.3+) {} | object | The available actions for this
resource.
|
|
| Assembly (v1.5+) { | object | The link to the assembly resource
associated with this power supply.
|
|
| @odata.id | string | read-only | Link to a Assembly resource. See the Links section and the Assembly schema for details. |
| } | |||
| EfficiencyPercent (v1.5+) | number (%) |
read-only (null) |
The measured efficiency of this power
supply as a percentage.
|
| FirmwareVersion | string | read-only (null) |
The firmware version for this power
supply.
|
| HotPluggable (v1.5+) | boolean | read-only (null) |
An indication of whether this device can
be inserted or removed while the equipment is in operation.
|
| IndicatorLED (v1.2+) | string (enum) |
read-write (null) |
The state of The indicator LED, which
identifies the power supply.
|
| InputRanges (v1.1+) [ { | array | The input ranges that the power supply can
use.
|
|
| InputType (v1.1+) | string (enum) |
read-only (null) |
The Input type (AC or DC).
|
| MaximumFrequencyHz (v1.1+) | number (Hz) |
read-only (null) |
The maximum line input frequency at which
this power supply input range is effective.
|
| MaximumVoltage (v1.1+) | number (Volts) |
read-only (null) |
The maximum line input voltage at which
this power supply input range is effective.
|
| MinimumFrequencyHz (v1.1+) | number (Hz) |
read-only (null) |
The minimum line input frequency at which
this power supply input range is effective.
|
| MinimumVoltage (v1.1+) | number (Volts) |
read-only (null) |
The minimum line input voltage at which
this power supply input range is effective.
|
| Oem (v1.1+) {} | object | See the OEM object definition in the Using this guide clause. | |
| OutputWattage (v1.1+) | number (Watts) |
read-only (null) |
The maximum capacity of this power supply
when operating in this input range.
|
| } ] | |||
| LastPowerOutputWatts | number (Watts) |
read-only (null) |
The average power output of this power
supply.
|
| LineInputVoltage | number (Volts) |
read-only (null) |
The line input voltage at which the power
supply is operating.
|
| LineInputVoltageType | string (enum) |
read-only (null) |
The line voltage type supported as an
input to this power supply.
|
| Location (v1.5+) {} | object | The location of the power
supply.
|
|
| Manufacturer (v1.1+) | string | read-only (null) |
The manufacturer of this power
supply.
|
| MemberId | string | read-only required | The identifier for the member within the
collection.
|
| Model | string | read-only (null) |
The model number for this power
supply.
|
| Name | string | read-only (null) |
The name of the power supply.
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| PartNumber | string | read-only (null) |
The part number for this power
supply.
|
| PowerCapacityWatts | number (Watts) |
read-only (null) |
The maximum capacity of this power
supply.
|
| PowerInputWatts (v1.5+) | number (Watts) |
read-only (null) |
The measured input power of this power
supply.
|
| PowerOutputWatts (v1.5+) | number (Watts) |
read-only (null) |
The measured output power of this power
supply.
|
| PowerSupplyType | string (enum) |
read-only (null) |
The power supply type (AC or
DC).
|
| Redundancy [ { } ] | array (object) | The common redundancy definition and
structure used in other Redfish schemas.
|
|
| RelatedItem [ { | array | An array of links to resources or objects
associated with this power supply.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| SerialNumber | string | read-only (null) |
The serial number for this power
supply.
|
| SparePartNumber | string | read-only (null) |
The spare part number for this power
supply.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| } ] | |||
| Redundancy [ { } ] | array (object) | The common redundancy definition and
structure used in other Redfish schemas.
|
|
| Voltages [ { | array | The set of voltage sensors for this
chassis.
|
|
| @odata.id | string (URI) |
read-only required | The unique identifier for a
resource.
|
| Actions (v1.3+) {} | object | The available actions for this
resource.
|
|
| LowerThresholdCritical | number (Volts) |
read-only (null) |
The value at which the reading is below
normal range but not yet fatal.
|
| LowerThresholdFatal | number (Volts) |
read-only (null) |
The value at which the reading is below
normal range and fatal.
|
| LowerThresholdNonCritical | number (Volts) |
read-only (null) |
The value at which the reading is below
normal range.
|
| MaxReadingRange | number (Volts) |
read-only (null) |
Maximum value for this sensor.
|
| MemberId | string | read-only required | The identifier for the member within the
collection.
|
| MinReadingRange | number (Volts) |
read-only (null) |
Minimum value for this sensor.
|
| Name | string | read-only (null) |
Voltage sensor name.
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| PhysicalContext | string (enum) |
read-only | The area or device to which this voltage
measurement applies.
|
| ReadingVolts | number (Volts) |
read-only (null) |
The reading of the voltage
sensor.
|
| RelatedItem [ { | array | An array of links to resources or objects
to which this voltage measurement applies.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| SensorNumber | integer | read-only (null) |
A numerical identifier to represent the
voltage sensor.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| UpperThresholdCritical | number (Volts) |
read-only (null) |
The value at which the reading is above
normal range but not yet fatal.
|
| UpperThresholdFatal | number (Volts) |
read-only (null) |
The value at which the reading is above
normal range and fatal.
|
| UpperThresholdNonCritical | number (Volts) |
read-only (null) |
The value at which the reading is above
normal range.
|
| } ] |
6.97.4 Actions
6.97.4.1 PowerSupplyReset (v1.6+)
Description
This action resets the targeted power supply.
- This action
shall reset a power supply specified by the MemberId from the
PowerSupplies array. A
GracefulRestartResetType shall reset the power supply but shall not affect the power output. AForceRestartResetType can affect the power supply output.
Action URI
{Base URI of target resource}/Actions/Power.PowerSupplyReset
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| MemberId | string | required | The MemberId of the power supply within
the PowerSupplies array on which to perform the reset.
|
| ResetType | string (enum) |
optional | The type of reset.
|
Request Example
{
"MemberId": "0",
"ResetType": "ForceRestart"
}6.97.5 Property details
6.97.5.1 IndicatorLED
The state of The indicator LED, which identifies the power supply.
- This property shall contain the indicator light state for the indicator light associated with this power supply.
| string | Description |
|---|---|
| Blinking | The indicator LED is blinking.
|
| Lit | The indicator LED is lit.
|
| Off | The indicator LED is off.
|
6.97.5.2 InputType
The Input type (AC or DC).
- This property shall contain the input type (AC or DC) of the associated range.
| string | Description |
|---|---|
| AC | Alternating Current (AC) input range. |
| DC | Direct Current (DC) input range. |
6.97.5.3 LimitException
The action that is taken if the power cannot be maintained below the LimitInWatts.
- This property shall represent the action to be taken if the resource power consumption cannot be limited below the specified limit after several correction time periods.
| string | Description |
|---|---|
| HardPowerOff | Turn the power off immediately when the limit is exceeded. |
| LogEventOnly | Log an event when the limit is exceeded, but take no further action. |
| NoAction | Take no action when the limit is exceeded. |
| Oem | Take an OEM-defined action. |
6.97.5.4 LineInputVoltageType
The line voltage type supported as an input to this power supply.
- This property shall contain the type of input line voltage supported by the associated power supply.
| string | Description |
|---|---|
| AC120V (v1.1+) | AC 120V nominal input. |
| AC240V (v1.1+) | AC 240V nominal input. |
| AC277V (v1.1+) | AC 277V nominal input. |
| ACandDCWideRange (v1.1+) | Wide range AC or DC input. |
| ACHighLine (deprecated v1.1) | 277V AC input. Deprecated in v1.1 and later. This value has been deprecated in favor of AC277V. |
| ACLowLine (deprecated v1.1) | 100-127V AC input. Deprecated in v1.1 and later. This value has been deprecated in favor of AC120V. |
| ACMidLine (deprecated v1.1) | 200-240V AC input. Deprecated in v1.1 and later. This value has been deprecated in favor of AC240V. |
| ACWideRange (v1.1+) | Wide range AC input. |
| DC240V (v1.1+) | DC 240V nominal input. |
| DC380V | High Voltage DC input (380V). |
| DCNeg48V | -48V DC input. |
| Unknown | The power supply line input voltage type cannot be determined. |
6.97.5.5 PhysicalContext
The area, device, or set of devices to which this power control applies.
- This property shall contain a description of the affected device(s) or region within the chassis to which this power control applies.
| string | Description |
|---|---|
| Accelerator | An accelerator. |
| ACInput | An AC input. |
| ACMaintenanceBypassInput | An AC maintenance bypass input. |
| ACOutput | An AC output. |
| ACStaticBypassInput | An AC static bypass input. |
| ACUtilityInput | An AC utility input. |
| ASIC | An ASIC device, such as a networking chip or chipset component. |
| Back | The back of the chassis. |
| Backplane | A backplane within the chassis. |
| Battery | A battery. |
| Board | A circuit board.
|
| Chassis | The entire chassis. |
| ComputeBay | Within a compute bay. |
| CoolingSubsystem | The entire cooling, or air and liquid, subsystem. |
| CPU | A processor (CPU). |
| CPUSubsystem | The entire processor (CPU) subsystem. |
| DCBus | A DC bus. |
| Exhaust | The air exhaust point or points or region of the chassis. |
| ExpansionBay | Within an expansion bay. |
| Fan | A fan. |
| FPGA | An FPGA. |
| Front | The front of the chassis. |
| GPU | A graphics processor (GPU). |
| GPUSubsystem | The entire graphics processor (GPU) subsystem. |
| Intake | The air intake point or points or region of the chassis. |
| LiquidInlet | The liquid inlet point of the chassis. |
| LiquidOutlet | The liquid outlet point of the chassis. |
| Lower | The lower portion of the chassis. |
| Memory | A memory device. |
| MemorySubsystem | The entire memory subsystem. |
| Motor | A motor. |
| NetworkBay | Within a networking bay. |
| NetworkingDevice | A networking device. |
| PowerSubsystem | The entire power subsystem. |
| PowerSupply | A power supply. |
| PowerSupplyBay | Within a power supply bay. |
| Pump | A pump. |
| Rectifier | A rectifier device. |
| Room | The room. |
| StorageBay | Within a storage bay. |
| StorageDevice | A storage device. |
| SystemBoard | The system board (PCB). |
| Transceiver | A transceiver.
|
| Transformer | A transformer. |
| TrustedModule | A trusted module. |
| Upper | The upper portion of the chassis. |
| VoltageRegulator | A voltage regulator device. |
6.97.5.6 PowerSupplyType
The power supply type (AC or DC).
- This property shall contain the input power type (AC or DC) of the associated power supply.
| string | Description |
|---|---|
| AC | Alternating Current (AC) power supply. |
| ACorDC | The power supply supports both DC or AC. |
| DC | Direct Current (DC) power supply. |
| Unknown | The power supply type cannot be determined. |
6.97.5.7 ResetType
The type of reset.
- This parameter shall contain the type of
reset. The service can accept a request without the parameter and shall
perform a
GracefulRestart.
| string | Description |
|---|---|
| ForceOff | Turn off the unit immediately
(non-graceful shutdown).
|
| ForceOn | Turn on the unit immediately.
|
| ForceRestart | Shut down immediately and non-gracefully
and restart the system.
|
| GracefulRestart | Shut down gracefully and restart the
system.
|
| GracefulShutdown | Shut down gracefully and power
off.
|
| Nmi | Generate a diagnostic interrupt, which is
usually an NMI on x86 systems, to stop normal operations, complete
diagnostic actions, and, typically, halt the system.
|
| On | Turn on the unit.
|
| Pause | Pause execution on the unit but do not
remove power. This is typically a feature of virtual machine
hypervisors.
|
| PowerCycle | Power cycle the unit. Behaves like a full
power removal, followed by a power restore to the resource.
|
| PushPowerButton | Simulate the pressing of the physical
power button on this unit.
|
| Resume | Resume execution on the paused unit. This
is typically a feature of virtual machine hypervisors.
|
| Suspend | Write the state of the unit to disk before
powering off. This allows for the state to be restored when powered back
on.
|
6.97.6 Example response
{
"@odata.type": "#Power.v1_7_1.Power",
"Id": "Power",
"Name": "Power",
"PowerControl": [
{
"@odata.id": "/redfish/v1/Chassis/1U/Power#/PowerControl/0",
"MemberId": "0",
"Name": "Server Power Control",
"PowerConsumedWatts": 344,
"PowerRequestedWatts": 800,
"PowerAvailableWatts": 0,
"PowerCapacityWatts": 800,
"PowerAllocatedWatts": 800,
"PowerMetrics": {
"IntervalInMin": 30,
"MinConsumedWatts": 271,
"MaxConsumedWatts": 489,
"AverageConsumedWatts": 319
},
"PowerLimit": {
"LimitInWatts": 500,
"LimitException": "LogEventOnly",
"CorrectionInMs": 50
},
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Systems/437XR1138R2"
},
{
"@odata.id": "/redfish/v1/Chassis/1U"
}
],
"Status": {
"State": "Enabled",
"Health": "OK"
}
}
],
"Voltages": [
{
"@odata.id": "/redfish/v1/Chassis/1U/Power#/Voltages/0",
"MemberId": "0",
"Name": "VRM1 Voltage",
"SensorNumber": 11,
"Status": {
"State": "Enabled",
"Health": "OK"
},
"ReadingVolts": 12,
"UpperThresholdNonCritical": 12.5,
"UpperThresholdCritical": 13,
"UpperThresholdFatal": 15,
"LowerThresholdNonCritical": 11.5,
"LowerThresholdCritical": 11,
"LowerThresholdFatal": 10,
"MinReadingRange": 0,
"MaxReadingRange": 20,
"PhysicalContext": "VoltageRegulator",
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Systems/437XR1138R2"
},
{
"@odata.id": "/redfish/v1/Chassis/1U"
}
]
},
{
"@odata.id": "/redfish/v1/Chassis/1U/Power#/Voltages/1",
"MemberId": "1",
"Name": "VRM2 Voltage",
"SensorNumber": 12,
"Status": {
"State": "Enabled",
"Health": "OK"
},
"ReadingVolts": 5,
"UpperThresholdNonCritical": 5.5,
"UpperThresholdCritical": 7,
"LowerThresholdNonCritical": 4.75,
"LowerThresholdCritical": 4.5,
"MinReadingRange": 0,
"MaxReadingRange": 20,
"PhysicalContext": "VoltageRegulator",
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Systems/437XR1138R2"
},
{
"@odata.id": "/redfish/v1/Chassis/1U"
}
]
}
],
"PowerSupplies": [
{
"@odata.id": "/redfish/v1/Chassis/1U/Power#/PowerSupplies/0",
"MemberId": "0",
"Name": "Power Supply Bay",
"Status": {
"State": "Enabled",
"Health": "Warning"
},
"PowerSupplyType": "AC",
"LineInputVoltageType": "ACWideRange",
"LineInputVoltage": 120,
"PowerCapacityWatts": 800,
"LastPowerOutputWatts": 325,
"Model": "499253-B21",
"Manufacturer": "ManufacturerName",
"FirmwareVersion": "1.00",
"SerialNumber": "1Z0000001",
"PartNumber": "0000001A3A",
"SparePartNumber": "0000001A3A",
"InputRanges": [
{
"InputType": "AC",
"MinimumVoltage": 100,
"MaximumVoltage": 120,
"OutputWattage": 800
},
{
"InputType": "AC",
"MinimumVoltage": 200,
"MaximumVoltage": 240,
"OutputWattage": 1300
}
],
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Chassis/1U"
}
]
}
],
"Actions": {
"#Power.PowerSupplyReset": {
"target": "/redfish/v1/Chassis/1U/Power/Actions/Power.PowerSupplyReset"
}
},
"@odata.id": "/redfish/v1/Chassis/1U/Power"
}6.98 PowerDistribution 1.3.2
| Version | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2022.3 | 2021.3 | 2021.2 | 2019.4 |
6.98.1 Description
This is the schema definition for a power distribution component or unit, such as a floor power distribution unit (PDU) or switchgear.
- This resource shall be used to represent a power distribution component or unit for a Redfish implementation.
6.98.2 URIs
/redfish/v1/PowerEquipment/ElectricalBuses/{PowerDistributionId}
/redfish/v1/PowerEquipment/FloorPDUs/{PowerDistributionId}
/redfish/v1/PowerEquipment/PowerShelves/{PowerDistributionId}
/redfish/v1/PowerEquipment/RackPDUs/{PowerDistributionId}
/redfish/v1/PowerEquipment/Switchgear/{PowerDistributionId}
/redfish/v1/PowerEquipment/TransferSwitches/{PowerDistributionId}
6.98.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AssetTag | string | read-write (null) |
The user-assigned asset tag for this
equipment.
|
| Branches { | object | A link to the branch circuits for this
equipment.
|
|
| @odata.id | string | read-only | Link to Collection of Circuit. See the Circuit schema for details. |
| } | |||
| EquipmentType | string (enum) |
read-only required | The type of equipment this resource
represents.
|
| Feeders { | object | A link to the feeder circuits for this
equipment.
|
|
| @odata.id | string | read-only | Link to Collection of Circuit. See the Circuit schema for details. |
| } | |||
| FirmwareVersion | string | read-only | The firmware version of this
equipment.
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| Chassis [ { | array | An array of links to the chassis that
contain this equipment.
|
|
| @odata.id | string | read-only | Link to a Chassis resource. See the Links section and the Chassis schema for details. |
| } ] | |||
| Facility { | object | A link to the facility that contains this
equipment.
|
|
| @odata.id | string | read-only | 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 equipment.
|
|
| @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 Using this guide clause. | |
| } | |||
| Location {} | object | The location of the equipment.
|
|
| Mains { | object | A link to the power input circuits for
this equipment.
|
|
| @odata.id | string | read-only | Link to Collection of Circuit. See the Circuit schema for details. |
| } | |||
| MainsRedundancy (v1.1+) {} | object | The redundancy information for the mains
(input) circuits for this equipment.
|
|
| Manufacturer | string | read-only (null) |
The manufacturer of this
equipment.
|
| Metrics { | object | A link to the summary metrics for this
equipment.
|
|
| @odata.id | string | read-only | Link to a PowerDistributionMetrics resource. See the Links section and the PowerDistributionMetrics schema for details. |
| } | |||
| Model | string | read-only (null) |
The product model number of this
equipment.
|
| OutletGroups { | object | A link to the outlet groups for this
equipment.
|
|
| @odata.id | string | read-only | Link to Collection of OutletGroup. See the OutletGroup schema for details. |
| } | |||
| Outlets { | object | A link to the outlets for this
equipment.
|
|
| @odata.id | string | read-only | Link to Collection of Outlet. See the Outlet schema for details. |
| } | |||
| PartNumber | string | read-only (null) |
The part number for this
equipment.
|
| PowerSupplies (v1.1+, deprecated v1.3 { | object | The link to the collection of power
supplies for this equipment.
|
|
| @odata.id | string | read-only | Link to Collection of PowerSupply. See the PowerSupply schema for details. |
| } | |||
| PowerSupplyRedundancy (v1.1+, deprecated v1.3 [ { } ] | array (object) | The redundancy information for the devices
in a redundancy group.
|
|
| ProductionDate | string (date-time) |
read-only (null) |
The production or manufacturing date of
this equipment.
|
| Sensors (deprecated v1.3) { | object | A link to the collection of sensors
located in the equipment and sub-components.
|
|
| @odata.id | string | read-only | Link to Collection of Sensor. See the Sensor schema for details. |
| } | |||
| SerialNumber | string | read-only (null) |
The serial number for this
equipment.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| Subfeeds { | object | A link to the subfeed circuits for this
equipment.
|
|
| @odata.id | string | read-only | Link to Collection of Circuit. See the Circuit schema for details. |
| } | |||
| TransferConfiguration { | object | (null) |
The configuration settings for an
automatic transfer switch.
|
| ActiveMainsId | string | read-write (null) |
The mains circuit that is switched on and
qualified to supply power to the output circuit.
|
| AutoTransferEnabled | boolean | read-write (null) |
Indicates if the qualified alternate mains
circuit is automatically switched on when the preferred mains circuit
becomes unqualified and is automatically switched off.
|
| ClosedTransitionAllowed | boolean | read-write (null) |
Indicates if a make-before-break switching
sequence of the mains circuits is permitted when they are both qualified
and in synchronization.
|
| ClosedTransitionTimeoutSeconds | integer | read-write (null) |
The time in seconds to wait for a closed
transition to occur.
|
| PreferredMainsId | string | read-write (null) |
The preferred source for the mains circuit
to this equipment.
|
| RetransferDelaySeconds | integer | read-write (null) |
The time in seconds to delay the automatic
transfer from the alternate mains circuit back to the preferred mains
circuit.
|
| RetransferEnabled | boolean | read-write (null) |
Indicates if the automatic transfer is
permitted from the alternate mains circuit back to the preferred mains
circuit after the preferred mains circuit is qualified again and the
Retransfer Delay time has expired.
|
| TransferDelaySeconds | integer | read-write (null) |
The time in seconds to delay the automatic
transfer from the preferred mains circuit to the alternate mains circuit
when the preferred mains circuit is disqualified.
|
| TransferInhibit | boolean | read-write (null) |
Indicates if any transfer is
inhibited.
|
| } | |||
| TransferCriteria { | object | (null) |
The criteria used to initiate a transfer
for an automatic transfer switch.
|
| OverNominalFrequencyHz | number (Hz) |
read-write (null) |
The frequency in hertz over the nominal
value that satisfies a criterion for transfer.
|
| OverVoltageRMSPercentage | number (%) |
read-write (null) |
The positive percentage of voltage RMS
over the nominal value that satisfies a criterion for
transfer.
|
| TransferSensitivity | string (enum) |
read-write (null) |
The sensitivity to voltage waveform
quality to satisfy the criterion for initiating a transfer.
|
| UnderNominalFrequencyHz | number (Hz) |
read-write (null) |
The frequency in hertz under the nominal
value that satisfies a criterion for transfer.
|
| UnderVoltageRMSPercentage | number (%) |
read-write (null) |
The negative percentage of voltage RMS
under the nominal value that satisfies a criterion for
transfer.
|
| } | |||
| UserLabel (v1.3+) | string | read-write | A user-assigned label.
|
| UUID | string (uuid) |
read-only (null) |
The UUID for this equipment.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ |
| Version | string | read-only (null) |
The hardware version of this
equipment.
|
6.98.4 Actions
6.98.4.1 TransferControl
Description
This action transfers control to the alternative input circuit.
- This action shall transfer power input from the existing mains circuit to the alternative mains circuit.
Action URI
{Base URI of target resource}/Actions/PowerDistribution.TransferControl
Action parameters
This action takes no parameters.
6.98.5 Property details
6.98.5.1 EquipmentType
The type of equipment this resource represents.
- This property shall contain the type of equipment this resource represents.
| string | Description |
|---|---|
| AutomaticTransferSwitch | An automatic power transfer switch. |
| BatteryShelf (v1.3+) | A battery shelf or battery-backed unit (BBU). |
| Bus (v1.2+) | An electrical bus. |
| FloorPDU | A power distribution unit providing feeder circuits for further power distribution. |
| ManualTransferSwitch | A manual power transfer switch. |
| PowerShelf (v1.1+) | A power shelf. |
| RackPDU | A power distribution unit providing outlets for a rack or similar quantity of devices. |
| Switchgear | Electrical switchgear. |
6.98.5.2 TransferSensitivity
The sensitivity to voltage waveform quality to satisfy the criterion for initiating a transfer.
- This property shall contain the setting that adjusts the analytical sensitivity of the detection of the quality of voltage waveform that satisfies a criterion for transfer.
| string | Description |
|---|---|
| High | High sensitivity for initiating a transfer. |
| Low | Low sensitivity for initiating a transfer. |
| Medium | Medium sensitivity for initiating a transfer. |
6.98.6 Example response
{
"@odata.type": "#PowerDistribution.v1_3_2.PowerDistribution",
"Id": "1",
"EquipmentType": "RackPDU",
"Name": "RackPDU1",
"FirmwareVersion": "4.3.0",
"Version": "1.03b",
"ProductionDate": "2017-01-11T08:00:00Z",
"Manufacturer": "Contoso",
"Model": "ZAP4000",
"SerialNumber": "29347ZT536",
"PartNumber": "AA-23",
"UUID": "32354641-4135-4332-4a35-313735303734",
"AssetTag": "PDX-92381",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Location": {
"Placement": {
"Row": "North 1"
}
},
"Mains": {
"@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Mains"
},
"Branches": {
"@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Branches"
},
"Outlets": {
"@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Outlets"
},
"OutletGroups": {
"@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/OutletGroups"
},
"Metrics": {
"@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Metrics"
},
"Sensors": {
"@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors"
},
"Links": {
"Facility": {
"@odata.id": "/redfish/v1/Facilities/Room237"
}
},
"@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1"
}6.99 PowerDistributionMetrics 1.3.0
| Version | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2021.4 | 2021.2 | 2021.1 | 2019.4 |
6.99.1 Description
This is the schema definition for the metrics of a power distribution component or unit, such as a floor power distribution unit (PDU) or switchgear.
- This resource shall be used to represent the metrics of a power distribution component or unit for a Redfish implementation.
6.99.2 URIs
/redfish/v1/PowerEquipment/ElectricalBuses/{PowerDistributionId}/Metrics
/redfish/v1/PowerEquipment/FloorPDUs/{PowerDistributionId}/Metrics
/redfish/v1/PowerEquipment/PowerShelves/{PowerDistributionId}/Metrics
/redfish/v1/PowerEquipment/RackPDUs/{PowerDistributionId}/Metrics
/redfish/v1/PowerEquipment/Switchgear/{PowerDistributionId}/Metrics
/redfish/v1/PowerEquipment/TransferSwitches/{PowerDistributionId}/Metrics
6.99.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AbsoluteHumidity (v1.3+) {} | object | Absolute humidity (g/cu m).
|
|
| EnergykWh { | object (excerpt) |
Energy consumption (kWh).
|
|
| ApparentkVAh (v1.5+) | number (kV.A.h) |
read-only (null) |
Apparent energy (kVAh).
|
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| LifetimeReading (v1.1+) | number | read-only (null) |
The total accumulation value for this
sensor.
|
| ReactivekVARh (v1.5+) | number (kV.A.h) |
read-only (null) |
Reactive energy (kVARh).
|
| Reading | number | read-only (null) |
The sensor value.
|
| SensorResetTime | string (date-time) |
read-only (null) |
The date and time when the time-based
properties were last reset.
|
| } | |||
| HumidityPercent (v1.1+) {} | object | Humidity (percent).
|
|
| PowerLoadPercent (v1.2+) {} | object | The power load (percent) for this
equipment.
|
|
| PowerWatts { | object (excerpt) |
Power consumption (W).
|
|
| ApparentVA | number (V.A) |
read-only (null) |
The product of voltage and current for an
AC circuit, in volt-ampere units.
|
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| PhaseAngleDegrees (v1.5+) | number | read-only (null) |
The phase angle (degrees) between the
current and voltage waveforms.
|
| PowerFactor | number | read-only (null) |
The power factor for this
sensor.
|
| ReactiveVAR | number (V.A) |
read-only (null) |
The square root of the difference term of
squared apparent VA and squared power (Reading) for a circuit, in VAR
units.
|
| Reading | number | read-only (null) |
The sensor value.
|
| } | |||
| TemperatureCelsius (v1.1+) {} | object | Temperature (Celsius).
|
6.99.4 Actions
6.99.4.1 ResetMetrics
Description
This action resets the summary metrics related to this equipment.
- This action shall reset any time intervals or counted values for this equipment.
Action URI
{Base URI of target resource}/Actions/PowerDistributionMetrics.ResetMetrics
Action parameters
This action takes no parameters.
6.99.5 Property details
6.99.5.1 SensorExcerpt
The Sensor schema describes a sensor and its properties. This object is an excerpt of the Sensor resource located at the URI shown in DataSourceUri.
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| Reading | number | read-only (null) |
The sensor value.
|
6.99.6 Example response
{
"@odata.type": "#PowerDistributionMetrics.v1_3_0.PowerDistributionMetrics",
"Id": "Metrics",
"Name": "Summary Metrics",
"PowerWatts": {
"DataSourceUri": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/PDUPower",
"Reading": 6438,
"ApparentVA": 6300,
"ReactiveVAR": 100,
"PowerFactor": 0.93
},
"EnergykWh": {
"DataSourceUri": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/PDUEnergy",
"Reading": 56438
},
"TemperatureCelsius": {
"DataSourceUri": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/PDUTemp",
"Reading": 26.3
},
"HumidityPercent": {
"DataSourceUri": "/redfish/v1/PowerEquipment/RackPDUs/1/Sensors/PDUHumidity",
"Reading": 52.7
},
"Actions": {
"#PowerDistributionMetrics.ResetMetrics": {
"target": "/redfish/v1/PowerEquipment/RackPDUs/1/Metrics/PowerDistributionMetrics.ResetMetrics"
}
},
"@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1/Metrics"
}6.100 PowerDomain 1.2.0
| Version | v1.2 | v1.1 | v1.0 |
| Release | 2021.3 | 2021.2 | 2019.4 |
6.100.1 Description
The PowerDomain schema contains definition for the DCIM power domain.
- This resource shall be used to represent a DCIM power domain for a Redfish implementation.
6.100.2 URIs
/redfish/v1/Facilities/{FacilityId}/PowerDomains/{PowerDomainId}
6.100.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| ElectricalBuses (v1.2+) [ { | array | An array of links to the electrical buses
in this power domain.
|
|
| @odata.id | string | read-write | Link to a PowerDistribution resource. See the Links section and the PowerDistribution schema for details. |
| } ] | |||
| FloorPDUs [ { | array | An array of links to the floor power
distribution units in this power domain.
|
|
| @odata.id | string | read-write | Link to a PowerDistribution resource. See the Links section and the PowerDistribution schema for details. |
| } ] | |||
| ManagedBy [ { | array | An array of links to the managers
responsible for managing this power domain.
|
|
| @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 Using this guide clause. | |
| PowerShelves (v1.1+) [ { | array | An array of links to the power shelves in
this power domain.
|
|
| @odata.id | string | read-write | Link to a PowerDistribution resource. See the Links section and the PowerDistribution schema for details. |
| } ] | |||
| RackPDUs [ { | array | An array of links to the rack-level power
distribution units in this power domain.
|
|
| @odata.id | string | read-write | Link to a PowerDistribution resource. See the Links section and the PowerDistribution schema for details. |
| } ] | |||
| Switchgear [ { | array | An array of links to the switchgear in
this power domain.
|
|
| @odata.id | string | read-write | Link to a PowerDistribution resource. See the Links section and the PowerDistribution schema for details. |
| } ] | |||
| TransferSwitches [ { | array | An array of links to the transfer switches
in this power domain.
|
|
| @odata.id | string | read-write | Link to a PowerDistribution resource. See the Links section and the PowerDistribution schema for details. |
| } ] | |||
| } | |||
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
6.100.4 Example response
{
"@odata.type": "#PowerDomain.v1_2_0.PowerDomain",
"Id": "Row1",
"Name": "Row #1 Domain",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Links": {
"ManagedBy": [
{
"@odata.id": "/redfish/v1/Managers/BMC"
}
],
"RackPDUs": [
{
"@odata.id": "/redfish/v1/PowerEquipment/RackPDUs/1"
}
]
},
"@odata.id": "/redfish/v1/Facilities/Room237/PowerDomains/Row1"
}6.101 PowerEquipment 1.2.0
| Version | v1.2 | v1.1 | v1.0 |
| Release | 2021.3 | 2021.2 | 2019.4 |
6.101.1 Description
This is the schema definition for the set of power equipment.
- This resource shall be used to represent the set of power equipment for a Redfish implementation.
6.101.2 URIs
/redfish/v1/PowerEquipment
6.101.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| ElectricalBuses (v1.2+) { | object | The link to a collection of electrical
buses.
|
|
| @odata.id | string | read-only | Link to Collection of PowerDistribution. See the PowerDistribution schema for details. |
| } | |||
| FloorPDUs { | object | A link to a collection of floor power
distribution units.
|
|
| @odata.id | string | read-only | Link to Collection of PowerDistribution. See the PowerDistribution schema for details. |
| } | |||
| Links { | object | The links to other resources that are
related to this resource.
|
|
| ManagedBy [ { | array | An array of links to the managers
responsible for managing this power equipment.
|
|
| @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 Using this guide clause. | |
| } | |||
| PowerShelves (v1.1+) { | object | A link to a collection of power
shelves.
|
|
| @odata.id | string | read-only | Link to Collection of PowerDistribution. See the PowerDistribution schema for details. |
| } | |||
| RackPDUs { | object | A link to a collection of rack-level power
distribution units.
|
|
| @odata.id | string | read-only | Link to Collection of PowerDistribution. See the PowerDistribution schema for details. |
| } | |||
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| Switchgear { | object | A link to a collection of
switchgear.
|
|
| @odata.id | string | read-only | Link to Collection of PowerDistribution. See the PowerDistribution schema for details. |
| } | |||
| TransferSwitches { | object | A link to a collection of transfer
switches.
|
|
| @odata.id | string | read-only | Link to Collection of PowerDistribution. See the PowerDistribution schema for details. |
| } |
6.101.4 Example response
{
"@odata.type": "#PowerEquipment.v1_2_0.PowerEquipment",
"Id": "PowerEquipment",
"Name": "DCIM Power Equipment",
"Status": {
"State": "Enabled",
"HealthRollup": "OK"
},
"FloorPDUs": {
"@odata.id": "/redfish/v1/PowerEquipment/FloorPDUs"
},
"RackPDUs": {
"@odata.id": "/redfish/v1/PowerEquipment/RackPDUs"
},
"TransferSwitches": {
"@odata.id": "/redfish/v1/PowerEquipment/TransferSwitches"
},
"@odata.id": "/redfish/v1/PowerEquipment"
}6.102 PowerSubsystem 1.1.0
| Version | v1.1 | v1.0 |
| Release | 2021.2 | 2020.4 |
6.102.1 Description
This PowerSubsystem schema contains the definition for the power subsystem of a chassis.
- This resource shall represent a power subsystem for a Redfish implementation.
6.102.2 URIs
/redfish/v1/Chassis/{ChassisId}/PowerSubsystem
6.102.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Allocation { | object | Power allocation for this
subsystem.
|
|
| AllocatedWatts | number (Watts) |
read-only (null) |
The total amount of power that has been
allocated or budgeted to this subsystem.
|
| RequestedWatts | number (Watts) |
read-only (null) |
The potential power, in watts, that the
subsystem requests, which might be higher than the current level being
consumed because the requested power includes a budget that the
subsystem wants for future use.
|
| } | |||
| Batteries (v1.1+) { | object | The link to the collection of batteries
within this subsystem.
|
|
| @odata.id | string | read-only | Link to Collection of Battery. See the Battery schema for details. |
| } | |||
| CapacityWatts | number (Watts) |
read-only (null) |
The total amount of power that can be
allocated to this subsystem. This value can be either the power supply
capacity or the power budget that an upstream chassis assigns to this
subsystem.
|
| PowerSupplies { | object | The link to the collection of power
supplies within this subsystem.
|
|
| @odata.id | string | read-only | Link to Collection of PowerSupply. See the PowerSupply schema for details. |
| } | |||
| PowerSupplyRedundancy [ { } ] | array (object) | The redundancy information for the devices
in a redundancy group.
|
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
6.102.4 Example response
{
"@odata.type": "#PowerSubsystem.v1_1_0.PowerSubsystem",
"Id": "PowerSubsystem",
"Name": "Power Subsystem for Chassis",
"CapacityWatts": 2000,
"Allocation": {
"RequestedWatts": 1500,
"AllocatedWatts": 1200
},
"PowerSupplyRedundancy": [
{
"RedundancyType": "Failover",
"MaxSupportedInGroup": 2,
"MinNeededInGroup": 1,
"RedundancyGroup": [
{
"@odata.id": "/redfish/v1/Chassis/1U/PowerSubsystem/PowerSupplies/Bay1"
},
{
"@odata.id": "/redfish/v1/Chassis/1U/PowerSubsystem/PowerSupplies/Bay2"
}
],
"Status": {
"State": "UnavailableOffline",
"Health": "OK"
}
}
],
"PowerSupplies": {
"@odata.id": "/redfish/v1/Chassis/1U/PowerSubsystem/PowerSupplies"
},
"Status": {
"State": "Enabled",
"Health": "OK"
},
"@odata.id": "/redfish/v1/Chassis/1U/PowerSubsystem"
}6.103 PowerSupply 1.5.2
| Version | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2022.2 | 2022.1 | 2021.4 | 2021.3 | 2021.1 | 2020.4 |
6.103.1 Description
The PowerSupply schema describes a power supply unit. It also describes the location, such as a slot, socket, or bay, where a unit can be installed, by populating a resource instance with an absent state if a unit is not present.
- This resource shall represent a power
supply unit for a Redfish implementation. It may also represent a
location, such as a slot, socket, or bay, where a unit may be installed,
but the State property within the Status property contains
Absent.
6.103.2 URIs
/redfish/v1/Chassis/{ChassisId}/PowerSubsystem/PowerSupplies/{PowerSupplyId}
/redfish/v1/PowerEquipment/PowerShelves/{PowerDistributionId}/PowerSupplies/{PowerSupplyId}
(deprecated)
6.103.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Assembly { | object | The link to the assembly associated with
this power supply.
|
|
| @odata.id | string | read-only | Link to a Assembly resource. See the Links section and the Assembly schema for details. |
| } | |||
| EfficiencyRatings [ { | array | The efficiency ratings of this power
supply.
|
|
| EfficiencyPercent | number (%) |
read-only (null) |
The rated efficiency of this power supply
at the specified load.
|
| LoadPercent | number (%) |
read-only (null) |
The electrical load for this
rating.
|
| } ] | |||
| ElectricalSourceManagerURIs (v1.2+) [ ] | array (URI) (string, null) |
read-write | The URIs of the management interfaces for
the upstream electrical source connections for this power
supply.
|
| ElectricalSourceNames (v1.2+) [ ] | array (string, null) | read-write | The names of the upstream electrical
sources, such as circuits or outlets, connected to this power
supply.
|
| FirmwareVersion | string | read-only (null) |
The firmware version for this power
supply.
|
| HotPluggable | boolean | read-only (null) |
An indication of whether this device can
be inserted or removed while the equipment is in operation.
|
| InputNominalVoltageType | string (enum) |
read-only (null) |
The nominal voltage type of the line input
to this power supply.
|
| InputRanges [ { | array | The input ranges that the power supply can
use.
|
|
| CapacityWatts | number (Watts) |
read-only (null) |
The maximum capacity of this power supply
when operating in this input range.
|
| NominalVoltageType | string (enum) |
read-only (null) |
The input voltage range.
|
| } ] | |||
| LineInputStatus (v1.3+) | string (enum) |
read-only (null) |
The status of the line input.
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| Outlet (deprecated v1.4) { | object | A link to the outlet connected to this
power supply.
|
|
| @odata.id | string | read-write | Link to a Outlet resource. See the Links section and the Outlet schema for details. |
| } | |||
| PoweringChassis (v1.4+) [ { | array | An array of links to the chassis that are
directly powered by this power supply.
|
|
| @odata.id | string | read-only | Link to a Chassis resource. See the Links section and the Chassis schema for details. |
| } ] | |||
| PowerOutlets (v1.2+) [ { | array | An array of links to the outlets that
provide power to this power supply.
|
|
| @odata.id | string | read-write | Link to a Outlet resource. See the Links section and the Outlet schema for details. |
| } ] | |||
| } | |||
| Location {} | object | The location of the power
supply.
|
|
| LocationIndicatorActive | boolean | read-write (null) |
An indicator allowing an operator to
physically locate this resource.
|
| Manufacturer | string | read-only (null) |
The manufacturer of this power
supply.
|
| Metrics { | object | The link to the power supply metrics
resource associated with this power supply.
|
|
| @odata.id | string | read-only | Link to a PowerSupplyMetrics resource. See the Links section and the PowerSupplyMetrics schema for details. |
| } | |||
| Model | string | read-only (null) |
The model number for this power
supply.
|
| OutputNominalVoltageType (v1.5+) | string (enum) |
read-only (null) |
The nominal output voltage type of this
power supply.
|
| OutputRails [ { | array | The output power rails provided by this
power supply.
|
|
| NominalVoltage | number | read-only (null) |
The nominal voltage of this output power
rail.
|
| PhysicalContext | string (enum) |
read-only | The area or device to which this power
rail applies.
|
| } ] | |||
| PartNumber | string | read-only (null) |
The part number for this power
supply.
|
| PhaseWiringType | string (enum) |
read-only (null) |
The number of ungrounded current-carrying
conductors (phases) and the total number of conductors (wires) provided
for the power supply input connector.
|
| PlugType | string (enum) |
read-only (null) |
The type of plug according to NEMA, IEC,
or regional standards.
|
| PowerCapacityWatts | number (Watts) |
read-only (null) |
The maximum capacity of this power
supply.
|
| PowerSupplyType | string (enum) |
read-only (null) |
The power supply type (AC or
DC).
|
| ProductionDate (v1.1+) | string (date-time) |
read-only (null) |
The production or manufacturing date of
this power supply.
|
| Replaceable (v1.5+) | boolean | read-only (null) |
An indication of whether this component
can be independently replaced as allowed by the vendor's replacement
policy.
|
| SerialNumber | string | read-only (null) |
The serial number for this power
supply.
|
| SparePartNumber | string | read-only (null) |
The spare part number for this power
supply.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| Version (v1.1+) | string | read-only (null) |
The hardware version of this power
supply.
|
6.103.4 Actions
6.103.4.1 Reset
Description
This action resets the power supply.
- This action shall reset a
power supply. A
GracefulRestartResetType shall reset the power supply but shall not affect the power output. AForceRestartResetType can affect the power supply output.
Action URI
{Base URI of target resource}/Actions/PowerSupply.Reset
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| ResetType | string (enum) |
optional | The type of reset.
|
Request Example
{
"ResetType": "ForceRestart"
}6.103.5 Property details
6.103.5.1 InputNominalVoltageType
The nominal voltage type of the line input to this power supply.
- This property shall contain the nominal voltage type of the input line voltage in use by this power supply. This value shall be one of the values shown in the NominalVoltageType property in the InputRanges array, if present.
| string | Description |
|---|---|
| AC100To127V | AC 100-127V nominal.
|
| 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.
|
| DC12V | DC 12V nominal.
|
| DC16V | DC 16V nominal.
|
| DC1_8V | DC 1.8V nominal.
|
| DC240V | DC 240V nominal.
|
| DC380V | High Voltage DC (380V).
|
| DC3_3V | DC 3.3V nominal.
|
| DC48V | DC 48V nominal.
|
| DC5V | DC 5V nominal.
|
| DC9V | DC 9V nominal.
|
| DCNeg48V | -48V DC.
|
6.103.5.2 LineInputStatus
The status of the line input.
- This property shall contain the status of the power line input for this power supply.
| string | Description |
|---|---|
| LossOfInput | No power detected at line input. |
| Normal | Line input is within normal operating range. |
| OutOfRange | Line input voltage or current is outside of normal operating range. |
6.103.5.3 NominalVoltageType
The input voltage range.
- This property shall contain the input voltage type of the associated range.
| string | Description |
|---|---|
| AC100To127V | AC 100-127V nominal.
|
| 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.
|
| DC12V | DC 12V nominal.
|
| DC16V | DC 16V nominal.
|
| DC1_8V | DC 1.8V nominal.
|
| DC240V | DC 240V nominal.
|
| DC380V | High Voltage DC (380V).
|
| DC3_3V | DC 3.3V nominal.
|
| DC48V | DC 48V nominal.
|
| DC5V | DC 5V nominal.
|
| DC9V | DC 9V nominal.
|
| DCNeg48V | -48V DC.
|
6.103.5.4 OutputNominalVoltageType
The nominal output voltage type of this power supply.
- This property shall contain the nominal voltage type of the single output line of this power supply. This property is intended to describe power supply types that connect to additional power infrastructure components, such as a rectifier component in a modular power system. This property shall not be present for power supplies not intended to connect to additional power infrastructure components.
| string | Description |
|---|---|
| AC100To127V | AC 100-127V nominal.
|
| 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.
|
| DC12V | DC 12V nominal.
|
| DC16V | DC 16V nominal.
|
| DC1_8V | DC 1.8V nominal.
|
| DC240V | DC 240V nominal.
|
| DC380V | High Voltage DC (380V).
|
| DC3_3V | DC 3.3V nominal.
|
| DC48V | DC 48V nominal.
|
| DC5V | DC 5V nominal.
|
| DC9V | DC 9V nominal.
|
| DCNeg48V | -48V DC.
|
6.103.5.5 PhaseWiringType
The number of ungrounded current-carrying conductors (phases) and the total number of conductors (wires) provided for the power supply input connector.
- This property shall contain the number of ungrounded current-carrying conductors (phases) and the total number of conductors (wires) included in the input connector for the power supply.
| 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.103.5.6 PhysicalContext
The area or device to which this power rail applies.
- This property shall contain a description of the device or region within the chassis to which this power rail applies.
| string | Description |
|---|---|
| Accelerator | An accelerator. |
| ACInput | An AC input. |
| ACMaintenanceBypassInput | An AC maintenance bypass input. |
| ACOutput | An AC output. |
| ACStaticBypassInput | An AC static bypass input. |
| ACUtilityInput | An AC utility input. |
| ASIC | An ASIC device, such as a networking chip or chipset component. |
| Back | The back of the chassis. |
| Backplane | A backplane within the chassis. |
| Battery | A battery. |
| Board | A circuit board.
|
| Chassis | The entire chassis. |
| ComputeBay | Within a compute bay. |
| CoolingSubsystem | The entire cooling, or air and liquid, subsystem. |
| CPU | A processor (CPU). |
| CPUSubsystem | The entire processor (CPU) subsystem. |
| DCBus | A DC bus. |
| Exhaust | The air exhaust point or points or region of the chassis. |
| ExpansionBay | Within an expansion bay. |
| Fan | A fan. |
| FPGA | An FPGA. |
| Front | The front of the chassis. |
| GPU | A graphics processor (GPU). |
| GPUSubsystem | The entire graphics processor (GPU) subsystem. |
| Intake | The air intake point or points or region of the chassis. |
| LiquidInlet | The liquid inlet point of the chassis. |
| LiquidOutlet | The liquid outlet point of the chassis. |
| Lower | The lower portion of the chassis. |
| Memory | A memory device. |
| MemorySubsystem | The entire memory subsystem. |
| Motor | A motor. |
| NetworkBay | Within a networking bay. |
| NetworkingDevice | A networking device. |
| PowerSubsystem | The entire power subsystem. |
| PowerSupply | A power supply. |
| PowerSupplyBay | Within a power supply bay. |
| Pump | A pump. |
| Rectifier | A rectifier device. |
| Room | The room. |
| StorageBay | Within a storage bay. |
| StorageDevice | A storage device. |
| SystemBoard | The system board (PCB). |
| Transceiver | A transceiver.
|
| Transformer | A transformer. |
| TrustedModule | A trusted module. |
| Upper | The upper portion of the chassis. |
| VoltageRegulator | A voltage regulator device. |
6.103.5.7 PlugType
The type of plug according to NEMA, IEC, or regional standards.
- This property shall contain the type of physical plug used for the input to this power supply, as defined by IEC, NEMA, or regional standard.
| 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.103.5.8 PowerSupplyType
The power supply type (AC or DC).
- This property shall contain the input power type (AC or DC) of this power supply.
| string | Description |
|---|---|
| AC | Alternating Current (AC) power supply. |
| ACorDC | The power supply supports both DC or AC. |
| DC | Direct Current (DC) power supply. |
| DCRegulator (v1.5+) | Direct Current (DC) voltage regulator. |
6.103.5.9 ResetType
The type of reset.
- This parameter shall contain the type of
reset. The service can accept a request without the parameter and shall
perform a
GracefulRestart.
| string | Description |
|---|---|
| ForceOff | Turn off the unit immediately
(non-graceful shutdown).
|
| ForceOn | Turn on the unit immediately.
|
| ForceRestart | Shut down immediately and non-gracefully
and restart the system.
|
| GracefulRestart | Shut down gracefully and restart the
system.
|
| GracefulShutdown | Shut down gracefully and power
off.
|
| Nmi | Generate a diagnostic interrupt, which is
usually an NMI on x86 systems, to stop normal operations, complete
diagnostic actions, and, typically, halt the system.
|
| On | Turn on the unit.
|
| Pause | Pause execution on the unit but do not
remove power. This is typically a feature of virtual machine
hypervisors.
|
| PowerCycle | Power cycle the unit. Behaves like a full
power removal, followed by a power restore to the resource.
|
| PushPowerButton | Simulate the pressing of the physical
power button on this unit.
|
| Resume | Resume execution on the paused unit. This
is typically a feature of virtual machine hypervisors.
|
| Suspend | Write the state of the unit to disk before
powering off. This allows for the state to be restored when powered back
on.
|
6.103.6 Example response
{
"@odata.type": "#PowerSupply.v1_5_2.PowerSupply",
"Id": "Bay1",
"Name": "Power Supply Bay 1",
"Status": {
"State": "Enabled",
"Health": "Warning"
},
"LineInputStatus": "Normal",
"Model": "RKS-440DC",
"Manufacturer": "Contoso Power",
"FirmwareVersion": "1.00",
"SerialNumber": "3488247",
"PartNumber": "23456-133",
"SparePartNumber": "93284-133",
"LocationIndicatorActive": false,
"HotPluggable": false,
"PowerCapacityWatts": 400,
"PhaseWiringType": "OnePhase3Wire",
"PlugType": "IEC_60320_C14",
"InputRanges": [
{
"NominalVoltageType": "AC200To240V",
"CapacityWatts": 400
},
{
"NominalVoltageType": "AC120V",
"CapacityWatts": 350
},
{
"NominalVoltageType": "DC380V",
"CapacityWatts": 400
}
],
"EfficiencyRatings": [
{
"LoadPercent": 25,
"EfficiencyPercent": 75
},
{
"LoadPercent": 50,
"EfficiencyPercent": 85
},
{
"LoadPercent": 90,
"EfficiencyPercent": 80
}
],
"OutputRails": [
{
"NominalVoltage": 3.3,
"PhysicalContext": "SystemBoard"
},
{
"NominalVoltage": 5,
"PhysicalContext": "SystemBoard"
},
{
"NominalVoltage": 12,
"PhysicalContext": "StorageDevice"
}
],
"Location": {
"PartLocation": {
"ServiceLabel": "PSU 1",
"LocationType": "Bay",
"LocationOrdinalValue": 0
}
},
"Links": {
"Outlet": {
"@odata.id": "https://redfishpdu.contoso.com/redfish/v1/PowerEquipment/RackPDUs/1/Outlets/A4"
}
},
"Assembly": {
"@odata.id": "/redfish/v1/Chassis/1U/PowerSubsystem/PowerSupplies/Bay1/Assembly"
},
"Metrics": {
"@odata.id": "/redfish/v1/Chassis/1U/PowerSubsystem/PowerSupplies/Bay1/Metrics"
},
"Actions": {
"#PowerSupply.Reset": {
"target": "/redfish/v1/Chassis/1U/PowerSubsystem/PowerSupplies/Bay1/PowerSupply.Reset"
}
},
"@odata.id": "/redfish/v1/Chassis/1U/PowerSubsystem/PowerSupplies/Bay1"
}6.104 PowerSupplyMetrics 1.1.0
| Version | v1.1 | v1.0 |
| Release | 2023.1 | 2020.4 |
6.104.1 Description
The PowerSupplyMetrics schema contains definitions for the metrics of a power supply.
- This resource shall be used to represent the metrics of a power supply unit for a Redfish implementation.
6.104.2 URIs
/redfish/v1/Chassis/{ChassisId}/PowerSubsystem/PowerSupplies/{PowerSupplyId}/Metrics
/redfish/v1/PowerEquipment/PowerShelves/{PowerDistributionId}/PowerSupplies/{PowerSupplyId}/Metrics
6.104.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| EnergykWh { | object (excerpt) |
The energy consumption (kWh) of this
unit.
|
|
| ApparentkVAh (v1.5+) | number (kV.A.h) |
read-only (null) |
Apparent energy (kVAh).
|
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| LifetimeReading (v1.1+) | number | read-only (null) |
The total accumulation value for this
sensor.
|
| ReactivekVARh (v1.5+) | number (kV.A.h) |
read-only (null) |
Reactive energy (kVARh).
|
| Reading | number | read-only (null) |
The sensor value.
|
| SensorResetTime | string (date-time) |
read-only (null) |
The date and time when the time-based
properties were last reset.
|
| } | |||
| FanSpeedPercent (deprecated v1.1) { | object (excerpt) |
The fan speed (percent) for this power
supply.
|
|
| 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.
|
| SpeedRPM (v1.2+) | number ({rev}/min) |
read-only (null) |
The rotational speed.
|
| } | |||
| FanSpeedsPercent (v1.1+) [ { | array (excerpt) |
Fan speeds (percent).
|
|
| 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.
|
| PhysicalSubContext | string (enum) |
read-only (null) |
The usage or location within a device to
which this sensor measurement applies.
|
| Reading | number | read-only (null) |
The sensor value.
|
| SpeedRPM (v1.2+) | number ({rev}/min) |
read-only (null) |
The rotational speed.
|
| } ] | |||
| FrequencyHz { | object (excerpt) |
The frequency (Hz) for this power
supply.
|
|
| 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.
|
| } | |||
| InputCurrentAmps { | object (excerpt) |
The input current (A) for this power
supply.
|
|
| 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 percent (%
THD).
|
| } | |||
| InputPowerWatts { | object (excerpt) |
The input power (W) for this power
supply.
|
|
| ApparentVA | number (V.A) |
read-only (null) |
The product of voltage and current for an
AC circuit, in volt-ampere units.
|
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| PhaseAngleDegrees (v1.5+) | number | read-only (null) |
The phase angle (degrees) between the
current and voltage waveforms.
|
| PowerFactor | number | read-only (null) |
The power factor for this
sensor.
|
| ReactiveVAR | number (V.A) |
read-only (null) |
The square root of the difference term of
squared apparent VA and squared power (Reading) for a circuit, in VAR
units.
|
| Reading | number | read-only (null) |
The sensor value.
|
| } | |||
| InputVoltage { | object (excerpt) |
The input voltage (V) for this power
supply.
|
|
| 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 percent (%
THD).
|
| } | |||
| OutputPowerWatts { | object (excerpt) |
The total power output (W) for this power
supply.
|
|
| ApparentVA | number (V.A) |
read-only (null) |
The product of voltage and current for an
AC circuit, in volt-ampere units.
|
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| PhaseAngleDegrees (v1.5+) | number | read-only (null) |
The phase angle (degrees) between the
current and voltage waveforms.
|
| PowerFactor | number | read-only (null) |
The power factor for this
sensor.
|
| ReactiveVAR | number (V.A) |
read-only (null) |
The square root of the difference term of
squared apparent VA and squared power (Reading) for a circuit, in VAR
units.
|
| Reading | number | read-only (null) |
The sensor value.
|
| } | |||
| RailCurrentAmps [ { | array (excerpt) |
The output currents (A) for this power
supply.
|
|
| 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 percent (%
THD).
|
| } ] | |||
| RailPowerWatts [ { | array (excerpt) |
The output power readings (W) for this
power supply.
|
|
| ApparentVA | number (V.A) |
read-only (null) |
The product of voltage and current for an
AC circuit, in volt-ampere units.
|
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| PhaseAngleDegrees (v1.5+) | number | read-only (null) |
The phase angle (degrees) between the
current and voltage waveforms.
|
| PowerFactor | number | read-only (null) |
The power factor for this
sensor.
|
| ReactiveVAR | number (V.A) |
read-only (null) |
The square root of the difference term of
squared apparent VA and squared power (Reading) for a circuit, in VAR
units.
|
| Reading | number | read-only (null) |
The sensor value.
|
| } ] | |||
| RailVoltage [ { | array (excerpt) |
The output voltages (V) for this power
supply.
|
|
| 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 percent (%
THD).
|
| } ] | |||
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| TemperatureCelsius { | object (excerpt) |
The temperature (C) for this power
supply.
|
|
| 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.104.4 Actions
6.104.4.1 ResetMetrics
Description
This action resets the summary metrics related to this equipment.
- This action shall reset any time intervals or counted values for this equipment.
Action URI
{Base URI of target resource}/Actions/PowerSupplyMetrics.ResetMetrics
Action parameters
This action takes no parameters.
6.104.5 Property details
6.104.5.1 PhysicalContext
The area or device to which this sensor measurement applies.
- This property shall contain a description of the affected component or region within the equipment 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. |
| Battery | A battery. |
| Board | A circuit board.
|
| Chassis | The entire chassis. |
| ComputeBay | Within a compute bay. |
| CoolingSubsystem | The entire cooling, or air and liquid, subsystem. |
| CPU | A processor (CPU). |
| CPUSubsystem | The entire processor (CPU) subsystem. |
| DCBus | A DC bus. |
| Exhaust | The air exhaust point or points or region of the chassis. |
| ExpansionBay | Within an expansion bay. |
| Fan | A fan. |
| FPGA | An FPGA. |
| Front | The front of the chassis. |
| GPU | A graphics processor (GPU). |
| GPUSubsystem | The entire graphics processor (GPU) subsystem. |
| Intake | The air intake point or points or region of the chassis. |
| LiquidInlet | The liquid inlet point of the chassis. |
| LiquidOutlet | The liquid outlet point of the chassis. |
| Lower | The lower portion of the chassis. |
| Memory | A memory device. |
| MemorySubsystem | The entire memory subsystem. |
| Motor | A motor. |
| NetworkBay | Within a networking bay. |
| NetworkingDevice | A networking device. |
| PowerSubsystem | The entire power subsystem. |
| PowerSupply | A power supply. |
| PowerSupplyBay | Within a power supply bay. |
| Pump | A pump. |
| Rectifier | A rectifier device. |
| Room | The room. |
| StorageBay | Within a storage bay. |
| StorageDevice | A storage device. |
| SystemBoard | The system board (PCB). |
| Transceiver | A transceiver.
|
| Transformer | A transformer. |
| TrustedModule | A trusted module. |
| Upper | The upper portion of the chassis. |
| VoltageRegulator | A voltage regulator device. |
6.104.5.2 PhysicalSubContext
The usage or location within a device to which this sensor measurement applies.
- This property shall contain a description of the usage or sub-region within the equipment to which this sensor measurement applies. This property generally differentiates multiple sensors within the same PhysicalContext instance.
| string | Description |
|---|---|
| Input | The input. |
| Output | The output. |
6.104.6 Example response
{
"@odata.type": "#PowerSupplyMetrics.v1_1_0.PowerSupplyMetrics",
"Id": "Metrics",
"Name": "Metrics for Power Supply 1",
"Status": {
"State": "Enabled",
"Health": "Warning"
},
"InputVoltage": {
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/PS1InputVoltage",
"Reading": 230.2
},
"InputCurrentAmps": {
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/PS1InputCurrent",
"Reading": 5.19
},
"InputPowerWatts": {
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/PS1InputPower",
"Reading": 937.4
},
"RailVoltage": [
{
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/PS1_3VOutput",
"Reading": 3.31
},
{
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/PS1_5VOutput",
"Reading": 5.03
},
{
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/PS1_12VOutput",
"Reading": 12.06
}
],
"RailCurrentAmps": [
{
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/PS1_3VCurrent",
"Reading": 9.84
},
{
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/PS1_5VCurrent",
"Reading": 1.25
},
{
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/PS1_12Current",
"Reading": 2.58
}
],
"OutputPowerWatts": {
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/PS1OutputPower",
"Reading": 937.4
},
"RailPowerWatts": [
{
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/PS1_3VPower",
"Reading": 79.84
},
{
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/PS1_5VPower",
"Reading": 26.25
},
{
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/PS1_12VPower",
"Reading": 91.58
}
],
"EnergykWh": {
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/PS1Energy",
"Reading": 325675
},
"FrequencyHz": {
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/PS1InputFrequency",
"Reading": 60
},
"TemperatureCelsius": {
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/PS1Temp",
"Reading": 43.9
},
"FanSpeedPercent": {
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/PS1Fan",
"Reading": 68,
"SpeedRPM": 3290
},
"Actions": {
"#PowerSupplyMetrics.ResetMetrics": {
"target": "/redfish/v1/Chassis/1U/PowerSubsystem/PowerSupplies/Bay1/Metrics/PowerSupplyMetrics.ResetMetrics"
}
},
"@odata.id": "/redfish/v1/Chassis/1U/PowerSubsystem/PowerSupplies/Bay1/Metrics"
}6.105 PrivilegeRegistry 1.1.4
| Version | v1.1 | v1.0 |
| Release | 2017.1 | 2016.3 |
6.105.1 Description
The PrivilegeRegistry schema describes the operation-to-privilege mappings.
- This Resource contains operation-to-privilege mappings.
6.105.2 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Mappings [ { | array | The mappings between entities and the
relevant privileges that access those entities.
|
|
| Entity | string | read-only | The Resource name, such as
Manager.
|
| OperationMap { | object | List mapping between HTTP methods and
privilege required for the Resource.
|
|
| DELETE [ { | array | The privilege required to complete an HTTP
DELETE operation.
|
|
| Privilege [ ] | array (string) | read-only | An array of privileges that are required
to complete a specific HTTP operation on a Resource.
|
| } ] | |||
| GET [ { | array | The privilege required to complete an HTTP
GET operation.
|
|
| Privilege [ ] | array (string) | read-only | An array of privileges that are required
to complete a specific HTTP operation on a Resource.
|
| } ] | |||
| HEAD [ { | array | The privilege required to complete an HTTP
HEAD operation.
|
|
| Privilege [ ] | array (string) | read-only | An array of privileges that are required
to complete a specific HTTP operation on a Resource.
|
| } ] | |||
| PATCH [ { | array | The privilege required to complete an HTTP
PATCH operation.
|
|
| Privilege [ ] | array (string) | read-only | An array of privileges that are required
to complete a specific HTTP operation on a Resource.
|
| } ] | |||
| POST [ { | array | The privilege required to complete an HTTP
POST operation.
|
|
| Privilege [ ] | array (string) | read-only | An array of privileges that are required
to complete a specific HTTP operation on a Resource.
|
| } ] | |||
| PUT [ { | array | The privilege required to complete an HTTP
PUT operation.
|
|
| Privilege [ ] | array (string) | read-only | An array of privileges that are required
to complete a specific HTTP operation on a Resource.
|
| } ] | |||
| } | |||
| PropertyOverrides [ { | array | The privilege overrides of properties
within a Resource.
|
|
| OperationMap { | object | The mapping between the HTTP operation and
the privilege required to complete the operation.
|
|
| DELETE [ { | array | The privilege required to complete an HTTP
DELETE operation.
|
|
| Privilege [ ] | array (string) | read-only | An array of privileges that are required
to complete a specific HTTP operation on a Resource.
|
| } ] | |||
| GET [ { | array | The privilege required to complete an HTTP
GET operation.
|
|
| Privilege [ ] | array (string) | read-only | An array of privileges that are required
to complete a specific HTTP operation on a Resource.
|
| } ] | |||
| HEAD [ { | array | The privilege required to complete an HTTP
HEAD operation.
|
|
| Privilege [ ] | array (string) | read-only | An array of privileges that are required
to complete a specific HTTP operation on a Resource.
|
| } ] | |||
| PATCH [ { | array | The privilege required to complete an HTTP
PATCH operation.
|
|
| Privilege [ ] | array (string) | read-only | An array of privileges that are required
to complete a specific HTTP operation on a Resource.
|
| } ] | |||
| POST [ { | array | The privilege required to complete an HTTP
POST operation.
|
|
| Privilege [ ] | array (string) | read-only | An array of privileges that are required
to complete a specific HTTP operation on a Resource.
|
| } ] | |||
| PUT [ { | array | The privilege required to complete an HTTP
PUT operation.
|
|
| Privilege [ ] | array (string) | read-only | An array of privileges that are required
to complete a specific HTTP operation on a Resource.
|
| } ] | |||
| } | |||
| Targets [ ] | array (string, null) | read-only | The set of URIs, Resource types, or
properties.
|
| } ] | |||
| ResourceURIOverrides [ { | array | The privilege overrides of Resource
URIs.
|
|
| OperationMap { | object | The mapping between the HTTP operation and
the privilege required to complete the operation.
|
|
| DELETE [ { | array | The privilege required to complete an HTTP
DELETE operation.
|
|
| Privilege [ ] | array (string) | read-only | An array of privileges that are required
to complete a specific HTTP operation on a Resource.
|
| } ] | |||
| GET [ { | array | The privilege required to complete an HTTP
GET operation.
|
|
| Privilege [ ] | array (string) | read-only | An array of privileges that are required
to complete a specific HTTP operation on a Resource.
|
| } ] | |||
| HEAD [ { | array | The privilege required to complete an HTTP
HEAD operation.
|
|
| Privilege [ ] | array (string) | read-only | An array of privileges that are required
to complete a specific HTTP operation on a Resource.
|
| } ] | |||
| PATCH [ { | array | The privilege required to complete an HTTP
PATCH operation.
|
|
| Privilege [ ] | array (string) | read-only | An array of privileges that are required
to complete a specific HTTP operation on a Resource.
|
| } ] | |||
| POST [ { | array | The privilege required to complete an HTTP
POST operation.
|
|
| Privilege [ ] | array (string) | read-only | An array of privileges that are required
to complete a specific HTTP operation on a Resource.
|
| } ] | |||
| PUT [ { | array | The privilege required to complete an HTTP
PUT operation.
|
|
| Privilege [ ] | array (string) | read-only | An array of privileges that are required
to complete a specific HTTP operation on a Resource.
|
| } ] | |||
| } | |||
| Targets [ ] | array (string, null) | read-only | The set of URIs, Resource types, or
properties.
|
| } ] | |||
| SubordinateOverrides [ { | array | The privilege overrides of the subordinate
Resource.
|
|
| OperationMap { | object | The mapping between the HTTP operation and
the privilege required to complete the operation.
|
|
| DELETE [ { | array | The privilege required to complete an HTTP
DELETE operation.
|
|
| Privilege [ ] | array (string) | read-only | An array of privileges that are required
to complete a specific HTTP operation on a Resource.
|
| } ] | |||
| GET [ { | array | The privilege required to complete an HTTP
GET operation.
|
|
| Privilege [ ] | array (string) | read-only | An array of privileges that are required
to complete a specific HTTP operation on a Resource.
|
| } ] | |||
| HEAD [ { | array | The privilege required to complete an HTTP
HEAD operation.
|
|
| Privilege [ ] | array (string) | read-only | An array of privileges that are required
to complete a specific HTTP operation on a Resource.
|
| } ] | |||
| PATCH [ { | array | The privilege required to complete an HTTP
PATCH operation.
|
|
| Privilege [ ] | array (string) | read-only | An array of privileges that are required
to complete a specific HTTP operation on a Resource.
|
| } ] | |||
| POST [ { | array | The privilege required to complete an HTTP
POST operation.
|
|
| Privilege [ ] | array (string) | read-only | An array of privileges that are required
to complete a specific HTTP operation on a Resource.
|
| } ] | |||
| PUT [ { | array | The privilege required to complete an HTTP
PUT operation.
|
|
| Privilege [ ] | array (string) | read-only | An array of privileges that are required
to complete a specific HTTP operation on a Resource.
|
| } ] | |||
| } | |||
| Targets [ ] | array (string, null) | read-only | The set of URIs, Resource types, or
properties.
|
| } ] | |||
| } ] | |||
| OEMPrivilegesUsed [ ] | array (string) | read-only | The set of OEM privileges used in this
mapping.
|
| PrivilegesUsed [ ] | array (string (enum)) |
read-only |
|
6.105.3 Property details
6.105.3.1 PrivilegesUsed
- The set of Redfish standard privileges used in this mapping.
- This property shall contain an array of Redfish standard privileges used in this mapping.
| string | Description |
|---|---|
| AdministrateStorage | Administrator for storage subsystems and storage systems found in the storage collection and storage system collection respectively. |
| AdministrateSystems | Administrator for systems found in the systems collection. Able to manage boot configuration, keys, and certificates for systems. |
| 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, log out of their own sessions, and perform operations on resources they created. Services will need to be aware of resource ownership to map this privilege to an operation from a particular user. |
| ConfigureUsers | Can configure users and their accounts. |
| Login | Can log in to the service and read resources. |
| NoAuth | Authentication is not
required.
|
| OperateStorageBackup | Operator for storage backup functionality for storage subsystems and storage systems found in the storage collection and storage system collection respectively. |
| OperateSystems | Operator for systems found in the systems collection. Able to perform resets and configure interfaces. |
6.105.4 Example response
{
"@odata.type": "#PrivilegeRegistry.v1_1_4.PrivilegeRegistry",
"Id": "Contoso_1.0.1_PrivilegeRegistry",
"Name": "Privilege Map",
"PrivilegesUsed": [
"Login",
"ConfigureManager",
"ConfigureUsers",
"ConfigureComponents",
"ConfigureSelf"
],
"OEMPrivilegesUsed": [],
"Mappings": [
{
"Entity": "Manager",
"OperationMap": {
"GET": [
{
"Privilege": [
"Login"
]
}
],
"HEAD": [
{
"Privilege": [
"Login"
]
}
],
"PATCH": [
{
"Privilege": [
"ConfigureManager"
]
}
],
"POST": [
{
"Privilege": [
"ConfigureManager"
]
}
],
"PUT": [
{
"Privilege": [
"ConfigureManager"
]
}
],
"DELETE": [
{
"Privilege": [
"ConfigureManager"
]
}
]
}
}
],
"@odata.id": "/redfish/v1/JobService"
}6.106 Processor 1.18.0
| Version | v1.18 | v1.17 | v1.16 | v1.15 | v1.14 | v1.13 | v1.12 | v1.11 | v1.10 | v1.9 | v1.8 | ... |
| Release | 2023.1 | 2022.3 | 2022.2 | 2022.1 | 2021.4 | 2021.2 | 2021.1 | 2020.4 | 2020.3 | 2020.2 | 2020.1 | ... |
6.106.1 Description
The Processor schema describes the information about a single processor that a system contains. A processor includes both performance characteristics, clock speed, architecture, core count, and so on, and compatibility, such as the CPU ID instruction results. It also describes the location, such as a slot, socket, or bay, where a unit can be installed, by populating a resource instance with an absent state if a unit is not present.
- This resource shall represent a single
processor that a system contains. A processor includes both performance
characteristics, clock speed, architecture, core count, and so on, and
compatibility, such as the CPU ID instruction results. It may also
represent a location, such as a slot, socket, or bay, where a unit may
be installed, but the State property within the Status property contains
Absent.
6.106.2 URIs
/redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/Processors/{ProcessorId}
/redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}
/redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors/{ProcessorId3}
/redfish/v1/Chassis/{ChassisId}/Processors/{ProcessorId}
/redfish/v1/Chassis/{ChassisId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}
/redfish/v1/Chassis/{ChassisId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors/{ProcessorId3}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors/{ProcessorId3}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors/{ProcessorId3}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors/{ProcessorId3}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors/{ProcessorId3}
/redfish/v1/Systems/{ComputerSystemId}/Processors/{ProcessorId}
/redfish/v1/Systems/{ComputerSystemId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}
/redfish/v1/Systems/{ComputerSystemId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors/{ProcessorId3}
6.106.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AccelerationFunctions (v1.4+) { | object | The link to the collection of acceleration
functions associated with this processor.
|
|
| @odata.id | string | read-only | Link to Collection of AccelerationFunction. See the AccelerationFunction schema for details. |
| } | |||
| AdditionalFirmwareVersions (v1.15+) { | object | The additional firmware versions of the
processor.
|
|
| Bootloader (v1.7+) | string | read-only (null) |
The bootloader version contained in this
software, such as U-Boot or UEFI.
|
| Kernel (v1.7+) | string | read-only (null) |
The kernel version contained in this
software.
|
| Microcode (v1.7+) | string | read-only (null) |
The microcode version contained in this
software, such as processor microcode.
|
| Oem (v1.7+) {} | object | See the OEM object definition in the Using this guide clause. | |
| OSDistribution (v1.8+) | string | read-only (null) |
The operating system name of this
software.
|
| } | |||
| AppliedOperatingConfig (v1.9+) { | object | The link to the operating configuration
that is applied to this processor.
|
|
| @odata.id | string | read-write | Link to a OperatingConfig resource. See the Links section and the OperatingConfig schema for details. |
| } | |||
| Assembly (v1.2+) { | object | The link to an assembly associated with
this processor.
|
|
| @odata.id | string | read-only | Link to a Assembly resource. See the Links section and the Assembly schema for details. |
| } | |||
| BaseSpeedMHz (v1.10+) | integer (MHz) |
read-only (null) |
The base (nominal) clock speed of the
processor in MHz.
|
| BaseSpeedPriorityState (v1.9+) | string (enum) |
read-only (null) |
The state of the base frequency settings
of the operation configuration applied to this processor.
|
| Certificates (v1.11+) { | object | The link to a collection of certificates
for device identity and attestation.
|
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| Enabled (v1.12+) | boolean | read-write | An indication of whether this processor is
enabled.
|
| EnvironmentMetrics (v1.11+) { | object | The link to the environment metrics for
this processor.
|
|
| @odata.id | string | read-only | Link to a EnvironmentMetrics resource. See the Links section and the EnvironmentMetrics schema for details. |
| } | |||
| Family (v1.16+) | string | read-only (null) |
The processor family.
|
| FirmwareVersion (v1.7+) | string | read-only | The firmware version of the
processor.
|
| FPGA (v1.4+) { | object | The properties for processors of the FPGA
type.
|
|
| ExternalInterfaces (v1.4+) [ { | array | An array of the FPGA external
interfaces.
|
|
| Ethernet (v1.4+) { | object | The Ethernet-related information for this
interface.
|
|
| MaxLanes (v1.4+) | integer | read-only (null) |
The number of lanes supported by this
interface.
|
| MaxSpeedMbps (v1.4+) | integer (Mbit/s) |
read-only (null) |
The maximum speed supported by this
interface.
|
| Oem (v1.4+) {} | object | See the OEM object definition in the Using this guide clause. | |
| } | |||
| InterfaceType (v1.4+) | string (enum) |
read-only (null) |
The interface type.
|
| PCIe (v1.4+) { | object | The PCIe-related information for this
interface.
|
|
| LanesInUse (v1.3+) | integer | read-only (null) |
The number of PCIe lanes in use by this
device.
|
| MaxLanes (v1.3+) | integer | read-only (null) |
The number of PCIe lanes supported by this
device.
|
| MaxPCIeType (v1.3+) | string (enum) |
read-only (null) |
The highest version of the PCIe
specification supported by this device.
|
| Oem (v1.3+) {} | object | See the OEM object definition in the Using this guide clause. | |
| PCIeType (v1.3+) | string (enum) |
read-only (null) |
The version of the PCIe specification in
use by this device.
|
| } | |||
| } ] | |||
| FirmwareId (v1.4+) | string | read-only | The FPGA firmware identifier.
|
| FirmwareManufacturer (v1.4+) | string | read-only | The FPGA firmware
manufacturer.
|
| FirmwareVersion (v1.4+, deprecated v1.9 | string | read-only | The FPGA firmware version.
|
| FpgaType (v1.4+) | string (enum) |
read-only | The FPGA type.
|
| HostInterface (v1.4+, deprecated v1.8 { | object | The FPGA interface to the
host.
|
|
| Ethernet (v1.4+) { | object | The Ethernet-related information for this
interface.
|
|
| MaxLanes (v1.4+) | integer | read-only (null) |
The number of lanes supported by this
interface.
|
| MaxSpeedMbps (v1.4+) | integer (Mbit/s) |
read-only (null) |
The maximum speed supported by this
interface.
|
| Oem (v1.4+) {} | object | See the OEM object definition in the Using this guide clause. | |
| } | |||
| InterfaceType (v1.4+) | string (enum) |
read-only (null) |
The interface type.
|
| PCIe (v1.4+) { | object | The PCIe-related information for this
interface.
|
|
| LanesInUse (v1.3+) | integer | read-only (null) |
The number of PCIe lanes in use by this
device.
|
| MaxLanes (v1.3+) | integer | read-only (null) |
The number of PCIe lanes supported by this
device.
|
| MaxPCIeType (v1.3+) | string (enum) |
read-only (null) |
The highest version of the PCIe
specification supported by this device.
|
| Oem (v1.3+) {} | object | See the OEM object definition in the Using this guide clause. | |
| PCIeType (v1.3+) | string (enum) |
read-only (null) |
The version of the PCIe specification in
use by this device.
|
| } | |||
| } | |||
| Model (v1.4+) | string | read-only | The FPGA model.
|
| Oem (v1.4+) {} | object | See the OEM object definition in the Using this guide clause. | |
| PCIeVirtualFunctions (v1.4+) | integer | read-write | The number of the PCIe Virtual
Functions.
|
| ProgrammableFromHost (v1.4+) | boolean | read-write (null) |
An indication of whether the FPGA firmware
can be reprogrammed from the host by using system software.
|
| ReconfigurationSlots (v1.4+) [ { | array | An array of the FPGA reconfiguration
slots. An FPGA uses a reconfiguration slot to contain an acceleration
function that can change as the FPGA is provisioned.
|
|
| AccelerationFunction (v1.4+) { | object | The link to the acceleration function that
the code programmed into a reconfiguration slot provides.
|
|
| @odata.id | string | read-only | Link to a AccelerationFunction resource. See the Links section and the AccelerationFunction schema for details. |
| } | |||
| ProgrammableFromHost (v1.4+) | boolean | read-write (null) |
An indication of whether the
reconfiguration slot can be reprogrammed from the host by using system
software.
|
| SlotId (v1.4+) | string | read-only (null) |
The FPGA reconfiguration slot
identifier.
|
| UUID (v1.4+) | string (uuid) |
read-only (null) |
The UUID for this reconfiguration
slot.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ |
| } ] | |||
| } | |||
| HighSpeedCoreIDs (v1.9+) [ ] | array (integer, null) | read-only | The list of core identifiers corresponding
to the cores that have been configured with the higher clock speed from
the operating configuration applied to this processor.
|
| InstructionSet | string (enum) |
read-only (null) |
The instruction set of the
processor.
|
| Links (v1.1+) { | object | The links to other resources that are
related to this resource.
|
|
| Chassis (v1.1+) { | object | The link to the chassis that contains this
processor.
|
|
| @odata.id | string | read-only | Link to a Chassis resource. See the Links section and the Chassis schema for details. |
| } | |||
| ConnectedProcessors (v1.4+) [ { | array | An array of links to the processors
directly connected to this processor.
|
|
| @odata.id | string | read-only | Link to another Processor resource. |
| } ] | |||
| Endpoints (v1.4+) [ { | array | An array of links to the endpoints that
connect to this processor.
|
|
| @odata.id | string | read-only | Link to a Endpoint resource. See the Links section and the Endpoint schema for details. |
| } ] | |||
| FabricAdapters (v1.17+) [ { | array | An array of links to the fabric adapters
that present this processor to a fabric.
|
|
| @odata.id | string | read-only | Link to a FabricAdapter resource. See the Links section and the FabricAdapter schema for details. |
| } ] | |||
| GraphicsController (v1.12+) { | object | (null) |
A link to the graphics controller
associated with this processor.
|
| @odata.id | string | read-only | Link to a GraphicsController resource. See the Links section and the GraphicsController schema for details. |
| } | |||
| Memory (v1.11+) [ { | array | An array of links to the memory associated
with this processor.
|
|
| @odata.id | string | read-only | Link to a Memory resource. See the Links section and the Memory schema for details. |
| } ] | |||
| NetworkDeviceFunctions (v1.13+) [ { | array | The network device functions to which this
processor performs offload computation, such as with a
SmartNIC.
|
|
| @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 Using this guide clause. | |
| PCIeDevice (v1.4+) { | object | The link to the PCIe device associated
with this processor.
|
|
| @odata.id | string | read-only | Link to a PCIeDevice resource. See the Links section and the PCIeDevice schema for details. |
| } | |||
| PCIeFunctions (v1.4+) [ { | array | An array of links to the PCIeFunctions
associated with this processor.
|
|
| @odata.id | string | read-only | Link to a PCIeFunction resource. See the Links section and the PCIeFunction schema for details. |
| } ] | |||
| } | |||
| Location (v1.2+) {} | object | The location of the processor.
|
|
| LocationIndicatorActive (v1.10+) | boolean | read-write (null) |
An indicator allowing an operator to
physically locate this resource.
|
| Manufacturer | string | read-only (null) |
The processor manufacturer.
|
| MaxSpeedMHz | integer (MHz) |
read-only (null) |
The maximum clock speed of the
processor.
|
| MaxTDPWatts (v1.4+) | integer (Watts) |
read-only (null) |
The maximum Thermal Design Power (TDP) in
watts.
|
| Measurements (v1.11+, deprecated 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. |
| } ] | |||
| MemorySummary (v1.11+) { | object | The summary of all memory associated with
this processor.
|
|
| ECCModeEnabled (v1.13+) | boolean | read-write (null) |
An indication of whether memory ECC mode
is enabled for this processor.
|
| Metrics (v1.11+) { | object | The link to the memory metrics associated
with all memory of this processor.
|
|
| @odata.id | string | read-only | Link to a MemoryMetrics resource. See the Links section and the MemoryMetrics schema for details. |
| } | |||
| TotalCacheSizeMiB (v1.11+) | integer (mebibytes) |
read-only (null) |
Total size of cache memory of this
processor.
|
| TotalMemorySizeMiB (v1.11+) | integer (mebibytes) |
read-only (null) |
Total size of non-cache, volatile or
non-volatile memory attached to this processor. Examples include DRAMs
and NV-DIMMs that are not configured as block storage.
|
| } | |||
| Metrics (v1.4+) { | object | The link to the metrics associated with
this processor.
|
|
| @odata.id | string | read-only | Link to a ProcessorMetrics resource. See the Links section and the ProcessorMetrics schema for details. |
| } | |||
| MinSpeedMHz (v1.8+) | integer (MHz) |
read-only (null) |
The minimum clock speed of the processor
in MHz.
|
| Model | string | read-only (null) |
The product model number of this
device.
|
| OperatingConfigs (v1.9+) { | object | The link to the collection operating
configurations that can be applied to this processor.
|
|
| @odata.id | string | read-only | Link to Collection of OperatingConfig. See the OperatingConfig schema for details. |
| } | |||
| OperatingSpeedMHz (v1.8+) | integer (MHz) |
read-only (null) |
Operating speed of the processor in
MHz.
|
| OperatingSpeedRangeMHz (v1.13+) { | object (excerpt) |
Range of allowed operating speeds
(MHz).
|
|
| AllowableMax | number | read-only (null) |
The maximum possible setting for this
control.
|
| AllowableMin | number | read-only (null) |
The minimum possible setting for this
control.
|
| AllowableNumericValues [ ] | array (number, null) | read-only | The supported values for the set
point.
|
| ControlMode | string (enum) |
read-write (null) |
The current operating mode of the
control.
|
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this control.
|
| Reading | number | read-only (null) |
The reading of the sensor associated with
this control.
|
| ReadingUnits | string | read-only (null) |
The units of the sensor reading associated
with this control.
|
| SettingMax | number | read-write (null) |
The maximum set point in the allowed
range.
|
| SettingMin | number | read-write (null) |
The minimum set point in the allowed
range.
|
| } | |||
| PartNumber (v1.7+) | string | read-only (null) |
The part number of the
processor.
|
| Ports (v1.13+) { | object | The link to the collection of ports for
this processor.
|
|
| @odata.id | string | read-only | Link to Collection of Port. See the Port schema for details. |
| } | |||
| PowerState (v1.17+) | string (enum) |
read-only (null) |
The current power state of the
processor.
|
| ProcessorArchitecture | string (enum) |
read-only (null) |
The architecture of the
processor.
|
| ProcessorId { | object | The identification information for this
processor.
|
|
| EffectiveFamily | string | read-only (null) |
The effective family for this
processor.
|
| EffectiveModel | string | read-only (null) |
The effective model for this
processor.
|
| IdentificationRegisters | string | read-only (null) |
The raw manufacturer-provided processor
identification registers for this processor.
^0x[0-9A-Fa-f]+$ For more information about this
property, see Property details. |
| MicrocodeInfo | string | read-only (null) |
The microcode information for this
processor.
|
| ProtectedIdentificationNumber (v1.10+) | string | read-only (null) |
The Protected Processor Identification
Number (PPIN) for this processor.
|
| Step | string | read-only (null) |
The step value for this
processor.
|
| VendorId | string | read-only (null) |
The vendor identification for this
processor.
|
| } | |||
| ProcessorIndex (v1.16+) | integer | read-only (null) |
The logical index of this processor within
the system.
|
| ProcessorMemory (v1.4+) [ { | array | The memory directly attached or integrated
within this processor. Examples include internal cache, dedicated memory
for the processor, and system memory.
|
|
| CapacityMiB (v1.4+) | integer (mebibytes) |
read-only (null) |
The memory capacity in MiB.
|
| IntegratedMemory (v1.4+) | boolean | read-only (null) |
An indication of whether this memory is
integrated within the processor.
|
| MemoryType (v1.4+) | string (enum) |
read-only (null) |
The type of memory used by this
processor.
|
| SpeedMHz (v1.4+) | integer | read-only (null) |
The operating speed of the memory in
MHz.
|
| } ] | |||
| ProcessorType | string (enum) |
read-only (null) |
The type of processor.
|
| Replaceable (v1.16+) | boolean | read-only (null) |
An indication of whether this component
can be independently replaced as allowed by the vendor's replacement
policy.
|
| SerialNumber (v1.7+) | string | read-only (null) |
The serial number of the
processor.
|
| Socket | string | read-only (null) |
The socket or location of the
processor.
|
| SparePartNumber (v1.11+) | string | read-only (null) |
The spare part number of the
processor.
|
| SpeedLimitMHz (v1.10+) | integer (MHz) |
read-write (null) |
The clock limit of the processor in
MHz.
|
| SpeedLocked (v1.10+) | boolean | read-write (null) |
Indicates whether the clock speed of the
processor is fixed at the value specified in the SpeedLimitMHz
property.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| SubProcessors (v1.3+) { | object | The link to the collection of
sub-processors associated with this processor, such as cores or threads,
that are part of a processor.
|
|
| @odata.id | string | read-only | Link to Collection of Processor. See the Processor schema for details. |
| } | |||
| SystemInterface (v1.8+) { | object | The interface between the system and the
processor.
|
|
| Ethernet (v1.4+) { | object | The Ethernet-related information for this
interface.
|
|
| MaxLanes (v1.4+) | integer | read-only (null) |
The number of lanes supported by this
interface.
|
| MaxSpeedMbps (v1.4+) | integer (Mbit/s) |
read-only (null) |
The maximum speed supported by this
interface.
|
| Oem (v1.4+) {} | object | See the OEM object definition in the Using this guide clause. | |
| } | |||
| InterfaceType (v1.4+) | string (enum) |
read-only (null) |
The interface type.
|
| PCIe (v1.4+) { | object | The PCIe-related information for this
interface.
|
|
| LanesInUse (v1.3+) | integer | read-only (null) |
The number of PCIe lanes in use by this
device.
|
| MaxLanes (v1.3+) | integer | read-only (null) |
The number of PCIe lanes supported by this
device.
|
| MaxPCIeType (v1.3+) | string (enum) |
read-only (null) |
The highest version of the PCIe
specification supported by this device.
|
| Oem (v1.3+) {} | object | See the OEM object definition in the Using this guide clause. | |
| PCIeType (v1.3+) | string (enum) |
read-only (null) |
The version of the PCIe specification in
use by this device.
|
| } | |||
| } | |||
| TDPWatts (v1.4+) | integer (Watts) |
read-only (null) |
The nominal Thermal Design Power (TDP) in
watts.
|
| ThrottleCauses (v1.16+) [ ] | array (string (enum)) |
read-only (null) |
|
| Throttled (v1.16+) | boolean | read-only (null) |
An indication of whether the processor is
throttled.
|
| TotalCores | integer | read-only (null) |
The total number of cores that this
processor contains.
|
| TotalEnabledCores (v1.5+) | integer | read-only (null) |
The total number of enabled cores that
this processor contains.
|
| TotalThreads | integer | read-only (null) |
The total number of execution threads that
this processor supports.
|
| TurboState (v1.9+) | string (enum) |
read-only (null) |
The state of the turbo for this
processor.
|
| UUID (v1.4+) | string (uuid) |
read-only (null) |
The UUID for this processor.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ |
| Version (v1.7+) | string | read-only (null) |
The hardware version of the
processor.
|
6.106.4 Actions
6.106.4.1 Reset (v1.6+)
Description
This action resets the processor.
- This action shall reset the processor.
Action URI
{Base URI of target resource}/Actions/Processor.Reset
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| ResetType | string (enum) |
optional | The type of reset.
|
Request Example
{
"ResetType": "ForceRestart"
}6.106.4.2 ResetToDefaults (v1.15+)
Description
The action resets the values of writable properties to factory defaults.
- This action shall reset the values of writable properties in this resource to their default values as specified by the manufacturer.
Action URI
{Base URI of target resource}/Actions/Processor.ResetToDefaults
Action parameters
This action takes no parameters.
6.106.5 Property details
6.106.5.1 BaseSpeedPriorityState
The state of the base frequency settings of the operation configuration applied to this processor.
- This property shall contain the state of the base frequency settings of the operating configuration applied to this processor.
| string | Description |
|---|---|
| Disabled | Base speed priority is disabled. |
| Enabled | Base speed priority is enabled. |
6.106.5.2 ControlMode
The current operating mode of the control.
- This property shall contain the operating mode of the control.
| string | Description |
|---|---|
| Automatic | Automatically adjust control to meet the set point. |
| Disabled | The control has been disabled. |
| Manual | No automatic adjustments are made to the control. |
| Override | User override of the automatic set point value. |
6.106.5.3 EffectiveFamily
The effective family for this processor.
- This property shall contain the effective family information as provided by the manufacturer of this processor. If this property represents raw register data, as determined by the value of the ProcessorArchitecture property, the service shall encode the value as a hex-encoded string following the regular expression pattern '^0x[0-9A-Fa-f]+$' or a decimal-encoded string following the regular expression pattern '^\d+$'.
For resources with a ProcessorArchitecture value of
x86, this string is derived from the execution of the
processor's CPUID instruction using this algorithm:
(eax, ebx, ecx, edx) = cpuid(eax=0x1);
EffectiveFamily = ((eax & 0x00FF00000) >> 20) + ((eax & 0x0F00) >> 8);6.106.5.4 EffectiveModel
The effective model for this processor.
- This property shall contain the effective model information as provided by the manufacturer of this processor. If this property represents raw register data, as determined by the value of the ProcessorArchitecture property, the service shall encode the value as a hex-encoded string following the regular expression pattern '^0x[0-9A-Fa-f]+$' or a decimal-encoded string following the regular expression pattern '^\d+$'.
For resources with a ProcessorArchitecture value of
x86, this string is derived from register values resulting
from the execution of the processor's CPUID instruction using this
algorithm:
(eax, ebx, ecx, edx) = cpuid(eax=0x1);
EffectiveModel = ((eax & 0x000F0000) >> 12) + ((eax & 0x00F0) >> 4);6.106.5.5 FpgaType
The FPGA type.
- This property shall contain a type of the FPGA device.
| string | Description |
|---|---|
| Discrete | The discrete FPGA device. |
| Integrated | The FPGA device integrated with other processor in the single chip. |
6.106.5.6 IdentificationRegisters
The raw manufacturer-provided processor identification registers for this processor.
- This property shall contain the raw manufacturer-provided processor-specific identification registers of this processor's features.
^0x[0-9A-Fa-f]+$
For resources with a ProcessorArchitecture value of x86,
this string is derived from register values resulting from execution of
the processor's CPUID instruction using this algorithm:
(eax, ebx, ecx, edx) = cpuid(eax=0xD);
IdentificationRegisters = (edx << 32) + eax;6.106.5.7 InstructionSet
The instruction set of the processor.
- This property shall contain the string that identifies the instruction set of the processor contained in this socket.
| string | Description |
|---|---|
| ARM-A32 | ARM 32-bit. |
| ARM-A64 | ARM 64-bit. |
| IA-64 | Intel IA-64. |
| MIPS32 | MIPS 32-bit. |
| MIPS64 | MIPS 64-bit. |
| OEM | OEM-defined. |
| PowerISA (v1.4+) | PowerISA-64 or PowerISA-32. |
| x86 | x86 32-bit. |
| x86-64 | x86 64-bit. |
6.106.5.8 InterfaceType
The interface type.
- This property shall contain an enumerated value that describes the type of interface between the system, or external connection, and the processor.
| string | Description |
|---|---|
| AMBA (v1.8+) | The Arm Advanced Microcontroller Bus Architecture interface. |
| CCIX (v1.8+) | The Cache Coherent Interconnect for Accelerators interface. |
| CXL (v1.8+) | The Compute Express Link interface. |
| Ethernet | An Ethernet interface. |
| OEM | An OEM-defined interface. |
| PCIe | A PCI Express interface. |
| QPI | The Intel QuickPath Interconnect. |
| UPI | The Intel UltraPath Interconnect. |
6.106.5.9 MaxPCIeType
The highest version of the PCIe specification supported by this device.
- This property shall contain the maximum PCIe specification that this device supports.
| string | Description |
|---|---|
| Gen1 | A PCIe v1.0 slot. |
| Gen2 | A PCIe v2.0 slot. |
| Gen3 | A PCIe v3.0 slot. |
| Gen4 | A PCIe v4.0 slot. |
| Gen5 | A PCIe v5.0 slot. |
6.106.5.10 MemoryType
The type of memory used by this processor.
- This property shall contain a type of the processor memory type.
| string | Description |
|---|---|
| Cache (v1.17+) | Processor cache, but no level is determined. |
| DDR | Double data rate synchronous dynamic random-access memory. |
| DDR2 | Double data rate type two synchronous dynamic random-access memory. |
| DDR3 | Double data rate type three synchronous dynamic random-access memory. |
| DDR4 | Double data rate type four synchronous dynamic random-access memory. |
| DDR5 | Double data rate type five synchronous dynamic random-access memory. |
| Flash | Flash memory. |
| GDDR | Synchronous graphics random-access memory. |
| GDDR2 | Double data rate type two synchronous graphics random-access memory. |
| GDDR3 | Double data rate type three synchronous graphics random-access memory. |
| GDDR4 | Double data rate type four synchronous graphics random-access memory. |
| GDDR5 | Double data rate type five synchronous graphics random-access memory. |
| GDDR5X | Double data rate type five X synchronous graphics random-access memory. |
| GDDR6 | Double data rate type six synchronous graphics random-access memory. |
| HBM1 | High Bandwidth Memory. |
| HBM2 | The second generation of High Bandwidth Memory. |
| HBM2E (v1.17+) | An updated version of the second generation of High Bandwidth Memory. |
| HBM3 | The third generation of High Bandwidth Memory. |
| L1Cache | L1 cache. |
| L2Cache | L2 cache. |
| L3Cache | L3 cache. |
| L4Cache | L4 cache. |
| L5Cache | L5 cache. |
| L6Cache | L6 cache. |
| L7Cache | L7 cache. |
| OEM | OEM-defined. |
| SDRAM | Synchronous dynamic random-access memory. |
| SGRAM | Synchronous graphics RAM. |
| SRAM | Static random-access memory. |
6.106.5.11 MicrocodeInfo
The microcode information for this processor.
- This property shall contain the microcode information as provided by the manufacturer of this processor. If this property represents raw register data, as determined by the value of the ProcessorArchitecture property, the service shall encode the value as a hex-encoded string following the regular expression pattern '^0x[0-9A-Fa-f]+$' or a decimal-encoded string following the regular expression pattern '^\d+$'.
For resources with a ProcessorArchitecture value of
x86, this string shall contain a hex-encoded representation
of the 64-bit value derived from register values resulting from the
execution of the processor's RDMSR instruction using this algorithm:
(eax, edx) = rdmsr(ecx=0x8B);
MicrocodeInfo = (edx << 32) + eax;6.106.5.12 Model
The FPGA model.
- This property shall contain a model of the FPGA device.
For resources with a ProcessorArchitecture value of
x86, this string shall contain the 48-byte, little-endian,
ASCII string derived from register values resulting from the execution
of the processor's CPUID instruction using this algorithm:
// Let Model[48] be a 48-byte, little-endian character array
// Let reg, eax, ebx, ecx, edx be 32-bit unsigned integer registers
for (leaf = 0; leaf <= 2; leaf++)
{
(eax, ebx, ecx, edx) = cpuid(eax = 0x80000002 + leaf);
regidx = 0;
for regval in (eax, ebx, ecx, edx)
{
##NB: order must be eax, ebx, ecx, edx
for (byte = 0; byte <= 3; byte++)
{
Model[leaf*16 + regidx*4 + byte] = regval & 0xFF;
regval = regval >> 8;
}
regidx++;
}
}6.106.5.13 PCIeType
The version of the PCIe specification in use by this device.
- This property shall contain the negotiated PCIe interface version in use by this device.
| string | Description |
|---|---|
| Gen1 | A PCIe v1.0 slot. |
| Gen2 | A PCIe v2.0 slot. |
| Gen3 | A PCIe v3.0 slot. |
| Gen4 | A PCIe v4.0 slot. |
| Gen5 | A PCIe v5.0 slot. |
6.106.5.14 PowerState
The current power state of the processor.
- This property shall
contain the power state of the processor. If the PowerState property in
the associated Chassis resource contains the value
Off, this property shall containOff.
| string | Description |
|---|---|
| Off | The resource is powered off. The components within the resource might continue to have AUX power. |
| On | The resource is powered on. |
| Paused | The resource is paused. |
| PoweringOff | A temporary state between on and off. The components within the resource can take time to process the power off action. |
| PoweringOn | A temporary state between off and on. The components within the resource can take time to process the power on action. |
6.106.5.15 ProcessorArchitecture
The architecture of the processor.
- This property shall contain the string that identifies the architecture of the processor contained in this socket.
| string | Description |
|---|---|
| ARM | ARM. |
| IA-64 | Intel Itanium. |
| MIPS | MIPS. |
| OEM | OEM-defined. |
| Power (v1.4+) | Power. |
| x86 | x86 or x86-64. |
6.106.5.16 ProcessorId
The identification information for this processor.
- This object shall contain identification information for this processor.
This object's properties shall contain values that depend on the
ProcessorArchitecture property value. For resources with a
ProcessorArchitecture value of x86, some
property values are defined using register values resulting from the
execution of the CPUID or RDMSR instructions.
6.106.5.17 ProcessorType
The type of processor.
- This property shall contain the string that identifies the type of processor contained in this socket.
| string | Description |
|---|---|
| Accelerator | An accelerator. |
| Core (v1.3+) | A core in a processor. |
| CPU | A CPU. |
| DSP | A DSP. |
| FPGA | An FPGA. |
| GPU | A GPU. |
| OEM | An OEM-defined processing unit. |
| Thread (v1.3+) | A thread in a processor. |
6.106.5.18 ResetType
The type of reset.
- This parameter shall contain the type of reset. The service can accept a request without the parameter and perform an implementation specific default reset.
| string | Description |
|---|---|
| ForceOff | Turn off the unit immediately
(non-graceful shutdown).
|
| ForceOn | Turn on the unit immediately.
|
| ForceRestart | Shut down immediately and non-gracefully
and restart the system.
|
| GracefulRestart | Shut down gracefully and restart the
system.
|
| GracefulShutdown | Shut down gracefully and power
off.
|
| Nmi | Generate a diagnostic interrupt, which is
usually an NMI on x86 systems, to stop normal operations, complete
diagnostic actions, and, typically, halt the system.
|
| On | Turn on the unit.
|
| Pause | Pause execution on the unit but do not
remove power. This is typically a feature of virtual machine
hypervisors.
|
| PowerCycle | Power cycle the unit. Behaves like a full
power removal, followed by a power restore to the resource.
|
| PushPowerButton | Simulate the pressing of the physical
power button on this unit.
|
| Resume | Resume execution on the paused unit. This
is typically a feature of virtual machine hypervisors.
|
| Suspend | Write the state of the unit to disk before
powering off. This allows for the state to be restored when powered back
on.
|
6.106.5.19 Step
The step value for this processor.
- This property shall contain the step or revision information as provided by the manufacturer of this processor. If this property represents raw register data, as determined by the value of the ProcessorArchitecture property, the service shall encode the value as a hex-encoded string following the regular expression pattern '^0x[0-9A-Fa-f]+$' or a decimal-encoded string following the regular expression pattern '^\d+$'.
For resources with a ProcessorArchitecture value of
x86, this string is derived from register values resulting
from the execution of the processor's CPUID instruction using this
algorithm:
(eax, ebx, ecx, edx) = cpuid(eax=0x1);
Step = (eax & 0x000F);6.106.5.20 ThrottleCauses
- The causes of the processor being throttled.
- This property shall contain the causes of the processor being throttled. If Throttled contains `false`, this property shall contain an empty array.
| string | Description |
|---|---|
| ClockLimit | The cause of the processor being throttled is a clock limit. |
| ManagementDetectedFault | The cause of the processor being throttled is a fault detected by management hardware or firmware. |
| OEM | The cause of the processor being throttled is OEM-specific. |
| PowerLimit | The cause of the processor being throttled is a power limit. |
| ThermalLimit | The cause of the processor being throttled is a thermal limit. |
| Unknown | The cause of the processor being throttled is not known. |
6.106.5.21 TurboState
The state of the turbo for this processor.
- This property shall contain the state of turbo for this processor.
| string | Description |
|---|---|
| Disabled | Turbo is disabled. |
| Enabled | Turbo is enabled. |
6.106.5.22 VendorId
The vendor identification for this processor.
- This property shall contain the vendor identification information as provided by the manufacturer of this processor. If this property represents raw register data, as determined by the value of the ProcessorArchitecture property, the service shall encode the value as a hex-encoded string following the regular expression pattern '^0x[0-9A-Fa-f]+$' or a decimal-encoded string following the regular expression pattern '^\d+$'.
For resources with a ProcessorArchitecture value of
x86, this string shall contain the 12-byte, little-endian,
ASCII string that results from the execution of the processor's CPUID
instruction using this algorithm:
// Let VendorID[12] be a 12-byte, little-endian character array
// Let reg, eax, ebx, ecx, edx be 32-bit unsigned integer registers
regidx = 0;
(eax, ebx, ecx, edx) = cpuid(eax=0x0);
for regval in (ebx, edx, ecx)
{
##NB: order must be ebx, edx, ecx
for (byte = 0; byte <= 3; byte++)
{
VendorID[regidx*4 +
byte] = regval & 0xFF;
regval = regval >> 8;
}
regidx++;
}6.106.6 Example response
{
"@odata.type": "#Processor.v1_18_0.Processor",
"Name": "Processor",
"Id": "1",
"Socket": "CPU 1",
"ProcessorType": "CPU",
"ProcessorArchitecture": "x86",
"InstructionSet": "x86-64",
"Manufacturer": "Intel(R) Corporation",
"Model": "Multi-Core Intel(R) Xeon(R) processor 7xxx Series",
"ProcessorId": {
"VendorId": "GenuineIntel",
"IdentificationRegisters": "0x34AC34DC8901274A",
"EffectiveFamily": "0x42",
"EffectiveModel": "0x61",
"Step": "0x1",
"MicrocodeInfo": "0x429943"
},
"MaxSpeedMHz": 3700,
"TotalCores": 8,
"TotalThreads": 16,
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Location": {
"PartLocation": {
"ServiceLabel": "Processor 1",
"LocationType": "Socket",
"LocationOrdinalValue": 0
}
},
"@odata.id": "/redfish/v1/Systems/437XR1138R2/Processors/1"
}6.107 ProcessorMetrics 1.6.2
| Version | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2022.2 | 2022.1 | 2021.3 | 2021.2 | 2020.4 | 2020.1 | 2018.3 |
6.107.1 Description
The ProcessorMetrics schema contains usage and health statistics for a processor.
- This resource contains the processor metrics for a single processor in a Redfish implementation.
6.107.2 URIs
/redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/Processors/{ProcessorId}/ProcessorMetrics
/redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/ProcessorMetrics
/redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors/{ProcessorId3}/ProcessorMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/ProcessorMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/ProcessorMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors/{ProcessorId3}/ProcessorMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/ProcessorMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/ProcessorMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors/{ProcessorId3}/ProcessorMetrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/ProcessorSummary/ProcessorMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/ProcessorMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/ProcessorMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors/{ProcessorId3}/ProcessorMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/ProcessorMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/ProcessorMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors/{ProcessorId3}/ProcessorMetrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/ProcessorSummary/ProcessorMetrics
/redfish/v1/Systems/{ComputerSystemId}/Processors/{ProcessorId}/ProcessorMetrics
/redfish/v1/Systems/{ComputerSystemId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/ProcessorMetrics
/redfish/v1/Systems/{ComputerSystemId}/Processors/{ProcessorId}/SubProcessors/{ProcessorId2}/SubProcessors/{ProcessorId3}/ProcessorMetrics
/redfish/v1/Systems/{ComputerSystemId}/ProcessorSummary/ProcessorMetrics
6.107.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AverageFrequencyMHz (deprecated v1.1) | number (MHz) |
read-only (null) |
The average frequency of the
processor.
|
| BandwidthPercent | number (%) |
read-only (null) |
The bandwidth usage of this processor as a
percentage.
|
| Cache [ { | array | The processor cache metrics.
|
|
| CacheMiss | number | read-only (null) |
The number of cache line misses in
millions.
|
| CacheMissesPerInstruction | number | read-only (null) |
The number of cache misses per
instruction.
|
| HitRatio | number | read-only (null) |
The cache line hit ratio.
|
| Level | string | read-only (null) |
The cache level.
|
| OccupancyBytes | integer (bytes) |
read-only (null) |
The total cache level occupancy in
bytes.
|
| OccupancyPercent | number (%) |
read-only (null) |
The total cache occupancy
percentage.
|
| } ] | |||
| CacheMetricsTotal (v1.2+) { | object | The total cache metrics for this
processor.
|
|
| CurrentPeriod (v1.2+) { | object | The cache metrics since the last reset or
ClearCurrentPeriod action for this processor.
|
|
| CorrectableECCErrorCount (v1.2+) | integer | read-only (null) |
The number of the correctable errors of
cache memory since reset or ClearCurrentPeriod action for this
processor.
|
| UncorrectableECCErrorCount (v1.2+) | integer | read-only (null) |
The number of the uncorrectable errors of
cache memory since reset or ClearCurrentPeriod action for this
processor.
|
| } | |||
| LifeTime (v1.2+) { | object | The cache metrics for the lifetime of this
processor.
|
|
| CorrectableECCErrorCount (v1.2+) | integer | read-only (null) |
The number of the correctable errors for
the lifetime of the cache memory.
|
| UncorrectableECCErrorCount (v1.2+) | integer | read-only (null) |
The number of the uncorrectable errors for
the lifetime of the cache memory.
|
| } | |||
| } | |||
| ConsumedPowerWatt (deprecated v1.2) | number (Watts) |
read-only (null) |
The power, in watts, that the processor
has consumed.
|
| CoreMetrics [ { | array | The processor core metrics.
|
|
| CoreCache [ { | array | The cache metrics of this core in the
processor.
|
|
| CacheMiss | number | read-only (null) |
The number of cache line misses in
millions.
|
| CacheMissesPerInstruction | number | read-only (null) |
The number of cache misses per
instruction.
|
| HitRatio | number | read-only (null) |
The cache line hit ratio.
|
| Level | string | read-only (null) |
The cache level.
|
| OccupancyBytes | integer (bytes) |
read-only (null) |
The total cache level occupancy in
bytes.
|
| OccupancyPercent | number (%) |
read-only (null) |
The total cache occupancy
percentage.
|
| } ] | |||
| CoreId | string | read-only (null) |
The processor core identifier.
|
| CorrectableCoreErrorCount (v1.5+) | integer | read-only (null) |
The number of the correctable core
errors.
|
| CorrectableOtherErrorCount (v1.5+) | integer | read-only (null) |
The number of the correctable errors of
all other components.
|
| CStateResidency [ { | array | The C-state residency of this core in the
processor.
|
|
| Level | string | read-only (null) |
The C-state level, such as C0, C1, or
C2.
|
| ResidencyPercent | number (%) |
read-only (null) |
The percentage of time that the processor
or core has spent in this particular level of C-state.
|
| } ] | |||
| InstructionsPerCycle | number | read-only (null) |
The number of instructions per clock cycle
of this core.
|
| IOStallCount | number | read-only (null) |
The number of stalled cycles due to I/O
operations.
|
| MemoryStallCount | number | read-only (null) |
The number of stalled cycles due to memory
operations.
|
| UncorrectableCoreErrorCount (v1.5+) | integer | read-only (null) |
The number of the uncorrectable core
errors.
|
| UncorrectableOtherErrorCount (v1.5+) | integer | read-only (null) |
The number of the uncorrectable errors of
all other components.
|
| UnhaltedCycles | number | read-only (null) |
The unhalted cycles count of this
core.
|
| } ] | |||
| CoreVoltage (v1.3+) { | object (excerpt) |
The core voltage (V) of this
processor.
|
|
| 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 percent (%
THD).
|
| } | |||
| CorrectableCoreErrorCount (v1.5+) | integer | read-only (null) |
The number of the correctable core
errors.
|
| CorrectableOtherErrorCount (v1.5+) | integer | read-only (null) |
The number of the correctable errors of
all other components.
|
| FrequencyRatio | number | read-only (null) |
The frequency relative to the nominal
processor frequency ratio.
|
| KernelPercent | number (%) |
read-only (null) |
The percentage of time spent in kernel
mode.
|
| LocalMemoryBandwidthBytes | integer (bytes) |
read-only (null) |
The local memory bandwidth usage in
bytes.
|
| OperatingSpeedMHz (v1.1+) | integer (MHz) |
read-only (null) |
Operating speed of the processor in
MHz.
|
| PCIeErrors (v1.4+) { | object | The PCIe errors associated with this
processor.
|
|
| CorrectableErrorCount (v1.8+) | integer | read-only (null) |
The total number of the PCIe correctable
errors for this device.
|
| FatalErrorCount (v1.8+) | integer | read-only (null) |
The total number of the PCIe fatal errors
for this device.
|
| L0ToRecoveryCount (v1.8+) | integer | read-only (null) |
The total number of times the PCIe link
states transitioned from L0 to the recovery state for this
device.
|
| NAKReceivedCount (v1.8+) | integer | read-only (null) |
The total number of NAKs issued on the
PCIe link by the receiver.
|
| NAKSentCount (v1.8+) | integer | read-only (null) |
The total number of NAKs issued on the
PCIe link by this device.
|
| NonFatalErrorCount (v1.8+) | integer | read-only (null) |
The total number of the PCIe non-fatal
errors for this device.
|
| ReplayCount (v1.8+) | integer | read-only (null) |
The total number of the PCIe replays
issued by this device.
|
| ReplayRolloverCount (v1.8+) | integer | read-only (null) |
The total number of the PCIe replay
rollovers issued by this device.
|
| } | |||
| PowerLimitThrottleDuration (v1.6+) | string (duration) |
read-only (null) |
The total duration of throttling caused by
a power limit of the processor since reset.
^P(\d+D)?(T(\d+H)?(\d+M)?(\d+(.\d+)?S)?)?$ |
| RemoteMemoryBandwidthBytes | integer (bytes) |
read-only (null) |
The remote memory bandwidth usage in
bytes.
|
| TemperatureCelsius (deprecated v1.2) | number (Celsius) |
read-only (null) |
The temperature of the
processor.
|
| ThermalLimitThrottleDuration (v1.6+) | string (duration) |
read-only (null) |
The total duration of throttling caused by
a thermal limit of the processor since reset.
^P(\d+D)?(T(\d+H)?(\d+M)?(\d+(.\d+)?S)?)?$ |
| ThrottlingCelsius | number (Celsius) |
read-only (null) |
The CPU margin to throttle (temperature
offset in degree Celsius).
|
| UncorrectableCoreErrorCount (v1.5+) | integer | read-only (null) |
The number of the uncorrectable core
errors.
|
| UncorrectableOtherErrorCount (v1.5+) | integer | read-only (null) |
The number of the uncorrectable errors of
all other components.
|
| UserPercent | number (%) |
read-only (null) |
The percentage of time spent in user
mode.
|
6.107.4 Actions
6.107.4.1 ClearCurrentPeriod (v1.2+)
Description
This action sets the CurrentPeriod property's values to 0.
- This action shall set the CurrentPeriod property's values to 0.
Action URI
{Base URI of target resource}/Actions/ProcessorMetrics.ClearCurrentPeriod
Action parameters
This action takes no parameters.
6.107.5 Example response
{
"@odata.type": "#ProcessorMetrics.v1_6_2.ProcessorMetrics",
"Id": "Metrics",
"Name": "Processor Metrics",
"BandwidthPercent": 62,
"OperatingSpeedMHz": 2400,
"ThrottlingCelsius": 65,
"FrequencyRatio": 0.00432,
"Cache": [
{
"Level": "3",
"CacheMiss": 0.12,
"HitRatio": 0.719,
"CacheMissesPerInstruction": 0.00088,
"OccupancyBytes": 3030144,
"OccupancyPercent": 90.1
}
],
"LocalMemoryBandwidthBytes": 18253611008,
"RemoteMemoryBandwidthBytes": 81788928,
"KernelPercent": 2.3,
"UserPercent": 34.7,
"CoreMetrics": [
{
"CoreId": "core0",
"InstructionsPerCycle": 1.16,
"UnhaltedCycles": 6254383746,
"MemoryStallCount": 58372,
"IOStallCount": 2634872,
"CoreCache": [
{
"Level": "2",
"CacheMiss": 0.472,
"HitRatio": 0.57,
"CacheMissesPerInstruction": 0.00346,
"OccupancyBytes": 198231,
"OccupancyPercent": 77.4
}
],
"CStateResidency": [
{
"Level": "C0",
"Residency": 1.13
},
{
"Level": "C1",
"Residency": 26
},
{
"Level": "C3",
"Residency": 0.00878
},
{
"Level": "C6",
"Residency": 0.361
},
{
"Level": "C7",
"Residency": 72.5
}
]
}
],
"@odata.id": "/redfish/v1/Systems/1/Processors/FPGA1/ProcessorMetrics"
}6.108 Pump 1.0.0
| Version | v1.0 |
| Release | 2023.1 |
6.108.1 Description
The Pump schema describes a pump unit for a cooling system or similar device.
- This resource shall represent the management properties for monitoring and management of pumps for a Redfish implementation.
6.108.2 URIs
/redfish/v1/Chassis/{ChassisId}/ThermalSubsystem/Pumps/{PumpId}
/redfish/v1/ThermalEquipment/CDUs/{CoolingUnitId}/Pumps/{PumpId}
/redfish/v1/ThermalEquipment/HeatExchangers/{CoolingUnitId}/Pumps/{PumpId}
/redfish/v1/ThermalEquipment/ImmersionUnits/{CoolingUnitId}/Pumps/{PumpId}
6.108.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Assembly { | object | The link to the assembly associated with
this pump.
|
|
| @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
equipment.
|
| Filters { | object | A link to a collection of
filters.
|
|
| @odata.id | string | read-only | Link to Collection of Filter. See the Filter schema for details. |
| } | |||
| FirmwareVersion | string | read-only | The firmware version of this
equipment.
|
| Location {} | object | The location of the pump.
|
|
| LocationIndicatorActive | boolean | read-write (null) |
An indicator allowing an operator to
physically locate this resource.
|
| Manufacturer | string | read-only (null) |
The manufacturer of this pump.
|
| Model | string | read-only (null) |
The model number for this
pump.
|
| PartNumber | string | read-only (null) |
The part number for this pump.
|
| PhysicalContext | string (enum) |
read-only | The area or device associated with this
pump.
|
| ProductionDate | string (date-time) |
read-only (null) |
The production or manufacturing date of
this equipment.
|
| PumpSpeedPercent { | object (excerpt) |
The pump speed (%).
|
|
| 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.
|
| SpeedRPM (v1.2+) | number ({rev}/min) |
read-only (null) |
The rotational speed.
|
| } | |||
| PumpType | string (enum) |
read-only (null) |
The type of pump.
|
| SerialNumber | string | read-only (null) |
The serial number for this
pump.
|
| ServiceHours | number | read-write (null) |
The hours of service this pump has
provided.
|
| SparePartNumber | string | read-only (null) |
The spare part number for this
pump.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| UserLabel | string | read-write | A user-assigned label.
|
| Version | string | read-only (null) |
The hardware version of this
equipment.
|
6.108.4 Property details
6.108.4.1 PhysicalContext
The area or device associated with this pump.
- This property shall contain a description of the affected device or region within the chassis with which this pump is associated.
| string | Description |
|---|---|
| Accelerator | An accelerator. |
| ACInput | An AC input. |
| ACMaintenanceBypassInput | An AC maintenance bypass input. |
| ACOutput | An AC output. |
| ACStaticBypassInput | An AC static bypass input. |
| ACUtilityInput | An AC utility input. |
| ASIC | An ASIC device, such as a networking chip or chipset component. |
| Back | The back of the chassis. |
| Backplane | A backplane within the chassis. |
| Battery | A battery. |
| Board | A circuit board.
|
| Chassis | The entire chassis. |
| ComputeBay | Within a compute bay. |
| CoolingSubsystem | The entire cooling, or air and liquid, subsystem. |
| CPU | A processor (CPU). |
| CPUSubsystem | The entire processor (CPU) subsystem. |
| DCBus | A DC bus. |
| Exhaust | The air exhaust point or points or region of the chassis. |
| ExpansionBay | Within an expansion bay. |
| Fan | A fan. |
| FPGA | An FPGA. |
| Front | The front of the chassis. |
| GPU | A graphics processor (GPU). |
| GPUSubsystem | The entire graphics processor (GPU) subsystem. |
| Intake | The air intake point or points or region of the chassis. |
| LiquidInlet | The liquid inlet point of the chassis. |
| LiquidOutlet | The liquid outlet point of the chassis. |
| Lower | The lower portion of the chassis. |
| Memory | A memory device. |
| MemorySubsystem | The entire memory subsystem. |
| Motor | A motor. |
| NetworkBay | Within a networking bay. |
| NetworkingDevice | A networking device. |
| PowerSubsystem | The entire power subsystem. |
| PowerSupply | A power supply. |
| PowerSupplyBay | Within a power supply bay. |
| Pump | A pump. |
| Rectifier | A rectifier device. |
| Room | The room. |
| StorageBay | Within a storage bay. |
| StorageDevice | A storage device. |
| SystemBoard | The system board (PCB). |
| Transceiver | A transceiver.
|
| Transformer | A transformer. |
| TrustedModule | A trusted module. |
| Upper | The upper portion of the chassis. |
| VoltageRegulator | A voltage regulator device. |
6.108.4.2 PumpType
The type of pump.
- This property shall contain the type of pump represented by this resource.
| string | Description |
|---|---|
| Compressor | A compressor. |
| Liquid | A water or liquid pump. |
6.108.5 Example response
{
"@odata.type": "#Pump.v1_0_0.Pump",
"Id": "1",
"PumpType": "Liquid",
"Name": "Immersion Unit Pump",
"Version": "1.03b",
"ProductionDate": "2021-06-24T08:00:00Z",
"Manufacturer": "Contoso",
"Model": "UP-JAM",
"SerialNumber": "29347ZT599",
"PartNumber": "MAARS",
"AssetTag": "PDX5-92399",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"PumpSpeedPercent": {
"Reading": 62,
"SpeedRPM": 1800
},
"@odata.id": "/redfish/v1/ThermalEquipment/ImmersionUnits/1/Pumps/1"
}6.109 RegisteredClient 1.1.0
| Version | v1.1 | v1.0 |
| Release | 2023.1 | 2021.4 |
6.109.1 Description
The RegisteredClient schema defines the record format for a registered client. It is designed to allow well behaved clients to register with a Redfish service such that other clients are aware the service might be configured or monitored by the client.
- This resource shall represent a registered client for a Redfish implementation. It is not expected that transient tools, such as a short lived CLI tool, register. Clients and management tools that live for long periods of time can create RegisteredClient resources so that other clients are aware the service might be configured or monitored by the client.
6.109.2 URIs
/redfish/v1/RegisteredClients/{RegisteredClientId}
6.109.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| ClientType | string (enum) |
read-write required | The type of registered client.
|
| ClientURI | string | read-write | The URI of the registered
client.
|
| Context (v1.1+) | string | read-write | A client-supplied data for providing
context for its own use.
|
| CreatedDate | string (date-time) |
read-only | The date and time when the client entry
was created.
|
| ExpirationDate | string (date-time) |
read-write | The date and time when the client entry
will expire.
|
| ManagedResources [ { | array | An array of resources that the registered
client monitors or configures.
|
|
| IncludesSubordinates | boolean | read-write (null) |
Indicates whether the subordinate
resources of the managed resource are also managed by the registered
client.
|
| ManagedResourceURI | string (URI) |
read-write (null) |
The URI of the resource or resource
collection managed by the registered client.
|
| PreferExclusive | boolean | read-write (null) |
Indicates whether the registered client
expects to have exclusive access to the managed resource.
|
| } ] | |||
| SubContext (v1.1+) | string | read-write | Additional client-supplied data for
providing contextual information for its own use.
|
6.109.4 Property details
6.109.4.1 ClientType
The type of registered client.
- This property shall contain the type of registered client.
| string | Description |
|---|---|
| Configure | The registered client performs update, create, and delete operations on the resources listed in the ManagedResources property as well as read operations on the service. |
| Monitor | The registered client only performs read operations on this service. |
6.109.5 Example response
{
"@odata.type": "#RegisteredClient.v1_1_0.RegisteredClient",
"Id": "2",
"Name": "ContosoConfigure",
"ClientType": "Configure",
"CreatedDate": "2021-09-25T20:12:24Z",
"Description": "Contoso manager access",
"ExpirationDate": "2022-10-03T20:00:00Z",
"ManagedResources": [
{
"ManagedResourceURI": "/redfish/v1/Systems",
"PreferExclusive": true,
"IncludesSubordinates": true
},
{
"ManagedResourceURI": "/redfish/v1/Chassis",
"PreferExclusive": true,
"IncludesSubordinates": true
}
],
"ClientURI": "https://4.5.6.2/ContosoManager",
"@odata.id": "/redfish/v1/RegisteredClients/2"
}6.110 Reservoir 1.0.0
| Version | v1.0 |
| Release | 2023.1 |
6.110.1 Description
The Reservoir schema describes a reservoir unit for a cooling system or similar device.
- This resource shall represent the management properties for monitoring and management of reservoirs for a Redfish implementation.
6.110.2 URIs
/redfish/v1/ThermalEquipment/CDUs/{CoolingUnitId}/Reservoirs/{ReservoirId}
/redfish/v1/ThermalEquipment/HeatExchangers/{CoolingUnitId}/Reservoirs/{ReservoirId}
/redfish/v1/ThermalEquipment/ImmersionUnits/{CoolingUnitId}/Reservoirs/{ReservoirId}
6.110.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Assembly { | object | The link to the assembly associated with
this reservoir.
|
|
| @odata.id | string | read-only | Link to a Assembly resource. See the Links section and the Assembly schema for details. |
| } | |||
| CapacityLiters | number | read-only (null) |
The capacity of the reservoir
(l).
|
| Coolant { | object | Details about the coolant used in this
unit.
|
|
| @odata.id | string | read-only | Link to a Coolant resource. See the Links section and the CoolingLoop schema for details. |
| } | |||
| Filters { | object | A link to a collection of
filters.
|
|
| @odata.id | string | read-only | Link to Collection of Filter. See the Filter schema for details. |
| } | |||
| FluidLevelPercent { | object (excerpt) |
The fluid capacity filled
(percent).
|
|
| 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.
|
| } | |||
| FluidLevelStatus | string (enum) |
read-only (null) |
The status of the fluid level in this
reservoir.
|
| InternalPressurekPa { | object (excerpt) |
The internal pressure (kPa)
reading.
|
|
| 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.
|
| } | |||
| Location {} | object | The location of the reservoir.
|
|
| LocationIndicatorActive | boolean | read-write (null) |
An indicator allowing an operator to
physically locate this resource.
|
| Manufacturer | string | read-only (null) |
The manufacturer of this
reservoir.
|
| Model | string | read-only (null) |
The model number for this
reservoir.
|
| PartNumber | string | read-only (null) |
The part number for this
reservoir.
|
| PhysicalContext | string (enum) |
read-only | The area or device associated with this
reservoir.
|
| ReservoirType | string (enum) |
read-only (null) |
The type of reservoir.
|
| SerialNumber | string | read-only (null) |
The serial number for this
reservoir.
|
| SparePartNumber | string | read-only (null) |
The spare part number for this
reservoir.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| UserLabel | string | read-write | A user-assigned label.
|
6.110.4 Property details
6.110.4.1 FluidLevelStatus
The status of the fluid level in this reservoir.
- This property shall indicate the status of the fluid level in this reservoir.
| string | Description |
|---|---|
| Critical | A critical condition requires immediate attention. |
| OK | Normal. |
| Warning | A condition requires attention. |
6.110.4.2 PhysicalContext
The area or device associated with this reservoir.
- This property shall contain a description of the affected device or region within the chassis with which this reservoir is associated.
| string | Description |
|---|---|
| Accelerator | An accelerator. |
| ACInput | An AC input. |
| ACMaintenanceBypassInput | An AC maintenance bypass input. |
| ACOutput | An AC output. |
| ACStaticBypassInput | An AC static bypass input. |
| ACUtilityInput | An AC utility input. |
| ASIC | An ASIC device, such as a networking chip or chipset component. |
| Back | The back of the chassis. |
| Backplane | A backplane within the chassis. |
| Battery | A battery. |
| Board | A circuit board.
|
| Chassis | The entire chassis. |
| ComputeBay | Within a compute bay. |
| CoolingSubsystem | The entire cooling, or air and liquid, subsystem. |
| CPU | A processor (CPU). |
| CPUSubsystem | The entire processor (CPU) subsystem. |
| DCBus | A DC bus. |
| Exhaust | The air exhaust point or points or region of the chassis. |
| ExpansionBay | Within an expansion bay. |
| Fan | A fan. |
| FPGA | An FPGA. |
| Front | The front of the chassis. |
| GPU | A graphics processor (GPU). |
| GPUSubsystem | The entire graphics processor (GPU) subsystem. |
| Intake | The air intake point or points or region of the chassis. |
| LiquidInlet | The liquid inlet point of the chassis. |
| LiquidOutlet | The liquid outlet point of the chassis. |
| Lower | The lower portion of the chassis. |
| Memory | A memory device. |
| MemorySubsystem | The entire memory subsystem. |
| Motor | A motor. |
| NetworkBay | Within a networking bay. |
| NetworkingDevice | A networking device. |
| PowerSubsystem | The entire power subsystem. |
| PowerSupply | A power supply. |
| PowerSupplyBay | Within a power supply bay. |
| Pump | A pump. |
| Rectifier | A rectifier device. |
| Room | The room. |
| StorageBay | Within a storage bay. |
| StorageDevice | A storage device. |
| SystemBoard | The system board (PCB). |
| Transceiver | A transceiver.
|
| Transformer | A transformer. |
| TrustedModule | A trusted module. |
| Upper | The upper portion of the chassis. |
| VoltageRegulator | A voltage regulator device. |
6.110.4.3 ReservoirType
The type of reservoir.
- This property shall contain the type of reservoir represented by this resource.
| string | Description |
|---|---|
| Immersion | An immersion cooling tank. |
| Inline | An inline or integrated reservoir. |
| Overflow | An overflow reservoir for excess fluid. |
| Reserve | A reservoir providing reserve fluid capacity. |
6.110.5 Example response
{
"@odata.type": "#Reservoir.v1_0_0.Reservoir",
"Id": "1",
"ReservoirType": "Reserve",
"Name": "Cooling Loop Reservoir",
"Manufacturer": "Contoso",
"Model": "Tarantino",
"CapacityLiters": 10,
"PartNumber": "Pink",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Location": {
"Placement": {
"Row": "North 1"
}
},
"FluidLevelPercent": {
"Reading": 64.8
},
"InternalPressurekPa": {
"Reading": 138.7
},
"@odata.id": "/redfish/v1/ThermalEquipment/CDUs/1/Reservoirs/1"
}6.111 ResourceBlock 1.4.1
| Version | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2020.4 | 2018.3 | 2018.2 | 2018.1 | 2017.1 |
6.111.1 Description
The ResourceBlock schema contains definitions resource blocks, its components, and affinity to composed devices.
- This resource shall represent a resource block for a Redfish implementation.
6.111.2 URIs
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}
6.111.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Client (v1.4+) | string | read-write (null) |
The client to which this resource block is
assigned.
|
| CompositionStatus { | object | required | The composition status details for this
resource block.
|
| CompositionState | string (enum) |
read-only required (null) |
The current state of the resource block
from a composition perspective.
|
| MaxCompositions (v1.1+) | integer | read-only (null) |
The maximum number of compositions in
which this resource block can participate simultaneously.
|
| NumberOfCompositions (v1.1+) | integer | read-only (null) |
The number of compositions in which this
resource block is currently participating.
|
| Reserved | boolean | read-write (null) |
An indication of whether any client has
reserved the resource block.
|
| SharingCapable (v1.1+) | boolean | read-only (null) |
An indication of whether this resource
block can participate in multiple compositions
simultaneously.
|
| SharingEnabled (v1.1+) | boolean | read-write (null) |
An indication of whether this resource
block is allowed to participate in multiple compositions
simultaneously.
|
| } | |||
| ComputerSystems [ { | array | An array of links to the computer systems
available in this resource block.
|
|
| @odata.id | string | read-only | Link to a ComputerSystem resource. See the Links section and the ComputerSystem schema for details. |
| } ] | |||
| Drives (v1.3+) [ { | array | An array of links to the drives available
in this resource block.
|
|
| @odata.id | string | read-only | Link to a Drive resource. See the Links section and the Drive schema for details. |
| } ] | |||
| EthernetInterfaces [ { | array | An array of links to the Ethernet
interfaces available in this resource block.
|
|
| @odata.id | string | read-only | Link to a EthernetInterface resource. See the Links section and the EthernetInterface schema for details. |
| } ] | |||
| Links { | object | The links to other resources that are
related to this resource.
|
|
| Chassis [ { | array | An array of links to the chassis in which
this resource block is contained.
|
|
| @odata.id | string | read-only | Link to a Chassis resource. See the Links section and the Chassis schema for details. |
| } ] | |||
| ComputerSystems [ { | array | An array of links to the computer systems
that are composed from this resource block.
|
|
| @odata.id | string | read-only | Link to a ComputerSystem resource. See the Links section and the ComputerSystem schema for details. |
| } ] | |||
| ConsumingResourceBlocks (v1.4+) [ { | array | An array of links to resource blocks that
depend on this resource block.
|
|
| @odata.id | string | read-only | Link to another ResourceBlock resource. |
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| SupplyingResourceBlocks (v1.4+) [ { | array | An array of links to resource blocks that
this resource block depends on.
|
|
| @odata.id | string | read-only | Link to another ResourceBlock resource. |
| } ] | |||
| Zones [ { | array | An array of links to the zones in which
this resource block is bound.
|
|
| @odata.id | string | read-only | Link to a Zone resource. See the Links section and the Zone schema for details. |
| } ] | |||
| } | |||
| Memory [ { | array | An array of links to the memory available
in this resource block.
|
|
| @odata.id | string | read-only | Link to a Memory resource. See the Links section and the Memory schema for details. |
| } ] | |||
| NetworkInterfaces [ { | array | An array of links to the Network
Interfaces available in this resource block.
|
|
| @odata.id | string | read-only | Link to a NetworkInterface resource. See the Links section and the NetworkInterface schema for details. |
| } ] | |||
| Pool (v1.4+) | string (enum) |
read-write (null) |
The pool to which this resource block
belongs.
|
| Processors [ { | array | An array of links to the processors
available in this resource block.
|
|
| @odata.id | string | read-only | Link to a Processor resource. See the Links section and the Processor schema for details. |
| } ] | |||
| ResourceBlockType [ ] | array (string (enum)) |
read-only required |
|
| SimpleStorage [ { | array | An array of links to the simple storage
available in this resource block.
|
|
| @odata.id | string | read-only | Link to a SimpleStorage resource. See the Links section and the SimpleStorage schema for details. |
| } ] | |||
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| Storage [ { | array | An array of links to the storage available
in this resource block.
|
|
| @odata.id | string | read-only | Link to a Storage resource. See the Links section and the Storage schema for details. |
| } ] |
6.111.4 Property details
6.111.4.1 CompositionState
The current state of the resource block from a composition perspective.
- This property shall contain an enumerated value that describes the composition state of the resource block.
| string | Description |
|---|---|
| Composed | Final successful state of a resource block that has participated in composition. |
| ComposedAndAvailable (v1.1+) | The resource block is currently participating in one or more compositions, and is available to use in more compositions. |
| Composing | Intermediate state indicating composition is in progress. |
| Failed | The final composition resulted in failure and manual intervention might be required to fix it. |
| Unavailable (v1.2+) | The resource block has been made unavailable by the service, such as due to maintenance being performed on the resource block. |
| Unused | The resource block is free and can participate in composition. |
6.111.4.2 Pool
The pool to which this resource block belongs.
- This property
shall contain the pool to which this resource block belongs. If this
resource block is not assigned to a client, this property shall contain
the value
Unassigned. If this resource block is assigned to a client, this property shall not contain the valueUnassigned.
| string | Description |
|---|---|
| Active | This resource block is in the active pool and is contributing to at least one composed resource as a result of a composition request. |
| Free | This resource block is in the free pool and is not contributing to any composed resources. |
| Unassigned | This resource block is not assigned to any pools. |
6.111.4.3 ResourceBlockType
- The types of resources available on this resource block.
- This property shall contain an array of enumerated values that describe the type of resources available.
| string | Description |
|---|---|
| Compute | This resource block contains resources of
type Processor and Memory in a manner that
creates a compute complex. |
| ComputerSystem | This resource block contains resources of
type ComputerSystem. |
| Expansion | This resource block is capable of changing over time based on its configuration. Different types of devices within this resource block can be added and removed over time. |
| IndependentResource | This resource block is capable of being consumed as a standalone component. This resource block can represent things such as a software platform on one or more computer systems or an appliance that provides composable resources and other services, and can be managed independently of the Redfish service. |
| Memory | This resource block contains resources of
type Memory. |
| Network | This resource block contains network
resources, such as resource of type EthernetInterface and
NetworkInterface. |
| Processor | This resource block contains resources of
type Processor. |
| Storage | This resource block contains storage
resources, such as resources of type Storage and
SimpleStorage. |
6.111.5 Example response
{
"@odata.type": "#ResourceBlock.v1_4_1.ResourceBlock",
"Id": "ComputeBlock1",
"Name": "Compute Block 1",
"ResourceBlockType": [
"Compute",
"Network"
],
"Status": {
"State": "Enabled",
"Health": "OK"
},
"CompositionStatus": {
"Reserved": false,
"CompositionState": "Composed",
"SharingCapable": false,
"MaxCompositions": 1,
"NumberOfCompositions": 1
},
"Processors": [
{
"@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/ComputeBlock1/Processors/Block1CPU0"
},
{
"@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/ComputeBlock1/Processors/Block1CPU1"
}
],
"Memory": [
{
"@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/ComputeBlock1/Memory/Block1DIMM0"
},
{
"@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/ComputeBlock1/Memory/Block1DIMM1"
},
{
"@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/ComputeBlock1/Memory/Block1DIMM2"
},
{
"@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/ComputeBlock1/Memory/Block1DIMM3"
}
],
"EthernetInterfaces": [
{
"@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/ComputeBlock1/EthernetInterfaces/Block1OnboardNIC"
}
],
"ComputerSystems": [],
"Links": {
"ComputerSystems": [
{
"@odata.id": "/redfish/v1/Systems/ComposedSystem"
}
],
"Chassis": [
{
"@odata.id": "/redfish/v1/Chassis/ComposableModule1"
}
],
"Zones": [
{
"@odata.id": "/redfish/v1/CompositionService/ResourceZones/1"
}
]
},
"@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/ComputeBlock1"
}6.112 Role 1.3.1
| Version | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2020.4 | 2017.2 | 2017.1 | 1.0 |
6.112.1 Description
The Role schema contains a Redfish role to use in conjunction with a manager account.
- This resource represents the Redfish role for the user account.
6.112.2 URIs
/redfish/v1/AccountService/Roles/{RoleId}
/redfish/v1/Managers/{ManagerId}/RemoteAccountService/Roles/{RoleId}
6.112.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AlternateRoleId (v1.3+) | string | read-only | An equivalent role to use when this role
is restricted.
|
| AssignedPrivileges [ ] | array (string (enum)) |
read-write |
|
| IsPredefined | boolean | read-only | An indication of whether the role is
predefined by Redfish or an OEM rather than a client-defined
role.
|
| OemPrivileges [ ] | array (string) | read-write | The OEM privileges for this
role.
|
| Restricted (v1.3+) | boolean | read-only | An indication of whether use of the role
is restricted.
|
| RoleId (v1.2+) | string | read-only required on create | The name of the role.
|
6.112.4 Property details
6.112.4.1 AssignedPrivileges
- The Redfish privileges for this role.
- This property shall contain the Redfish privileges for this role. For predefined roles, this property shall be read-only. For custom roles, some implementations may prevent writing to this property.
| string | Description |
|---|---|
| AdministrateStorage | Administrator for storage subsystems and storage systems found in the storage collection and storage system collection respectively. |
| AdministrateSystems | Administrator for systems found in the systems collection. Able to manage boot configuration, keys, and certificates for systems. |
| 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, log out of their own sessions, and perform operations on resources they created. Services will need to be aware of resource ownership to map this privilege to an operation from a particular user. |
| ConfigureUsers | Can configure users and their accounts. |
| Login | Can log in to the service and read resources. |
| NoAuth | Authentication is not
required.
|
| OperateStorageBackup | Operator for storage backup functionality for storage subsystems and storage systems found in the storage collection and storage system collection respectively. |
| OperateSystems | Operator for systems found in the systems collection. Able to perform resets and configure interfaces. |
6.112.5 Example response
{
"@odata.type": "#Role.v1_3_1.Role",
"Id": "Administrator",
"Name": "User Role",
"Description": "Admin User Role",
"IsPredefined": true,
"AssignedPrivileges": [
"Login",
"ConfigureManager",
"ConfigureUsers",
"ConfigureSelf",
"ConfigureComponents"
],
"OemPrivileges": [
"OemClearLog",
"OemPowerControl"
],
"@odata.id": "/redfish/v1/AccountService/Roles/Administrator"
}6.113 RouteEntry 1.0.1
| Version | v1.0 |
| Release | 2019.4 |
6.113.1 Description
The RouteEntry schema describes the content of route entry rows. Each route entry contains route sets that list the possible routes for the route entry.
- This Resource shall represent the content of route entry rows in the Redfish Specification.
6.113.2 URIs
/redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/GenZ/MSDT/{MSDTId}
/redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/GenZ/SSDT/{SSDTId}
/redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/MSDT/{MSDTId}
(deprecated)
/redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/GenZ/LPRT/{LPRTId}
/redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/GenZ/MPRT/{MPRTId}
/redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/LPRT/{LPRTId}
(deprecated)
/redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/MPRT/{MPRTId}
(deprecated)
/redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/SSDT/{SSDTId}
(deprecated)
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/GenZ/MSDT/{MSDTId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/GenZ/SSDT/{SSDTId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/MSDT/{MSDTId}
(deprecated)
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/GenZ/LPRT/{LPRTId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/GenZ/MPRT/{MPRTId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/LPRT/{LPRTId}
(deprecated)
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/MPRT/{MPRTId}
(deprecated)
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/SSDT/{SSDTId}
(deprecated)
/redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortId}/GenZ/LPRT/{LPRTId}
/redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortId}/GenZ/MPRT/{MPRTId}
/redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortId}/LPRT/{LPRTId}
(deprecated)
/redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortId}/MPRT/{MPRTId}
(deprecated)
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/GenZ/MSDT/{MSDTId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/GenZ/SSDT/{SSDTId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/MSDT/{MSDTId}
(deprecated)
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/GenZ/LPRT/{LPRTId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/GenZ/MPRT/{MPRTId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/LPRT/{LPRTId}
(deprecated)
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/MPRT/{MPRTId}
(deprecated)
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/SSDT/{SSDTId}
(deprecated)
/redfish/v1/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/GenZ/MSDT/{MSDTId}
/redfish/v1/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/GenZ/SSDT/{SSDTId}
/redfish/v1/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/MSDT/{MSDTId}
(deprecated)
/redfish/v1/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/GenZ/LPRT/{LPRTId}
/redfish/v1/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/GenZ/MPRT/{MPRTId}
/redfish/v1/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/LPRT/{LPRTId}
(deprecated)
/redfish/v1/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/MPRT/{MPRTId}
(deprecated)
/redfish/v1/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/SSDT/{SSDTId}
(deprecated)
6.113.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| MinimumHopCount | integer | read-write | The minimum number of hops.
|
| RawEntryHex | string | read-write | The raw data of route entry
rows.
^0[xX](([a-fA-F]|[0-9]){2}){8}$ |
| RouteSet { | object | The link to the collection of route set
entries associated with this route.
|
|
| @odata.id | string | read-only | Link to Collection of RouteSetEntry. See the RouteSetEntry schema for details. |
| } |
6.113.4 Example response
{
"@odata.type": "#RouteEntry.v1_0_1.RouteEntry",
"Id": "0",
"Name": "LPRT0",
"Description": "Gen-Z Port 1 LPRT Entry 0",
"RawEntryHex": "0x34EF124500000000",
"RouteSet": {
"@odata.id": "/redfish/v1/Fabrics/GenZ/Switches/Switch1/Ports/1/LPRT/0/RouteSet"
},
"MinimumHopCount": 1,
"@odata.id": "/redfish/v1/Fabrics/GenZ/Switches/Switch1/Ports/1/LPRT/0"
}6.114 RouteSetEntry 1.0.1
| Version | v1.0 |
| Release | 2019.4 |
6.114.1 Description
The RouteSetEntry schema contains the information about a route. It is part of a larger set that contains possible routes for a particular route entry.
- This Resource contains the content of a route set in the Redfish Specification.
6.114.2 URIs
/redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/MSDT/{MSDTId}/RouteSet/{RouteId}
/redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/LPRT/{LPRTId}/RouteSet/{RouteId}
/redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/MPRT/{MPRTId}/RouteSet/{RouteId}
/redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/SSDT/{SSDTId}/RouteSet/{RouteId}
/redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortId}/LPRT/{LPRTId}/RouteSet/{RouteId}
/redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortId}/MPRT/{MPRTId}/RouteSet/{RouteId}
/redfish/v1/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/MSDT/{MSDTId}/RouteSet/{RouteId}
/redfish/v1/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/LPRT/{LPRTId}/RouteSet/{RouteId}
/redfish/v1/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/MPRT/{MPRTId}/RouteSet/{RouteId}
/redfish/v1/Systems/{ComputerSystemId}/FabricAdapters/{FabricAdapterId}/SSDT/{SSDTId}/RouteSet/{RouteId}
6.114.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| EgressIdentifier | integer | read-write | The egress interface
identifier.
|
| HopCount | integer | read-write | The number of hops.
|
| Valid | boolean | read-write | An indication of whether the entry is
valid.
|
| VCAction | integer | read-write | The Virtual Channel Action
index.
|
6.114.4 Example response
{
"@odata.type": "#RouteSetEntry.v1_0_1.RouteSetEntry",
"Id": "0",
"Name": "RouteSet0",
"Description": "Gen-Z Port 1 LPRT Entry 0 Route 0",
"Valid": false,
"VCAction": 1,
"HopCount": 2,
"EgressIdentifier": 0,
"@odata.id": "/redfish/v1/Fabrics/GenZ/Switches/Switch1/Ports/1/LPRT/0/RouteSet/0"
}6.115 SecureBoot 1.1.0
| Version | v1.1 | v1.0 |
| Release | 2020.1 | 2016.1 |
6.115.1 Description
The SecureBoot schema contains UEFI Secure Boot information and represents properties for managing the UEFI Secure Boot functionality of a system.
- This resource contains UEFI Secure Boot information for a Redfish implementation.
6.115.2 URIs
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/SecureBoot
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/SecureBoot
/redfish/v1/Systems/{ComputerSystemId}/SecureBoot
6.115.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| SecureBootCurrentBoot | string (enum) |
read-only (null) |
The UEFI Secure Boot state during the
current boot cycle.
|
| SecureBootDatabases (v1.1+) { | object | A link to the collection of UEFI Secure
Boot databases.
|
|
| @odata.id | string | read-only | Link to Collection of SecureBootDatabase. See the SecureBootDatabase schema for details. |
| } | |||
| SecureBootEnable | boolean | read-write (null) |
An indication of whether UEFI Secure Boot
is enabled.
|
| SecureBootMode | string (enum) |
read-only (null) |
The current UEFI Secure Boot
Mode.
|
6.115.4 Actions
6.115.4.1 ResetKeys
Description
This action resets the UEFI Secure Boot keys.
- This action
shall reset the UEFI Secure Boot key databases. The
ResetAllKeysToDefaultvalue shall reset all UEFI Secure Boot key databases to their default values. TheDeleteAllKeysvalue shall delete the content of all UEFI Secure Boot key databases. TheDeletePKvalue shall delete the content of the PK Secure Boot key database.
Action URI
{Base URI of target resource}/Actions/SecureBoot.ResetKeys
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| ResetKeysType | string (enum) |
required | The type of reset or delete to perform on
the UEFI Secure Boot databases.
|
Request Example
{
"ResetKeysType": "DeleteAllKeys"
}6.115.5 Property details
6.115.5.1 ResetKeysType
The type of reset or delete to perform on the UEFI Secure Boot databases.
- This parameter shall specify the type of reset or delete to perform on the UEFI Secure Boot databases.
| string | Description |
|---|---|
| DeleteAllKeys | Delete the contents of all UEFI Secure Boot key databases, including the PK key database. This puts the system in Setup Mode. |
| DeletePK | Delete the contents of the PK UEFI Secure Boot database. This puts the system in Setup Mode. |
| ResetAllKeysToDefault | Reset the contents of all UEFI Secure Boot key databases, including the PK key database, to the default values. |
6.115.5.2 SecureBootCurrentBoot
The UEFI Secure Boot state during the current boot cycle.
- This property shall indicate the UEFI Secure Boot state during the current boot cycle.
| string | Description |
|---|---|
| Disabled | UEFI Secure Boot is currently disabled. |
| Enabled | UEFI Secure Boot is currently enabled. |
6.115.5.3 SecureBootMode
The current UEFI Secure Boot Mode.
- This property shall contain the current UEFI Secure Boot mode, as defined in the UEFI Specification.
| string | Description |
|---|---|
| AuditMode | UEFI Secure Boot is currently in Audit Mode. |
| DeployedMode | UEFI Secure Boot is currently in Deployed Mode. |
| SetupMode | UEFI Secure Boot is currently in Setup Mode. |
| UserMode | UEFI Secure Boot is currently in User Mode. |
6.115.6 Example response
{
"@odata.type": "#SecureBoot.v1_1_0.SecureBoot",
"Id": "SecureBoot",
"Name": "UEFI Secure Boot",
"Actions": {
"#SecureBoot.ResetKeys": {
"target": "/redfish/v1/Systems/1/SecureBoot/Actions/SecureBoot.ResetKeys",
"ResetKeysType@Redfish.AllowableValues": [
"ResetAllKeysToDefault",
"DeleteAllKeys",
"DeletePK"
]
}
},
"SecureBootEnable": false,
"SecureBootCurrentBoot": "Disabled",
"SecureBootMode": "UserMode",
"SecureBootDatabases": {
"@odata.id": "/redfish/v1/Systems/1/SecureBoot/SecureBootDatabases"
},
"@odata.id": "/redfish/v1/Systems/1/SecureBoot"
}6.116 SecureBootDatabase 1.0.1
| Version | v1.0 |
| Release | 2020.1 |
6.116.1 Description
The SecureBootDatabase schema describes a UEFI Secure Boot database used to store certificates or hashes.
- This resource shall be used to represent a UEFI Secure Boot database for a Redfish implementation.
6.116.2 URIs
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/SecureBoot/SecureBootDatabases/{DatabaseId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/SecureBoot/SecureBootDatabases/{DatabaseId}
/redfish/v1/Systems/{ComputerSystemId}/SecureBoot/SecureBootDatabases/{DatabaseId}
6.116.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Certificates { | object | A link to the collection of certificates
contained in this UEFI Secure Boot database.
|
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| DatabaseId | string | read-only | This property contains the name of the
UEFI Secure Boot database.
|
| Signatures { | object | A link to the collection of signatures
contained in this UEFI Secure Boot database.
|
|
| @odata.id | string | read-only | Link to Collection of Signature. See the Signature schema for details. |
| } |
6.116.4 Actions
6.116.4.1 ResetKeys
Description
This action is used to reset the UEFI Secure Boot keys of this database.
- This action shall perform a reset of this UEFI Secure
Boot key database. The
ResetAllKeysToDefaultvalue shall reset this UEFI Secure Boot key database to the default values. TheDeleteAllKeysvalue shall delete the content of this UEFI Secure Boot key database.
Action URI
{Base URI of target resource}/Actions/SecureBootDatabase.ResetKeys
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| ResetKeysType | string (enum) |
required | The type of reset or delete to perform on
this UEFI Secure Boot database.
|
Request Example
{
"ResetKeysType": "ResetAllKeysToDefault"
}6.116.5 Property details
6.116.5.1 ResetKeysType
The type of reset or delete to perform on this UEFI Secure Boot database.
- This parameter shall specify the type of reset or delete to perform on this UEFI Secure Boot database.
| string | Description |
|---|---|
| DeleteAllKeys | Delete the content of this UEFI Secure Boot key database. |
| ResetAllKeysToDefault | Reset the content of this UEFI Secure Boot key database to the default values. |
6.116.6 Example response
{
"@odata.type": "#SecureBootDatabase.v1_0_1.SecureBootDatabase",
"Id": "PK",
"Name": "PK - Platform Key",
"Description": "UEFI PK Secure Boot Database",
"DatabaseId": "PK",
"Certificates": {
"@odata.id": "/redfish/v1/Systems/1/SecureBoot/SecureBootDatabases/PK/Certificates/"
},
"Actions": {
"#SecureBootDatabase.ResetKeys": {
"target": "/redfish/v1/Systems/1/SecureBoot/SecureBootDatabases/PK/Actions/SecureBootDatabase.ResetKeys",
"ResetKeysType@Redfish.AllowableValues": [
"ResetAllKeysToDefault",
"DeleteAllKeys"
]
}
},
"@odata.id": "/redfish/v1/Systems/1/SecureBoot/SecureBootDatabases/PK"
}6.117 SecurityPolicy 1.0.0
| Version | v1.0 |
| Release | 2022.2 |
6.117.1 Description
The SecurityPolicy resource provides a central point to configure the security policy of a manager.
- This resource shall represent configurable security related policies managed by a manager. All security parameters in other resources that are controlled by the manager shall follow to the related settings in this security policy. For example, an outbound TLS connection established per an EventDestination resource will follow the values of the properties in the TLS property.
6.117.2 URIs
/redfish/v1/Managers/{ManagerId}/SecurityPolicy
6.117.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| OverrideParentManager | boolean | read-write | Override the security policy of the parent
manager.
|
| SPDM { | object | The SPDM policy.
|
|
| Allowed { | object | (null) |
The SPDM policy settings that are allowed,
such as the allowable SPDM versions and algorithms.
|
| Algorithms { | object | (null) |
The SPDM algorithms.
|
| AEAD [ ] | array (string, null) | read-write | The AEAD algorithms.
|
| BaseAsym [ ] | array (string, null) | read-write | The asymmetric signature
algorithms.
|
| BaseHash [ ] | array (string, null) | read-write | The hash algorithms.
|
| } | |||
| Versions [ ] | array (string, null) | read-write | The SPDM versions.
^\d+\.\d+$|^NONE$|^ALL$ |
| } | |||
| AllowExtendedAlgorithms | boolean | read-write (null) |
An indication of whether SPDM extended
algorithms are allowed.
|
| Denied { | object | (null) |
The SPDM policy settings that are
prohibited, such as the prohibited SPDM versions and
algorithms.
|
| Algorithms { | object | (null) |
The SPDM algorithms.
|
| AEAD [ ] | array (string, null) | read-write | The AEAD algorithms.
|
| BaseAsym [ ] | array (string, null) | read-write | The asymmetric signature
algorithms.
|
| BaseHash [ ] | array (string, null) | read-write | The hash algorithms.
|
| } | |||
| Versions [ ] | array (string, null) | read-write | The SPDM versions.
^\d+\.\d+$|^NONE$|^ALL$ |
| } | |||
| Enabled | boolean | read-write (null) |
An indication of whether SPDM
communication with devices is enabled.
|
| RevokedCertificates { | object | (null) |
The revoked SPDM device
certificates.
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| SecureSessionEnabled | boolean | read-write (null) |
An indication of whether SPDM secure
sessions with devices is enabled.
|
| TrustedCertificates { | object | (null) |
The trusted SPDM device
certificates.
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| VerifyCertificate | boolean | read-write (null) |
An indication of whether the manager will
verify the certificate of the SPDM endpoint.
|
| } | |||
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| TLS { | object | The TLS policy.
|
|
| Client { | object | The TLS policy.
|
|
| Allowed {} | object | (null) |
The TLS policy settings that are allowed,
such as the allowable TLS versions and algorithms.
|
| Denied {} | object | (null) |
The TLS policy settings that are
prohibited, such as the prohibited TLS versions and
algorithms.
|
| RevokedCertificates { | object | (null) |
The revoked TLS server
certificates.
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| TrustedCertificates { | object | (null) |
The trusted TLS server
certificates.
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| VerifyCertificate | boolean | read-write (null) |
An indication of whether the manager will
verify the certificate of the remote TLS endpoint.
|
| } | |||
| Server { | object | The TLS policy.
|
|
| Allowed {} | object | (null) |
The TLS policy settings that are allowed,
such as the allowable TLS versions and algorithms.
|
| Denied {} | object | (null) |
The TLS policy settings that are
prohibited, such as the prohibited TLS versions and
algorithms.
|
| RevokedCertificates { | object | (null) |
The revoked TLS server
certificates.
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| TrustedCertificates { | object | (null) |
The trusted TLS server
certificates.
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| VerifyCertificate | boolean | read-write (null) |
An indication of whether the manager will
verify the certificate of the remote TLS endpoint.
|
| } | |||
| } |
6.117.4 Property details
6.117.4.1 TLSParameterSet
The TLS policy settings.
| Algorithms { | object | (null) |
The TLS algorithms.
|
||||||||
| CipherSuites [ ] | array (string, null) | read-write | The TLS cipher suites.
|
||||||||
| SignatureAlgorithms [ ] | array (string, null) | read-write | The TLS signature algorithms.
|
||||||||
| } | |||||||||||
| Versions [ ] | array (string, null) | read-write | The TLS versions.
^\d+\.\d+$|^NONE$|^ALL$ |
6.117.5 Example response
{
"@odata.type": "#SecurityPolicy.v1_0_0.SecurityPolicy",
"Id": "ManagerGlobalSecurityPolicy",
"Status": {
"Health": "OK",
"State": "Enabled"
},
"OverrideParentManager": true,
"SPDM": {
"Enabled": true,
"SecureSessionEnabled": true,
"VerifyCertificate": true,
"TrustedCertificates": {
"@odata.id": "/redfish/v1/Managers/BMC/SecurityPolicy/SPDM/TrustedCertificates"
},
"RevokedCertificates": {
"@odata.id": "/redfish/v1/Managers/BMC/SecurityPolicy/SPDM/RevokedCertificates"
},
"Allowed": {
"Versions": [
"ALL"
],
"Algorithms": {
"AEAD": [
"AES-GCM-256",
"AES-GCM-128"
],
"BaseAsym": [
"TPM_ALG_RSASSA_2048",
"TPM_ALG_ECDSA_ECC_NIST_P384",
"TPM_ALG_SM2_ECC_SM2_P256"
],
"BaseHash": [
"TPM_ALG_SHA_512",
"TPM_ALG_SHA3_512"
]
}
},
"Denied": {
"Versions": [
"NONE"
],
"Algorithms": {
"AEAD": [],
"BaseAsym": [
"EdDSA ed25519"
],
"BaseHash": [
"TPM_ALG_SHA_256"
]
}
},
"AllowExtendedAlgorithms": false
},
"TLS": {
"Client": {
"VerifyCertificate": true,
"TrustedCertificates": {
"@odata.id": "/redfish/v1/Managers/BMC/SecurityPolicy/TLS/Server/TrustedCertificates"
},
"RevokedCertificates": {
"@odata.id": "/redfish/v1/Managers/BMC/SecurityPolicy/TLS/Server/RevokedCertificates"
},
"Allowed": {
"Versions": [
"1.2",
"1.3"
],
"Algorithms": {
"CipherSuites": [
"TLS_AES_128_GCM_SHA256",
"TLS_AES_128_GCM_SHA384"
],
"SignatureAlgorithms": []
}
},
"Denied": {
"Versions": [
"1.1"
],
"Algorithms": {
"CipherSuites": [],
"SignatureAlgorithms": [
"rsa_pkcs1_sha1",
"ecdsa_sha1"
]
}
}
},
"Server": {
"VerifyCertificate": false,
"TrustedCertificates": {
"@odata.id": "/redfish/v1/Managers/BMC/SecurityPolicy/TLS/Client/TrustedCertificates"
},
"RevokedCertificates": {
"@odata.id": "/redfish/v1/Managers/BMC/SecurityPolicy/TLS/Client/RevokedCertificates"
},
"Allowed": {
"Versions": [
"1.3"
],
"Algorithms": {
"CipherSuites": [
"TLS_AES_128_GCM_SHA256",
"TLS_AES_128_GCM_SHA384"
],
"SignatureAlgorithms": []
}
},
"Denied": {
"Versions": [
"1.1",
"1.2"
],
"Algorithms": {
"CipherSuites": [],
"SignatureAlgorithms": [
"rsa_pkcs1_sha1",
"ecdsa_sha1"
]
}
}
}
},
"@odata.id": "/redfish/v1/Managers/BMC/SecurityPolicy"
}6.118 Sensor 1.8.0
| Version | v1.8 | v1.7 | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2023.2 | 2023.1 | 2022.2 | 2021.4 | 2021.2 | 2021.1 | 2020.4 | 2019.4 | 2018.3 |
6.118.1 Description
The Sensor schema describes a sensor and its properties.
- This resource shall represent a sensor for a Redfish implementation.
6.118.2 URIs
/redfish/v1/Chassis/{ChassisId}/Sensors/{SensorId}
/redfish/v1/PowerEquipment/FloorPDUs/{PowerDistributionId}/Sensors/{SensorId}
(deprecated)
/redfish/v1/PowerEquipment/PowerShelves/{PowerDistributionId}/Sensors/{SensorId}
(deprecated)
/redfish/v1/PowerEquipment/RackPDUs/{PowerDistributionId}/Sensors/{SensorId}
(deprecated)
/redfish/v1/PowerEquipment/Switchgear/{PowerDistributionId}/Sensors/{SensorId}
(deprecated)
/redfish/v1/PowerEquipment/TransferSwitches/{PowerDistributionId}/Sensors/{SensorId}
(deprecated)
6.118.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Accuracy (deprecated v1.8) | number (%) |
read-only (null) |
The estimated percent error of measured
versus actual values.
|
| AdjustedMaxAllowableOperatingValue | number | read-only (null) |
The adjusted maximum allowable operating
value for this equipment based on the environmental
conditions.
|
| AdjustedMinAllowableOperatingValue | number | read-only (null) |
The adjusted minimum allowable operating
value for this equipment based on the environmental
conditions.
|
| ApparentkVAh (v1.5+) | number (kV.A.h) |
read-only (null) |
Apparent energy (kVAh).
|
| ApparentVA | number (V.A) |
read-only (null) |
The product of voltage and current for an
AC circuit, in volt-ampere units.
|
| AverageReading (v1.4+) | number | read-only (null) |
The average sensor value.
|
| AveragingInterval (v1.4+) | string (duration) |
read-write (null) |
The interval over which the average sensor
value is calculated.
^P(\d+D)?(T(\d+H)?(\d+M)?(\d+(.\d+)?S)?)?$ |
| AveragingIntervalAchieved (v1.4+) | boolean | read-only (null) |
Indicates that enough readings were
collected to calculate the average sensor reading over the averaging
interval time.
|
| Calibration (v1.4+) | number | read-write (null) |
The calibration offset applied to the
Reading.
|
| CalibrationTime (v1.4+) | string (date-time) |
read-write (null) |
The date and time that the sensor was last
calibrated.
|
| CrestFactor (v1.1+) | number | read-only (null) |
The crest factor for this
sensor.
|
| ElectricalContext | string (enum) |
read-only (null) |
The combination of current-carrying
conductors.
|
| Implementation (v1.1+) | string (enum) |
read-only (null) |
The implementation of the
sensor.
|
| LifetimeReading (v1.1+) | number | read-only (null) |
The total accumulation value for this
sensor.
|
| Links (v1.3+) { | object | The links to other resources that are
related to this resource.
|
|
| AssociatedControls (v1.4+) [ { | array | An array of links to the controls that can
affect this sensor.
|
|
| @odata.id | string | read-only | Link to a Control resource. See the Links section and the Control schema for details. |
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| } | |||
| LoadPercent (deprecated v1.1) | number (%) |
read-only (null) |
The power load utilization for this
sensor.
Percent to show utilization values when
needed. |
| Location {} | object | The location information for this
sensor.
|
|
| LowestReading (v1.4+) | number | read-only (null) |
The lowest sensor value.
|
| LowestReadingTime (v1.4+) | string (date-time) |
read-only (null) |
The time when the lowest sensor value
occurred.
|
| MaxAllowableOperatingValue | number | read-only (null) |
The maximum allowable operating value for
this equipment.
|
| MinAllowableOperatingValue | number | read-only (null) |
The minimum allowable operating value for
this equipment.
|
| PeakReading | number | read-only (null) |
The peak sensor value.
|
| PeakReadingTime | string (date-time) |
read-only (null) |
The time when the peak sensor value
occurred.
|
| PhaseAngleDegrees (v1.5+) | number | read-only (null) |
The phase angle (degrees) between the
current and voltage waveforms.
|
| PhysicalContext | string (enum) |
read-only (null) |
The area or device to which this sensor
measurement applies.
|
| PhysicalSubContext | string (enum) |
read-only (null) |
The usage or location within a device to
which this sensor measurement applies.
|
| PowerFactor | number | read-only (null) |
The power factor for this
sensor.
|
| Precision | number | read-only (null) |
The number of significant digits in the
reading.
|
| ReactivekVARh (v1.5+) | number (kV.A.h) |
read-only (null) |
Reactive energy (kVARh).
|
| ReactiveVAR | number (V.A) |
read-only (null) |
The square root of the difference term of
squared apparent VA and squared power (Reading) for a circuit, in VAR
units.
|
| Reading | number | read-only (null) |
The sensor value.
|
| ReadingAccuracy (v1.8+) | number | read-only (null) |
Accuracy (+/-) of the reading.
|
| ReadingBasis (v1.7+) | string (enum) |
read-only (null) |
The basis for the reading of this
sensor.
|
| ReadingRangeMax | number | read-only (null) |
The maximum possible value for this
sensor.
|
| ReadingRangeMin | number | read-only (null) |
The minimum possible value for this
sensor.
|
| ReadingTime (v1.1+) | string (date-time) |
read-only (null) |
The date and time that the reading was
acquired from the sensor.
|
| ReadingType | string (enum) |
read-only (null) |
The type of sensor.
|
| ReadingUnits | string | read-only (null) |
The units of the reading and
thresholds.
|
| RelatedItem (v1.2+) [ { | array | An array of links to resources or objects
that this sensor services.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| SensingFrequency (deprecated v1.1) | number | read-only (null) |
The time interval between readings of the
physical sensor.
|
| SensingInterval (v1.1+) | string (duration) |
read-only (null) |
The time interval between readings of the
sensor.
^P(\d+D)?(T(\d+H)?(\d+M)?(\d+(.\d+)?S)?)?$ |
| SensorGroup (v1.4+) {} | object | The group of sensors that provide readings
for this sensor.
|
|
| SensorResetTime | string (date-time) |
read-only (null) |
The date and time when the time-based
properties were last reset.
|
| SpeedRPM (v1.2+) | number ({rev}/min) |
read-only (null) |
The rotational speed.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| THDPercent (v1.1+) | number (%) |
read-only (null) |
The total harmonic distortion percent (%
THD).
|
| Thresholds { | object | The set of thresholds defined for this
sensor.
|
|
| LowerCaution {} | object | The value at which the reading is below
normal range.
|
|
| LowerCautionUser (v1.2+) {} | object | A user-defined value at which the reading
is considered below normal range.
|
|
| LowerCritical {} | object | The value at which the reading is below
normal range but not yet fatal.
|
|
| LowerCriticalUser (v1.2+) {} | object | A user-defined value at which the reading
is considered below normal range but not yet fatal.
|
|
| LowerFatal {} | object | The value at which the reading is below
normal range and fatal.
|
|
| UpperCaution {} | object | The value at which the reading is above
normal range.
|
|
| UpperCautionUser (v1.2+) {} | object | A user-defined value at which the reading
is considered above normal range.
|
|
| UpperCritical {} | object | The value at which the reading is above
normal range but not yet fatal.
|
|
| UpperCriticalUser (v1.2+) {} | object | A user-defined value at which the reading
is considered above normal range but not yet fatal.
|
|
| UpperFatal {} | object | The value at which the reading is above
normal range and fatal.
|
|
| } | |||
| VoltageType | string (enum) |
read-only (null) |
The voltage type for this
sensor.
|
6.118.4 Actions
6.118.4.1 ResetMetrics
Description
Resets metrics related to this sensor.
- This action shall reset any time intervals or counted values for this sensor. The SensorResetTime property shall be updated to reflect the time that this action was performed.
Action URI
{Base URI of target resource}/Actions/Sensor.ResetMetrics
Action parameters
This action takes no parameters.
6.118.4.2 ResetToDefaults (v1.6+)
Description
The action resets the values of writable properties to factory defaults.
- This action shall reset the values of writable properties in this resource to their default values as specified by the manufacturer.
Action URI
{Base URI of target resource}/Actions/Sensor.ResetToDefaults
Action parameters
This action takes no parameters.
6.118.5 Property details
6.118.5.1 Activation
The direction of crossing that activates this threshold.
- This property shall indicate the direction of crossing of the reading for this sensor that activates the threshold.
| string | Description |
|---|---|
| Decreasing | Value decreases below the
threshold.
|
| Disabled (v1.7+) | The threshold is disabled.
|
| Either | Value crosses the threshold in either
direction.
|
| Increasing | Value increases above the
threshold.
|
6.118.5.2 ElectricalContext
The combination of current-carrying conductors.
- This property shall represent the combination of current-carrying conductors that distribute power.
| 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.118.5.3 Implementation
The implementation of the sensor.
- This property shall contain the implementation of the sensor.
| string | Description |
|---|---|
| PhysicalSensor | The reading is acquired from a physical sensor. |
| Reported | The reading is obtained from software or a device. |
| Synthesized | The reading is obtained by applying a calculation on one or more properties or multiple sensors. The calculation is not provided. |
6.118.5.4 PhysicalContext
The area or device to which this sensor measurement applies.
- This property shall contain a description of the affected component or region within the equipment 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. |
| Battery | A battery. |
| Board | A circuit board.
|
| Chassis | The entire chassis. |
| ComputeBay | Within a compute bay. |
| CoolingSubsystem | The entire cooling, or air and liquid, subsystem. |
| CPU | A processor (CPU). |
| CPUSubsystem | The entire processor (CPU) subsystem. |
| DCBus | A DC bus. |
| Exhaust | The air exhaust point or points or region of the chassis. |
| ExpansionBay | Within an expansion bay. |
| Fan | A fan. |
| FPGA | An FPGA. |
| Front | The front of the chassis. |
| GPU | A graphics processor (GPU). |
| GPUSubsystem | The entire graphics processor (GPU) subsystem. |
| Intake | The air intake point or points or region of the chassis. |
| LiquidInlet | The liquid inlet point of the chassis. |
| LiquidOutlet | The liquid outlet point of the chassis. |
| Lower | The lower portion of the chassis. |
| Memory | A memory device. |
| MemorySubsystem | The entire memory subsystem. |
| Motor | A motor. |
| NetworkBay | Within a networking bay. |
| NetworkingDevice | A networking device. |
| PowerSubsystem | The entire power subsystem. |
| PowerSupply | A power supply. |
| PowerSupplyBay | Within a power supply bay. |
| Pump | A pump. |
| Rectifier | A rectifier device. |
| Room | The room. |
| StorageBay | Within a storage bay. |
| StorageDevice | A storage device. |
| SystemBoard | The system board (PCB). |
| Transceiver | A transceiver.
|
| Transformer | A transformer. |
| TrustedModule | A trusted module. |
| Upper | The upper portion of the chassis. |
| VoltageRegulator | A voltage regulator device. |
6.118.5.5 PhysicalSubContext
The usage or location within a device to which this sensor measurement applies.
- This property shall contain a description of the usage or sub-region within the equipment to which this sensor measurement applies. This property generally differentiates multiple sensors within the same PhysicalContext instance.
| string | Description |
|---|---|
| Input | The input. |
| Output | The output. |
6.118.5.6 ReadingBasis
The basis for the reading of this sensor.
- This property shall
indicate the basis or frame of reference for the value of the Reading
property. If this property is not present, the value shall be assumed to
be
Zero.
| string | Description |
|---|---|
| Delta | A reading that reports the difference
between two measurements.
|
| Headroom | A reading that decreases as it approaches
a defined reference point.
|
| Zero | A zero-based reading.
|
6.118.5.7 ReadingType
The type of sensor.
- This property shall contain the type of the sensor.
| string | Description |
|---|---|
| AbsoluteHumidity (v1.5+) | Absolute humidity (g/cu m).
|
| AirFlow (deprecated v1.7) | Air flow (cu ft/min).
AirFlowCMM for
consistent use of SI units. |
| AirFlowCMM (v1.7+) | Air flow (m^3/min).
|
| Altitude | Altitude (m).
|
| Barometric | Barometric pressure (mm).
|
| ChargeAh (v1.4+) | Charge (Ah).
|
| Current | Current (A).
|
| EnergyJoules | Energy (J).
|
| EnergykWh | Energy (kWh).
|
| EnergyWh (v1.4+) | Energy (Wh).
|
| Frequency | Frequency (Hz).
|
| Heat (v1.7+) | Heat (kW).
|
| Humidity | Relative humidity (percent).
|
| LiquidFlow (deprecated v1.7) | Liquid flow (L/s).
LiquidFlowLPM for consistency of units typically
expected or reported by Sensor and Control resources. |
| LiquidFlowLPM (v1.7+) | Liquid flow (L/min).
|
| LiquidLevel | Liquid level (cm).
|
| Percent (v1.1+) | Percent (%).
|
| Power | Power (W).
|
| Pressure (deprecated v1.7) | Pressure (Pa).
PressurePa or
PressurekPa for consistency of units between Sensor and
Control resources. |
| PressurekPa (v1.5+) | Pressure (kPa).
|
| PressurePa (v1.7+) | Pressure (Pa).
|
| Rotational | Rotational (RPM).
|
| Temperature | Temperature (C).
|
| Voltage | Voltage (VAC or VDC).
|
6.118.5.8 Threshold
The threshold definition for a sensor.
| Activation | string (enum) |
read-write (null) |
The direction of crossing that activates
this threshold.
|
| DwellTime | string (duration) |
read-write (null) |
The duration the sensor value must violate
the threshold before the threshold is activated.
^P(\d+D)?(T(\d+H)?(\d+M)?(\d+(.\d+)?S)?)?$ |
| HysteresisDuration (v1.7+) | string (duration) |
read-write (null) |
The duration the sensor value must not
violate the threshold before the threshold is deactivated.
^P(\d+D)?(T(\d+H)?(\d+M)?(\d+(.\d+)?S)?)?$ |
| HysteresisReading (v1.7+) | number | read-write (null) |
The reading offset from the threshold
value required to clear the threshold.
|
| Reading | number | read-write (null) |
The threshold value.
|
6.118.5.9 VoltageType
The voltage type for this sensor.
- This property shall represent the type of input voltage the sensor monitors.
| string | Description |
|---|---|
| AC | Alternating current. |
| DC | Direct current. |
6.118.6 Example response
{
"@odata.type": "#Sensor.v1_8_0.Sensor",
"Id": "CabinetTemp",
"Name": "Rack Temperature",
"ReadingType": "Temperature",
"ReadingTime": "2019-12-25T04:14:33+06:00",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Reading": 31.6,
"ReadingUnits": "C",
"ReadingRangeMin": 0,
"ReadingRangeMax": 70,
"Accuracy": 0.25,
"Precision": 1,
"SensingInterval": "PT3S",
"PhysicalContext": "Chassis",
"Thresholds": {
"UpperCritical": {
"Reading": 40,
"Activation": "Increasing"
},
"UpperCaution": {
"Reading": 35,
"Activation": "Increasing"
},
"LowerCaution": {
"Reading": 10,
"Activation": "Increasing"
}
},
"@odata.id": "/redfish/v1/Chassis/1/Sensors/CabinetTemp"
}6.119 SerialInterface 1.2.0
| Version | v1.2 | v1.1 | v1.0 |
| Release | 2023.2 | 2017.1 | 1.0 |
6.119.1 Description
The SerialInterface schema describes an asynchronous serial interface, such as an RS-232 interface, available to a system or device.
- This resource shall represent a serial interface as part of the Redfish Specification.
6.119.2 URIs
/redfish/v1/Managers/{ManagerId}/SerialInterfaces/{SerialInterfaceId}
6.119.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| BitRate | string (enum) |
read-write | The receive and transmit rate of data
flow, typically in bits per second (bit/s), over the serial
connection.
|
| ConnectorType | string (enum) |
read-only | The type of connector used for this
interface.
|
| DataBits | string (enum) |
read-write | The number of data bits that follow the
start bit over the serial connection.
|
| FlowControl | string (enum) |
read-write | The type of flow control, if any, that is
imposed on the serial connection.
|
| InterfaceEnabled | boolean | read-write (null) |
An indication of whether this interface is
enabled.
|
| Links (v1.2+) { | object | The links to other resources that are
related to this resource.
|
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| } | |||
| Parity | string (enum) |
read-write | The type of parity used by the sender and
receiver to detect errors over the serial connection.
|
| PinOut | string (enum) |
read-only (null) |
The physical pinout configuration for a
serial connector.
|
| SignalType | string (enum) |
read-only | The type of signal used for the
communication connection.
|
| StopBits | string (enum) |
read-write | The period of time before the next start
bit is transmitted.
|
6.119.4 Property details
6.119.4.1 BitRate
The receive and transmit rate of data flow, typically in bits per second (bit/s), over the serial connection.
- This property shall indicate the transmit and receive speed of the serial connection.
| string | Description |
|---|---|
| 115200 | A bit rate of 115200 bit/s. |
| 1200 | A bit rate of 1200 bit/s. |
| 19200 | A bit rate of 19200 bit/s. |
| 230400 | A bit rate of 230400 bit/s. |
| 2400 | A bit rate of 2400 bit/s. |
| 38400 | A bit rate of 38400 bit/s. |
| 4800 | A bit rate of 4800 bit/s. |
| 57600 | A bit rate of 57600 bit/s. |
| 9600 | A bit rate of 9600 bit/s. |
6.119.4.2 ConnectorType
The type of connector used for this interface.
- This property shall indicate the type of physical connector used for this serial connection.
| string | Description |
|---|---|
| DB25 Female | A DB25 Female connector. |
| DB25 Male | A DB25 Male connector. |
| DB9 Female | A DB9 Female connector. |
| DB9 Male | A DB9 Male connector. |
| mUSB | A mUSB connector. |
| RJ11 | An RJ11 connector. |
| RJ45 | An RJ45 connector. |
| USB | A USB connector. |
| uUSB | A uUSB connector. |
6.119.4.3 DataBits
The number of data bits that follow the start bit over the serial connection.
- This property shall indicate number of data bits for the serial connection.
| string | Description |
|---|---|
| 5 | Five bits of data following the start bit. |
| 6 | Six bits of data following the start bit. |
| 7 | Seven bits of data following the start bit. |
| 8 | Eight bits of data following the start bit. |
6.119.4.4 FlowControl
The type of flow control, if any, that is imposed on the serial connection.
- This property shall indicate the flow control mechanism for the serial connection.
| string | Description |
|---|---|
| Hardware | Out-of-band flow control imposed. |
| None | No flow control imposed. |
| Software | XON/XOFF in-band flow control imposed. |
6.119.4.5 Parity
The type of parity used by the sender and receiver to detect errors over the serial connection.
- This property shall indicate parity information for a serial connection.
| string | Description |
|---|---|
| Even | An even parity bit. |
| Mark | A mark parity bit. |
| None | No parity bit. |
| Odd | An odd parity bit. |
| Space | A space parity bit. |
6.119.4.6 PinOut
The physical pinout configuration for a serial connector.
- This property shall indicate the physical pinout for the serial connector.
| string | Description |
|---|---|
| Cisco | The Cisco pinout configuration. |
| Cyclades | The Cyclades pinout configuration. |
| Digi | The Digi pinout configuration. |
6.119.4.7 SignalType
The type of signal used for the communication connection.
- This property shall contain the type of serial signaling in use for the serial connection.
| string | Description |
|---|---|
| Rs232 | The serial interface follows RS232. |
| Rs485 | The serial interface follows RS485. |
6.119.4.8 StopBits
The period of time before the next start bit is transmitted.
- This property shall indicate the stop bits for the serial connection.
| string | Description |
|---|---|
| 1 | One stop bit following the data bits. |
| 2 | Two stop bits following the data bits. |
6.119.5 Example response
{
"@odata.type": "#SerialInterface.v1_2_0.SerialInterface",
"Id": "TTY0",
"Name": "Manager Serial Interface 1",
"Description": "Management for Serial Interface",
"InterfaceEnabled": true,
"SignalType": "Rs232",
"BitRate": "115200",
"Parity": "None",
"DataBits": "8",
"StopBits": "1",
"FlowControl": "None",
"ConnectorType": "RJ45",
"PinOut": "Cyclades",
"@odata.id": "/redfish/v1/Managers/BMC/SerialInterfaces/TTY0"
}6.120 ServiceConditions 1.0.0
| Version | v1.0 |
| Release | 2021.4 |
6.120.1 Description
The ServiceConditions schema contains definitions for reporting the conditions present in the service that require attention.
- This resource shall be used to represent the overall conditions present in a service for a Redfish implementation.
6.120.2 URIs
/redfish/v1/ServiceConditions
6.120.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Conditions [ { } ] | array (object) | (null) |
A condition that requires
attention.
|
| HealthRollup | string (enum) |
read-only | The health roll-up for all
resources.
|
6.120.4 Property details
6.120.4.1 HealthRollup
The health roll-up for all resources.
- This property shall contain the highest severity of any messages included in the Conditions property.
| string | Description |
|---|---|
| Critical | A critical condition requires immediate attention. |
| OK | Normal. |
| Warning | A condition requires attention. |
6.120.5 Example response
{
"@odata.type": "#ServiceConditions.v1_0_0.ServiceConditions",
"Name": "Redfish Service Conditions",
"HealthRollup": "Warning",
"Conditions": [
{
"MessageId": "ThermalEvents.1.0.OverTemperature",
"Timestamp": "2020-11-08T12:25:00-05:00 ",
"Message": "Temperature exceeds rated limit in power supply `A`.",
"Severity": "Warning",
"MessageArgs": [
"A"
],
"OriginOfCondition": {
"@odata.id": "/redfish/v1/Chassis/1/Power"
},
"LogEntry": {
"@odata.id": "/redfish/v1/Managers/1/LogServices/Log1/Entries/1"
}
},
{
"MessageId": "Base.1.9.ConditionInRelatedResource",
"Message": "One or more conditions exist in a related resource. See the OriginOfCondition property.",
"Severity": "Warning",
"OriginOfCondition": {
"@odata.id": "/redfish/v1/Systems/cpu-memory-example"
}
}
],
"@odata.id": "/redfish/v1/ServiceConditions"
}6.121 ServiceRoot 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 | 2023.1 | 2022.3 | 2022.1 | 2021.4 | 2021.3 | 2021.2 | 2021.1 | 2020.3 | 2020.2 | 2020.1 | 2019.4 | ... |
6.121.1 Description
The ServiceRoot schema describes the root of the Redfish service, located at the '/redfish/v1' URI. All other resources accessible through the Redfish interface on this device are linked directly or indirectly from the service root.
- This resource shall represent the root of the Redfish service.
6.121.2 URIs
/redfish/v1
/redfish/v1/
6.121.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AccountService { | object | The link to the account
service.
|
|
| @odata.id | string | read-only | Link to a AccountService resource. See the Links section and the AccountService schema for details. |
| } | |||
| AggregationService (v1.8+) { | object | The link to the aggregation
service.
|
|
| @odata.id | string | read-only | Link to a AggregationService resource. See the Links section and the AggregationService schema for details. |
| } | |||
| Cables (v1.11+) { | object | The link to a collection of
cables.
|
|
| @odata.id | string | read-only | Link to Collection of Cable. See the Cable schema for details. |
| } | |||
| CertificateService (v1.5+) { | object | The link to the certificate
service.
|
|
| @odata.id | string | read-only | Link to a CertificateService resource. See the Links section and the CertificateService schema for details. |
| } | |||
| Chassis { | object | The link to a collection of
chassis.
|
|
| @odata.id | string | read-only | Link to Collection of Chassis. See the Chassis schema for details. |
| } | |||
| ComponentIntegrity (v1.13+) { | object | The link to a collection of component
integrity information.
|
|
| @odata.id | string | read-only | Link to Collection of ComponentIntegrity. See the ComponentIntegrity schema for details. |
| } | |||
| CompositionService (v1.2+) { | object | The link to the composition
service.
|
|
| @odata.id | string | read-only | Link to a CompositionService resource. See the Links section and the CompositionService schema for details. |
| } | |||
| EventService { | object | The link to the event service.
|
|
| @odata.id | string | read-only | Link to a EventService resource. See the Links section and the EventService schema for details. |
| } | |||
| Fabrics (v1.1+) { | object | The link to a collection of
fabrics.
|
|
| @odata.id | string | read-only | Link to Collection of Fabric. See the Fabric schema for details. |
| } | |||
| Facilities (v1.6+) { | object | The link to a collection of
facilities.
|
|
| @odata.id | string | read-only | Link to Collection of Facility. See the Facility schema for details. |
| } | |||
| JobService (v1.4+) { | object | The link to the job service.
|
|
| @odata.id | string | read-only | Link to a JobService resource. See the Links section and the JobService schema for details. |
| } | |||
| JsonSchemas { | object | The link to a collection of JSON Schema
files.
|
|
| @odata.id | string | read-only | Link to Collection of JsonSchemaFile. See the JsonSchemaFile schema for details. |
| } | |||
| KeyService (v1.11+) { | object | The link to the key service.
|
|
| @odata.id | string | read-only | Link to a KeyService resource. See the Links section and the KeyService schema for details. |
| } | |||
| LicenseService (v1.12+) { | object | The link to the license
service.
|
|
| @odata.id | string | read-only | Link to a LicenseService resource. See the Links section and the LicenseService schema for details. |
| } | |||
| Links { | object | required | The links to other resources that are
related to this resource.
|
| ManagerProvidingService (v1.15+) { | object | The link to the manager that is providing
this Redfish service.
|
|
| @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 Using this guide clause. | |
| Sessions { | object | required | The link to a collection of
sessions.
|
| @odata.id | string | read-only | Link to Collection of Session. See the Session schema for details. |
| } | |||
| } | |||
| Managers { | object | The link to a collection of
managers.
|
|
| @odata.id | string | read-only | Link to Collection of Manager. See the Manager schema for details. |
| } | |||
| NVMeDomains (v1.10+) {} | object | The link to a collection of NVMe
domains.
|
|
| PowerEquipment (v1.6+) { | object | The link to a set of power
equipment.
|
|
| @odata.id | string | read-only | Link to a PowerEquipment resource. See the Links section and the PowerEquipment schema for details. |
| } | |||
| Product (v1.3+) | string | read-only (null) |
The product associated with this Redfish
service.
|
| ProtocolFeaturesSupported (v1.3+) { | object | The information about protocol features
that the service supports.
|
|
| DeepOperations (v1.7+) { | object | The information about deep operations that
the service supports.
|
|
| DeepPATCH (v1.7+) | boolean | read-only | An indication of whether the service
supports the deep PATCH operation.
|
| DeepPOST (v1.7+) | boolean | read-only | An indication of whether the service
supports the deep POST operation.
|
| MaxLevels (v1.7+) | integer | read-only | The maximum levels of resources allowed in
deep operations.
|
| } | |||
| ExcerptQuery (v1.4+) | boolean | read-only | An indication of whether the service
supports the excerpt query parameter.
|
| ExpandQuery (v1.3+) { | object | The information about the use of $expand
in the service.
|
|
| ExpandAll (v1.3+) | boolean | read-only | An indication of whether the service
supports the asterisk (*) option of the $expand query
parameter.
|
| Levels (v1.3+) | boolean | read-only | An indication of whether the service
supports the $levels option of the $expand query parameter.
|
| Links (v1.3+) | boolean | read-only | An indication of whether this service
supports the tilde (~) option of the $expand query
parameter.
|
| MaxLevels (v1.3+) | integer | read-only | The maximum $levels option value in the
$expand query parameter.
|
| NoLinks (v1.3+) | boolean | read-only | An indication of whether the service
supports the period (.) option of the $expand query
parameter.
|
| } | |||
| FilterQuery (v1.3+) | boolean | read-only | An indication of whether the service
supports the $filter query parameter.
|
| MultipleHTTPRequests (v1.14+) | boolean | read-only | An indication of whether the service
supports multiple outstanding HTTP requests.
|
| OnlyMemberQuery (v1.4+) | boolean | read-only | An indication of whether the service
supports the only query parameter.
|
| SelectQuery (v1.3+) | boolean | read-only | An indication of whether the service
supports the $select query parameter.
|
| } | |||
| RedfishVersion | string | read-only | The version of the Redfish
service.
^\d+\.\d+\.\d+$ |
| RegisteredClients (v1.13+) { | object | The link to a collection of registered
clients.
|
|
| @odata.id | string | read-only | Link to Collection of RegisteredClient. See the RegisteredClient schema for details. |
| } | |||
| Registries { | object | The link to a collection of
registries.
|
|
| @odata.id | string | read-only | Link to Collection of MessageRegistryFile. See the MessageRegistryFile schema for details. |
| } | |||
| ResourceBlocks (v1.5+) { | object | The link to a collection of resource
blocks. This collection is intended for implementations that do not
contain a composition service but that expose resources to an
orchestrator that implements a composition service.
|
|
| @odata.id | string | read-only | Link to Collection of ResourceBlock. See the ResourceBlock schema for details. |
| } | |||
| ServiceConditions (v1.13+) { | object | The link to the service
conditions.
|
|
| @odata.id | string | read-only | Link to a ServiceConditions resource. See the Links section and the ServiceConditions schema for details. |
| } | |||
| ServiceIdentification (v1.14+) | string | read-only | The vendor or user-provided product and
service identifier.
|
| SessionService { | object | The link to the sessions
service.
|
|
| @odata.id | string | read-only | Link to a SessionService resource. See the Links section and the SessionService schema for details. |
| } | |||
| Storage (v1.9+) { | object | The link to a collection of storage
subsystems.
|
|
| @odata.id | string | read-only | Link to Collection of Storage. See the Storage schema for details. |
| } | |||
| StorageServices (v1.1+) {} | object | The link to a collection of storage
services.
|
|
| StorageSystems (v1.1+) {} | object | The link to a collection of storage
systems.
|
|
| Systems { | object | The link to a collection of
systems.
|
|
| @odata.id | string | read-only | Link to Collection of ComputerSystem. See the ComputerSystem schema for details. |
| } | |||
| Tasks { | object | The link to the task service.
|
|
| @odata.id | string | read-only | Link to a TaskService resource. See the Links section and the TaskService schema for details. |
| } | |||
| TelemetryService (v1.4+) { | object | The link to the telemetry
service.
|
|
| @odata.id | string | read-only | Link to a TelemetryService resource. See the Links section and the TelemetryService schema for details. |
| } | |||
| ThermalEquipment (v1.16+) { | object | The link to a set of cooling
equipment.
|
|
| @odata.id | string | read-only | Link to a ThermalEquipment resource. See the Links section and the ThermalEquipment schema for details. |
| } | |||
| UpdateService (v1.1+) { | object | The link to the update
service.
|
|
| @odata.id | string | read-only | Link to a UpdateService resource. See the Links section and the UpdateService schema for details. |
| } | |||
| UUID | string (uuid) |
read-only (null) |
Unique identifier for a service instance.
When SSDP is used, this value contains the same UUID returned in an HTTP
200 OK response from an SSDP M-SEARCH request
during discovery.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ |
| Vendor (v1.5+) | string | read-only (null) |
The vendor or manufacturer associated with
this Redfish service.
|
6.121.4 Property details
6.121.4.1 idRef
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
6.121.5 Example response
{
"@odata.type": "#ServiceRoot.v1_16_0.ServiceRoot",
"Id": "RootService",
"Name": "Root Service",
"RedfishVersion": "1.15.0",
"UUID": "92384634-2938-2342-8820-489239905423",
"Product": "UR99 1U Server",
"ProtocolFeaturesSupported": {
"ExpandQuery": {
"ExpandAll": true,
"Levels": true,
"MaxLevels": 6,
"Links": true,
"NoLinks": true
},
"SelectQuery": false,
"FilterQuery": false,
"OnlyMemberQuery": true,
"ExcerptQuery": true,
"MultipleHTTPRequests": true
},
"ServiceConditions": {
"@odata.id": "/redfish/v1/ServiceConditions"
},
"Systems": {
"@odata.id": "/redfish/v1/Systems"
},
"Chassis": {
"@odata.id": "/redfish/v1/Chassis"
},
"Managers": {
"@odata.id": "/redfish/v1/Managers"
},
"UpdateService": {
"@odata.id": "/redfish/v1/UpdateService"
},
"CompositionService": {
"@odata.id": "/redfish/v1/CompositionService"
},
"Tasks": {
"@odata.id": "/redfish/v1/TaskService"
},
"SessionService": {
"@odata.id": "/redfish/v1/SessionService"
},
"AccountService": {
"@odata.id": "/redfish/v1/AccountService"
},
"EventService": {
"@odata.id": "/redfish/v1/EventService"
},
"Links": {
"Sessions": {
"@odata.id": "/redfish/v1/SessionService/Sessions"
}
},
"@odata.id": "/redfish/v1/"
}6.122 Session 1.7.0
| Version | v1.7 | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2023.2 | 2022.3 | 2022.2 | 2022.1 | 2020.3 | 2019.1 | 2017.1 | 1.0 |
6.122.1 Description
The Session resource describes a single connection (session) between a client and a Redfish service instance.
- This resource shall represent a session for a Redfish implementation.
6.122.2 URIs
/redfish/v1/SessionService/Sessions/{SessionId}
6.122.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| ClientOriginIPAddress (v1.3+) | string | read-only (null) |
The IP address of the client that created
the session.
|
| Context (v1.5+) | string | read-only (null) |
A client-supplied string that is stored
with the session.
|
| CreatedTime (v1.4+) | string (date-time) |
read-only (null) |
The date and time when the session was
created.
|
| Links (v1.7+) { | object | The links to other resources that are
related to this resource.
|
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| OutboundConnection (v1.7+) { | object | (null) |
The outbound connection associated with
this session.
|
| @odata.id | string | read-only | Link to a OutboundConnection resource. See the Links section and the OutboundConnection schema for details. |
| } | |||
| } | |||
| OemSessionType (v1.2+) | string | read-only (null) |
The active OEM-defined session
type.
|
| Password | string | read-only required on
create (null) |
The password for this session. The value
is null in responses.
|
| Roles (v1.7+) [ ] | array (string, null) | read-only | The Redfish roles that contain the
privileges of this session.
|
| SessionType (v1.2+) | string (enum) |
read-only (null) |
The active session type.
|
| Token (v1.6+) | string | read-only (null) |
The multi-factor authentication token for
this session. The value is null in responses.
|
| UserName | string | read-only required on
create (null) |
The username for the account for this
session.
|
6.122.4 Property details
6.122.4.1 SessionType
The active session type.
- This property shall represent the type of session that is currently active.
| string | Description |
|---|---|
| HostConsole | The host's console, which could be
connected through Telnet, SSH, or other protocol.
|
| IPMI | Intelligent Platform Management
Interface.
|
| KVMIP | A Keyboard-Video-Mouse over IP
session.
|
| ManagerConsole | The manager's console, which could be
connected through Telnet, SSH, SM CLP, or other protocol.
|
| OEM | OEM type. For OEM session types, see the
OemSessionType property.
|
| OutboundConnection (v1.7+) | A Redfish Specification-defined outbound
connection. See the 'Outbound connections' clause of the Redfish
Specification.
|
| Redfish | A Redfish session.
|
| VirtualMedia | Virtual media.
|
| WebUI | A non-Redfish web user interface session,
such as a graphical interface or another web-based protocol.
|
6.122.5 Example response
{
"@odata.type": "#Session.v1_7_0.Session",
"Id": "1234567890ABCDEF",
"Name": "User Session",
"Description": "Manager User Session",
"UserName": "Administrator",
"@odata.id": "/redfish/v1/SessionService/Sessions/1234567890ABCDEF"
}6.123 SessionService 1.1.8
| Version | v1.1 | v1.0 |
| Release | 2016.2 | 1.0 |
6.123.1 Description
The SessionService schema describes the session service and its properties, with links to the actual list of sessions.
- This resource contains the session service properties for a Redfish implementation.
6.123.2 URIs
/redfish/v1/SessionService
6.123.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| ServiceEnabled | boolean | read-write (null) |
An indication of whether this service is
enabled. If true, this service is enabled. If
false, it is disabled, and new sessions cannot be created,
old sessions cannot be deleted, and established sessions can continue
operating.
|
| Sessions { | object | The link to a collection of
sessions.
|
|
| @odata.id | string | read-only | Link to Collection of Session. See the Session schema for details. |
| } | |||
| SessionTimeout | integer (seconds) |
read-write | The number of seconds of inactivity that a
session can have before the session service closes the session due to
inactivity.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
6.123.4 Example response
{
"@odata.type": "#SessionService.v1_1_8.SessionService",
"Id": "SessionService",
"Name": "Session Service",
"Description": "Session Service",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"ServiceEnabled": true,
"SessionTimeout": 30,
"Sessions": {
"@odata.id": "/redfish/v1/SessionService/Sessions"
},
"@odata.id": "/redfish/v1/SessionService"
}6.124 Signature 1.0.2
| Version | v1.0 |
| Release | 2020.1 |
6.124.1 Description
The Signature schema describes a signature or a hash.
- This resource contains a signature for a Redfish implementation.
6.124.2 URIs
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/SecureBoot/SecureBootDatabases/{DatabaseId}/Signatures/{SignatureId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/SecureBoot/SecureBootDatabases/{DatabaseId}/Signatures/{SignatureId}
/redfish/v1/Systems/{ComputerSystemId}/SecureBoot/SecureBootDatabases/{DatabaseId}/Signatures/{SignatureId}
6.124.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| SignatureString | string | read-only required on
create (null) |
The string for the signature.
|
| SignatureType | string | read-only required on
create (null) |
The format of the signature.
|
| SignatureTypeRegistry | string (enum) |
read-only required on
create (null) |
The type of the signature.
|
| UefiSignatureOwner | string (uuid) |
read-only (null) |
The UEFI signature owner for this
signature.
([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}) |
6.124.4 Property details
6.124.4.1 SignatureTypeRegistry
The type of the signature.
- This property shall contain the type for the signature.
| string | Description |
|---|---|
| UEFI | A signature defined in the UEFI
Specification.
|
6.124.5 Example response
{
"@odata.type": "#Signature.v1_0_2.Signature",
"Id": "1",
"Name": "SHA256 Signature",
"SignatureString": "80B4D96931BF0D02FD91A61E19D14F1DA452E66DB2408CA8604D411F92659F0A",
"SignatureTypeRegistry": "UEFI",
"SignatureType": "EFI_CERT_SHA256_GUID",
"UefiSignatureOwner": "28d5e212-165b-4ca0-909b-c86b9cee0112",
"@odata.id": "/redfish/v1/Systems/1/SecureBoot/SecureBootDatabases/db/Signatures/1"
}6.125 SimpleStorage 1.3.1
| Version | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2020.3 | 2017.1 | 2016.1 | 1.0 |
6.125.1 Description
The SimpleStorage schema represents the properties of a storage controller and its directly-attached devices.
- This Resource contains a storage controller and its directly-attached devices.
6.125.2 URIs
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/SimpleStorage/{SimpleStorageId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/SimpleStorage/{SimpleStorageId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/SimpleStorage/{SimpleStorageId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/SimpleStorage/{SimpleStorageId}
/redfish/v1/Systems/{ComputerSystemId}/SimpleStorage/{SimpleStorageId}
6.125.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Devices [ { | array | The storage devices.
|
|
| CapacityBytes (v1.1+) | integer (bytes) |
read-only (null) |
The size, in bytes, of the storage
device.
|
| Manufacturer | string | read-only (null) |
The name of the manufacturer of this
device.
|
| Model | string | read-only (null) |
The product model number of this
device.
|
| Name | string | read-only required | The name of the Resource or array
member.
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| Status {} | object | The status and health of the Resource and
its subordinate or dependent Resources.
|
|
| } ] | |||
| Links (v1.2+) { | object | The links to other Resources that are
related to this Resource.
|
|
| Chassis (v1.2+) { | object | The link to the chassis that contains this
simple storage.
|
|
| @odata.id | string | read-only | Link to a Chassis resource. See the Links section and the Chassis schema for details. |
| } | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| Storage (v1.3+) { | object | The link to the storage instance that
corresponds to this simple storage.
|
|
| @odata.id | string | read-only | Link to a Storage resource. See the Links section and the Storage schema for details. |
| } | |||
| } | |||
| Status {} | object | The status and health of the Resource and
its subordinate or dependent Resources.
|
|
| UefiDevicePath | string | read-only (null) |
The UEFI device path to access this
storage controller.
|
6.125.4 Example response
{
"@odata.type": "#SimpleStorage.v1_3_1.SimpleStorage",
"Id": "1",
"Name": "Simple Storage Controller",
"Description": "System SATA",
"UefiDevicePath": "Acpi(PNP0A03,0)/Pci(1F|1)/Ata(Primary,Master)/HD(Part3, Sig00110011)",
"Status": {
"State": "Enabled",
"Health": "OK",
"HealthRollup": "Warning"
},
"Devices": [
{
"Name": "SATA Bay 1",
"Manufacturer": "Contoso",
"Model": "3000GT8",
"CapacityBytes": 8000000000000,
"Status": {
"State": "Enabled",
"Health": "OK"
}
},
{
"Name": "SATA Bay 2",
"Manufacturer": "Contoso",
"Model": "3000GT7",
"CapacityBytes": 4000000000000,
"Status": {
"State": "Enabled",
"Health": "Warning"
}
},
{
"Name": "SATA Bay 3",
"Status": {
"State": "Absent"
}
},
{
"Name": "SATA Bay 4",
"Status": {
"State": "Absent"
}
}
],
"@odata.id": "/redfish/v1/Systems/437XR1138R2/SimpleStorage/1"
}6.126 SoftwareInventory 1.10.0
| Version | v1.10 | v1.9 | v1.8 | v1.7 | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2023.2 | 2022.3 | 2022.2 | 2022.1 | 2021.4 | 2021.2 | 2020.4 | 2020.1 | 2018.1 | 2016.3 | 2016.2 |
6.126.1 Description
The SoftwareInventory schema contains an inventory of software components. This can include software components such as BIOS, BMC firmware, firmware for other devices, system drivers, or provider software.
- This Resource contains a single software component that this Redfish Service manages.
6.126.2 URIs
/redfish/v1/UpdateService/FirmwareInventory/{SoftwareInventoryId}
/redfish/v1/UpdateService/SoftwareInventory/{SoftwareInventoryId}
6.126.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AdditionalVersions (v1.7+) { | object | The additional versions of this
software.
|
|
| Bootloader (v1.7+) | string | read-only (null) |
The bootloader version contained in this
software, such as U-Boot or UEFI.
|
| Kernel (v1.7+) | string | read-only (null) |
The kernel version contained in this
software.
|
| Microcode (v1.7+) | string | read-only (null) |
The microcode version contained in this
software, such as processor microcode.
|
| Oem (v1.7+) {} | object | See the OEM object definition in the Using this guide clause. | |
| OSDistribution (v1.8+) | string | read-only (null) |
The operating system name of this
software.
|
| } | |||
| AssociatedPhysicalContext (v1.10+) | string (enum) |
read-only | The area or device to which the software
applies. Used to distinguish when different parts of a device have
different software components.
|
| LowestSupportedVersion (v1.1+) | string | read-only (null) |
The lowest supported version of this
software.
|
| Manufacturer (v1.2+) | string | read-only (null) |
The manufacturer or producer of this
software.
|
| Measurement (v1.4+, deprecated v1.6 { | object | A DSP0274-defined measurement
block.
|
|
| Measurement (v1.4+) | string | read-only (null) |
The hexadecimal string representation of
the numeric value of the DSP0274-defined Measurement field of the
measurement block.
^[0-9a-fA-F]+$ |
| MeasurementIndex (v1.5+) | integer | read-only (null) |
The DSP0274-defined Index field of the
measurement block.
|
| MeasurementSize (v1.4+) | integer | read-only (null) |
The DSP0274-defined MeasurementSize field
of the measurement block.
|
| MeasurementSpecification (v1.4+) | integer | read-only (null) |
The DSP0274-defined
MeasurementSpecification field of the measurement block.
|
| } | |||
| RelatedItem (v1.1+) [ { | array | The IDs of the Resources associated with
this software inventory item.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| ReleaseDate (v1.2+) | string (date-time) |
read-only (null) |
The release date of this
software.
|
| ReleaseType (v1.10+) | string (enum) |
read-only (null) |
The type of release.
|
| SoftwareId (v1.1+) | string | read-only | The implementation-specific label that
identifies this software.
|
| Status {} | object | The status and health of the Resource and
its subordinate or dependent Resources.
|
|
| UefiDevicePaths (v1.1+) [ ] | array (string, null) | read-only | The list of UEFI device paths of the
components associated with this software inventory item.
|
| Updateable | boolean | read-only (null) |
An indication of whether the Update
Service can update this software.
|
| Version | string | read-only (null) |
The version of this software.
|
| VersionScheme (v1.9+) | string (enum) |
read-only (null) |
The format of the version.
|
| WriteProtected (v1.3+) | boolean | read-write (null) |
Indicates if the software is
write-protected.
|
6.126.4 Property details
6.126.4.1 AssociatedPhysicalContext
The area or device to which the software applies. Used to distinguish when different parts of a device have different software components.
- This property shall contain a description of the physical context for the software inventory data.
| string | Description |
|---|---|
| Accelerator | An accelerator. |
| ACInput | An AC input. |
| ACMaintenanceBypassInput | An AC maintenance bypass input. |
| ACOutput | An AC output. |
| ACStaticBypassInput | An AC static bypass input. |
| ACUtilityInput | An AC utility input. |
| ASIC | An ASIC device, such as a networking chip or chipset component. |
| Back | The back of the chassis. |
| Backplane | A backplane within the chassis. |
| Battery | A battery. |
| Board | A circuit board.
|
| Chassis | The entire chassis. |
| ComputeBay | Within a compute bay. |
| CoolingSubsystem | The entire cooling, or air and liquid, subsystem. |
| CPU | A processor (CPU). |
| CPUSubsystem | The entire processor (CPU) subsystem. |
| DCBus | A DC bus. |
| Exhaust | The air exhaust point or points or region of the chassis. |
| ExpansionBay | Within an expansion bay. |
| Fan | A fan. |
| FPGA | An FPGA. |
| Front | The front of the chassis. |
| GPU | A graphics processor (GPU). |
| GPUSubsystem | The entire graphics processor (GPU) subsystem. |
| Intake | The air intake point or points or region of the chassis. |
| LiquidInlet | The liquid inlet point of the chassis. |
| LiquidOutlet | The liquid outlet point of the chassis. |
| Lower | The lower portion of the chassis. |
| Memory | A memory device. |
| MemorySubsystem | The entire memory subsystem. |
| Motor | A motor. |
| NetworkBay | Within a networking bay. |
| NetworkingDevice | A networking device. |
| PowerSubsystem | The entire power subsystem. |
| PowerSupply | A power supply. |
| PowerSupplyBay | Within a power supply bay. |
| Pump | A pump. |
| Rectifier | A rectifier device. |
| Room | The room. |
| StorageBay | Within a storage bay. |
| StorageDevice | A storage device. |
| SystemBoard | The system board (PCB). |
| Transceiver | A transceiver.
|
| Transformer | A transformer. |
| TrustedModule | A trusted module. |
| Upper | The upper portion of the chassis. |
| VoltageRegulator | A voltage regulator device. |
6.126.4.2 ReleaseType
The type of release.
- This property shall describe the type of release for the software.
| string | Description |
|---|---|
| Other | The Redfish service does not have enough
data to make a determination about this release.
|
| Production | This release is ready for use in
production environments.
|
| Prototype | This release is intended for development
or internal use.
|
6.126.4.3 VersionScheme
The format of the version.
- This property shall describe the scheme used to format the value of the Version property.
| string | Description |
|---|---|
| DotIntegerNotation | Version formatted as dot-separated
integers.
|
| OEM | Version follows OEM-defined
format.
|
| SemVer | Version follows Semantic Versioning 2.0
rules.
|
6.126.5 Example response
{
"@odata.type": "#SoftwareInventory.v1_10_0.SoftwareInventory",
"Id": "BMC",
"Name": "Contoso BMC Firmware",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Updateable": true,
"Manufacturer": "Contoso",
"ReleaseDate": "2017-08-22T12:00:00",
"Version": "1.45.455b66-rev4",
"SoftwareId": "1624A9DF-5E13-47FC-874A-DF3AFF143089",
"LowestSupportedVersion": "1.30.367a12-rev1",
"UefiDevicePaths": [
"BMC(0x1,0x0ABCDEF)"
],
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Managers/1"
}
],
"@odata.id": "/redfish/v1/UpdateService/FirmwareInventory/BMC"
}6.127 Storage 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 | 2023.1 | 2022.3 | 2022.1 | 2021.4 | 2021.2 | 2020.4 | 2020.3 | 2019.3 | 2019.1 | 2018.3 | 2018.2 | ... |
6.127.1 Description
The Storage schema defines a storage subsystem and its respective properties. A storage subsystem represents a set of physical or virtual storage controllers and the resources, such as volumes, that can be accessed from that subsystem.
- This resource shall represent a storage subsystem in the Redfish Specification.
6.127.2 URIs
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}
/redfish/v1/Storage/{StorageId}
/redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}
6.127.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AutoVolumeCreate (v1.15+) | string (enum) |
read-write (null) |
Indicates if this storage subsystem
automatically create new volumes for unassigned drives.
|
| Connections (v1.15+) { | object | The collection of links to the connections
that this storage subsystem contains.
|
|
| @odata.id | string | read-only | Link to Collection of Connection. See the Connection schema for details. |
| } | |||
| ConsistencyGroups (v1.8+) {} | object | The consistency groups, each of which
contains a set of volumes that are treated by an application or set of
applications as a single resource, that are managed by this storage
subsystem.
|
|
| Controllers (v1.9+) { | object | The set of controllers instantiated by
this storage subsystem.
|
|
| @odata.id | string | read-only | Link to Collection of StorageController. See the StorageController schema for details. |
| } | |||
| Drives [ { | array | The set of drives attached to the storage
controllers that this resource represents.
|
|
| @odata.id | string | read-only | Link to a Drive resource. See the Links section and the Drive schema for details. |
| } ] | |||
| EncryptionMode (v1.14+) | string (enum) |
read-write (null) |
The encryption mode of this storage
subsystem.
|
| EndpointGroups (v1.8+) { | object | All of the endpoint groups, each of which
contains a set of endpoints that are used for a common purpose such as
an ACL or logical identification, that belong to this storage
subsystem.
|
|
| @odata.id | string | read-only | Link to Collection of EndpointGroup. See the EndpointGroup schema for details. |
| } | |||
| FileSystems (v1.8+) {} | object | All file systems that are allocated by
this storage subsystem.
|
|
| HotspareActivationPolicy (v1.14+) | string (enum) |
read-write (null) |
The policy under which hot spare drives in
this storage domain will activate.
|
| Identifiers (v1.9+) [ { } ] | array (object) | Any additional identifiers for a
resource.
|
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| Enclosures [ { | array | An array of links to the chassis to which
this storage subsystem is attached.
|
|
| @odata.id | string | read-only | Link to a Chassis resource. See the Links section and the Chassis schema for details. |
| } ] | |||
| HostingStorageSystems (v1.11+) [ { | array | The storage systems that host this storage
subsystem.
|
|
| @odata.id | string | read-only | Link to a ComputerSystem resource. See the Links section and the ComputerSystem schema for details. |
| } ] | |||
| NVMeoFDiscoverySubysystems (v1.15+) [ { | array | An array of links to the discovery
subsystems that discovered this subsystem in an NVMe-oF
environment.
|
|
| @odata.id | string | read-only | Link to another Storage resource. |
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| SimpleStorage (v1.9+) { | object | The link to the simple storage instance
that corresponds to this storage.
|
|
| @odata.id | string | read-only | Link to a SimpleStorage resource. See the Links section and the SimpleStorage schema for details. |
| } | |||
| StorageServices (v1.9+) [ { | array | An array of links to the storage services
that connect to this storage subsystem.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| } | |||
| LocalEncryptionKeyIdentifier (v1.14+) | string | read-only (null) |
The local encryption key identifier used
by the storage subsystem.
|
| Redundancy [ { } ] | array (object) | The common redundancy definition and
structure used in other Redfish schemas.
|
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| StorageControllers (deprecated v1.13) [ { | array | The set of storage controllers that this
resource represents.
|
|
| @odata.id | string (URI) |
read-only required | The unique identifier for a
resource.
|
| Actions (v1.2+) {} | object | The available actions for this
resource.
|
|
| Assembly (v1.4+) { | object | The link to the assembly associated with
this storage controller.
|
|
| @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
storage controller.
|
| CacheSummary (v1.5+) { | object | The cache memory of the storage controller
in general detail.
|
|
| PersistentCacheSizeMiB (v1.5+) | integer (mebibytes) |
read-only (null) |
The portion of the cache memory that is
persistent, measured in MiB.
|
| Status (v1.5+) {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| TotalCacheSizeMiB (v1.5+) | integer (mebibytes) |
read-only required (null) |
The total configured cache memory,
measured in MiB.
|
| } | |||
| Certificates (v1.10+) { | object | The link to a collection of certificates
for device identity and attestation.
|
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| ControllerRates (v1.7+) { | object | This property describes the various
controller rates used for processes such as volume rebuild or
consistency checks.
|
|
| ConsistencyCheckRatePercent (v1.7+) | integer | read-write (null) |
The percentage of controller resources
used for performing a data consistency check on volumes.
|
| RebuildRatePercent (v1.7+) | integer | read-write (null) |
The percentage of controller resources
used for rebuilding/repairing volumes.
|
| TransformationRatePercent (v1.7+) | integer | read-write (null) |
The percentage of controller resources
used for transforming volumes from one configuration to
another.
|
| } | |||
| FirmwareVersion | string | read-only (null) |
The firmware version of this storage
controller.
|
| Identifiers [ { } ] | array (object) | Any additional identifiers for a
resource.
|
|
| Links (v1.1+) { | object | The links to other resources that are
related to this resource.
|
|
| Endpoints (v1.1+) [ { | array | An array of links to the endpoints that
connect to this controller.
|
|
| @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 Using this guide clause. | |
| PCIeFunctions (v1.7+) [ { | array | An array of links to the PCIe functions
that the storage controller produces.
|
|
| @odata.id | string | read-only | Link to a PCIeFunction resource. See the Links section and the PCIeFunction schema for details. |
| } ] | |||
| StorageServices (v1.4+, deprecated v1.9 [ { | array | An array of links to the storage services
that connect to this controller.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| } | |||
| Location (v1.4+) {} | object | The location of the storage
controller.
|
|
| Manufacturer | string | read-only (null) |
The manufacturer of this storage
controller.
|
| Measurements (v1.10+, deprecated 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. |
| } ] | |||
| MemberId | string | read-only required | The unique identifier for the member
within an array.
|
| Model | string | read-only (null) |
The model number for the storage
controller.
|
| Name (v1.3+) | string | read-only (null) |
The name of the storage
controller.
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| PartNumber | string | read-only (null) |
The part number for this storage
controller.
|
| PCIeInterface (v1.5+) { | object | The PCIe interface details for this
controller.
|
|
| LanesInUse (v1.3+) | integer | read-only (null) |
The number of PCIe lanes in use by this
device.
|
| MaxLanes (v1.3+) | integer | read-only (null) |
The number of PCIe lanes supported by this
device.
|
| MaxPCIeType (v1.3+) | string (enum) |
read-only (null) |
The highest version of the PCIe
specification supported by this device.
|
| Oem (v1.3+) {} | object | See the OEM object definition in the Using this guide clause. | |
| PCIeType (v1.3+) | string (enum) |
read-only (null) |
The version of the PCIe specification in
use by this device.
|
| } | |||
| Ports (v1.7+) { | object | The link to the collection of ports that
exist on the storage controller.
|
|
| @odata.id | string | read-only | Link to Collection of Port. See the Port schema for details. |
| } | |||
| SerialNumber | string | read-only (null) |
The serial number for this storage
controller.
|
| SKU | string | read-only (null) |
The SKU for this storage
controller.
|
| SpeedGbps | number (Gbit/s) |
read-only (null) |
The maximum speed of the storage
controller's device interface.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| SupportedControllerProtocols [ ] | array (string (enum)) |
read-only |
|
| SupportedDeviceProtocols [ ] | array (string (enum)) |
read-only |
|
| SupportedRAIDTypes (v1.6+) [ ] | array (string (enum)) |
read-only (null) |
|
| } ] | |||
| StorageGroups (v1.8+, deprecated v1.15 {} | object | All of the storage groups, each of which
contains a set of volumes and endpoints that are managed as a group for
mapping and masking, that belong to this storage subsystem.
|
|
| StoragePools (v1.8+) {} | object | The set of all storage pools that are
allocated by this storage subsystem. A storage pool is the set of
storage capacity that can be used to produce volumes or other storage
pools.
|
|
| Volumes {} | object | The set of volumes that the storage
controllers produce.
|
6.127.4 Actions
6.127.4.1 ResetToDefaults (v1.11+)
Description
The reset action resets the storage device to factory defaults. This can cause the loss of data.
- This action shall reset the storage device. This action can impact other resources.
Action URI
{Base URI of target resource}/Actions/Storage.ResetToDefaults
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| ResetType | string (enum) |
required | The type of reset to defaults.
|
Request Example
{
"ResetType": "ResetAll"
}6.127.4.2 SetEncryptionKey
Description
This action sets the local encryption key for the storage subsystem.
- This action shall set the local encryption key for the storage subsystem.
Action URI
{Base URI of target resource}/Actions/Storage.SetEncryptionKey
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| CurrentEncryptionKey (v1.14+) | string | optional | The current local encryption key on the
storage subsystem.
|
| EncryptionKey | string | required | The local encryption key to set on the
storage subsystem.
|
| EncryptionKeyIdentifier (v1.14+) | string | optional | The local encryption key identifier used
by the storage subsystem.
|
Request Example
{
"EncryptionKey": "566b523d3f955a7fba38a28ec708ca10"
}6.127.5 Property details
6.127.5.1 AutoVolumeCreate
Indicates if this storage subsystem automatically create new volumes for unassigned drives.
- This property shall indicate if volumes are created automatically for each unassigned drive attached to this storage subsystem.
| string | Description |
|---|---|
| Disabled | Do not automatically create volumes. |
| NonRAID | Automatically create non-RAID volumes. |
| RAID0 | Automatically create RAID0 volumes. |
| RAID1 | Automatically create RAID1 volumes. |
6.127.5.2 EncryptionMode
The encryption mode of this storage subsystem.
- This property shall contain the encryption mode of this storage subsystem.
| string | Description |
|---|---|
| Disabled | Encryption is disabled on the storage subsystem. |
| UseExternalKey | The storage subsystem uses one or more external keys for encryption. |
| UseLocalKey | The storage subsystem uses a local key for encryption. |
6.127.5.3 HotspareActivationPolicy
The policy under which hot spare drives in this storage domain will activate.
- This property shall contain the policy under which all drives operating as hot spares in this storage domain will activate.
| string | Description |
|---|---|
| OEM | The hot spare drive will take over for the original drive in an algorithm custom to the OEM. |
| OnDriveFailure | The hot spare drive will take over for the original drive when the original drive has been marked as failed by the storage domain. |
| OnDrivePredictedFailure | The hot spare drive will take over for the original drive when the original drive has been predicted to fail in the future by the storage domain. |
6.127.5.4 idRef
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
6.127.5.5 MaxPCIeType
The highest version of the PCIe specification supported by this device.
- This property shall contain the maximum PCIe specification that this device supports.
| string | Description |
|---|---|
| Gen1 | A PCIe v1.0 slot. |
| Gen2 | A PCIe v2.0 slot. |
| Gen3 | A PCIe v3.0 slot. |
| Gen4 | A PCIe v4.0 slot. |
| Gen5 | A PCIe v5.0 slot. |
6.127.5.6 PCIeType
The version of the PCIe specification in use by this device.
- This property shall contain the negotiated PCIe interface version in use by this device.
| string | Description |
|---|---|
| Gen1 | A PCIe v1.0 slot. |
| Gen2 | A PCIe v2.0 slot. |
| Gen3 | A PCIe v3.0 slot. |
| Gen4 | A PCIe v4.0 slot. |
| Gen5 | A PCIe v5.0 slot. |
6.127.5.7 ResetType
The type of reset to defaults.
- This parameter shall contain the type of reset to defaults.
| string | Description |
|---|---|
| PreserveVolumes | Reset all settings to factory defaults but preserve the configured volumes on the controllers. |
| ResetAll | Reset all settings to factory defaults and remove all volumes. |
6.127.5.8 SupportedControllerProtocols
- The supported set of protocols for communicating to this storage controller.
- This property shall contain the supported set of protocols for communicating to this storage controller.
| string | Description |
|---|---|
| AHCI | Advanced Host Controller Interface
(AHCI).
|
| CXL | Compute Express Link.
|
| 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.
|
| QPI | Intel QuickPath Interconnect
(QPI).
|
| 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).
|
| UPI | Intel UltraPath Interconnect
(UPI).
|
| USB | Universal Serial Bus (USB).
|
| VGA | VGA.
|
6.127.5.9 SupportedDeviceProtocols
- The protocols that the storage controller can use to communicate with attached devices.
- This property shall contain the set of protocols this storage controller can use to communicate with attached devices.
| string | Description |
|---|---|
| AHCI | Advanced Host Controller Interface
(AHCI).
|
| CXL | Compute Express Link.
|
| 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.
|
| QPI | Intel QuickPath Interconnect
(QPI).
|
| 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).
|
| UPI | Intel UltraPath Interconnect
(UPI).
|
| USB | Universal Serial Bus (USB).
|
| VGA | VGA.
|
6.127.5.10 SupportedRAIDTypes
- The set of RAID types supported by the storage controller.
- This property shall contain an array of all the RAID types supported by this controller.
| string | Description |
|---|---|
| None | A placement policy with no redundancy at the device level. |
| RAID0 | A placement policy where consecutive
logical blocks of data are uniformly distributed across a set of
independent storage devices without offering any form of
redundancy.
|
| RAID00 | A placement policy that creates a RAID 0
stripe set over two or more RAID 0 sets.
|
| RAID01 | A data placement policy that creates a
mirrored device (RAID 1) over a set of striped devices (RAID
0).
|
| RAID1 | A placement policy where each logical
block of data is stored on more than one independent storage
device.
|
| RAID10 | A placement policy that creates a striped
device (RAID 0) over a set of mirrored devices (RAID 1).
|
| RAID10E | A placement policy that uses a RAID 0
stripe set over two or more RAID 10 sets.
|
| RAID10Triple | A placement policy that uses a striped
device (RAID 0) over a set of triple mirrored devices (RAID
1Triple).
|
| RAID1E | A placement policy that uses a form of
mirroring implemented over a set of independent storage devices where
logical blocks are duplicated on a pair of independent storage devices
so that data is uniformly distributed across the storage
devices.
|
| RAID1Triple | A placement policy where each logical
block of data is mirrored three times across a set of three independent
storage devices.
|
| RAID3 | A placement policy using parity-based
protection where logical bytes of data are uniformly distributed across
a set of independent storage devices and where the parity is stored on a
dedicated independent storage device.
|
| RAID4 | A placement policy using parity-based
protection where logical blocks of data are uniformly distributed across
a set of independent storage devices and where the parity is stored on a
dedicated independent storage device.
|
| RAID5 | A placement policy using parity-based
protection for storing stripes of 'n' logical blocks of data and one
logical block of parity across a set of 'n+1' independent storage
devices where the parity and data blocks are interleaved across the
storage devices.
|
| RAID50 | A placement policy that uses a RAID 0
stripe set over two or more RAID 5 sets of independent storage
devices.
|
| RAID6 | A placement policy using parity-based
protection for storing stripes of 'n' logical blocks of data and two
logical blocks of independent parity across a set of 'n+2' independent
storage devices where the parity and data blocks are interleaved across
the storage devices.
|
| RAID60 | A placement policy that uses a RAID 0
stripe set over two or more RAID 6 sets of independent storage
devices.
|
| RAID6TP | A placement policy that uses parity-based
protection for storing stripes of 'n' logical blocks of data and three
logical blocks of independent parity across a set of 'n+3' independent
storage devices where the parity and data blocks are interleaved across
the storage devices.
|
6.127.6 Example response
{
"@odata.type": "#Storage.v1_15_0.Storage",
"Id": "1",
"Name": "Local Storage Controller",
"Description": "Integrated RAID Controller",
"Status": {
"State": "Enabled",
"Health": "OK",
"HealthRollup": "OK"
},
"StorageControllers": [
{
"@odata.id": "/redfish/v1/Systems/437XR1138R2/Storage/1#/StorageControllers/0",
"MemberId": "0",
"Name": "Contoso Integrated RAID",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Identifiers": [
{
"DurableNameFormat": "NAA",
"DurableName": "345C59DBD970859C"
}
],
"Manufacturer": "Contoso",
"Model": "12Gbs Integrated RAID",
"SerialNumber": "2M220100SL",
"PartNumber": "CT18754",
"SpeedGbps": 12,
"FirmwareVersion": "1.0.0.7",
"SupportedControllerProtocols": [
"PCIe"
],
"SupportedDeviceProtocols": [
"SAS",
"SATA"
]
}
],
"Drives": [
{
"@odata.id": "/redfish/v1/Systems/437XR1138R2/Storage/1/Drives/35D38F11ACEF7BD3"
},
{
"@odata.id": "/redfish/v1/Systems/437XR1138R2/Storage/1/Drives/3F5A8C54207B7233"
},
{
"@odata.id": "/redfish/v1/Systems/437XR1138R2/Storage/1/Drives/32ADF365C6C1B7BD"
},
{
"@odata.id": "/redfish/v1/Systems/437XR1138R2/Storage/1/Drives/3D58ECBC375FD9F2"
}
],
"Volumes": {
"@odata.id": "/redfish/v1/Systems/437XR1138R2/Storage/1/Volumes"
},
"Actions": {
"#Storage.SetEncryptionKey": {
"target": "/redfish/v1/Systems/437XR1138R2/Storage/1/Actions/Storage.SetEncryptionKey"
}
},
"@odata.id": "/redfish/v1/Systems/437XR1138R2/Storage/1"
}6.128 StorageController 1.7.1
| Version | v1.7 | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2023.1 | 2022.1 | 2021.4 | 2021.3 | 2021.2 | 2021.1 | 2020.4 | 2020.3 |
6.128.1 Description
The StorageController schema describes a storage controller and its properties. A storage controller represents a physical or virtual storage device that produces volumes.
- This resource shall represent a storage controller in the Redfish Specification.
6.128.2 URIs
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Controllers/{ControllerId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Controllers/{ControllerId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Controllers/{ControllerId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Controllers/{ControllerId}
/redfish/v1/Storage/{StorageId}/Controllers/{ControllerId}
/redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/Controllers/{ControllerId}
6.128.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Assembly { | object | The link to the assembly associated with
this storage controller.
|
|
| @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
storage controller.
|
| CacheSummary { | object | The cache memory of the storage controller
in general detail.
|
|
| PersistentCacheSizeMiB | integer (mebibytes) |
read-only (null) |
The portion of the cache memory that is
persistent, measured in MiB.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| TotalCacheSizeMiB | integer (mebibytes) |
read-only required (null) |
The total configured cache memory,
measured in MiB.
|
| } | |||
| Certificates (v1.1+) { | object | The link to a collection of certificates
for device identity and attestation.
|
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| ControllerRates { | object | This property describes the various
controller rates used for processes such as volume rebuild or
consistency checks.
|
|
| ConsistencyCheckRatePercent | integer (%) |
read-write (null) |
The percentage of controller resources
used for performing a data consistency check on volumes.
|
| RebuildRatePercent | integer (%) |
read-write (null) |
The percentage of controller resources
used for rebuilding/repairing volumes.
|
| TransformationRatePercent | integer (%) |
read-write (null) |
The percentage of controller resources
used for transforming volumes from one configuration to
another.
|
| } | |||
| EnvironmentMetrics (v1.2+) { | object | The link to the environment metrics for
this storage controller.
|
|
| @odata.id | string | read-only | Link to a EnvironmentMetrics resource. See the Links section and the EnvironmentMetrics schema for details. |
| } | |||
| FirmwareVersion | string | read-only (null) |
The firmware version of this storage
controller.
|
| Identifiers [ { } ] | array (object) | Any additional identifiers for a
resource.
|
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| AttachedVolumes [ { | array | An array of links to volumes that are
attached to this controller instance.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| Batteries (v1.6+) [ { | array | The batteries that provide power to this
storage controller during a power loss event.
|
|
| @odata.id | string | read-only | Link to a Battery resource. See the Links section and the Battery schema for details. |
| } ] | |||
| Endpoints [ { | array | An array of links to the endpoints that
connect to this controller.
|
|
| @odata.id | string | read-only | Link to a Endpoint resource. See the Links section and the Endpoint schema for details. |
| } ] | |||
| NetworkDeviceFunctions (v1.3+) [ { | array | The network device functions that provide
connectivity to this controller.
|
|
| @odata.id | string | read-only | Link to a NetworkDeviceFunction resource. See the Links section and the NetworkDeviceFunction schema for details. |
| } ] | |||
| NVMeDiscoveredSubsystems (v1.7+) [ { | array | The NVMe subsystems discovered by this
discovery controller.
|
|
| @odata.id | string | read-only | Link to a Storage resource. See the Links section and the Storage schema for details. |
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| PCIeFunctions [ { | array | An array of links to the PCIe functions
that the storage controller produces.
|
|
| @odata.id | string | read-only | Link to a PCIeFunction resource. See the Links section and the PCIeFunction schema for details. |
| } ] | |||
| } | |||
| Location {} | object | The location of the storage
controller.
|
|
| Manufacturer | string | read-only (null) |
The manufacturer of this storage
controller.
|
| Measurements (v1.1+, deprecated v1.5 [ { | 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. |
| } ] | |||
| Metrics (v1.7+) { | object | (null) |
The link to the metrics associated with
this storage controller.
|
| @odata.id | string | read-only | Link to a StorageControllerMetrics resource. See the Links section and the StorageControllerMetrics schema for details. |
| } | |||
| Model | string | read-only (null) |
The model number for the storage
controller.
|
| NVMeControllerProperties { | object | The NVMe related properties for this
storage controller.
|
|
| AllocatedCompletionQueues (v1.4+) | integer | read-only (null) |
The number of I/O completion queues
allocated to this NVMe I/O controller.
|
| AllocatedSubmissionQueues (v1.4+) | integer | read-only (null) |
The number of I/O submission queues
allocated to this NVMe I/O controller.
|
| ANACharacteristics [ { | array | The ANA characteristics and volume
information.
|
|
| AccessState | string (enum) |
read-only (null) |
Reported ANA access state.
|
| Volume { | object | The specified volume.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } | |||
| } ] | |||
| ControllerType | string (enum) |
read-only (null) |
The type of NVMe controller.
|
| MaxQueueSize | integer | read-only (null) |
The maximum individual queue size that an
NVMe IO controller supports.
|
| NVMeControllerAttributes { | object | (null) |
The NVMe controller
attributes.
|
| ReportsNamespaceGranularity | boolean | read-only (null) |
Indicates whether or not the controller
supports reporting of Namespace Granularity.
|
| ReportsUUIDList | boolean | read-only (null) |
Indicates whether or not the controller
supports reporting of a UUID list.
|
| Supports128BitHostId | boolean | read-only (null) |
Indicates whether or not the controller
supports a 128-bit Host Identifier.
|
| SupportsEnduranceGroups | boolean | read-only (null) |
Indicates whether or not the controller
supports Endurance Groups.
|
| SupportsExceedingPowerOfNonOperationalState | boolean | read-only (null) |
Indicates whether or not the controller
supports exceeding Power of Non-Operational State in order to execute
controller initiated background operations in a non-operational power
state.
|
| SupportsNVMSets | boolean | read-only (null) |
Indicates whether or not the controller
supports NVM Sets.
|
| SupportsPredictableLatencyMode | boolean | read-only (null) |
Indicates whether or not the controller
supports Predictable Latency Mode.
|
| SupportsReadRecoveryLevels | boolean | read-only (null) |
Indicates whether or not the controller
supports Read Recovery Levels.
|
| SupportsReservations (v1.2+) | boolean | read-only (null) |
Indicates if the controller supports
reservations.
|
| SupportsSQAssociations | boolean | read-only (null) |
Indicates whether or not the controller
supports SQ Associations.
|
| SupportsTrafficBasedKeepAlive | boolean | read-only (null) |
Indicates whether or not the controller
supports restarting Keep Alive Timer if traffic is processed from an
admin command or IO during a Keep Alive Timeout interval.
|
| } | |||
| NVMeSMARTCriticalWarnings { | object | (null) |
The NVMe SMART Critical Warnings for this
storage controller. This property contains possible triggers for the
predictive drive failure warning for the corresponding
drive.
|
| MediaInReadOnly | boolean | read-only (null) |
Indicates the media has been placed in
read only mode.
|
| OverallSubsystemDegraded | boolean | read-only (null) |
Indicates that the NVM subsystem
reliability has been compromised.
|
| PMRUnreliable | boolean | read-only (null) |
The Persistent Memory Region has become
unreliable.
|
| PowerBackupFailed | boolean | read-only (null) |
Indicates that the volatile memory backup
device has failed.
|
| SpareCapacityWornOut | boolean | read-only (null) |
Indicates that the available spare
capacity has fallen below the threshold.
|
| } | |||
| NVMeVersion | string | read-only (null) |
The version of the NVMe Base Specification
supported.
|
| } | |||
| PartNumber | string | read-only (null) |
The part number for this storage
controller.
|
| PCIeInterface { | object | The PCIe interface details for this
controller.
|
|
| LanesInUse (v1.3+) | integer | read-only (null) |
The number of PCIe lanes in use by this
device.
|
| MaxLanes (v1.3+) | integer | read-only (null) |
The number of PCIe lanes supported by this
device.
|
| MaxPCIeType (v1.3+) | string (enum) |
read-only (null) |
The highest version of the PCIe
specification supported by this device.
|
| Oem (v1.3+) {} | object | See the OEM object definition in the Using this guide clause. | |
| PCIeType (v1.3+) | string (enum) |
read-only (null) |
The version of the PCIe specification in
use by this device.
|
| } | |||
| Ports { | object | The link to the collection of ports that
exist on the storage controller.
|
|
| @odata.id | string | read-only | Link to Collection of Port. See the Port schema for details. |
| } | |||
| SerialNumber | string | read-only (null) |
The serial number for this storage
controller.
|
| SKU | string | read-only (null) |
The SKU for this storage
controller.
|
| SpeedGbps | number (Gbit/s) |
read-only (null) |
The maximum speed of the storage
controller's device interface.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| SupportedControllerProtocols [ ] | array (string (enum)) |
read-only |
|
| SupportedDeviceProtocols [ ] | array (string (enum)) |
read-only |
|
| SupportedRAIDTypes [ ] | array (string (enum)) |
read-only (null) |
|
6.128.4 Actions
6.128.4.1 AttachNamespaces (v1.7+)
Description
This action attaches referenced namespaces to the storage controller. Attached namespaces are added to the AttachedVolumes property in Links.
- This action shall attach referenced namespaces to the storage controller. Services shall add the attached namespaces to the AttachedVolumes property in Links.
Action URI
{Base URI of target resource}/Actions/StorageController.AttachNamespaces
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| Namespaces [ { | array | required | The namespaces to attach to the storage
controller.
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] |
Response Payload
| { | |||
| AttachedVolumes (v1.7+) [ { | array | required | An array of links to volumes that are
attached to this controller instance.
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| } |
Request Example
{
"Namespaces": [
{
"@odata.id": "/redfish/v1/Systems/1/Storage/NVMe/Volumes/Namespace5"
}
]
}Response Example
{
"Volumes": [
{
"@odata.id": "/redfish/v1/Systems/1/Storage/NVMe/Volumes/Namespace1"
},
{
"@odata.id": "/redfish/v1/Systems/1/Storage/NVMe/Volumes/Namespace2"
},
{
"@odata.id": "/redfish/v1/Systems/1/Storage/NVMe/Volumes/Namespace5"
}
]
}6.128.4.2 DetachNamespaces (v1.7+)
Description
This action detaches referenced namespaces from the storage controller. Detached namespaces are removed from the AttachedVolumes property in Links.
- This action shall detach referenced namespaces from the storage controller. Services shall remove the detached namespaces from the AttachedVolumes property in Links.
Action URI
{Base URI of target resource}/Actions/StorageController.DetachNamespaces
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| Namespaces [ { | array | required | The namespaces to detach from the storage
controller.
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] |
Response Payload
| { | |||
| AttachedVolumes (v1.7+) [ { | array | required | An array of links to volumes that are
attached to this controller instance.
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| } |
Request Example
{
"Namespaces": [
{
"@odata.id": "/redfish/v1/Systems/1/Storage/NVMe/Volumes/Namespace5"
}
]
}Response Example
{
"Volumes": [
{
"@odata.id": "/redfish/v1/Systems/1/Storage/NVMe/Volumes/Namespace1"
},
{
"@odata.id": "/redfish/v1/Systems/1/Storage/NVMe/Volumes/Namespace2"
}
]
}6.128.4.3 SecurityReceive (v1.7+)
Description
This action transfers security protocol data from the controller. The data transferred from the controller contains the status and data result of one or more SecuritySend action requests that were previously submitted to the controller.
- This action shall transfer security protocol data from the controller. The contents of the request are specified by the 'SECURITY PROTOCOL IN command' section of the SPC-5 Specification.
Action URI
{Base URI of target resource}/Actions/StorageController.SecurityReceive
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| AllocationLength | integer | required | Allocated size for received
data.
|
| SecurityProtocol | integer | required | The security protocol number.
|
| SecurityProtocolSpecific | integer | required | The security protocol-specific
parameter.
|
Response Payload
| { | |||
| Data (v1.7+) | string | read-only | The Base64-encoded security protocol
data.
|
| } |
Request Example
{
"SecurityProtocol": 2,
"SecurityProtocolSpecific": 4100,
"AllocationLength": 48
}Response Example
{
"Data": "EAQAAAAAAAEAAAAiAAAAAgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
}6.128.4.4 SecuritySend (v1.7+)
Description
This action transfers security protocol data to the controller. The data transferred to the controller contains security protocol-specific commands to be performed by the controller.
- This action shall transfer security protocol data to the controller. The contents of the request are specified by the 'SECURITY PROTOCOL OUT command' section of the SPC-5 Specification.
Action URI
{Base URI of target resource}/Actions/StorageController.SecuritySend
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| Data | string | required | The data to transfer.
|
| SecurityProtocol | integer | required | The security protocol number.
|
| SecurityProtocolSpecific | integer | required | The security protocol-specific
parameter.
|
Request Example
{
"SecurityProtocol": 2,
"SecurityProtocolSpecific": 4100,
"Data": "EAQAAAAAAAE="
}6.128.5 Property details
6.128.5.1 AccessState
Reported ANA access state.
- This property shall contain the reported ANA access state.
| string | Description |
|---|---|
| Inaccessible | Namespaces in this group are inaccessible. Commands are not able to access user data of namespaces in the ANA Group. |
| NonOptimized | Commands processed by a controller that reports this state for an ANA Group provide non-optimized access characteristics, such as lower performance or non-optimal use of subsystem resources, to any namespace in the ANA Group. |
| Optimized | Commands processed by a controller provide optimized access to any namespace in the ANA group. |
| PersistentLoss | The group is persistently inaccessible. Commands are persistently not able to access user data of namespaces in the ANA Group. |
6.128.5.2 ControllerType
The type of NVMe controller.
- This property shall contain the type of NVMe controller.
| string | Description |
|---|---|
| Admin | The NVMe controller is an admin controller. |
| Discovery | The NVMe controller is a discovery controller. |
| IO | The NVMe controller is an IO controller. |
6.128.5.3 MaxPCIeType
The highest version of the PCIe specification supported by this device.
- This property shall contain the maximum PCIe specification that this device supports.
| string | Description |
|---|---|
| Gen1 | A PCIe v1.0 slot. |
| Gen2 | A PCIe v2.0 slot. |
| Gen3 | A PCIe v3.0 slot. |
| Gen4 | A PCIe v4.0 slot. |
| Gen5 | A PCIe v5.0 slot. |
6.128.5.4 PCIeType
The version of the PCIe specification in use by this device.
- This property shall contain the negotiated PCIe interface version in use by this device.
| string | Description |
|---|---|
| Gen1 | A PCIe v1.0 slot. |
| Gen2 | A PCIe v2.0 slot. |
| Gen3 | A PCIe v3.0 slot. |
| Gen4 | A PCIe v4.0 slot. |
| Gen5 | A PCIe v5.0 slot. |
6.128.5.5 SupportedControllerProtocols
- The supported set of protocols for communicating to this storage controller.
- This property shall contain the supported set of protocols for communicating to this storage controller.
| string | Description |
|---|---|
| AHCI | Advanced Host Controller Interface
(AHCI).
|
| CXL | Compute Express Link.
|
| 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.
|
| QPI | Intel QuickPath Interconnect
(QPI).
|
| 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).
|
| UPI | Intel UltraPath Interconnect
(UPI).
|
| USB | Universal Serial Bus (USB).
|
| VGA | VGA.
|
6.128.5.6 SupportedDeviceProtocols
- The protocols that the storage controller can use to communicate with attached devices.
- This property shall contain the set of protocols this storage controller can use to communicate with attached devices.
| string | Description |
|---|---|
| AHCI | Advanced Host Controller Interface
(AHCI).
|
| CXL | Compute Express Link.
|
| 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.
|
| QPI | Intel QuickPath Interconnect
(QPI).
|
| 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).
|
| UPI | Intel UltraPath Interconnect
(UPI).
|
| USB | Universal Serial Bus (USB).
|
| VGA | VGA.
|
6.128.5.7 SupportedRAIDTypes
- The set of RAID types supported by the storage controller.
- This property shall contain an array of all the RAID types supported by this controller.
| string | Description |
|---|---|
| None | A placement policy with no redundancy at the device level. |
| RAID0 | A placement policy where consecutive
logical blocks of data are uniformly distributed across a set of
independent storage devices without offering any form of
redundancy.
|
| RAID00 | A placement policy that creates a RAID 0
stripe set over two or more RAID 0 sets.
|
| RAID01 | A data placement policy that creates a
mirrored device (RAID 1) over a set of striped devices (RAID
0).
|
| RAID1 | A placement policy where each logical
block of data is stored on more than one independent storage
device.
|
| RAID10 | A placement policy that creates a striped
device (RAID 0) over a set of mirrored devices (RAID 1).
|
| RAID10E | A placement policy that uses a RAID 0
stripe set over two or more RAID 10 sets.
|
| RAID10Triple | A placement policy that uses a striped
device (RAID 0) over a set of triple mirrored devices (RAID
1Triple).
|
| RAID1E | A placement policy that uses a form of
mirroring implemented over a set of independent storage devices where
logical blocks are duplicated on a pair of independent storage devices
so that data is uniformly distributed across the storage
devices.
|
| RAID1Triple | A placement policy where each logical
block of data is mirrored three times across a set of three independent
storage devices.
|
| RAID3 | A placement policy using parity-based
protection where logical bytes of data are uniformly distributed across
a set of independent storage devices and where the parity is stored on a
dedicated independent storage device.
|
| RAID4 | A placement policy using parity-based
protection where logical blocks of data are uniformly distributed across
a set of independent storage devices and where the parity is stored on a
dedicated independent storage device.
|
| RAID5 | A placement policy using parity-based
protection for storing stripes of 'n' logical blocks of data and one
logical block of parity across a set of 'n+1' independent storage
devices where the parity and data blocks are interleaved across the
storage devices.
|
| RAID50 | A placement policy that uses a RAID 0
stripe set over two or more RAID 5 sets of independent storage
devices.
|
| RAID6 | A placement policy using parity-based
protection for storing stripes of 'n' logical blocks of data and two
logical blocks of independent parity across a set of 'n+2' independent
storage devices where the parity and data blocks are interleaved across
the storage devices.
|
| RAID60 | A placement policy that uses a RAID 0
stripe set over two or more RAID 6 sets of independent storage
devices.
|
| RAID6TP | A placement policy that uses parity-based
protection for storing stripes of 'n' logical blocks of data and three
logical blocks of independent parity across a set of 'n+3' independent
storage devices where the parity and data blocks are interleaved across
the storage devices.
|
6.128.6 Example response
{
"@odata.type": "#StorageController.v1_7_1.StorageController",
"Id": "1",
"Name": "NVMe IO Controller",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"SupportedControllerProtocols": [
"NVMeOverFabrics"
],
"NVMeControllerProperties": {
"NVMeVersion": "1.4",
"ControllerType": "IO",
"NVMeControllerAttributes": {
"ReportsUUIDList": false,
"SupportsSQAssociations": false,
"ReportsNamespaceGranularity": false,
"SupportsTrafficBasedKeepAlive": false,
"SupportsPredictableLatencyMode": false,
"SupportsEnduranceGroups": false,
"SupportsReadRecoveryLevels": false,
"SupportsNVMSets": false,
"SupportsExceedingPowerOfNonOperationalState": false,
"Supports128BitHostId": false
},
"NVMeSMARTCriticalWarnings": {
"PMRUnreliable": false,
"PowerBackupFailed": false,
"MediaInReadOnly": false,
"OverallSubsystemDegraded": false,
"SpareCapacityWornOut": false
}
},
"Links": {
"Endpoints": [
{
"@odata.id": "/redfish/v1/Fabrics/NVMeoF/Endpoints/Initiator1"
},
{
"@odata.id": "/redfish/v1/Fabrics/NVMeoF/Endpoints/Target1"
}
],
"AttachedVolumes": [
{
"@odata.id": "/redfish/v1/Storage/NVMeoF/Volumes/1"
},
{
"@odata.id": "/redfish/v1/Storage/NVMeoF/Volumes/3"
},
{
"@odata.id": "/redfish/v1/Storage/NVMeoF/Volumes/4"
}
]
},
"@odata.id": "/redfish/v1/Storage/NVMeoF/Controllers/1"
}6.129 StorageControllerMetrics 1.0.1
| Version | v1.0 |
| Release | 2023.1 |
6.129.1 Description
The usage and health statistics for a storage controller.
- The StorageControllerMetrics schema shall contain the usage and health statistics for a storage controller in a Redfish implementation.
6.129.2 URIs
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Controllers/{ControllerId}/Metrics
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Controllers/{ControllerId}/Metrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Controllers/{ControllerId}/Metrics
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Controllers/{ControllerId}/Metrics
/redfish/v1/Storage/{StorageId}/Controllers/{ControllerId}/Metrics
/redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/Controllers/{ControllerId}/Metrics
6.129.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| CorrectableECCErrorCount | integer | read-only (null) |
The number of the correctable errors for
the lifetime of the memory of the storage controller.
|
| CorrectableParityErrorCount | integer | read-only (null) |
The number of the correctable parity
errors for the lifetime of the memory of the storage
controller.
|
| NVMeSMART { | object | The NVMe SMART metrics for this storage
controller.
|
|
| AvailableSparePercent | number (%) |
read-only (null) |
The normalized percentage of the remaining
spare capacity available.
|
| AvailableSpareThresholdPercent | number (%) |
read-only (null) |
The available spare threshold as a
normalized percentage.
|
| CompositeTemperatureCelsius | number (Celsius) |
read-only (null) |
The composite temperature in degrees
Celsius for this storage controller.
|
| ControllerBusyTimeMinutes | integer | read-only (null) |
The total time the controller is busy with
I/O commands in minutes.
|
| CriticalCompositeTempTimeMinutes | integer | read-only (null) |
The amount of time in minutes that the
controller is operational and the composite temperature is greater than
or equal to the critical composite temperature threshold.
|
| CriticalWarnings { | object | The NVMe SMART critical
warnings.
|
|
| @odata.id | string | read-only | Link to a NVMeSMARTCriticalWarnings resource. See the Links section and the StorageController schema for details. |
| } | |||
| DataUnitsRead | integer | read-only (null) |
The number of 512 byte data units the host
has read from the controller as part of processing a SMART Data Units
Read Command in units of one thousand.
|
| DataUnitsWritten | integer | read-only (null) |
The number of 512 byte data units the host
has written to the controller as part of processing a User Data Out
Command in units of one thousand.
|
| EGCriticalWarningSummary { | object | The Endurance Group critical warnings
summary.
|
|
| NamespacesInReadOnlyMode | boolean | read-only (null) |
An indication of whether namespaces in one
or more Endurance Groups are in read-only mode not as a result of a
change in the write protection state of a namespace.
|
| ReliabilityDegraded | boolean | read-only (null) |
An indication of whether the reliability
of one or more Endurance Groups is degraded due to significant media
related errors or any internal error that degrades the NVM subsystem
reliability.
|
| SpareCapacityUnderThreshold | boolean | read-only (null) |
An indication of whether the available
spare capacity of one or more Endurance Groups is below the
threshold.
|
| } | |||
| HostReadCommands | integer | read-only (null) |
The number of SMART Host Read Commands
completed by the controller.
|
| HostWriteCommands | integer | read-only (null) |
The number of User Data Out Commands
completed by the controller.
|
| MediaAndDataIntegrityErrors | integer | read-only (null) |
The number of occurrences where the
controller detected an unrecovered data integrity error.
|
| NumberOfErrorInformationLogEntries | integer | read-only (null) |
The number of error information log
entries over the life of the controller.
|
| PercentageUsed | number (%) |
read-only (null) |
The percentage of the NVM subsystem life
used.
|
| PowerCycles | integer | read-only (null) |
The number of power cycles.
|
| PowerOnHours | number | read-only (null) |
The number of power-on hours.
|
| TemperatureSensorsCelsius [ ] | array (Celsius) (number, null) |
read-only | The temperature sensor readings in degrees
Celsius for this storage controller.
|
| ThermalMgmtTemp1TotalTimeSeconds | integer | read-only (null) |
The number of seconds the controller
transitioned to lower power states or performed vendor-specific thermal
management actions while minimizing the impact on performance in order
to attempt to reduce the composite temperature.
|
| ThermalMgmtTemp1TransitionCount | integer | read-only (null) |
The number of times the controller
transitioned to lower power states or performed vendor-specific thermal
management actions while minimizing the impact on performance in order
to attempt to reduce the composite temperature.
|
| ThermalMgmtTemp2TotalTimeSeconds | integer | read-only (null) |
The number of seconds the controller
transitioned to lower power states or performed vendor-specific thermal
management actions regardless of the impact on performance in order to
attempt to reduce the composite temperature.
|
| ThermalMgmtTemp2TransitionCount | integer | read-only (null) |
The number of times the controller
transitioned to lower power states or performed vendor-specific thermal
management actions regardless of the impact on performance in order to
attempt to reduce the composite temperature.
|
| UnsafeShutdowns | integer | read-only (null) |
The number of unsafe
shutdowns.
|
| WarningCompositeTempTimeMinutes | integer | read-only (null) |
The amount of time in minutes that the
controller is operational and the composite temperature is greater than
or equal to the warning composite temperature threshold.
|
| } | |||
| StateChangeCount | integer | read-only (null) |
The number of state changes for this
storage controller.
|
| UncorrectableECCErrorCount | integer | read-only (null) |
The number of the uncorrectable errors for
the lifetime of the memory of the storage controller.
|
| UncorrectableParityErrorCount | integer | read-only (null) |
The number of the uncorrectable parity
errors for the lifetime of the memory of the storage
controller.
|
6.129.4 Example response
{
"@odata.type": "#StorageControllerMetrics.v1_0_1.StorageControllerMetrics",
"Id": "Metrics",
"Name": "Storage Controller Metrics for NVMe IO Controller",
"NVMeSMART": {
"CriticalWarnings": {
"PMRUnreliable": false,
"PowerBackupFailed": false,
"MediaInReadOnly": false,
"OverallSubsystemDegraded": false,
"SpareCapacityWornOut": false
},
"CompositeTemperatureCelsius": 34,
"AvailableSparePercent": 50,
"AvailableSpareThresholdPercent": 30,
"PercentageUsed": 50,
"EGCriticalWarningSummary": {
"NamespacesInReadOnlyMode": false,
"ReliabilityDegraded": false,
"SpareCapacityUnderThreshold": false
},
"DataUnitsRead": 0,
"DataUnitsWritten": 0,
"HostReadCommands": 0,
"HostWriteCommands": 0,
"ControllerBusyTimeMinutes": 20,
"PowerCycles": 49,
"PowerOnHours": 3,
"UnsafeShutdowns": 4,
"MediaAndDataIntegrityErrors": 0,
"NumberOfErrorInformationLogEntries": 100,
"WarningCompositeTempTimeMinutes": 0,
"CriticalCompositeTempTimeMinutes": 0,
"TemperatureSensorsCelsius": [
34,
34,
34,
26,
31,
35,
33,
32
],
"ThermalMgmtTemp1TransitionCount": 10,
"ThermalMgmtTemp2TransitionCount": 2,
"ThermalMgmtTemp1TotalTimeSeconds": 20,
"ThermalMgmtTemp2TotalTimeSeconds": 42
},
"@odata.id": "/redfish/v1/Systems/Sys-1/Storage/SimplestNVMeSSD/Controllers/NVMeIOController/Metrics"
}6.130 Switch 1.9.1
| Version | v1.9 | v1.8 | v1.7 | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2022.3 | 2021.4 | 2021.3 | 2021.1 | 2020.4 | 2020.3 | 2019.4 | 2019.2 | 2017.3 | 2016.2 |
6.130.1 Description
The Switch schema contains properties that describe a fabric switch.
- This resource contains a switch for a Redfish implementation.
6.130.2 URIs
/redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}
6.130.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AssetTag | string | read-write (null) |
The user-assigned asset tag for this
switch.
|
| Certificates (v1.5+) { | object | The link to a collection of certificates
for device identity and attestation.
|
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| CurrentBandwidthGbps (v1.4+) | number (Gbit/s) |
read-only (null) |
The current internal bandwidth of this
switch.
|
| CXL (v1.9+) { | object | CXL properties for this
switch.
|
|
| MaxVCSsSupported (v1.9+) | integer | read-only | The maximum number of Virtual CXL Switches
(VCSs) supported in this switch.
|
| TotalNumbervPPBs (v1.9+) | integer | read-only | The total number of virtual PCI-to-PCI
bridges (vPPBs) supported in this switch.
|
| VCS (v1.9+) { | object | Virtual CXL Switch (VCS) properties for
this switch.
|
|
| HDMDecoders (v1.9+) | integer | read-only | The number of Host Device Memory (HDM)
Decoders supported by this switch.
|
| } | |||
| } | |||
| DomainID | integer | read-only (null) |
The domain ID for this switch.
|
| Enabled (v1.6+) | boolean | read-write | An indication of whether this switch is
enabled.
|
| EnvironmentMetrics (v1.6+) { | object | The link to the environment metrics for
this switch.
|
|
| @odata.id | string | read-only | Link to a EnvironmentMetrics resource. See the Links section and the EnvironmentMetrics schema for details. |
| } | |||
| FirmwareVersion (v1.2+) | string | read-only (null) |
The firmware version of this
switch.
|
| IndicatorLED (deprecated v1.4) | string (enum) |
read-write (null) |
The state of the indicator LED, which
identifies the switch.
|
| IsManaged | boolean | read-write (null) |
An indication of whether the switch is in
a managed or unmanaged state.
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| Chassis { | object | The link to the chassis that contains this
switch.
|
|
| @odata.id | string | read-only | Link to a Chassis resource. See the Links section and the Chassis schema for details. |
| } | |||
| Endpoints (v1.3+) [ { | array | An array of links to the endpoints that
connect to this switch.
|
|
| @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 that
manage this switch.
|
|
| @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 Using this guide clause. | |
| PCIeDevice (v1.4+) { | object | (null) |
The link to the PCIe device providing this
switch.
|
| @odata.id | string | read-only | Link to a PCIeDevice resource. See the Links section and the PCIeDevice schema for details. |
| } | |||
| } | |||
| Location (v1.1+) {} | object | The location of the switch.
|
|
| LocationIndicatorActive (v1.4+) | 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 switch.
|
|
| @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
switch.
|
| MaxBandwidthGbps (v1.4+) | number (Gbit/s) |
read-only (null) |
The maximum internal bandwidth of this
switch as currently configured.
|
| Measurements (v1.5+, deprecated v1.8 [ { | 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. |
| } ] | |||
| Metrics (v1.7+) { | object | The link to the metrics associated with
this switch.
|
|
| @odata.id | string | read-only | Link to a SwitchMetrics resource. See the Links section and the SwitchMetrics schema for details. |
| } | |||
| Model | string | read-only (null) |
The product model number of this
switch.
|
| PartNumber | string | read-only (null) |
The part number for this
switch.
|
| Ports { | object | The link to the collection ports for this
switch.
|
|
| @odata.id | string | read-only | Link to Collection of Port. See the Port schema for details. |
| } | |||
| PowerState | string (enum) |
read-only (null) |
The current power state of the
switch.
|
| Redundancy [ { } ] | array (object) | The common redundancy definition and
structure used in other Redfish schemas.
|
|
| SerialNumber | string | read-only (null) |
The serial number for this
switch.
|
| SKU | string | read-only (null) |
The SKU for this switch.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| SupportedProtocols (v1.3+) [ ] | array (string (enum)) |
read-only |
|
| SwitchType | string (enum) |
read-only (null) |
The protocol being sent over this
switch.
|
| TotalSwitchWidth | integer | read-only (null) |
The total number of lanes, phys, or other
physical transport links that this switch contains.
|
| UUID (v1.3+) | string (uuid) |
read-only (null) |
The UUID for this switch.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ |
6.130.4 Actions
6.130.4.1 Reset
Description
This action resets this switch.
- This action shall reset this switch.
Action URI
{Base URI of target resource}/Actions/Switch.Reset
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| ResetType | string (enum) |
optional | The type of reset.
|
Request Example
{
"ResetType": "ForceRestart"
}6.130.5 Property details
6.130.5.1 IndicatorLED
The state of the indicator LED, which identifies the switch.
- This property shall contain the state of the indicator light associated with this switch.
| string | Description |
|---|---|
| Blinking | The indicator LED is blinking.
|
| Lit | The indicator LED is lit.
|
| Off | The indicator LED is off.
|
6.130.5.2 PowerState
The current power state of the switch.
- This property shall contain the power state of the switch.
| string | Description |
|---|---|
| Off | The resource is powered off. The components within the resource might continue to have AUX power. |
| On | The resource is powered on. |
| Paused | The resource is paused. |
| PoweringOff | A temporary state between on and off. The components within the resource can take time to process the power off action. |
| PoweringOn | A temporary state between off and on. The components within the resource can take time to process the power on action. |
6.130.5.3 ResetType
The type of reset.
- This parameter shall contain the type of reset. The service can accept a request without this parameter and can complete an implementation-specific default reset.
| string | Description |
|---|---|
| ForceOff | Turn off the unit immediately
(non-graceful shutdown).
|
| ForceOn | Turn on the unit immediately.
|
| ForceRestart | Shut down immediately and non-gracefully
and restart the system.
|
| GracefulRestart | Shut down gracefully and restart the
system.
|
| GracefulShutdown | Shut down gracefully and power
off.
|
| Nmi | Generate a diagnostic interrupt, which is
usually an NMI on x86 systems, to stop normal operations, complete
diagnostic actions, and, typically, halt the system.
|
| On | Turn on the unit.
|
| Pause | Pause execution on the unit but do not
remove power. This is typically a feature of virtual machine
hypervisors.
|
| PowerCycle | Power cycle the unit. Behaves like a full
power removal, followed by a power restore to the resource.
|
| PushPowerButton | Simulate the pressing of the physical
power button on this unit.
|
| Resume | Resume execution on the paused unit. This
is typically a feature of virtual machine hypervisors.
|
| Suspend | Write the state of the unit to disk before
powering off. This allows for the state to be restored when powered back
on.
|
6.130.5.4 SupportedProtocols
- The protocols this switch supports.
- The property shall contain an array of protocols this switch supports. If the value of SwitchType is `MultiProtocol`, this property shall be required.
| string | Description |
|---|---|
| AHCI | Advanced Host Controller Interface
(AHCI).
|
| CXL | Compute Express Link.
|
| 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.
|
| QPI | Intel QuickPath Interconnect
(QPI).
|
| 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).
|
| UPI | Intel UltraPath Interconnect
(UPI).
|
| USB | Universal Serial Bus (USB).
|
| VGA | VGA.
|
6.130.5.5 SwitchType
The protocol being sent over this switch.
- This property shall
contain the protocol being sent over this switch. For a switch that
supports multiple protocols, the value should be
MultiProtocoland the SupportedProtocols property should be used to describe the supported protocols.
| string | Description |
|---|---|
| AHCI | Advanced Host Controller Interface
(AHCI).
|
| CXL | Compute Express Link.
|
| 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.
|
| QPI | Intel QuickPath Interconnect
(QPI).
|
| 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).
|
| UPI | Intel UltraPath Interconnect
(UPI).
|
| USB | Universal Serial Bus (USB).
|
| VGA | VGA.
|
6.130.6 Example response
{
"@odata.type": "#Switch.v1_9_1.Switch",
"Id": "Switch1",
"Name": "SAS Switch",
"SwitchType": "SAS",
"Manufacturer": "Contoso",
"Model": "SAS1000",
"SKU": "67B",
"SerialNumber": "2M220100SL",
"PartNumber": "76-88883",
"Ports": {
"@odata.id": "/redfish/v1/Fabrics/SAS/Switches/Switch1/Ports"
},
"Redundancy": [
{
"@odata.id": "/redfish/v1/Fabrics/SAS/Switches/Switch1#/Redundancy/0",
"MemberId": "Redundancy",
"Mode": "Sharing",
"MaxNumSupported": 2,
"MinNumNeeded": 1,
"Status": {
"State": "Enabled",
"Health": "OK"
},
"RedundancySet": [
{
"@odata.id": "/redfish/v1/Fabrics/SAS/Switches/Switch1"
},
{
"@odata.id": "/redfish/v1/Fabrics/SAS/Switches/Switch2"
}
]
}
],
"Links": {
"Chassis": {
"@odata.id": "/redfish/v1/Chassis/Switch1"
},
"ManagedBy": [
{
"@odata.id": "/redfish/v1/Managers/Switch1"
},
{
"@odata.id": "/redfish/v1/Managers/Switch2"
}
]
},
"Actions": {
"#Switch.Reset": {
"target": "/redfish/v1/Fabrics/SAS/Switches/Switch1/Actions/Switch.Reset",
"ResetType@Redfish.AllowableValues": [
"ForceRestart",
"GracefulRestart"
]
}
},
"@odata.id": "/redfish/v1/Fabrics/SAS/Switches/Switch1"
}6.131 SwitchMetrics 1.0.0
| Version | v1.0 |
| Release | 2021.3 |
6.131.1 Description
The SwitchMetrics schema contains usage and health statistics for a switch device.
- This resource shall represent the metrics for a switch device in a Redfish implementation.
6.131.2 URIs
/redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/SwitchMetrics
6.131.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| InternalMemoryMetrics { | object | The memory metrics for a
switch.
|
|
| CurrentPeriod { | object | The memory metrics since the last reset
for this switch.
|
|
| CorrectableECCErrorCount | integer | read-only (null) |
The number of the correctable errors of
memory since reset.
|
| UncorrectableECCErrorCount | integer | read-only (null) |
The number of the uncorrectable errors of
memory since reset.
|
| } | |||
| LifeTime { | object | The memory metrics for the lifetime of
this switch.
|
|
| CorrectableECCErrorCount | integer | read-only (null) |
The number of the correctable errors for
the lifetime of the memory.
|
| UncorrectableECCErrorCount | integer | read-only (null) |
The number of the uncorrectable errors for
the lifetime of the memory.
|
| } | |||
| } | |||
| PCIeErrors { | object | The PCIe errors associated with this
switch.
|
|
| CorrectableErrorCount (v1.8+) | integer | read-only (null) |
The total number of the PCIe correctable
errors for this device.
|
| FatalErrorCount (v1.8+) | integer | read-only (null) |
The total number of the PCIe fatal errors
for this device.
|
| L0ToRecoveryCount (v1.8+) | integer | read-only (null) |
The total number of times the PCIe link
states transitioned from L0 to the recovery state for this
device.
|
| NAKReceivedCount (v1.8+) | integer | read-only (null) |
The total number of NAKs issued on the
PCIe link by the receiver.
|
| NAKSentCount (v1.8+) | integer | read-only (null) |
The total number of NAKs issued on the
PCIe link by this device.
|
| NonFatalErrorCount (v1.8+) | integer | read-only (null) |
The total number of the PCIe non-fatal
errors for this device.
|
| ReplayCount (v1.8+) | integer | read-only (null) |
The total number of the PCIe replays
issued by this device.
|
| ReplayRolloverCount (v1.8+) | integer | read-only (null) |
The total number of the PCIe replay
rollovers issued by this device.
|
| } |
6.131.4 Actions
6.131.4.1 ClearCurrentPeriod
Description
This action sets the CurrentPeriod property's values to 0.
- This action shall set the CurrentPeriod property's values to 0.
Action URI
{Base URI of target resource}/Actions/SwitchMetrics.ClearCurrentPeriod
Action parameters
This action takes no parameters.
6.131.5 Example response
{
"@odata.type": "#SwitchMetrics.v1_0_0.SwitchMetrics",
"Id": "SwitchMetrics",
"Name": "PCIe Switch Metrics",
"PCIeErrors": {
"CorrectableErrorCount": 0,
"NonFatalErrorCount": 0,
"FatalErrorCount": 0,
"L0ToRecoveryCount": 0,
"ReplayCount": 0,
"ReplayRolloverCount": 0,
"NAKSentCount": 0,
"NAKReceivedCount": 0
},
"InternalMemoryMetrics": {
"CurrentPeriod": {
"CorrectableECCErrorCount": 0,
"UncorrectableECCErrorCount": 0
},
"LifeTime": {
"CorrectableECCErrorCount": 0,
"UncorrectableECCErrorCount": 0
}
},
"@odata.id": "/redfish/v1/Fabrics/PCIe/Switches/1/SwitchMetrics"
}6.132 Task 1.7.2
| Version | v1.7 | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2022.3 | 2022.1 | 2020.3 | 2018.3 | 2018.2 | 2018.1 | 2017.1 | 1.0 |
6.132.1 Description
The Task schema contains information about a task that the Redfish task service schedules or executes. Tasks represent operations that take more time than a client typically wants to wait.
- This resource contains a task for a Redfish implementation.
6.132.2 URIs
/redfish/v1/TaskService/Tasks/{TaskId}
/redfish/v1/TaskService/Tasks/{TaskId}/SubTasks/{TaskId2}
6.132.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| EndTime | string (date-time) |
read-only | The date and time when the task was
completed. This property will only appear when the task is
complete.
|
| EstimatedDuration (v1.6+) | string (duration) |
read-only (null) |
The estimated total time required to
complete the task.
^P(\d+D)?(T(\d+H)?(\d+M)?(\d+(.\d+)?S)?)?$ |
| HidePayload (v1.3+) | boolean | read-only | An indication of whether the contents of
the payload are hidden from view after the task has been created. If
true, responses do not return the payload. If
false, responses return the payload. If this property is
not present when the task is created, the default is
false.
|
| Links (v1.7+) { | object | Contains references to other resources
that are related to this resource.
|
|
| CreatedResources (v1.7+) [ { | array | An array of URIs referencing the resources
created as the result of the operation that produced this
task.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| } | |||
| Messages [ { } ] | array (object) | The message that the Redfish service
returns.
|
|
| Payload (v1.3+) { | object | The HTTP and JSON request payload details
for this task, unless they are hidden from view by the
service.
|
|
| HttpHeaders (v1.3+) [ ] | array (string) | read-only | An array of HTTP headers that this task
includes.
|
| HttpOperation (v1.3+) | string | read-only | The HTTP operation to perform to execute
this task.
|
| JsonBody (v1.3+) | string | read-only | The JSON payload to use in the execution
of this task.
|
| TargetUri (v1.3+) | string (URI) |
read-only | The URI of the target for this
task.
|
| } | |||
| PercentComplete (v1.4+) | integer (%) |
read-only (null) |
The completion percentage of this
task.
|
| StartTime | string (date-time) |
read-only | The date and time when the task was
started.
|
| SubTasks (v1.5+) { | object | The link to a collection of sub-tasks for
this task.
|
|
| @odata.id | string | read-only | Link to Collection of Task. See the Task schema for details. |
| } | |||
| TaskMonitor (v1.2+) | string (URI) |
read-only | The URI of the Task Monitor for this
task.
|
| TaskState | string (enum) |
read-only | The state of the task.
|
| TaskStatus | string (enum) |
read-only | The completion status of the
task.
|
6.132.4 Property details
6.132.4.1 TaskState
The state of the task.
- This property shall indicate the state of the task.
| string | Description |
|---|---|
| Cancelled (v1.2+) | Task has been cancelled by an operator or
internal process.
|
| Cancelling (v1.2+) | Task is in the process of being
cancelled.
|
| Completed | Task was completed.
|
| Exception | Task has stopped due to an exception
condition.
|
| Interrupted | Task has been interrupted.
|
| Killed (deprecated v1.2) | Task was terminated.
Cancelled value,
which has more determinate semantics. |
| New | A new task.
|
| Pending | Task is pending and has not
started.
|
| Running | Task is running normally.
|
| Service | Task is running as a service.
|
| Starting | Task is starting.
|
| Stopping | Task is in the process of
stopping.
|
| Suspended | Task has been suspended.
|
6.132.4.2 TaskStatus
The completion status of the task.
- This property shall contain
the completion status of the task and shall not be set until the task
completes. This property should contain
Criticalif one or more messages in the Messages array contains the severityCritical. This property should containWarningif one or more messages in the Messages array contains the severityWarningand no messages contain the severityCritical. This property should containOKif all messages in the Messages array contain the severityOKor the array is empty.
| string | Description |
|---|---|
| Critical | A critical condition requires immediate attention. |
| OK | Normal. |
| Warning | A condition requires attention. |
6.132.5 Example response
{
"@odata.type": "#Task.v1_7_2.Task",
"Id": "545",
"Name": "Task 545",
"TaskMonitor": "/taskmon/545",
"TaskState": "Completed",
"StartTime": "2012-03-07T14:44+06:00",
"EndTime": "2012-03-07T14:45+06:00",
"TaskStatus": "OK",
"Messages": [
{
"MessageId": "Base.1.0.PropertyNotWritable",
"RelatedProperties": [
"SKU"
],
"Message": "The property SKU is a read only property and cannot be assigned a value",
"MessageArgs": [
"SKU"
],
"Severity": "Warning"
}
],
"@odata.id": "/redfish/v1/TaskService/Tasks/545"
}6.133 TaskService 1.2.0
| Version | v1.2 | v1.1 | v1.0 |
| Release | 2021.1 | 2017.1 | 1.0 |
6.133.1 Description
The TaskService schema describes a task service that enables management of long-duration operations, includes the properties for the task service itself, and has links to the resource collection of tasks.
- This resource contains a task service for a Redfish implementation.
6.133.2 URIs
/redfish/v1/TaskService
6.133.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| CompletedTaskOverWritePolicy | string (enum) |
read-only | The overwrite policy for completed tasks.
This property indicates if the task service overwrites completed task
information.
|
| DateTime | string (date-time) |
read-only (null) |
The current date and time, with UTC
offset, setting that the task service uses.
|
| LifeCycleEventOnTaskStateChange | boolean | read-only | An indication of whether a task state
change sends an event.
|
| 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.
|
|
| TaskAutoDeleteTimeoutMinutes (v1.2+) | integer | read-write | The number of minutes after which a
completed task is deleted by the service.
|
| Tasks { | object | The links to the collection of
tasks.
|
|
| @odata.id | string | read-only | Link to Collection of Task. See the Task schema for details. |
| } |
6.133.4 Property details
6.133.4.1 CompletedTaskOverWritePolicy
The overwrite policy for completed tasks. This property indicates if the task service overwrites completed task information.
- This property shall contain the overwrite policy for completed tasks. This property shall indicate if the task service overwrites completed task information.
| string | Description |
|---|---|
| Manual | Completed tasks are not automatically overwritten. |
| Oldest | Oldest completed tasks are overwritten. |
6.133.5 Example response
{
"@odata.type": "#TaskService.v1_2_0.TaskService",
"Id": "TaskService",
"Name": "Tasks Service",
"DateTime": "2015-03-13T04:14:33+06:00",
"CompletedTaskOverWritePolicy": "Manual",
"LifeCycleEventOnTaskStateChange": true,
"Status": {
"State": "Enabled",
"Health": "OK"
},
"ServiceEnabled": true,
"Tasks": {
"@odata.id": "/redfish/v1/TaskService/Tasks"
},
"@odata.id": "/redfish/v1/TaskService"
}6.134 TelemetryService 1.3.2
| Version | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2020.4 | 2019.4 | 2018.3 | 2018.2 |
6.134.1 Description
The TelemetryService schema describes a telemetry service. The telemetry service is used to for collecting and reporting metric data within the Redfish Service.
- This resource contains a telemetry service for a Redfish implementation.
6.134.2 URIs
/redfish/v1/TelemetryService
6.134.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| LogService { | object | The link to a log service that the
telemetry service uses. This service can be a dedicated log service or a
pointer a log service under another resource, such as a
manager.
|
|
| @odata.id | string | read-only | Link to a LogService resource. See the Links section and the LogService schema for details. |
| } | |||
| MaxReports | integer | read-only (null) |
The maximum number of metric reports that
this service supports.
|
| MetricDefinitions { | object | The link to the collection of metric
definitions.
|
|
| @odata.id | string | read-only | Link to Collection of MetricDefinition. See the MetricDefinition schema for details. |
| } | |||
| MetricReportDefinitions { | object | The link to the collection of metric
report definitions.
|
|
| @odata.id | string | read-only | Link to Collection of MetricReportDefinition. See the MetricReportDefinition schema for details. |
| } | |||
| MetricReports { | object | The link to the collection of metric
reports.
|
|
| @odata.id | string | read-only | Link to Collection of MetricReport. See the MetricReport schema for details. |
| } | |||
| MinCollectionInterval | string (duration) |
read-only (null) |
The minimum time interval between
gathering metric data that this service allows.
^P(\d+D)?(T(\d+H)?(\d+M)?(\d+(.\d+)?S)?)?$ |
| ServiceEnabled (v1.2+) | 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.
|
|
| SupportedCollectionFunctions [ ] | array (string (enum)) |
read-only (null) |
An operation to perform over the
sample.
|
| Triggers { | object | The link to the collection of triggers
that apply to metrics.
|
|
| @odata.id | string | read-only | Link to Collection of Triggers. See the Triggers schema for details. |
| } |
6.134.4 Actions
6.134.4.1 ClearMetricReports (v1.3+)
Description
The action to clear the metric reports for this telemetry service.
- This action shall delete all entries found in the metric report collection for this telemetry service.
Action URI
{Base URI of target resource}/Actions/TelemetryService.ClearMetricReports
Action parameters
This action takes no parameters.
6.134.4.2 ResetMetricReportDefinitionsToDefaults (v1.3+)
Description
The action to reset the metric report definitions to factory defaults.
- This action shall reset all entries found in the metric report definition collection to factory defaults. This action may delete members of the metric report definition collection.
Action URI
{Base URI of target resource}/Actions/TelemetryService.ResetMetricReportDefinitionsToDefaults
Action parameters
This action takes no parameters.
6.134.4.3 ResetTriggersToDefaults (v1.3+)
Description
The action to reset the triggers to factory defaults.
- This action shall reset all entries found in the triggers collection to factory defaults. This action may delete members of the triggers collection.
Action URI
{Base URI of target resource}/Actions/TelemetryService.ResetTriggersToDefaults
Action parameters
This action takes no parameters.
6.134.4.4 SubmitTestMetricReport
Description
This action generates a metric report.
- This action shall cause the Event Service to immediately generate the metric report as an alert event. Then, this message should be sent to any appropriate event destinations.
Action URI
{Base URI of target resource}/Actions/TelemetryService.SubmitTestMetricReport
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| GeneratedMetricReportValues (v1.1+) [ { | array | required | The content of the MetricReportValues in
the generated metric report.
|
| MetricDefinition (v1.1+) { | object | The link to the metric definition for this
metric.
|
|
| @odata.id | string | read-only | Link to a MetricDefinition resource. See the Links section and the MetricDefinition schema for details. |
| } | |||
| MetricId (v1.1+) | string | read-only (null) |
The metric definitions identifier for this
metric.
|
| MetricProperty (v1.1+) | string (URI) |
read-only (null) |
The URI for the property from which this
metric is derived.
|
| MetricValue (v1.1+) | string | read-only (null) |
The metric value, as a string.
|
| Timestamp (v1.1+) | string (date-time) |
read-only (null) |
The date and time when the metric is
obtained. A management application can establish a time series of metric
data by retrieving the instances of metric value and sorting them
according to their timestamp.
|
| } ] | |||
| MetricReportName | string | required | The name of the metric report in generated
metric report.
|
| MetricReportValues (deprecated v1.1) | string | optional | The contents of MetricReportValues array
in the generated metric report.
|
Request Example
{
"MetricReportName": "TestMetricReport",
"GeneratedMetricReportValues": [
{
"MetricId": "AverageReadingCelsius",
"MetricValue": "50",
"Timestamp": "2020-12-06T12:00:00Z",
"MetricProperty": "/redfish/v1/Chassis/Tray_1/Thermal#/Temperatures/0/ReadingCelsius",
"MetricDefinition": {
"@odata.id": "/redfish/v1/TelemetryService/MetricDefinitions/AverageReadingCelsius"
}
},
{
"MetricId": "AverageReadingCelsius",
"MetricValue": "53",
"Timestamp": "2020-12-06T12:00:01Z",
"MetricProperty": "/redfish/v1/Chassis/Tray_1/Thermal#/Temperatures/0/ReadingCelsius",
"MetricDefinition": {
"@odata.id": "/redfish/v1/TelemetryService/MetricDefinitions/AverageReadingCelsius"
}
}
]
}6.134.5 Property details
6.134.5.1 SupportedCollectionFunctions
An operation to perform over the sample.
- The functions that
can be performed over each metric.
- This property shall contain the function to apply over the collection duration.
| string | Description |
|---|---|
| Average | An averaging function. |
| Maximum | A maximum function. |
| Minimum | A minimum function. |
| Summation | A summation function. |
6.134.6 Example response
{
"@odata.type": "#TelemetryService.v1_3_2.TelemetryService",
"Id": "TelemetryService",
"Name": "Telemetry Service",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"SupportedCollectionFunctions": [
"Average",
"Minimum",
"Maximum"
],
"MetricDefinitions": {
"@odata.id": "/redfish/v1/TelemetryService/MetricDefinitions"
},
"MetricReportDefinitions": {
"@odata.id": "/redfish/v1/TelemetryService/MetricReportDefinitions"
},
"MetricReports": {
"@odata.id": "/redfish/v1/TelemetryService/MetricReports"
},
"Triggers": {
"@odata.id": "/redfish/v1/TelemetryService/Triggers"
},
"LogService": {
"@odata.id": "/redfish/v1/Managers/1/LogServices/Log1"
},
"@odata.id": "/redfish/v1/TelemetryService"
}6.135 Thermal 1.7.1 (deprecated)
| Version | v1.7 Deprecated | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2020.4 | 2019.4 | 2018.2 | 2017.3 | 2017.1 | 2016.3 | 2016.1 | 1.0 |
This schema has been deprecated and use in new implementations is discouraged except to retain compatibility with existing products. This schema has been deprecated in favor of the ThermalSubsystem schema.
6.135.1 Description
The Thermal schema describes temperature monitoring and thermal management subsystems, such as cooling fans, for a computer system or similar devices contained within a chassis.
- This resource shall contain the thermal management properties for temperature monitoring and management of cooling fans for a Redfish implementation.
6.135.2 URIs
/redfish/v1/Chassis/{ChassisId}/Thermal (deprecated)
6.135.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Fans [ { | array | The set of fans for this
chassis.
|
|
| @odata.id | string (URI) |
read-only required | The unique identifier for a
resource.
|
| Actions (v1.3+) {} | object | The available actions for this
resource.
|
|
| Assembly (v1.4+) { | object | The link to the assembly associated with
this fan.
|
|
| @odata.id | string | read-only | Link to a Assembly resource. See the Links section and the Assembly schema for details. |
| } | |||
| FanName (deprecated v1.1) | string | read-only (null) |
The name of the fan.
|
| HotPluggable (v1.4+) | boolean | read-only (null) |
An indication of whether this device can
be inserted or removed while the equipment is in operation.
|
| IndicatorLED (v1.2+) | string (enum) |
read-write (null) |
The state of the indicator LED, which
identifies this fan.
|
| Location (v1.4+) {} | object | The location of the fan.
|
|
| LowerThresholdCritical | integer | read-only (null) |
The value at which the reading is below
normal range but not yet fatal.
|
| LowerThresholdFatal | integer | read-only (null) |
The value at which the reading is below
normal range and fatal.
|
| LowerThresholdNonCritical | integer | read-only (null) |
The value at which the reading is below
normal range.
|
| Manufacturer (v1.2+) | string | read-only (null) |
The manufacturer of this fan.
|
| MaxReadingRange | integer | read-only (null) |
Maximum value for this sensor.
|
| MemberId | string | read-only required | The identifier for the member within the
collection.
|
| MinReadingRange | integer | read-only (null) |
Minimum value for this sensor.
|
| Model (v1.2+) | string | read-only (null) |
The model number for this fan.
|
| Name (v1.1+) | string | read-only (null) |
Name of the fan.
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| PartNumber (v1.2+) | string | read-only (null) |
The part number for this fan.
|
| PhysicalContext | string (enum) |
read-only | The area or device associated with this
fan.
|
| Reading | integer | read-only (null) |
The fan speed.
|
| ReadingUnits (v1.0.1+) | string (enum) |
read-only (null) |
The units in which the fan reading and
thresholds are measured.
|
| Redundancy [ { } ] | array (object) | The common redundancy definition and
structure used in other Redfish schemas.
|
|
| RelatedItem [ { | array | An array of links to resources or objects
that this fan services.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| SensorNumber (v1.5+) | integer | read-only (null) |
The numerical identifier for this fan
speed sensor.
|
| SerialNumber (v1.2+) | string | read-only (null) |
The serial number for this
fan.
|
| SparePartNumber (v1.2+) | string | read-only (null) |
The spare part number for this
fan.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| UpperThresholdCritical | integer | read-only (null) |
The value at which the reading is above
normal range but not yet fatal.
|
| UpperThresholdFatal | integer | read-only (null) |
The value at which the reading is above
normal range and fatal.
|
| UpperThresholdNonCritical | integer | read-only (null) |
The value at which the reading is above
normal range.
|
| } ] | |||
| Redundancy [ { } ] | array (object) | The common redundancy definition and
structure used in other Redfish schemas.
|
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| Temperatures [ { | array | The set of temperature sensors for this
chassis.
|
|
| @odata.id | string (URI) |
read-only required | The unique identifier for a
resource.
|
| Actions (v1.3+) {} | object | The available actions for this
resource.
|
|
| AdjustedMaxAllowableOperatingValue (v1.4+) | integer (Celsius) |
read-only (null) |
Adjusted maximum allowable operating
temperature for this equipment based on the current environmental
conditions present.
|
| AdjustedMinAllowableOperatingValue (v1.4+) | integer (Celsius) |
read-only (null) |
Adjusted minimum allowable operating
temperature for this equipment based on the current environmental
conditions present.
|
| DeltaPhysicalContext (v1.4+) | string (enum) |
read-only | The area or device to which the
DeltaReadingCelsius temperature measurement applies, relative to
PhysicalContext.
|
| DeltaReadingCelsius (v1.4+) | number (Celsius) |
read-only (null) |
The delta temperature reading.
|
| LowerThresholdCritical | number (Celsius) |
read-only (null) |
The value at which the reading is below
normal range but not yet fatal.
|
| LowerThresholdFatal | number (Celsius) |
read-only (null) |
The value at which the reading is below
normal range and fatal.
|
| LowerThresholdNonCritical | number (Celsius) |
read-only (null) |
The value at which the reading is below
normal range.
|
| LowerThresholdUser (v1.6+) | integer (Celsius) |
read-write (null) |
The value at which the reading is below
the user-defined range.
|
| MaxAllowableOperatingValue (v1.4+) | integer (Celsius) |
read-only (null) |
Maximum allowable operating temperature
for this equipment.
|
| MaxReadingRangeTemp | number (Celsius) |
read-only (null) |
Maximum value for this sensor.
|
| MemberId | string | read-only required | The identifier for the member within the
collection.
|
| MinAllowableOperatingValue (v1.4+) | integer (Celsius) |
read-only (null) |
Minimum allowable operating temperature
for this equipment.
|
| MinReadingRangeTemp | number (Celsius) |
read-only (null) |
Minimum value for this sensor.
|
| Name | string | read-only (null) |
The temperature sensor name.
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| PhysicalContext | string (enum) |
read-only | The area or device to which this
temperature measurement applies.
|
| ReadingCelsius | number (Celsius) |
read-only (null) |
The temperature in degrees
Celsius.
|
| RelatedItem [ { | array | An array of links to resources or objects
that represent areas or devices to which this temperature
applies.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| SensorNumber | integer | read-only (null) |
The numerical identifier of the
temperature sensor.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| UpperThresholdCritical | number (Celsius) |
read-only (null) |
The value at which the reading is above
normal range but not yet fatal.
|
| UpperThresholdFatal | number (Celsius) |
read-only (null) |
The value at which the reading is above
normal range and fatal.
|
| UpperThresholdNonCritical | number (Celsius) |
read-only (null) |
The value at which the reading is above
normal range.
|
| UpperThresholdUser (v1.6+) | integer (Celsius) |
read-write (null) |
The value at which the reading is above
the user-defined range.
|
| } ] |
6.135.4 Property details
6.135.4.1 DeltaPhysicalContext
The area or device to which the DeltaReadingCelsius temperature measurement applies, relative to PhysicalContext.
- This property shall contain a description of the affected device or region within the chassis to which the DeltaReadingCelsius temperature measurement applies, relative to PhysicalContext.
| string | Description |
|---|---|
| Accelerator | An accelerator. |
| ACInput | An AC input. |
| ACMaintenanceBypassInput | An AC maintenance bypass input. |
| ACOutput | An AC output. |
| ACStaticBypassInput | An AC static bypass input. |
| ACUtilityInput | An AC utility input. |
| ASIC | An ASIC device, such as a networking chip or chipset component. |
| Back | The back of the chassis. |
| Backplane | A backplane within the chassis. |
| Battery | A battery. |
| Board | A circuit board.
|
| Chassis | The entire chassis. |
| ComputeBay | Within a compute bay. |
| CoolingSubsystem | The entire cooling, or air and liquid, subsystem. |
| CPU | A processor (CPU). |
| CPUSubsystem | The entire processor (CPU) subsystem. |
| DCBus | A DC bus. |
| Exhaust | The air exhaust point or points or region of the chassis. |
| ExpansionBay | Within an expansion bay. |
| Fan | A fan. |
| FPGA | An FPGA. |
| Front | The front of the chassis. |
| GPU | A graphics processor (GPU). |
| GPUSubsystem | The entire graphics processor (GPU) subsystem. |
| Intake | The air intake point or points or region of the chassis. |
| LiquidInlet | The liquid inlet point of the chassis. |
| LiquidOutlet | The liquid outlet point of the chassis. |
| Lower | The lower portion of the chassis. |
| Memory | A memory device. |
| MemorySubsystem | The entire memory subsystem. |
| Motor | A motor. |
| NetworkBay | Within a networking bay. |
| NetworkingDevice | A networking device. |
| PowerSubsystem | The entire power subsystem. |
| PowerSupply | A power supply. |
| PowerSupplyBay | Within a power supply bay. |
| Pump | A pump. |
| Rectifier | A rectifier device. |
| Room | The room. |
| StorageBay | Within a storage bay. |
| StorageDevice | A storage device. |
| SystemBoard | The system board (PCB). |
| Transceiver | A transceiver.
|
| Transformer | A transformer. |
| TrustedModule | A trusted module. |
| Upper | The upper portion of the chassis. |
| VoltageRegulator | A voltage regulator device. |
6.135.4.2 IndicatorLED
The state of the indicator LED, which identifies this fan.
- This property shall contain the state of the indicator light associated with this fan.
| string | Description |
|---|---|
| Blinking | The indicator LED is blinking.
|
| Lit | The indicator LED is lit.
|
| Off | The indicator LED is off.
|
6.135.4.3 PhysicalContext
The area or device associated with this fan.
- This property shall contain a description of the affected device or region within the chassis with which this fan is associated.
| string | Description |
|---|---|
| Accelerator | An accelerator. |
| ACInput | An AC input. |
| ACMaintenanceBypassInput | An AC maintenance bypass input. |
| ACOutput | An AC output. |
| ACStaticBypassInput | An AC static bypass input. |
| ACUtilityInput | An AC utility input. |
| ASIC | An ASIC device, such as a networking chip or chipset component. |
| Back | The back of the chassis. |
| Backplane | A backplane within the chassis. |
| Battery | A battery. |
| Board | A circuit board.
|
| Chassis | The entire chassis. |
| ComputeBay | Within a compute bay. |
| CoolingSubsystem | The entire cooling, or air and liquid, subsystem. |
| CPU | A processor (CPU). |
| CPUSubsystem | The entire processor (CPU) subsystem. |
| DCBus | A DC bus. |
| Exhaust | The air exhaust point or points or region of the chassis. |
| ExpansionBay | Within an expansion bay. |
| Fan | A fan. |
| FPGA | An FPGA. |
| Front | The front of the chassis. |
| GPU | A graphics processor (GPU). |
| GPUSubsystem | The entire graphics processor (GPU) subsystem. |
| Intake | The air intake point or points or region of the chassis. |
| LiquidInlet | The liquid inlet point of the chassis. |
| LiquidOutlet | The liquid outlet point of the chassis. |
| Lower | The lower portion of the chassis. |
| Memory | A memory device. |
| MemorySubsystem | The entire memory subsystem. |
| Motor | A motor. |
| NetworkBay | Within a networking bay. |
| NetworkingDevice | A networking device. |
| PowerSubsystem | The entire power subsystem. |
| PowerSupply | A power supply. |
| PowerSupplyBay | Within a power supply bay. |
| Pump | A pump. |
| Rectifier | A rectifier device. |
| Room | The room. |
| StorageBay | Within a storage bay. |
| StorageDevice | A storage device. |
| SystemBoard | The system board (PCB). |
| Transceiver | A transceiver.
|
| Transformer | A transformer. |
| TrustedModule | A trusted module. |
| Upper | The upper portion of the chassis. |
| VoltageRegulator | A voltage regulator device. |
6.135.4.4 ReadingUnits
The units in which the fan reading and thresholds are measured.
- This property shall contain the units in which the fan reading and thresholds are measured.
| string | Description |
|---|---|
| Percent | The fan reading and thresholds are measured as a percentage. |
| RPM | The fan reading and thresholds are measured in revolutions per minute. |
6.135.5 Example response
{
"@odata.type": "#Thermal.v1_7_1.Thermal",
"Id": "Thermal",
"Name": "Thermal",
"Temperatures": [
{
"@odata.id": "/redfish/v1/Chassis/1U/Thermal#/Temperatures/0",
"MemberId": "0",
"Name": "CPU1 Temp",
"SensorNumber": 5,
"Status": {
"State": "Enabled",
"Health": "OK"
},
"ReadingCelsius": 41,
"UpperThresholdNonCritical": 42,
"UpperThresholdCritical": 45,
"UpperThresholdFatal": 48,
"MinReadingRangeTemp": 0,
"MaxReadingRangeTemp": 60,
"PhysicalContext": "CPU",
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Systems/437XR1138R2/Processors/CPU1"
}
]
},
{
"@odata.id": "/redfish/v1/Chassis/1U/Thermal#/Temperatures/1",
"MemberId": "1",
"Name": "CPU2 Temp",
"SensorNumber": 6,
"Status": {
"State": "Disabled"
},
"UpperThresholdNonCritical": 42,
"UpperThresholdCritical": 45,
"UpperThresholdFatal": 48,
"MinReadingRangeTemp": 0,
"MaxReadingRangeTemp": 60,
"PhysicalContext": "CPU",
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Systems/437XR1138R2/Processors/CPU2"
}
]
},
{
"@odata.id": "/redfish/v1/Chassis/1U/Thermal#/Temperatures/2",
"MemberId": "2",
"Name": "Chassis Intake Temp",
"SensorNumber": 9,
"Status": {
"State": "Enabled",
"Health": "OK"
},
"ReadingCelsius": 25,
"UpperThresholdUser": 28,
"UpperThresholdNonCritical": 30,
"UpperThresholdCritical": 40,
"UpperThresholdFatal": 50,
"LowerThresholdUser": 20,
"LowerThresholdNonCritical": 10,
"LowerThresholdCritical": 5,
"LowerThresholdFatal": 0,
"MinReadingRangeTemp": 0,
"MaxReadingRangeTemp": 60,
"PhysicalContext": "Intake",
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Chassis/1U"
},
{
"@odata.id": "/redfish/v1/Systems/437XR1138R2"
}
]
}
],
"Fans": [
{
"@odata.id": "/redfish/v1/Chassis/1U/Thermal#/Fans/0",
"MemberId": "0",
"Name": "BaseBoard System Fan",
"PhysicalContext": "Backplane",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Reading": 2100,
"ReadingUnits": "RPM",
"LowerThresholdFatal": 0,
"MinReadingRange": 0,
"MaxReadingRange": 5000,
"Redundancy": [
{
"@odata.id": "/redfish/v1/Chassis/1U/Thermal#/Redundancy/0"
}
],
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Systems/437XR1138R2"
},
{
"@odata.id": "/redfish/v1/Chassis/1U"
}
]
},
{
"@odata.id": "/redfish/v1/Chassis/1U/Thermal#/Fans/1",
"MemberId": "1",
"Name": "BaseBoard System Fan Backup",
"PhysicalContext": "Backplane",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Reading": 2050,
"ReadingUnits": "RPM",
"LowerThresholdFatal": 0,
"MinReadingRange": 0,
"MaxReadingRange": 5000,
"Redundancy": [
{
"@odata.id": "/redfish/v1/Chassis/1U/Thermal#/Redundancy/0"
}
],
"RelatedItem": [
{
"@odata.id": "/redfish/v1/Systems/437XR1138R2"
},
{
"@odata.id": "/redfish/v1/Chassis/1U"
}
]
}
],
"Redundancy": [
{
"@odata.id": "/redfish/v1/Chassis/1U/Thermal#/Redundancy/0",
"MemberId": "0",
"Name": "BaseBoard System Fans",
"RedundancySet": [
{
"@odata.id": "/redfish/v1/Chassis/1U/Thermal#/Fans/0"
},
{
"@odata.id": "/redfish/v1/Chassis/1U/Thermal#/Fans/1"
}
],
"Mode": "N+m",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"MinNumNeeded": 1,
"MaxNumSupported": 2
}
],
"@odata.id": "/redfish/v1/Chassis/1U/Thermal"
}6.136 ThermalEquipment 1.1.0
| Version | v1.1 | v1.0 |
| Release | 2023.2 | 2023.1 |
6.136.1 Description
This is the schema definition for the set of cooling equipment.
- This resource shall represent the set of cooling equipment for a Redfish implementation.
6.136.2 URIs
/redfish/v1/ThermalEquipment
6.136.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| CDUs { | object | A link to a collection of cooling
distribution units.
|
|
| @odata.id | string | read-only | Link to Collection of CoolingUnit. See the CoolingUnit schema for details. |
| } | |||
| CoolingLoopRedundancy (v1.1+) [ { } ] | array (object) | The redundancy information for the devices
in a redundancy group.
|
|
| CoolingLoops { | object | A link to a collection of cooling
loops.
|
|
| @odata.id | string | read-only | Link to Collection of CoolingLoop. See the CoolingLoop schema for details. |
| } | |||
| HeatExchangers { | object | A link to a collection of heat exchanger
units.
|
|
| @odata.id | string | read-only | Link to Collection of CoolingUnit. See the CoolingUnit schema for details. |
| } | |||
| ImmersionUnits { | object | A link to a collection of immersion
cooling units.
|
|
| @odata.id | string | read-only | Link to Collection of CoolingUnit. See the CoolingUnit schema for details. |
| } | |||
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
6.136.4 Example response
{
"@odata.type": "#ThermalEquipment.v1_1_0.ThermalEquipment",
"Id": "ThermalEquipment",
"Name": "Cooling Equipment",
"Status": {
"State": "Enabled",
"HealthRollup": "OK"
},
"CDUs": {
"@odata.id": "/redfish/v1/ThermalEquipment/CDUs"
},
"CoolingLoops": {
"@odata.id": "/redfish/v1/ThermalEquipment/CoolingLoops"
},
"@odata.id": "/redfish/v1/ThermalEquipment"
}6.137 ThermalMetrics 1.3.0
| Version | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2023.2 | 2023.1 | 2022.3 | 2020.4 |
6.137.1 Description
The ThermalMetrics schema represents the thermal metrics of a chassis.
- This resource shall represent the thermal metrics of a chassis for a Redfish implementation.
6.137.2 URIs
/redfish/v1/Chassis/{ChassisId}/ThermalSubsystem/ThermalMetrics
6.137.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AirFlowCubicMetersPerMinute (v1.2+) {} | object | The air flow through the chassis
(m^3/min).
|
|
| DeltaPressurekPa (v1.2+) {} | object | The differential pressure
(kPa).
|
|
| EnergykWh (v1.3+) { | object (excerpt) |
Energy consumption (kWh) of the thermal
management subsystem.
|
|
| ApparentkVAh (v1.5+) | number (kV.A.h) |
read-only (null) |
Apparent energy (kVAh).
|
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| LifetimeReading (v1.1+) | number | read-only (null) |
The total accumulation value for this
sensor.
|
| ReactivekVARh (v1.5+) | number (kV.A.h) |
read-only (null) |
Reactive energy (kVARh).
|
| Reading | number | read-only (null) |
The sensor value.
|
| SensorResetTime | string (date-time) |
read-only (null) |
The date and time when the time-based
properties were last reset.
|
| } | |||
| HeaterSummary (v1.1+) { | object | (null) |
The summary of heater metrics for this
chassis.
|
| TotalPrePowerOnHeatingTimeSeconds (v1.1+) | integer | read-only (null) |
The total number of seconds all the
heaters in the thermal subsystem were active while the respective
devices they heat were powered off.
|
| TotalRuntimeHeatingTimeSeconds (v1.1+) | integer | read-only (null) |
The total number of seconds all the
heaters in the thermal subsystem were active while the respective
devices they heat were powered on.
|
| } | |||
| PowerWatts (v1.3+) { | object (excerpt) |
Power consumption (W) of the thermal
management subsystem.
|
|
| ApparentVA | number (V.A) |
read-only (null) |
The product of voltage and current for an
AC circuit, in volt-ampere units.
|
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| PhaseAngleDegrees (v1.5+) | number | read-only (null) |
The phase angle (degrees) between the
current and voltage waveforms.
|
| PowerFactor | number | read-only (null) |
The power factor for this
sensor.
|
| ReactiveVAR | number (V.A) |
read-only (null) |
The square root of the difference term of
squared apparent VA and squared power (Reading) for a circuit, in VAR
units.
|
| Reading | number | read-only (null) |
The sensor value.
|
| } | |||
| TemperatureReadingsCelsius [ { | array (excerpt) |
The temperatures (Celsius) from all
related sensors for this device.
|
|
| 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.
|
| PhysicalSubContext | string (enum) |
read-only (null) |
The usage or location within a device to
which this sensor measurement applies.
|
| Reading | number | read-only (null) |
The sensor value.
|
| } ] | |||
| TemperatureSummaryCelsius { | object | (null) |
The summary temperature readings for this
chassis.
|
| Ambient {} | object | The ambient temperature (Celsius) of this
subsystem.
|
|
| Exhaust {} | object | The exhaust temperature (Celsius) of this
subsystem.
|
|
| Intake {} | object | The intake temperature (Celsius) of this
subsystem.
|
|
| Internal {} | object | The internal temperature (Celsius) of this
subsystem.
|
|
| } |
6.137.4 Actions
6.137.4.1 ResetMetrics
Description
This action resets the summary metrics related to this equipment.
- This action shall reset any time intervals or counted values for this equipment.
Action URI
{Base URI of target resource}/Actions/ThermalMetrics.ResetMetrics
Action parameters
This action takes no parameters.
6.137.5 Property details
6.137.5.1 PhysicalContext
The area or device to which this sensor measurement applies.
- This property shall contain a description of the affected component or region within the equipment 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. |
| Battery | A battery. |
| Board | A circuit board.
|
| Chassis | The entire chassis. |
| ComputeBay | Within a compute bay. |
| CoolingSubsystem | The entire cooling, or air and liquid, subsystem. |
| CPU | A processor (CPU). |
| CPUSubsystem | The entire processor (CPU) subsystem. |
| DCBus | A DC bus. |
| Exhaust | The air exhaust point or points or region of the chassis. |
| ExpansionBay | Within an expansion bay. |
| Fan | A fan. |
| FPGA | An FPGA. |
| Front | The front of the chassis. |
| GPU | A graphics processor (GPU). |
| GPUSubsystem | The entire graphics processor (GPU) subsystem. |
| Intake | The air intake point or points or region of the chassis. |
| LiquidInlet | The liquid inlet point of the chassis. |
| LiquidOutlet | The liquid outlet point of the chassis. |
| Lower | The lower portion of the chassis. |
| Memory | A memory device. |
| MemorySubsystem | The entire memory subsystem. |
| Motor | A motor. |
| NetworkBay | Within a networking bay. |
| NetworkingDevice | A networking device. |
| PowerSubsystem | The entire power subsystem. |
| PowerSupply | A power supply. |
| PowerSupplyBay | Within a power supply bay. |
| Pump | A pump. |
| Rectifier | A rectifier device. |
| Room | The room. |
| StorageBay | Within a storage bay. |
| StorageDevice | A storage device. |
| SystemBoard | The system board (PCB). |
| Transceiver | A transceiver.
|
| Transformer | A transformer. |
| TrustedModule | A trusted module. |
| Upper | The upper portion of the chassis. |
| VoltageRegulator | A voltage regulator device. |
6.137.5.2 PhysicalSubContext
The usage or location within a device to which this sensor measurement applies.
- This property shall contain a description of the usage or sub-region within the equipment to which this sensor measurement applies. This property generally differentiates multiple sensors within the same PhysicalContext instance.
| string | Description |
|---|---|
| Input | The input. |
| Output | The output. |
6.137.5.3 SensorExcerpt
The Sensor schema describes a sensor and its properties. This object is an excerpt of the Sensor resource located at the URI shown in DataSourceUri.
| DataSourceUri | string (URI) |
read-only (null) |
The link to the resource that provides the
data for this sensor.
|
| Reading | number | read-only (null) |
The sensor value.
|
6.137.6 Example response
{
"@odata.type": "#ThermalMetrics.v1_3_0.ThermalMetrics",
"Id": "ThermalMetrics",
"Name": "Chassis Thermal Metrics",
"TemperatureSummaryCelsius": {
"Internal": {
"Reading": 39,
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/CPU1Temp"
},
"Intake": {
"Reading": 24.8,
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/IntakeTemp"
},
"Ambient": {
"Reading": 22.5,
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/AmbientTemp"
},
"Exhaust": {
"Reading": 40.5,
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/ExhaustTemp"
}
},
"PowerWatts": {
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/FanTotalPower",
"Reading": 24.72
},
"EnergykWh": {
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/FanTotalEnergy",
"Reading": 38.84
},
"TemperatureReadingsCelsius": [
{
"Reading": 40,
"DeviceName": "SystemBoard",
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/SysBrdTemp"
},
{
"Reading": 24.8,
"DeviceName": "Intake",
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/IntakeTemp"
},
{
"Reading": 39,
"DeviceName": "CPUSubsystem",
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/CPUTemps"
},
{
"Reading": 42,
"DeviceName": "MemorySubsystem",
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/MemoryTemp"
},
{
"Reading": 33,
"DeviceName": "PowerSupply",
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/PSTemp"
},
{
"Reading": 40.5,
"DeviceName": "Exhaust",
"DataSourceUri": "/redfish/v1/Chassis/1U/Sensors/ExhaustTemp"
}
],
"@odata.id": "/redfish/v1/Chassis/1U/ThermalSubsystem/ThermalMetrics"
}6.138 ThermalSubsystem 1.3.0
| Version | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2023.2 | 2023.1 | 2022.3 | 2020.4 |
6.138.1 Description
This ThermalSubsystem schema contains the definition for the thermal subsystem of a chassis.
- This resource shall represent a thermal subsystem for a Redfish implementation.
6.138.2 URIs
/redfish/v1/Chassis/{ChassisId}/ThermalSubsystem
6.138.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| CoolantConnectorRedundancy (v1.3+) [ { } ] | array (object) | The redundancy information for the devices
in a redundancy group.
|
|
| CoolantConnectors (v1.2+) { | object | A link to the coolant connectors for this
equipment.
|
|
| @odata.id | string | read-only | Link to Collection of CoolantConnector. See the CoolantConnector schema for details. |
| } | |||
| FanRedundancy [ { } ] | array (object) | The redundancy information for the devices
in a redundancy group.
|
|
| Fans { | object | The link to the collection of fans within
this subsystem.
|
|
| @odata.id | string | read-only | Link to Collection of Fan. See the Fan schema for details. |
| } | |||
| Heaters (v1.1+) { | object | The link to the collection of heaters
within this subsystem.
|
|
| @odata.id | string | read-only | Link to Collection of Heater. See the Heater schema for details. |
| } | |||
| LeakDetection (v1.3+) { | object | The link to the leak detection system
within this chassis.
|
|
| @odata.id | string | read-only | Link to a LeakDetection resource. See the Links section and the LeakDetection schema for details. |
| } | |||
| Pumps (v1.3+) { | object | A link to the pumps for this
equipment.
|
|
| @odata.id | string | read-only | Link to Collection of Pump. See the Pump schema for details. |
| } | |||
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| ThermalMetrics { | object | The link to the summary of thermal metrics
for this subsystem.
|
|
| @odata.id | string | read-only | Link to a ThermalMetrics resource. See the Links section and the ThermalMetrics schema for details. |
| } |
6.138.4 Example response
{
"@odata.type": "#ThermalSubsystem.v1_3_0.ThermalSubsystem",
"Id": "ThermalSubsystem",
"Name": "Thermal Subsystem for Chassis",
"FanRedundancy": [
{
"RedundancyType": "NPlusM",
"MaxSupportedInGroup": 2,
"MinNeededInGroup": 1,
"RedundancyGroup": [
{
"@odata.id": "/redfish/v1/Chassis/1U/ThermalSubsystem/Fans/Bay1"
},
{
"@odata.id": "/redfish/v1/Chassis/1U/ThermalSubsystem/Fans/Bay2"
}
],
"Status": {
"State": "Enabled",
"Health": "OK"
}
},
{
"RedundancyType": "NPlusM",
"MaxSupportedInGroup": 2,
"MinNeededInGroup": 1,
"RedundancyGroup": [
{
"@odata.id": "/redfish/v1/Chassis/1U/ThermalSubsystem/Fans/CPU1"
},
{
"@odata.id": "/redfish/v1/Chassis/1U/ThermalSubsystem/Fans/CPU2"
}
],
"Status": {
"State": "Disabled"
}
}
],
"Fans": {
"@odata.id": "/redfish/v1/Chassis/1U/ThermalSubsystem/Fans"
},
"ThermalMetrics": {
"@odata.id": "/redfish/v1/Chassis/1U/ThermalSubsystem/ThermalMetrics"
},
"Status": {
"State": "Enabled",
"Health": "OK"
},
"@odata.id": "/redfish/v1/Chassis/1U/ThermalSubsystem"
}6.139 Triggers 1.3.2
| Version | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2023.1 | 2021.2 | 2019.1 | 2018.2 |
6.139.1 Description
The Triggers schema describes a trigger that applies to metrics.
- This resource shall contain a trigger that applies to metrics.
6.139.2 URIs
/redfish/v1/TelemetryService/Triggers/{TriggersId}
6.139.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| DiscreteTriggerCondition | string (enum) |
read-only (null) |
The conditions when a discrete metric
triggers.
|
| DiscreteTriggers [ { | array | The list of discrete triggers.
|
|
| DwellTime | string (duration) |
read-write (null) |
The amount of time that a trigger event
persists before the metric action is performed.
^P(\d+D)?(T(\d+H)?(\d+M)?(\d+(.\d+)?S)?)?$ |
| Name | string | read-only (null) |
The name of trigger.
|
| Severity | string (enum) |
read-write (null) |
The severity of the event
message.
|
| Value | string | read-write (null) |
The discrete metric value that constitutes
a trigger event.
|
| } ] | |||
| EventTriggers (v1.1+) [ ] | array (string, null) | read-write | The array of MessageIds that specify when
a trigger condition is met based on an event.
^[A-Za-z0-9]+\.\d+\.\d+\.[A-Za-z0-9.]+$ |
| HysteresisDuration (v1.3+) | string (duration) |
read-write (null) |
The duration the sensor value must not
violate the threshold before the threshold is deactivated.
^P(\d+D)?(T(\d+H)?(\d+M)?(\d+(.\d+)?S)?)?$ |
| HysteresisReading (v1.3+) | number | read-write (null) |
The reading offset from the threshold
value required to clear the threshold.
|
| Links (v1.1+) { | object | The links to other resources that are
related to this resource.
|
|
| MetricReportDefinitions (v1.1+) [ { | array | The metric report definitions that
generate new metric reports when a trigger condition is met and when the
TriggerActions property contains
RedfishMetricReport.
|
|
| @odata.id | string | read-write | Link to a MetricReportDefinition resource. See the Links section and the MetricReportDefinition schema for details. |
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| } | |||
| MetricIds (v1.2+) [ ] | array (string, null) | read-write | The label for the metric definitions that
contain the property identifiers for this trigger. It matches the Id
property of the corresponding metric definition.
|
| MetricProperties [ ] | array (URI) (string, null) |
read-write | An array of URIs with wildcards and
property identifiers for this trigger. Each wildcard is replaced with
its corresponding entry in the Wildcard array property.
|
| MetricType | string (enum) |
read-only (null) |
The metric type of the
trigger.
|
| NumericThresholds { | object | The thresholds when a numeric metric
triggers.
|
|
| LowerCritical {} | object | The value at which the reading is below
normal range and requires attention.
|
|
| LowerWarning {} | object | The value at which the reading is below
normal range.
|
|
| UpperCritical {} | object | The value at which the reading is above
normal range and requires attention.
|
|
| UpperWarning {} | object | The value at which the reading is above
normal range.
|
|
| } | |||
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| TriggerActions [ ] | array (string (enum)) |
read-only | The actions to perform when a trigger
condition is met.
|
| Wildcards [ { | array | The wildcards and their substitution
values for the entries in the MetricProperties array
property.
|
|
| Name | string | read-only (null) |
The wildcard.
|
| Values [ ] | array (string, null) | read-only | An array of values to substitute for the
wildcard.
|
| } ] |
6.139.4 Property details
6.139.4.1 Activation
The direction of crossing that activates this threshold.
- This property shall indicate the direction of crossing of the reading for this sensor that activates the threshold.
| string | Description |
|---|---|
| Decreasing | Value decreases below the
threshold.
|
| Disabled (v1.3+) | The threshold is disabled.
|
| Either | Value crosses the threshold in either
direction.
|
| Increasing | Value increases above the
threshold.
|
6.139.4.2 DiscreteTriggerCondition
The conditions when a discrete metric triggers.
- This property shall contain the conditions when a discrete metric triggers.
| string | Description |
|---|---|
| Changed | A discrete trigger condition is met whenever the metric value changes. |
| Specified | A discrete trigger condition is met when the metric value becomes one of the values that the DiscreteTriggers property lists. |
6.139.4.3 MetricType
The metric type of the trigger.
- This property shall contain the metric type of the trigger.
| string | Description |
|---|---|
| Discrete | The trigger is for a discrete sensor. |
| Numeric | The trigger is for numeric sensor. |
6.139.4.4 Severity
The severity of the event message.
- This property shall contain the Severity property to be used in the event message.
| string | Description |
|---|---|
| Critical | A critical condition requires immediate attention. |
| OK | Normal. |
| Warning | A condition requires attention. |
6.139.4.5 Threshold
A threshold definition for a sensor.
| Activation | string (enum) |
read-write (null) |
The direction of crossing that activates
this threshold.
|
| DwellTime | string (duration) |
read-write (null) |
The duration the sensor value must violate
the threshold before the threshold is activated.
^P(\d+D)?(T(\d+H)?(\d+M)?(\d+(.\d+)?S)?)?$ |
| Reading | number | read-write (null) |
The threshold value.
|
6.139.4.6 TriggerActions
The actions to perform when a trigger condition is met.
- The
actions that the trigger initiates.
- This property shall contain the actions that the trigger initiates.
| string | Description |
|---|---|
| LogToLogService | When a trigger condition is met, record in
a log.
|
| RedfishEvent | When a trigger condition is met, the
service sends an event to subscribers.
|
| RedfishMetricReport | When a trigger condition is met, force an
update of the specified metric reports.
|
6.139.5 Example response
{
"@odata.type": "#Triggers.v1_3_2.Triggers",
"Id": "PlatformPowerCapTriggers",
"Name": "Triggers for platform power consumed",
"MetricType": "Numeric",
"TriggerActions": [
"RedfishEvent"
],
"NumericThresholds": {
"UpperCritical": {
"Reading": 50,
"Activation": "Increasing",
"DwellTime": "PT0.001S"
},
"UpperWarning": {
"Reading": 48.1,
"Activation": "Increasing",
"DwellTime": "PT0.004S"
}
},
"MetricProperties": [
"/redfish/v1/Chassis/1/Power#/PowerControl/0/PowerConsumedWatts"
],
"@odata.id": "/redfish/v1/TelemetryService/Triggers/PlatformPowerCapTriggers"
}6.140 TrustedComponent 1.2.0
| Version | v1.2 | v1.1 | v1.0 |
| Release | 2023.2 | 2023.1 | 2022.2 |
6.140.1 Description
The TrustedComponent resource represents a trusted device, such as a TPM.
- This resource shall represent a trusted component in a Redfish implementation.
6.140.2 URIs
/redfish/v1/Chassis/{ChassisId}/TrustedComponents/{TrustedComponentId}
6.140.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Certificates { | object | The link to a collection of device
identity certificates of the trusted component.
|
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| FirmwareVersion | string | read-only (null) |
The software version of the active
software image on the trusted component.
|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| ActiveSoftwareImage { | object | The link to the software inventory
resource that represents the active firmware image for this trusted
component.
|
|
| @odata.id | string | read-write | Link to a SoftwareInventory resource. See the Links section and the SoftwareInventory schema for details. |
| } | |||
| ComponentIntegrity [ { | array | An array of links to ComponentIntegrity
resources for which the trusted component is responsible.
|
|
| @odata.id | string | read-only | Link to a ComponentIntegrity resource. See the Links section and the ComponentIntegrity schema for details. |
| } ] | |||
| ComponentsProtected [ { | array | An array of links to resources that the
target component protects.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| IntegratedInto { | object | A link to a resource to which this trusted
component is integrated.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| Owner (v1.2+) { | object | A link to the resource that owns this
trusted component.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } | |||
| SoftwareImages [ { | array | The images that are associated with this
trusted component.
|
|
| @odata.id | string | read-only | Link to a SoftwareInventory resource. See the Links section and the SoftwareInventory schema for details. |
| } ] | |||
| } | |||
| Manufacturer | string | read-only (null) |
The manufacturer of this trusted
component.
|
| Model | string | read-only (null) |
The model number of the trusted
component.
|
| PartNumber | string | read-only (null) |
The part number of the trusted
component.
|
| SerialNumber | string | read-only (null) |
The serial number of the trusted
component.
|
| SKU | string | read-only (null) |
The SKU of the trusted
component.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| TPM (v1.1+) { | object | TPM-specific information for this trusted
component.
|
|
| CapabilitiesVendorID (v1.1+) | string | read-only (null) |
The capabilities vendor ID for this
trusted component.
|
| HardwareInterfaceVendorID (v1.1+) | string | read-only (null) |
The hardware interface vendor ID for this
trusted component.
^0[xX]([0-9A-Fa-f]{2}){2}$ |
| } | |||
| TrustedComponentType | string (enum) |
read-only required | The type of trusted component, such as any
physical distinction about the trusted component.
|
| UUID | string (uuid) |
read-only (null) |
The UUID for this trusted
component.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ |
6.140.4 Property details
6.140.4.1 TrustedComponentType
The type of trusted component, such as any physical distinction about the trusted component.
- This property shall contain the type of trusted component.
| string | Description |
|---|---|
| Discrete | A discrete trusted component.
|
| Integrated | An integrated trusted
component.
|
6.140.5 Example response
{
"@odata.type": "#TrustedComponent.v1_2_0.TrustedComponent",
"Id": "iRoT0",
"UUID": "A3981CF9-576A-4335-A19F-B8CD7EC2821E",
"Status": {
"Health": "OK",
"State": "Enabled"
},
"TrustedComponentType": "Integrated",
"Certificates": {
"@odata.id": "/redfish/v1/Chassis/1U/TrustedComponents/iRoT0/Certificates"
},
"Links": {
"ComponentsProtected": [
{
"@odata.id": "/redfish/v1/Systems/437XR1138R2/Processors/CPU1"
}
],
"IntegratedInto": {
"@odata.id": "/redfish/v1/Systems/437XR1138R2/Processors/CPU1"
},
"ComponentIntegrity": [
{
"@odata.id": "/redfish/v1/ComponentIntegrity/SS-SPDM-1"
}
]
},
"@odata.id": "/redfish/v1/Chassis/1U/TrustedComponents/iRoT0"
}6.141 UpdateService 1.12.0
| Version | v1.12 | v1.11 | v1.10 | v1.9 | v1.8 | v1.7 | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 | ... |
| Release | 2023.2 | 2021.4 | 2021.2 | 2021.1 | 2019.4 | 2019.3 | 2019.2 | 2019.1 | 2018.3 | 2018.2 | 2017.1 | ... |
6.141.1 Description
The UpdateService schema describes the update service and the properties for the service itself with links to collections of firmware and software inventory. The update service also provides methods for updating software and firmware of the resources in a Redfish service.
- This resource shall represent an update service and the properties that affect the service itself for a Redfish implementation.
6.141.2 URIs
/redfish/v1/UpdateService
6.141.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| ClientCertificates (v1.10+) { | object | The link to a collection of client
identity certificates provided to the server referenced by the ImageURI
property in SimpleUpdate.
|
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| FirmwareInventory { | object | An inventory of firmware.
|
|
| @odata.id | string | read-only | Link to Collection of SoftwareInventory. See the SoftwareInventory schema for details. |
| } | |||
| HttpPushUri (v1.1+) | string (URI) |
read-only | The URI used to perform an HTTP or HTTPS
push update to the update service. The format of the message is
vendor-specific.
|
| HttpPushUriOptions (v1.4+) { | object | The options for HttpPushUri-provided
software updates.
|
|
| ForceUpdate (v1.11+) | boolean | read-write | An indication of whether the service
should bypass update policies when applying the HttpPushUri-provided
image.
|
| HttpPushUriApplyTime (v1.4+) { | object | The settings for when to apply
HttpPushUri-provided firmware.
|
|
| ApplyTime (v1.4+) | string (enum) |
read-write | The time when to apply the
HttpPushUri-provided software update.
|
| MaintenanceWindowDurationInSeconds (v1.4+) | integer (seconds) |
read-write | The expiry time, in seconds, of the
maintenance window.
|
| MaintenanceWindowStartTime (v1.4+) | string (date-time) |
read-write | The start time of a maintenance
window.
|
| } | |||
| } | |||
| HttpPushUriOptionsBusy (v1.4+) | boolean | read-write (null) |
An indication of whether a client has
reserved the HttpPushUriOptions properties for software
updates.
|
| HttpPushUriTargets (v1.2+) [ ] | array (URI) (string, null) |
read-write | An array of URIs that indicate where to
apply the update image.
|
| HttpPushUriTargetsBusy (v1.2+) | boolean | read-write (null) |
An indication of whether any client has
reserved the HttpPushUriTargets property.
|
| MaxImageSizeBytes (v1.5+) | integer (bytes) |
read-only (null) |
The maximum size in bytes of the software
update image that this service supports.
|
| MultipartHttpPushUri (v1.6+) | string (URI) |
read-only | The URI used to perform a Redfish
Specification-defined Multipart HTTP or HTTPS push update to the update
service.
|
| RemoteServerCertificates (v1.9+) { | object | The link to a collection of server
certificates for the server referenced by the ImageURI property in
SimpleUpdate.
|
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| RemoteServerSSHKeys (v1.12+) { | object | The link to a collection of keys that can
be used to authenticate the server referenced by the ImageURI property
in SimpleUpdate.
|
|
| @odata.id | string | read-only | Link to Collection of Key. See the Key schema for details. |
| } | |||
| ServiceEnabled | boolean | read-write (null) |
An indication of whether this service is
enabled.
|
| SoftwareInventory { | object | An inventory of software.
|
|
| @odata.id | string | read-only | Link to Collection of SoftwareInventory. See the SoftwareInventory schema for details. |
| } | |||
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| VerifyRemoteServerCertificate (v1.9+) | boolean | read-write (null) |
An indication of whether the service will
verify the certificate of the server referenced by the ImageURI property
in SimpleUpdate prior to sending the transfer request.
|
| VerifyRemoteServerSSHKey (v1.12+) | boolean | read-write (null) |
An indication of whether the service will
verify the SSH key of the server referenced by the ImageURI property in
SimpleUpdate prior to sending the transfer request.
|
6.141.4 Actions
6.141.4.1 SimpleUpdate
Description
This action updates software components.
- This action shall update installed software components in a software image file located at an ImageURI parameter-specified URI.
Action URI
{Base URI of target resource}/Actions/UpdateService.SimpleUpdate
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| ForceUpdate (v1.11+) | boolean | optional | An indication of whether the service
should bypass update policies when applying the provided image. The
default is false.
|
| ImageURI | string | required | The URI of the software image to
install.
|
| Password (v1.4+) | string | optional | The password to access the URI specified
by the ImageURI parameter.
|
| Targets (v1.2+) [ ] | array (URI) (string) |
optional | An array of URIs that indicate where to
apply the update image.
|
| TransferProtocol | string (enum) |
optional | The network protocol that the update
service uses to retrieve the software image file located at the URI
provided in ImageURI. This parameter is ignored if the URI provided in
ImageURI contains a scheme.
|
| Username (v1.4+) | string | optional | The user name to access the URI specified
by the ImageURI parameter.
|
Request Example
{
"ImageURI": "https://images.contoso.org/bmc_0260_2021.bin"
}6.141.4.2 StartUpdate (v1.7+)
Description
This action starts updating all images that have been previously
invoked using an OperationApplyTime value of
OnStartUpdateRequest.
- This action shall start an
update of software component that have been scheduled with the
OperationApplyTime value of
OnStartUpdateRequest.
Action URI
{Base URI of target resource}/Actions/UpdateService.StartUpdate
Action parameters
This action takes no parameters.
6.141.5 Property details
6.141.5.1 ApplyTime
The time when to apply the HttpPushUri-provided software update.
- This property shall indicate the time when to apply the HttpPushUri-provided software update.
| string | Description |
|---|---|
| AtMaintenanceWindowStart | Apply during an administrator-specified
maintenance window.
|
| Immediate | Apply immediately.
|
| InMaintenanceWindowOnReset | Apply after a reset but within an
administrator-specified maintenance window.
|
| OnReset | Apply on a reset.
|
| OnStartUpdateRequest (v1.11+) | Apply when the StartUpdate action of the
update service is invoked.
|
6.141.5.2 TransferProtocol
The network protocol that the update service uses to retrieve the software image file located at the URI provided in ImageURI. This parameter is ignored if the URI provided in ImageURI contains a scheme.
- This parameter shall contain the network protocol that the update service shall use to retrieve the software image located at the ImageURI. Services should ignore this parameter if the URI provided in ImageURI contains a scheme. If this parameter is not provided (or supported), and a transfer protocol is not specified by a scheme contained within this URI, the service shall use HTTP to retrieve the image.
| string | Description |
|---|---|
| CIFS | Common Internet File System (CIFS). |
| FTP | File Transfer Protocol (FTP). |
| HTTP | Hypertext Transfer Protocol (HTTP). |
| HTTPS | Hypertext Transfer Protocol Secure (HTTPS). |
| NFS (v1.3+) | Network File System (NFS). |
| NSF (deprecated v1.3) | Network File System (NFS). Deprecated in v1.3 and later. This value has been deprecated in favor of NFS. |
| OEM | A manufacturer-defined protocol. |
| SCP | Secure Copy Protocol (SCP). |
| SFTP (v1.1+) | Secure File Transfer Protocol (SFTP). |
| TFTP | Trivial File Transfer Protocol (TFTP). |
6.141.6 Example response
{
"@odata.type": "#UpdateService.v1_12_0.UpdateService",
"Id": "UpdateService",
"Name": "Update service",
"Status": {
"State": "Enabled",
"Health": "OK",
"HealthRollup": "OK"
},
"ServiceEnabled": true,
"HttpPushUri": "/FWUpdate",
"FirmwareInventory": {
"@odata.id": "/redfish/v1/UpdateService/FirmwareInventory"
},
"SoftwareInventory": {
"@odata.id": "/redfish/v1/UpdateService/SoftwareInventory"
},
"Actions": {
"#UpdateService.SimpleUpdate": {
"target": "/redfish/v1/UpdateService/Actions/SimpleUpdate",
"@Redfish.ActionInfo": "/redfish/v1/UpdateService/SimpleUpdateActionInfo"
}
},
"@odata.id": "/redfish/v1/UpdateService"
}6.142 USBController 1.0.0
| Version | v1.0 |
| Release | 2021.1 |
6.142.1 Description
The USBController schema defines a Universal Serial Bus controller.
- This resource shall represent a USB controller in a Redfish implementation.
6.142.2 URIs
/redfish/v1/Systems/{ComputerSystemId}/USBControllers/{ControllerId}
6.142.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Links { | object | The links to other resources that are
related to this resource.
|
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| PCIeDevice { | object | (null) |
A link to the PCIe device that represents
this USB controller.
|
| @odata.id | string | read-only | Link to a PCIeDevice resource. See the Links section and the PCIeDevice schema for details. |
| } | |||
| Processors [ { | array | An array of links to the processors that
can utilize this USB controller.
|
|
| @odata.id | string | read-only | Link to a Processor resource. See the Links section and the Processor schema for details. |
| } ] | |||
| } | |||
| Manufacturer | string | read-only (null) |
The manufacturer of this USB
controller.
|
| Model | string | read-only (null) |
The product model number of this USB
controller.
|
| PartNumber | string | read-only (null) |
The part number for this USB
controller.
|
| Ports { | object | The ports of the USB
controller.
|
|
| @odata.id | string | read-only | Link to Collection of Port. See the Port schema for details. |
| } | |||
| SerialNumber | string | read-only (null) |
The serial number for this USB
controller.
|
| SKU | string | read-only (null) |
The SKU for this USB
controller.
|
| SparePartNumber | string | read-only (null) |
The spare part number of the USB
controller.
|
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
6.142.4 Example response
{
"@odata.type": "#USBController.v1_0_0.USBController",
"Id": "USB1",
"Name": "Contoso USB Controller 1",
"Manufacturer": "Contoso",
"Model": "USBv3",
"SKU": "80937",
"SerialNumber": "2M220100SL",
"PartNumber": "G37891",
"SparePartNumber": "G37890",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Ports": {
"@odata.id": "/redfish/v1/Systems/1/USBControllers/USB1/Ports"
},
"Links": {
"Processors": [
{
"@odata.id": "/redfish/v1/Systems/1/Processors/1"
},
{
"@odata.id": "/redfish/v1/Systems/1/Processors/2"
}
]
},
"@odata.id": "/redfish/v1/Systems/1/USBControllers/USB1"
}6.143 VCATEntry 1.0.1
| Version | v1.0 |
| Release | 2019.4 |
6.143.1 Description
The VCATEntry schema defines an entry in a Virtual Channel Action Table. A Virtual Channel is a mechanism used to create multiple, logical communication streams across a physical link.
- This resource shall represent and entry of Virtual Channel Action Table in a Redfish implementation.
6.143.2 URIs
/redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/GenZ/REQ-VCAT/{VCATEntryId}
/redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/GenZ/RSP-VCAT/{VCATEntryId}
/redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/GenZ/VCAT/{VCATEntryId}
/redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/VCAT/{VCATEntryId}
(deprecated)
/redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/REQ-VCAT/{VCATEntryId}
(deprecated)
/redfish/v1/Chassis/{ChassisId}/FabricAdapters/{FabricAdapterId}/RSP-VCAT/{VCATEntryId}
(deprecated)
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/GenZ/REQ-VCAT/{VCATEntryId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/GenZ/RSP-VCAT/{VCATEntryId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/GenZ/VCAT/{VCATEntryId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/VCAT/{VCATEntryId}
(deprecated)
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/REQ-VCAT/{VCATEntryId}
(deprecated)
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/RSP-VCAT/{VCATEntryId}
(deprecated)
/redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortId}/GenZ/VCAT/{VCATEntryId}
/redfish/v1/Fabrics/{FabricId}/Switches/{SwitchId}/Ports/{PortId}/VCAT/{VCATEntryId}
(deprecated)
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/GenZ/REQ-VCAT/{VCATEntryId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/GenZ/RSP-VCAT/{VCATEntryId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/GenZ/VCAT/{VCATEntryId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/VCAT/{VCATEntryId}
(deprecated)
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/REQ-VCAT/{VCATEntryId}
(deprecated)
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/RSP-VCAT/{VCATEntryId}
(deprecated)
/redfish/v1/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/GenZ/REQ-VCAT/{VCATEntryId}
/redfish/v1/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/GenZ/RSP-VCAT/{VCATEntryId}
/redfish/v1/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/GenZ/VCAT/{VCATEntryId}
/redfish/v1/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/Ports/{PortId}/VCAT/{VCATEntryId}
(deprecated)
/redfish/v1/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/REQ-VCAT/{VCATEntryId}
(deprecated)
/redfish/v1/Systems/{SystemId}/FabricAdapters/{FabricAdapterId}/RSP-VCAT/{VCATEntryId}
(deprecated)
6.143.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| RawEntryHex | string | read-write (null) |
The hexadecimal value of the Virtual
Channel Action Table entries.
^0[xX](([a-fA-F]|[0-9])*)$ |
| VCEntries [ { | array | An array of entries of the Virtual Channel
Action Table.
|
|
| Threshold | string | read-write (null) |
The configured threshold.
^0[xX]([a-fA-F]|[0-9]){2}$ |
| VCMask | string | read-write (null) |
The bits corresponding to the supported
Virtual Channel.
^0[xX](([a-fA-F]|[0-9]){2}){4}$ |
| } ] |
6.143.4 Example response
{
"@odata.type": "#VCATEntry.v1_0_1.VCATEntry",
"Id": "0",
"Name": "VCAT Entry 0",
"Description": "Gen-Z Port 1 Virtual Channel Action Table Entry 0",
"RawEntryHex": "0x123456",
"VCEntries": [
{
"VCMask": "0x00000034",
"Threshold": "0x12"
},
{
"VCMask": "0x00000034",
"Threshold": "0x12"
},
{
"VCMask": "0x00000034",
"Threshold": "0x12"
},
{
"VCMask": "0x00000034",
"Threshold": "0x12"
}
],
"@odata.id": "/redfish/v1/Fabrics/GenZ/Switches/Switch1/Ports/1/VCAT/0"
}6.144 VirtualMedia 1.6.2
| Version | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2022.3 | 2021.2 | 2021.1 | 2018.3 | 2017.3 | 2017.1 | 1.0 |
6.144.1 Description
The VirtualMedia schema contains properties related to the monitor and control of an instance of virtual media, such as a remote CD, DVD, or USB device. A manager for a system or device provides virtual media functionality.
- This resource shall represent a virtual media service for a Redfish implementation.
6.144.2 URIs
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/VirtualMedia/{VirtualMediaId}
/redfish/v1/Managers/{ManagerId}/VirtualMedia/{VirtualMediaId}
(deprecated)
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/VirtualMedia/{VirtualMediaId}
/redfish/v1/Systems/{ComputerSystemId}/VirtualMedia/{VirtualMediaId}
6.144.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| Certificates (v1.4+) { | object | The link to a collection of server
certificates for the server referenced by the Image
property.
|
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| ClientCertificates (v1.5+) { | object | The link to a collection of client
identity certificates provided to the server referenced by the Image
property.
|
|
| @odata.id | string | read-only | Link to Collection of Certificate. See the Certificate schema for details. |
| } | |||
| ConnectedVia | string (enum) |
read-only (null) |
The current virtual media connection
method.
|
| EjectPolicy (v1.6+) | string (enum) |
read-write (null) |
The ejection policy for the virtual
media.
|
| EjectTimeout (v1.6+) | string (duration) |
read-write (null) |
Timeout value before the virtual media is
automatically ejected.
^P(\d+D)?(T(\d+H)?(\d+M)?(\d+(.\d+)?S)?)?$ |
| Image | string (URI) |
read-write (null) |
The URI of the location of the selected
image.
|
| ImageName | string | read-only (null) |
The current image name.
|
| Inserted | boolean | read-write (null) |
An indication of whether virtual media is
inserted into the virtual device.
|
| MediaTypes [ ] | array (string (enum)) |
read-only |
|
| Password (v1.3+) | string | read-write (null) |
The password to access the Image
parameter-specified URI. This property is null in responses.
|
| Status (v1.4+) {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| TransferMethod (v1.3+) | string (enum) |
read-write (null) |
The transfer method to use with the
Image.
|
| TransferProtocolType (v1.3+) | string (enum) |
read-write (null) |
The network protocol to use with the
image.
|
| UserName (v1.3+) | string | read-write (null) |
The user name to access the Image
parameter-specified URI.
|
| VerifyCertificate (v1.4+) | boolean | read-write (null) |
An indication of whether the service will
verify the certificate of the server referenced by the Image property
prior to completing the remote media connection.
|
| WriteProtected | boolean | read-write (null) |
An indication of whether the media is
write-protected.
|
6.144.4 Actions
6.144.4.1 EjectMedia (v1.2+)
Description
This action detaches remote media from virtual media.
- This
action shall detach the remote media from the virtual media. At the
completion of the operation, inserted shall be set to
falseand the image name shall be cleared.
Action URI
{Base URI of target resource}/Actions/VirtualMedia.EjectMedia
Action parameters
This action takes no parameters.
6.144.4.2 InsertMedia (v1.2+)
Description
This action attaches remote media to virtual media.
- This action shall attach remote media to virtual media.
Action URI
{Base URI of target resource}/Actions/VirtualMedia.InsertMedia
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| Image | string | required | The URI of the media to attach to the
virtual media.
|
| Inserted | boolean | optional | An indication of whether the image is
treated as inserted upon completion of the action. The default is
true.
|
| Password (v1.3+) | string | optional | The password to access the URI specified
by the Image parameter.
|
| TransferMethod (v1.3+) | string (enum) |
optional | The transfer method to use with the
image.
|
| TransferProtocolType (v1.3+) | string (enum) |
optional | The network protocol to use with the
image.
|
| UserName (v1.3+) | string | optional | The username to access the URI specified
by the Image parameter.
|
| WriteProtected | boolean | optional | An indication of whether the remote media
is treated as write-protected. The default is
true.
|
Request Example
{
"Image": "https://192.168.1.225/boot_image.iso",
"Inserted": true,
"WriteProtected": true
}6.144.5 Property details
6.144.5.1 ConnectedVia
The current virtual media connection method.
- This property shall contain the current connection method from a client to the virtual media that this resource represents.
| string | Description |
|---|---|
| Applet | Connected to a client application. |
| NotConnected | No current connection. |
| Oem | Connected through an OEM-defined method. |
| URI | Connected to a URI location. |
6.144.5.2 EjectPolicy
The ejection policy for the virtual media.
- This property shall contain the ejection policy for the virtual media.
| string | Description |
|---|---|
| AfterUse | The virtual media ejection occurs after the media is used. |
| OnPowerOff | The virtual media ejection occurs during a system power or reset event. |
| Persistent | The virtual media mount information persists indefinitely. |
| Session | The virtual media ejection occurs when a session is terminated. The session might be outside the Redfish service. |
| Timed | The virtual media ejection occurs when a timer configured by the EjectTimeout property expires. |
6.144.5.3 MediaTypes
- The media types supported as virtual media.
- This property shall contain an array of the supported media types for this connection.
| string | Description |
|---|---|
| CD | A CD-ROM format (ISO) image. |
| DVD | A DVD-ROM format image. |
| Floppy | A floppy disk image. |
| USBStick | An emulation of a USB storage device. |
6.144.5.4 TransferMethod
The transfer method to use with the image.
- This parameter shall contain the transfer method to use with the specified image URI.
| string | Description |
|---|---|
| Stream | Stream image file data from the source URI. |
| Upload | Upload the entire image file from the source URI to the service. |
6.144.5.5 TransferProtocolType
The network protocol to use with the image.
- This parameter shall contain the network protocol to use with the specified image URI.
| string | Description |
|---|---|
| CIFS | Common Internet File System (CIFS). |
| FTP | File Transfer Protocol (FTP). |
| HTTP | Hypertext Transfer Protocol (HTTP). |
| HTTPS | Hypertext Transfer Protocol Secure (HTTPS). |
| NFS | Network File System (NFS). |
| OEM | A manufacturer-defined protocol. |
| SCP | Secure Copy Protocol (SCP). |
| SFTP | Secure File Transfer Protocol (SFTP). |
| TFTP | Trivial File Transfer Protocol (TFTP). |
6.144.6 Example response
{
"@odata.type": "#VirtualMedia.v1_6_2.VirtualMedia",
"Id": "CD1",
"Name": "Virtual CD",
"MediaTypes": [
"CD",
"DVD"
],
"Image": "redfish.dmtf.org/freeImages/freeOS.1.1.iso",
"ImageName": "mymedia-read-only",
"ConnectedVia": "Applet",
"Inserted": true,
"WriteProtected": false,
"@odata.id": "/redfish/v1/Managers/BMC/VirtualMedia/CD1"
}6.145 VLanNetworkInterface 1.3.0 (deprecated)
| Version | v1.3 Deprecated | v1.2 | v1.1 | v1.0 |
| Release | 2021.2 | 2020.4 | 2017.1 | 1.0 |
This schema has been deprecated and use in new implementations is discouraged except to retain compatibility with existing products. This schema has been deprecated in favor of using individual EthernetInterface resources to show VLAN information.
6.145.1 Description
The VLanNetworkInterface schema describes a VLAN network instance that is available on a manager, system, or other device.
- This resource contains information for a VLAN network instance that is available on a manager, system, or other device for a Redfish implementation.
6.145.2 URIs
/redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/NetworkDeviceFunctions/{NetworkDeviceFunctionId}/Ethernet/VLANs/{VLanNetworkInterfaceId}
(deprecated)
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/EthernetInterfaces/{EthernetInterfaceId}/VLANs/{VLanNetworkInterfaceId}
(deprecated)
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/EthernetInterfaces/{EthernetInterfaceId}/VLANs/{VLanNetworkInterfaceId}
(deprecated)
/redfish/v1/Managers/{ManagerId}/EthernetInterfaces/{EthernetInterfaceId}/VLANs/{VLanNetworkInterfaceId}
(deprecated)
/redfish/v1/ResourceBlocks/{ResourceBlockId}/EthernetInterfaces/{EthernetInterfaceId}/VLANs/{VLanNetworkInterfaceId}
(deprecated)
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/EthernetInterfaces/{EthernetInterfaceId}/VLANs/{VLanNetworkInterfaceId}
(deprecated)
/redfish/v1/Systems/{ComputerSystemId}/EthernetInterfaces/{EthernetInterfaceId}/VLANs/{VLanNetworkInterfaceId}
(deprecated)
6.145.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| VLANEnable | boolean | read-write required on
create (null) |
An indication of whether this VLAN is
enabled for this 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.
|
6.145.4 Example response
{
"@odata.type": "#VLanNetworkInterface.v1_3_0.VLanNetworkInterface",
"Id": "1",
"Name": "VLAN Network Interface",
"Description": "System NIC 1 VLAN",
"VLANEnable": true,
"VLANId": 101,
"@odata.id": "/redfish/v1/Systems/437XR1138R2/EthernetInterfaces/12446A3B0411/VLANs/1"
}6.146 Volume 1.10.0
| Version | v1.10 | v1.9 | v1.8 | v1.7 | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 |
| Release | 1.2.6 | 1.2.5 | 1.2.4 | 1.2.3 | 1.2.1 | 1.2.0 | 1.1.0 | 1.0.6a | 1.0.5 |
6.146.1 Description
Volume contains properties used to describe a volume, virtual disk, LUN, or other logical storage entity for any system.
- This resource shall be used to represent a volume, virtual disk, logical disk, LUN, or other logical storage for a Redfish implementation.
6.146.2 URIs
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Volumes/{VolumeId}
/redfish/v1/CompositionService/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Volumes/{VolumeId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Storage/{StorageId}/Volumes/{VolumeId}
/redfish/v1/ResourceBlocks/{ResourceBlockId}/Systems/{ComputerSystemId}/Storage/{StorageId}/Volumes/{VolumeId}
/redfish/v1/Storage/{StorageId}/ConsistencyGroups/{ConsistencyGroupId}/Volumes/{VolumeId}
/redfish/v1/Storage/{StorageId}/FileSystems/{FileSystemId}/CapacitySources/{CapacitySourceId}/ProvidingVolumes/{VolumeId}
/redfish/v1/Storage/{StorageId}/StoragePools/{StoragePoolId}/AllocatedVolumes/{VolumeId}
/redfish/v1/Storage/{StorageId}/StoragePools/{StoragePoolId}/CapacitySources/{CapacitySourceId}/ProvidingVolumes/{VolumeId}
/redfish/v1/Storage/{StorageId}/Volumes/{VolumeId}
/redfish/v1/StorageServices/{StorageServiceId}/ConsistencyGroups/{ConsistencyGroupId}/Volumes/{VolumeId}
/redfish/v1/StorageServices/{StorageServiceId}/FileSystems/{FileSystemId}/CapacitySources/{CapacitySourceId}/ProvidingVolumes/{VolumeId}
/redfish/v1/StorageServices/{StorageServiceId}/StoragePools/{StoragePoolId}/AllocatedVolumes/{VolumeId}
/redfish/v1/StorageServices/{StorageServiceId}/StoragePools/{StoragePoolId}/CapacitySources/{CapacitySourceId}/ProvidingVolumes/{VolumeId}
/redfish/v1/StorageServices/{StorageServiceId}/Volumes/{VolumeId}
/redfish/v1/StorageServices/{StorageServiceId}/Volumes/{VolumeId}/CapacitySources/{CapacitySourceId}/ProvidingVolumes/{ProvidingVolumeId}
/redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/ConsistencyGroups/{ConsistencyGroupId}/Volumes/{VolumeId}
/redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/FileSystems/{FileSystemId}/CapacitySources/{CapacitySourceId}/ProvidingVolumes/{VolumeId}
/redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/StoragePools/{StoragePoolId}/AllocatedVolumes/{VolumeId}
/redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/StoragePools/{StoragePoolId}/CapacitySources/{CapacitySourceId}/ProvidingVolumes/{VolumeId}
/redfish/v1/Systems/{ComputerSystemId}/Storage/{StorageId}/Volumes/{VolumeId}
6.146.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| AccessCapabilities (v1.1+) [ ] | array (string (enum)) |
read-write (null) |
Values of StorageAccessCapability describe
abilities to read or write storage.
|
| AllocatedPools (v1.1+) {} | object | An array of references to StoragePools
allocated from this Volume.
|
|
| BlockSizeBytes | integer (bytes) |
read-only (null) |
The size of the smallest addressable unit
(Block) of this volume in bytes.
|
| Capacity (v1.1+) {} | object | Capacity utilization.
|
|
| CapacityBytes | integer (bytes) |
read-write (null) |
The size in bytes of this
Volume.
|
| CapacitySources (v1.1+) [ { | array | An array of space allocations to this
volume.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| Compressed (v1.4+) | boolean | read-write (null) |
Indicator of whether or not the Volume has
compression enabled.
|
| Connections (v1.9+) [ { | array | An array of references to Connections that
includes this volume.
|
|
| @odata.id | string | read-only | Link to a Connection resource. See the Links section and the Connection schema for details. |
| } ] | |||
| Deduplicated (v1.4+) | boolean | read-write (null) |
Indicator of whether or not the Volume has
deduplication enabled.
|
| DisplayName (v1.4+) | string | read-write (null) |
A user-configurable string to name the
volume.
|
| Encrypted | boolean | read-write (null) |
Is this Volume encrypted.
|
| EncryptionTypes [ ] | array (string (enum)) |
read-write |
|
| Identifiers [ { } ] | array (object) | Any additional identifiers for a
resource.
|
|
| InitializeMethod (v1.6+) | string (enum) |
read-only (null) |
Indicates the Initialization Method used
for this volume. If InitializeMethod is not specified, the
InitializeMethod should be Foreground.
|
| IOPerfModeEnabled (v1.5+) | boolean | read-write (null) |
Indicates the IO performance mode setting
for the volume.
|
| IOStatistics (v1.2+) {} | object | Statistics for this volume.
|
|
| IsBootCapable (v1.7+) | boolean | read-write (null) |
This property indicates whether or not the
Volume contains a boot image and is capable of booting.
|
| Links { | object | Contains references to other resources
that are related to this resource.
|
|
| CacheDataVolumes (v1.6+) [ { | array | A pointer to the data volumes this volume
serves as a cache volume.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| CacheVolumeSource (v1.6+) {} | object | (null) |
A pointer to the cache volume source for
this volume.
|
| ClassOfService (v1.1+) {} | object | The ClassOfService that this storage
volume conforms to.
|
|
| ClientEndpoints (v1.4+) [ { | array | An array of references to the client
Endpoints associated with this volume.
|
|
| @odata.id | string | read-only | Link to a Endpoint resource. See the Links section and the Endpoint schema for details. |
| } ] | |||
| ConsistencyGroups (v1.4+) [ { | array | An array of references to the
ConsistencyGroups associated with this volume.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| Controllers (v1.9+) [ { | array | An array of the Controllers associated
with this volume.
|
|
| @odata.id | string | read-only | Link to a StorageController resource. See the Links section and the StorageController schema for details. |
| } ] | |||
| DedicatedSpareDrives (v1.2+) [ { | array | An array of references to the drives which
are dedicated spares for this volume.
|
|
| @odata.id | string | read-write | Link to a Drive resource. See the Links section and the Drive schema for details. |
| } ] | |||
| Drives [ { | array | An array of references to the drives which
contain this volume. This will reference Drives that either wholly or
only partly contain this volume.
|
|
| @odata.id | string | read-only | Link to a Drive resource. See the Links section and the Drive schema for details. |
| } ] | |||
| JournalingMedia (v1.5+) {} | object | (null) |
A pointer to the Resource that serves as a
journaling media for this volume.
|
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| OwningStorageResource (v1.5+) { | object | A pointer to the Storage resource that
owns or contains this volume.
|
|
| @odata.id | string | read-only | Link to a Storage resource. See the Links section and the Storage schema for details. |
| } | |||
| OwningStorageService (v1.4+) {} | object | A pointer to the StorageService that owns
or contains this volume.
|
|
| ServerEndpoints (v1.4+) [ { | array | An array of references to the server
Endpoints associated with this volume.
|
|
| @odata.id | string | read-only | Link to a Endpoint resource. See the Links section and the Endpoint schema for details. |
| } ] | |||
| SpareResourceSets (v1.3+) [ { | array | An array of references to
SpareResourceSets.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| StorageGroups (v1.4+) [ { | array | An array of references to the
StorageGroups associated with this volume.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| } | |||
| LogicalUnitNumber (v1.4+) | integer | read-only (null) |
Indicates the host-visible
LogicalUnitNumber assigned to this Volume.
|
| LowSpaceWarningThresholdPercents (v1.1+) [ ] | array (%) (integer, null) |
read-write | Low space warning.
|
| Manufacturer (v1.1+) | string | read-only (null) |
The manufacturer or OEM of this storage
volume.
|
| MaxBlockSizeBytes (v1.1+) | integer (bytes) |
read-only (null) |
Max Block size in bytes.
|
| MediaSpanCount (v1.4+) | integer | read-only (null) |
Indicates the number of media elements
used per span in the secondary RAID for a hierarchical RAID
type.
|
| Metrics (v1.9+) {} | object | The link to the metrics for this
volume.
|
|
| Model (v1.1+) | string | read-only (null) |
The model number for this storage
volume.
|
| NVMeNamespaceProperties (v1.5+) { | object | (null) |
This property contains properties to use
when Volume is used to describe an NVMe Namespace.
|
| FormattedLBASize (v1.5+) | string | read-only (null) |
The LBA data size and metadata size
combination that the namespace has been formatted with.
|
| IsShareable (v1.5+) | boolean | read-write (null) |
Indicates the namespace is
shareable.
|
| LBAFormat (v1.9+) { | object | (null) |
Describes the current LBA format ID and
detailed properties.
|
| LBADataSizeBytes (v1.9+) | integer | read-only (null) |
The LBA data size in bytes.
|
| LBAFormatType (v1.9+) | string (enum) |
read-only (null) |
The LBA format type.
|
| LBAMetadataSizeBytes (v1.9+) | integer | read-only (null) |
The LBA metadata size in
bytes.
|
| RelativePerformance (v1.9+) | string (enum) |
read-only (null) |
The LBA Relative Performance
type.
|
| } | |||
| LBAFormats (v1.9+) [ { | array | Describes the LBA format IDs and detailed
properties.
|
|
| LBADataSizeBytes (v1.9+) | integer | read-only (null) |
The LBA data size in bytes.
|
| LBAFormatType (v1.9+) | string (enum) |
read-only (null) |
The LBA format type.
|
| LBAMetadataSizeBytes (v1.9+) | integer | read-only (null) |
The LBA metadata size in
bytes.
|
| RelativePerformance (v1.9+) | string (enum) |
read-only (null) |
The LBA Relative Performance
type.
|
| } ] | |||
| LBAFormatsSupported (v1.8+) [ ] | array (string (enum)) |
read-only (null) |
LBAFormatType is defined in the NVMe
specification set. This field indicates the LBA data size supported;
implementations may report up to 16 values. For more details refer to
the appropriate NVMe specification.
|
| MetadataTransferredAtEndOfDataLBA (v1.5+) | boolean | read-only (null) |
This property indicates whether or not the
metadata is transferred at the end of the LBA creating an extended data
LBA.
|
| NamespaceFeatures (v1.5+) { | object | (null) |
This property contains a set of Namespace
Features.
|
| SupportsAtomicTransactionSize (v1.5+) | boolean | read-only (null) |
Indicates that the NVM fields for
Namespace preferred write granularity (NPWG), write alignment (NPWA),
deallocate granularity (NPDG), deallocate alignment (NPDA) and optimal
write size (NOWS) are defined for this namespace and should be used by
the host for I/O optimization.
|
| SupportsDeallocatedOrUnwrittenLBError (v1.5+) | boolean | read-only (null) |
This property indicates that the
controller supports deallocated or unwritten logical block error for
this namespace.
|
| SupportsIOPerformanceHints (v1.5+) | boolean | read-only (null) |
Indicates that the Namespace Atomic Write
Unit Normal (NAWUN), Namespace Atomic Write Unit Power Fail (NAWUPF),
and Namespace Atomic Compare and Write Unit (NACWU) fields are defined
for this namespace and should be used by the host for this namespace
instead of the controller-level properties AWUN, AWUPF, and
ACWU.
|
| SupportsNGUIDReuse (v1.5+) | boolean | read-only (null) |
This property indicates that the namespace
supports the use of an NGUID (namespace globally unique identifier)
value.
|
| SupportsThinProvisioning (v1.5+) | boolean | read-only (null) |
This property indicates whether or not the
NVMe Namespace supports thin provisioning.
|
| } | |||
| NamespaceId (v1.5+) | string | read-only (null) |
The NVMe Namespace Identifier for this
namespace.
^0[xX](([a-fA-F]|[0-9])*)$ |
| NamespaceType (v1.9+) | string (enum) |
read-only (null) |
Identifies the type of
namespace.
|
| NumberLBAFormats (v1.5+) | integer (bytes) |
read-only (null) |
The number of LBA data size and metadata
size combinations supported by this namespace. The value of this
property is between 0 and 16.
|
| NVMeVersion (v1.5+) | string | read-only (null) |
The version of the NVMe Base Specification
supported.
|
| Type (v1.8+) | string (enum) |
read-only (null) |
Identifies the type of
namespace.
|
| } | |||
| Operations [ { | array | The operations currently running on the
Volume.
|
|
| AssociatedFeaturesRegistry {} | object | A reference to the task associated with
the operation if any.
|
|
| Operation (v1.9+) | string (enum) |
read-only (null) |
The type of the operation.
|
| OperationName (deprecated v1.9) | string | read-only (null) |
The name of the operation. Deprecated in v1.9 and later. This property is deprecated in favor of the Operation property using the Operation enum. |
| PercentageComplete | integer | read-only (null) |
The percentage of the operation that has been completed. |
| } ] | |||
| OptimumIOSizeBytes | integer (bytes) |
read-only (null) |
The size in bytes of this Volume's optimum
IO size.
|
| ProvisioningPolicy (v1.4+) | string (enum) |
read-write (null) |
This property specifies the volume's
storage allocation, or provisioning policy.
|
| RAIDType (v1.3.1+) | string (enum) |
read-only (null) |
The RAID type of this volume.
|
| ReadCachePolicy (v1.4+) | string (enum) |
read-write (null) |
Indicates the read cache policy setting
for the Volume.
|
| RecoverableCapacitySourceCount (v1.3+) | integer | read-write (null) |
Current number of capacity source
resources that are available as replacements.
|
| RemainingCapacityPercent (v1.2+) | integer | read-only (null) |
The percentage of the capacity remaining
in the Volume.
|
| RemoteReplicaTargets (v1.8+) [ ] | array (string, null) | read-only | URIs to the resources that are remote
target replicas of this source.
|
| ReplicaInfo (v1.1+) {} | object | Describes this storage volume in its role
as a target replica.
|
|
| ReplicaTargets (v1.3+) [ { | array | The resources that are target replicas of
this source.
|
|
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
| } ] | |||
| ReplicationEnabled (v1.9+) | boolean | read-write (null) |
Indicates whether or not replication is
enabled on the volume.
|
| Status {} | object | The property contains the status of the
Volume.
|
|
| StorageGroups (v1.1+, deprecated v1.9 {} | object | An array of references to Storage Groups
that includes this volume.
|
|
| StripSizeBytes (v1.4+) | integer (bytes) |
read-write (null) |
The number of blocks (bytes) in a strip in
a disk array that uses striped data mapping.
|
| VolumeType | string (enum) |
read-only (null) |
The type of this volume.
|
| VolumeUsage (v1.4+) | string (enum) |
read-only (null) |
Indicates the Volume usage type setting
for the Volume.
|
| WriteCachePolicy (v1.4+) | string (enum) |
read-write (null) |
Indicates the write cache policy setting
for the Volume.
|
| WriteCacheState (v1.4+) | string (enum) |
read-only (null) |
Indicates the WriteCacheState policy
setting for the Volume.
|
| WriteHoleProtectionPolicy (v1.4+) | string (enum) |
read-write | The policy that the RAID volume is using
to address the write hole issue.
|
6.146.4 Actions
6.146.4.1 AssignReplicaTarget (v1.4+)
Description
This action is used to establish a replication relationship by assigning an existing volume to serve as a target replica for an existing source volume.
- This action shall be used to establish a replication relationship by assigning an existing volume to serve as a target replica for an existing source volume.
Action URI
{Base URI of target resource}/Actions/Volume.AssignReplicaTarget
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| ReplicaType | string (enum) |
required | The type of replica relationship to be
created.
|
| ReplicaUpdateMode | string (enum) |
required | The replica update mode (synchronous vs
asynchronous).
|
| TargetVolume | string | required | The Uri to the existing target
volume.
|
Request Example
{
"ReplicaUpdateMode": "Synchronous",
"TargetVolume": "/redfish/v1/Storage/1/ConsistencyGroup/CG_DB2",
"ReplicaType": "Mirror"
}6.146.4.2 ChangeRAIDLayout (v1.5+)
Description
Request system change the RAID layout of the volume.
- This action shall request the system to change the RAID layout of the volume. Depending on the combination of the submitted parameters, this could be changing the RAID type, changing the span count, changing the number of drives used by the volume, or another configuration change supported by the system. Note that usage of this action while online may potentially cause data loss if the available capacity is reduced.
Action URI
{Base URI of target resource}/Actions/Volume.ChangeRAIDLayout
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| Drives [ { | array | optional | An array of the drives to be used by the
volume.
|
| @odata.id | string | read-only | Link to a Drive resource. See the Links section and the Drive schema for details. |
| } ] | |||
| MediaSpanCount | integer | optional | The requested number of media elements
used per span in the secondary RAID for a hierarchical RAID
type.
|
| RAIDType | string (enum) |
optional | The requested RAID type for the
volume.
|
| StripSizeBytes | integer | optional | The number of blocks (bytes) requested for
new strip size.
|
Request Example
{
"Drives": [
{
"@odata.id": "/redfish/v1/Chassis/1U/Drives/Bay1A"
},
{
"@odata.id": "/redfish/v1/Chassis/1U/Drives/Bay2A"
},
{
"@odata.id": "/redfish/v1/Chassis/1U/Drives/Bay3B"
},
{
"@odata.id": "/redfish/v1/Chassis/1U/Drives/Bay4B"
}
],
"RAIDType": "RAID6"
}6.146.4.3 CheckConsistency
Description
This action is used to force a check of the Volume's parity or redundant data to ensure it matches calculated values.
- This defines the name of the custom action supported on this resource.
Action URI
{Base URI of target resource}/Actions/Volume.CheckConsistency
Action parameters
This action takes no parameters.
6.146.4.4 CreateReplicaTarget (v1.4+)
Description
This action is used to create a new volume resource to provide expanded data protection through a replica relationship with the specified source volume.
- This action shall be used to create a new volume resource to provide expanded data protection through a replica relationship with the specified source volume.
Action URI
{Base URI of target resource}/Actions/Volume.CreateReplicaTarget
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| ReplicaType | string (enum) |
required | The type of replica relationship to be
created.
|
| ReplicaUpdateMode | string (enum) |
required | The replica update mode (synchronous vs
asynchronous).
|
| TargetStoragePool | string | required | The Uri to the existing target Storage
Pool.
|
| VolumeName | string | optional | The Name for the new target
volume.
|
Request Example
{
"VolumeName": "Mirror of Volume 65",
"ReplicaUpdateMode": "Synchronous",
"TargetStoragePool": "/redfish/v1/Storage/1/StoragePools/PrimaryPool",
"ReplicaType": "Mirror"
}6.146.4.5 ForceEnable (v1.5+)
Description
Request system force the volume to an enabled state regardless of data loss.
- This action shall request the system to force the volume to enabled state regardless of data loss scenarios.
Action URI
{Base URI of target resource}/Actions/Volume.ForceEnable
Action parameters
This action takes no parameters.
6.146.4.6 Initialize (v1.5+)
Description
This action is used to prepare the contents of the volume for use by the system. If InitializeMethod is not specified in the request body, but the property InitializeMethod is specified, the property InitializeMethod value should be used. If neither is specified, the InitializeMethod should be Foreground.
- This defines the name of the custom action supported on this resource. If InitializeMethod is not specified in the request body, but the property InitializeMethod is specified, the property InitializeMethod value should be used. If neither is specified, the InitializeMethod should be Foreground.
Action URI
{Base URI of target resource}/Actions/Volume.Initialize
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| InitializeMethod | string (enum) |
optional | The type of initialization to be
performed.
|
| InitializeType | string (enum) |
optional | The type of initialization to be
performed.
|
Request Example
{
"InitializeMethod": "Background",
"InitializeType": "Fast"
}6.146.4.7 RemoveReplicaRelationship (v1.4+)
Description
This action is used to disable data synchronization between a source and target volume, remove the replication relationship, and optionally delete the target volume.
- This action shall be used to disable data synchronization between a source and target volume, remove the replication relationship, and optionally delete the target volume.
Action URI
{Base URI of target resource}/Actions/Volume.RemoveReplicaRelationship
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| DeleteTargetVolume | boolean | optional | Indicate whether or not to delete the
target volume as part of the operation.
|
| TargetVolume | string | required | The Uri to the existing target
volume.
|
Request Example
{
"TargetVolume": "/redfish/v1/Storage/1/StoragePools/PrimaryPool/AllocatedVolumes/650973452245",
"DeleteTargetVolume": "false"
}6.146.4.8 ResumeReplication (v1.4+)
Description
This action is used to resume the active data synchronization between a source and target volume, without otherwise altering the replication relationship.
- This action shall be used to resume the active data synchronization between a source and target volume, without otherwise altering the replication relationship.
Action URI
{Base URI of target resource}/Actions/Volume.ResumeReplication
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| TargetVolume | string | required | The Uri to the existing target
volume.
|
Request Example
{
"TargetVolume": "/redfish/v1/Storage/1/StoragePools/PrimaryPool/AllocatedVolumes/650973452245"
}6.146.4.9 ReverseReplicationRelationship (v1.4+)
Description
This action is used to reverse the replication relationship between a source and target volume.
- This action shall be used to reverse the replication relationship between a source and target volume.
Action URI
{Base URI of target resource}/Actions/Volume.ReverseReplicationRelationship
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| TargetVolume | string | required | The Uri to the existing target
volume.
|
Request Example
{
"TargetVolume": "/redfish/v1/Storage/1/StoragePools/PrimaryPool/AllocatedVolumes/650973452245"
}6.146.4.10 SplitReplication (v1.4+)
Description
This action is used to split the replication relationship and suspend data synchronization between a source and target volume.
- This action shall be used to split the replication relationship and suspend data synchronization between a source and target volume.
Action URI
{Base URI of target resource}/Actions/Volume.SplitReplication
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| TargetVolume | string | required | The Uri to the existing target
volume.
|
Request Example
{
"TargetVolume": "/redfish/v1/Storage/1/StoragePools/PrimaryPool/AllocatedVolumes/650973452245"
}6.146.4.11 SuspendReplication (v1.4+)
Description
This action is used to suspend active data synchronization between a source and target volume, without otherwise altering the replication relationship.
- This action shall be used to suspend active data synchronization between a source and target volume, without otherwise altering the replication relationship.
Action URI
{Base URI of target resource}/Actions/Volume.SuspendReplication
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| TargetVolume | string | required | The Uri to the existing target
volume.
|
Request Example
{
"TargetVolume": "/redfish/v1/Storage/1/StoragePools/PrimaryPool/AllocatedVolumes/650973452245"
}6.146.5 Property details
6.146.5.1 AccessCapabilities
Values of StorageAccessCapability describe abilities to read or write storage.
- Supported IO access capabilities.
- Each entry shall specify a current storage access capability.
| string | Description |
|---|---|
| Append | AppendOnly.
|
| Execute | Execute access is allowed by the file
share.
|
| Read | Read.
|
| Streaming | Streaming.
|
| Write | Write Many.
|
| WriteOnce | WriteOnce.
|
6.146.5.2 EncryptionTypes
- The types of encryption used by this Volume.
- This property shall contain the types of encryption used by this Volume.
| string | Description |
|---|---|
| ControllerAssisted | The volume is being encrypted by the storage controller entity. |
| NativeDriveEncryption | The volume is utilizing the native drive encryption capabilities of the drive hardware. |
| SoftwareAssisted | The volume is being encrypted by software running on the system or the operating system. |
6.146.5.3 idRef
| @odata.id | string (URI) |
read-only | The unique identifier for a
resource.
|
6.146.5.4 InitializeMethod
The type of initialization to be performed.
- This defines the property name for the action.
| string | Description |
|---|---|
| Background | The volume will be available for use immediately, with data erasure and preparation to happen as background tasks. |
| Foreground | Data erasure and preparation tasks will complete before the volume is presented as available for use. |
| Skip | The volume will be available for use immediately, with no preparation. |
6.146.5.5 InitializeType
The type of initialization to be performed.
- This defines the property name for the action.
| string | Description |
|---|---|
| Fast | The volume is prepared for use quickly, typically by erasing just the beginning and end of the space so that partitioning can be performed. |
| Slow | The volume is prepared for use slowly, typically by completely erasing the volume. |
6.146.5.6 LBAFormatsSupported
LBAFormatType is defined in the NVMe specification set. This field indicates the LBA data size supported; implementations may report up to 16 values. For more details refer to the appropriate NVMe specification.
- A list of the LBA format types supported for the
namespace, or potential namespaces.
- This shall be a list of the LBA formats supported for the namespace, or potential namespaces.
| string | Description |
|---|---|
| LBAFormat0 | LBAFormat0 is a required type. Indicates the LBA data size supported. |
| LBAFormat1 | Indicates the LBA data size if supported. |
| LBAFormat10 | Indicates the LBA data size supported if supported. |
| LBAFormat11 | Indicates the LBA data size supported if supported. |
| LBAFormat12 | Indicates the LBA data size supported if supported. |
| LBAFormat13 | Indicates the LBA data size supported if supported. |
| LBAFormat14 | Indicates the LBA data size supported if supported. |
| LBAFormat15 | Indicates the LBA data size supported if supported. |
| LBAFormat2 | Indicates the LBA data size supported if supported. |
| LBAFormat3 | Indicates the LBA data size supported if supported. |
| LBAFormat4 | Indicates the LBA data size supported if supported. |
| LBAFormat5 | Indicates the LBA data size supported if supported. |
| LBAFormat6 | Indicates the LBA data size supported if supported. |
| LBAFormat7 | Indicates the LBA data size supported if supported. |
| LBAFormat8 | Indicates the LBA data size supported if supported. |
| LBAFormat9 | Indicates the LBA data size supported if supported. |
6.146.5.7 LBAFormatType
The LBA format type.
- This shall be the LBA format type. This property is intended for capabilities instrumentation.
| string | Description |
|---|---|
| LBAFormat0 | LBAFormat0 is a required type. Indicates the LBA data size supported. |
| LBAFormat1 | Indicates the LBA data size if supported. |
| LBAFormat10 | Indicates the LBA data size supported if supported. |
| LBAFormat11 | Indicates the LBA data size supported if supported. |
| LBAFormat12 | Indicates the LBA data size supported if supported. |
| LBAFormat13 | Indicates the LBA data size supported if supported. |
| LBAFormat14 | Indicates the LBA data size supported if supported. |
| LBAFormat15 | Indicates the LBA data size supported if supported. |
| LBAFormat2 | Indicates the LBA data size supported if supported. |
| LBAFormat3 | Indicates the LBA data size supported if supported. |
| LBAFormat4 | Indicates the LBA data size supported if supported. |
| LBAFormat5 | Indicates the LBA data size supported if supported. |
| LBAFormat6 | Indicates the LBA data size supported if supported. |
| LBAFormat7 | Indicates the LBA data size supported if supported. |
| LBAFormat8 | Indicates the LBA data size supported if supported. |
| LBAFormat9 | Indicates the LBA data size supported if supported. |
6.146.5.8 NamespaceType
Identifies the type of namespace.
- This shall identify the type of namespace.
| string | Description |
|---|---|
| Block | The namespace is configured for use with a block storage interface. |
| Computational | The namespace is configured for use with a computational storage interface. |
| KeyValue | The namespace is configured for use with a KeyValue interface. |
| ZNS | The namespace is configured for use with a zoned storage interface. |
6.146.5.9 Operation
The type of the operation.
- This property shall contain the type of the operation.
| string | Description |
|---|---|
| ChangeRAIDType | A ChangeRAIDType operation is being performed. |
| ChangeStripSize | A ChangeStripSize operation is being performed. |
| CheckConsistency | A CheckConsistency operation is being performed. |
| Compress | A Compress operation is being performed. |
| Decrypt | A Decrypt operation is being performed. |
| Deduplicate | A Deduplicate operation is being performed. |
| Delete | A Delete operation is being performed. |
| Encrypt | An Encrypt operation is being performed. |
| Format | A Format operation is being performed. |
| Initialize | An Initialize operation is being performed. |
| Rebuild | A Rebuild operation is being performed. |
| Replicate | A Replicate operation is being performed. |
| Resize | A Resize operation is being performed. |
| Sanitize | A Sanitize operation is being performed. |
6.146.5.10 ProvisioningPolicy
This property specifies the volume's storage allocation, or provisioning policy.
- This property shall specify the volume's supported storage allocation policy.
| string | Description |
|---|---|
| Fixed | Storage is fully allocated.
|
| Thin | Storage may be over allocated.
|
6.146.5.11 RAIDType
The requested RAID type for the volume.
- This parameter shall contain the requested RAID type for the volume.
| string | Description |
|---|---|
| None | A placement policy with no redundancy at the device level. |
| RAID0 | A placement policy where consecutive
logical blocks of data are uniformly distributed across a set of
independent storage devices without offering any form of
redundancy.
|
| RAID00 | A placement policy that creates a RAID 0
stripe set over two or more RAID 0 sets.
|
| RAID01 | A data placement policy that creates a
mirrored device (RAID 1) over a set of striped devices (RAID
0).
|
| RAID1 | A placement policy where each logical
block of data is stored on more than one independent storage
device.
|
| RAID10 | A placement policy that creates a striped
device (RAID 0) over a set of mirrored devices (RAID 1).
|
| RAID10E | A placement policy that uses a RAID 0
stripe set over two or more RAID 10 sets.
|
| RAID10Triple | A placement policy that uses a striped
device (RAID 0) over a set of triple mirrored devices (RAID
1Triple).
|
| RAID1E | A placement policy that uses a form of
mirroring implemented over a set of independent storage devices where
logical blocks are duplicated on a pair of independent storage devices
so that data is uniformly distributed across the storage
devices.
|
| RAID1Triple | A placement policy where each logical
block of data is mirrored three times across a set of three independent
storage devices.
|
| RAID3 | A placement policy using parity-based
protection where logical bytes of data are uniformly distributed across
a set of independent storage devices and where the parity is stored on a
dedicated independent storage device.
|
| RAID4 | A placement policy using parity-based
protection where logical blocks of data are uniformly distributed across
a set of independent storage devices and where the parity is stored on a
dedicated independent storage device.
|
| RAID5 | A placement policy using parity-based
protection for storing stripes of 'n' logical blocks of data and one
logical block of parity across a set of 'n+1' independent storage
devices where the parity and data blocks are interleaved across the
storage devices.
|
| RAID50 | A placement policy that uses a RAID 0
stripe set over two or more RAID 5 sets of independent storage
devices.
|
| RAID6 | A placement policy using parity-based
protection for storing stripes of 'n' logical blocks of data and two
logical blocks of independent parity across a set of 'n+2' independent
storage devices where the parity and data blocks are interleaved across
the storage devices.
|
| RAID60 | A placement policy that uses a RAID 0
stripe set over two or more RAID 6 sets of independent storage
devices.
|
| RAID6TP | A placement policy that uses parity-based
protection for storing stripes of 'n' logical blocks of data and three
logical blocks of independent parity across a set of 'n+3' independent
storage devices where the parity and data blocks are interleaved across
the storage devices.
|
6.146.5.12 ReadCachePolicy
Indicates the read cache policy setting for the Volume.
- This property shall contain a boolean indicator of the read cache policy for the Volume.
| string | Description |
|---|---|
| AdaptiveReadAhead | A caching technique in which the controller dynamically determines whether to pre-fetch data anticipating future read requests, based on previous cache hit ratio. |
| Off | The read cache is disabled. |
| ReadAhead | A caching technique in which the controller pre-fetches data anticipating future read requests. |
6.146.5.13 RelativePerformance
The LBA Relative Performance type.
- This shall be the LBA Relative Performance type. This field indicates the relative performance of the LBA format indicated relative to other LBA formats supported by the controller. This property is intended for capabilities instrumentation.
| string | Description |
|---|---|
| Best | Best performance. |
| Better | Better performance. |
| Degraded | Degraded performance. |
| Good | Good performance. |
6.146.5.14 ReplicaType
The type of replica relationship to be created.
- This parameter shall contain the type of replica relationship to be created (e.g., Clone, Mirror, Snap).
| 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.
|
6.146.5.15 ReplicaUpdateMode
The replica update mode (synchronous vs asynchronous).
- This parameter shall specify the replica update mode.
| 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.
|
6.146.5.16 Type
Identifies the type of namespace.
- This shall identify the type of namespace.
| string | Description |
|---|---|
| Block | The namespace is configured for use with a block storage interface. |
| Computational | The namespace is configured for use with a computational storage interface. |
| KeyValue | The namespace is configured for use with a KeyValue interface. |
| ZNS | The namespace is configured for use with a zoned storage interface. |
6.146.5.17 VolumeType
The type of this volume.
- This property shall contain the type of the associated Volume.
| string | Description |
|---|---|
| Mirrored | The volume is a mirrored device. |
| NonRedundant | The volume is a non-redundant storage device. |
| RawDevice | The volume is a raw physical device without any RAID or other virtualization applied. |
| SpannedMirrors | The volume is a spanned set of mirrored devices. |
| SpannedStripesWithParity | The volume is a spanned set of devices which uses parity to retain redundant information. |
| StripedWithParity | The volume is a device which uses parity to retain redundant information. |
6.146.5.18 VolumeUsage
Indicates the Volume usage type setting for the Volume.
- This property shall contain the volume usage type for the Volume.
| string | Description |
|---|---|
| CacheOnly | The volume is allocated for use as a
non-consumable cache only volume.
|
| Data | The volume is allocated for use as a
consumable data volume.
|
| ReplicationReserve | The volume is allocated for use as a
non-consumable reserved volume for replication use.
|
| SystemData | The volume is allocated for use as a
consumable data volume reserved for system use.
|
| SystemReserve | The volume is allocated for use as a
non-consumable system reserved volume.
|
6.146.5.19 WriteCachePolicy
Indicates the write cache policy setting for the Volume.
- This property shall contain a boolean indicator of the write cache policy for the Volume.
| string | Description |
|---|---|
| Off | The write cache is
disabled.
|
| ProtectedWriteBack | A caching technique in which the completion of a write request is signaled as soon as the data is in cache, and actual writing to non-volatile media is guaranteed to occur at a later time. |
| UnprotectedWriteBack | A caching technique in which the completion of a write request is signaled as soon as the data is in cache; actual writing to non-volatile media is not guaranteed to occur at a later time. |
| WriteThrough | A caching technique in which the completion of a write request is not signaled until data is safely stored on non-volatile media. |
6.146.5.20 WriteCacheState
Indicates the WriteCacheState policy setting for the Volume.
- This property shall contain the WriteCacheState policy setting for the Volume.
| string | Description |
|---|---|
| Degraded | Indicates an issue with the cache state in which the cache space is diminished or disabled due to a failure or an outside influence such as a discharged battery. |
| Protected | Indicates that the cache state type in use generally protects write requests on non-volatile media. |
| Unprotected | Indicates that the cache state type in use generally does not protect write requests on non-volatile media. |
6.146.5.21 WriteHoleProtectionPolicy
The policy that the RAID volume is using to address the write hole issue.
- This property specifies the policy that is enabled to address the write hole issue on the RAID volume. If no policy is enabled at the moment, this property shall be set to 'Off'.
| string | Description |
|---|---|
| DistributedLog | The policy that distributes additional log
among the volume's capacity sources to address write hole
issue.
|
| Journaling | The policy that uses separate block device
for write-ahead logging to address write hole issue.
|
| Oem | The policy that is Oem
specific.
|
| Off | The volume is not using any policy to
address the write hole issue.
|
6.146.6 Example response
{
"@odata.type": "#Volume.v1_10_0.Volume",
"Id": "2",
"Name": "Virtual Disk 2",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Encrypted": false,
"RAIDType": "RAID0",
"CapacityBytes": 107374182400,
"Identifiers": [
{
"DurableNameFormat": "UUID",
"DurableName": "0324c96c-8031-4f5e-886c-50cd90aca854"
}
],
"Links": {
"Drives": [
{
"@odata.id": "/redfish/v1/Systems/437XR1138R2/Storage/1/Drives/3D58ECBC375FD9F2"
}
]
},
"Actions": {
"#Volume.Initialize": {
"target": "/redfish/v1/Systems/3/Storage/RAIDIntegrated/Volumes/1/Actions/Volume.Initialize",
"InitializeType@Redfish.AllowableValues": [
"Fast",
"Slow"
]
}
},
"@odata.id": "/redfish/v1/Systems/437XR1138R2/Storage/1/Volumes/2"
}6.147 Zone 1.6.2
| Version | v1.6 | v1.5 | v1.4 | v1.3 | v1.2 | v1.1 | v1.0 |
| Release | 2020.4 | 2020.3 | 2019.4 | 2019.1 | 2017.3 | 2017.1 | 2016.2 |
6.147.1 Description
The Zone schema describes a simple fabric zone for a Redfish implementation.
- This resource shall represent a simple fabric zone for a Redfish implementation.
6.147.2 URIs
/redfish/v1/CompositionService/ResourceZones/{ZoneId}
/redfish/v1/Fabrics/{FabricId}/Zones/{ZoneId}
6.147.3 Properties
| Property | Type | Attributes | Notes |
|---|---|---|---|
| DefaultRoutingEnabled (v1.4+) | boolean | read-write (null) |
This property indicates whether routing
within this zone is enabled.
|
| ExternalAccessibility (v1.3+) | string (enum) |
read-write (null) |
Indicates accessibility of endpoints in
this zone to endpoints outside of this zone.
|
| Identifiers (v1.2+) [ { } ] | array (object) | Any additional identifiers for a
resource.
|
|
| 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 zone.
|
|
| @odata.id | string | read-only | Link to a AddressPool resource. See the Links section and the AddressPool schema for details. |
| } ] | |||
| ContainedByZones (v1.4+) [ { | array | An array of links to the zone that contain
this zone.
|
|
| @odata.id | string | read-only | Link to another Zone resource. |
| } ] | |||
| ContainsZones (v1.4+) [ { | array | An array of links to the zones that are
contained by this zone.
|
|
| @odata.id | string | read-write | Link to another Zone resource. |
| } ] | |||
| Endpoints [ { | array | The links to the endpoints that this zone
contains.
|
|
| @odata.id | string | read-only | Link to a Endpoint resource. See the Links section and the Endpoint schema for details. |
| } ] | |||
| InvolvedSwitches [ { | array | The links to the collection of switches in
this zone.
|
|
| @odata.id | string | read-only | Link to a Switch resource. See the Links section and the Switch schema for details. |
| } ] | |||
| Oem {} | object | See the OEM object definition in the Using this guide clause. | |
| ResourceBlocks (v1.1+) [ { | array | The links to the resource blocks with
which this zone is associated.
|
|
| @odata.id | string | read-only | Link to a ResourceBlock resource. See the Links section and the ResourceBlock schema for details. |
| } ] | |||
| } | |||
| Status {} | object | The status and health of the resource and
its subordinate or dependent resources.
|
|
| ZoneType (v1.4+) | string (enum) |
read-write (null) |
The type of zone.
|
6.147.4 Actions
6.147.4.1 AddEndpoint (v1.5+)
Description
This action adds an endpoint to a zone.
- This action shall add an endpoint to a zone.
Action URI
{Base URI of target resource}/Actions/Zone.AddEndpoint
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| Endpoint { | object | required | The endpoint to add to the
zone.
|
| @odata.id | string | read-only | Link to a Endpoint resource. See the Links section and the Endpoint schema for details. |
| } | |||
| EndpointETag | string | optional | The current ETag of the endpoint to add to
the zone.
|
| ZoneETag | string | optional | The current ETag of the zone.
|
Request Example
{
"Endpoint": {
"@odata.id": "/redfish/v1/Fabrics/SAS/Endpoints/Initiator1"
},
"EndpointETag": "W/\"19472363938\"",
"ZoneETag": "W/\"99374369273\""
}6.147.4.2 RemoveEndpoint (v1.5+)
Description
This action removes an endpoint from a zone.
- This action shall remove an endpoint from a zone.
Action URI
{Base URI of target resource}/Actions/Zone.RemoveEndpoint
Action parameters
| Parameter Name | Type | Attributes | Notes |
|---|---|---|---|
| Endpoint { | object | required | The endpoint to remove from the
zone.
|
| @odata.id | string | read-only | Link to a Endpoint resource. See the Links section and the Endpoint schema for details. |
| } | |||
| EndpointETag | string | optional | The current ETag of the endpoint to remove
from the system.
|
| ZoneETag | string | optional | The current ETag of the zone.
|
Request Example
{
"Endpoint": {
"@odata.id": "/redfish/v1/Fabrics/SAS/Endpoints/Initiator1"
},
"EndpointETag": "W/\"19472363938\"",
"ZoneETag": "W/\"99374369273\""
}6.147.5 Property details
6.147.5.1 ExternalAccessibility
Indicates accessibility of endpoints in this zone to endpoints outside of this zone.
- This property shall contain and indication of accessibility of endpoints in this zone to endpoints outside of this zone.
| string | Description |
|---|---|
| GloballyAccessible | Any external entity with the correct
access details, which might include authorization information, can
access the endpoints that this zone lists.
|
| NoInternalRouting | Routing is not enabled within this
zone.
|
| NonZonedAccessible | Any external entity that another zone does
not explicitly list can access the endpoints that this zone
lists.
|
| ZoneOnly | Only accessible by endpoints that this
zone explicitly lists.
|
6.147.5.2 ZoneType
The type of zone.
- This property shall contain the type of zone that this zone represents.
| string | Description |
|---|---|
| Default | The zone in which all endpoints are added
by default when instantiated.
|
| ZoneOfEndpoints | A zone that contains
endpoints.
|
| ZoneOfResourceBlocks (v1.6+) | A zone that contains resource
blocks.
|
| ZoneOfZones | A zone that contains zones.
|
6.147.6 Example response
{
"@odata.type": "#Zone.v1_6_2.Zone",
"Id": "1",
"Name": "SAS Zone 1",
"Description": "SAS Zone 1",
"Status": {
"State": "Enabled",
"Health": "OK"
},
"Links": {
"Endpoints": [
{
"@odata.id": "/redfish/v1/Fabrics/SAS/Endpoints/Initiator1"
},
{
"@odata.id": "/redfish/v1/Fabrics/SAS/Endpoints/Initiator2"
},
{
"@odata.id": "/redfish/v1/Fabrics/SAS/Endpoints/Drive1"
},
{
"@odata.id": "/redfish/v1/Fabrics/SAS/Endpoints/Drive3"
}
]
},
"@odata.id": "/redfish/v1/Fabrics/SAS/Zones/1"
}7 Redfish documentation generator
This document was created using the Redfish Documentation Generator utility, which uses the contents of the Redfish schema files (in JSON schema format) to automatically generate the bulk of the text. The source code for the utility is available for download at DMTF's GitHub repository located at https://www.github.com/DMTF/Redfish-Tools.
8 ANNEX A (informative) Change log
| Version | Date | Description |
|---|---|---|
| 2023.2 | 2023-08-11 | DSP8010 version 2023.2 |
| 2023.1 | 2023-04-06 | DSP8010 version 2023.1 |
| 2022.3 | 2022-12-08 | DSP8010 version 2022.3 |
Added uuid and
duration as known string formats. |
||
Corrrected missing required
notations on array properties. |
||
Added supplemental details for
HealthRollup. |
||
| 2022.2 | 2022-08-04 | DSP8010 version 2022.2 |
| Renamed document to Redfish Data Model Specification. | ||
| 2022.1 | 2022-04-15 | DSP8010 version 2022.1 |
| 2021.4 | 2021-12-02 | DSP8010 version 2021.4 |
| Added Collection Capabilities section. | ||
| 2021.3 | 2021-10-15 | DSP8010 version 2021.3 |
| 2021.2 | 2021-08-13 | DSP8010 version 2021.2 |
| Corrected format of UUID from RFC4122. | ||
| 2021.1 | 2021-04-16 | DSP8010 version 2021.1 |
| Document formatting updated for Documentation Generator v3. | ||
| 2020.4 | 2020-12-01 | DSP8010 version 2020.4 |
| 2020.3 | 2020-08-14 | DSP8010 version 2020.3 |
| Corrected issue that caused read-write links to be listed as read-only. | ||
| 2020.2.1 | 2020-07-10 | Errata release to correct truncated Processor supplemental text. |
| 2020.2 | 2020-05-08 | DSP8010 version 2020.2 |
| 2020.1 | 2020-03-27 | DSP8010 version 2020.1 |
| 2019.4 | 2019-12-06 | DSP8010 version 2019.4 |
| 2019.3 | 2019-10-11 | DSP8010 version 2019.3 |
| 2019.2 | 2019-09-13 | DSP8010 version 2019.2 |
| 2019.1a | 2019-05-03 | DSP8010 version
2019.1 Work-in-progress release |