Developers Guide

ManualsBrandsDell ManualsActive System ManagerEMC OpenManage Enterprise

Table Of Contents

OpenManage Enterprise Version 3.7 and OpenManage Enterprise - Modular Edition Version 1.30.00 RESTful API Guide
Contents
About this document
Overview
- RESTful application programming interface
- OData
- JSON data
- HTTPS communication
- OpenManage Enterprise – Modular Edition
- OpenManage Enterprise
Key integration concepts
- Base URI
  - OEM scheme
  - Redfish scheme
- Security
- Authentication
- Authorization
- Resource addressing
- Resource operations
- Security considerations
- Performance considerations
- Data filtering
- Data sorting
- Data pagination
- Request headers
- Response codes
- Response headers
Application settings
- Network
- Security and user management
- Security and certificate management
- Monitoring and alert notifications
- api/ApplicationService/SystemResourceUsage
  - GET method for ApplicationService.SystemResourceUsage
Alerts
- Alert logs
- Alert policies
- Alert definitions
Configure
- Firmware
- Template Service
- Identity pools
- Network Configuration Service
Devices
- /api/DeviceService
  - GET method for DeviceService
- /api/DeviceService/Devices
  - GET method for Devices
- /api/DeviceService/Devices?$filter=Type eq 1000
  - GET method for device filter
- /api/DeviceService/Devices(Id)
  - GET method for Devices(Id)
- /api/DeviceService/Devices(Id)/InventoryDetails
  - GET method for InventoryDetails
    - Individual filters
- /api/DeviceService/Devices(Id)/InventoryDetails(InventoryType)
  - GET method for inventory details by inventory type
- /api/DeviceService/Devices(Device_ID)/InventoryDetails('deviceManagement')
  - GET method for device inventory details
- /api/DeviceService/Devices(Id)/Settings('ReplicableChassisConfigurations')
  - PUT method to retrieve chassis time and alert destination settings
- /api/DeviceService/Devices(DEVICE_ID)/Settings('NetworkServices')
  - PUT method for network services settings
- /api/DeviceService/Devices(Device_ID)/Settings('LocalAccessConfiguration')
  - GET method for local access configuration
  - PUT method for local access configuration
- /api/DeviceService/Devices(Id)/HardwareLogs
  - GET method for HardwareLogs
- /api/DeviceService/Devices(Id)/SubSystemHealth
  - GET method for sub system health information
- /api/DeviceService/Devices(Id)/RecentActivity
  - GET method for RecentActivity
- /api/DeviceService/Devices(Id)/InventoryTypes
  - GET method for InventoryTypes
- /api/DeviceService/Devices(Id)/LogSeverities
  - GET method for LogSeverities
- /api/DeviceService/Devices(Id)/Settings
  - GET method for Settings
- /api/DeviceService/Devices(Id)/Settings('Type')
  - GET method for device settings by type
  - PUT method for device settings by type
- /api/DeviceService/Devices(Id)/Temperature
  - GET method for Temperature
- /api/DeviceService/Devices(Id)/BlinkStatus
  - GET method for LED blink status
- /api/DeviceService/Devices(Id)/PowerUsageByDevice
  - GET method for power usage by devices
- /api/DeviceService/Devices(Id)/DeviceBladeSlots
  - GET method for device blade slots
- /api/DeviceService/Devices(Id)/GraphicInfo
  - GET method for GraphicInfo
- /api/DeviceService/Devices(Id)/DeployRequired
  - GET method for deployment by device IDs
- /api/DeviceService/Devices(Id)/SystemUpTime
  - GET method for /api/DeviceService/Devices(Id)/SystemUpTime
- /api/DeviceService/Actions/DeviceService/Devices(Id)Actions/DeviceService.UploadFSDCertificate
  - POST method for uploading FSD certificate
- /api/DeviceService/PowerStates
  - GET method for PowerStates
- /api/DeviceService/DeviceStatuses
  - GET method for DeviceStatuses
- /api/DeviceService/DeviceType
  - GET method for DeviceType
- /api/DeviceService/Actions/DeviceService/Devices(Id)Actions/DeviceService.SetTermState
  - POST method for setting term state
