Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial
Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under
vendor's standard commercial license.
The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express
warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall
not be liable for technical or editorial errors or omissions contained herein.
Acknowledgments
Windows Server® is a trademark of the Microsoft Group of companies.
Prerequisites and Audience
This paper assumes the reader is familiar with HTTP operations and RESTful web service APIs. The reader should be familiar with JSON and UTF-8 encoding as well as HTTP operations and
headers.
This paper is a reference and is intended to be used in conjunction with the paper entitled "Managing HP Servers Using the HP RESTful API." This other document is an introduction to using
the HP RESTful API, while this document provides detail on individual properties and messages.
First Things
HP Moonshot running Chassis Manager 1.30 or later features a new management interface called the “HP RESTful API.” The HP RESTful API is a RESTful Web Service API served by iLO’s web
server. If you are familiar with RESTful APIs, this should tell you much about how the API works. In short, a RESTful API is an application programming interface using the basic HTTP
operations GET, PUT, POST, DELETE, and PATCH. Each HTTP operation either submits or returns a “resource” in the form of UTF-8 encoded JSON. Just as a Web application returns HTML to
your browser, a REST interface returns data (in the form of JSON) to your client over the same transport (HTTPS).
All modern scripting languages make it very easy to write simple REST clients for web services. Most, like Python can transform JSON into internal data structures like dictionaries, allowing for
easily access to data. This enables you to write custom code directly to the API instead of using intermediate tools.
If you are not familiar with RESTful APIs, you should pause and do internet research on the subject. This tutorial is intended to point out the things you must consider when creating a proper
client to interact with The HP RESTful API.
Key Benefits of the HP RESTful API
This HP RESTful API will become the main management API for Moonshot. Using this API you can take full inventory of the Moonshot enclosure, control power and reset, configure settings,
fetch event logs as well as many other things.
This API follows the trend of the Internet in moving to a common pattern for new software interfaces. Many web services in a variety of industries use REST APIs because they are easily to
implement, easy to consume, and offer scalability advantages over previous technologies. HP OneView, OpenStack, and many other server management APIs are now REST APIs. Most HP
Management software offerings as well as the entire Software Defined Data Center architecture is built upon REST APIs.
Requirements for using the HP RESTful API
The HP RESTful API for iLO is available on Moonshot servers running iLO Chassis Manager and does not require a license.
How to Use This Document
This document has three main sections.
Examples of using PATCH and POST to set properties and perform actions.
Resource Map documents the resources in the data model including the URIs and types of the resources as well as the relationships between resources. Not all implementations of the
The
API will contain all the resources in this table and the model may expand in future versions of firmware.
Data Model Type Reference contains a chapter for each resource type and a section for each property in each resource type.
The
The Message Reference documents the MessageID values that may be returned in ExtendedError responses to HTTP operations.
Examples of using PATCH and POST to set properties and
perform actions
1./rest/v1/Sessions
a.POST Login
{
"Password": "",
"UserName": ""
}
b.DELETE Session (Clear session)
From the /rest/v1/Sessions URI select the href: for the session to be cleared. An
example is href: /rest/v1/Sessions/administrator53d95db4c8098e1d. When
the session is verified sending a DELETE request will clear the session.
2./rest/v1/AccountService
a.PATCH Minimum Password Length
{
"Oem": {
"Hp": {
"MinPasswordLength": 8
}
}
}
This changes the Minimum Password Length. Acceptable values are 0 through 39.
Valid values for privileges are true and false. Each account has specific link with an
integer (N). Perform a GET /rest/v1/AccountService/Accounts to get a list of
valid accounts.
This POST removes the SSH public key associated with account N.
5./rest/v1/Managers/1
a.POST Reset
{
"Action": "Reset"
}
The performs a reset on iLO CM.
b.POST Set Factory Defaults
{
"Action": "SetFactoryDefaults"
}
6./rest/v1/Managers/1/DateTime
a.PATCH DateTime
{
"DateTime": "YYYY-MM-DDTHH:MM:SS+hh:mm"
}
The DateTime format follows the ISO 8601 standard. The time is set using local time and
the +hh:mm section is the offset from UTC to the local standard time zone. Daylight savings
time is automatically determined. CST/CDT is +06:00.
b.PATCH TimeZone.Index
{
"TimeZone": {
"Index": 296
}
}
The Timezone Indexes that are available are listed in the TimeZoneList array with a GET
/rest/v1/Managers/1/DateTime.
c.PATCH SNTPPollingPeriodSeconds
{
"SNTPPollingPeriodSeconds": 95
}
This is an integer value with a 60 second minimum. It sets the frequency that the the NTP
server(s) are polled for the current time.
This removes the named firmware file from the repository. The firmware files currently in
the repository are listed in the FirmwareRepositoryFiles array.
Use "none" for "StaticRoutes", "Address", "SubnetMask", or "Gateway" to
clear the setting.
The "DDNSRegistration", "WINSRegistration", "StaticSubnetMask",
"DNSServers", "StaticRoutes", and "WINSServers" properties can be PATCHED
in any combination.
Changing this property requires an iLO CM reset for the changes to take effect.
c.PATCH PingGatewayOnStartup
{
"Oem": {
"Hp": {
"PingGatewayOnStartup": true
}
}
}
Changing this property requires an iLO CM reset for the change to take effect.
Valid ControlType values are "Off" and "On". "On" creates a link between cartridges
Cx and Cy if there is an appropriate connection path between the two cartridges. It is
possible to create a link from a cartridge to more than one other cartridge. "Off" breaks
an existing link between two cartridges.
c.PATCH Power
{
"Power": "Press"
}
Valid Power values are "Press"and "PressAndHold".
"PressAndHold"unconditionally removes power from all nodes on a cartridge.
"Press"(when all nodes are off) sends a power on signal to all nodes. "Press" (when
any nodes are on) sends a power off signal to all nodes that have power applied. This
requires a running OS for a response.
d.PATCH SKU (Product ID)
{
"SKU": "XXXXXX-B21"
}
e.PATCH Serial Number
{
"SerialNumber": ""
}
f.PATCH IndicatorLED (UID)
{
"IndicatorLED": "Lit"
}
Valid IndicatorLED values are "Off" and "Lit".
18. /rest/v1/Chassis/1/Cartridges/Cx/Logs/IML
a.POST ClearLog
{
"Action": "ClearLog"
}
This action clears the Integrated Management Log of any entries related to the cartridge
(Cx) or any node(s) (CxNy) on the cartridge.
This action clears the Integrated Management Log of any entries related to the switch
(Sx).
21. /rest/v1/Systems/CxNy
a.POST PowerButton
{
"Action": "PowerButton",
“PushType”: “”
}
Valid PushType values are "Press" and "PressAndHold". "PressAndHold"
unconditionally removes power from the node. "Press" (when the node is off) sends a
power on signal to the node. "Press" (when the node is on) sends a power off signal
the node. This requires a running OS for a response.
b.POST Reset
{
"Action": "Reset",
"ResetType": ""
}
Valid ResetType values are "On", "Off", "Reset", "ColdReset", and
"GracefulShutdown". "ResetType": "On" changes the power state of the node
to "On". "ResetType": "Off" forces the power state of the node to "Off".
"ResetType": " GracefulShutdown " changes the power state of the node to
"Off" based on the OS services running on the node. "ResetType": "Reset" and
"ResetType": "ColdReset" forces the power state of the node to "Off" and then
back to "On".
c.PATCH BSC
{
"Oem": {
"Hp": {
"Options": {
"BSC": "Enable"
}
}
}
}
d.PATCH CPU
{
"Oem": {
"Hp": {
"Options": {
"CPU": {
"ClockRate": {
"CurrentFrequency": "1.8"
}
}
}
}
}
}
The "CurrentFrequency" must be in the list of "AvailableFrequency" values.
Valid BootOrder values are "N/A", "PXE", "HDD", "iSCSI", and "M.2". Up to two
boot order targets can be specified.
f.PATCH BootSourceOverride
{
"Boot": {
"BootSourceOverrideEnabled": "Once",
"BootSourceOverrideTarget": "M.2"
}
}
The list of valid targets for "BootSourceOverrideTarget" is listed in
"BootSourceOverrideSupported".
22. /rest/v1/Systems/CxNy/Logs/IML
a.POST ClearLog
{
"Action": "ClearLog"
}
This action clears the Integrated Management Log of any entries related to the node
(CxNy).
Resource Map
This section documents the resource map. Not all resources will be present in all implementations and the resource model may expand in future versions of the firmware. The root resource
is /rest/v1.
/rest/v1/Systems/{item}/Logs/IMLHpMoonshotLogServiceHTTP Allow: GET, PATCH, POST
Links to other resourcesto resource URIto resource Type
/rest/v1/SystemsSummary
SystemsSummaryHTTP Allow: GET
Links to other resourcesto resource URIto resource Type
/rest/v1/Systems/{item}ComputerSystem
/rest/v1/Chassis/{item}Chassis
Data Model Type Reference
This section documents each type of resource. Note that more than one resource may be of the same type. Not all resource instances implement every property specified in the definition.
"AccountService" Resource Type
Resource Instances
/rest/v1/AccountService
See Resource Map for more details.
This is the schema definition for
"AuthFailureLoggingThreshold"
You may create an iLO account by building a request JSON object of type
POST {"UserName":
"VirtualMediaPriv": true,
"newuser"}}}
"AccountService"
defines the following properties specified in JSON-pointer syntax
the Account service. It represents the properties for this service and has links to the list of accounts.
may be PATCHed to the values 0, 1, 2, 3, or 5. The value of 4 is not supported by
ManagerAccount and POSTing it to the Collection pointed to by the "Accounts" link. For Example:
This property enables you to view and configure logging criteria for failed authentications. A failed login log entry is recorded after the configured number of attempts. 0 = feature disabled; 13 and 5 are allowable values.
JSON type:
HTTP Operations
Integer
GETRendered if supported by the implementation or omitted if not.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
The property "Oem/Hp/AuthFailureLoggingThreshold" on resource type
ExtendedError. Multiple properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first, insert
nulls as placeholders on skipped array entries.
AccountService may not support PATCH of all values and may result in an HTTP 400 error with response of Type
"Oem/Hp/MinPasswordLength"
This property is a member of AccountService
This property specifies the minimum number of characters allowed when a user password is set or changed. It must be a value from 0 to 39.
JSON type: Integer from 0 to 39.
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
The property "Oem/Hp/MinPasswordLength" on resource type
Multiple properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first, insert nulls as
placeholders on skipped array entries.
AccountService may not support PATCH of all values and may result in an HTTP 400 error with response of Type ExtendedError.
"Chassis" Resource Type
Resource Instances
/rest/v1/Chassis/{item}
See Resource Map for more details.
The schema definition for the Chassis resource. It represents the properties for physical components for any system. This object represents racks, rackmount servers, blades, standalone,
modular systems, enclosures, and all other containers. The non-CPU/device-centric parts of the schema are accessed either directly or indirectly through this resource.
Chassis resources are members of the Chassis collection at /rest/v1/Chassis. Each Chassis contains an OEM section with HP-specific properties.
"Chassis" defines the following properties specified in JSON-pointer syntax
This is a user-assigned asset tag for the chassis.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
PATCH Example
HTTP PATCH to resource with request JSON:
{"AssetTag": "<string-value>"}
The property "AssetTag" on resource type
Chassis may not support PATCH of all values and may result in an HTTP 400 error with response of Type ExtendedError. Multiple properties may be
included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first, insert nulls as placeholders on skipped array
entries.
"ChassisType"
This property is a member of Chassis
This property indicates the type of physical form factor of this resource.
JSON type: String containing one of the following supported values:
This is the indicator LED for the chassis, which is used to identify the chassis. This LED can be manipulated by the user.
JSON type: String containing one of the following supported values:
"Unknown"
"Lit"
"Blinking"
"Off"
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
PATCH Example
HTTP PATCH to resource with request JSON:
{"IndicatorLED": "Lit"}
The property "IndicatorLED" on resource type
be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first, insert nulls as placeholders on skipped array
entries.
Chassis may not support PATCH of all values and may result in an HTTP 400 error with response of Type ExtendedError. Multiple properties may
"Manufacturer"
This property is a member of Chassis
This is the manufacturer of this chassis.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
"Model"
This property is a member of Chassis
This is the model number for the chassis.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
JSON type: String containing one of the following supported values:
"On"
"Off"
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
PATCH Example
HTTP PATCH to resource with request JSON:
{"Oem": {"Hp": {"AutoPowerOn": "Off"}}}
The property "Oem/Hp/AutoPowerOn" on resource type
properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first, insert nulls as placeholders on
skipped array entries.
Chassis may not support PATCH of all values and may result in an HTTP 400 error with response of Type ExtendedError. Multiple
"Oem/Hp/BaseFru[]/MfgDateTime"
This property is a member of Chassis
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"Oem/Hp/BaseFru[]/ProductName"
This property is a member of Chassis
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
GETRendered if supported by the implementation or omitted if not.
"Oem/Hp/Location/LocationOfChassis/UUID"
This property is a member of Chassis
Chassis UUID provided by SMBIOS.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"PartNumber"
This property is a member of Chassis
This is the part number of the chassis.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
"SKU"
This property is a member of Chassis
This is the SKU of the chassis.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
PATCH Example
HTTP PATCH to resource with request JSON:
{"SKU": "<string-value>"}
The property "SKU" on resource type
included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first, insert nulls as placeholders on skipped array
entries.
Chassis may not support PATCH of all values and may result in an HTTP 400 error with response of Type ExtendedError. Multiple properties may be
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
PATCH Example
HTTP PATCH to resource with request JSON:
{"SerialNumber": "<string-value>"}
The property "SerialNumber" on resource type
Chassis may not support PATCH of all values and may result in an HTTP 400 error with response of Type ExtendedError. Multiple properties
may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first, insert nulls as placeholders on skipped
array entries.
"Status/Health"
This property is a member of Chassis
Indicates the health state of this resource without considering its dependent resources.
JSON type: String containing one of the following supported values:
"OK"
"Warning"
"Critical"
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"Status/HealthRollUp"
This property is a member of Chassis
Indicates the overall health state of this resource and its dependent resources.
JSON type: String containing one of the following supported values:
GETRendered if supported by the implementation or omitted if not.
"Status/State"
This property is a member of Chassis
Indicates the known state of this resource (for example, if the resource is enabled). Enabled indicates that the resource is available. Disabled indicates that the resource has been made
unavailable intentionally, but it can be enabled. Offline indicates that the resource is unavailable intentionally and requires action to be made available. InTest indicates that the component is
undergoing testing. Starting indicates that the resource is on its way to becoming available. Absent indicates that the resource is physically unavailable.
JSON type: String containing one of the following supported values:
GETRendered if supported by the implementation or omitted if not.
"Version"
This property is a member of Chassis
This is the version of the chassis.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
This property is a member of ChassisFirmwareSummary
This string represents the version of the firmware image.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
This property is a member of ChassisFirmwareSummary
This string represents the version of the firmware image.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
This property is a member of ChassisFirmwareSummary
This string represents the version of the firmware image.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
This property is a member of ChassisFirmwareSummary
This string represents the version of the firmware image.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
"Cartridges[]/Model"
This property is a member of ChassisFirmwareSummary
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"Cartridges[]/Presence"
This property is a member of ChassisFirmwareSummary
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"Cartridges[]/SlotOrBayNumber"
This property is a member of ChassisFirmwareSummary
JSON type: Integer greater than or equal to 1.
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
This property is a member of ChassisFirmwareSummary
This string represents the version of the firmware image.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
This property is a member of ChassisFirmwareSummary
This string represents the version of the firmware image.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
This property is a member of ChassisFirmwareSummary
This string represents the version of the firmware image.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
"PowerSupplies[]/FirmwareVersion"
This property is a member of ChassisFirmwareSummary
This is the firmware version of the power supply.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"PowerSupplies[]/SlotOrBayNumber"
This property is a member of ChassisFirmwareSummary
JSON type: Integer greater than or equal to 1.
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"PowerSupplies[]/Status/Health"
This property is a member of ChassisFirmwareSummary
Indicates the health state of this resource without considering its dependent resources.
JSON type: String containing one of the following supported values:
"OK"
"Warning"
"Critical"
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"PowerSupplies[]/Status/HealthRollUp"
This property is a member of ChassisFirmwareSummary
Indicates the overall health state of this resource and its dependent resources.
JSON type: String containing one of the following supported values:
GETRendered if supported by the implementation or omitted if not.
"PowerSupplies[]/Status/State"
This property is a member of ChassisFirmwareSummary
Indicates the known state of this resource (for example, if the resource is enabled). Enabled indicates that the resource is available. Disabled indicates that the resource has been made
unavailable intentionally, but it can be enabled. Offline indicates that the resource is unavailable intentionally and requires action to be made available. InTest indicates that the component
is undergoing testing. Starting indicates that the resource is on its way to becoming available. Absent indicates that the resource is physically unavailable.
JSON type: String containing one of the following supported values:
This property is a member of ChassisFirmwareSummary
This string represents the version of the firmware image.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
This property is a member of ChassisFirmwareSummary
This string represents the version of the firmware image.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
This property is a member of ChassisFirmwareSummary
This string represents the version of the firmware image.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
This property is a member of ChassisFirmwareSummary
This string represents the version of the firmware image.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
This property is a member of ChassisFirmwareSummary
This string represents the version of the firmware image.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
JSON type: String containing one of the following supported values:
"On"
"Off"
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
PATCH Example
HTTP PATCH to resource with request JSON:
{"AutoPowerOn": "Off"}
The property "AutoPowerOn" on resource type
properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first, insert nulls as placeholders
on skipped array entries.
ChassisSummary may not support PATCH of all values and may result in an HTTP 400 error with response of Type ExtendedError. Multiple
"BayNumber"
This property is a member of ChassisSummary
JSON type: Integer greater than or equal to 0.
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"Cartridges[]/AutoRev"
This property is a member of ChassisSummary
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
GETRendered if supported by the implementation or omitted if not.
"Cartridges[]/Power"
This property is a member of ChassisSummary
JSON type: String containing one of the following supported values:
"On"
"Off"
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
PATCH Example
HTTP PATCH to resource with request JSON:
{"Cartridges": [null, {"Power": "Off"}]}
The property "Cartridges[]/Power" on resource type
Multiple properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first, insert nulls as
placeholders on skipped array entries.
"Cartridges[]/Presence"
This property is a member of ChassisSummary
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"Cartridges[]/ProcessorFamily"
This property is a member of ChassisSummary
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
Indicates the overall health state of this resource and its dependent resources.
JSON type: String containing one of the following supported values:
"OK"
"Warning"
"Critical"
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"Cartridges[]/Status/State"
This property is a member of ChassisSummary
Indicates the known state of this resource (for example, if the resource is enabled). Enabled indicates that the resource is available. Disabled indicates that the resource has been made
unavailable intentionally, but it can be enabled. Offline indicates that the resource is unavailable intentionally and requires action to be made available. InTest indicates that the component
is undergoing testing. Starting indicates that the resource is on its way to becoming available. Absent indicates that the resource is physically unavailable.
JSON type: String containing one of the following supported values:
GETRendered if supported by the implementation or omitted if not.
"Fans[]/Status/State"
This property is a member of ChassisSummary
Indicates the known state of this resource (for example, if the resource is enabled). Enabled indicates that the resource is available. Disabled indicates that the resource has been made
unavailable intentionally, but it can be enabled. Offline indicates that the resource is unavailable intentionally and requires action to be made available. InTest indicates that the component
is undergoing testing. Starting indicates that the resource is on its way to becoming available. Absent indicates that the resource is physically unavailable.
JSON type: String containing one of the following supported values:
This string represents the version of the firmware image.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
This string represents the version of the firmware image.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
This string represents the version of the firmware image.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
This string represents the version of the firmware image.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
JSON type: String containing one of the following supported values:
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
"HealthLED"
This property is a member of ChassisSummary
This property is indicates the state of the chassis health LED.
JSON type: String containing one of the following supported values:
"Unknown"
"Red"
"Amber"
"Green"
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"HealthStatusCount/Critical"
This property is a member of ChassisSummary
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"HealthStatusCount/OK"
This property is a member of ChassisSummary
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"IndicatorLED"
This property is a member of ChassisSummary
This property is indicates the state of the UID LED.
GETRendered if supported by the implementation or omitted if not.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
PATCH Example
HTTP PATCH to resource with request JSON:
{"IndicatorLED": "Lit"}
The property "IndicatorLED" on resource type
properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first, insert nulls as placeholders
on skipped array entries.
ChassisSummary may not support PATCH of all values and may result in an HTTP 400 error with response of Type ExtendedError. Multiple
"Manufacturer"
This property is a member of ChassisSummary
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"Model"
This property is a member of ChassisSummary
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
GETRendered if supported by the implementation or omitted if not.
"PowerSupplies[]/Status/Health"
This property is a member of ChassisSummary
Indicates the health state of this resource without considering its dependent resources.
JSON type: String containing one of the following supported values:
"OK"
"Warning"
"Critical"
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"PowerSupplies[]/Status/HealthRollUp"
This property is a member of ChassisSummary
Indicates the overall health state of this resource and its dependent resources.
JSON type: String containing one of the following supported values:
"OK"
"Warning"
"Critical"
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"PowerSupplies[]/Status/State"
This property is a member of ChassisSummary
Indicates the known state of this resource (for example, if the resource is enabled). Enabled indicates that the resource is available. Disabled indicates that the resource has been made
unavailable intentionally, but it can be enabled. Offline indicates that the resource is unavailable intentionally and requires action to be made available. InTest indicates that the component
is undergoing testing. Starting indicates that the resource is on its way to becoming available. Absent indicates that the resource is physically unavailable.
JSON type: String containing one of the following supported values:
Indicates the known state of this resource (for example, if the resource is enabled). Enabled indicates that the resource is available. Disabled indicates that the resource has been made
unavailable intentionally, but it can be enabled. Offline indicates that the resource is unavailable intentionally and requires action to be made available. InTest indicates that the component
is undergoing testing. Starting indicates that the resource is on its way to becoming available. Absent indicates that the resource is physically unavailable.
JSON type: String containing one of the following supported values:
GETRendered if supported by the implementation or omitted if not.
"Switches[]/Model"
This property is a member of ChassisSummary
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"Switches[]/Power"
This property is a member of ChassisSummary
JSON type: String containing one of the following supported values:
"On"
"Off"
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
PATCH Example
HTTP PATCH to resource with request JSON:
{"Switches": [null, {"Power": "Off"}]}
The property "Switches[]/Power" on resource type
Multiple properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first, insert nulls as
placeholders on skipped array entries.
"Switches[]/Presence"
This property is a member of ChassisSummary
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
GETRendered if supported by the implementation or omitted if not.
"Switches[]/Status/State"
This property is a member of ChassisSummary
Indicates the known state of this resource (for example, if the resource is enabled). Enabled indicates that the resource is available. Disabled indicates that the resource has been made
unavailable intentionally, but it can be enabled. Offline indicates that the resource is unavailable intentionally and requires action to be made available. InTest indicates that the component
is undergoing testing. Starting indicates that the resource is on its way to becoming available. Absent indicates that the resource is physically unavailable.
JSON type: String containing one of the following supported values:
"Collection" defines the following properties specified in JSON-pointer syntax
"MemberType"
This property is a member of Collection
This property has the type of members in this collection. All of the members of a collection have the same value for their Type property, thus they are all the same kind of resource.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
GETRendered if supported by the implementation or omitted if not.
"ComputerSystem" Resource Type
Resource Instances
/rest/v1/Systems/{item}
See Resource Map for more details.
The schema definition of a computer system and its properties. A computer system represents a physical or virtual machine and the local resources, such as memory, CPU, and other
devices that can be accessed from that machine.
ComputerSystem resources are members of the Systems collection at /rest/v1/Systems. Each ComputerSystem contains an OEM section with HP-specific properties. Because resource
types are used in multiple implementations, not all instances of the ComputerSystem type will contain all the properties listed below.
"ComputerSystem" defines the following properties specified in JSON-pointer syntax
"AssetTag"
This property is a member of ComputerSystem
This is a user-definable tag that can be used to track this system for inventory or other client purposes.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
PATCH Example
HTTP PATCH to resource with request JSON:
{"AssetTag": "<string-value>"}
The property "AssetTag" on resource type
properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first, insert nulls as placeholders
on skipped array entries.
GETRendered if supported by the implementation or omitted if not.
"Boot/BootSourceOverrideEnabled"
This property is a member of ComputerSystem
BootSourceOverrideTarget must be specified before BootSourceOverrideEnabled can be used.
JSON type: String containing one of the following supported values:
"Disabled"
"Once"
"Continuous"
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
PATCH Example
HTTP PATCH to resource with request JSON:
{"Boot": {"BootSourceOverrideEnabled": "Once"}}
The property "Boot/BootSourceOverrideEnabled" on resource type
ExtendedError. Multiple properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first,
insert nulls as placeholders on skipped array entries.
"Boot/BootSourceOverrideTarget"
This property is a member of ComputerSystem
The current boot source to be used at next boot instead of the normal boot device, if BootSourceOverrideEnabled is not Disabled.
JSON type: String containing one of the following supported values:
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
The property "Boot/BootSourceOverrideTarget" on resource type
ExtendedError. Multiple properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first,
ComputerSystem may not support PATCH of all values and may result in an HTTP 400 error with response of Type
insert nulls as placeholders on skipped array entries.
"Boot/UefiTargetBootSourceOverride"
This property is a member of ComputerSystem
The UEFI device path of the device to boot from when BootSourceOverrideTarget is UefiTarget.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
The property "Boot/UefiTargetBootSourceOverride" on resource type
ExtendedError. Multiple properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first,
insert nulls as placeholders on skipped array entries.
ComputerSystem may not support PATCH of all values and may result in an HTTP 400 error with response of Type
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
"HostCorrelation/HostName"
This property is a member of ComputerSystem
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
"IndicatorLED"
This property is a member of ComputerSystem
This property indicates the state of the indicator LED.
JSON type: String containing one of the following supported values:
"Unknown"
"Lit"
"Blinking"
"Off"
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
PATCH Example
HTTP PATCH to resource with request JSON:
{"IndicatorLED": "Lit"}
The property "IndicatorLED" on resource type
properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first, insert nulls as placeholders
on skipped array entries.
ComputerSystem may not support PATCH of all values and may result in an HTTP 400 error with response of Type ExtendedError. Multiple
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
"Memory/Status/Health"
This property is a member of ComputerSystem
Indicates the health state of this resource without considering its dependent resources.
JSON type: String containing one of the following supported values:
"OK"
"Warning"
"Critical"
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"Memory/Status/HealthRollUp"
This property is a member of ComputerSystem
Indicates the overall health state of this resource and its dependent resources.
JSON type: String containing one of the following supported values:
"OK"
"Warning"
"Critical"
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"Memory/Status/State"
This property is a member of ComputerSystem
Indicates the known state of this resource (for example, if the resource is enabled). Enabled indicates that the resource is available. Disabled indicates that the resource has been made
unavailable intentionally, but it can be enabled. Offline indicates that the resource is unavailable intentionally and requires action to be made available. InTest indicates that the component
is undergoing testing. Starting indicates that the resource is on its way to becoming available. Absent indicates that the resource is physically unavailable.
JSON type: String containing one of the following supported values:
GETRendered if supported by the implementation or omitted if not.
"Memory/TotalSystemMemoryGB"
This property is a member of ComputerSystem
The total amount of memory in the system, measured in GB.
JSON type: Integer greater than or equal to 0.
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
"Model"
This property is a member of ComputerSystem
This is the model information that the manufacturer uses to refer to this system.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
"Oem/Hp/MemoryModules[]/CapacityGB"
This property is a member of ComputerSystem
JSON type: Integer greater than or equal to 0.
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"Oem/Hp/MemoryModules[]/ClockSpeed"
This property is a member of ComputerSystem
Identifies the configured clock speed to the memory device, in megahertz (MHz). If the value is 0, the speed is unknown.
JSON type: Integer
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
"Oem/Hp/MemoryModules[]/DataWidth"
This property is a member of ComputerSystem
JSON type: Integer
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
Identifies when the Memory Device is one of a set of Memory Devices that must be populated with all devices of the same type and size, and the set to which this device belongs. A value of
0 indicates that the device is not part of a set; a value of 255 indicates that the attribute is unknown.
JSON type: Integer
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
"Oem/Hp/MemoryModules[]/FormFactor"
This property is a member of ComputerSystem
JSON type: String containing one of the following supported values:
JSON type: String containing one of the following supported values:
"enabled"
"disabled"
"DISABLE"
"ENABLE"
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
PATCH Example
HTTP PATCH to resource with request JSON:
{"Oem": {"Hp": {"Options": {"BSC": "DISABLE"}}}}
The property "Oem/Hp/Options/BSC" on resource type
ComputerSystem may not support PATCH of all values and may result in an HTTP 400 error with response of Type ExtendedError.
Multiple properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first, insert nulls as
placeholders on skipped array entries.
"Oem/Hp/Options/BootOnce"
This property is a member of ComputerSystem
The current boot source to be used at next boot instead of the normal boot device
JSON type: String containing one of the following supported values:
"None"
"HDD"
"PXE"
"iSCSI"
"M.2"
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
PATCH Example
HTTP PATCH to resource with request JSON:
{"Oem": {"Hp": {"Options": {"BootOnce": "PXE"}}}}
The property "Oem/Hp/Options/BootOnce" on resource type
ComputerSystem may not support PATCH of all values and may result in an HTTP 400 error with response of Type
ExtendedError. Multiple properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first,
insert nulls as placeholders on skipped array entries.
"Oem/Hp/Options/CPU/ClockRate/CurrentFrequency"
This property is a member of ComputerSystem
Current CPU clock rate
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
The property "Oem/Hp/Options/CPU/ClockRate/CurrentFrequency" on resource type
response of Type
ExtendedError. Multiple properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other
ComputerSystem may not support PATCH of all values and may result in an HTTP 400 error with
than the first, insert nulls as placeholders on skipped array entries.
"Oem/Hp/Options/CPU/HyperThreading"
This property is a member of ComputerSystem
Intel CPU HyperThreading
JSON type: String containing one of the following supported values:
"enabled"
"disabled"
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
The property "Oem/Hp/Options/CPU/HyperThreading" on resource type
ExtendedError. Multiple properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first,
insert nulls as placeholders on skipped array entries.
ComputerSystem may not support PATCH of all values and may result in an HTTP 400 error with response of Type
GETRendered if supported by the implementation or omitted if not.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
The property "Oem/Hp/Options/WOL" on resource type
ComputerSystem may not support PATCH of all values and may result in an HTTP 400 error with response of Type ExtendedError.
Multiple properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first, insert nulls as
placeholders on skipped array entries.
"Oem/Hp/PowerOnDelay"
This property is a member of ComputerSystem
Redundent with HpBios::PowerOnDelay
JSON type: String containing one of the following supported values:
GETRendered if supported by the implementation or omitted if not.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
PATCH Example
HTTP PATCH to resource with request JSON:
{"Oem": {"Hp": {"PowerOnDelay": "45Sec"}}}
The property "Oem/Hp/PowerOnDelay" on resource type
Multiple properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first, insert nulls as
ComputerSystem may not support PATCH of all values and may result in an HTTP 400 error with response of Type ExtendedError.
placeholders on skipped array entries.
"Oem/Hp/VirtualUUID"
This property is a member of ComputerSystem
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
"PartNumber"
This property is a member of ComputerSystem
The part number for this system as defined by the manufacturer.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
"Power"
This property is a member of ComputerSystem
This is the current power state of the system.
JSON type: String containing one of the following supported values:
"On"
"Off"
"Unknown"
"Reset"
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
Indicates the health state of this resource without considering its dependent resources.
"Processors/CurrentClockSpeedMHz"
This property is a member of ComputerSystem
Processor Clock Speed in MHz
JSON type: Integer greater than or equal to 0.
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
"Processors/MaxClockSpeedMHz"
This property is a member of ComputerSystem
JSON type: Integer greater than or equal to 0.
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
"Processors/NumberOfCores"
This property is a member of ComputerSystem
JSON type: Integer greater than or equal to 0.
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
"Processors/ProcessorFamily"
This property is a member of ComputerSystem
This is the processor family for the processors in the system.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
JSON type: String containing one of the following supported values:
"OK"
"Warning"
"Critical"
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"Processors/Status/HealthRollUp"
This property is a member of ComputerSystem
Indicates the overall health state of this resource and its dependent resources.
JSON type: String containing one of the following supported values:
"OK"
"Warning"
"Critical"
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"Processors/Status/State"
This property is a member of ComputerSystem
Indicates the known state of this resource (for example, if the resource is enabled). Enabled indicates that the resource is available. Disabled indicates that the resource has been made
unavailable intentionally, but it can be enabled. Offline indicates that the resource is unavailable intentionally and requires action to be made available. InTest indicates that the component
is undergoing testing. Starting indicates that the resource is on its way to becoming available. Absent indicates that the resource is physically unavailable.
JSON type: String containing one of the following supported values:
"Removed"
"Redundant"
"Not Redundant"
"Insufficient to Operate"
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"SKU"
This property is a member of ComputerSystem
The manufacturer's SKU for this system.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
"SerialNumber"
This property is a member of ComputerSystem
The serial number for this system.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
"Status/Health"
This property is a member of ComputerSystem
Indicates the health state of this resource without considering its dependent resources.
JSON type: String containing one of the following supported values:
"OK"
"Warning"
"Critical"
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
Indicates the overall health state of this resource and its dependent resources.
JSON type: String containing one of the following supported values:
"OK"
"Warning"
"Critical"
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"Status/State"
This property is a member of ComputerSystem
Indicates the known state of this resource (for example, if the resource is enabled). Enabled indicates that the resource is available. Disabled indicates that the resource has been made
unavailable intentionally, but it can be enabled. Offline indicates that the resource is unavailable intentionally and requires action to be made available. InTest indicates that the component
is undergoing testing. Starting indicates that the resource is on its way to becoming available. Absent indicates that the resource is physically unavailable.
JSON type: String containing one of the following supported values:
GETRendered if supported by the implementation or omitted if not.
"UUID"
This property is a member of ComputerSystem
The universal unique identifier for this system.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
"Version"
This property is a member of ComputerSystem
The version of this system as defined by the manufacturer.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
This property is a member of EthernetNetworkInterface
Autosense speed/duplex enabled or disabled. This property can be disabled only if the SpeedMbps and FullDuplex values are specified. This property is applicable only for a dedicated
network port. This property can only be modified on a dedicated network port. It cannot be modified for blade servers.
JSON type: Boolean ('true' or 'false')
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
PATCH Example
HTTP PATCH to resource with request JSON:
{"Autosense": true}
The property "Autosense" on resource type
EthernetNetworkInterface may not support PATCH of all values and may result in an HTTP 400 error with response of Type ExtendedError.
Multiple properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first, insert nulls as
placeholders on skipped array entries.
"FactoryMacAddress"
This property is a member of EthernetNetworkInterface
This is the MAC address assigned to the NIC at the factory.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"FullDuplex"
This property is a member of EthernetNetworkInterface
Connection duplex status. If Autosense is enabled, this property cannot be modified. This property is applicable only for a dedicated network port. This property can only be modified on a
dedicated network port. It cannot be modified for blade servers.
JSON type: Boolean ('true' or 'false')
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
The property "FullDuplex" on resource type EthernetNetworkInterface may not support PATCH of all values and may result in an HTTP 400 error with response of Type ExtendedError.
Multiple properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first, insert nulls as
placeholders on skipped array entries.
"IPv4Addresses[]/Address"
This property is a member of EthernetNetworkInterface
This is the IPv4 Address.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
The property "IPv4Addresses[]/Address" on resource type
ExtendedError. Multiple properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first,
insert nulls as placeholders on skipped array entries.
EthernetNetworkInterface may not support PATCH of all values and may result in an HTTP 400 error with response of Type
"IPv4Addresses[]/AddressOrigin"
This property is a member of EthernetNetworkInterface
This indicates how the address was determined.
JSON type: String containing one of the following supported values:
"DHCP"
"Static"
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
"IPv4Addresses[]/Gateway"
This property is a member of EthernetNetworkInterface
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
The property "IPv4Addresses[]/Gateway" on resource type
ExtendedError. Multiple properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first,
insert nulls as placeholders on skipped array entries.
EthernetNetworkInterface may not support PATCH of all values and may result in an HTTP 400 error with response of Type
"IPv4Addresses[]/SubnetMask"
This property is a member of EthernetNetworkInterface
This is the IPv4 Subnet mask.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not. The value of this property may also be null if it is unavailable at the time of the request.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
The property "IPv4Addresses[]/SubnetMask" on resource type
ExtendedError. Multiple properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first,
insert nulls as placeholders on skipped array entries.
EthernetNetworkInterface may not support PATCH of all values and may result in an HTTP 400 error with response of Type
"MacAddress"
This property is a member of EthernetNetworkInterface
The effective current MAC address. If the assignable MAC address is not supported, this is a read-only alias of FactoryMacAddress.
JSON type: String
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
This property is a member of EthernetNetworkInterface
The state of the currently displayed configuration settings.
JSON type: String containing one of the following supported values:
"Current"
"SomePendingReset"
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
"Oem/Hp/DHCPv4/Enabled"
This property is a member of EthernetNetworkInterface
Determines whether DHCPv4 is enabled.
JSON type: Boolean ('true' or 'false')
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
PATCH Example
HTTP PATCH to resource with request JSON:
{"Oem": {"Hp": {"DHCPv4": {"Enabled": true}}}}
The property "Oem/Hp/DHCPv4/Enabled" on resource type
ExtendedError. Multiple properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first,
insert nulls as placeholders on skipped array entries.
"Oem/Hp/DHCPv4/UseDNSServers"
This property is a member of EthernetNetworkInterface
Determines whether to use DHCPv4-supplied DNS servers. Applies only when DHCPv4 is enabled.
JSON type: Boolean ('true' or 'false')
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
The property "Oem/Hp/DHCPv4/UseDNSServers" on resource type
ExtendedError. Multiple properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first,
Type
EthernetNetworkInterface may not support PATCH of all values and may result in an HTTP 400 error with response of
insert nulls as placeholders on skipped array entries.
"Oem/Hp/DHCPv4/UseDomainName"
This property is a member of EthernetNetworkInterface
Determines whether to use a DHCPv4-supplied domain name.
JSON type: Boolean ('true' or 'false')
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
The property "Oem/Hp/DHCPv4/UseDomainName" on resource type
ExtendedError. Multiple properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first,
Type
insert nulls as placeholders on skipped array entries.
EthernetNetworkInterface may not support PATCH of all values and may result in an HTTP 400 error with response of
"Oem/Hp/DHCPv4/UseGateway"
This property is a member of EthernetNetworkInterface
Determines whether to use a DHCPv4-supplied gateway.
JSON type: Boolean ('true' or 'false')
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
PATCH Example
HTTP PATCH to resource with request JSON:
{"Oem": {"Hp": {"DHCPv4": {"UseGateway": true}}}}
The property "Oem/Hp/DHCPv4/UseGateway" on resource type
ExtendedError. Multiple properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first,
EthernetNetworkInterface may not support PATCH of all values and may result in an HTTP 400 error with response of Type
insert nulls as placeholders on skipped array entries.
"Oem/Hp/DHCPv4/UseNTPServers"
This property is a member of EthernetNetworkInterface
Determines whether to use DHCPv4-supplied NTP servers. Applies only when DHCPv4 is enabled.
JSON type: Boolean ('true' or 'false')
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
The property "Oem/Hp/DHCPv4/UseNTPServers" on resource type
ExtendedError. Multiple properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first,
Type
insert nulls as placeholders on skipped array entries.
EthernetNetworkInterface may not support PATCH of all values and may result in an HTTP 400 error with response of
"Oem/Hp/DHCPv4/UseStaticRoutes"
This property is a member of EthernetNetworkInterface
Determines whether to use DHCPv4-supplied static routes.
JSON type: Boolean ('true' or 'false')
HTTP Operations
GETRendered if supported by the implementation or omitted if not.
PATCHThis property may be PATCHed if the resource instance of this type supports PATCH in the HTTP Allow headers.
The property "Oem/Hp/DHCPv4/UseStaticRoutes" on resource type
ExtendedError. Multiple properties may be included in a single HTTP PATCH operation as long as the request is properly formatted JSON. To address an array entry other than the first,
Type
insert nulls as placeholders on skipped array entries.
EthernetNetworkInterface may not support PATCH of all values and may result in an HTTP 400 error with response of
"Oem/Hp/DHCPv4/UseWINSServers"
This property is a member of EthernetNetworkInterface