OpenManage Enterprise Power Manager RESTful API Guide version 1.2 July 2020 Rev.
Notes, cautions, and warnings NOTE: A NOTE indicates important information that helps you make better use of your product. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. © 2019 - 2020 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
Contents Chapter 1: About this document....................................................................................................... 6 Chapter 2: Overview....................................................................................................................... 7 Introduction to Power Manager...........................................................................................................................................7 RESTful application programming interface...............
/api/PowerService/CapableGroups................................................................................................................................. 27 GET method for Representing Capable Groups........................................................................................................28 /api/PowerService/CapableGroups()/Devices.........................................................................................
POST method to add unmonitored device................................................................................................................ 55 api/PowerService/UserDefinedEntities/Actions/UserDefinedEntities.Update......................................................... 56 POST method to edit unmonitored device................................................................................................................ 56 api/PowerService/UserDefinedEntities/Actions/UserDefinedEntities.Delete..
1 About this document This document contains information about the resource models for Dell EMC OpenManage Enterprise Power Manager. Each RESTful API specification includes the URI, method, parameters, request codes, and response codes. For OpenManage Enterprise RESTful API specifications, see OpenManage Enterprise and OpenManage Enterprise - Modular Edition RESTful API Guide .
2 Overview RESTful API support in Dell EMC OpenManage Enterprise Power Manager Power Manager supports RESTful API. APIs on these products enhance the systems management capabilities. The RESTful interface is provided over HTTPS in JSON format that is based on ODATA v4 usable by clients, scripts, and browser-based GUIs. The APIs enable you to build console management tools that are based on common programming and scripting languages such as Python, Java, and C.
but uses conventions familiar to programmers of the C-family of languages such as C, C++, C#, Java, JavaScript, PERL, and Python. These properties make JSON an ideal data-interchange language. HTTPS communication The Hypertext Transfer Protocol or HTTP is an application protocol for distributed, collaborative, hypermedia information systems. HTTP forms the foundation of data communication for the World Wide Web.
3 Key integration concepts This section describes the key integration concepts that are applicable to the use cases and resource model. Topics: • • • • • • • • • • • • • Base URI Security Authentication Authorization Resource addressing Resource operations Security considerations Data filtering Data sorting Data pagination Request headers Response codes Response headers Base URI REST API tree structure The console software provides a web-based hypermedia driven API using a simple folder structure.
Resource model https://[IP or DNS name]/api/$metadata Security To improve security, only HTTPS is supported. You can also update the SSL self-signed certificate with a custom certificate. For example, you can upload a PKCS-12 certificate or sign an application-generated Certificate Signing Request (CSR). Authentication Several common schemes are available for enabling authentication of REST requests. Basic Authentication and X-Auth-Token Authentication are some of the common schemes.
Table 1. Authentication and authorization requirements (continued) Actions Authentication required Authorization required Invoke actions Y Y View service root N N View metadata document N N View OData service document N N View message registry Y N View Redfish version URI N N View JSONSchemaFile resource URI N/A N/A View JSON schemas URI N/A N/A OME Table 2.
Following is the format of a resource URI: // Following is an example of a resource URI, where 1234 is the unique identifier for the device: /DeviceService/Devices(1234) Resource operations Standard HTTP methods are used for creating, retrieving, updating, and deleting resources. The mapping of the HTTP methods to operational semantics is described in the following table: Table 3.
Filter devices by system ID /api/DeviceService/Devices?$filter=SystemId eq 123 Filter devices by model using equal operator /api/DeviceService/Devices?$filter=Model eq 'PowerEdge MX740c' Filter devices by model using contains operator /api/PowerService/MonitoredDevices?$filter=contains(Model,'PowerEdge') Filter devices by device type /api/DeviceService/Devices?$filter=Type eq 3000 or Type eq 5000 Adding combinations of filters /api/PowerService/MonitoredDevices?$filter=contains(Model,'PowerEdge') a
Table 4. Examples of request headers Request Header Description Example x-auth-token Authentication token taken from the return header of the SessionService/ Sessions POST operation to create a session. x-auth-token: d6399a19-38c8-467ba1ec-75ffa03efb7c Accept-Language Choice of language that the client can request—Optional. Accept-Language: en Response codes For synchronous operations, the server returns HTTP response codes 200 or 204.
Table 6. Examples of response headers (continued) Response Header Description Content-Type Specifies the format of the content that the Content-Type: application/json; server returns. If there are multiple formats odata.metadata=minimal that can be accepted in the client request (using the Accept header), the server chooses the appropriate supported format.
4 Settings Topics: • • /api/PowerService/Settings /api/PowerService/Actions/PowerService.UpdateSettings /api/PowerService/Settings This URI represents the list of power settings. Supported versions of Power Manager: • • • 1.2 1.1 1.0 GET method for Power Service Settings To get power and temperature monitoring units, metric gathering interval, date range configuration for Top Energy Consumers widgets and Report settings. Description This method returns the list of settings that are configured.
}, { }, { }, { }, { } } "Name": "BUILT_IN_REPORT_TIME_INTERVAL", "DefaultValue": 90, "Value": 90 "@odata.type": "#PowerService.Settings", "Id": 6, "Name": "BUILT_IN_REPORT_TIME_GRANULARITY", "DefaultValue": 2, "Value": 2 "@odata.type": "#PowerService.Settings", "Id": 7, "Name": "TOP_ENERGY_CONSUMERS_DURATION","DefaultValue": 8, "Value": 8 "@odata.type": "#PowerService.Settings", "Id": 8, "Name": "DELETE_METRIC_DATA", "DefaultValue": 2, "Value": 2 "@odata.type": "#PowerService.
Privilege APPLIANCE_SETUP HTTP response codes 200 Example Input: { "Settings":[ { "Id": 1, "Value": 1 }, { "Id": 2, "Value": 1 }, { "Id": 3, "Value": 15 }, { "Id": 5, "Value": 90 }, { "Id": 6, "Value": 2 }, { "Id": 7, "Value": 8 }, { "Id": 8, "Value": 1 }, { "Id": 9, "Value": 2 } ] } Output: { "Status": true } Table 8.
Table 9. Temperature Display Unit Enumeration (continued) Enumeration Value Description 2 Fahrenheit Table 10. Power Display Unit Enumeration Enumeration Value Description 1 Watt 2 BTU/Hr Table 11. Metric Gathering Interval Enumeration Enumeration Value Description 15 15 Minutes 30 30 Minutes 60 60 Minutes Table 12. Built-in Report Time Interval Enumeration Enumeration Value Description 1 1 Day 7 7 Days 15 15 Days 30 30 Days 90 90 Days 180 180 Days 365 365 Days Table 13.
Table 15. Delete Metric Data Enumeration (continued) Enumeration Value Description 2 Keep data Table 16.
5 Monitored Devices Topics: • • • /api/PowerService/Actions/PowerService.AddDevices /api/PowerService/Actions/PowerService.RemoveDevices /api/PowerService/MonitoredDevices /api/PowerService/Actions/ PowerService.AddDevices This URI is to add the devices to Power Manager. Supported versions of Power Manager: • • • 1.2 1.1 1.0 POST method to add Devices This method adds device(s) to Power Manager. Description Adds device(s) to Power Manager.
• • 1.1 1.0 POST method to remove Monitored Devices This method removes device(s) from Power Manager. Description Removes device(s) from Power Manager. Privilege DEVICE_CONFIGURATION HTTP response codes 200 Example Input: { "Ids": [10128,10127] } Output: { "Status": "SUCCESS" } Table 18. Attributes Attribute Name Description Id Device Id(s) to be removed from the Power Manager NOTE: To remove all devices from Power Manager, provide value as -1.
"@odata.context": "/api/ $metadata#Collection(PowerService.MonitoredDevice)", "@odata.count": 1, "value": [ { "@odata.type": "#PowerService.MonitoredDevice", "@odata.id": "/api/PowerService/MonitoredDevices(10079)", "Id": 10079, "DeviceName": "100.96.27.67", "ServiceTag": "DSFYSF2", "Type": 1000, "Model": "PowerEdge M630", "PowerState": 17, "ConnectionState": true, "HealthStatus": 1000, "ManagedState": 3000, "AddedOn": "2019-06-25 12:55:34.
Table 20. Attributes (continued) Attribute Name Description PowerPolicyCapable Device is Policy capable or not. AllDevices Filter attribute to get all devices or individual devices. IsPartOfGroup Device is part of group or not. License enumerations are defined in following table. Table 21. License Status Enumeration Enumeration Value Description 1 Active 2 Expired 3 Not Applicable Table 22.
Table 23.
6 Monitored Groups Topics: • • • • • • • /api/PowerService/Actions/PowerService.AddGroups /api/PowerService/Actions/PowerService.RemoveGroups /api/PowerService/CapableGroups /api/PowerService/CapableGroups()/Devices /api/PowerService/Groups()/Devices /api/PowerService/MonitoredGroups /api/PowerService/MonitoredGroups()/Devices /api/PowerService/Actions/ PowerService.AddGroups This URI adds the group(s) to Power Manager. Supported versions of Power Manager: • • • 1.2 1.1 1.
/api/PowerService/Actions/ PowerService.RemoveGroups This URI removes the group(s) from Power Manager. Supported versions of Power Manager: • • • 1.2 1.1 1.0 POST method to remove Monitored Groups This method removes group(s) from Power Manager. Description Removes Group(s) from Power Manager Privilege GROUP_MANAGEMENT HTTP response codes 200 Example Input: { "Ids": [10131,10132] } Output: { "Status": "SUCCESS" } Table 25. Attributes Attribute Name Description Ids Device Id(s) to be removed.
GET method for Representing Capable Groups This method represents the capable groups. Description Returns a list of capable groups. Privilege VIEW HTTP response codes 200 Example Input: None Output: { "@odata.context":"/api/$metadata#Collection(PowerService.CapableGroups)", "@odata.count": 1, "value": [ { "@odata.type": "#PowerService.CapableGroups", "@odata.
GET method for Representing All Devices from Capable Group This method represents all the devices from capable group. Description Returns all the devices belonging to a capable group. Privilege VIEW HTTP response codes 200 Example Input: None Output: { "@odata.context": "/api/$metadata#Collection(PowerService.Device)", "@odata.count": 1, "value": [ { "@odata.type": "#PowerService.Device", "Id": 10069, "DeviceName": "SKCLUSN1.tejd.bdcsv.
/api/PowerService/Groups()/Devices This URI represents all the Power Manager capable devices. Supported versions of Power Manager: • • • 1.2 1.1 1.
Table 30. Attributes (continued) Attribute Name Description Model Device Model. InWorkingSet Available in monitored list. IsPolicyCapable Capable to apply Power cap policy or not. IsAddedIndividually Device is added individually or not. Table 31.
GET method for Representing Monitored Groups This method represents all groups which are monitored. Description Returns all the Power Manager monitored groups. Privilege VIEW HTTP response codes 200 Example Input: None Output: { "@odata.context": "/api/$metadata#Collection(PowerService.MonitoredGroup)", "@odata.count": 1, "value": [ { "@odata.type": "#PowerService.MonitoredGroup", "@odata.
Table 34. Filters (continued) Field Operator Name contains Description contains List of all the sort options that this method supports: • • • • • • • • Id ParentId Type Name Description Location DevicesInWorkingSet AddedOn /api/PowerService/MonitoredGroups()/Devices This URI represents all the devices of a monitored group Table 35. Filters Filter Name Description Top Required number of records Skip Number of records to skip. Default value is zero.
} ] } "ManagedState": 3000, "ConnectionState": true, "HealthStatus": 4000, "Model": "PowerEdge R940", "InWorkingSet": true, "IsPolicyCapable": true "IsAddedIndividually": false Table 36. Attributes Attribute name Description Id Device Id DeviceName Device Name ServiceTag Device Service Tag Type Device Type PowerState Power State of device.
7 Power Policy Topics: • • • • • • • • • • • api/PowerService/PowerBounds /api/PowerService/Policies /api/PowerService/Policies() /api/PowerService/Policies()/PolicyDetails /api/PowerService/MonitoredDevices()/Policies /api/PowerService/MonitoredGroups()/Policies /api/PowerService/Actions/PowerService.CreatePolicy /api/PowerService/Actions/PowerService. EditPolicy /api/PowerService/Actions/PowerService.EnablePolicies /api/PowerService/Actions/PowerService.
NOTE: Only single entity ID is supported and pass only device ids. /api/PowerService/Policies This URI represents the power policies that are created Table 38. Filters Filter Name Description Top Required number of records Skip Number of records to skip. Default value is zero. Supported versions of Power Manager: • • • 1.2 1.1 1.0 GET method for retrieving Policies This method returns all the power policies. Description Returns all the power policies.
} ] } Table 39. Attributes Attribute Name Description PolicyId ID of policy Name Name associated with the policy. Type Type of policy. Description Description associated with the policy Enabled Indicates if the policy is enabled or disabled AssignedTo Entity on which the policy is assigned to. CreatedTime Time at which the policy is created. ExecutionState State associated with the policy. PolicyDetails Link to the detailed view of the policy.
• • Type IsAssociatedToGroup /api/PowerService/Policies() This URI represents a specific policy. Supported versions of Power Manager: • • 1.2 1.1 GET method for Policies() This method returns a specific policy. Description Returns details of a specific policy. Privilege VIEW HTTP response codes 200 Example Input: None Output: { "@odata.context": "/api/$metadata#Collection(PowerService.PowerPolicy)", "@odata.count": 1, "value": [ { "@odata.type": "#PowerService.
Table 43. Attributes (continued) Attribute Name Description ExecutionState State associated with the policy. PolicyDetails Link to the detailed view of the policy. IsAssociatedToGroup The policy is associated to group or not. Table 44. Policy Execution State Enumeration Enumeration Value Description 1 NOSTATE (Policy execution state is not yet determined). 2 EXECUTING (Policy execution is in progress or pending). 3 SUCCESS (Policy execution is successful).
"DeviceName": "100.96.25.126", "Type": 2000, "ServiceTag": "D89RG52", "PowerCapValue": 16670, "Ip": null } } ], "Group": { "Id": 10132, "PowerCapValue": 16670, "TemperatureThreshold": 45, "Name": "DeviceGroup", "Description": "" } Table 45. Attributes Attribute name Description PolicyId ID of power policy. Name Name associated with the policy. Type Type of policy. Description Description associated with the policy. Enabled Indicates if the policy is enabled or disabled.
/api/PowerService/ MonitoredDevices()/Policies This method returns policies that are created on the specific device. Supported versions of Power Manager: • • • 1.2 1.1 1.0 GET method for policies created on specified devices This URI returns the power policies that are created on the specified device. Description Returns all the power policies. Privilege VIEW HTTP response codes 200 Example Input: None Output: { "@odata.context": "/api/$metadata#Collection(PowerService.Policy)", "@odata.
/api/PowerService/ MonitoredGroups()/Policies This URI returns the power policies that are created on the specified group. Supported versions of Power Manager: • • • 1.2 1.1 1.0 GET method for policies created on specified groups Description Returns all the power policies. Privilege VIEW HTTP response codes 200 Example Input: None Output: { "@odata.context": "/api/$metadata#Collection(PowerService.Policy)", "@odata.count": 1, "value": [ { "@odata.type": "#PowerService.
/api/PowerService/Actions/ PowerService.CreatePolicy This method creates a policy. Supported versions of Power Manager: • • • 1.2 1.1 1.0 POST method for creating Policy This method creates a power policy.
Table 49. Attributes Attribute name Description Name Name associated with the policy. Description Description associated with the policy Enabled Indicates if the policy is enabled or disabled Schedule Indicates when the policy will be enabled StartTime Time at which the policy interval starts. EndTime Time at which the policy interval ends. StartDate Date from which the policy is active. EndDate Date until which the policy is active.
Example Input to edit static power policy: { "Id": 30, "Name": "Group Policy", "Description": "Updated policy on group", "Enabled": true, "Schedule": { "StartTime": "", "EndTime": "", "StartDate": "2019-06-1", "EndDate": "2019-07-28", "DaysOfTheWeek": ["MON", "TUE", "WED", "FRI", "THU", "SAT", "SUN"] }, "Targets": [ { "Id": 10132, "PowerCapValue": 16663 }, { "Id": 10070, "PowerCapValue": 16663 } ] } Input to edit temperature-triggered policy: { "Id": 3, "Name": "Edited Temp Policy", "Description": "Edited
Table 51. Attributes (continued) Attribute name Description Id ID of the target device or group PowerCapValue Power cap value for the device or group. Table 52. Output Attributes Attribute name Description Id ID of the power policy NOTE: All targets and corresponding power cap must be passed in the payload.
Table 53. Attributes Attribute name Description Ids List of IDs of power policies NOTE: To enable all power policies, provide value for Ids as -1. /api/PowerService/Actions/ PowerService.DisablePolicies This method disables a policy. Supported versions of Power Manager: • • • 1.2 1.1 1.0 POST method for Disabling Policy This method disables power policies. Description Disables power policies.
/api/PowerService/Actions/ PowerService.DeletePolicies This method deletes a policy. Supported versions of Power Manager: • • • 1.2 1.1 1.0 POST method for Deleting Policy This method deletes power policies. Description Deletes power policies. Privilege DEVICE_CONFIGURATION HTTP response codes 200 Example Input: { "Ids": [30,32] } Output: { "Ids": [ 30, 32 ] } Table 55.
8 Emergency Power Reduction Topics: • • • • • /api/PowerService/MonitoredDevices()/EPRStatus /api/PowerService/MonitoredGroups()/EPRStatus /api/PowerService/EPR /api/PowerService/Actions/PowerService.EnableEPR /api/PowerService/Actions/PowerService.DisableEPR /api/PowerService/ MonitoredDevices()/EPRStatus This URI represents the EPR status of the Power Manager monitored devices Supported versions of Power Manager: • • • 1.2 1.1 1.
Table 57. EPR Type Enumeration Enumeration Value Description 1 Power Throttle Down (0 power cap value). 2 Power Off. Table 58. EPR Source Enumeration Enumeration Value Description 1 Manual 2 Temperature-triggered /api/PowerService/ MonitoredGroups()/EPRStatus This URI represents the EPR status of the Power Manager monitored groups Supported versions of Power Manager: • • • 1.2 1.1 1.
Table 60. EPR Type Enumeration (continued) Enumeration Value Description 2 Power Off. Table 61. EPR Source Enumeration Enumeration Value Description 1 Manual 2 Temperature-triggered /api/PowerService/EPR This URI represents the list of Emergency Power Reduction applied on the targets. Supported versions of Power Manager: • • • 1.2 1.1 1.
Table 62. Attributes Attribute Description PolicyId Id of the EPR created. Name Name of the EPR. Description Description of the EPR. Enabled Status of the EPR. AssignedTo Target on which EPR is applied. CreatedTime Time at which EPR is created. IsEprPowerDown True, if EPR type is Power Down. IsAssociatedToGroup True, if EPR is associated to a group. ExecutionState State of the EPR execution. Table 63.
/api/PowerService/Actions/ PowerService.EnableEPR This URI enables you to enable EPR on the target. Supported versions of Power Manager: • • • 1.2 1.1 1.0 POST method to Enable EPR This method enables EPR on the specified target. Description Enables EPR on the specified target Privilege DEVICE_CONFIGURATION HTTP response codes 200 Example Input: { "Target": 10149, "Action": "POWER_THROTTLE" } Output: { "Id": 7 } Table 66.
Privilege DEVICE_CONFIGURATION HTTP response codes 200 Example Input: { "Ids": [6,7] } Output: { "Ids": [6,7] } Table 67. Attributes Attribute Name Description Id EPR Ids to be disabled. NOTE: To disable all the EPRs, provide value for Ids as -1.
9 Unmonitored devices Topics: • • • • • api/PowerService/UserDefinedEntities/Actions/UserDefinedEntities.Create api/PowerService/UserDefinedEntities/Actions/UserDefinedEntities.Update api/PowerService/UserDefinedEntities/Actions/UserDefinedEntities.Delete api/PowerService/UserDefinedEntities/Devices api/PowerService/UserDefinedEntities/Devices() api/PowerService/UserDefinedEntities/Actions/ UserDefinedEntities.
Table 68. Attributes (continued) Attribute Description Size Space occupied by the unmonitored device in a rack. EstimatedMaxPower Maximum power defined for the unmonitored device. Model Model of the unmonitored device. api/PowerService/UserDefinedEntities/Actions/ UserDefinedEntities.Update Use this URI to edit the unmonitored device details. Supported versions of Power Manager: • 1.2 POST method to edit unmonitored device Description Use this method to edit unmonitored device details.
api/PowerService/UserDefinedEntities/Actions/ UserDefinedEntities.Delete Use this URI to delete the unmonitored device details. Supported versions of Power Manager: • 1.2 POST method to delete unmonitored device Description Use this method to delete unmonitored devices that is not supported in OpenManange Enterprise. Privilege DEVICE_CONFIGURATION HTTP response codes 200 Example Input: { "Ids": [6,7] } Output: { "Status": "SUCCESS" } Table 70.
"Id":1, "Name": "Device A", "Description": "Device A", "HostName": "W109GHK890", "Identifier": "CXDFGHJ", "Size": 2, "EstimatedMaxPower": 10000, "Model": "Power Edge", "Location": "DC/Room/Aisle/Rack1", "RackSlot": 10, } ] } Table 71.
HTTP response codes Example 200 Input: None Output: { "Id":10009, "Name": "Device A", "Description": "Device A", "HostName": "W109GHK890", "Identifier": "CXDFGHJ", "Size": 2, "EstimatedMaxPower": 10000, "Model": "Power Edge", "Location": "DC/Room/Aisle/Rack1", "RackSlot": 10, } Unmonitored devices 59
10 Physical Groups Topics: • • • • • • • • • • • • • • • api/GroupService/Actions/GroupService.CreateGroup api/GroupService/Actions/GroupService.UpdateGroup api/GroupService/Actions/GroupService.DeleteGroup /api/PowerService/PhysicalGroups/GroupDetails /api/PowerService/PhysicalGroups/GroupDetails() api/PowerService/PhysicalGroups/GroupDetails/AllLeafgroups api/PowerService/Actions/PowerService.
}, { } } ] } "Value": "1000" "AttributeTypeName": "SPACE_CAPACITY", "IdDataType": 2, "Value": "42" Output: { 10113 } Table 72. Attributes Attribute Description Name Name of the physical group. Description Description of the physical group. MembershipTypeId Define the group type as static. To create a physical group, pass this value as 12. ParentId Id of the parent group. To create a group immediately under physical hierarchy, provide the group id as 1029.
api/GroupService/Actions/ GroupService.UpdateGroup Use this URI to update physical groups. Supported versions of Power Manager: • 1.2 POST method to update physical group Description Updates a physical group.
HTTP response codes Example 204 Input: { "GroupIds": [10166] } Output: None /api/PowerService/PhysicalGroups/GroupDetails Use this URI to get a list of all the physical groups. Supported versions of Power Manager: • 1.2 GET method to list all physical groups Description Displays a list of all the physical groups created. Privilege VIEW HTTP response codes 200 Example Input: None Output: { "@odata.context": "/api/ $metadata#Collection(PhysicalGroup.GroupDetails)", "@odata.
Table 74.
"Id": 11182, "ParentId": 1029, "Name": "DC", "Description": "DC", "AddedOn": "2020-06-15 12:03:59.579174", "DevicesInWorkingSet": 4, "Tag": "DATA_CENTER", "Location": null, "SpaceCapacity": 261, "PowerCapacity": 10000, "CalculatedPowerCapacity": 14100, "SparePowerCapacity": 9269, "SpareSpaceCapacity": 229, "AllLeafgroups@odata.navigationLink": "/api/PowerService/PhysicalGroups/ GroupDetails(11182)/AllLeafgroups", "Devices@odata.
"AllLeafgroups@odata.navigationLink": "/api/PowerService/ PhysicalGroups/GroupDetails(11183)/AllLeafgroups", "Devices@odata.navigationLink": "/api/PowerService/ PhysicalGroups/GroupDetails(11183)/Devices" } ] } Table 75.
Example Input: { { } "Devices": [ { "Id": 10069, "Size": 2, "EstimatedMaxPower": 1000 }, { "Id": 10068, "Size": 2, "EstimatedMaxPower": 10000 } ] Output: { "Status": "SUCCESS" } /api/PowerService/DeviceDetails Use this URI to view the device information such as device size and estimated maximum power. Supported versions of Power Manager: • 1.2 POST method to fetch device details Description Get device details information like device size and estimated max power.
GET method to list all rack placeable devices Description This method returns rack capable devices. Privilege VIEW HTTP response codes 200 Example Input: None Output: { "@odata.context": "/api/ $metadata#Collection(PhysicalGroup.CapableDevices)", "@odata.count": 1, "value": [ { "@odata.type": "#PhysicalGroup.CapableDevices", "@odata.id": "/api/PowerService/PhysicalGroups/ CapableDevices(10204)", "Id": 10204, "Name": "100.96.25.
• • • • • • • Model PowerState ManagedState ConnectionState HealthStatus Size EstimatedMaxPower api/PowerService/PhysicalGroups/ CapableDevices() Use this URI to get the selected device details. Supported versions of Power Manager: • 1.2 GET method for selected device details Description This method returns the selected rack capable devices. Privilege VIEW HTTP response codes 200 Example Input: None Output: { "@odata.context": "/api/$metadata#PhysicalGroup.CapableDevices", "@odata.
Privilege GROUP_MANAGEMENT HTTP response codes 200 Example Input: { "GroupId": 10001, "MemberDevices" : [ { "Id": 10001, "SlotNumber": 1 }, { } ] } "Id": 10002, "SlotNumber": 2 Output: { "Status": "SUCCESS" } NOTE: To add the device automatically in an empty slot, provide the SlotNumber value as zero. api/PowerService/PhysicalGroups/Actions/ PhysicalGroup.RemoveMemberDevices Use this URI to remove device from a physical group at the rack level. Supported versions of Power Manager: • 1.
api/PowerService/PhysicalGroups/ GroupDetails()/Devices Use this URI to get all the devices such as supported and unsupported or either of them under the physical group in a rack. Supported versions of Power Manager: • 1.2 GET method to list all the devices from the physical group Description This method gets all the devices such as supported and unsupported or either of them under the physical group in a rack. Privilege VIEW HTTP response codes 200 Example Input: { "@odata.
Table 77. Filters (continued) Field Operator ConnectionState eq HealthStatus eq Size eq SlotNumber eq EstimatedMaxPower eq List of all the sort options that this method supports: • • • • • • • • • • • • Id Name ServiceTag Type Size Model PowerState ManagedState ConnectionState HealthStatus SlotNumber EstimatedMaxPower api/PowerService/PhysicalGroups/Actions/ PhysicalGroup.UpdateSlots Use this URI to update physical group member rack slots. Supported versions of Power Manager: • 1.
Output: { "Status": "SUCCESS" } api/PowerService/PhysicalGroups/Actions/ PhysicalGroup.MoveDevice Use this URI to move device from a physical group. Supported versions of Power Manager: • 1.2 POST method to move device from one rack to another Description Use this method to move the device from physical group.
11 Report Service Topics: • /api/ReportService/ReportDefs /api/ReportService/ReportDefs This method creates a custom report. Supported versions of Power Manager: • • 1.1 1.0 Post method for creating a custom Power Manager Report > Description Creates a custom report.
}, { "FieldId":99 }, { "FieldId":102 } ], "SortFields":[], "ReportSettings": [{ "SettingId": 1, "OperatorId": 1, "Value": "90" }, { "SettingId": 2, "OperatorId": 1, "Value": "2" }] } } Table 78. SettingId Enumeration Enumeration Value Description 1 Report duration 2 Aggregation period 3 Metric type Table 79. Report duration Enumeration Enumeration Value Description 1 1 Day 7 7 Days 15 15 Days 30 1 Month 90 3 Months 180 6 Months 365 1 Year Table 80.