- /api/DeviceService/Actions/DeviceService/Devices(Id)Actions/DeviceService.GetTermState
  - POST method for getting term state
- /api/DeviceService/Actions/DeviceService/Devices(Id)Actions/DeviceService.GetComputeIPs
  - POST method for /api/DeviceService/Actions/DeviceService/Devices(Id)Actions/DeviceService.GetComputeIPs
- /api/DeviceService/DeviceSummary
  - GET method for DeviceSummary
- /api/DeviceService/DeviceSummary(Type)
  - GET method for /api/DeviceService/DeviceSummary(Type)
- api/DeviceService/Actions/DeviceService.DevicesPrivilegesAction
  - POST method for api/DeviceService/Actions/DeviceService.DevicesPrivilegesAction
- /api/DeviceService/Actions/DeviceService.DevicesByPrivilegesAction
  - POST method for device privileges action
- /api/DeviceService/Actions/DeviceService.ExecuteAction
  - POST method /api/DeviceService/Actions/DeviceService.ExecuteAction
- /api/DeviceService/DeviceSlotType
  - GET method for DeviceSlotType
- /api/DeviceService/DeviceSettingsMetadata
  - GET method for DeviceSettingsMetadata
- /api/DeviceService/GlobalExcludes
  - GET method for GlobalExcludes
  - POST method for GlobalExcludes
- /api/DeviceService/Actions/DeviceService.AddNetworkRange
  - POST method for DeviceService.AddNetworkRange
- /api/DeviceService/Actions/DeviceService.EditNetworkRange
  - POST method for DeviceService.EditNetworkRange
- /api/DeviceService/Actions/DeviceService.RemoveFromExclusion
  - POST method for DeviceService.RemoveFromExclusion
- /api/DeviceService/Actions/DeviceService.ValidateExcludes
  - POST method for DeviceService.ValidateExcludes
- /api/DeviceService/Actions/DeviceService.RemoveDevices
  - POST method for DeviceService.RemoveDevices
- DeviceService_/api/ConnectionStateReasons
  - GET method for ConnectionStateReasons
- DeviceService_/api/ConnectionStateReasons(arg1)
  - GET method for ConnectionStateReasons(arg1)
Diagnostic
- /api/DeviceService/Devices(Id)/Actions/DeviceService.Diagnostic
  - POST method for DeviceService.Diagnostic
Groups
- /api/GroupService/Groups
  - GET method for Groups
- /api/GroupService/Groups(Id)
  - GET method for Groups(Id)
  - PUT method for Groups(Id)
  - DELETE method for Groups(Id)
- /api/GroupService/Groups(Id)/Devices
  - GET method for Devices
- /api/GroupService/Groups(Id)/GroupDevicesSummary
  - GET method for GroupDevicesSummary
- /api/GroupService/Groups(group id)/AllLeafDeviceSummaries
  - GET method for AllLeafDeviceSummaries
- /api/GroupService/Groups(group id)/AllLeafDeviceSummaries?$filter=Type eq 4000
  - Get method for AllLeafDeviceSummaries?$filter=Type eq 4000
- /api/GroupService/Groups(group id)/AllLeafDeviceSummaries?$filter=Type eq 4000&$top=25&$skip=0
  - GET method for AllLeafDeviceSummaries?$filter=Type eq 4000&$top=25&$skip=0
- /api/GroupService/Groups(group id)/AllLeafDeviceSummaries?$filter=Type eq 4000&$top=25&$skip=0&$orderby=Identifier asc
  - GET method for AllLeafDeviceSummaries?$filter=Type eq 4000&$top=25&$skip=0&$orderby=Identifier asc
- /api/GroupService/Groups(Id)/SubGroups
  - GET method for SubGroups
- /api/GroupService/Groups(Id)/GroupHierarchy
  - GET method for GroupHierarchy
- /api/GroupService/GroupTypes
  - GET method for GroupTypes
- /api/GroupService/GroupTypes(Id)
  - GET method for GroupTypes(Id)
- /api/GroupService/MembershipTypes
  - GET method for MembershipTypes
- /api/GroupService/MembershipTypes(Id)
  - GET method for MembershipTypes(Id)
- /api/GroupService/AllGroupsHierarchy
  - GET method for AllGroupsHierarchy
