Dell EMC OpenManage Enterprise Reference guide

Type
Reference guide
OpenManage Enterprise Version 3.5 and
OpenManage Enterprise - Modular Edition
Version 1.20.10
RESTful API Guide
December 2020
Rev. A01
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.
© 2018 -2020 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
Other trademarks may be trademarks of their respective owners.
Chapter 1: About this document................................................................................................... 17
Chapter 2: Overview.................................................................................................................... 19
RESTful application programming interface................................................................................................................19
OData.................................................................................................................................................................................... 19
JSON data........................................................................................................................................................................... 19
HTTPS communication..................................................................................................................................................... 19
OpenManage Enterprise Modular Edition................................................................................................................20
OpenManage Enterprise..................................................................................................................................................20
Chapter 3: Key integration concepts............................................................................................ 21
Base URI...............................................................................................................................................................................21
OEM scheme................................................................................................................................................................. 21
Redfish scheme............................................................................................................................................................23
Security................................................................................................................................................................................23
Authentication....................................................................................................................................................................24
Authorization...................................................................................................................................................................... 24
Resource addressing.........................................................................................................................................................27
Resource operations......................................................................................................................................................... 27
Security considerations....................................................................................................................................................28
Performance considerations ..........................................................................................................................................28
Data filtering.......................................................................................................................................................................28
Data sorting........................................................................................................................................................................ 28
Data pagination..................................................................................................................................................................29
Request headers................................................................................................................................................................29
Response codes.................................................................................................................................................................29
Response headers............................................................................................................................................................. 30
Chapter 4: Application settings................................................................................................... 32
Network............................................................................................................................................................................... 32
/api/ApplicationService/Network...........................................................................................................................32
/api/ApplicationService/Network/WebServerConfiguration.......................................................................... 33
/api/ApplicationService/Network/TimeConfiguration...................................................................................... 34
/api/ApplicationService/Network/TimeZones.................................................................................................... 35
/api/ApplicationService/Network/ProxyConfiguration.................................................................................... 36
Security and user management......................................................................................................................................37
/api/AccountService.................................................................................................................................................. 37
/api/AccountService/Accounts.............................................................................................................................. 40
/api/AccountService/Accounts(Id)....................................................................................................................... 42
/api/AccountService/Accounts(userId)/Permissions....................................................................................... 44
/api/AccountService/Actions/AccountService.GetPrivileges........................................................................ 45
/api/AccountService/Actions/AccountService.GetPrivilegesForUser......................................................... 45
/api/AccountService/Actions/AccountService.GetUserDetail.......................................................................46
/api/AccountService/Actions/AccountService.Enable.....................................................................................46
Contents
Contents 3
/api/AccountService/Actions/AccountService.Disable.................................................................................... 47
/api/AccountService/Actions/AccountService.Delete..................................................................................... 47
/api/AccountService/Roles......................................................................................................................................48
/api/AccountService/Roles(Id)...............................................................................................................................49
/api/AccountService/ExternalAccountProvider................................................................................................. 50
/api/AccountService/ExternalAccountProvider/DirectoryServiceType....................................................... 51
/api/AccountService/ExternalAccountProvider/ADAccountProvider...........................................................51
/api/AccountService/ExternalAccountProvider/ADAccountProvider(Id)................................................... 53
/api/AccountService/ExternalAccountProvider/Actions/
ExternalAccountProvider.TestADConnection.................................................................................................. 55
/api/AccountService/ExternalAccountProvider/LDAPAccountProvider..................................................... 57
/api/AccountService/ExternalAccountProvider/LDAPAccountProvider(Id).............................................. 59
/api/AccountService/ExternalAccountProvider/Actions/
ExternalAccountProvider.TestLDAPConnection.............................................................................................. 61
/api/AccountService/ExternalAccountProvider/Actions/ExternalAccountProvider.SearchGroups.....63
/api/AccountService/ExternalAccountProvider/Actions/
ExternalAccountProvider.DeleteExternalAccountProvider...........................................................................64
/api/AccountService/Actions/AccountService.ImportExternalAccountProvider...................................... 64
/api/AccountService/ExternalAccountProvider/OpenIDConnectProvider................................................. 66
/api/AccountService/ExternalAccountProvider/OpenIDConnectProvider('OIDCProviderID').............. 66
/api/AccountService/ExternalAccountProvider/Actions/
ExternalAccountProvider.EnableOIDCProviders..............................................................................................67
/api/AccountService/ExternalAccountProvider/Actions/
ExternalAccountProvider.DisableOIDCProviders............................................................................................ 68
/api/AccountService/ExternalAccountProvider/Actions/
ExternalAccountProvider.DeleteOIDCProviders..............................................................................................68
/api/AccountService/ExternalAccountProvider/Actions/
ExternalAccountProvider.TestOIDCProvider................................................................................................... 69
/api/AccountService/ExternalAccountProvider/Actions/
ExternalAccountProvider.TestOIDCProviderRegistrationStatus.................................................................69
Security and certificate management.......................................................................................................................... 70
/api/ApplicationService/Security............................................................................................................................70
/api/ApplicationService/Security/SecurityConfiguration.................................................................................70
/api/ApplicationService/Certificate........................................................................................................................71
/api/ApplicationService/Actions/ApplicationService.GenerateCSR..............................................................72
/api/ApplicationService/Actions/ApplicationService.UploadCertificate.......................................................73
/api/AccountService/ExternalAccountProvider/Actions/ExternalAccountProvider.DSCertificate...... 73
Monitoring and alert notifications................................................................................................................................. 74
api/AlertService/AlertDestinations/SNMPConfiguration................................................................................. 74
api/AlertService/AlertDestinations/Actions/AlertDestinations.ApplySNMPConfig...................................75
/api/AlertService/AlertDestinations/SyslogConfiguration............................................................................... 77
api/AlertService/AlertDestinations/Actions/AlertDestinations.ApplySyslogConfig...................................78
/api/AlertService/AlertDestinations/SMTPConfiguration................................................................................79
/api/AlertService/AlertDestinations/Actions/AlertDestinations.SendTestTrap.........................................80
Chapter 5: Alerts.........................................................................................................................82
Alert logs..............................................................................................................................................................................82
/api/AlertService/Alerts............................................................................................................................................82
/api/AlertService/Alerts?$filter=contains(UserName,'admin')...................................................................... 84
/api/AlertService/Alerts?$filter=StatusType eq 2000..................................................................................... 84
/api/AlertService/Alerts?$filter=StatusType eq 1000......................................................................................88
4
Contents
/api/AlertService/Alerts?$filter=StatusType eq 1............................................................................................. 92
/api/AlertService/Alerts(Id).....................................................................................................................................93
/api/AlertService/AlertCategories......................................................................................................................... 94
/api/AlertService/AlertCategories('Name')....................................................................................................... 122
/api/AlertService/AlertSeverities..........................................................................................................................123
/api/AlertService/AlertSeverities(Id)...................................................................................................................124
/api/AlertService/AlertStatuses............................................................................................................................124
/api/AlertService/AlertStatuses(Id).....................................................................................................................125
/api/AlertService/AlertCatalogs............................................................................................................................125
/api/AlertService/AlertCatalogs(Id).....................................................................................................................127
/api/AlertService/Events........................................................................................................................................ 127
/api/AlertService/Actions/AlertService.Acknowledge.................................................................................... 128
/api/AlertService/Actions/AlertService.Unacknowledge............................................................................... 129
/api/AlertService/Actions/AlertService.RemoveAlerts...................................................................................130
Alert policies.......................................................................................................................................................................131
/api/AlertService/AlertPolicies...............................................................................................................................131
/api/AlertService/AlertPolicies(Id).......................................................................................................................136
/api/AlertService/AlertPolicies(Arg1)/PolicyCriteria....................................................................................... 142
/api/AlertService/AlertPolicies(Arg1)/PolicyCriteria(Arg2)...........................................................................143
/api/AlertService/AlertPolicies(Arg1)/PolicyActions....................................................................................... 144
/api/AlertService/AlertPolicies(Arg1)/PolicyActions(Arg2)...........................................................................145
/api/AlertService/AlertActionTemplates.............................................................................................................146
/api/AlertService/AlertActionTemplates(Id)...................................................................................................... 147
/api/AlertService/Actions/AlertService.EnableAlertPolicies......................................................................... 148
/api/AlertService/Actions/AlertService.DisableAlertPolicies.........................................................................148
/api/AlertService/Actions/AlertService.RemoveAlertPolicies.......................................................................148
Alert definitions................................................................................................................................................................ 149
/api/AlertService/AlertMessageDefinitions........................................................................................................149
/api/AlertService/AlertMessageDefinitions(Id).................................................................................................150
/api/AlertService/AlertMessageDefinitionsCategories.................................................................................... 151
/api/AlertService/AlertMessageDefinitionsCategories('Name')................................................................... 152
Chapter 6: Configure................................................................................................................. 155
Firmware............................................................................................................................................................................ 155
/api/UpdateService/Catalogs................................................................................................................................155
/api/UpdateService/Catalogs(Id).........................................................................................................................158
/api/UpdateService/Baselines...............................................................................................................................159
api/UpdateService/Baselines(Id).......................................................................................................................... 166
/api/UpdateService/Actions/UpdateService.GetBaselinesForDevices...................................................... 168
api/UpdateService/FirmwareBaselineSummary................................................................................................ 168
/api/UpdateService/Actions/UpdateService.CheckBaselinesAssociation................................................. 169
/api/UpdateService/ComplianceStatuses.......................................................................................................... 169
/api/UpdateService/Baselines(Id)/DeviceComplianceReports..................................................................... 170
/api/UpdateService/Baselines(Id)/DeviceComplianceReports(Id).............................................................. 172
/api/UpdateService/Baselines(Id)/DeviceComplianceReports(Id)/ComponentComplianceReports.. 174
/api/UpdateService/Baselines(Id)/DeviceComplianceReports(Id)/
ComponentComplianceReports(Id)...................................................................................................................175
/api/UpdateService/Actions/UpdateService.UploadFile................................................................................ 175
/api/UpdateService/Actions/UpdateService.RemoveFile.............................................................................. 176
/api/UpdateService/Actions/UpdateService.RefreshCatalogs.....................................................................176
Contents
5
/api/UpdateService/Actions/UpdateService.RemoveCatalogs.................................................................... 177
/api/UpdateService/Actions/UpdateService.RemoveBaselines................................................................... 177
/api/UpdateService/RollbackSoftwares..............................................................................................................177
/api/UpdateService/Actions/UpdateService.GetSingleDupDetails..............................................................178
/api/UpdateService/Actions/UpdateService.GetSingleDupReport............................................................. 179
/api/UpdateService/Actions/UpdateService.GetBaselinesReportByDeviceids........................................180
/api/UpdateService/Actions/UpdateService.GetCertDetails........................................................................183
Template Service............................................................................................................................................................. 183
/api/TemplateService/TemplateTypes................................................................................................................183
/api/TemplateService/TemplateViewTypes.......................................................................................................184
/api/TemplateService/Templates......................................................................................................................... 185
/api/TemplateService/Templates(Id).................................................................................................................. 190
api/TemplateService/Templates(26)................................................................................................................... 192
/api/TemplateService/Templates(Id)/Views.....................................................................................................195
/api/TemplateService/Templates(Id)/Views(Id)..............................................................................................196
/api/TemplateService/Templates(Id)/Views(Id)/AttributeViewDetails..................................................... 196
/api/TemplateService/Templates(Id)/Views(Id)/AttributeViewDetails/TemplateEditInfoDetails.......199
/api/TemplateService/Templates(Id)/Views(Id)/DeviceAttributeViewDetails(Id).................................. 201
/api/TemplateService/Templates(26)/Views(9)/DeviceAttributeViewDetails(10176)..........................206
/api/TemplateService/Actions/TemplateService.AssignIdentities.............................................................. 207
/api/TemplateService/Actions/TemplateService.GetAssignedIdentities.................................................. 208
/api/TemplateService/Actions/TemplateService.FreeReservedIdentities.................................................210
/api/TemplateService/Actions/TemplateService.Clone................................................................................. 210
/api/TemplateService/Actions/TemplateService.Export............................................................................... 210
/api/TemplateService/Actions/TemplateService.Import................................................................................ 211
/api/TemplateService/Actions/TemplateService.Deploy............................................................................... 213
/api/TemplateService/Actions/TemplateService.UpdateNetworkConfig..................................................216
/api/TemplateService/Actions/TemplateService.RemoveBaseline..............................................................217
/api/TemplateService/Actions/TemplateService.Remediate ....................................................................... 217
Identity pools.....................................................................................................................................................................217
/api/IdentityPoolService/IdentityPools............................................................................................................... 217
/api/IdentityPoolService/IdentityPools(Id)........................................................................................................ 221
/api/IdentityPoolService/IdentityPools(Id)/UsageCounts.............................................................................223
/api/IdentityPoolService/IdentityPools(Id)/UsageIdentitySets................................................................... 224
/api/IdentityPoolService/IdentityPoolsI(Id)/UsageIdentitySets(Id)........................................................... 225
/api/IdentityPoolService/IdentityPools(Id)/UsageIdentitySets(Id)/Details..............................................226
/api/IdentityPoolService/IdentityStates.............................................................................................................227
/api/IdentityPoolService/IdentityStates(Id)......................................................................................................227
/api/IdentityPoolService/Actions/IdentityPoolService.DeleteIdentityPools............................................. 228
Network Configuration Service................................................................................................................................... 228
/api/NetworkConfigurationService/Networks..................................................................................................228
/api/NetworkConfigurationService/Networks(Id)........................................................................................... 231
/api/NetworkConfigurationService/NetworkTypes........................................................................................ 232
/api/NetworkConfigurationService/NetworkTypes(Id)..................................................................................233
/api/NetworkConfigurationService/QosTypes................................................................................................. 234
/api/NetworkConfigurationService/QosTypes(Id).......................................................................................... 234
/api/NetworkConfigurationService/Actions/NetworkConfigurationService.RemoveNetworks..........235
api/NetworkConfigurationService/Actions/NetworkConfigurationService.ImportVLANDefinitions.. 235
api/NetworkConfigurationService/Actions/NetworkConfigurationService.ExportVLANDefinitions.. 236
6
Contents
api/NetworkConfigurationService/Actions/
NetworkConfigurationService.ValidateNetworkDefinitionFile................................................................... 237
Chapter 7: Devices.................................................................................................................... 238
/api/DeviceService........................................................................................................................................................ 239
GET method for DeviceService............................................................................................................................. 239
/api/DeviceService/Devices........................................................................................................................................239
GET method for Devices......................................................................................................................................... 239
/api/DeviceService/Devices?$filter=Type eq 1000............................................................................................... 241
GET method for device filter.................................................................................................................................. 241
/api/DeviceService/Devices(Id).................................................................................................................................247
GET method for Devices(Id).................................................................................................................................. 247
/api/DeviceService/Devices(Id)/InventoryDetails................................................................................................ 248
GET method for InventoryDetails......................................................................................................................... 248
/api/DeviceService/Devices(Id)/InventoryDetails(InventoryType)..................................................................259
GET method for inventory details by inventory type.......................................................................................259
/api/DeviceService/Devices(Id)/Settings('ReplicableChassisConfigurations')............................................. 260
PUT method to retrieve chassis time and alert destination settings...........................................................260
/api/DeviceService/Devices(Device_ID)/Settings('LocalAccessConfiguration').......................................... 261
GET method for local access configuration........................................................................................................ 261
/api/DeviceService/Devices(Id)/HardwareLogs....................................................................................................263
GET method for HardwareLogs.............................................................................................................................263
/api/DeviceService/Devices(Id)/SubSystemHealth............................................................................................. 264
GET method for sub system health information............................................................................................... 264
/api/DeviceService/Devices(Id)/RecentActivity...................................................................................................265
GET method for RecentActivity............................................................................................................................265
/api/DeviceService/Devices(Id)/InventoryTypes..................................................................................................266
GET method for InventoryTypes...........................................................................................................................266
/api/DeviceService/Devices(Id)/LogSeverities..................................................................................................... 266
GET method for LogSeverities.............................................................................................................................. 266
/api/DeviceService/Devices(Id)/Settings............................................................................................................... 267
GET method for Settings........................................................................................................................................ 267
/api/DeviceService/Devices(Id)/Settings('Type')................................................................................................ 267
GET method for device settings by type............................................................................................................ 268
PUT method for device settings by type............................................................................................................ 269
/api/DeviceService/Devices(Id)/Temperature........................................................................................................271
GET method for Temperature.................................................................................................................................271
/api/DeviceService/Devices(Id)/BlinkStatus..........................................................................................................272
GET method for LED blink status..........................................................................................................................272
/api/DeviceService/Devices(Id)/PowerUsageByDevice......................................................................................272
GET method for power usage by devices........................................................................................................... 272
/api/DeviceService/Devices(Id)/DeviceBladeSlots...............................................................................................273
GET method for device blade slots.......................................................................................................................273
/api/DeviceService/Devices(Id)/GraphicInfo......................................................................................................... 274
GET method for GraphicInfo.................................................................................................................................. 274
/api/DeviceService/Devices(Id)/DeployRequired................................................................................................. 275
GET method for deployment by device IDs........................................................................................................ 275
/api/DeviceService/Devices(Id)/SystemUpTime.................................................................................................. 275
GET method for /api/DeviceService/Devices(Id)/SystemUpTime............................................................. 275
/api/DeviceService/Actions/DeviceService/Devices(Id)Actions/DeviceService.UploadFSDCertificate276
Contents
7
POST method for uploading FSD certificate......................................................................................................276
/api/DeviceService/PowerStates.............................................................................................................................. 276
GET method for PowerStates................................................................................................................................276
/api/DeviceService/DeviceStatuses..........................................................................................................................277
GET method for DeviceStatuses........................................................................................................................... 277
/api/DeviceService/DeviceType.................................................................................................................................277
GET method for DeviceType.................................................................................................................................. 277
/api/DeviceService/Actions/DeviceService/Devices(Id)Actions/DeviceService.SetTermState.............. 278
POST method for setting term state................................................................................................................... 278
/api/DeviceService/Actions/DeviceService/Devices(Id)Actions/DeviceService.GetTermState..............279
POST method for getting term state...................................................................................................................279
/api/DeviceService/Actions/DeviceService/Devices(Id)Actions/DeviceService.GetComputeIPs...........279
POST method for /api/DeviceService/Actions/DeviceService/Devices(Id)Actions/
DeviceService.GetComputeIPs..........................................................................................................................279
/api/DeviceService/DeviceSummary........................................................................................................................ 279
GET method for DeviceSummary..........................................................................................................................279
/api/DeviceService/DeviceSummary(Type)............................................................................................................282
GET method for /api/DeviceService/DeviceSummary(Type)...................................................................... 282
api/DeviceService/Actions/DeviceService.DevicesPrivilegesAction................................................................ 283
POST method for api/DeviceService/Actions/DeviceService.DevicesPrivilegesAction........................ 283
/api/DeviceService/Actions/DeviceService.DevicesByPrivilegesAction......................................................... 283
POST method for device privileges action......................................................................................................... 283
/api/DeviceService/Actions/DeviceService.ExecuteAction............................................................................... 284
POST method /api/DeviceService/Actions/DeviceService.ExecuteAction..............................................284
/api/DeviceService/DeviceSlotType......................................................................................................................... 284
GET method for DeviceSlotType.......................................................................................................................... 284
/api/DeviceService/DeviceSettingsMetadata........................................................................................................ 285
GET method for DeviceSettingsMetadata......................................................................................................... 285
/api/DeviceService/GlobalExcludes.......................................................................................................................... 288
GET method for GlobalExcludes............................................................................................................................288
POST method for GlobalExcludes.........................................................................................................................289
/api/DeviceService/Actions/DeviceService.AddNetworkRange....................................................................... 290
POST method for DeviceService.AddNetworkRange......................................................................................290
/api/DeviceService/Actions/DeviceService.EditNetworkRange....................................................................... 290
POST method for DeviceService.EditNetworkRange......................................................................................290
/api/DeviceService/Actions/DeviceService.RemoveFromExclusion.................................................................291
POST method for DeviceService.RemoveFromExclusion................................................................................291
/api/DeviceService/Actions/DeviceService.ValidateExcludes............................................................................291
POST method for DeviceService.ValidateExcludes.......................................................................................... 291
/api/DeviceService/Actions/DeviceService.RemoveDevices.............................................................................292
POST method for DeviceService.RemoveDevices........................................................................................... 292
Chapter 8: Diagnostic................................................................................................................293
/api/DeviceService/Devices(Id)/Actions/DeviceService.Diagnostic............................................................... 293
POST method for DeviceService.Diagnostic......................................................................................................293
Chapter 9: Groups..................................................................................................................... 294
/api/GroupService/Groups..........................................................................................................................................294
GET method for Groups.......................................................................................................................................... 294
/api/GroupService/Groups(Id)...................................................................................................................................296
8
Contents
GET method for Groups(Id)................................................................................................................................... 296
PUT method for Groups(Id)................................................................................................................................... 298
DELETE method for Groups(Id)............................................................................................................................299
/api/GroupService/Groups(Id)/Devices.................................................................................................................. 299
GET method for Devices.........................................................................................................................................299
/api/GroupService/Groups(Id)/GroupDevicesSummary...................................................................................... 301
GET method for GroupDevicesSummary.............................................................................................................301
/api/GroupService/Groups(group id)/AllLeafDeviceSummaries....................................................................... 302
GET method for AllLeafDeviceSummaries..........................................................................................................302
/api/GroupService/Groups(group id)/AllLeafDeviceSummaries?$filter=Type eq 4000.............................. 321
Get method for AllLeafDeviceSummaries?$filter=Type eq 4000 .................................................................321
/api/GroupService/Groups(group id)/AllLeafDeviceSummaries?$filter=Type eq 4000&$top=25&
$skip=0 .........................................................................................................................................................................324
GET method for AllLeafDeviceSummaries?$filter=Type eq 4000&$top=25&$skip=0.......................... 324
/api/GroupService/Groups(group id)/AllLeafDeviceSummaries?$filter=Type eq 4000&$top=25&
$skip=0&$orderby=Identifier asc...........................................................................................................................328
GET method for AllLeafDeviceSummaries?$filter=Type eq 4000&$top=25&$skip=0&
$orderby=Identifier asc....................................................................................................................................... 328
/api/GroupService/Groups(Id)/SubGroups............................................................................................................. 331
GET method for SubGroups....................................................................................................................................331
/api/GroupService/Groups(Id)/GroupHierarchy................................................................................................... 333
GET method for GroupHierarchy.......................................................................................................................... 333
/api/GroupService/GroupTypes.................................................................................................................................334
GET method for GroupTypes.................................................................................................................................334
/api/GroupService/GroupTypes(Id)..........................................................................................................................335
GET method for GroupTypes(Id)..........................................................................................................................335
/api/GroupService/MembershipTypes..................................................................................................................... 335
GET method for MembershipTypes..................................................................................................................... 335
/api/GroupService/MembershipTypes(Id).............................................................................................................. 336
GET method for MembershipTypes(Id)...............................................................................................................336
/api/GroupService/AllGroupsHierarchy....................................................................................................................337
GET method for AllGroupsHierarchy.................................................................................................................... 337
/api/GroupService/Actions/GroupService.AddMemberDevices........................................................................337
POST method for GroupService.AddMemberDevices..................................................................................... 337
/api/GroupService/Actions/GroupService.GroupsPrivilegesAction..................................................................338
POST method for GroupService.GroupsPrivilegesAction............................................................................... 338
/api/GroupService/Actions/GroupService.GroupsByPrivilegesAction.............................................................338
POST method for GroupService.GroupsByPrivilegesAction.......................................................................... 338
Chapter 10: Monitor.................................................................................................................. 340
Audit logs.......................................................................................................................................................................... 340
/api/ApplicationService/AuditLogs......................................................................................................................340
/api/ApplicationService/AuditLogs(Id)................................................................................................................341
Jobs.................................................................................................................................................................................... 342
/api/JobService/Jobs............................................................................................................................................. 342
/api/JobService/Jobs(Id).......................................................................................................................................370
/api/JobService/JobStatuses............................................................................................................................... 373
/api/JobService/JobStatuses(Id)........................................................................................................................ 375
/api/JobService/JobTypes.................................................................................................................................... 375
/api/JobService/JobTypes(Id)..............................................................................................................................377
Contents
9
/api/JobService/Jobs(Id)/ExecutionHistories..................................................................................................378
/api/JobService/Jobs(Id)/ExecutionHistories(Id)...........................................................................................380
/api/JobService/Actions/JobService.EnableJobs............................................................................................381
/api/JobService/Actions/JobService.DisableJobs.......................................................................................... 382
/api/JobService/Actions/JobService.RemoveJobs........................................................................................ 383
/api/JobService/Actions/JobService.Schedule............................................................................................... 384
/api/JobService/Actions/JobService.RunJobs................................................................................................ 384
/api/JobService/Actions/JobService.StopJobs...............................................................................................385
/api/JobService/Actions/JobService.Resume................................................................................................. 388
/api/JobService/Actions/JobService.ExecuteAction..................................................................................... 388
Chapter 11: Reset application.................................................................................................... 390
/api/ApplicationService/Actions/ApplicationService.ResetApplication........................................................... 390
POST method for ResetApplication..................................................................................................................... 390
Chapter 12: Console version....................................................................................................... 391
/api/ApplicationService/Info........................................................................................................................................391
GET method for Info................................................................................................................................................. 391
Chapter 13: Console capabilities................................................................................................ 392
/api/ApplicationService/Capabilities......................................................................................................................... 392
GET method for Capabilities.................................................................................................................................. 392
Chapter 14: Search.................................................................................................................... 394
/api/SearchService/Actions/SearchService.Search.............................................................................................394
POST method for SearchService.Search............................................................................................................394
Chapter 15: Session...................................................................................................................396
/api/SessionService.......................................................................................................................................................396
GET method for SessionService........................................................................................................................... 396
/api/SessionService/Sessions.....................................................................................................................................397
GET method for Sessions........................................................................................................................................397
POST method for Sessions.....................................................................................................................................398
/api/SessionService/Sessions(Id)..............................................................................................................................399
GET method for Sessions(Id)................................................................................................................................ 399
DELETE method for Sessions(Id)......................................................................................................................... 399
/api/SessionService/SessionConfiguration.............................................................................................................400
GET method for SessionConfiguration................................................................................................................400
/api/SessionService/Actions/SessionService.SessionConfigurationUpdate...................................................401
POST method for SessionService.SessionConfigurationUpdate................................................................... 401
/api/SessionService/Actions/SessionService.Logoff...........................................................................................402
POST method for session service log off........................................................................................................... 402
Chapter 16: APIs specific to OpenManage Enterprise Modular Edition.................................... 403
/api/ApplicationService/Settings...............................................................................................................................403
GET method for /api/ApplicationService/Settings..........................................................................................403
/api/ApplicationService/Network/CurrentAddressConfiguration..................................................................... 404
GET method for CurrentAddressConfiguration.................................................................................................404
/api/ApplicationService/Network/AddressConfiguration................................................................................... 405
10
Contents
GET method for AddressConfiguration............................................................................................................... 406
PUT method for AddressConfiguration............................................................................................................... 406
/api/ApplicationService/Actions/ApplicationService.GetConfiguration.......................................................... 409
POST method for ApplicationService.GetConfiguration.................................................................................409
/api/ApplicationService/Actions/ApplicationService.ApplyConfiguration........................................................419
POST method for ApplicationService.ApplyConfiguration.............................................................................. 419
Brand..................................................................................................................................................................................429
/api/ApplicationService/Actions/ApplicationService.BrandInfo...................................................................429
/api/ApplicationService/Actions/ApplicationService.ActivateBrand.......................................................... 429
Multichassis management.............................................................................................................................................430
/api/ManagementDomainService......................................................................................................................... 430
/api/ManagementDomainService/DiscoveredDomains.................................................................................. 435
/api/ManagementDomainService/ConfigurationTypes...................................................................................437
/api/ManagementDomainService/ConfigurationTypes(Id)........................................................................... 439
/api/ManagementDomainService/Domains.......................................................................................................439
/api/ManagementDomainService/Domains(Id)................................................................................................ 443
/api/ManagementDomainService/PendingDomains........................................................................................ 444
/api/ManagementDomainService/PendingDomains(Id)................................................................................. 445
/api/ManagementDomainService/Actions/ManagementDomainService.Domains..................................446
/api/ManagementDomainService/Actions/ManagementDomainService.Join.......................................... 447
/api/ManagementDomainService/Actions/ManagementDomainService.Leave...................................... 448
/api/ManagementDomainService/Actions/ManagementDomainService.Delete..................................... 448
/api/ManagementDomainService/Actions/ManagementDomainService.DeleteGroup.......................... 449
/api/ManagementDomainService/GetSyncFailureAlertTimeoutValues......................................................450
/api/ManagementDomainService/Actions/ManagementDomainService.ApproveJoin.......................... 450
/api/ManagementDomainService/Actions/ManagementDomainService.AssignBackupLead............... 451
/api/ManagementDomainService/Actions/ManagementDomainService.ReassignBackupLead.......... 452
/api/ManagementDomainService/Actions/ManagementDomainService.UnassignBackupLead..........453
/api/ManagementDomainService/Actions/ManagementDomainService.PromoteBackupLead...........453
/api/ManagementDomainService/Actions/ManagementDomainService.RetireLead............................. 454
FIPS mode settings........................................................................................................................................................ 455
/api/ApplicationService/Security/SecurityConfiguration.............................................................................. 455
Fabric management........................................................................................................................................................455
/api/NetworkService...............................................................................................................................................455
/api/NetworkService/Fabrics............................................................................................................................... 456
/api/NetworkService/FabricDesigns...................................................................................................................459
/api/NetworkService/Fabrics(Id)......................................................................................................................... 461
/api/NetworkService/Fabrics(Id)/FabricDesigns............................................................................................ 463
/api/NetworkService/Fabrics(Id)/ValidationErrors.........................................................................................464
/api/NetworkService/Fabrics(Id)/Uplinks......................................................................................................... 467
/api/NetworkService/Fabrics(Id)/Uplinks(Id).................................................................................................. 468
/api/NetworkService/Fabrics(Id)/Uplinks(Id)/Ports.......................................................................................471
/api/NetworkService/Fabrics(Id)/Uplinks(Id)/Networks.............................................................................. 473
/api/NetworkService/Fabrics('Id')/NetworkService.GetApplicableUplinkNetworks.............................. 474
api/NetworkService/Fabrics(arg1)/NetworkService.GetApplicableUplinkUntaggedNetworks............ 474
api/NetworkService/Fabrics(arg1)/Servers...................................................................................................... 475
/api/NetworkService/Fabrics(Id)/NetworkService.GetApplicableUplinkPorts........................................ 479
api/NetworkService/Actions/NetworkService.UpdateServerUntaggedVLAN..........................................481
/api/NetworkService/Fabrics(Id)/Switches..................................................................................................... 482
/api/NetworkService/Fabrics(arg1)/Actions/NetworkService.ReplaceSwitch....................................... 483
Contents
11
/api/NetworkService/Fabrics(Id)/Servers........................................................................................................ 484
/api/NetworkService/Fabrics(Id)/Topology..................................................................................................... 487
/api/NetworkService/Fabrics(Id)/Topology/Nodes....................................................................................... 487
/api/NetworkService/Fabrics(Id)/Topology/Nodes(Id)................................................................................ 488
/api/NetworkService/Actions/NetworkService.RemoveFabrics.................................................................490
/api/NetworkService/Actions/NetworkService.RemoveUplinks.................................................................490
/api/NetworkService/FabricDesigns(Id)/NetworkService.GetApplicableNodes..................................... 492
/api/NetworkService/UplinkTypes...................................................................................................................... 493
/api/NetworkService/NodeTypes........................................................................................................................493
/api/NetworkService/FabricActivityTypes........................................................................................................ 494
/api/NetworkService/FabricActivityStatuses...................................................................................................495
/api/NetworkService/FabricHealthStatuses.....................................................................................................496
/api/NetworkService/MultiChassisDomain........................................................................................................497
/api/NetworkService/MultiChassisDomain/Topology.................................................................................... 497
/api/NetworkService/MultiChassisDomain/Topology/Nodes...................................................................... 498
/api/NetworkService/MultiChassisDomain/Topology/Nodes(Id)............................................................... 499
/api/NetworkService/MultiChassisDomain/Topology/Nodes(Id)/ChildNodes........................................499
/api/NetworkService/MultiChassisDomain/ValidationErrors....................................................................... 500
/api/NetworkService/PortAdminStatuses.........................................................................................................503
/api/NetworkService/PortStatuses.................................................................................................................... 504
/api/NetworkService/PortBlinkStatuses........................................................................................................... 504
/api/NetworkService/PortRoles.......................................................................................................................... 505
api/NetworkService/ServerProfileBondingTechnologies...............................................................................506
api/NetworkService/ServerProfiles.................................................................................................................... 506
api/NetworkService/ServerProfiles(Id)..............................................................................................................507
/api/NetworkService /ServerProfiles(arg1)......................................................................................................508
/api/NetworkService /ServerProfiles(arg1)/ServerInterfaceProfiles........................................................ 509
/api/NetworkService /ServerProfiles(arg1)/ServerInterfaceProfiles(arg2).............................................. 511
/api/NetworkService /ServerProfiles(arg1)/ServerInterfaceProfiles(arg2)/Networks......................... 512
api/NetworkService/ServerProfiles(Id)/ServerInterfaceProfiles................................................................. 513
/api/NetworkService/Actions/NetworkService.ApplyServersInterfaceProfiles.......................................513
/api/NetworkService/Actions/NetworkService.ModifyServerProfiles....................................................... 514
/api/NetworkService/Actions/NetworkService.AddServerNetworks........................................................ 515
/api/NetworkService/Actions/NetworkService.DeleteServerNetworks....................................................516
/api/NetworkService/FeatureCapabilities..........................................................................................................516
Port configuration in Fabrics.........................................................................................................................................517
/api/JobService/Jobs.............................................................................................................................................. 517
Storage management.....................................................................................................................................................520
Assign enclosure........................................................................................................................................................520
Clear enclosure assignment.....................................................................................................................................521
Assign drives.............................................................................................................................................................. 522
Clear drive assignment............................................................................................................................................ 522
Force-activate a SAS IOM......................................................................................................................................523
Clear configuration on SAS IOM........................................................................................................................... 524
Extract SAS IOM logs to NFS share.................................................................................................................... 525
Extract SAS IOM logs to CIFS share................................................................................................................... 525
Quick Deploy.................................................................................................................................................................... 527
/api/JobService/Jobs..............................................................................................................................................527
Server NIC VLAN configuration.................................................................................................................................. 530
/api/NetworkService /ServerProfiles(arg1)...................................................................................................... 530
12
Contents
/api/NetworkService /ServerProfiles(arg1)/ServerInterfaceProfiles.........................................................532
/api/NetworkService /ServerProfiles(arg1)/ServerInterfaceProfiles(arg2).............................................533
/api/NetworkService /ServerProfiles(arg1)/ServerInterfaceProfiles(arg2)/Networks.........................533
/api/NetworkService /ServerProfiles(arg1)/ServerInterfaceProfiles(arg2)/Networks (arg3)............534
/api/NetworkService/Actions/NetworkService.ApplyServersInterfaceProfiles...................................... 535
Template Service............................................................................................................................................................ 536
/api/TemplateService/Profiles............................................................................................................................. 536
/api/TemplateService/Profiles(Id).......................................................................................................................536
/api/TemplateService/ProfileState..................................................................................................................... 537
/api/TemplateService/ProfileUsage....................................................................................................................538
/api/TemplateService/Actions/TemplateService.AttachProfile.................................................................. 539
/api/TemplateService/Actions/TemplateService.AssociateProfile.............................................................539
/api/TemplateService/Actions/TemplateService.UpdateProfile................................................................. 540
/api/TemplateService/Actions/TemplateService.MigrateProfile................................................................ 540
/api/TemplateService/Actions/TemplateService.DetachProfile.................................................................. 541
Chapter 17: APIs specific to OpenManage Enterprise.................................................................542
Application settings........................................................................................................................................................ 542
Console update................................................................................................................................................................542
/api/JobService/Jobs............................................................................................................................................. 542
/api/ConsoleUpdateService/Updates?$filter= Auto eq true........................................................................543
/api/ConsoleUpdateService/UpdateBundleInfo............................................................................................... 543
/api/ConsoleUpdateService/Actions/ConsoleUpdateService.DeleteUpgradeBundle............................ 544
/api/ConsoleUpdateService/Actions/ConsoleUpdateService.DownloadBundle...................................... 544
/api/ConsoleUpdateService/LastUpdateResult............................................................................................... 545
Mobile................................................................................................................................................................................ 545
/api/AlertService/MobileSubscriptions.............................................................................................................. 545
/api/AlertService/SubscriptionNotificationService......................................................................................... 546
/api/AlertService/Actions/AlertService.CreateEditMobileSubscription.....................................................547
/api/AlertService/Actions/AlertService.DeleteMobileSubscription.............................................................547
/api/AlertService/Actions/AlertService.EnableSubscriptionNotificationService.....................................547
/api/AlertService/Actions/AlertService.FilterAlertsByPolicy........................................................................548
Console Preferences......................................................................................................................................................549
/api/ApplicationService/Settings.........................................................................................................................549
/api/JobService/Jobs(10011)................................................................................................................................ 550
/api/ApplicationService/Settings..........................................................................................................................551
/api/Console/UpdateConsoleSettings................................................................................................................552
Alerts..................................................................................................................................................................................553
https://<IP>/api/ApplicationService/Settings.................................................................................................553
https://<IP>/api/AlertService/AlertDestinations/SMTPConfiguration.....................................................553
https://<IP>/api/AlertService/AlertDestinations/Actions/AlertDestinations.ApplySNMPConfig......554
https://<IP>/api/AlertService/AlertDestinations/Actions/AlertDestinations.ApplySyslogConfig .... 554
Incoming Alerts................................................................................................................................................................555
https://<IP>/api/ApplicationService/Settings................................................................................................ 555
Warranty........................................................................................................................................................................... 556
https://<IP>/api/ApplicationService/Settings ............................................................................................... 556
Network Configuration.................................................................................................................................................. 557
/api/ApplicationService/Network/AdapterConfigurations............................................................................ 557
/api/ApplicationService/Network/AdapterConfigurations('ens33')........................................................... 559
/api/ApplicationService/Actions/Network.ConfigureNetworkAdapter...................................................... 561
Contents
13
/api/NetworkConfigurationService/Actions/
NetworkConfigurationService.ImportVLANFromTarget............................................................................. 564
Configuration compliance............................................................................................................................................. 564
/api/TemplateService/Baselines ......................................................................................................................... 564
/api/TemplateService/Baselines(ID) ..................................................................................................................565
/ api/TemplateService/Baselines(ID)/DeviceConfigComplianceReports .................................................565
/api/TemplateService/Baselines(ID)/DeviceConfigComplianceReports(ID)/
DeviceComplianceDetails ...................................................................................................................................566
Troubleshoot service......................................................................................................................................................566
/api/JobService/Jobs............................................................................................................................................. 566
/api/TroubleshootService/Files............................................................................................................................568
/api/TroubleshootService/Actions/TroubleshootService.GetTroubleshootDocument..........................569
/api/TroubleShootService/Actions/TroubleShootService.GetArchivedConsoleLogs............................ 570
/api/TroubleShootService/Actions/TroubleShootService.DeleteArchivedConsoleLogs....................... 570
Query support service....................................................................................................................................................570
/api/QuerySupportService/Queries.....................................................................................................................570
/api/QuerySupportService/Queries(Id)...............................................................................................................571
/api/QuerySupportService/QueryContextSummaries.................................................................................... 572
/api/QuerySupportService/QueryContextSummary(Id)................................................................................ 573
/api/QuerySupportService/QueryContexts(Id)................................................................................................573
/api/QuerySupportService/QueryContexts(Id)/QuerySupportService.GetFiltersForContext.............576
/api/QuerySupportService/OperatorInfo...........................................................................................................579
/api/QuerySupportService/Filters........................................................................................................................581
/api/QuerySupportService/Filters(Id)................................................................................................................ 582
Groups service.................................................................................................................................................................583
/api/GroupService/Groups....................................................................................................................................583
/api/GroupService/Groups(Id)/SubGroups(Id)............................................................................................... 584
/api/GroupService/Groups(Id)/DeviceStatusSummary.................................................................................584
/api/GroupService/Groups(Id)/EventStatusSummary.................................................................................. 585
/api/GroupService/Groups(group id)/EventSeveritySummary?$filter=StatusType eq 2000.............586
/api/GroupService/Groups(group id)/EventSeveritySummary?$filter=StatusType eq 1000..............586
/api/GroupService/Groups(group id)/EventSeveritySummary$filter=StatusType eq 1....................... 586
/api/GroupService/GroupAudits.......................................................................................................................... 586
/api/GroupService/Actions/GroupService.CreateGroup...............................................................................587
/api/GroupService/Actions/GroupService.UpdateGroup..............................................................................587
/api/GroupService/Actions/GroupService.Clone............................................................................................ 588
/api/GroupService/Actions/GroupService.DeleteGroup............................................................................... 588
/api/GroupService/Actions/GroupService.AddMemberDevices................................................................. 589
/api/GroupService/Actions/GroupService.RemoveMemberDevices..........................................................589
/api/GroupService/Actions/GroupService.AddUserToGroups.................................................................... 589
Profiles.............................................................................................................................................................................. 590
/api/ProfileService/Profiles...................................................................................................................................590
/api/ProfileService/Profiles(arg)..........................................................................................................................591
/api/ProfileService/ProfileUsage..........................................................................................................................591
/api/ProfileService/Profiles(arg1)/AttributeDetails........................................................................................ 592
/api/ProfileService/Actions/ProfileService.Rename ..................................................................................... 592
/api/ProfileService/Actions/ProfileService.GetTargetSpecificAttributes.................................................592
/api/ProfileService/Actions/ProfileService.GetIdentityAttributes..............................................................593
/api/ProfileService/Actions/ProfileService.AssignProfile............................................................................. 593
/api/ProfileService/Actions/ProfileService.AssignProfileForAutoDeploy..................................................594
14
Contents
/api/ProfileService/Actions/ProfileService.SyncProfiles.............................................................................. 594
/api/ProfileService/Actions/ProfileService.MigrateProfile...........................................................................595
/api/ProfileService/Actions/ProfileService.UnassignProfiles.......................................................................595
/api/ProfileService/ProfileStates........................................................................................................................ 596
/api/ProfileService/Actions/ProfileService.Delete......................................................................................... 596
/api/ProfileService/Profiles(arg1)........................................................................................................................597
/api/ProfileService/Actions/ProfileService.GetInvalidTargetsForDeployTemplate................................ 597
/api/ProfileService/Actions/ProfileService.GetInvalidTargetsForAssignProfile...................................... 597
Devices.............................................................................................................................................................................. 598
/api/DeviceService/HostKeys.............................................................................................................................. 598
/api/DeviceService/Actions/DeviceService.AddKeys.................................................................................... 598
/api/DeviceService/Actions/DeviceService.ScanAndAddKeys....................................................................599
/api/DeviceService/Actions/DeviceService.RemoveKeys............................................................................ 599
/api/DeviceService/Actions/DeviceService.AddCredentialToDevice.........................................................600
Auto deploy...................................................................................................................................................................... 600
/api/AutoDeployService/Targets.........................................................................................................................600
/api/AutoDeployService/Actions/AutoDeployService.Verify........................................................................ 601
/api/AutoDeployService/Actions/AutoDeployService.Delete.......................................................................602
/api/AutoDeployService/AutoDeploy..................................................................................................................603
/api/AutoDeployService/AutoDeploy(AutoDeployId)......................................................................................603
Monitor.............................................................................................................................................................................. 604
Discovery service...................................................................................................................................................... 604
Server-initiated discovery........................................................................................................................................613
Warranty service........................................................................................................................................................616
Report service.............................................................................................................................................................617
MIB import service....................................................................................................................................................625
Plugin Manager................................................................................................................................................................629
/api/PluginService/Plugins.................................................................................................................................... 629
/api/PluginService/Plugins('<PluginId>')...........................................................................................................630
/api/PluginService/Plugins('<PluginId>')/AvailableVersionDetails...............................................................631
/api/PluginService/Actions/PluginService.CheckPluginCompatibility........................................................632
/api/PluginService/Actions/PluginService.UpdateConsolePlugins............................................................. 633
Power Metrics................................................................................................................................................................. 634
/api/MetricService/Metrics...................................................................................................................................634
/api/MetricService/TopEnergyConsumption....................................................................................................636
/api/MetricService/EnergyConsumption........................................................................................................... 638
/api/MetricService/MetricTypes......................................................................................................................... 639
/api/MetricService/MetricsConsumption...........................................................................................................641
/api/MetricService/Threshold.............................................................................................................................. 642
/api/MetricService/TopOffenders.......................................................................................................................643
/api/MetricService/Actions/MetricService.SaveThreshold..........................................................................644
Chapter 18: Redfish resource model.......................................................................................... 646
RedfishServiceRoot...................................................................................................................................................646
redfish/v1....................................................................................................................................................................646
redfish/v1/$metadata..............................................................................................................................................647
redfish/v1/odata....................................................................................................................................................... 654
RedfishSessionService..............................................................................................................................................655
/redfish/v1/SessionService................................................................................................................................... 656
/redfish/v1/SessionService/Sessions/Members............................................................................................. 656
Contents
15
/redfish/v1/SessionService/Sessions/Members(Id)...................................................................................... 658
RedfishAccount Service........................................................................................................................................... 659
/redfish/v1/AccountService..................................................................................................................................659
/redfish/v1/AccountService/Accounts/Members...........................................................................................662
/redfish/v1/AccountService/Accounts/Members(Id)....................................................................................664
redfish/v1/AccountService/Roles/Members.................................................................................................... 666
RedfishMessage Registry.........................................................................................................................................668
/redfish/v1/Registries............................................................................................................................................. 668
GET method for Registry instance....................................................................................................................... 668
redfish/v1/MessageRegistryCollection/Members(<InstanceId>)................................................................669
RedfishChassis............................................................................................................................................................670
/redfish/v1/Chassis................................................................................................................................................. 670
RedfishSystems.......................................................................................................................................................... 677
/redfish/v1/Systems................................................................................................................................................677
redfish/v1/Systems/Members(id)........................................................................................................................678
redfish/v1/Systems/Members(id)/Processors................................................................................................ 680
redfish/v1/Systems/Members(id)/Processors/Members(id)...................................................................... 680
redfish/v1/Systems/Members(id)/EthernetInterfaces...................................................................................681
redfish/v1/Systems/Members(id)/EthernetInterfaces/Members(id)........................................................682
redfish/v1/Systems/Members(id)/SimpleStorage.......................................................................................... 682
redfish/v1/Systems/Members(id)/SimpleStorage/Members.......................................................................683
redfish/v1/Systems/Members(id)/SimpleStorage/Members(id)................................................................684
redfish/v1/Systems/Members(id)/Actions/ComputerSystem.Reset.........................................................684
RedfishCompositionService.....................................................................................................................................685
redfish/v1/CompositionService.............................................................................................................................685
redfish/v1/CompositionService/ResourceBlocks.............................................................................................685
redfish/v1/CompositionService/ResourceBlocks/Members(<InstanceId>)..............................................687
redfish/v1/CompositionService/ResourceZones..............................................................................................688
redfish/v1/CompositionService/ResourceZones/Members(<InstanceId>).............................................. 689
/redfish/v1/Systems/Members(<SystemId>)/Actions/ComputerSystem.AddResourceBlock........... 690
/redfish/v1/Systems/Members(<SystemId>)/Actions/ComputerSystem.RemoveResourceBlock... 690
16
Contents
About this document
This document contains information about the resource models for OpenManage Enterprise and OpenManage Enterprise
Modular Edition (OMEModular). Each RESTful API specification includes the URI, method, parameters, request codes, and
response codes. Some of the APIs are available only in OMEModular and do not work if used in OMEModular and the
opposite way.
Table 1. Supported REST API versions
Product Date of release What's new
OpenManage Enterprise 3.5 December 2020 The following APIs are added:
/api/TemplateService/Baselines(ID) on page 565
POST method for Baselines on page 564
OpenManage Enterprise 3.5 November 2020
API to retrieve information about the last attempted
console upgrade. See /api/ConsoleUpdateService/
LastUpdateResult on page 545.
APIs to add, delete, modify, and test OpenID Connect
(OIDC) provider information.
/api/AccountService/ExternalAccountProvider/
OpenIDConnectProvider on page 66
/api/AccountService/ExternalAccountProvider/
OpenIDConnectProvider('OIDCProviderID') on
page 66
/api/AccountService/ExternalAccountProvider/
Actions/
ExternalAccountProvider.DeleteOIDCProviders on
page 68
/api/AccountService/ExternalAccountProvider/
Actions/
ExternalAccountProvider.DisableOIDCProviders on
page 68
/api/AccountService/ExternalAccountProvider/
Actions/
ExternalAccountProvider.EnableOIDCProviders on
page 67
/api/AccountService/ExternalAccountProvider/
Actions/
ExternalAccountProvider.TestOIDCProvider on
page 69
/api/AccountService/ExternalAccountProvider/
Actions/
ExternalAccountProvider.TestOIDCProviderRegistr
ationStatus on page 69
OpenManage Enterprise Modular Edition
1.20.10
August 2020
APIs to fetch compliance report of device
components. For more information, see /api/
UpdateService/Baselines(Id)/
DeviceComplianceReports.
APIs to fetch component compliance reports by Id. For
more information, see /api/UpdateService/
Baselines(Id)/DeviceComplianceReports(Id)/
ComponentComplianceReports.
1
About this document 17
Table 1. Supported REST API versions (continued)
Product Date of release What's new
Added a new compliance status option, "Unknown".
For details, see /api/UpdateService/Baselines(Id)/
DeviceComplianceReports, /api/UpdateService/
Baselines(Id)/DeviceComplianceReports(Id)/
ComponentComplianceReports(Id)/api/
UpdateService/Baselines(Id)/
DeviceComplianceReports(Id)/
ComponentComplianceReports, /api/UpdateService/
Baselines(Id)/DeviceComplianceReports(Id)/
ComponentComplianceReports(Id)
18 About this document
Overview
RESTful API support in OpenManage Enterprise,
OpenManage Enterprise and OMEModular
OMEModular supports RESTful API. Support for APIs has also been improved for OpenManage Enterprise. Improved support
for APIs on these products enhances the systems management capabilities. The RESTful interface is provided over HTTPS in
JSON format based on ODATA v4 usable by clients, scripts, and browser-based GUIs. The APIs enable you to build console
management tools based on common programming and scripting languages such as Python, Java, and C.
For more information about REST, see publically-available resources.
Topics:
RESTful application programming interface
OData
JSON data
HTTPS communication
OpenManage Enterprise Modular Edition
OpenManage Enterprise
RESTful application programming interface
Representational State Transfer or REST is a software architectural style used within the World Wide Web. REST architectures
are commonly used for many IT solutions, including the definition of web-based APIs. Systems that adhere to REST practices
are often referred to as RESTful interfaces. RESTful interfaces use the HTTP methodsGET, POST, DELETE, and so onthat
web browsers use to access web pages.
OData
OData is an open protocol standard for the definition and exchange of information using RESTful APIs. When implementing a
common interface across multiple vendors, it is important to standardize the data formats. Standardizing the data formats
ensure that the data structures remain interchangeable between different manufacturers.
JSON data
Console API represents data using JSON. JSON is a lightweight data-interchange format that is readable and can also be easily
parsed by machines. JSON is based on a subset of the JavaScript Programming Language. JSON uses a text format that is
language independent 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. Secure HTTP (HTTPS) is a secure
version of HTTP where it operates within a network connection encrypted by TLS or SSL. By enforcing HTTPS, the security of
console management is significantly enhanced.
2
Overview 19
OpenManage Enterprise Modular Edition
OpenManage Enterprise Modular Edition (OMEModular) is the systems management software that runs on the Dell EMC
PowerEdge MX-series chassis. OMEModular shares a common codebase with OpenManage Enterprise and delivers an agile,
reliable, and comprehensive platform to manage PowerEdge MX-series servers, storage, and networking products. OME
Modular boosts services delivery and restores IT agility for growing businesses. A unified web and RESTful API interface
manages all nodes including compute, storage, and networking. OMEModular helps reduce costs and learning curve, and
consolidates multiple tools for ease of access and monitoring. Simplified administration helps deploy and monitor at scale, from
one to many chassis, with support for remote management. Agile and intelligent automation of OMEModular helps faster
hardware deployments and reduces repetitive tasks for accelerated life cycle management. Some of the key features of OME
Modular include:
Capability to manage servers across multiple MX-series chassis
Fast deployment with automatic chassis and node discovery
Comprehensive RESTful API to automate multiple tasks and integrate with third-party tools
Enhanced management with redundant OME-M module, touchscreen LCD, and OpenManage Mobile options for remote
access
Expanded management across all PowerEdge servers with OpenManage Enterprise
OpenManage Enterprise
OpenManage Enterprise is a hardware management and monitoring console that provides a comprehensive view of devices.
These devices include servers, chassis, network switches, and other third-party devices on the enterprise network.
OpenManage Enterprise is designed with a focus on simplicity, automation, and unification of data center management. Some of
the key features of OpenManage Enterprise include:
Architecture is delivered as a virtual applianceESXi, Hyper-V, and KVM
Engineered on CentOS with PostgreSQL database
No operating system and database licenses are required
End-to-end server life cycle management that includes inventory, monitoring, reporting, configuration, and deployment
Northbound API that helps you automate and integrate with existing solutions
Simplified discovery processes that enable devices to automatically register themselves with the console
Intuitive interface that minimizes management steps
Modernized dashboard that provides a clear view of alerts and options for performing corrective actions
Access to warranty status
Customized reporting capabilities
20
Overview
  • Page 1 1
  • Page 2 2
  • Page 3 3
  • Page 4 4
  • Page 5 5
  • Page 6 6
  • Page 7 7
  • Page 8 8
  • Page 9 9
  • Page 10 10
  • Page 11 11
  • Page 12 12
  • Page 13 13
  • Page 14 14
  • Page 15 15
  • Page 16 16
  • Page 17 17
  • Page 18 18
  • Page 19 19
  • Page 20 20
  • Page 21 21
  • Page 22 22
  • Page 23 23
  • Page 24 24
  • Page 25 25
  • Page 26 26
  • Page 27 27
  • Page 28 28
  • Page 29 29
  • Page 30 30
  • Page 31 31
  • Page 32 32
  • Page 33 33
  • Page 34 34
  • Page 35 35
  • Page 36 36
  • Page 37 37
  • Page 38 38
  • Page 39 39
  • Page 40 40
  • Page 41 41
  • Page 42 42
  • Page 43 43
  • Page 44 44
  • Page 45 45
  • Page 46 46
  • Page 47 47
  • Page 48 48
  • Page 49 49
  • Page 50 50
  • Page 51 51
  • Page 52 52
  • Page 53 53
  • Page 54 54
  • Page 55 55
  • Page 56 56
  • Page 57 57
  • Page 58 58
  • Page 59 59
  • Page 60 60
  • Page 61 61
  • Page 62 62
  • Page 63 63
  • Page 64 64
  • Page 65 65
  • Page 66 66
  • Page 67 67
  • Page 68 68
  • Page 69 69
  • Page 70 70
  • Page 71 71
  • Page 72 72
  • Page 73 73
  • Page 74 74
  • Page 75 75
  • Page 76 76
  • Page 77 77
  • Page 78 78
  • Page 79 79
  • Page 80 80
  • Page 81 81
  • Page 82 82
  • Page 83 83
  • Page 84 84
  • Page 85 85
  • Page 86 86
  • Page 87 87
  • Page 88 88
  • Page 89 89
  • Page 90 90
  • Page 91 91
  • Page 92 92
  • Page 93 93
  • Page 94 94
  • Page 95 95
  • Page 96 96
  • Page 97 97
  • Page 98 98
  • Page 99 99
  • Page 100 100
  • Page 101 101
  • Page 102 102
  • Page 103 103
  • Page 104 104
  • Page 105 105
  • Page 106 106
  • Page 107 107
  • Page 108 108
  • Page 109 109
  • Page 110 110
  • Page 111 111
  • Page 112 112
  • Page 113 113
  • Page 114 114
  • Page 115 115
  • Page 116 116
  • Page 117 117
  • Page 118 118
  • Page 119 119
  • Page 120 120
  • Page 121 121
  • Page 122 122
  • Page 123 123
  • Page 124 124
  • Page 125 125
  • Page 126 126
  • Page 127 127
  • Page 128 128
  • Page 129 129
  • Page 130 130
  • Page 131 131
  • Page 132 132
  • Page 133 133
  • Page 134 134
  • Page 135 135
  • Page 136 136
  • Page 137 137
  • Page 138 138
  • Page 139 139
  • Page 140 140
  • Page 141 141
  • Page 142 142
  • Page 143 143
  • Page 144 144
  • Page 145 145
  • Page 146 146
  • Page 147 147
  • Page 148 148
  • Page 149 149
  • Page 150 150
  • Page 151 151
  • Page 152 152
  • Page 153 153
  • Page 154 154
  • Page 155 155
  • Page 156 156
  • Page 157 157
  • Page 158 158
  • Page 159 159
  • Page 160 160
  • Page 161 161
  • Page 162 162
  • Page 163 163
  • Page 164 164
  • Page 165 165
  • Page 166 166
  • Page 167 167
  • Page 168 168
  • Page 169 169
  • Page 170 170
  • Page 171 171
  • Page 172 172
  • Page 173 173
  • Page 174 174
  • Page 175 175
  • Page 176 176
  • Page 177 177
  • Page 178 178
  • Page 179 179
  • Page 180 180
  • Page 181 181
  • Page 182 182
  • Page 183 183
  • Page 184 184
  • Page 185 185
  • Page 186 186
  • Page 187 187
  • Page 188 188
  • Page 189 189
  • Page 190 190
  • Page 191 191
  • Page 192 192
  • Page 193 193
  • Page 194 194
  • Page 195 195
  • Page 196 196
  • Page 197 197
  • Page 198 198
  • Page 199 199
  • Page 200 200
  • Page 201 201
  • Page 202 202
  • Page 203 203
  • Page 204 204
  • Page 205 205
  • Page 206 206
  • Page 207 207
  • Page 208 208
  • Page 209 209
  • Page 210 210
  • Page 211 211
  • Page 212 212
  • Page 213 213
  • Page 214 214
  • Page 215 215
  • Page 216 216
  • Page 217 217
  • Page 218 218
  • Page 219 219
  • Page 220 220
  • Page 221 221
  • Page 222 222
  • Page 223 223
  • Page 224 224
  • Page 225 225
  • Page 226 226
  • Page 227 227
  • Page 228 228
  • Page 229 229
  • Page 230 230
  • Page 231 231
  • Page 232 232
  • Page 233 233
  • Page 234 234
  • Page 235 235
  • Page 236 236
  • Page 237 237
  • Page 238 238
  • Page 239 239
  • Page 240 240
  • Page 241 241
  • Page 242 242
  • Page 243 243
  • Page 244 244
  • Page 245 245
  • Page 246 246
  • Page 247 247
  • Page 248 248
  • Page 249 249
  • Page 250 250
  • Page 251 251
  • Page 252 252
  • Page 253 253
  • Page 254 254
  • Page 255 255
  • Page 256 256
  • Page 257 257
  • Page 258 258
  • Page 259 259
  • Page 260 260
  • Page 261 261
  • Page 262 262
  • Page 263 263
  • Page 264 264
  • Page 265 265
  • Page 266 266
  • Page 267 267
  • Page 268 268
  • Page 269 269
  • Page 270 270
  • Page 271 271
  • Page 272 272
  • Page 273 273
  • Page 274 274
  • Page 275 275
  • Page 276 276
  • Page 277 277
  • Page 278 278
  • Page 279 279
  • Page 280 280
  • Page 281 281
  • Page 282 282
  • Page 283 283
  • Page 284 284
  • Page 285 285
  • Page 286 286
  • Page 287 287
  • Page 288 288
  • Page 289 289
  • Page 290 290
  • Page 291 291
  • Page 292 292
  • Page 293 293
  • Page 294 294
  • Page 295 295
  • Page 296 296
  • Page 297 297
  • Page 298 298
  • Page 299 299
  • Page 300 300
  • Page 301 301
  • Page 302 302
  • Page 303 303
  • Page 304 304
  • Page 305 305
  • Page 306 306
  • Page 307 307
  • Page 308 308
  • Page 309 309
  • Page 310 310
  • Page 311 311
  • Page 312 312
  • Page 313 313
  • Page 314 314
  • Page 315 315
  • Page 316 316
  • Page 317 317
  • Page 318 318
  • Page 319 319
  • Page 320 320
  • Page 321 321
  • Page 322 322
  • Page 323 323
  • Page 324 324
  • Page 325 325
  • Page 326 326
  • Page 327 327
  • Page 328 328
  • Page 329 329
  • Page 330 330
  • Page 331 331
  • Page 332 332
  • Page 333 333
  • Page 334 334
  • Page 335 335
  • Page 336 336
  • Page 337 337
  • Page 338 338
  • Page 339 339
  • Page 340 340
  • Page 341 341
  • Page 342 342
  • Page 343 343
  • Page 344 344
  • Page 345 345
  • Page 346 346
  • Page 347 347
  • Page 348 348
  • Page 349 349
  • Page 350 350
  • Page 351 351
  • Page 352 352
  • Page 353 353
  • Page 354 354
  • Page 355 355
  • Page 356 356
  • Page 357 357
  • Page 358 358
  • Page 359 359
  • Page 360 360
  • Page 361 361
  • Page 362 362
  • Page 363 363
  • Page 364 364
  • Page 365 365
  • Page 366 366
  • Page 367 367
  • Page 368 368
  • Page 369 369
  • Page 370 370
  • Page 371 371
  • Page 372 372
  • Page 373 373
  • Page 374 374
  • Page 375 375
  • Page 376 376
  • Page 377 377
  • Page 378 378
  • Page 379 379
  • Page 380 380
  • Page 381 381
  • Page 382 382
  • Page 383 383
  • Page 384 384
  • Page 385 385
  • Page 386 386
  • Page 387 387
  • Page 388 388
  • Page 389 389
  • Page 390 390
  • Page 391 391
  • Page 392 392
  • Page 393 393
  • Page 394 394
  • Page 395 395
  • Page 396 396
  • Page 397 397
  • Page 398 398
  • Page 399 399
  • Page 400 400
  • Page 401 401
  • Page 402 402
  • Page 403 403
  • Page 404 404
  • Page 405 405
  • Page 406 406
  • Page 407 407
  • Page 408 408
  • Page 409 409
  • Page 410 410
  • Page 411 411
  • Page 412 412
  • Page 413 413
  • Page 414 414
  • Page 415 415
  • Page 416 416
  • Page 417 417
  • Page 418 418
  • Page 419 419
  • Page 420 420
  • Page 421 421
  • Page 422 422
  • Page 423 423
  • Page 424 424
  • Page 425 425
  • Page 426 426
  • Page 427 427
  • Page 428 428
  • Page 429 429
  • Page 430 430
  • Page 431 431
  • Page 432 432
  • Page 433 433
  • Page 434 434
  • Page 435 435
  • Page 436 436
  • Page 437 437
  • Page 438 438
  • Page 439 439
  • Page 440 440
  • Page 441 441
  • Page 442 442
  • Page 443 443
  • Page 444 444
  • Page 445 445
  • Page 446 446
  • Page 447 447
  • Page 448 448
  • Page 449 449
  • Page 450 450
  • Page 451 451
  • Page 452 452
  • Page 453 453
  • Page 454 454
  • Page 455 455
  • Page 456 456
  • Page 457 457
  • Page 458 458
  • Page 459 459
  • Page 460 460
  • Page 461 461
  • Page 462 462
  • Page 463 463
  • Page 464 464
  • Page 465 465
  • Page 466 466
  • Page 467 467
  • Page 468 468
  • Page 469 469
  • Page 470 470
  • Page 471 471
  • Page 472 472
  • Page 473 473
  • Page 474 474
  • Page 475 475
  • Page 476 476
  • Page 477 477
  • Page 478 478
  • Page 479 479
  • Page 480 480
  • Page 481 481
  • Page 482 482
  • Page 483 483
  • Page 484 484
  • Page 485 485
  • Page 486 486
  • Page 487 487
  • Page 488 488
  • Page 489 489
  • Page 490 490
  • Page 491 491
  • Page 492 492
  • Page 493 493
  • Page 494 494
  • Page 495 495
  • Page 496 496
  • Page 497 497
  • Page 498 498
  • Page 499 499
  • Page 500 500
  • Page 501 501
  • Page 502 502
  • Page 503 503
  • Page 504 504
  • Page 505 505
  • Page 506 506
  • Page 507 507
  • Page 508 508
  • Page 509 509
  • Page 510 510
  • Page 511 511
  • Page 512 512
  • Page 513 513
  • Page 514 514
  • Page 515 515
  • Page 516 516
  • Page 517 517
  • Page 518 518
  • Page 519 519
  • Page 520 520
  • Page 521 521
  • Page 522 522
  • Page 523 523
  • Page 524 524
  • Page 525 525
  • Page 526 526
  • Page 527 527
  • Page 528 528
  • Page 529 529
  • Page 530 530
  • Page 531 531
  • Page 532 532
  • Page 533 533
  • Page 534 534
  • Page 535 535
  • Page 536 536
  • Page 537 537
  • Page 538 538
  • Page 539 539
  • Page 540 540
  • Page 541 541
  • Page 542 542
  • Page 543 543
  • Page 544 544
  • Page 545 545
  • Page 546 546
  • Page 547 547
  • Page 548 548
  • Page 549 549
  • Page 550 550
  • Page 551 551
  • Page 552 552
  • Page 553 553
  • Page 554 554
  • Page 555 555
  • Page 556 556
  • Page 557 557
  • Page 558 558
  • Page 559 559
  • Page 560 560
  • Page 561 561
  • Page 562 562
  • Page 563 563
  • Page 564 564
  • Page 565 565
  • Page 566 566
  • Page 567 567
  • Page 568 568
  • Page 569 569
  • Page 570 570
  • Page 571 571
  • Page 572 572
  • Page 573 573
  • Page 574 574
  • Page 575 575
  • Page 576 576
  • Page 577 577
  • Page 578 578
  • Page 579 579
  • Page 580 580
  • Page 581 581
  • Page 582 582
  • Page 583 583
  • Page 584 584
  • Page 585 585
  • Page 586 586
  • Page 587 587
  • Page 588 588
  • Page 589 589
  • Page 590 590
  • Page 591 591
  • Page 592 592
  • Page 593 593
  • Page 594 594
  • Page 595 595
  • Page 596 596
  • Page 597 597
  • Page 598 598
  • Page 599 599
  • Page 600 600
  • Page 601 601
  • Page 602 602
  • Page 603 603
  • Page 604 604
  • Page 605 605
  • Page 606 606
  • Page 607 607
  • Page 608 608
  • Page 609 609
  • Page 610 610
  • Page 611 611
  • Page 612 612
  • Page 613 613
  • Page 614 614
  • Page 615 615
  • Page 616 616
  • Page 617 617
  • Page 618 618
  • Page 619 619
  • Page 620 620
  • Page 621 621
  • Page 622 622
  • Page 623 623
  • Page 624 624
  • Page 625 625
  • Page 626 626
  • Page 627 627
  • Page 628 628
  • Page 629 629
  • Page 630 630
  • Page 631 631
  • Page 632 632
  • Page 633 633
  • Page 634 634
  • Page 635 635
  • Page 636 636
  • Page 637 637
  • Page 638 638
  • Page 639 639
  • Page 640 640
  • Page 641 641
  • Page 642 642
  • Page 643 643
  • Page 644 644
  • Page 645 645
  • Page 646 646
  • Page 647 647
  • Page 648 648
  • Page 649 649
  • Page 650 650
  • Page 651 651
  • Page 652 652
  • Page 653 653
  • Page 654 654
  • Page 655 655
  • Page 656 656
  • Page 657 657
  • Page 658 658
  • Page 659 659
  • Page 660 660
  • Page 661 661
  • Page 662 662
  • Page 663 663
  • Page 664 664
  • Page 665 665
  • Page 666 666
  • Page 667 667
  • Page 668 668
  • Page 669 669
  • Page 670 670
  • Page 671 671
  • Page 672 672
  • Page 673 673
  • Page 674 674
  • Page 675 675
  • Page 676 676
  • Page 677 677
  • Page 678 678
  • Page 679 679
  • Page 680 680
  • Page 681 681
  • Page 682 682
  • Page 683 683
  • Page 684 684
  • Page 685 685
  • Page 686 686
  • Page 687 687
  • Page 688 688
  • Page 689 689
  • Page 690 690

Dell EMC OpenManage Enterprise Reference guide

Type
Reference guide

Ask a question and I''ll find the answer in the document

Finding information in a document is now easier with AI