- /api/GroupService/Actions/GroupService.AddMemberDevices
  - POST method for GroupService.AddMemberDevices
- /api/GroupService/Actions/GroupService.GroupsPrivilegesAction
  - POST method for GroupService.GroupsPrivilegesAction
- /api/GroupService/Actions/GroupService.GroupsByPrivilegesAction
  - POST method for GroupService.GroupsByPrivilegesAction
- GroupService_/api/Groups/Devices(arg1)
  - GET method for GroupService/Groups/Devices(arg1)
- GroupService_/api/Groups/AllLeaveDevices(arg1)
  - GET method for AllLeafDevice(arg1)
- GroupService_/api/Groups/AllLeafDevicesSummary(arg1)
  - GET method for AllLeafDevicesSummary
Monitor
- Audit logs
  - /api/ApplicationService/AuditLogs
    - GET method for AuditLogs
    - /api/ApplicationService/AuditLogCategories
      - GET method for /api/ApplicationService/AuditLogCategories
  - /api/ApplicationService/AuditLogs(Id)
    - GET method for AuditLogs(Id)
- Jobs
Reset application
- /api/ApplicationService/Actions/ApplicationService.ResetApplication
  - POST method for ResetApplication
- ApplicationService/_api/Actions/ApplicationService.SetSecurityPolicyMessage
  - POST method for SetSecurityPolicyMessage
- ApplicationService/_api/Actions/ApplicationService.GetSecurityPolicyMessage
  - POST method for GetSecurityPolicyMessage
Console version
- /api/ApplicationService/Info
  - GET method for Info
Console capabilities
- /api/ApplicationService/Capabilities
  - GET method for Capabilities
Search
- /api/SearchService/Actions/SearchService.Search
  - POST method for SearchService.Search
Session
- /api/SessionService
  - GET method for SessionService
- /api/SessionService/Sessions
  - GET method for Sessions
  - POST method for Sessions
- /api/SessionService/Sessions(Id)
  - GET method for Sessions(Id)
  - DELETE method for Sessions(Id)
- /api/SessionService/CurrentUser
  - GET method for session details of current user
- /api/SessionService/SessionConfiguration
  - GET method for SessionConfiguration
- /api/SessionService/Actions/SessionService.SessionConfigurationUpdate
  - POST method for SessionService.SessionConfigurationUpdate
- /api/SessionService/Actions/SessionService.Logoff
  - POST method for session service log off
APIs specific to OpenManage Enterprise – Modular Edition
- /api/ApplicationService/Settings
  - GET method for /api/ApplicationService/Settings
  - POST method for /api/ApplicationService/Settings
- /api/ApplicationService/Network/CurrentAddressConfiguration
  - GET method for CurrentAddressConfiguration
- /api/ApplicationService/Network/AddressConfiguration
  - GET method for AddressConfiguration
  - PUT method for AddressConfiguration
- /api/ApplicationService/Actions/ApplicationService.GetConfiguration
  - POST method for ApplicationService.GetConfiguration
- /api/ApplicationService/Actions/ApplicationService.ApplyConfiguration
  - POST method for ApplicationService.ApplyConfiguration
- Brand
  - /api/ApplicationService/Actions/ApplicationService.BrandInfo
    - POST method for BrandInfo
  - /api/ApplicationService/Actions/ApplicationService.ActivateBrand
    - POST method for ActivateBrand
- Multichassis management
- FIPS mode settings
  - /api/ApplicationService/Security/SecurityConfiguration
    - GET method for SecurityConfiguration
- Fabric management
- Port configuration in Fabrics
  - /api/JobService/Jobs
- Storage management
- Quick Deploy
  - /api/JobService/Jobs
    - POST method for Quick-Deploy Jobs
- Server NIC VLAN configuration
- Template Service
APIs specific to OpenManage Enterprise
- Application settings
- Console update
- Mobile
- Console Preferences
- Alerts
- Incoming Alerts
  - https:///api/ApplicationService/Settings
    - POST method for Jobs
- Warranty
  - https:///api/ApplicationService/Settings
    - POST method for Warranty settings
- Network Configuration
- Configuration compliance
- Troubleshoot service
- Query support service
- Groups service
- Profiles
- Devices
- Auto deploy
- Monitor
- Plugin Manager
- Power Metrics
Redfish resource model
- Redfish—ServiceRoot
- Redfish—SessionService
- Redfish—Account Service
- Redfish—Message Registry
- Redfish—Chassis
  - /redfish/v1/Chassis
- Redfish—Systems
- Redfish—CompositionService
- Redfish—EventService
- Redfish—OpenManage Enterprise License Manager
- Redfish—Telemetry
- Managers
- Redfish—OpenID Connect Provider

/api/DeviceService/Devices(Id)/Temperature.......................................................................................................347

GET method for Temperature................................................................................................................................347

/api/DeviceService/Devices(Id)/BlinkStatus..........................................................................................................347

GET method for LED blink status..........................................................................................................................347

/api/DeviceService/Devices(Id)/PowerUsageByDevice......................................................................................348

GET method for power usage by devices...........................................................................................................348

/api/DeviceService/Devices(Id)/DeviceBladeSlots.............................................................................................. 348

GET method for device blade slots...................................................................................................................... 348

/api/DeviceService/Devices(Id)/GraphicInfo.........................................................................................................349

GET method for GraphicInfo..................................................................................................................................349

/api/DeviceService/Devices(Id)/DeployRequired................................................................................................. 350

GET method for deployment by device IDs........................................................................................................350

/api/DeviceService/Devices(Id)/SystemUpTime.................................................................................................. 350

GET method for /api/DeviceService/Devices(Id)/SystemUpTime.............................................................350

/api/DeviceService/Actions/DeviceService/Devices(Id)Actions/

DeviceService.UploadFSDCertificate..................................................................................................................... 351

POST method for uploading FSD certificate...................................................................................................... 351

/api/DeviceService/PowerStates...............................................................................................................................351

GET method for PowerStates................................................................................................................................ 351

/api/DeviceService/DeviceStatuses......................................................................................................................... 352

GET method for DeviceStatuses...........................................................................................................................352

/api/DeviceService/DeviceType................................................................................................................................ 353

GET method for DeviceType..................................................................................................................................353

/api/DeviceService/Actions/DeviceService/Devices(Id)Actions/DeviceService.SetTermState..............354

POST method for setting term state...................................................................................................................354

/api/DeviceService/Actions/DeviceService/Devices(Id)Actions/DeviceService.GetTermState............. 354

POST method for getting term state...................................................................................................................354

/api/DeviceService/Actions/DeviceService/Devices(Id)Actions/DeviceService.GetComputeIPs.......... 355

POST method for /api/DeviceService/Actions/DeviceService/Devices(Id)Actions/

DeviceService.GetComputeIPs......................................................................................................................... 355

/api/DeviceService/DeviceSummary........................................................................................................................ 355

GET method for DeviceSummary......................................................................................................................... 355

/api/DeviceService/DeviceSummary(Type)........................................................................................................... 358

GET method for /api/DeviceService/DeviceSummary(Type)...................................................................... 358

api/DeviceService/Actions/DeviceService.DevicesPrivilegesAction................................................................ 359

POST method for api/DeviceService/Actions/DeviceService.DevicesPrivilegesAction........................ 359

/api/DeviceService/Actions/DeviceService.DevicesByPrivilegesAction......................................................... 359

POST method for device privileges action......................................................................................................... 359

/api/DeviceService/Actions/DeviceService.ExecuteAction............................................................................... 360

POST method /api/DeviceService/Actions/DeviceService.ExecuteAction..............................................360

/api/DeviceService/DeviceSlotType.........................................................................................................................360

GET method for DeviceSlotType.......................................................................................................................... 360

/api/DeviceService/DeviceSettingsMetadata.........................................................................................................361

GET method for DeviceSettingsMetadata.......................................................................................................... 361

/api/DeviceService/GlobalExcludes.......................................................................................................................... 364

GET method for GlobalExcludes........................................................................................................................... 364

POST method for GlobalExcludes.........................................................................................................................365

/api/DeviceService/Actions/DeviceService.AddNetworkRange....................................................................... 365

POST method for DeviceService.AddNetworkRange......................................................................................365

/api/DeviceService/Actions/DeviceService.EditNetworkRange....................................................................... 366

Contents