API Guide

ManualsBrandsDell ManualsActive System ManagerOpenManage Enterprise-Modular

OpenManage Enterprise and OpenManage

Enterprise - Modular Edition

RESTful API Guide

March 2020

Rev. A00

Summary of content (611 pages)

PAGE 1
OpenManage Enterprise and OpenManage Enterprise - Modular Edition RESTful API Guide March 2020 Rev.
PAGE 2
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.
PAGE 3
Contents Chapter 1: About this document...................................................................................................16 Chapter 2: Overview.................................................................................................................... 17 RESTful application programming interface................................................................................................................ 17 OData......................................................................
PAGE 4
/api/AccountService/Actions/AccountService.Delete..................................................................................... 45 /api/AccountService/Roles......................................................................................................................................46 /api/AccountService/Roles(Id)............................................................................................................................... 47 /api/AccountService/ExternalAccountProvider.........
PAGE 5
/api/AlertService/Actions/AlertService.Unacknowledge.................................................................................96 /api/AlertService/Actions/AlertService.RemoveAlerts.................................................................................... 97 Alert policies....................................................................................................................................................................... 98 /api/AlertService/AlertPolicies.....................
PAGE 6
/api/TemplateService/Templates(Id)/Views(Id)/AttributeViewDetails......................................................157 /api/TemplateService/Templates(Id)/Views(Id)/AttributeViewDetails/TemplateEditInfoDetails.......160 /api/TemplateService/Templates(Id)/Views(Id)/DeviceAttributeViewDetails(Id).................................. 162 /api/TemplateService/Templates(26)/Views(9)/DeviceAttributeViewDetails(10176)...........................167 /api/TemplateService/Profiles......................................
PAGE 7
GET method for device filter................................................................................................................................. 204 /api/DeviceService/Devices(Id)................................................................................................................................. 210 GET method for Devices(Id)...................................................................................................................................
PAGE 8
/api/DeviceService/Actions/DeviceService/Devices(Id)Actions/DeviceService.GetTermState............. 242 POST method for getting term state...................................................................................................................242 /api/DeviceService/Actions/DeviceService/Devices(Id)Actions/DeviceService.GetComputeIPs...........242 POST method for /api/DeviceService/Actions/DeviceService/Devices(Id)Actions/ DeviceService.GetComputeIPs.................................................
PAGE 9
/api/GroupService/Groups(group id)/AllLeafDeviceSummaries?$filter=Type eq 4000............................. 283 Get method for AllLeafDeviceSummaries?$filter=Type eq 4000 ................................................................283 /api/GroupService/Groups(group id)/AllLeafDeviceSummaries?$filter=Type eq 4000&$top=25& $skip=0 ........................................................................................................................................................................
PAGE 10
/api/JobService/Actions/JobService.ExecuteAction..................................................................................... 340 Chapter 11: Reset application.....................................................................................................342 /api/ApplicationService/Actions/ApplicationService.ResetApplication........................................................... 342 POST method for ResetApplication.............................................................................
PAGE 11
/api/ManagementDomainService/DiscoveredDomains.................................................................................. 386 /api/ManagementDomainService/ConfigurationTypes.................................................................................. 388 /api/ManagementDomainService/ConfigurationTypes(Id)........................................................................... 390 /api/ManagementDomainService/Domains..............................................................................
PAGE 12
/api/NetworkService/MultiChassisDomain/Topology.................................................................................... 440 /api/NetworkService/MultiChassisDomain/Topology/Nodes...................................................................... 440 /api/NetworkService/MultiChassisDomain/Topology/Nodes(Id)................................................................ 441 /api/NetworkService/MultiChassisDomain/Topology/Nodes(Id)/ChildNodes........................................
PAGE 13
/api/ConsoleUpdateService/Actions/ConsoleUpdateService.DeleteUpgradeBundle............................. 481 /api/ConsoleUpdateService/Actions/ConsoleUpdateService.DownloadBundle.......................................481 Mobile................................................................................................................................................................................ 482 /api/AlertService/MobileSubscriptions....................................................................
PAGE 14
/api/GroupService/GroupAudits...........................................................................................................................519 /api/GroupService/Actions/GroupService.CreateGroup...............................................................................520 /api/GroupService/Actions/GroupService.UpdateGroup..............................................................................520 /api/GroupService/Actions/GroupService.Clone...............................................
PAGE 15
/redfish/v1/AccountService/Accounts/Members...........................................................................................582 /redfish/v1/AccountService/Accounts/Members(Id)....................................................................................584 redfish/v1/AccountService/Roles/Members.................................................................................................... 586 Redfish—Message Registry.......................................................................
PAGE 16
1 About this document This document contains information about the resource models for OpenManage Enterprise and OpenManage Enterprise – Modular Edition (OME–Modular). Each RESTful API specification includes the URI, method, parameters, request codes, and response codes. Some of the APIs are available only in OME–Modular and do not work if used in OME–Modular and the opposite way. Table 1. Supported REST API versions Product Date of release Whats new OpenManage Enterprise 3.3.
PAGE 17
2 Overview RESTful API support in OpenManage Enterprise, OpenManage Enterprise and OME–Modular OME–Modular 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.
PAGE 18
OpenManage Enterprise – Modular Edition OpenManage Enterprise – Modular Edition (OME–Modular) is the systems management software that runs on the Dell EMC PowerEdge MX-series chassis. OME–Modular 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.
PAGE 19
3 Key integration concepts This section describes the key integration concepts that are applicable to the use cases and resource model. Topics: • • • • • • • • • • • • • Base URI Security Authentication Authorization Resource addressing Resource operations Security considerations Data filtering Data sorting Data pagination Request headers Response codes Response headers Base URI REST API tree structure The console software provides a web-based hypermedia driven API using a simple folder structure.
PAGE 20
Resource tree for OME–Modular OEM scheme Figure 1. Resource tree for OME–Modular OEM scheme Resource tree for OpenManage Enterprise OEM scheme Figure 2.
PAGE 21
Resource model https://[IP or DNS name]/api/$metadata Redfish scheme https://[IP or DNS name]/redfish/v1 Resource tree for Redfish scheme Figure 3. Resource tree for Redfish scheme NOTE: Current version of the console supports the DMTF-defined schema for a selected set of resources in the hierarchy that is outlined in this image. Resource model https://[IP or DNS name]/redfish/v1/$metadata Security To improve security, only HTTPS is supported.
PAGE 22
Authentication Several common schemes are available for enabling authentication of REST requests. Basic Authentication and X-Auth-Token Authentication are some of the common schemes. Basic authentication The authorization header in the request has the base-64 encoding of the credentials—username and password. If you do not provide the credentials, a 401—Authorization Failure error is returned. Basic Authentication is supported only when SSL/TLS is used for the transport.
PAGE 23
Table 2. Authentication and authorization requirements (continued) Actions Authentication required Authorization required N/A N/A View JSON schemas URI OME - Modular Table 3. Role descriptions OME-Modular Role Description VIEW View all data, report execution and management, and so on. APPLIANCE_SETUP Global appliance/OME - Modular settings that involve setup of the appliance. SECURITY_SETUP User management, security policies, proxy, and firewall setup.
PAGE 24
Table 4. Roles and associated privileges for OME - Modular (continued) Privilege Roles CHASSIS_ADMIN ISTRATOR COMPUTE_MAN AGER STORAGE_MANA GER FABRIC_MANAG ER DEVICE_UPDATE Y Y Y Y TEMPLATE_MANA GEMENT Y Y BASELINE_MANA GEMENT Y Y Y Y POWER_MANAGE MENT Y Y JOB_MANAGEME NT Y Y Y Y ALERT_MANAGEM ENT Y FABRIC_MANAGE MENT Y NETWORK_MANA GEMENT Y VIEWER Y Y Y OME - Modular Table 5.
PAGE 25
Table 5. Roles and associated privileges for OME - Modular (continued) Privilege Roles ADMINISTRATOR DEVICE_MANAGER VIEWER ALERT_MANAGEMENT Y N N AUTO_DEPLOY_MANAGEME NT Y N N FABRIC_MANAGEMENT Y N N NETWORK_MANAGEMENT Y N N Resource addressing Each managed resource must be uniquely addressable using a distinct URI. The URI syntax must be intuitive and should indicate the relationships with a parent resource.
PAGE 26
Table 6. HTTP methods (continued) HTTP method Description Example DELETE Used for removing a specific resource. If the resource does not exist, a Success response is returned. Delete a specific user account. DELETE / AccountService/ Accounts('1414') When you perform tasks using these methods, they return an HTTP response code. For more information about the response codes, see Status Code Definitions on the W3.org website. If a method fails, you may also see an Error and Event Message code.
PAGE 27
Data pagination The console software provides pagination options on certain URIs that return a collection of entities. The pagination options enable the clients to get paginated results. If a URI supports pagination, the relevant URI sections indicate it.
PAGE 28
Table 8.
PAGE 29
Table 9.
PAGE 30
4 Application settings Topics: • • • • Network Security and user management Security and certificate management Monitoring and alert notifications Network /api/ApplicationService/Network This URI represents the collection of network application services. GET method for Network This method returns the network configuration details. Description Returns the network configuration details. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "$metadata#Network.
PAGE 31
/api/ApplicationService/Network/WebServerConfiguration This URI represents the web-server configuration. GET method for WebServerConfiguration This method returns the web server configuration, including the status, port number, and session timeout duration. Description Returns the web-server configuration, including the status of the web server, port number, and session timeout duration. Privilege VIEW HTTP response codes 200 Example response body { } "@odata.context": "$metadata#Network.
PAGE 32
/api/ApplicationService/Network/TimeConfiguration This URI represents the time-configuration-related application services. GET method for TimeConfiguration This method returns the current time-related configuration. Description Returns the time-related configuration. Privilege VIEW HTTP response codes 200 Example response body { } "@odata.context": "$metadata#Network.TimeConfiguration/$entity", "@odata.
PAGE 33
Table 11. Attributes (continued) Attribute name Description EnableNTP Specify whether to enable or disable NTP. PrimaryNTPAddress The primary NTP address. SecondaryNTPAddress1 The first secondary NTP address. SecondaryNTPAddress2 The second secondary NTP address. SystemTime The system time. If EnableNTP is False, SystemTime cannot be null or empty. /api/ApplicationService/Network/TimeZones This URI represents the time-zone application services.
PAGE 34
/api/ApplicationService/Network/ProxyConfiguration This URI represents the proxy configuration. GET method for ProxyConfiguration This method returns the current proxy configuration. Description Returns the current proxy configuration. Privilege VIEW HTTP response codes 200 Example response body { } "@odata.context": "$metadata#Network.ProxyConfiguration/$entity", "@odata.
PAGE 35
Table 13. Attributes (continued) Attribute name Description PortNumber Port number, if HTTP Proxy Settings is enabled. EnableAuthentication Enable or disable Proxy Authentication. EnableProxy Enable or disable HTTP Proxy Settings. Username Username, if Proxy Authentication is enabled. Password Password, if Proxy Authentication is enabled. Security and user management /api/AccountService This URI represents the configuration of the user accounts.
PAGE 36
} } "@odata.id": "/api/AccountService/ExternalAccountProvider" Table 14. Attributes Attribute Description Description Description for the Account service. Name Name given for Account service. State Indicates the known state of the resource. HealthRollup Health rollup status. Health Health of the resource. ServiceEnabled Indicates if the service is enabled or disabled.
PAGE 37
} Example response body { } }, "ServiceEnabled": false, "AuthFailureLoggingThreshold": 3, "MinPasswordLength": 8, "MaxPasswordLength": 20, "AccountLockoutThreshold": 3, "AccountLockoutDuration": 30, "AccountLockoutCounterResetAfter": 900, "EnableIpRangeAddress": false, "IpRangeAddress": null, "ByUserName": false, "ByIPAddress": false "Id": "10", "Description": "MSM User Accounts", "Name": "Account Service", "Status": { "State": "Enabled", "HealthRollup": "OK", "Health": "OK", "Oem": null }, "Oem": null
PAGE 38
Table 15. Attributes (continued) Attribute Description higher than the AccountLockoutResetAfter value. 0 indicates that the account is never locked. AccountLockoutCounterResetAfter The interval of time in seconds since the last failed login attempt at which point the lockout threshold counter for the account is reset to zero. Must be less than or equal to AccountLockoutDuration. EnableIpRangeAddress Enable or disable IP range address. IpRangeAddress IP rage address to be used.
PAGE 39
Table 16. Attributes (continued) Attribute Description UserTypeId Type of user. DirectoryServiceId Directory service ID. Description Description for the user. Name Name of the user. This name is the same as user name. Password Password for the user. When retrieving the details, Password is displayed as blank. UserName User name of the account. RoleId Role for the account. Locked Indicates if the account is locked or unlocked. IsBuiltin Indicates if the account is an in-built account.
PAGE 40
Table 17. Attributes Attribute Description Id Uniquely identifies the resource within the collection. UserTypeId Type of user. DirectoryServiceId Directory service ID. Description Description for the user. Name Name of the user. This name is the same as user name. Password Password for the user. When retrieving the details, Password is displayed as blank. UserName User name of the account. RoleId Role for the account. Locked Indicates if the account is locked or unlocked.
PAGE 41
Table 18. Attributes Attribute Description Id Uniquely identifies the resource within the collection. UserTypeId Type of user. DirectoryServiceId Directory service ID. Description Description for the user. Name Name of the user. This name is the same as user name. Password Password for the user. When retrieving the details, Password is displayed as blank. UserName User name of the account. RoleId Role for the account. Locked Indicates if the account is locked or unlocked.
PAGE 42
Table 19. Attributes Attribute Description Id Uniquely identifies the resource within the collection. UserTypeId Type of user. DirectoryServiceId Directory service ID. Description Description for the user. Name Name of the user. This name is the same as user name. Password Password for the user. When retrieving the details, Password is displayed as blank. UserName User name of the account. RoleId Role for the account. Locked Indicates if the account is locked or unlocked.
PAGE 43
} ] } "Id": 3214, "UserId": 3164, "RoleId": 10, "Entities": [ 64 ] Table 21. Attributes Attribute Description Id Permission record ID. UserId Account ID for which permissions are retrieved. RoleId Role ID of the account. Entities List of entities that the account has access to. /api/AccountService/Actions/AccountService.GetPrivileges This URI represents the list of privileges for a user for a device. POST method for /api/AccountService/Actions/ AccountService.
PAGE 44
Example request body { "UserId":"100", "MacAddress":"d0:94:66:34:b7:de" } /api/AccountService/Actions/AccountService.GetUserDetail This API returns details of the user who has logged in. POST method for /api/AccountService/Actions/ AccountService.GetUserDetail This method returns details of the user who has logged in. The details include user name, user ID, and role details. Description Returns details the user who has logged in.
PAGE 45
/api/AccountService/Actions/AccountService.Disable This URI enables you to disable multiple accounts. POST method for AccountService.Disable This method disables multiple accounts. Description Disables multiple accounts. Privilege SECURITY_SETUP HTTP response codes 204 Example request body { } "AccountIds":[3164,3264] Table 23. Attributes Attribute Description AccountIds Account IDs to be disabled. /api/AccountService/Actions/AccountService.
PAGE 46
/api/AccountService/Roles This URI represents the user roles. GET method for Roles This method returns a list of roles and the respective privileges. Description Returns a list of user roles and respective privileges. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "$metadata#Collection(AccountService.Role)", "@odata.count": 5, "value": [ { "@odata.
PAGE 47
/api/AccountService/Roles(Id) This URI represents the details of a user role. GET method for Roles(Id) This method returns the details of a user role. Description Returns the details of a user role. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "$metadata#Collection(AccountService.Role)", "@odata.count": 5, "value": [ { "@odata.
PAGE 48
/api/AccountService/ExternalAccountProvider This URI represents the collection of external account providers. GET method for ExternalAccountProvider This method returns the details of the default LDAP and AD ports and network timeouts. Description Returns the LDAP and AP ports and network timeouts. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "$metadata#ExternalAccountProvider.ExternalAccountProvider/$entity", "@odata.
PAGE 49
/api/AccountService/ExternalAccountProvider/ DirectoryServiceType This URI represents the collection of directory types. GET method for DirectoryServiceType This method returns the collection of directory types. Description Returns a collection of directory types. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "$metadata#Collection(ExternalAccountProvider.DirectoryServiceType)", "@odata.
PAGE 50
{ "@odata.context": "$metadata#Collection(ExternalAccountProvider.ADAccountProvider)", "@odata.count": 1, "value": [ { "@odata.id": "/api/AccountService/ExternalAccountProvider/ ADAccountProvider(1264)", "Id": 1264, "Name": "Dell Servers", "ServerType": "MANUAL", "ServerName": [ "ausdc12amer29.amer.dell.
PAGE 51
} "UserName": "test", "Password": null, "ServerPort": 3268, "NetworkTimeOut": 300, "SearchTimeOut": 300, "CertificateValidation": false, "CertificateFile": null Table 29. Attributes Attribute Description Id Active Directory or LDAP server ID. ServerType Server type of the directory—DNS or Manual. ServerName Server name of the directory service. UserName User name of the directory service. Password Password of the directory service. ServerPort Port of the directory Service.
PAGE 52
"Password": "XXXXXX", "ServerPort": 3268, "SsoEnablement": false, "KerberosFile": null, "NetworkTimeOut": 120, "SearchTimeOut": 120, "CertificateValidation": false, "CertificateFile": null, "Groups": [ { "@odata.id": "/api/AccountService/ExternalAccountProvider/ ADAccountProvider(1264)/Groups" } ] } ] } PUT method for ADAccountProvider(Id) This method updates the details of a specific Active Directory server in the collection. Description Updates the details of a specific Active Directory server.
PAGE 53
Table 30. Attributes (continued) Attribute name Description ServerType Server type of the directory—DNS or Manual. ServerName Server name of the directory service. UserName User name of the directory service. Password Password of the directory service. ServerPort Port of the directory service. NetworkTimeOut Network timeout value. SearchTimeOut Search timeout value. CertificateValidation Enable or disable certificate validation for the directory service.
PAGE 54
} "SearchTimeOut": 300, "CertificateValidation": false, "CertificateFile": null Example for Example request body ServerType: DNS { "Name": "AD", "ServerType": "DNS", "ServerName": [ ], "DnsServer": [ "dell.com" ], "GroupDomain": "dell.
PAGE 55
Table 31. Attributes (continued) Attribute name Description Password Password of the directory service. ServerPort Port of the directory service. NetworkTimeOut Network timeout value. SearchTimeOut Search timeout value. CertificateValidation Enable or disable certificate validation for the directory service. CertificateFile Certificate file for authentication. /api/AccountService/ExternalAccountProvider/ LDAPAccountProvider This URI represents the collection of LDAP Directory Services.
PAGE 56
} ] POST method for LDAPAccountProvider This method adds an LDAP Directory Service. Description Adds an LDAP Directory Service. Privilege SECURITY_SETUP HTTP response codes 200 Example request body { } Example response body { } "Name": "seaquest", "Id":1, "ServerType": "DNS", "ServerName": ["10.35.195.
PAGE 57
Table 32. Attributes (continued) Attribute name Description Password Password of the directory service. BaseDistinguishedName Domain names for search base. Example: dc=dell, dc=com. AttributeUserLogin User login details. AttributeGroupMembership Group member information. SearchFilter Search type. NetworkTimeOut Network timeout value. SearchTimeOut Search timeout value. CertificateValidation Enable or disable certificate validation for the directory service.
PAGE 58
} ] PUT method for LDAPAccountProvider(Id) This method updates the details of a server of the LDAP Directory Service. Description Updates the details of an LDAP server. Privilege SECURITY_SETUP HTTP response codes 200 Example request body { } Example response body { } "Name": "seaquest", "Id":2964, "ServerType": "DNS", "ServerName": ["10.35.195.
PAGE 59
Table 33. Attributes (continued) Attribute name Description BaseDistinguishedName Domain names for search base. Example: dc=dell, dc=com. AttributeUserLogin User login details. AttributeGroupMembership Group member information. SearchFilter Search type. NetworkTimeOut Network timeout value. SearchTimeOut Search timeout value. CertificateValidation Enable or disable certificate validation for the directory service. CertificateFile Certificate file for authentication.
PAGE 60
} "Password": null, "ServerPort": 636, "BaseDistinguishedName": "dc=dell,dc=com", "AttributeUserLogin": null, "AttributeGroupMembership": null, "SearchFilter": null, "NetworkTimeOut": 300, "SearchTimeOut": 300, "CertificateValidation": false, "CertificateFile": "" Example for Example request body ServerType: DNS { "Name": "LDAP", "ServerType": "DNS", "ServerName": [ ], "DnsServer": [ "dell.
PAGE 61
} "CertificateValidation": false, "CertificateFile": "" Table 34. Attributes Attribute name Description Id ID of the LDAP account provider. Name Directory name. ServerType Server type of the directory—DNS or Manual. ServerName Server name of the directory service. UserName User name of the directory service. Password Password of the directory service. BaseDistinguishedName Domain names for search base. Example: dc=dell, dc=com. AttributeUserLogin User login details.
PAGE 62
] } "DomainComponent": [], "ObjectGuid": "87da9d36-116c-405d-ae3f-054574e91af4" Table 35. Attributes Attribute name Description CommonName Common name of the directory service. OrganizationalUnit Organization unit of the directory service. DistinguishedName Distinguished name of the directory service. DomainComponent Domain name of the directory service. ObjectGuid Unique ObjectGuid for the group. /api/AccountService/ExternalAccountProvider/Actions/ ExternalAccountProvider.
PAGE 63
HTTP response codes Example Request Body 200 [ { ] Example Response Body [ { }, { ] } "UserTypeId": 2, "DirectoryServiceId": 0, "Description": "admin", "Name": "MSMMegatronTeam", "Password": "", "UserName": "MSMMegatronTeam", "RoleId": "10", "Locked": false, "Enabled": true, "ObjectGuid": "d22005b6-0ce5-40ed-88d0-7f7759b52f25" }, { "UserTypeId": 2, "DirectoryServiceId": 0, "Description": "admin", "Name": "MSMDevelopmentTeam", "Password": "", "UserName": "MSMDevelopmentTeam", "RoleId": "10", "Lock
PAGE 64
Table 37. Attributes Attribute name Description Id Unique identifier of the resource within the collection. UserTypeId Type of user. DirectoryServiceId ID of the directory service. Description Description for this user. Name Name of the user. This value is the same as the user name. Password Password for the user. The password is not displayed while retrieving the details. UserName Username of the account. RoleId Role for the account. Locked Indicates if the account is locked.
PAGE 65
/api/ApplicationService/Security/SecurityConfiguration This URI represents the security configuration. GET method for SecurityConfiguration This method returns the security configuration. Description Returns the security configuration. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "/api/ $metadata#ApplicationService.FIPSModeConfiguration/$entity", "@odata.type": "#ApplicationService.FIPSModeConfiguration", "@odata.
PAGE 66
} ] } } "Locality": "Round Rock", "State": "TX", "Country": "US", "Email": "support@dell.com" Table 38. Attributes Attribute name Description Value.ValidFrom Date from which the certificate is valid. Value.ValidTo Date till which the certificate is valid. Value.IssuedBy Who the certificate is issued by. Value.IssuedBy.DistinguishedName Distinguished name of the certificate issuer. Value.IssuedBy.DepartmentName The department which issued the certificate. Value.IssuedBy.
PAGE 67
} Example response body "State": "Texas", "Country": "US", "Email": "", -----BEGIN CERTIFICATE REQUEST----MIIB/jCCAWcCAQAwgZgxCzAJBgNVBAYTAlVTMQswCQYDVQQIEwJUWDETMBEGA1UE BxMKUm91bmQgUm9jazENMAsGA1UEChMERGVsbDEWMBQGA1UECxMNUHJvZHVjdCBH cm91cDEVMBMGA1UEAxMMMTcyLjE3LjEuMjA0MSkwJwYJKoZIhvcNAQkBFhprYXRo bGVlbl9oYXR0YXdheUBkZWxsLmNvbTCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkC gYEAwTiSPpKcMV+rJM6lHhsAuW6LvQ4MMQmAqPnE75sJn9fV2sXQPpO1TzwlD5hu DdcCvVeU9nzAZ3oR0Xc2mp28zw/4oBbsje01dLAC0PxDFzQswLFhri9kCHrnGc4Q ZZjn06u+QFf9R
PAGE 68
/api/AccountService/ExternalAccountProvider/Actions/ ExternalAccountProvider.DSCertificate Gets the details of the uploaded certificate for AD or LDAP Directory Services. Gets the details of the uploaded certificate for AD or LDAP Directory Services. When you click See details for that particular Directory Service, a pop is displayed with the certificate Serial Number, Issuer CN, Subject CN , and validity dates.
PAGE 69
}, { }, { }, { } ] } "DestinationAddress": "100.97.1.185", "PortNumber": 162, "Version": "SNMPV2", "SnmpV1V2Credential": { "Community": "public" } "Id": 2, "Enabled": true, "DestinationAddress": "100.97.1.185", "PortNumber": 162, "Version": "SNMPV2", "SnmpV1V2Credential": { "Community": "public" } "Id": 3, "Enabled": false, "DestinationAddress": "100.97.1.185", "PortNumber": 162, "Version": "SNMPV2", "SnmpV1V2Credential": { "Community": "public" } "Id": 4, "Enabled": true, "DestinationAddress": "100.
PAGE 70
api/AlertService/AlertDestinations/Actions/ AlertDestinations.ApplySNMPConfig POST method for AlertDestinations.ApplySNMPConfig This method configures SNMP. Description Configures SNMP. Privilege MONITORING_SETUP HTTP response codes 200 Example request body [ { { }, { }, { ] } "Enabled": true, "DestinationAddress": "100.97.1.185", "PortNumber": "162", "Version": "SNMPV2", "SnmpV1V2Credential": { "Community": "public" } }, "Enabled": true, "DestinationAddress": "100.97.1.
PAGE 71
}, { }, { }, { ] } "Id": 2, "Enabled": true, "DestinationAddress": "100.97.1.185", "PortNumber": 162, "Version": "SNMPV2", "SnmpV1V2Credential": { "Community": "public" }, "SnmpV3Credential": null "Id": 3, "Enabled": false, "DestinationAddress": "100.97.1.185", "PortNumber": 162, "Version": "SNMPV2", "SnmpV1V2Credential": { "Community": "public" }, "SnmpV3Credential": null "Id": 4, "Enabled": true, "DestinationAddress": "100.97.1.
PAGE 72
Example response body { "@odata.context": "$metadata#Collection(AlertDestinations.SyslogConfiguration)", "@odata.count": 4, "value": [ { "Id": 1, "Enabled": true, "DestinationAddress": "100.97.10.17", "PortNumber": 514 }, { "Id": 2, "Enabled": true, "DestinationAddress": "100.97.10.17", "PortNumber": 514 }, { "Id": 3, "Enabled": true, "DestinationAddress": "10.19.12.1", "PortNumber": 514 }, { "Id": 4, "Enabled": true, "DestinationAddress": "100.97.1.23", "PortNumber": 514 } ] } Table 42.
PAGE 73
}, { }, { }, { ] Example response body [ } { }, { }, { }, { ] } "Enabled": true, "DestinationAddress": "100.97.10.17", "PortNumber": 514 "Enabled": true, "DestinationAddress": "100.97.10.17", "PortNumber": 514 "Enabled": true, "DestinationAddress": "10.19.12.1", "PortNumber": 514 "Enabled": true, "DestinationAddress": "100.97.1.23", "PortNumber": 514 "Id": 1, "Enabled": true, "DestinationAddress": "100.97.10.17", "PortNumber": 514 "Id": 2, "Enabled": true, "DestinationAddress": "100.97.10.
PAGE 74
/api/AlertService/AlertDestinations/SMTPConfiguration This URI represents the SMTP configuration. GET method for SMTPConfiguration This method returns a collection of SMTP configuration. Description Returns a collection of SMTP configuration. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "$metadata#Collection(AlertDestinations.SMTPConfiguration)", "@odata.count": 1, "value": [ { "DestinationAddress": "10.35.12.
PAGE 75
Example response body { } "DestinationAddress": "10.35.12.7", "PortNumber": 25, "UseCredentials": false, "UseSSL": false, "Credential": null Table 45. Attributes Attribute name Description DestinationAddress Destination address of SMTP. PortNumber Port number of SMTP. UseCredentials Indicates if credentials are used. UseSSL Indicates if SSL is used. User User name Password Password /api/AlertService/AlertDestinations/Actions/ AlertDestinations.
PAGE 76
5 Alerts Topics: • • • Alert logs Alert policies Alert definitions Alert logs /api/AlertService/Alerts This URI represents the alerts. Table 47. Filters Filter name Description Top Top records to return. Default value is 100. Skip Max records to skip. Default value is 0. Orderby Order to apply to the output. Id Filter by event ID. Default value is 0. AlertDeviceId Filter by device ID. Default value is 0. AlertDeviceIdentifier Filter by device identifier.
PAGE 77
Example response body { } "@odata.context": "$metadata#Collection(AlertService.Alert)", "@odata.count": 11, "value": [ { "@odata.id": "/api/AlertService/Alerts(2)", "Id": 2, "SeverityType": 16, "SeverityName": "Critical", "AlertDeviceId": 1714, "AlertDeviceName": "localhost.smd.devops.dell.com", "AlertDeviceType": 1000, "AlertDeviceIpAddress": "xx.xx.xx.
PAGE 78
Table 48. Attributes (continued) Attribute name Description StatusType ID of status type. StatusName Name of status type. TimeStamp Date and time when the alert was raised. Message Message describing the issue. EemiMessage Event and Error Message describing the issue, if applicable. RecommendedAction Recommended action for the alert. AlertMessageId Event and Alert Message ID associated with the issue. AlertVarBindDetails List of variable bindings of the alert, if applicable.
PAGE 79
{ "@odata.type": "#AlertService.Alert", "@odata.id": "/api/AlertService/Alerts(4592)", "Id": 4592, "SeverityType": 2, "SeverityName": "Info", "AlertDeviceId": 10056, "AlertDeviceName": "Sled-5", "AlertDeviceType": 1000, "AlertDeviceIpAddress": "100.97.211.
PAGE 80
{"@odata.type": "#AlertService.Alert", Alerts(4587)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4586)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4585)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4584)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4583)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4582)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4581)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4580)",…}, {"@odata.type": "#AlertService.
PAGE 81
{"@odata.type": "#AlertService.Alert", Alerts(4551)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4550)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4549)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4548)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4547)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4546)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4545)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4544)",…}, {"@odata.type": "#AlertService.
PAGE 82
{"@odata.type": "#AlertService.Alert", "@odata.id": "/api/AlertService/ Alerts(4515)",…}, {"@odata.type": "#AlertService.Alert", "@odata.id": "/api/AlertService/ Alerts(4514)",…}, {"@odata.type": "#AlertService.Alert", "@odata.id": "/api/AlertService/ Alerts(4513)",…}, {"@odata.type": "#AlertService.Alert", "@odata.id": "/api/AlertService/ Alerts(4512)",…}, {"@odata.type": "#AlertService.Alert", "@odata.id": "/api/AlertService/ Alerts(4511)",…}, {"@odata.type": "#AlertService.Alert", "@odata.
PAGE 83
"value":[ { "@odata.type": "#AlertService.Alert", "@odata.
PAGE 84
Alerts(4299)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4298)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4297)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4296)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4293)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4292)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4291)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4290)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4289)",…}, {"@odata.type": "#AlertService.
PAGE 85
Alerts(4065)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4064)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4063)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4062)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4061)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4060)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4059)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4058)",…}, {"@odata.type": "#AlertService.Alert", Alerts(4057)",…}, {"@odata.type": "#AlertService.
PAGE 86
Alerts(3755)",…}, {"@odata.type": "#AlertService.Alert", "@odata.id": "/api/AlertService/ Alerts(3754)",…}, {"@odata.type": "#AlertService.Alert", "@odata.id": "/api/AlertService/ Alerts(3753)",…}, {"@odata.type": "#AlertService.Alert", "@odata.id": "/api/AlertService/ Alerts(3752)",…}, {"@odata.type": "#AlertService.Alert", "@odata.id": "/api/AlertService/ Alerts(3751)",…}, {"@odata.type": "#AlertService.Alert", "@odata.id": "/api/AlertService/ Alerts(3750)",…}, {"@odata.type": "#AlertService.
PAGE 87
"@odata.count": 0, "value":[ ] } /api/AlertService/Alerts(Id) This URI represents a specific alert. GET method for Alerts(Id) This method returns the details of a specific alert. Description Returns the details of a specific alert. Privilege VIEW HTTP response codes 200 Example response body { } "@odata.context": "$metadata#AlertService.Alert/$entity", "@odata.
PAGE 88
Table 49. Attributes (continued) Attribute name Description AlertDeviceIpAddress IP address of device. AlertDeviceMacAddress MAC address of device. AlertDeviceIdentifier Identifier or Service Tag of device. AlertDeviceAssetTag Asset tag of device. DefinitionId ID of the definition associated to the alert. CatalogName Catalog name associated to alert. CategoryId Category ID associated to alert. CategoryName Category name associated to alert.
PAGE 89
}, { } } ] } "SubCategoryDetails": [ { "Id": 7500, "Name": "Online Status "Description": "Online }, { "Id": 7400, "Name": "Health Status "Description": "Health } ] of Managed device", Status of Managed device" of Managed device", Status of Managed device" "Id": 1003, "Name": "Audit", "CatalogName": "Application", "SubCategoryDetails": [ { "Id": 7600, "Name": "Device Compliance", "Description": "Device Compliance" } ] Table 50.
PAGE 90
Example response body { } "@odata.context": "$metadata#AlertService.AlertCategories/$entity", "@odata.
PAGE 91
{ }, { }, { }, { }, { } ] } "@odata.id": "/api/AlertService/AlertSeverities(1)", "Id": 1, "Name": "Unknown", "Description": "Unknown" "@odata.id": "/api/AlertService/AlertSeverities(2)", "Id": 2, "Name": "Info", "Description": "Info" "@odata.id": "/api/AlertService/AlertSeverities(4)", "Id": 4, "Name": "Normal", "Description": "Normal" "@odata.id": "/api/AlertService/AlertSeverities(8)", "Id": 8, "Name": "Warning", "Description": "Warning" "@odata.
PAGE 92
Table 53. Attributes Attribute name Description Id ID of the severity. Name Name of the severity Description Description of the severity. /api/AlertService/AlertStatuses This URI represents the statuses for an alert. GET method for AlertStatuses This method returns all possible statues that are applicable to an alert. Description Returns all the possible alert statues. Privilege VIEW HTTP response codes 200 Example response body { } "@odata.context": "$metadata#Collection(AlertService.
PAGE 93
Privilege VIEW HTTP response codes 200 Example response body { } "@odata.context": "$metadata#AlertService.AlertStatus/$entity", "@odata.id": "/api/AlertService/AlertStatuses(1000)", "Id": 1000, "Name": "Acknowledged", "Description": "The event was acknowledged" Table 55. Attributes Attribute name Description Id ID of the alert status. Name Name of the alert status Description Description of the alert status.
PAGE 94
}, { } } "CatalogName": "iDRAC", "InternalName": "IDRAC-MIB-SMIv2", "ReleaseVersion": "v3.3", "IsBuiltIn": true, "IsVisible": true "@odata.id": "/api/AlertService/AlertCatalogs(1002)", "Id": 1002, "CatalogName": "iDRAC", "InternalName": "MIB-Dell-10909", "ReleaseVersion": "9.0.0", "IsBuiltIn": true, "IsVisible": true Table 57. Attributes Attribute name Description Id Catalog ID. CatalogName Name of the catalog. InternalName Internal name associated with the catalog.
PAGE 95
Table 58. Attributes (continued) Attribute name Description InternalName Internal name associated with the catalog. ReleaseVersion Catalog version. IsBuiltIn Indicates if the catalog in built-in or is manually included. IsVisible Indicates if the catalog is visible or hidden. /api/AlertService/Events This URI represents the events. POST method for Events This method creates an event. Description Creates a Redfish event.
PAGE 96
} } "DeviceIds": [0], "DeviceType": 0, "Severity": 0, "StatusType": 1000, "StartDate": "", "EndDate": "", "SourceName": "", "Category": 0, "SubCategory": 0, "Message": "" Table 59. Attributes Attribute Description AlertIds List of alert IDs. This value is an empty list when AllAlerts is True. AllAlerts True or False. Determines if action should be taken for all alerts. Filters Optional filters to specify when AllAlerts is True. DeviceIds List of IDs of devices. DeviceType Device type ID.
PAGE 97
} } "AlertIds": [100,200,300], "AllAlerts": true, "Filters": { "DeviceIds": [0], "DeviceType": 0, "Severity": 0, "StatusType": 1000, "StartDate": "", "EndDate": "", "SourceName": "", "Category": 0, "SubCategory": 0, "Message": "" Table 60. Attributes Attribute Description AlertIds List of alert IDs. This value is an empty list when AllAlerts is True. AllAlerts True or False. Determines if action should be taken for all alerts. Filters Optional filters to specify when AllAlerts is True.
PAGE 98
Example request body { } "AlertIds": [100,200,300], "AllAlerts": true, "Filters": { "DeviceIds": [0], "DeviceType": 0, "Severity": 0, "StatusType": 1000, "StartDate": "", "EndDate": "", "SourceName": "", "Category": 0, "SubCategory": 0, "Message": "" } Table 61. Attributes Attribute Description AlertIds List of alert IDs. This value is an empty list when AllAlerts is True. AllAlerts True or False. Determines if action should be taken for all alerts.
PAGE 99
Table 62. Filters (continued) Filter name Description Visible Filter by visible state—True or False. GET method for AlertPolicies This method returns the policies that are created. Description Returns all the policies. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "$metadata#Collection(AlertService.AlertPolicy)", "@odata.count": 1, "value": [ { "@odata.
PAGE 100
"PolicyActions": [ { "@odata.id": "/api/AlertService/AlertPolicies(314)/ PolicyActions" } ], "PolicyCriteria": [ { "@odata.id": "/api/AlertService/AlertPolicies(314)/ PolicyCriteria" } ] } ] } Table 63. Attributes Attribute name Description Id Event record ID. Name Name associated with the policy. Description Description associated with the policy. Enabled Indicates if the policy is enabled or disabled. DefaultPolicy Indicates if the policy is the default policy or pre-seeded.
PAGE 101
Table 63. Attributes (continued) Attribute name Description Id ID of action. Name Name associated with the action. ParameterDetails Extra parameters that can be used for the action. TemplateId ID of the template associated with the action. PolicyActions Link to the list of actions that can be triggered for the policy. PolicyCriteria Link to the criteria for the evaluation of the alert contents with the policy contents.
PAGE 102
}, { }, { "Value": "test@dell.com" "Name": "from", "Value": "MCSIApplication@Dell.
PAGE 103
"Id": 3, "Name": "Email", "ParameterDetails": [ { "Name": "subject", "Value": "Device Name: $name, Device IP Address: $ip, Severity: $severity", "Type": "string", "TypeParams": [ { "Name": "maxLength", "Value": "255" } ] }, { "Name": "to", "Value": "test@dell.com", "Type": "string", "TypeParams": [ { "Name": "maxLength", "Value": "255" } ] }, { "Name": "from", "Value": "MCSIApplication@Dell.
PAGE 104
Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "$metadata#AlertService.AlertPolicy/$entity", "@odata.id": "/api/AlertService/AlertPolicies(314)", "Id": 314, "Name": "Default OnDemand Health Policy", "Description": "This policy is applicable to all devices. A health task will be triggered if category is for system health.
PAGE 105
Table 64. Attributes Attribute name Description Id Event record ID. Name Name associated with the policy. Description Description associated with the policy. Enabled Indicates if the policy is enabled or disabled. DefaultPolicy Indicates if the policy is the default policy or pre-seeded. State State associated with the policy. Visible Indicate if the policy is visible or hidden. PolicyData CatalogName Name of the catalogs associated with the policy.
PAGE 106
PUT method for AlertPolicies(Id) This method updates a policy. Description Updates a policy.
PAGE 107
} Example response body "State": true { "Id": 4114, "Name": "Policy Test1", "Description": "Policy Test1", "Enabled": true, "DefaultPolicy": false, "Editable": true, "Visible": true, "PolicyData": { "Catalogs": [ { "CatalogName": "iDRAC", "Categories": [ 0 ], "SubCategories": [ 0 ] }, { "CatalogName": "Application", "Categories": [ 0 ], "SubCategories": [ 0 ] } ], "Severities": [ 16, 1, 2, 4, 8 ], "Devices": [ 1914 ], "DeviceTypes": [ 1000 ], "Groups": [], "Schedule": { "StartTime": "2016-06-06 15:02:46
PAGE 108
}, { }, { "Name": "to", "Value": "test@dell.com", "Type": "string", "TypeParams": [ { "Name": "maxLength", "Value": "255" } ] "Name": "from", "Value": "MCSIApplication@Dell.
PAGE 109
Table 65. Attributes (continued) Attribute name Description Severities List of severities associated to the policy. This field is validated during policy evaluation. Devices List of devices associated to the policy. This field is validated during policy evaluation. DevicesTypes List of devices types associated to the policy. Groups List of groups associated to the policy. This field is validated during policy evaluation. Schedule StartTime Start event-time to verify.
PAGE 110
GET method for PolicyCriteria This method returns the criteria that are used for matching the policy with incoming events. Description Returns the criteria used for matching the policy with incoming events. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "$metadata#Collection(AlertService.PolicyCriterion)", "@odata.count": 1, "value": [ { "@odata.
PAGE 111
Example response body { "@odata.context": "$metadata#AlertService.PolicyCriterion/$entity", "@odata.id": "/api/AlertService/AlertPolicies(314)/PolicyCriteria(4)", "Id": 4, "PolicyId": 314, "Parameter": "", "Value": "(catalogName == 'iDRAC' AND categoryId==3300) AND (severityType==1 OR severityType==2 OR severityType==4 OR severityType==8 OR severityType==16)", "Type": 3, "TypeName": "EXPRESSION", "ComparisonType": 3, "ComparisonTypeName": "Equal" } Table 68.
PAGE 112
"@odata.context": "$metadata#Collection(AlertService.PolicyAction)", "@odata.count": 1, "value": [ { "@odata.id": "/api/AlertService/AlertPolicies(314)/ PolicyActions(1)", "Id": 1, "PolicyId": 314, "Name": "OnDemandHealth", "Parameters": "", "TemplateId": 80, "Template": { "Id": 80, "Name": "OnDemandHealth", "Description": "OnDemandHealth", "Disabled": false, "ParameterDetails": [] } } ] } Table 70. Attributes Attribute name Description Id ID of the criteria.
PAGE 113
} "PolicyId": 314, "Name": "OnDemandHealth", "Parameters": "", "TemplateId": 80, "Template": { "Id": 80, "Name": "OnDemandHealth", "Description": "OnDemandHealth", "Disabled": false, "ParameterDetails": [] } Table 71. Attributes Attribute name Description Id ID of the criteria. PolicyId ID of the policy with which the action is associated. Name Name of the action. Parameters Extra parameter that can be added to the action. TemplateId ID of the action template associated with the action.
PAGE 114
{ }, { }, { }, { } ] } "@odata.id": "/api/AlertService/AlertActionTemplates(60)", "Id": 60, "Name": "Trap", "Description": "Trap", "Disabled": true, "ParameterDetails": [] "@odata.id": "/api/AlertService/AlertActionTemplates(90)", "Id": 90, "Name": "Syslog", "Description": "Syslog", "Disabled": true, "ParameterDetails": [] "@odata.id": "/api/AlertService/AlertActionTemplates(80)", "Id": 80, "Name": "OnDemandHealth", "Description": "OnDemandHealth", "Disabled": false, "ParameterDetails": [] "@odata.
PAGE 115
} "@odata.id": "/api/AlertService/AlertActionTemplates(50)", "Id": 50, "Name": "Email", "Description": "Email", "Disabled": true, "ParameterDetails": [] Table 73. Attributes Attribute name Description Id ID of the action template. Name Name of the action template. Description Extra description of the action template. Disabled Indicates if the template is enabled or disabled. ParameterDetails Extra parameter that the template can carry and apply. /api/AlertService/Actions/AlertService.
PAGE 116
Example request body Request: { "AlertPolicyIds": [100,200,300] } Or InRequestput: { "AllPolicies": true } /api/AlertService/Actions/AlertService.RemoveAlertPolicies POST method for AlertService.RemoveAlertPolicies This method removes the selected set of alert policies or all the alert policies. Description Removes the selected alerts policies.
PAGE 117
Table 74. Filters (continued) Filter name Description Severity Filter by severity. GET method for AlertMessageDefinitions This method returns the definitions for all alert messages. Description Returns the definitions for all alert messages. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "$metadata#Collection(AlertService.AlertMessageDefinition)", "@odata.count": 3, "value": [ { "@odata.
PAGE 118
Table 75. Attributes (continued) Attribute Description SubCategory Subcategory associated with the message. DetailedDescription Detailed description of the issue. /api/AlertService/AlertMessageDefinitions(Id) This URI represents a specific message definition. GET method for AlertMessageDefinitions(Id) This method returns the details of a specific message definition. Description Returns the definitions of a specific message.
PAGE 119
/api/AlertService/AlertMessageDefinitionsCategories This URI represents the alert definition categories. GET method for AlertMessageDefinitionsCategories This method returns the list of alert definition categories. Description Returns the alert definition categories. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "/api/ $metadata#Collection(AlertService.AlertMessageDefinitionCategory)", "@odata.count": 6, "value": [ {"@odata.type": "#AlertService.
PAGE 120
AlertMessageDefinitionsCategories('Audit')", "Category": "Audit", "SubCategoriesDetails": [ { "@odata.type": "#AlertService.AlertMessageDefinitionSubCategories", "SubCategory": "Debug" }, { "@odata.type": "#AlertService.AlertMessageDefinitionSubCategories", "SubCategory": "Devices" }, { "@odata.type": "#AlertService.AlertMessageDefinitionSubCategories", "SubCategory": "Fabric" }, { "@odata.type": "#AlertService.AlertMessageDefinitionSubCategories", "SubCategory": "Fan Event" }, { "@odata.
PAGE 121
}, { "@odata.type": "#AlertService.AlertMessageDefinitionSubCategories", "SubCategory": "Log Event" }, { "@odata.type": "#AlertService.AlertMessageDefinitionSubCategories", "SubCategory": "Management Module" }, { "@odata.type": "#AlertService.AlertMessageDefinitionSubCategories", "SubCategory": "Memory" }, { "@odata.type": "#AlertService.AlertMessageDefinitionSubCategories", "SubCategory": "Node" }, { "@odata.type": "#AlertService.
PAGE 122
"@odata.type": "#AlertService.AlertMessageDefinitionSubCategories", "SubCategory": "System Info" }, { "@odata.type": "#AlertService.AlertMessageDefinitionSubCategories", "SubCategory": "Temperature" }, { "@odata.type": "#AlertService.AlertMessageDefinitionSubCategories", "SubCategory": "UEFI Event" }, { "@odata.type": "#AlertService.AlertMessageDefinitionSubCategories", "SubCategory": "User Tracking" }, { "@odata.type": "#AlertService.
PAGE 123
6 Configure Topics: • • • • Firmware Deploy Identity pools Network Configuration Service Firmware /api/UpdateService/Catalogs This URI represents the catalogs in the appliance. GET method for Catalogs This method returns the catalogs that are created in the appliance. Description Returns the list of catalogs. Privilege VIEW HTTP response codes 200 Example request body { "@odata.context": "/api/$metadata#Collection(UpdateService.Catalogs)", "@odata.count": 1, "value": [ { "@odata.
PAGE 124
}, { }, { }, { }, { } ] } "BaselineName": "Single" "BaselineId": 11, "BaselineName": "500" "BaselineId": 6, "BaselineName": "Test" "BaselineId": 7, "BaselineName": "Test 100" "BaselineId": 8, "BaselineName": "Test 2500+" } ], "Repository": { "@odata.type": "#UpdateService.Repository", "Id": 12, "Name": "Dell", "Description": "", "Source": "downloads.dell.com", "DomainName": null, "Username": null, "Password": null, "CheckCertificate": false, "RepositoryType": "DELL_ONLINE" } Table 77.
PAGE 125
Table 77. Attributes (continued) Attribute Description BaselineId Identifier of a baseline associated with the catalog. BaselineName Name of a baseline associated with the catalog. Name Name of the repository. Description User provided description for the repository. Source URL or location of the repository. DomainName Domain for the user credentials (CIFS only). Username Username to access the share containing the catalog (CIFS / HTTPS).
PAGE 126
Privilege VIEW HTTP response codes 200 Example response body { } "@odata.context": "/api/$metadata#UpdateService.Catalogs/$entity", "@odata.type": "#UpdateService.Catalogs", "@odata.id": "/api/UpdateService/Catalogs(28)", "Id": 28, "Filename": "CatalogA00.xml", "SourcePath": "cifs/compute", "Status": "Completed", "TaskId": 26960, "BaseLocation": "", "ManifestIdentifier": "", "ReleaseIdentifier": "8217fadb-ec37-46a4-b7ba-56a353dbf3d2", "ManifestVersion": null, "ReleaseDate": "2018-05-21 05:33:25.
PAGE 127
} "ManifestVersion": null, "ReleaseDate": "2018-05-21 05:33:25.000", "LastUpdated": "2018-09-10 03:26:51.362", "BundlesCount": 3, "PredecessorIdentifier": "", "AssociatedBaselines": [ { "BaselineId": 12, "BaselineName": "cifs1" } ], "Repository": { "@odata.type": "#UpdateService.
PAGE 128
"Type": { "Id": 6000, "Name": "GROUP" } } ], "ComplianceSummary": { "ComplianceStatus": "CRITICAL", "NumberOfCritical": 7761, "NumberOfWarning": 1, "NumberOfNormal": 12, "NumberOfDowngrade": 1 }, "DeviceComplianceReports@odata.navigationLink": "/api/ UpdateService/Baselines(8)/DeviceComplianceReports" } ] } Table 78. Attributes Attribute Description Name Name of the Baseline. Description Description of the Baseline. CatalogId ID of the catalog. RepositoryId ID of the repository.
PAGE 129
Example request body { "Name": "HTTP", "Description": "HTTP", "CatalogId": 22, "RepositoryId": 12, "RepositoryName": "HTTP", "RepositoryType": "HTTP", "DowngradeEnabled": true, "Is64Bit": true, "Targets": [ { "Id": 500, "Type": { "Id": 6000, "Name": "GROUP" } } ] } { "Name": "HTTP1", "Description": "HTTP1", "CatalogId": 22, "RepositoryId": 12, "RepositoryName": "HTTP", "RepositoryType": "HTTP", "DowngradeEnabled": true, "Is64Bit": true, "Targets": [ { "Id": 25015, "Type": { "Id": 1000, "Name": "DEVICE"
PAGE 130
}, { }, { }, { }, { }, { } ] } ] } } "Name": "DEVICE" "Id": 25023, "Type": { "Id": 1000, "Name": "DEVICE" } "Id": 25032, "Type": { "Id": 1000, "Name": "DEVICE" } "Id": 25033, "Type": { "Id": 1000, "Name": "DEVICE" } "Id": 25035, "Type": { "Id": 1000, "Name": "DEVICE" } "Id": 25038, "Type": { "Id": 1000, "Name": "DEVICE" } Table 79.
PAGE 131
Table 79. Attributes (continued) Attribute Description Type Id ID for the device type. You can determine the DeviceType IDs can be determined through /api/DeviceService/ DeviceType Name Type of the target (DEVICE or GROUP). api/UpdateService/Baselines(Id) This URI represents a specific baseline. GET method for Baselines(Id) This method returns the details of a specific baseline. Description Returns details of a specific baseline.
PAGE 132
}, { }, { }, { }, { }, { } "Id": 25031, "Type": { "Id": 1000, "Name": "DEVICE" } "Id": 25033, "Type": { "Id": 1000, "Name": "DEVICE" } "Id": 25035, "Type": { "Id": 1000, "Name": "DEVICE" } "Id": 25580, "Type": { "Id": 1000, "Name": "DEVICE" } "Id": 25585, "Type": { "Id": 1000, "Name": "DEVICE" } } ], "ComplianceSummary": { "ComplianceStatus": "OK", "NumberOfCritical": 0, "NumberOfWarning": 0, "NumberOfNormal": 9, "NumberOfDowngrade": 0 }, "DeviceComplianceReports@odata.
PAGE 133
"Name": "Test 2500+", "Description": "", "CatalogId": 22, "RepositoryId": 12, "TaskId": 27734, "RepositoryName": "Dell", "RepositoryType": "DELL_ONLINE", "LastRun": "2018-08-08 21:22:36.858", "DowngradeEnabled": true, "Is64Bit": true, "Targets": [ { "Id": 1010, "Type": { "Id": 6000, "Name": "GROUP" } } ], "ComplianceSummary": { "ComplianceStatus": "CRITICAL", "NumberOfCritical": 7761, "NumberOfWarning": 1, "NumberOfNormal": 12, "NumberOfDowngrade": 1 }, "DeviceComplianceReports@odata.
PAGE 134
api/UpdateService/FirmwareBaselineSummary This API represents the firmware baseline information. GET method for baseline summary This API returns the total number of baselines that meet a specific compliance status. Description Returns the total number of baselines that meet a specific compliance status. Privilege VIEW HTTP response code 200 Example response body { "@odata.context": "/api/ $metadata#Collection(UpdateService.SummaryCount)", "@odata.count": 1, "value":[ { "@odata.
PAGE 135
Privilege HTTP response code Example response body 200 { "@odata.context": "/api/ $metadata#Collection(UpdateService.ComplianceStatus)", "@odata.count": 4, "value":[ { "@odata.type": "#UpdateService.ComplianceStatus", "@odata.id": "/api/UpdateService/ComplianceStatuses(1)", "StatusId": 1, "StatusName": "OK" }, { "@odata.type": "#UpdateService.ComplianceStatus", "@odata.id": "/api/UpdateService/ComplianceStatuses(2)", "StatusId": 2, "StatusName": "DOWNGRADE" }, { "@odata.type": "#UpdateService.
PAGE 136
"@odata.id": "/api/UpdateService/Baselines(9)/ DeviceComplianceReports(9523)", "Id": 9523, "DeviceId": 25031, "ServiceTag": "JP00002", "DeviceModel": "PowerEdge MX740c", "DeviceTypeName": "SERVER", "DeviceName": "iDRAC-JP00002", "FirmwareStatus": "Compliant", "ComplianceStatus": "OK", "DeviceTypeId": 1000, "RebootRequired": false, "ComponentComplianceReports@odata.navigationLink": "/api/ UpdateService/Baselines(9)/DeviceComplianceReports(9523)/ ComponentComplianceReports" } ] } Table 80.
PAGE 137
"@odata.id": "/api/UpdateService/Baselines(6)/ DeviceComplianceReports(1)", "Id": 1, "DeviceId": 10069, "ServiceTag": "7BU0772", "DeviceModel": "PowerEdge MX7000", "DeviceTypeName": "CHASSIS", "DeviceName": "MX-7BU0772", "FirmwareStatus": "Compliant", "ComplianceStatus": "OK", "DeviceTypeId": 2000, "RebootRequired": true, "DeviceFirmwareUpdateCapable": true, "DeviceUserFirmwareUpdateCapable": true, "ComponentComplianceReports":[ { "@odata.type": "#UpdateService.
PAGE 138
Example response body A numeric token ID is returned. /api/UpdateService/Actions/UpdateService.RemoveFile POST method for RemoveFile This method removes a file from the system. Description Removes a file identified by the numeric token ID. Privilege DEVICE_UPDATE HTTP response codes 200 Example request body { } "FileToken": "1481131455800" /api/UpdateService/Actions/UpdateService.RefreshCatalogs This API refreshes catalog information. POST method for /api/UpdateService/Actions/ UpdateService.
PAGE 139
Example request body { } "CatalogIds":["12"] /api/UpdateService/Actions/UpdateService.RemoveBaselines POST method for RemoveBaselines This method deletes baselines. Description Deletes baselines. Privilege BASELINE_MANAGEMENT HTTP response codes 204 Example request body { } "BaselineIds":[13] /api/UpdateService/RollbackSoftwares This URI returns software rollback information. GET method for rollback software This method returns the software rollback information.
PAGE 140
} ] } "ComponentId": "159", "PCIDeviceId": null, "DeviceDescription": "BIOS", "CatalogId": 26, "RollbackSource": "Device" /api/UpdateService/Actions/UpdateService.GetSingleDupDetails POST method for GetSingleDupDetails This method returns the details of a specific Dell Update Package (DUP). Description Returns the details of a specific DUP.
PAGE 141
} Response: Example response body [ { "DeviceId": 1674, "DeviceReport": { "ComponentUpdateAction": "UPGRADE", "DeviceTypeId": "1000", "ComponentCurrentVersion": "2.10.10.10", "ComponentUriInformation": null, "DeviceTypeName": "SERVER", "ComponentVersion": "2.30.30.30", "ComponentCriticality": "Recommended", "DeviceId": "1674", "DeviceServiceTag": "JS8BDV1", "IsCompliant": "CRITICAL", "ComponentTargetIdentifier": "25227", "ComponentSourceName": "DCIM:INSTALLED#iDRAC.Embedded.
PAGE 142
] } } "DeviceModel": "PowerEdge T320", "ComponentName": "IDRAC @ Lifecycle Controller V.,2.30.30.30, A00" /api/UpdateService/Actions/ UpdateService.GetBaselinesReportByDeviceids POST method for GetBaselinesReportByDeviceids This method returns the baseline report for specific device IDs. Description Returns the baseline report for specific device IDs.
PAGE 143
] } ] } "ServiceTag": "testing", "DeviceModel": "POWEREDGE MX7000", "DeviceTypeId": 2000, "DeviceTypeName": "MX-testing", "DeviceName": null, "FirmwareStatus": "Compliant", "ComplianceStatus": "OK", "RebootRequired": false, "ComponentComplianceReports": [] /api/UpdateService/Actions/UpdateService.GetCertDetails POST method for GetCertDetails This method returns the details of a certificate. Description Returns the details of a certificate.
PAGE 144
Deploy /api/TemplateService/TemplateTypes This URI represents the types of templates. GET method for TemplateTypes This method returns information about each type of template, indicating the types of devices for which configuration is supported, such as chassis and servers. Description Returns information for each supported template type. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "/api/ $metadata#Collection(TemplateService.TemplateTypeModel)", "@odata.
PAGE 145
/api/TemplateService/TemplateViewTypes This URI represents the different features that support template operations. GET method for TemplateViewTypes This method returns the features that support template operations. Description Returns the features that support templates operations. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "/api/ $metadata#Collection(TemplateService.TemplateViewTypeModel)", "@odata.count": 5, "value": [ { "@odata.
PAGE 146
/api/TemplateService/Templates This URI represents the templates. GET method for Templates This method returns the details of all available templates. Table 83. Filters Filter name Description Top Top records to return. Default value is 100. Skip Maximum records to skip. Default value is 0. Orderby Order to apply to the output. SearchFilter Search type. Description Returns the details of all templates. Privilege VIEW HTTP response codes 200 Example response body { "@odata.
PAGE 147
}, { "HasIdentityAttributes": false, "Status": 0, "IdentityPoolId": 0, "IsBuiltIn": true, "CreatedBy": "system", "CreationTime": "2017-11-30 19:02:11.200378", "LastUpdatedBy": null, "LastUpdatedTime": "2017-11-30 19:02:11.200378", "Views": [ { "@odata.id": "/api/TemplateService/Templates(2)/Views" } ] "@odata.
PAGE 148
}, { }, { "HasIdentityAttributes": false, "Status": 0, "IdentityPoolId": 0, "IsBuiltIn": true, "CreatedBy": "system", "CreationTime": "2017-11-30 19:02:11.200378", "LastUpdatedBy": null, "LastUpdatedTime": "2017-11-30 19:02:11.200378", "Views": [ { "@odata.id": "/api/TemplateService/Templates(5)/Views" } ] "@odata.
PAGE 149
} ] } "TypeId": 2, "ViewTypeId": 4, "TaskId": 0, "HasIdentityAttributes": false, "Status": 0, "IdentityPoolId": 0, "IsBuiltIn": true, "CreatedBy": "system", "CreationTime": "2017-11-30 19:02:11.200378", "LastUpdatedBy": null, "LastUpdatedTime": "2017-11-30 19:02:11.200378", "Views": [ { "@odata.id": "/api/TemplateService/Templates(8)/Views" } ] NOTE: For information about template attributes, see the Attributes table under GET method for Templates(Id).
PAGE 150
Table 84. Attributes (continued) Attribute Description ● ● ● ● ● ● ● ● iDRAC System BIOS NIC LifeCycleController RAID EventFilters All To get the entire device configuration, useAll. POST method for IOA Templates This method creates an IOA template. Description Creates an IOA template. Privilege TEMPLATE_MANAGEMENT HTTP response codes 201 Example request body { "Name": "Switch-FJM0Y42", "TypeId": 3, "ViewTypeId": 2, "SourceDeviceId": 10173, "Fqdds": "" } Table 85.
PAGE 151
/api/TemplateService/Templates(Id) This URI represents a specific template. GET method for Templates(Id) This method returns the details of a specific template. Description Returns the details of a specific template. Privilege VIEW HTTP response codes 200 Example response body { } "@odata.context": "/api/$metadata#TemplateService.Template/$entity", "@odata.
PAGE 152
Table 86. Attributes (continued) Attribute Description Status Status of the action. IdentityPoolId The ID of the identify pool associated with the template. If an identity pool is not associated, this value is 0. IsBuiltIn Indicates whether the template is a preinstalled template or customer-defined. CreatedBy The name of the user who created the template. CreationTime Timestamp indicating when this template was created. Last UpdatedBy The name of the user who last modified this template.
PAGE 153
Table 87. Attributes (continued) Attribute name Description Attribute Id Attribute Id Value Status of the Value attribute IsIgnored Whether the attribute id Ignored or Not DELETE method for Templates(Id) This method deletes a template. Description Deletes a specific template. Privilege DEVICE_CONFIGURATION HTTP response codes 204 api/TemplateService/Templates(26) This URL represents the template configuration content.
PAGE 154
auto vlan\n! \n protocol lldp \n no shutdown\n! \ninterface TenGigabitEthernet 0/9\n auto vlan\n! \n protocol lldp \n no shutdown\n! \ninterface TenGigabitEthernet 0/10\n auto vlan\n! \n protocol lldp \n no shutdown\n! \ninterface TenGigabitEthernet 0/11\n auto vlan\n! \n protocol lldp \n no shutdown\n! \ninterface TenGigabitEthernet 0/12\n auto vlan\n! \n protocol lldp \n no shutdown\n! \ninterface TenGigabitEthernet 0/13\n auto vlan\n! \n protocol lldp \n no shutdown \n! \ninterface TenGigabitEthernet 0/1
PAGE 155
"CreatedBy": "admin", "CreationTime": "2019-01-24 15:15:13.509153", "LastUpdatedBy": "admin", "LastUpdatedTime": "2019-01-24 15:15:13.509153", "Views@odata.navigationLink": "/api/TemplateService/Templates(10)/ Views" } Table 88. Attributes Attribute Description Id Unique identifier for referencing a template. Name Template name. Description Definition for the template. SourceDeviceId The identifier of the device whose configuration was used as a reference for creating the template.
PAGE 156
"@odata.context": "/api/ $metadata#Collection(TemplateService.AttributeView) HYPERLINK "mailto:\",\"@odata.count" ", "@odata.count": 2, "value": [ { "@odata.type": "#TemplateService.AttributeView", "@odata.id": "/api/TemplateService/Templates(1)/Views(1)", "Id": 1, "Name": "TemplateSpecific", "Description": "The hierarchy consists of template specific component classes, groups (from the attribute registry) and attributes.", "AttributeViewDetails": { "@odata.
PAGE 157
"/api/TemplateService/Templates(10)/Views(1)", "Id": 1, "Name": "DefaultModel", "Description": "The default hierarchical model of a template. The hierarchy consists of component classes, groups (from the attribute registry) and attributes.", "AttributeViewDetails": { "@odata.id": "/api/TemplateService/Templates(10)/Views(1)/ AttributeViewDetails" }, "DeviceAttributeViewDetails": [ { "@odata.id": "/api/TemplateService/Templates(10)/Views(1)/ DeviceAttributeViewDetails" } ] } Table 89.
PAGE 158
"DisplayName": "LifecycleController", "SubAttributeGroups": [ { "GroupNameId": 410, "DisplayName": "Lifecycle Controller Attributes", "SubAttributeGroups": [], "Attributes": [ { "AttributeId": 3562, "CustomId": 0, "AttributeEditInfoId": 1857, "DisplayName": "LCAttributes 1 VirtualAddressManagementApplication", "Description": null, "Value": null, "IsReadOnly": false, "IsIgnored": false }, { "AttributeId": 3561, "CustomId": 0, "AttributeEditInfoId": 1856, "DisplayName": "LCAttributes 1 VirtualAddressManagemen
PAGE 159
} { Restart", }, { Requested", }, { }, { ] } "CustomId": 0, "AttributeEditInfoId": 1855, "DisplayName": "LCAttributes 1 IPChangeNotifyPS", "Description": null, "Value": "Off", "IsReadOnly": false, "IsIgnored": false "AttributeId": 3557, "CustomId": 0, "AttributeEditInfoId": 1642, "DisplayName": "LCAttributes 1 Collect System Inventory on "Description": null, "Value": "Enabled", "IsReadOnly": false, "IsIgnored": false "AttributeId": 3564, "CustomId": 0, "AttributeEditInfoId": 1859, "DisplayName": "LC
PAGE 160
Table 90. Attributes (continued) Attribute Description Description Attribute definition. Value The current value for the attribute. IsReadOnly Indicates whether the attribute value can be modified. IsIgnored Indicates whether the attribute should be ignored or included when the template is deployed to another device. true indicates Ignore - do not deploy.
PAGE 161
}, { "DependencyText": null, "OptionSetId": 0, "DefaultOptionId": 0, "GenericNameId": 2258 "Id": 3637, "DataType": 4308, "Description": "Specify the iSCSI Qualified Name (IQN) of the fifth iSCSI storage target.
PAGE 162
/api/TemplateService/Templates(Id)/Views(Id)/ DeviceAttributeViewDetails(Id) This URI represents the device-specific attributes for a view of a template. GET method for DeviceAttributeViewDetails(Id) This method returns the device-specific attributes for a view of a template. Description Returns the device-specific attributes for a view of a template. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "/api/$metadata#TemplateService.
PAGE 163
}, { }, { ] }, { }, { } "IsIgnored": false "AttributeId": 0, "CustomId": 43, "AttributeEditInfoId": 0, "DisplayName": "Vlan Tagged", "Description": null, "Value": null, "IsReadOnly": false, "IsIgnored": false "AttributeId": 0, "CustomId": 43, "AttributeEditInfoId": 0, "DisplayName": "Vlan UnTagged", "Description": null, "Value": "0", "IsReadOnly": false, "IsIgnored": false } ], "Attributes": [] "GroupNameId": 1, "DisplayName": "Port ", "Sub ttributeGroups": [ "GroupNameId": 2, "DisplayName": "P "SubA
PAGE 164
{ }, { ] }, { 164 Configure } "AttributeId": 3369, "CustomId": 0, "AttributeEditInfoId": 2969, "DisplayName": "Partition n Minimum TX Bandwidth", "Description": null, "Value": "20", "IsReadOnly": false, "IsIgnored": false "AttributeId": 3370, "CustomId": 0, "AttributeEditInfoId": 2968, "DisplayName": "Partition n Maximum TX Bandwidth", "Description": null, "Value": "100", "IsReadOnly": false, "IsIgnored": false } ], "Attributes": [] "GroupNameId": 1, "DisplayName": "Port ", "SubAttributeGroups": [ {
PAGE 165
"AttributeId": 3431, "CustomId": 0, "AttributeEditInfoId": 2969, "DisplayName": "Partition n Minimum TX Bandwidth", }, { Bandwidth", }, { }, { ] }, { Bandwidth", } "Description": null, "Value": "20", "IsReadOnly": false, "IsIgnored": false "AttributeId": 3432, "CustomId": 0, "AttributeEditInfoId": 2968, "DisplayName": "Partition n Maximum TX "Description": null, "Value": "100", "IsReadOnly": false, "IsIgnored": false "AttributeId": 0, "CustomId": 47, "AttributeEditInfoId": 0, "DisplayName": "Vlan
PAGE 166
"DisplayName": "Partition n Maximum TX Bandwidth", ] }, { Bandwidth", } } ], "Attributes": [] "GroupNameId": 2, "DisplayName": "Port ", "SubAttributeGroups": [ { "GroupNameId": 3, "DisplayName": "Partition ", "SubAttributeGroups": [], "Attributes": [ { "AttributeId": 3503, "CustomId": 0, "AttributeEditInfoId": 2969, "DisplayName": "Partition n Minimum TX }, { Bandwidth", ] }, { Bandwidth", } Configure "Description": null, "Value": "20", "IsReadOnly": false, "IsIgnored": false "AttributeId": 35
PAGE 167
{ Bandwidth", ] } "AttributeId": 3523, "CustomId": 0, "AttributeEditInfoId": 2968, "DisplayName": "Partition n Maximum TX "Description": null, "Value": "100", "IsReadOnly": false, "IsIgnored": false } ], "Attributes": [] } ], "Attributes": [] } ], "Attributes": [] } ], "TemplateEditInfoDetails": { "@odata.
PAGE 168
} ] } ] } "AttributeEditInfoId": 0, "DisplayName": "IOA.Hostname", "Value": "dell-lex-c3", "IsReadOnly": false, "IsIgnored": false /api/TemplateService/Profiles This URI represents the profiles. GET method for Profiles This method returns the list of available profiles. Description Returns list of profiles. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "/api/$metadata#Collection(TemplateService.Profile)", "@odata.count": 12, "value": [ {"@odata.
PAGE 169
/api/TemplateService/Profiles(Id) This URI represents a specific profile. GET method for Profiles(Id) This method returns the details of a specific profile. Description Returns details of a specific profile. Privilege VIEW HTTP response codes 200 Example response body { } "@odata.context": "/api/$metadata#TemplateService.Profile/$entity", "@odata.type": "#TemplateService.Profile", "@odata.
PAGE 170
}, { }, { }, { }, { }, { } ] } "Id": 3, "Name": "DeploymentInProgress" "@odata.type": "#TemplateService.ProfileState", "Id": 4, "Name": "DeploymentCompletedWithErrors" "@odata.type": "#TemplateService.ProfileState", "Id": 5, "Name": "DeploymentFailedOnNoTargetAvailable" "@odata.type": "#TemplateService.ProfileState", "Id": 10, "Name": "DeployedSuccessfully" "@odata.type": "#TemplateService.ProfileState", "Id": 11, "Name": "DeployedIOSuccessfully" "@odata.type": "#TemplateService.
PAGE 171
{ ] } } "@odata.type": "#TemplateService.ProfileUsage", "Id": 4, "Name": "ServiceTag" /api/TemplateService/Actions/TemplateService.AssignIdentities POST method for TemplateService.AssignIdentities This method reserves virtual identities for target devices based on the configuration in a specified template. Identities are reserved from the identity pool associated with the specified template. Description Reserves virtual identities for target devices.
PAGE 172
Example response body The reply is a hierarchical structure for the cards, ports, and partitions for which identities were assigned, or that have boot options.
PAGE 173
}, { } ] } ] } ] } ] } ] } "AttributeId": 0, "CustomId": 0, "AttributeEditInfoId": 0, "DisplayName": "iSCSI IQN", "Description": "iSCSI IQN", "Value": "iqn.pool1.0000005", "IsReadOnly": true, "IsIgnored": false "GroupNameId": 2, "DisplayName": "Partition", "SubAttributeGroups": [], "Attributes": [ { "AttributeId": 0, "CustomId": 0, "AttributeEditInfoId": 0, "DisplayName": "Protocol", "Description": "", } ] /api/TemplateService/Actions/ TemplateService.
PAGE 174
/api/TemplateService/Actions/TemplateService.AttachProfile This API represents information about server profiles that are created from templates. Post method for /api/TemplateService/Actions/ TemplateService.AttachProfile This method returns information about server profiles that are created from templates. Description Returns information about server profiles that are created from templates.
PAGE 175
} "DestinationSlotEntityId":1234 /api/TemplateService/Actions/TemplateService.UpdateProfile This API updates device-specific attributes in server profiles. POST method for updating profiles This method updates device-specific attributes in server profiles. Description Updates device-specific attributes in the server profile.
PAGE 176
} "ForceMigrate":false /api/TemplateService/Actions/TemplateService.DetachProfile This API detaches profiles from slots. If IO identities that are associated with the profile are in the reserved state, they are returned to the pool. If a profile is tied to a compute device, the IO identity that is associated with the profile is cleared from the device. The IO identity is then returned to the pool.
PAGE 177
Privilege DEVICE_CONFIGURATION HTTP response codes 200 Example request body { } Example response body "TemplateId": 11 { "TemplateId": 11, "Content": "\n\n\nConsole \n
PAGE 178
Privilege TEMPLATE_MANAGEMENT HTTP response codes 200 Example request body 178 Configure { "Name": "Import Test - IOA", "Type": 3, "Content": "\n!Cloning Header Start\n!ReleasePlatform XL\n! ReleaseVersion 9-14(0-30)\n!ReleaseSize 48140985\n!ReleaseTime Jun 19 2018 01:29:05\n!OPTM0 10GBASE-T\n!OPTM1 -\n!Service-Tag FJM0Y42\n! Serial-Number CN2829865N0013\n!FCPortsPresent FALSE\n!QuadPortsPresent 33 37 49 53\n!IOM-Mode standalone\n!CheckSum 4fd3e503fd1df86f419aecd3cd23bd21\n!Cloning Header End\n\n\n!
PAGE 179
TenGigabitEthernet 0/42\n! \n protocol lldp \n no shutdown\n! \ninterface TenGigabitEthernet 0/43\n! \n protocol lldp \n no shutdown \n! \ninterface TenGigabitEthernet 0/44\n! \n protocol lldp \n no shutdown\n! \ninterface TenGigabitEthernet 0/49\n! \n protocol lldp \n no shutdown\n! \ninterface TenGigabitEthernet 0/50\n! \n protocol lldp \n no shutdown\n! \ninterface TenGigabitEthernet 0/51\n! \n protocol lldp \n no shutdown\n! \ninterface TenGigabitEthernet 0/52\n! \n protocol lldp \n no shutdown\n! \nint
PAGE 180
}, { } "DeviceId": "10173", "Attributes": [ { "Id": 18968, "Value": "hostname-1", "IsIgnored": false } ] "DeviceId": "18968", "Attributes": [ { "Id": 9000, "Value": "hostname-2", "IsIgnored": false } ] } ], "Options": { "ShutdownType": 0, "TimeToWaitBeforeShutdown": 300, "EndHostPowerState": 1, "PrecheckOnly": false, "ContinueOnWarning": true }, "Schedule": { "RunNow": true, "RunLater": false } /api/TemplateService/Actions/ TemplateService.UpdateNetworkConfig POST method for TemplateService.
PAGE 181
}, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { } "IsIgnored": false "Id": 3350, "Value": "30", "IsIgnored": false "Id": 3351, "Value": "100", "IsIgnored": false "Id": 3369, "Value": "20", "IsIgnored": false "Id": 3370, "Value": "100", "IsIgnored": false "Id": 3388, "Value": "30", "IsIgnored": false "Id": 3389, "Value": "100", "IsIgnored": false "Id": 3431, "Value": "20", "IsIgnored": false "Id": 3432, "Value": "100", "IsIgnored": false "Id": 3484, "Value": "30", "IsIgno
PAGE 182
} ] ], "VlanAttributes": [ { "ComponentId": 1090, "Untagged": 25455, "Tagged": [25531,25532] } ] } /api/TemplateService/Actions/TemplateService.RemoveBaseline POST method for TemplateService.RemoveBaseline Description This method removes the compliance baseline. Privilege TEMPLATE_MANAGEMENT HTTP response codes 200 Example request body { "BaselineIds": [1,2,5..] } /api/TemplateService/Actions/TemplateService.Remediate POST method for TemplateService.
PAGE 183
HTTP response code Example response body 201 { "Id":2664, "Deviceids":[ 2514 ], "Attributes":[ { "DeviceId":2514, "Attributes":[ { "Id":341, "Value":"MSM RAC 2", "Deploy":true } ] } ] } /api/TemplateService/Actions/TemplateService.MigrateProfile POST method for TemplateService.MigrateProfile Description This method migrates a profile from one server to another.
PAGE 184
"@odata.context": "/api/ $metadata#Collection(IdentityPoolService.IdentityPool)", "@odata.count": 2, "value": [ { "@odata.type": "#IdentityPoolService.IdentityPool", "@odata.id": "/api/IdentityPoolService/IdentityPools(1)", "Id": 1, "Name": "Pool 1", "Description": "This is Pool 1", "CreatedBy": "admin", "CreationTime": "2018-09-06 16:41:47.612624", "LastUpdatedBy": "admin", "LastUpdateTime": "2018-09-06 16:41:47.
PAGE 185
{ "@odata.type": "#IdentityPoolService.IdentityPool", "@odata.id": "/api/IdentityPoolService/IdentityPools(10)", "Id": 10, "Name": "Sample Identity Pool", "Description": "This is a sample Identity Pool", "CreatedBy": "admin", "CreationTime": "2018-09-11 17:12:46.166658", "LastUpdatedBy": "admin", "LastUpdateTime": "2018-09-11 17:12:46.
PAGE 186
POST method for IdentityPools This method creates an identity pool. Description Creates an identity pool. Privilege TEMPLATE_MANAGEMENT HTTP response codes 200 Example request body { } 186 Configure "Name":"New Identity Pool 4", "EthernetSettings": { "Mac": { "IdentityCount":55, "StartingMacAddress": "UFBQUFAA" } }, "IscsiSettings": { "Mac": { "IdentityCount":65, "StartingMacAddress": "YGBgYGAA" }, "InitiatorConfig": { "IqnPrefix":"Iqn.
PAGE 187
/api/IdentityPoolService/IdentityPools(Id) This URI represents a specific identity pool. GET method for IdentityPools(Id) This method returns the details of a specific identity pool. Description Returns a specific identity pool. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "/api/$metadata#IdentityPoolService.IdentityPool/ $entity", "@odata.type": "#IdentityPoolService.IdentityPool", "@odata.
PAGE 188
}, "UsageCounts": { "@odata.id": "/api/IdentityPoolService/IdentityPools(4)/UsageCounts" }, "UsageIdentitySets@odata.navigationLink": "/api/IdentityPoolService/ IdentityPools(4)/UsageIdentitySets" } PUT method for IdentityPools(Id) This method updates a specific identity pool. Description Updates an identity pool.
PAGE 189
Table 91. Attributes Attribute name Description ID Iopool Id Name Name of the Iopool Description Definition for the Iopool EthernetSettings- MAC IdentityCount Number of Identities Starting MAC address Initial MAC Address FcSettings WWPN worldwide port names IdentityCount IdentityCount Starting WWPN address Initial WWPN Address WWNN worldwide Node names Starting WWNN address Initial WWNN Address DELETE method for IdentityPools(Id) This method deletes an identity pool.
PAGE 190
{ }, { }, { }, { }, { } ] } "IdentityTypeId": 10, "TotalRequested": 65, "TotalReserved": 0, "TotalDeployed": 0 "IdentityTypeId": 8, "TotalRequested": 55, "TotalReserved": 42, "TotalDeployed": 0 "IdentityTypeId": 3, "TotalRequested": 85, "TotalReserved": 3, "TotalDeployed": 0 "IdentityTypeId": 4, "TotalRequested": 85, "TotalReserved": 3, "TotalDeployed": 0 "IdentityTypeId": 7, "TotalRequested": 0, "TotalReserved": 14, "TotalDeployed": 0 /api/IdentityPoolService/IdentityPools(Id)/UsageIdentitySets Th
PAGE 191
"@odata.id": "/api/IdentityPoolService/IdentityPools(4)/ UsageIdentitySets(2)", "IdentitySetId": 2, "Name": "iSCSI", "Details@odata.navigationLink": "/api/IdentityPoolService/ IdentityPools(4)/UsageIdentitySets(2)/Details" }, { "@odata.type": "#IdentityPoolService.UsageIdentitySet", "@odata.id": "/api/IdentityPoolService/IdentityPools(4)/ UsageIdentitySets(3)", "IdentitySetId": 3, "Name": "FCoE", "Details@odata.
PAGE 192
/api/IdentityPoolService/IdentityPools(Id)/ UsageIdentitySets(Id)/Details This URI represents usage details for a specific identity pool and identity set (protocol). GET method for Details of UsageIdentitySets(Id) This method returns the usage details for a specific identity pool and identity set or protocol. NOTE: ● To get the identifier for each available Identity Pool, use the API /IdentityPoolService/IdentityPools.
PAGE 193
} ] /api/IdentityPoolService/IdentityStates This URI represents the identity states for the identities in an identity pool. GET method for IdentityStates This method returns the identity states, such as Reserved and Assigned, for the identities in an identity pool. Description Returns identity states. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "/api/ $metadata#Collection(IdentityPoolService.IdentityState)", "@odata.count": 2, "value": [ { "@odata.
PAGE 194
} "@odata.type": "#IdentityPoolService.IdentityState", "@odata.id": "/api/IdentityPoolService/IdentityStates(1)", "Id": 1, "Name": "Reserved", "Description": "Assigned to a profile; deployment pending." /api/IdentityPoolService/Actions/ IdentityPoolService.DeleteIdentityPools POST method for deleting identity pools This method deletes identity pools. Description Deletes identity pools.
PAGE 195
}, { } ] } "Id": 42214, "Name": "Network-1", "Description": "", "VlanMaximum": 3, "VlanMinimum": 3, "Type": 1, "CreatedBy": "root", "CreationTime": "1970-01-01 01:01:48.181", "UpdatedBy": null, "UpdatedTime": "1970-01-01 01:01:48.181", "InternalRefNWUUId": 0 "@odata.id": "/api/NetworkConfigurationService/Networks(42414)", "Id": 42414, "Name": ""Network-3", "Description": null, "VlanMaximum": 9, "VlanMinimum": 9, "Type": 8, "CreatedBy": "root", "CreationTime": "1970-01-01 01:02:29.
PAGE 196
Example request body { } Example response body "Name": "abc-1", "Description": "abc", "VlanMaximum": 19, "VlanMinimum": 19, "Type": 1 { "@odata.context": "/api/$metadata#NetworkConfigurationService.Network/ $entity", "@odata.id": "/api/NetworkConfigurationService/Networks(43614)", "Id": 43614, "Name": "abc-1", "Description": "abc", "VlanMaximum": 19, "VlanMinimum": 19, "Type": 1, "CreatedBy": "root", "CreationTime": "1970-01-01 02:02:15.797", "UpdatedBy": null, "UpdatedTime": "1970-01-01 02:02:15.
PAGE 197
PUT method for Networks(Id) This method updates an existing network. Description Updates a network. Privilege TEMPLATE_MANAGEMENT HTTP response codes 200 Example request body { } Example response body { } "Id": 43614, "Name": "abc-1", "Description": "abc-updated", "VlanMaximum": 22, "VlanMinimum": 19, "Type": 1 "Id": 43614, "Name": "abc-1", "Description": "abc-updated", "VlanMaximum": 22, "VlanMinimum": 19, "Type": 1, "CreatedBy": "root", "CreationTime": "1970-01-01 02:02:15.
PAGE 198
HTTP response codes 204 /api/NetworkConfigurationService/NetworkTypes This URI represents the supported network types. GET method for NetworkTypes This method returns a list of the supported network types. Description Returns a list of network types. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "/api/ $metadata#Collection(NetworkConfigurationService.NetworkType)", "@odata.count": 11, "value": [ { "@odata.
PAGE 199
/api/NetworkConfigurationService/NetworkTypes(Id) This URI represents a specific network type within the collection. GET method for NetworkTypes(Id) This method returns the details of a specific network type. Description Returns the details of a specific network type. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "/api/ $metadata#NetworkConfigurationService.NetworkType/$entity", "@odata.
PAGE 200
} ] Table 95. Attributes Attribute name Description Id ID of the QoS type. Name Name of the QoS type. /api/NetworkConfigurationService/QosTypes(Id) This URI represents a specific QoS type within the collection. GET method for QosTypes(Id) This method returns a specific QoS type. Description Returns a specific QoS type. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "/api/$metadata#NetworkConfigurationService.QosType/ $entity", "@odata.
PAGE 201
7 Devices Topics: • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • /api/DeviceService /api/DeviceService/Devices /api/DeviceService/Devices?$filter=Type eq 1000 /api/DeviceService/Devices(Id) /api/DeviceService/Devices(Id)/InventoryDetails /api/DeviceService/Devices(Id)/InventoryDetails(InventoryType) /api/DeviceService/Devices(Id)/Settings('ReplicableChassisConfigurations') /api/DeviceService/Devices(Device_ID)/Settings('LocalAccessConfiguration') /api/DeviceService/Devi
PAGE 202
/api/DeviceService This URI represents the device services. GET method for DeviceService This method returns a list of all the device services. Description Returns a list of device services. Privilege VIEW HTTP response codes 200 Example Response Body { "@odata.context": "/api/$metadata#DeviceService.DeviceService", "@odata.type": "#DeviceService.DeviceService", "@odata.id": "/api/DeviceService", "Actions": null, "Devices@odata.navigationLink": "/api/DeviceService/Devices", "DeviceStatuses@odata.
PAGE 203
"PowerState": 17, "ManagedState": 3000, "Status": 1000, "ConnectionState": true, "AssetTag": "12345678910", "SystemId": 2031, "DeviceName": "IOM-C1", "LastInventoryTime": "2019-09-06 06:30:11.936", "LastStatusTime": "2019-09-06 06:30:06.
PAGE 204
DeviceService/Devices(10281)",…} ] } /api/DeviceService/Devices?$filter=Type eq 1000 This URI gets a collection of devices with filter. GET method for device filter This method gets a collection of devices.
PAGE 205
5, 6, 7, 8, 9, 41, 11, 12, 13, 14, 15, 1009, 17, 50, 18, 30, 31 ], "SlotConfiguration": { "ChassisName": null }, "DeviceManagement": [ { "ManagementId": 5002, "NetworkAddress": "XX.XX.X.XX", "MacAddress": "58:8a:5a:ee:01:6e", "ManagementType": 2, "InstrumentationName": "WIN-02GODDHDJTC", "DnsName": "idrac-gmgr064.smd.devops.dell.com", "ManagementProfile": [ { "ManagementProfileId": 5002, "ManagementId": 5002, "AgentName": "iDRAC", "Version": "3.30.30.30", "ManagementURL": "https://XX.XX.X.
PAGE 206
Temperature" "Temperature": { "@odata.id": "/api/DeviceService/Devices(10074)/ }, "Power": { "@odata.id": "/api/DeviceService/Devices(10074)/Power" }, "SystemUpTime": { "@odata.id": "/api/DeviceService/Devices(10074)/ SystemUpTime" }, "BlinkStatus": { "@odata.id": "/api/DeviceService/Devices(10074)/ BlinkStatus" }, "PowerUsageByDevice@odata.navigationLink": "/api/ DeviceService/Devices(10074)/PowerUsageByDevice", "DeviceBladeSlots@odata.
PAGE 207
}, "DeviceManagement": [ { "ManagementId": 5012, "NetworkAddress": "XX.XX.X.XX", "MacAddress": "50:9a:4c:b2:f6:16", "ManagementType": 2, "InstrumentationName": "WIN-02GODDHDJTC", "DnsName": "idrac-gmgr075.smd.devops.dell.com", "ManagementProfile": [ { "ManagementProfileId": 5012, "ManagementId": 5012, "AgentName": "iDRAC", "Version": "3.36.36.36", "ManagementURL": "https://XX.XX.X.XX:XXX", "HasCreds": 0, "Status": 1000, "StatusDateTime": "2019-12-02 16:00:58.
PAGE 208
GraphicInfo" "@odata.id": "/api/DeviceService/Devices(10079)/ }, "DeployRequired": { "@odata.id": "/api/DeviceService/Devices(10079)/ DeployRequired" } }, { "@odata.type": "#DeviceService.Device", "@odata.id": "/api/DeviceService/Devices(10085)", "Id": 10085, "Type": 1000, "Identifier": null, "DeviceServiceTag": null, "ChassisServiceTag": "", "Model": "unknown", "PowerState": 17, "ManagedState": 3000, "Status": 1000, "ConnectionState": true, "AssetTag": null, "SystemId": 0, "DeviceName": "10.35.0.
PAGE 209
} ] ], "Actions": null, "SensorHealth@odata.navigationLink": "/api/DeviceService/ Devices(10085)/SensorHealth", "VirtualSession": { "@odata.id": "/api/DeviceService/Devices(10085)/ VirtualSession" }, "Baselines": { "@odata.id": "/api/DeviceService/Devices(10085)/ Baselines" }, "InventoryDetails@odata.navigationLink": "/api/DeviceService/ Devices(10085)/InventoryDetails", "HardwareLogs@odata.navigationLink": "/api/DeviceService/ Devices(10085)/HardwareLogs", "SubSystemHealth@odata.
PAGE 210
/api/DeviceService/Devices(Id) This URI represents a specific device within the collection. GET method for Devices(Id) This method returns the details of a specific device. Description Returns the details of a specific device. Privilege VIEW HTTP response codes 200 Example response body 210 Devices { "@odata.context": "/api/$metadata#DeviceService.Device", "@odata.type": "#DeviceService.Device", "@odata.
PAGE 211
] } ], "Actions": null, "DeviceSpecificData":{ "powerRedundancy": "No Redundancy", "expressservicecode": "49896352517", "servicetag": "MX70005", "faceplatePower": 11571, "dnsname": "", "location": "", "hardwareVersion": "", "powercapacity": "Disabled" }, "InventoryDetails@odata.navigationLink": "/api/DeviceService/ Devices(10053)/InventoryDetails", "HardwareLogs@odata.navigationLink": "/api/DeviceService/Devices(10053)/ HardwareLogs", "SubSystemHealth@odata.
PAGE 212
Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "$metadata#Collection(DeviceService.InventoryDetail)", "@odata.count": 18, "value": [ { "@odata.id": "/api/DeviceService/Devices(3315)/ InventoryDetails('serverDeviceCards')", "InventoryType": "serverDeviceCards", "InventoryInfo": [ { "Id": 127, "SlotNumber": "SMBus.Embedded.
PAGE 213
{ }, { mode]", }, { ] } "Id": 133, "SlotNumber": "P2PBridge.Embedded.2-1", "Manufacturer": "Intel Corporation", "Description": "Lewisburg PCI Express Root Port #5", "DatabusWidth": "Unknown", "SlotLength": "Unknown", "SlotType": "Unknown" "Id": 134, "SlotNumber": "AHCI.Embedded.2-1", "Manufacturer": "Intel Corporation", "Description": "Lewisburg SATA Controller [AHCI "DatabusWidth": "Unknown", "SlotLength": "Unknown", "SlotType": "Unknown" "@odata.
PAGE 214
"@odata.id": "/api/DeviceService/Devices(3315)/ InventoryDetails('serverArrayDisks')", "InventoryType": "serverArrayDisks", "InventoryInfo": [ { "Id": 10, "DeviceId": 0, "DiskNumber": "Disk 0 on Embedded AHCI Controller 2", "VendorName": "SEAGATE", "Status": 2000, "StatusString": "Unknown", "ModelNumber": "ST1000NX0423", "SerialNumber": "S47171Y1", "Revision": "NA03", "EnclosureId": "Disk 0 on Embedded AHCI Controller 2", "Channel": 0, "Size": "931.
PAGE 215
}, { ] } "SerialNumber": "1446F14C", "TypeDetails": "DDR4 DIMM", "ManufacturerDate": "Mon Oct 17 07:00:00 2016 UTC", "Speed": 2666, "CurrentOperatingSpeed": 2133, "Rank": "Single Rank", "InstanceId": "DIMM.Socket.A1", "DeviceDescription": "DIMM A1" "@odata.id": "/api/DeviceService/Devices(3315)/ InventoryDetails('serverStorageEnclosures')", "InventoryType": "serverStorageEnclosures", "InventoryInfo": [] }, { "@odata.
PAGE 216
data" "InventoryInfo": [ { "Id": 366, "CapabilityType": { "CapabilityId": 17, "Name": "FEATURES_14G", "Description": "14G specific features" } }, { "Id": 367, "CapabilityType": { "CapabilityId": 16, "Name": "VIRTUAL_CONSOLE", "Description": "Ability to execute RACADM tasks" } }, { "Id": 368, "CapabilityType": { "CapabilityId": 15, "Name": "TEMP_HISTORY", "Description": "Retrieve historical temperature }, { }, { }, { }, { }, { }, { 216 Devices } "Id": 369, "CapabilityType": { "CapabilityId": 14, "Na
PAGE 217
assigned Storage" }, { capability.
PAGE 218
}, { ] } } "CapabilityId": 30, "Name": "REMOTE_RACADM", "Description": "14G specific features" "@odata.id": "/api/DeviceService/Devices(3315)/ InventoryDetails('deviceFru')", "InventoryType": "deviceFru", "InventoryInfo": [ { "Id": 38, "Manufacturer": "Dell Inc.", "Name": "SystemPlanar" }, { "Id": 37, "Manufacturer": "Micron Technology", "Name": "DDR4 DIMM", "PartNumber": "9ASF1G72PZ-2G6D1", "SerialNumber": "1446F14C" } ] }, { "@odata.
PAGE 219
"InventoryType": "deviceSoftware", "InventoryInfo": [ { "Version": "0", "InstallationDate": "2017-06-16T00:54:12Z", "Status": "Installed", "SoftwareType": "APAC", "ComponentId": "25806", "DeviceDescription": "Diagnostics", "InstanceId": "DCIM:INSTALLED#802__Diagnostics.Embedded.1:LC.Embedded.
PAGE 220
"DCIM:INSTALLED#802__OSCollector.Embedded.1" }, { "Version": "0", "InstallationDate": "2017-06-16T00:54:12Z", "Status": "Installed", "SoftwareType": "APAC", "ComponentId": "104684", "DeviceDescription": "iDRAC Service Module Installer", "InstanceId": "DCIM:INSTALLED#802__ServiceModule.Embedded.1" }, { "Version": "3.20.20.
PAGE 221
}, { } ] } ] } "SubsystemName": "tempRollupStatus" "Id": 152, "Status": 2000, "SubsystemName": "intrusionRollupStatus" Individual filters You can also use individual filters in this URI. Example response body GET for the following URI: /api/DeviceService/Devices(3315)/ InventoryDetails('subsystemRollupStatus') Output: { "@odata.context": "$metadata#DeviceService.InventoryDetail/$entity", "@odata.
PAGE 222
} ] /api/DeviceService/Devices(Id)/ InventoryDetails(InventoryType) This URI represents the details of a specific inventory type for a specific device. GET method for inventory details by inventory type This method returns the details of a specific inventory type. NOTE: If a PSU is absent, this method reports the status as follows: ● Presence: Absent ● Health: Ok ● Power state: Off Description Returns details of a specific inventory type.
PAGE 223
/api/DeviceService/Devices(Id)/ Settings('ReplicableChassisConfigurations') This URI retrieves the chassis time and alert destination settings and applies the settings to the IOM. PUT method to retrieve chassis time and alert destination settings This method retrieves the chassis and alert destinations settings. Description Retrieves the chassis and alert destinations settings and applies the settings to the IOMs.
PAGE 224
/api/DeviceService/Devices(Device_ID)/ Settings('LocalAccessConfiguration') This API represents the local access configuration information. GET method for local access configuration This method returns the local access configuration details. Description Returns the local access configuration details.
PAGE 225
"EnableReadAuthentication": true, "EnableQuickSyncWifi": true } Example response body { } }, "EnableChassisDirect": true, "LcdAccess": "VIEW_AND_MODIFY", "LcdPresence": "Present", "LcdCustomString": "", "LcdLanguage": "en" "SettingType": "LocalAccessConfiguration", "EnableChassisPowerButton": true, "EnableKvmAccess": true, "LedPresence": "Absent", "QuickSync": { "QuickSyncHardware": "Present", "QuickSyncAccess": "READ_WRITE", "EnableInactivityTimeout": true, "TimeoutLimit": 120, "TimeoutLimitUnit": "SE
PAGE 226
"EnableReadAuthentication": true, "EnableQuickSyncWifi": true } }, "EnableChassisDirect": false, "LcdAccess": "VIEW_AND_MODIFY", "LcdPresence": "Present", "LcdCustomString": "", "LcdLanguage": "en" /api/DeviceService/Devices(Id)/HardwareLogs This URI represents the hardware logs of a specific device. GET method for HardwareLogs This method returns the hardware logs of a specific device. Description Returns the hardware logs of a specific device.
PAGE 227
"LogTimestamp": "20170907053540.000000-300", "LogSequenceNumber": 286411, "LogSeverity": 1000, "LogComment": "[set comment here]", "LogMessageId": "USR0030", "LogMessage": "Successfully logged in using root, from 10.32.22.88 and wsman.", "LogId": "DCIM:LifeCycleLog:286411", "LogCategory": "Audit", "DateFormat": "CIM" } ] } /api/DeviceService/Devices(Id)/SubSystemHealth This URI represents the health of a specific device.
PAGE 228
} ] } /api/DeviceService/Devices(Id)/RecentActivity This URI represents the recent activities for a specific device. GET method for RecentActivity This method returns the recent activities for a specific device. Description Returns the recent activities for a specific device. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "$metadata#Collection(DeviceService.ExecutionHistoryDetailModel)", "@odata.
PAGE 229
/api/DeviceService/Devices(Id)/InventoryTypes This URI represents the inventory types for a specific device. GET method for InventoryTypes This method returns the inventory types for a specific device. Description Returns the inventory types for a specific device. Privilege VIEW HTTP response codes 200 Example response body { } "@odata.context": "$metadata#DeviceService.InventoryTypes/$entity", "@odata.
PAGE 230
} "Info": 1000 NOTE: The severity "Unknown": 5000 is not displayed by REST. To view logs in Unknown state, use the web interface. /api/DeviceService/Devices(Id)/Settings This URI represents the settings of a specific device. GET method for Settings This method returns the details of the settings of a specific device. Description Returns the details of the settings of a specific device. Privilege VIEW HTTP response codes 200 Example response body { "@odata.
PAGE 231
GET method for device settings by type This method returns the available attributes under a specific setting type. Description Returns the available attributes under a specific setting type. Privilege VIEW HTTP response codes 200 Example for network settings for IOM Example response body { } Example for network settings for Chassis "@odata.context": "/api/$metadata#DeviceService.DeviceSetting/$entity", "@odata.type": "#DeviceService.DeviceSetting", "@odata.
PAGE 232
"EnableAutoconfiguration": true, "StaticIPv6Address": "", "StaticPrefixLength": "0", "StaticGateway": "", "UseDHCPv6ObtainDNSServerAddresses": true, "StaticPreferredDNSServer": "", "StaticAlternateDNSServer": "" } }, "GeneralSettings": { "EnableNIC": true, "RegisterDNS": false, "DnsName": "MX7000", "UseDHCPForDomainName": false, "DnsDomainName": "", "AutoNegotiation": true, "NetworkSpeed": "1_GB", "Delay": 0 } PUT method for device settings by type This method updates the attributes under a specific sett
PAGE 233
Example for network settings for IOM Example response body { } Example for IOM names Example response body { Example for network settings for Chassis "@odata.id": "/api/DeviceService/Devices(25773)/Settings('Network')", "EnableMgmtVLANId": false, "@odata.context": "/api/$metadata#DeviceService.
PAGE 234
{ } Example for network settings for Chassis } "EnableNIC": true, "RegisterDNS": false, "DnsName": "MX7000", "UseDHCPForDomainName": false, "DnsDomainName": "", "AutoNegotiation": true, "NetworkSpeed": "1_GB", "Delay": 0 Example response body { } "SettingType": "Network", "DhcpProvisioning": null, "MgmtVLANId": "1", "EnableVLAN": false, "Ipv4Settings": { "EnableIPv4": true, "EnableDHCP": true, "StaticIPAddress": "", "StaticSubnetMask": "", "StaticGateway": "", "UseDHCPObtainDNSServerAddresses": true,
PAGE 235
HTTP response codes 200 Example response body { "@odata.context": "$metadata#DeviceService.TemperatureResponseModel/ $entity", "@odata.id": "/api/DeviceService/Devices(3265)/Temperature", "peakTemperatureUnit": "celsius", "avgTemperatureUnit": "celsius", "DateFormat": "CIM", "instantaneousTemperatureUnit": "celsius", "avgTemperatureTimeStamp": "20170907071015.
PAGE 236
Example response body { } "@odata.context": "$metadata#DeviceService.PowerResponseModel/$entity", "@odata.id": "/api/DeviceService/Devices(3265)/Power", "avgPower": "0", "systemEnergyConsumptionUnit": "killowatt-hour", "systemEnergyConsumptionTimeStamp": "20170907071147.450000-300", "powerUnit": "watt", "minimumPowerTimeStamp": "19691231180000.000000-360", "avgPowerUnit": "watt", "minimumPower": "65535", "peakPower": "73", "DateFormat": "CIM", "systemEnergyConsumption": "0.000", "Since": "20170414145039.
PAGE 237
} ] } "Id": 4465, "SlotName": "Sled-3", "PowerState": 18, "SlotType": 2000, "DeviceName": "" /api/DeviceService/Devices(Id)/GraphicInfo This URI represents the graphics information of a specific device. GET method for GraphicInfo This method returns the graphics-related information of a specific device. Description Returns the graphics-related information of a specific device. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "$metadata#DeviceService.
PAGE 238
/api/DeviceService/Devices(Id)/DeployRequired This API represents the device deployment results. GET method for deployment by device IDs This method returns the results for deployment on devices by IDs. Description Returns the results for deployment on devices by IDs. Privilege HTTP response code Example response body 200 { "@odata.context": "/api/$metadata#DeviceService.DeployRequired", "@odata.type": "#DeviceService.DeployRequired", "@odata.
PAGE 239
/api/DeviceService/Actions/DeviceService/ Devices(Id)Actions/ DeviceService.UploadFSDCertificate This API represents Field Service Debug (FSD) certificate information. POST method for uploading FSD certificate This method returns information about the FSD certificate upload process. Description Returns information about the FSD certificate upload process.
PAGE 240
/api/DeviceService/DeviceStatuses This URI represents the statuses that the devices can be in. GET method for DeviceStatuses This method returns a list of statuses for the devices. Description Returns a list of statuses for the devices. Privilege VIEW HTTP response codes 200 Example response body { } "@odata.context": "$metadata#Collection(DeviceService.DeviceStatus)", "@odata.count": 5, "value": [ { "GlobalStatus": 1000, "Name": "NORMAL", "Description": "The device is running normal.
PAGE 241
Example response body { } "@odata.context": "$metadata#Collection(DeviceService.DeviceType)", "@odata.
PAGE 242
/api/DeviceService/Actions/DeviceService/ Devices(Id)Actions/DeviceService.GetTermState This API represents term state information for devices. POST method for getting term state This method returns term state information. Description Returns term state information. Privilege DEVICE_CONFIGURATION HTTP response codes 202 Table 98. Attributes Attribute name Description Id—Devices(Id) ID of the device. /api/DeviceService/Actions/DeviceService/ Devices(Id)Actions/DeviceService.
PAGE 243
Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "$metadata#Collection(DeviceService.DeviceSummary)", "@odata.count": 6, "value": [ { "@odata.id": "/api/DeviceService/DeviceSummary(1000)", "DeviceType": 1000, "TotalCount": 2, "DeviceStatusSummary": [ { "StatusType": 1000, "Count": 1 }, { "StatusType": 2000, "Count": 0 }, { "StatusType": 3000, "Count": 0 }, { "StatusType": 4000, "Count": 1 }, { "StatusType": 5000, "Count": 0 } ] }, { "@odata.
PAGE 244
}, { }, { }, { }, { }, { }, { 244 Devices ] } "Count": 0 "StatusType": 2000, "Count": 0 "StatusType": 3000, "Count": 0 "StatusType": 4000, "Count": 0 "StatusType": 5000, "Count": 0 "@odata.id": "/api/DeviceService/DeviceSummary(4000)", "DeviceType": 4000, "TotalCount": 0, "DeviceStatusSummary": [ { "StatusType": 1000, "Count": 0 }, { "StatusType": 2000, "Count": 0 }, { "StatusType": 3000, "Count": 0 }, { "StatusType": 4000, "Count": 0 }, { "StatusType": 5000, "Count": 0 } ] "@odata.
PAGE 245
}, { } ] } ] "@odata.id": "/api/DeviceService/DeviceSummary(8000)", "DeviceType": 8000, "TotalCount": 1, "DeviceStatusSummary": [ { "StatusType": 1000, "Count": 0 }, { "StatusType": 2000, "Count": 0 }, { "StatusType": 3000, "Count": 1 }, { "StatusType": 4000, "Count": 0 }, { "StatusType": 5000, "Count": 0 } ] /api/DeviceService/DeviceSummary(Type) This API represents the device summary information by device status type.
PAGE 246
"StatusType": 3000, "Count": 0 }, { "@odata.type": "#DeviceService.DeviceStatusSummary", "StatusType": 4000, "Count": 0 }, { "@odata.type": "#DeviceService.DeviceStatusSummary", "StatusType": 5000, "Count": 0 } ] } api/DeviceService/Actions/ DeviceService.DevicesPrivilegesAction This API represents the device privilege information that users have for devices. POST method for api/DeviceService/Actions/ DeviceService.
PAGE 247
HTTP response code Example request body 201 { "Privileges": [] } Example response body { “Privileges”: [“VIEW”,”CHASSIS_ADMINISTRATOR”] } /api/DeviceService/Actions/ DeviceService.ExecuteAction This API represents the remote console preview information. POST method /api/DeviceService/Actions/ DeviceService.ExecuteAction This method returns the remote console preview information. Description Returns the remote console preview information.
PAGE 248
}, { }, { }, { }, { }, { } ] } "Description": "Slot type is unknown." "SlotType": 2000, "SlotName": "Sled Slot", "Description": "This is Sled Slot type." "SlotType": 3000, "SlotName": "Fan Slot", "Description": "This is Fan Slot type." "SlotType": 4000, "SlotName": "IO Module Slot", "Description": "This is IO Module Slot type." "SlotType": 5000, "SlotName": "Chassis Manager Slot", "Description": "This is Chassis Manager Slot type.
PAGE 249
}, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { "Id": 3000, "Property": "duplexMode", "Key": "HALF", "Value": "Half", "Description": "Duplex Mode is half." "Id": 4000, "Property": "duplexMode", "Key": "FULL", "Value": "Full", "Description": "Duplex Mode is full.
PAGE 250
}, { }, { }, { }, { }, { }, { } ] } "Id": 13000, "Property": "quickSyncAccess", "Key": "READ_WRITE", "Value": "Read-Write", "Description": "QuickSyncAccess is read write" "Id": 14000, "Property": "timeoutLimitUnit", "Key": "SECONDS", "Value": "Seconds", "Description": "Time out limit unit is seconds" "Id": 15000, "Property": "timeoutLimitUnit", "Key": "MINUTES", "Value": "Minutes", "Description": "Time out limit unit is minutes" "Id": 16000, "Property": "lcdAccess", "Key": "DISABLED", "Value": "Dis
PAGE 251
Example response body { } "@odata.context": "$metadata#Collection(DeviceService.GlobalExclude)", "@odata.count": 4, "value": [ { "@odata.id": "/api/DeviceService/GlobalExcludes(1)", "Id": 1, "Identifier": "9PKM9Z1", "DeviceType": 0, "GlobalExcludeDetails": [ { "Id": 1, "NetworkAddress": "xx.xx.xx.xx" } ] }, { "@odata.id": "/api/DeviceService/GlobalExcludes(2)", "Id": 2, "Identifier": null, "DeviceType": 0, "GlobalExcludeDetails": [ { "Id": 2, "NetworkAddress": "xx.xx.xx.xx" } ] }, { "@odata.
PAGE 252
Example request body Example response body {"DeviceIds": [2464,2614,2514]} True /api/DeviceService/Actions/ DeviceService.AddNetworkRange This URI adds ranges to the globally excluded range. POST method for DeviceService.AddNetworkRange This method adds ranges to global exclusion. Description Adds network ranges to global exclusion.
PAGE 253
} "Identifier": "IPRange2", "DeviceType": 0, "GlobalExcludeDetails": [ { "Id": 0, "NetworkAddress": "xx.xx.xx.xx-xx.xx.xx.xx" } ] /api/DeviceService/Actions/ DeviceService.RemoveFromExclusion This URI removes ranges from Global Exclusion. POST method for DeviceService.RemoveFromExclusion This method removes ranges in global exclusion. Description Removes ranges in global exclusion.
PAGE 254
}, ] } } "Id": 0, "NetworkAddress": "xx.xx.xx.xx-xx.xx.xx.xx" { "Id": 0, "NetworkAddress": "xx.xx.xx.xx" /api/DeviceService/Actions/ DeviceService.RemoveDevices This URI deletes an array of devices. POST method for DeviceService.RemoveDevices Description Deletes an array of devices.
PAGE 255
8 Diagnostic Topics: • /api/DeviceService/Devices(Id)/Actions/DeviceService.Diagnostic /api/DeviceService/Devices(Id)/Actions/ DeviceService.Diagnostic This URI allows you to execute supported diagnostic commands. POST method for DeviceService.Diagnostic This method executes the supported diagnostics commands. Description Executes supported diagnostic commands.
PAGE 256
9 Groups Topics: • • • • • • • • • • • • • • • • • • /api/GroupService/Groups /api/GroupService/Groups(Id) /api/GroupService/Groups(Id)/Devices /api/GroupService/Groups(Id)/GroupDevicesSummary /api/GroupService/Groups(group id)/AllLeafDeviceSummaries /api/GroupService/Groups(group id)/AllLeafDeviceSummaries?$filter=Type eq 4000 /api/GroupService/Groups(group id)/AllLeafDeviceSummaries?$filter=Type eq 4000&$top=25&$skip=0 /api/GroupService/Groups(group id)/AllLeafDeviceSummaries?$filter=Type eq 4000&$top=25
PAGE 257
} ] } "UpdatedBy": "", "Visible": true, "DefinitionId": 500, "DefinitionDescription": "Root group for all Types of Devices.", "TypeId": 2000, "MembershipTypeId": 24, "Devices": [ { "@odata.id": "/api/GroupService/Groups(64)/Devices" } ], "AllLeafDevices": [ { "@odata.id": "/api/GroupService/Groups(64)/AllLeafDevices" } ], "GroupHierarchy": [ { "@odata.id": "/api/GroupService/Groups(64)/GroupHierarchy" } ], "SubGroups": [ { "@odata.
PAGE 258
Table 99. Attributes (continued) Attribute name Description MembershipTypeId Group membership type. ● 12 — Static ● 24 — Dynamic Link Devices Group link to list group devices. AllLeafDevices Group link to list all group sub groups devices. GroupHierarchy Group link to list the group hierarchy. SubGroup Group link to display the list of sub groups of this group. GroupDevicesSummary Group link to display a summary of all group devices. Table 100.
PAGE 259
Example response body { } "@odata.context": "$metadata#GroupService.Group/$entity", "@odata.id": "/api/GroupService/Groups(64)", "Id": 64, "Name": "All Devices", "Description": "Group associated to all devices.", "GlobalStatus": 5000, "ParentId": 0, "CreationTime": "2017-06-08 18:48:27.069", "UpdatedTime": "2017-06-08 21:15:01.746", "CreatedBy": "system", "UpdatedBy": "", "Visible": true, "DefinitionId": 500, "DefinitionDescription": "Root group for all Types of Devices.
PAGE 260
Table 101. Attributes (continued) Attribute name Description DefinitionDescription Definition description of the group. TypeId Group type. ● ● ● ● ● MembershipTypeId 1000 — Internal 2000 — Predefined 3000 — User defined 4000 — Discovery defined 5000 — MCM group Group membership type. ● 12 — Static ● 24 — Dynamic Link Devices Group link to list group devices. AllLeafDevices Group link to list all group sub groups devices. GroupHierarchy Group link to list the group hierarchy.
PAGE 261
} "DefinitionDescription": "" DELETE method for Groups(Id) This method deletes a group from the collection. Description Deletes a group. Privilege DEVICE_CONFIGURATION HTTP response codes 204 Example request body { } "Id": 1564 Table 102. Attributes Attribute name Description Id ID of the group to be deleted. /api/GroupService/Groups(Id)/Devices This URI represents the devices within a group. GET method for Devices This method returns the list of devices within a specific group.
PAGE 262
"DeviceName": "WIN-02GODDHDJTC", "LastInventoryTime": "2017-06-08 14:10:43.965", "LastStatusTime": "2017-06-08 21:31:41.
PAGE 263
"Settings": [ { "@odata.id": "/api/DeviceService/Devices(1614)/Settings" } ], "Temperature": { "@odata.id": "/api/DeviceService/Devices(1614)/Temperature" }, "Power": { "@odata.id": "/api/DeviceService/Devices(1614)/Power" }, "BlinkStatus": { "@odata.id": "/api/DeviceService/Devices(1614)/BlinkStatus" }, "PowerUsageByDevice": [ { "@odata.id": "/api/DeviceService/Devices(1614)/ PowerUsageByDevice" } ], "Faults": [ { "@odata.id": "/api/DeviceService/Devices(1614)/Faults" } ], "DeviceBladeSlots": [ { "@odata.
PAGE 264
"$metadata#Collection(GroupService.GroupDevicesSummary)", "@odata.count": 1, "value": [ { "DeviceType": 1000, "TotalCount": 55, "GroupDevicesStatusSummary": [ { "StatusType": 1000, "Count": 29 }, { "StatusType": 2000, "Count": 5 }, { "StatusType": 3000, "Count": 4 }, { "StatusType": 4000, "Count": 17 }, { "StatusType": 5000, "Count": 0 } ] } ] } Table 104. Attributes Attribute name Description Id ID of the group.
PAGE 265
}, { "Model": "PowerEdge FM120", "Identifier": "8FWV992d", "DeviceServiceTag": "8FWV992", "Type": 1000, "Status": 1000, "PowerState": 18, "ConnectionState": true, "ManagedState": 3000, "DeviceCapabilities": [ 1, 12, 5, 41, 2, 30, 8, 9, 1009, 10, 14, 4, 6, 3, 18, 15, 7, 31, 13, 50 ], "DeviceManagement": [ { "DeviceId": 14164, "ManagementId": 5000, "NetworkAddress": "XXX.XX.XXX.
PAGE 266
12, 1, 31, 10, 1009, 9, 2, 41, 8, 7, 6, 5, 50 }, { ], "DeviceManagement": [ { "DeviceId": 14214, "ManagementId": 5001, "NetworkAddress": "XXX.XX.XXX.XX", "MacAddress": "74:86:7a:e5:c5:fc", "InstrumentationName": "idrac-2476qm2.fwtestwin.com", "ManagementProfile": [ { "ManagementProfileId": 5001, "ManagementId": 0, "AgentName": "iDRAC", "Version": "2.63.60.62", "ManagementURL": "https://XXX.XX.XXX.XX:XXX" } ] } ], "IpAddress": "XXX.XX.XXX.XX" "@odata.type": "#DeviceService.DeviceMinModel", "@odata.
PAGE 267
"DeviceId": 14264, "ManagementId": 5002, "NetworkAddress": "XXX.XX.XXX.XX", "MacAddress": "74:86:7a:e5:c5:f8", "InstrumentationName": "idrac-8FWV992a", "ManagementProfile": [ { "ManagementProfileId": 5002, "ManagementId": 0, "AgentName": "iDRAC", "Version": "2.63.60.62", "ManagementURL": "https://XXX.XX.XXX.XX:XXX" } ] }, { } ], "IpAddress": "XXX.XX.XXX.XX" "@odata.type": "#DeviceService.DeviceMinModel", "@odata.
PAGE 268
}, { "IpAddress": "XXX.XX.XXX.XX" "@odata.type": "#DeviceService.DeviceMinModel", "@odata.
PAGE 269
1001, 18, 41 }, { ], "DeviceManagement": [ { "DeviceId": 15112, "ManagementId": 5010, "NetworkAddress": "XXX.XX.XXX.XX", "MacAddress": "64:00:6a:c4:13:a8", "InstrumentationName": "MINWINPC", "ManagementProfile": [ { "ManagementProfileId": 5010, "ManagementId": 0, "AgentName": "iDRAC", "Version": "2.61.60.60", "ManagementURL": "https://XXX.XX.XXX.XX:XXX" } ] } ], "IpAddress": "XXX.XX.XXX.XX" "@odata.type": "#DeviceService.DeviceMinModel", "@odata.
PAGE 270
"@odata.type": "#DeviceService.DeviceMinModel", "@odata.id": "/api/GroupService/Groups(500)/ AllLeafDeviceSummaries(15132)", "Id": 15132, "DeviceName": "100.97.133.
PAGE 271
}, { "ManagedState": 3000, "DeviceCapabilities": [ 16, 4, 5, 30, 50, 6, 41, 7, 2, 8, 33, 1009, 9, 10, 11, 31, 12, 1, 13, 18, 14, 15, 17, 3 ], "DeviceManagement": [ { "DeviceId": 15133, "ManagementId": 5299, "NetworkAddress": "XXX.XX.XXX.XX", "MacAddress": "d0:94:66:8c:ec:7a", "InstrumentationName": "idrac-4598BS2", "ManagementProfile": [ { "ManagementProfileId": 5299, "ManagementId": 0, "AgentName": "iDRAC", "Version": "3.36.36.36", "ManagementURL": "https://XXX.XX.XXX.XX:XXX" } ] } ], "IpAddress": "XXX.
PAGE 272
30, 6, 2, 1, 12, 17, 1009, 33, 3, 15, 8, 1006, 14, 18, 31, 50 }, { ], "DeviceManagement": [ { "DeviceId": 15136, "ManagementId": 5073, "NetworkAddress": "XXX.XX.XXX.XX", "MacAddress": "d0:94:66:8e:a9:d1", "InstrumentationName": "idrac-GGWD9V2", "ManagementProfile": [ { "ManagementProfileId": 5073, "ManagementId": 0, "AgentName": "iDRAC", "Version": "3.36.36.36", "ManagementURL": "https://XXX.XX.XXX.XX:XXX" } ] } ], "IpAddress": "XXX.XX.XXX.XX" "@odata.type": "#DeviceService.DeviceMinModel", "@odata.
PAGE 273
}, { "DeviceServiceTag": "6FP7F2S", "Type": 1000, "Status": 2000, "PowerState": 1, "ConnectionState": false, "ManagedState": 3000, "DeviceCapabilities": [ 9, 3, 2, 7, 10, 31, 41, 1, 12, 6, 13, 30, 5, 14, 4, 15, 18, 1009, 8 ], "DeviceManagement": [ { "DeviceId": 15230, "ManagementId": 5176, "NetworkAddress": "XXX.XX.XXX.XX", "MacAddress": "5c:f9:dd:d6:9d:54", "InstrumentationName": "idrac-6FP7F2S", "ManagementProfile": [ { "ManagementProfileId": 5176, "ManagementId": 0, "AgentName": "iDRAC", "Version": "2.
PAGE 274
5, 8, 4, 15, 33, 18, 30, 7, 1, 12, 6, 10 }, { ], "DeviceManagement": [ { "DeviceId": 15231, "ManagementId": 5178, "NetworkAddress": "XXX.XX.XXX.XX", "MacAddress": "10:98:36:9b:03:7f", "InstrumentationName": "localhost", "ManagementProfile": [ { "ManagementProfileId": 5178, "ManagementId": 0, "AgentName": "iDRAC", "Version": "2.63.60.61", "ManagementURL": "https://XXX.XX.XXX.XX:XXX" } ] } ], "IpAddress": "XXX.XX.XXX.XX" "@odata.type": "#DeviceService.DeviceMinModel", "@odata.
PAGE 275
{ }, { "DeviceId": 15232, "ManagementId": 5180, "NetworkAddress": "XXX.XX.XXX.XX", "MacAddress": "10:98:36:9a:62:c1", "InstrumentationName": "idrac-1LPSG52", "ManagementProfile": [ { "ManagementProfileId": 5180, "ManagementId": 0, "AgentName": "iDRAC", "Version": "2.63.60.61", "ManagementURL": "https://XXX.XX.XXX.XX:XXX" } ] } ], "IpAddress": "XXX.XX.XXX.XX" "@odata.type": "#DeviceService.DeviceMinModel", "@odata.
PAGE 276
}, { "Id": 15251, "DeviceName": "100.97.133.57", "Model": "PowerEdge MX740c", "Identifier": "17YFBS2", "DeviceServiceTag": "17YFBS2", "Type": 1000, "Status": 1000, "PowerState": 17, "ConnectionState": true, "ManagedState": 7000, "DeviceCapabilities": [ 4, 16, 12, 1009, 8, 11, 7, 1, 14, 2, 9, 3, 10, 18, 17, 15, 41, 13, 33 ], "DeviceManagement": [ { "DeviceId": 15251, "ManagementId": 5211, "NetworkAddress": "XXX.XX.XXX.
PAGE 277
6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 30, 31, 33, 41, 50, 1001, 1009 }, { ], "DeviceManagement": [ { "DeviceId": 15252, "ManagementId": 5303, "NetworkAddress": "XXX.XX.XXX.XX", "MacAddress": "d0:94:66:8b:4d:b3", "InstrumentationName": "WIN-FP7P1J8GN1B", "ManagementProfile": [ { "ManagementProfileId": 5303, "ManagementId": 0, "AgentName": "iDRAC", "Version": "3.36.36.36", "ManagementURL": "https://XXX.XX.XXX.XX:XXX" } ] } ], "IpAddress": "XXX.XX.XXX.XX" "@odata.type": "#DeviceService.
PAGE 278
{ }, { ] } "ManagementProfileId": 5294, "ManagementId": 0, "AgentName": null, "Version": null, "ManagementURL": "http://XXX.XX.XXX.XX" "DeviceId": 15253, "ManagementId": 5295, "NetworkAddress": "2607:f2b1:f083:133::2b6", "MacAddress": "20:04:0F:13:3C:E2", "InstrumentationName": "MX5108n Ethernet Switch", "ManagementProfile": [ { "ManagementProfileId": 5295, "ManagementId": 0, "AgentName": null, "Version": null, "ManagementURL": "http:// [2607:f2b1:f083:133::2b6]" } ] } ], "IpAddress": "XXX.XX.XXX.
PAGE 279
3, 7, 2, 18, 8 ], "DeviceManagement": [ { "DeviceId": 15255, "ManagementId": 5292, "NetworkAddress": "XXX.XX.XXX.XX", "MacAddress": "20:04:0F:12:DF:62", "InstrumentationName": "MX5108n Ethernet Switch", "ManagementProfile": [ { "ManagementProfileId": 5292, "ManagementId": 0, "AgentName": null, "Version": null, "ManagementURL": "http://XXX.XX.XXX.
PAGE 280
}, { "Id": 15382, "DeviceName": "100.97.135.63", "Model": "PowerEdge M620", "Identifier": "4T36G2S", "DeviceServiceTag": "4T36G2S", "Type": 1000, "Status": 3000, "PowerState": 17, "ConnectionState": true, "ManagedState": 3000, "DeviceCapabilities": [ 1009, 7, 1001, 2, 6, 4, 5, 50, 12, 15, 14, 10, 31, 18, 1, 30, 9, 3, 13, 41, 8 ], "DeviceManagement": [ { "DeviceId": 15382, "ManagementId": 5222, "NetworkAddress": "XXX.XX.XXX.
PAGE 281
14, 13, 12, 31, 11, 1, 10, 9, 33, 41, 8, 7, 6, 50, 5, 4, 17, 3, 1009, 2, 18 }, { ], "DeviceManagement": [ { "DeviceId": 15388, "ManagementId": 5306, "NetworkAddress": "XXX.XX.XXX.XX", "MacAddress": "d0:94:66:8b:49:4f", "InstrumentationName": "WIN-8U5E5RHPHL0", "ManagementProfile": [ { "ManagementProfileId": 5306, "ManagementId": 0, "AgentName": "iDRAC", "Version": "3.36.36.36", "ManagementURL": "https://XXX.XX.XXX.XX:XXX" } ] } ], "IpAddress": "XXX.XX.XXX.XX" "@odata.type": "#DeviceService.
PAGE 282
10, 11, 31, 2, 12, 16, 13, 14 }, { ], "DeviceManagement": [ { "DeviceId": 15389, "ManagementId": 5301, "NetworkAddress": "XXX.XX.XXX.XX", "MacAddress": "d0:94:66:87:af:3c", "InstrumentationName": "idrac-4RKG9V2", "ManagementProfile": [ { "ManagementProfileId": 5301, "ManagementId": 0, "AgentName": "iDRAC", "Version": "3.36.36.36", "ManagementURL": "https://XXX.XX.XXX.XX:xxx" } ] } ], "IpAddress": "XXX.XX.XXX.XX" "@odata.type": "#DeviceService.DeviceMinModel", "@odata.
PAGE 283
} ] /api/GroupService/Groups(group id)/ AllLeafDeviceSummaries?$filter=Type eq 4000 This URL returns the device data by specifying the device type. Get method for AllLeafDeviceSummaries?$filter=Type eq 4000 Description Returns the device data specified by device type. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "/api/ $metadata#Collection(DeviceService.DeviceMinModel)", "@odata.count": 5, "value": [ { "@odata.type": "#DeviceService.DeviceMinModel", "@odata.
PAGE 284
}, { "DeviceId": 15253, "ManagementId": 5295, "NetworkAddress": "2607:f2b1:f083:133::2b6", "MacAddress": "20:04:0F:13:3C:E2", "InstrumentationName": "MX5108n Ethernet Switch", "ManagementProfile": [ { "ManagementProfileId": 5295, "ManagementId": 0, "AgentName": null, "Version": null, "ManagementURL": "http:// [2607:f2b1:f083:133::2b6]" } ] } ], "IpAddress": "XXX.XX.XXX.XX" }, { "@odata.type": "#DeviceService.DeviceMinModel", "@odata.
PAGE 285
}, { "DeviceId": 15255, "ManagementId": 5292, "NetworkAddress": "XXX.XX.XXX.XX", "MacAddress": "20:04:0F:12:DF:62", "InstrumentationName": "MX5108n Ethernet Switch", "ManagementProfile": [ { "ManagementProfileId": 5292, "ManagementId": 0, "AgentName": null, "Version": null, "ManagementURL": "http://XXX.XX.XXX.
PAGE 286
} ] } "ConnectionState": true, "ManagedState": 7000, "DeviceCapabilities": [ 7, 3, 5, 9, 8, 2, 1 ], "DeviceManagement": [ { "DeviceId": 15390, "ManagementId": 5296, "NetworkAddress": "XXX.XX.XXX.XX", "MacAddress": "88:94:71:DB:E8:98", "InstrumentationName": "MXG610s FC Switch 2SFP", "ManagementProfile": [ { "ManagementProfileId": 5296, "ManagementId": 0, "AgentName": null, "Version": null, "ManagementURL": "http://XXX.XX.XXX.XX" } ] } ], "IpAddress": "XXX.XX.XXX.
PAGE 287
"@odata.id": "/api/GroupService/Groups(500)/ AllLeafDeviceSummaries(15253)", "Id": 15253, "DeviceName": "MX5108n Ethernet Switch", "Model": "MX5108n Ethernet Switch", "Identifier": "8Y280T2", "DeviceServiceTag": "8Y280T2", "Type": 4000, "Status": 1000, "PowerState": 17, "ConnectionState": true, "ManagedState": 7000, "DeviceCapabilities": [ 18, 1, 3, 8, 2, 9, 7, 5 ], "DeviceManagement": [ { "DeviceId": 15253, "ManagementId": 5294, "NetworkAddress": "XXX.XX.XXX.
PAGE 288
}, { "ManagedState": 7000, "DeviceCapabilities": [ 2, 7, 9, 5, 1, 3 ], "DeviceManagement": [], "IpAddress": "XXX.XX.XXX.XX" "@odata.type": "#DeviceService.DeviceMinModel", "@odata.
PAGE 289
}, { "@odata.type": "#DeviceService.DeviceMinModel", "@odata.id": "/api/GroupService/Groups(500)/ AllLeafDeviceSummaries(15256)", "Id": 15256, "DeviceName": "IOM-B1", "Model": "MX7116n Fabric Expander Module", "Identifier": "902B0T2", "DeviceServiceTag": "902B0T2", "Type": 4000, "Status": 1000, "PowerState": 17, "ConnectionState": true, "ManagedState": 7000, "DeviceCapabilities": [ 3, 9, 1, 2, 7, 5 ], "DeviceManagement": [], "IpAddress": "XXX.XX.XXX.XX" }, { "@odata.type": "#DeviceService.
PAGE 290
} /api/GroupService/Groups(group id)/ AllLeafDeviceSummaries?$filter=Type eq 4000& $top=25&$skip=0&$orderby=Identifier asc This URL returns the device data by specifying the order—ascending or descending. GET method for AllLeafDeviceSummaries?$filter=Type eq 4000& $top=25&$skip=0&$orderby=Identifier asc Description Returns the device data by specifying the order—ascending or descending. Privilege VIEW HTTP response codes 200 Example response body { "@odata.
PAGE 291
} }, { ] } "ManagementURL": "http://XXX.XX.XXX.XX" ], "IpAddress": "XXX.XX.XXX.XX" "@odata.type": "#DeviceService.DeviceMinModel", "@odata.
PAGE 292
"Id": 15253, "DeviceName": "MX5108n Ethernet Switch", "Model": "MX5108n Ethernet Switch", "Identifier": "8Y280T2", "DeviceServiceTag": "8Y280T2", "Type": 4000, "Status": 1000, "PowerState": 17, "ConnectionState": true, "ManagedState": 7000, "DeviceCapabilities": [ 18, 1, 3, 8, 2, 9, 7, 5 ], "DeviceManagement": [ { "DeviceId": 15253, "ManagementId": 5294, "NetworkAddress": "XXX.XX.XXX.
PAGE 293
2, 7, 9, 5, 1, 3 }, { ], "DeviceManagement": [], "IpAddress": "XXX.XX.XXX.XX" "@odata.type": "#DeviceService.DeviceMinModel", "@odata.
PAGE 294
"CreationTime": "2017-06-08 21:34:42.681", "UpdatedTime": "2017-06-08 21:34:42.681", "CreatedBy": "root", "UpdatedBy": "", "Visible": true, "DefinitionId": 400, "DefinitionDescription": "UserDefined", "TypeId": 3000, "MembershipTypeId": 12, "Devices": [ { "@odata.id": "/api/GroupService/Groups(19164)/Devices" } ], "AllLeafDevices": [ { "@odata.id": "/api/GroupService/Groups(19164)/AllLeafDevices" } ], "GroupHierarchy": [ { "@odata.
PAGE 295
Table 105. Attributes (continued) Attribute name Description ● 3000 — User defined ● 4000 — Discovery defined ● 5000 — MCM group MembershipTypeId Group membership type. ● 12 — Static ● 24 — Dynamic Link Devices Group link to list group devices. AllLeafDevices Group link to list all group sub groups devices. GroupHierarchy Group link to list the group hierarchy. SubGroup Group link to display the list of sub groups of this group.
PAGE 296
/api/GroupService/GroupTypes This URI represents the group types. GET method for GroupTypes This method returns a list of all the group types. Description Returns all the group types. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "$metadata#Collection(GroupService.GroupType)", "@odata.count": 5, "value": [ { "@odata.id": "/api/GroupService/GroupTypes(1000)", "Id": 1000, "Name": "Internal Group", "Description": "Internal group.
PAGE 297
/api/GroupService/GroupTypes(Id) This URI represents a group type within the collection. GET method for GroupTypes(Id) This method returns the details of a specific group from the collection. Description Returns the details of a specific group. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "$metadata#GroupService.GroupType/$entity", "@odata.id": "/api/GroupService/GroupTypes(1000)", "Id": 1000, "Name": "Internal Group", "Description": "Internal group.
PAGE 298
} ] } "@odata.id": "/api/GroupService/MembershipTypes(24)", "Id": 24, "Name": "Dynamic", "Description": "Dynamic type" Table 109. Attributes Attribute name Description Id ID of the membership type. Name Name of the membership type. Description Description of the membership type. /api/GroupService/MembershipTypes(Id) This URI represents a specific membership type within the collection. GET method for MembershipTypes(Id) This method returns the details of a specific membership type.
PAGE 299
/api/GroupService/AllGroupsHierarchy This URI represents the hierarchy of all the groups and subgroups. GET method for AllGroupsHierarchy This method returns the hierarchy of all the groups and subgroups. Description Returns the hierarchy of all the groups and subgroups. Privilege VIEW HTTP response codes 200 Example response body { } "@odata.context": "$metadata#Collection(GroupService.GroupHierarchy)", "@odata.
PAGE 300
/api/GroupService/Actions/ GroupService.GroupsPrivilegesAction POST method for GroupService.GroupsPrivilegesAction This method returns the group privileges for the logged-in user. Description Returns the group privileges for the user. To view the privileges of multiple groups, provide the group IDs separated by a comma.
PAGE 301
“Privileges”: [[] // ex. [“DEVICE_UPDATE”] } Example response body List of groups on which the user the specified privilege.
PAGE 302
10 Monitor Topics: • • Audit logs Jobs Audit logs /api/ApplicationService/AuditLogs This URI represents a collection of audit logs of the system. GET method for AuditLogs This method returns a collection of audit logs of the system. Description Returns a collection of audit logs. Privilege VIEW HTTP response codes 200 Example response body { } 302 Monitor "@odata.context": "$metadata#Collection(ApplicationService.AuditLog)", "@odata.count": 7, "value": [ { "@odata.
PAGE 303
/api/ApplicationService/AuditLogCategories This API represents information about audit log categories. GET method for /api/ApplicationService/AuditLogCategories This method returns the audit log categories. Description Returns the audit log categories. Privilege HTTP response code Example response body 200 { "@odata.context": "/api/ $metadata#Collection(ApplicationService.AuditLogCategories)", "@odata.count": 1, "value":[ { "@odata.type": "#ApplicationService.
PAGE 304
"Severity": "1000", "Message": "Successfully logged in.", "Category": "Audit", "UserName": "root", "IpAddress": "xx.xx.xx.xx", "MessageArgs": "root || xx.xx.xx.xx", "MessageID": "CUSR0001", "CreatedDate": "2017-04-26 16:13:57.880" } Table 111. Attributes Attribute Description Id Identifier of the SessionService. Severity Severity of the event or error message. Possible values are Critical, Warning, and Informational. Message Message text. Category Category of the message.
PAGE 305
"StartTime": null, "EndTime": null, "Schedule": "0 0/30 * 1/1 * ? *", "State": "Enabled", "CreatedBy": "admin", "UpdatedBy": null, "Visible": false, "Editable": false, "Builtin": true, "Targets": [ { "JobId": 10016, "Id": 500, "Data": "All-Devices", "TargetType": { "Id": 6000, "Name": "GROUP" } } ], "Params": [ { "JobId": 10016, "Key": "defaultInventoryTask", "Value": "TRUE" } ], "LastRunStatus": { "@odata.type": "#JobService.JobStatus", "Id": 2060, "Name": "Completed" }, "JobType": { "@odata.
PAGE 306
Table 112. Filters (continued) Filter name Description Visible Filter by group visibility NextRunBegin Filter by job next run time start. NextRunEnd Filter by next run time end. LastRunBegin Filter by last run time start. LastRunEnd Filter by last run time end. Table 113. Attributes Attribute Description Id ID of the job. JobName Name of the job. JobDescription Description of the job. JobType Type of the job. NextRun The next time when the job will be executed.
PAGE 307
POST method for Jobs This method creates a job. Description Creates a job.
PAGE 308
"JobId": 26097, "Id": 25915, "Data": "", "TargetType": { "Id": 1000, "Name": "DEVICE" } } } ], "Params": [], "Visible": true, "Editable": true, "Builtin": false POST method for Example response body updating { firmware using "JobName": "", Compliance "JobDescription": "", method "Schedule": "", "State": "Enabled", "JobType": { "Id": 5, Name": "Update_Task" }, "Targets": [ { "Id": , "Data": ";;;
PAGE 309
{"Id":, "Data":";", "TargetType":{"Id":1000, "Name":"Device"}}, ], "Params": [ { "Key": "operationName", "Value": "INSTALL_FIRMWARE" }, { "Key": "complianceUpdate", "Value": "false" }, { "Key": "signVerify", "Value": "true" }, { "Key": "stagingValue", "Value": "true" }] } POST method for Example response body configuring { chassis name "JobName": "Update Chassis Name", "JobDescription": "Update Chassis Name", "Schedule": "startnow", "State": "Enabled", "Targets"
PAGE 310
} Quick Deploy of IOM Example response body { 310 Monitor } "Id": 3, "Name": "DeviceAction_Task" "JobName": "Quick Deploy Task", "JobDescription": "Quick Deploy Task", "Schedule": "startnow", "State": "Enabled", "JobType": { "Id": 42, "Name": "QuickDeploy_Task" }, "Params": [ { "Key": "operationName", "Value": "IOM_QUICK_DEPLOY" }, { "Key": "deviceId", "Value": "25041" }, { "Key": "rootCredential", "Value": "password" }, { "Key": "networkTypeV4", "Value": "Dhcp" }, { "Key": "protocolTypeV4", "Value":
PAGE 311
}, { }, { }, { } Quick Deploy of sleds ] } "Value": "SlotSelected=true;SlotType=4000;IPV4Address=;VlanId=;" "Key": "slotId=4", "Value": "SlotSelected=true;SlotType=4000;IPV4Address=;VlanId=;" "Key": "slotId=5", "Value": "SlotSelected=true;SlotType=4000;IPV4Address=;VlanId=;" "Key": "slotId=6", "Value": "SlotSelected=true;SlotType=4000;IPV4Address=;VlanId=;" Example response body { "JobName": "Quick Deploy", "JobDescription": "New Quick Deploy Configuration", "Schedule": "startnow", "State": "Enabled",
PAGE 312
}, { "Key": "slotId=4", "Value": "SlotSelected=true;SlotType=1000;IPV4Address=0.0.0.0;IPV6Address=::;VlanId=1" }, { "Key": "slotId=1", "Value": "SlotSelected=true;SlotType=1000;IPV4Address=0.0.0.
PAGE 313
} Rolling back firmware update —Browse method "Schedule":"", "State":"Enabled", "JobType":{ "Id": 15, "Name":"RollbackSoftware_Task" }, "Params":[ { "Key":"operationName", "Value":"INSTALL_FIRMWARE" }, { "Key":"stagingValue", "Value":"false" }, { "Key":"signVerify", "Value":"true" } ], "Targets":[ { "Id":, "Data": "=
PAGE 314
Failover of management module Example response body { } Chassis backup "JobName": "Failover Operation", "JobDescription": "Failover Operation", "Schedule": "", "State": "Enabled", "Targets": [ { "Id": 25039, "Data": "", "TargetType": { "Id": 1000, "Name": "DEVICE" } } ], "Params": [ { "Key": "operationName", "Value": "FAILOVER" } ], "JobType": { "Id": 3, "Name": "DeviceAction_Task" } Example response body { "JobName": "Backup Task", "JobDescription": "Create a Backup of the chassis", "Schedule": "start
PAGE 315
} Chassis restore } ], "JobType": { "Id": 21, "Name": "Backup_Task" } Example response body { "JobName": "Restore Task", "JobDescription": "Restore an existing device backup" "Schedule": "startnow", "State": "Enabled", "Targets": [], "Params": [ { }, { }, { }, { }, { }, { }, { }, { "Key": "shareType", "Value": "" "Key": "backup_filename", "Value": "
PAGE 316
"Targets": [], "Params": [ { "Key": "checkPathOnly", "Value": "false" }, { "Key": "shareType", "Value": "" }, { "Key": "ShareNetworkFilePath", "Value": "" }, { "Key": "shareAddress", "Value": "" }, { "Key": "testShareWriteAccess", "Value": "true" } ], "JobType": { } Chassis Extract Logs—Local Share 316 Monitor } "Id": 56, "Name": "ValidateNWFileShare_Task" Example response body { "JobName": "Extract Log", "JobDescription": "Extract device log", "Schedule": "startno
PAGE 317
} } "Name": "DebugLogs_Task" Chassis Extract Example response body Logs—NFS Share { "JobName": "Extract Log", "JobDescription": "Extract device log to NFS location", "Schedule": "startnow", "State": "Enabled", "Targets": [ { "Id": 25016, "Data": "", "TargetType": { "Id": 1000, "Name": "DEVICE" } } ], "Params": [ { "Key": "shareAddress", "Value": "2607:f2b1:f083:218::1f2" }, { "Key": "shareName", "Value": "share" }, { "Key": "OPERATION_NAME", "Value": "EXTRACT_LOGS" }, { "Key": "shareType", "Value": "NFS"
PAGE 318
}, { }, { }, { }, { }, { }, { } Device-based reseat for compute, storage, or IOM 318 Monitor "Key": "password", "Value": "sharepass" "Key": "userName", "Value": "administrator" "Key": "shareType", "Value": "CIFS" "Key": "shareName", "Value": "cifs" "Key": "shareAddress", "Value": "2607:f2b1:f083:218::1f2" "Key": "maskSensitiveInfo", "Value": "FALSE" } ], "JobType": { "Id": 18, "Name": "DebugLogs_Task" } Example response body { "JobName": "Virtual_Reseat", "JobDescription": " Virtual_Reseat ", "Schedul
PAGE 319
Slot-based reseat for compute, storage, or IOM Example response body Chassis power off operation Example response body { "JobName": "Slot Based Virtual Reseat", "JobDescription": "Virtual_Reseat_Slot_based", "Schedule": "startnow", "State":"Enabled", "Targets": [ { "Id": 25045, "Data": "", "TargetType": { "Id": 1000, "Name": "DEVICE" } } ], "Params": [ { "Key": "slotType", "Value": "2000" }, { "Key": "operationName", "Value": "VIRTUAL_RESEAT" }, { "Key": "slotNumber", "Value": "6" } ], "JobType": { "Id"
PAGE 320
"JobType": { "Id": 3, "Name": "DeviceAction_Task", "Internal": false } } Blade server (sled) power off operation Example response body IOM power off operation Example response body { "JobName": "Power Off (Non-graceful)", "JobDescription": "Power Control Task: Power Off (Non-graceful)", "Schedule": "startnow", "State": "Enabled", "Targets": [ { "Id": 10771, "Data": "", "TargetType": { "Id": 1000, "Name": "DEVICE" } }], "Params": [ { "Key": "override", "Value": "true" }, { "Key": "powerState", "Value": "
PAGE 321
"Key": "powerState", "Value": "12" }, { "Key": "operationName", "Value": "POWER_CONTROL" }, { "Key": "deviceTypes", "Value": "1000" } ], "JobType": { "Id": 3, "Name": "DeviceAction_Task", "Internal": false } } Slot-based iDRAC reset operation Example response body { } "JobName": "iDRAC Reset_REST", "JobDescription": "iDRAC Reset_Slot2", "Schedule": "startnow", "State": "Enabled", "Targets": [ { "Id": 10099, "Data": "", "TargetType": { "Id": 1000, "Name": "DEVICE" } } ], "Params": [ { "Key": "slotNumber",
PAGE 322
Table 114. Attributes (continued) Attribute Description ● 2000 for computes ● 4000 for IOM PowerState The supported values are: ● 2 (Power On)—Transitions the system to "power on" state. The corresponding ACPI state is G0/S0. ● 5 (Power Cycle (Off Soft))—Turns off the system. The corresponding ACPI state is G2/S5, in which the system consumes a minimal amount of power. The system, then, transitions to "power on" state. The corresponding ACPI state for "power on" is G0/S0.
PAGE 323
"Data": "All-Devices", "TargetType": { "Id": 6000, "Name": "GROUP" } } ], "Params": [ { "JobId": 10016, "Key": "defaultInventoryTask", "Value": "TRUE" } ], "LastRunStatus": { "@odata.type": "#JobService.JobStatus", "Id": 2060, "Name": "Completed" }, "JobType": { "@odata.type": "#JobService.JobType", "Id": 8, "Name": "Inventory_Task", "Internal": false }, "JobStatus": { "@odata.type": "#JobService.JobStatus", "Id": 2020, "Name": "Scheduled" }, "ExecutionHistories@odata.
PAGE 324
Table 115. Attributes (continued) Attribute Description Targets Job targets. Params Parameters for the job. LastRunStatus Indicates the status of the last instance of the job execution. JobStatus Job completion status. ● ● ● ● ● ● ● ● ● ● ● ● Links 2020 — Scheduled 2030 — Queued 2040 — Starting 2050 — Running 2060 — Completed 2070 — Failed 2080 — New 2090 — Warning 2100 — Aborted 2101 — Paused 2102 — Stopped 2103 — Canceled Link to access all execution histories.
PAGE 325
Example response body { } "Id": 26097, "JobName": "Inventory Task", "JobDescription": "Inventory Task", "NextRun": null, "LastRun": "2018-09-14 15:31:13.
PAGE 326
DELETE method for Jobs(Id) This method deletes a specific job. Description Deletes a job. Privilege JOB_MANAGEMENT HTTP response codes 204 Table 117. Attributes Attribute Description Id ID of the job to be deleted. /api/JobService/JobStatuses This URI represents the status of all the jobs. GET method for JobStatuses This method returns the status of all the jobs. Description Returns status of all the jobs.
PAGE 327
}, { }, { }, { }, { }, { }, { }, { } ] } "@odata.type": "#JobService.JobStatus", "@odata.id": "/api/JobService/JobStatuses(2070)", "Id": 2070, "Name": "Failed" "@odata.type": "#JobService.JobStatus", "@odata.id": "/api/JobService/JobStatuses(2080)", "Id": 2080, "Name": "New" "@odata.type": "#JobService.JobStatus", "@odata.id": "/api/JobService/JobStatuses(2090)", "Id": 2090, "Name": "Warning" "@odata.type": "#JobService.JobStatus", "@odata.
PAGE 328
HTTP response codes Example response body 200 { } "@odata.context": "/api/$metadata#JobService.JobStatus/$entity", "@odata.type": "#JobService.JobStatus", "@odata.id": "/api/JobService/JobStatuses(2030)", "Id": 2030, "Name": "Queued" Table 119. Attributes Attribute Description Id ID of the job status. Name Name of the job status. /api/JobService/JobTypes This URI represents all the job types. GET method for JobTypes This method returns the details of all the job types.
PAGE 329
}, { }, { }, { }, { }, { }, { }, { }, { }, { }, { "Name": "RollbackSoftware_Task", "Internal": false "@odata.type": "#JobService.JobType", "@odata.id": "/api/JobService/JobTypes(18)", "Id": 18, "Name": "DebugLogs_Task", "Internal": false "@odata.type": "#JobService.JobType", "@odata.id": "/api/JobService/JobTypes(20)", "Id": 20, "Name": "Restore_Task", "Internal": false "@odata.type": "#JobService.JobType", "@odata.
PAGE 330
}, { } ] } "@odata.type": "#JobService.JobType", "@odata.id": "/api/JobService/JobTypes(42)", "Id": 42, "Name": "QuickDeploy_Task", "Internal": false Table 120. Attributes Attribute Description Id ID of the job type. Name Name of the job type. Internal Indicates if the job is internal. /api/JobService/JobTypes(Id) This URI represents the details of a job type. GET method for JobTypes(Id) This method returns the details of a specific job type. Description Returns details of a job type.
PAGE 331
/api/JobService/Jobs(Id)/ExecutionHistories This URI represents all the execution histories for a job. GET method for ExecutionHistories This method returns the details of all the execution histories for a job. Description Returns details of all executions histories for a job. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "/api/ $metadata#Collection(JobService.ExecutionHistory)", "@odata.count": 5, "value": [ { "@odata.type": "#JobService.
PAGE 332
"JobName": "Default Inventory Task", "Progress": "100", "StartTime": "2018-09-14 14:00:00.526", "EndTime": "2018-09-14 14:00:29.312", "LastUpdateTime": "2018-09-14 14:00:29.312", "ExecutedBy": "admin", "JobId": 10016, "JobStatus": { "@odata.type": "#JobService.JobStatus", "Id": 2060, "Name": "Completed" }, "ExecutionHistoryDetails@odata.navigationLink": "/api/JobService/ Jobs(10016)/ExecutionHistories(18774)/ExecutionHistoryDetails" }, { "@odata.type": "#JobService.ExecutionHistory", "@odata.
PAGE 333
Table 122. Attributes (continued) Attribute Description EndTime The end time of job execution. Schedule Job schedule (cron string). State Indicates whether the job is enabled or disabled. LastUpdatedTime Timestamp when the job-execution history was last updated. ExecutedBy Details of who executed the job. JobId Job associated with the execution history. JobStatus Job execution history detail completion status. Links Link to access details of all execution histories.
PAGE 334
} ] } "Value": "Running\nCompleted", "ExecutionHistoryId": 18683, "JobStatus": { "@odata.type": "#JobService.JobStatus", "Id": 2060, "Name": "Completed" } Table 123. Attributes Attribute Description Id Job execution history detail ID. Progress Percentage of completion. StartTime The start time of job execution. EndTime The end time of job execution. Key Job execution history details key. Value Job execution history details value.
PAGE 335
Or { } "AllJobs": true, /api/JobService/Actions/JobService.DisableJobs POST method for JobService.DisableJobs This method disables the selected jobs. Description Disables the selected jobs.
PAGE 336
● A single job ● A set of jobs based on the filters you provide ● All jobs Privilege DEVICE_CONFIGURATION HTTP response codes 201 Example request body { } "JobIds": [100,200,300], Or { } "Filters": { "Status": 2020, "State": "", "JobType": "AlertSubscription_Task", "StartTime": "2017-06-06 10:00:00.00", "EndTime": "2017-06-07 10:00:00.00" } Or { } "AllJobs": true, /api/JobService/Actions/JobService.Schedule This API represents the job schedule information.
PAGE 337
/api/JobService/Actions/JobService.RunJobs POST method for JobService.RunJobs This method executes the selected jobs. Description Executes the selected jobs.
PAGE 338
} "JobIds": [100,200,300], Or { } "Filters": { "Status": 2020, "State": "", "JobType": "AlertSubscription_Task", "StartTime": "2017-06-06 10:00:00.00", "EndTime": "2017-06-07 10:00:00.00" } Or { } "AllJobs": true, /api/JobService/Actions/JobService.Schedule This API represents the job schedule information. POST method for job schedule This method returns the job schedule information. Description Returns information about job schedules.
PAGE 339
HTTP response codes Example response body 204 { } "JobIds": [], "AllJobs": true, "Filters": { "Status": 2020, "State": "", "JobType": "", "StartTime": "", "EndTime": "" } /api/JobService/Actions/JobService.Cancel This API represents information about jobs that are canceled. POST method for canceled jobs This method returns information about jobs that are canceled. Description Returns information about a canceled job.
PAGE 340
} } "State": "", "JobType": "", "StartTime": "", "EndTime": "" /api/JobService/Actions/JobService.Resume This API returns information about jobs that are resumed. POST method for resumed jobs This method returns information about jobs that are resumed. Description Returns information about jobs that are resumed.
PAGE 341
"Id": , "Data": "", "TargetType": { "Id": 1000 , "Name": "DEVICE" } } } ], "Params": [ { "Key": "operationName", "Value": "SET_COMMENT_IN_LOG" } ] Monitor 341
PAGE 342
11 Reset application Topics: • /api/ApplicationService/Actions/ApplicationService.ResetApplication /api/ApplicationService/Actions/ ApplicationService.ResetApplication This URI resets the application and select between resetting all data or only resetting the configuraiton. POST method for ResetApplication This method resets the application. You can either reset only the configuration or also clear all the data.
PAGE 343
12 Console version Topics: • /api/ApplicationService/Info /api/ApplicationService/Info This URI represents the product information. GET method for Info This method returns the product information. Description Returns the product information. Privilege VIEW HTTP response codes 200 Example response body { } "@odata.context": "/api/$metadata#ApplicationService.Info/$entity", "@odata.type": "#ApplicationService.Info", "@odata.
PAGE 344
13 Console capabilities Topics: • /api/ApplicationService/Capabilities /api/ApplicationService/Capabilities This URI represents the capabilities of the management console—OpenManage Enterprise or OME–Modular. GET method for Capabilities This method returns the capabilities of the management console—OME–Modular or OME–Modular. These two management consoles have different capabilities. Description Returns the capabilities of the management console.
PAGE 345
"@odata.context": "/api/ $metadata#Collection(ApplicationService.Capability)", "@odata.count": 7, "value": [ { "@odata.type": "#ApplicationService.Capability", "Name": "DEVICE_MANAGEMENT", "Description": "This capability tells whether the console is capable of restricting execution of tasks based on onboarded and notonboarded devices" }, { "@odata.type": "#ApplicationService.Capability", "Name": "BOOT_TO_NETWORK_ISO", "Description": "This capability is for booting devices from network iso." }, { "@odata.
PAGE 346
14 Search This resource enables you to search for navigation links and documents using query strings. Use the URIs in this resource to search for navigation links and documents by providing search query strings. Topics: • /api/SearchService/Actions/SearchService.Search /api/SearchService/Actions/SearchService.Search POST method for SearchService.Search This method performs a search using the query string that you provide and returns links to the corresponding navigation pages.
PAGE 347
"_id": "3864", "_score": 1, "_source": { "tskNm": "Device_Config_Task (1493523261197) - for Device with Id: 1864", "tskTyp": "Device Config Task", "tskStatus": "Task status is Failed", "tskDesc": "Device_Config_Task (1493523261197) - for Device with Id: 1864", "tskCreatedBy": "system", "tskId": "3864" } } ] } } Table 124. Attributes Attribute name Description QueryString String to search. FilterType Indexes to be searched for the query string.
PAGE 348
15 Session Topics: • • • • • /api/SessionService /api/SessionService/Sessions /api/SessionService/Sessions(Id) /api/SessionService/SessionConfiguration /api/SessionService/Actions/SessionService.SessionConfigurationUpdate /api/SessionService This URI represents the collection of session services. GET method for SessionService This method returns a collection of the sessions services. Description Returns a collection of session services.
PAGE 349
/api/SessionService/Sessions This URI represents a collection of active session services. GET method for Sessions This method returns the collection of active session service. Description Returns a collection of active session services. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "$metadata#Collection(SessionService.Session)", "@odata.count": 1, "value": [ { "@odata.
PAGE 350
HTTP response codes Example request body 200 { } Example response body { } "UserName":"root", "Password":"linux", "SessionType":"API" "Id": "7b723932-a119-4843-a5b7-7a122e4def99", "Description": "root", "Name": "API", "UserName": "root", "Password": null, "Roles": [ "ADMINISTRATOR" ], "IpAddress": "xx.xx.xx.xx", "StartTimeStamp": "2017-04-17 20:07:12.357", "LastAccessedTimeStamp": "2017-04-17 20:07:12.357" Table 127. Attributes Attribute Name Description UserName The Session user name.
PAGE 351
Example request body { } Example response body { } "UserName":"root", "Password":"linux", "SessionType":"API" "Id": "7b723932-a119-4843-a5b7-7a122e4def99", "Description": "root", "Name": "API", "UserName": "root", "Password": null, "Roles": [ "ADMINISTRATOR" ], "IpAddress": "xx.xx.xx.xx", "StartTimeStamp": "2017-04-17 20:07:12.357", "LastAccessedTimeStamp": "2017-04-17 20:07:12.357" Table 128. Attributes Attribute Name Description Id The unique identifier of the SessionService.
PAGE 352
HTTP response codes 200 Example response body { "@odata.context": "/api/ $metadata#Collection(SessionService.SessionConfiguration)", "@odata.count": 6, "value": [ { "@odata.type": "#SessionService.SessionConfiguration", "SessionType": "GUI", "MaxSessions": 6, "SessionTimeout": 1320000, "MinSessionTimeout": 60000, "MaxSessionTimeout": 86400000, "MinSessionsAllowed": 1, "MaxSessionsAllowed": 6 }, { "@odata.type": "#SessionService.
PAGE 353
/api/SessionService/Actions/ SessionService.SessionConfigurationUpdate POST method for SessionService.SessionConfigurationUpdate Description This method adds the ability to configure the inactivity (not active sessions) timeout interval and the maximum number of sessions that are enabled per session type. When these properties are changed, the properties of the current active sessions are not terminated or modified.
PAGE 354
16 APIs specific to OpenManage Enterprise – Modular Edition Topics: • • • • • • • • • • • • • /api/ApplicationService/Settings /api/ApplicationService/Network/CurrentAddressConfiguration /api/ApplicationService/Network/AddressConfiguration /api/ApplicationService/Actions/ApplicationService.GetConfiguration /api/ApplicationService/Actions/ApplicationService.
PAGE 355
Privilege APPLIANCE_SETUP HTTP response codes 201 Example Response Body { "ConsoleSetting": [{ "Name": "WARRANTY_EXPIRY_SETTING", "DefaultValue": "90", "Value": "1", "DataType": "java.lang.Boolean", "GroupName": "WARRANTY_SCOREBOARD" } ] } /api/ApplicationService/Network/ CurrentAddressConfiguration This URI represents the current network IP configuration. NOTE: This API is not available in OpenManage Enterprise from version 3.3.1.
PAGE 356
} "CurrentAlternateDNSServer": "" }, "DnsSetting": { "DnsFQDName": "dell.example.com", "DnsDomainName": "example.com" } Table 129. Attributes Attribute name Description Ipv4Setting.Enable IPv4 network settings status. Ipv4Setting.EnableDHCP Obtain IPv4 via DHCP server status. Ipv4Setting.CurrentIPAddress Current IPv4 address. Ipv4Setting.CurrentSubMask Current IPv4 subnet mask address. Ipv4Setting.CurrentGateway Current IPv4 gateway address. Ipv4Setting.
PAGE 357
HTTP response codes Example response body 200 { "@odata.context": "/api/$metadata#Network.AddressConfiguration/ $entity", "@odata.type": "#Network.AddressConfiguration", "@odata.
PAGE 358
"EnableDHCP": true, "StaticIPAddress": "", "StaticSubnetMask": "", "StaticGateway": "", "UseDHCPForDNSServerNames": true, "StaticPreferredDNSServer": "", "StaticAlternateDNSServer": "" } Example response body 358 { }, "Ipv6Configuration": { "Enable": false, "EnableAutoConfiguration": true, "StaticIPAddress": "", "StaticPrefixLength": 0, "StaticGateway": "", "UseDHCPForDNSServerNames": true, "StaticPreferredDNSServer": "", "StaticAlternateDNSServer": "" }, "ManagementVLAN": { "EnableVLAN": false, "Id": 1
PAGE 359
"Ipv4CurrentAlternateDNSServer": "192.168.1.3", "Ipv6CurrentPreferredDNSServer": "", "Ipv6CurrentAlternateDNSServer": "", "FqdndomainName": "" } }, "Delay": 0 Table 130. Attributes Attribute name Description EnableNIC Network interface controller for public networking access. Ipv4Configuration.Enable Enable IPv4 network settings. Ipv4Configuration.EnableDHCP Obtain IPv4 via DHCP server. Ipv4Configuration.StaticIPAddress Set Static IPv4 address. Ipv4Configuration.
PAGE 360
/api/ApplicationService/Actions/ ApplicationService.GetConfiguration POST method for ApplicationService.GetConfiguration This method returns a collection of all the settings of the system or a group of settings. Description Returns a collection of settings.
PAGE 361
{ }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, "Name": "LoginSecurity.1#LockoutByUsernameEnable", "Value": false "Name": "LoginSecurity.1#LockoutByIPEnable", "Value": true "Name": "LoginSecurity.1#IPRangeEnable", "Value": false "Name": "RemoteSystemLog.1#RemoteSyslogEnable", "Value": true "Name": "RemoteSystemLog.1#destinationAddress", "Value": "10.36.0.167" "Name": "RemoteSystemLog.1#Port", "Value": 514 "Name": "RemoteSystemLog.
PAGE 362
{ }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, 362 "Name": "SNMPAlerts.1#Enable", "Value": true "Name": "SNMPAlerts.1#DestinationIP", "Value": "10.36.0.167" "Name": "SNMPAlerts.1#port", "Value": 162 "Name": "SNMPAlerts.1#version", "Value": "SNMPV1" "Name": "SNMPAlerts.1#CommunityString", "Value": "public" "Name": "SNMPAlerts.2#Enable", "Value": false "Name": "SNMPAlerts.2#DestinationIP", "Value": null "Name": "SNMPAlerts.2#port", "Value": 0 "Name": "SNMPAlerts.
PAGE 363
{ }, { }, { }, { }, { }, { }, { }, { }, { "Name": "SNMPAlerts.4#version", "Value": null "Name": "SNMPAlerts.4#CommunityString", "Value": null "Name": "TimeConfig.1#TimeZone", "Value": "TZ_ID_11" "Name": "TimeConfig.1#NTPEnable", "Value": false "Name": "TimeConfig.1#NTPServer1", "Value": null "Name": "TimeConfig.1#NTPServer2", "Value": null "Name": "TimeConfig.1#NTPServer3", "Value": null "Name": "TimeConfig.1#systemTime", "Value": "2018-09-25 08:39:07" "Name": "LocalAccessConfiguration.
PAGE 364
}, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { 364 "Name": "EmailAlertsConf.1#useCredentials", "Value": false "Name": "EmailAlertsConf.1#useSSL", "Value": false "Name": "EmailAlertsConf.1#user", "Value": null "Name": "EmailAlertsConf.1#Password", "Value": null "Name": "SNMPService.1#Enable", "Value": true "Name": "SNMPService.1#Port", "Value": 161 "Name": "SNMPService.1#CommunityName", "Value": "public" "Name": "SSH.1#Enable", "Value": true "Name": "SSH.
PAGE 365
}, { }, { }, { }, { }, { }, { }, { }, { }, { "Name": "Network#SettingType", "Value": "Network" "Name": "Network#MgmtVLANId", "Value": "1" "Name": "Network#EnableVLAN", "Value": false "Name": "Network#Ipv4Settings#EnableIPv4", "Value": true "Name": "Network#Ipv4Settings#EnableDHCP", "Value": true "Name": "Network#Ipv4Settings#StaticIPAddress", "Value": "" "Name": "Network#Ipv4Settings#StaticSubnetMask", "Value": "" "Name": "Network#Ipv4Settings#StaticGateway", "Value": "" "Name": "Network#Ipv4Settings#UseD
PAGE 366
}, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { "Name": "Network#Ipv6Settings#StaticPreferredDNSServer", "Value": "" "Name": "Network#Ipv6Settings#StaticAlternateDNSServer", "Value": "" "Name": "Network#GeneralSettings#EnableNIC", "Value": true "Name": "Network#GeneralSettings#RegisterDNS", "Value": true "Name": "Network#GeneralSettings#DnsName", "Value": "MX-01PTCMSM1234" "Name": "Network#GeneralSettings#UseDHCPForDomainName", "Value": true "Name": "Network#GeneralSettings#DnsDomainName", "Value":
PAGE 367
}, { }, { }, { }, { }, { }, { "Name": "Users.2#Name", "Value": "ravi2" "Name": "Users.2#Privilege", "Value": "10" "Name": "Users.2#Enable", "Value": true "Name": "Users.2#Password", "Value": null "Name": "Users.3#userType", "Value": 1 "Name": "Users.3#SHA256Password", "Value": "$2a $10$dTg7igLe1neXnZthG9vzP.8ML.tcUOxyeP.i3XRD7eYfKMlJOqMDe" }, { "Name": "Users.3#Name", "Value": "ravi" }, { "Name": "Users.3#Privilege", "Value": "10" }, { "Name": "Users.3#Enable", "Value": true }, { "Name": "Users.
PAGE 368
"Name": "Users.5#SHA256Password", "Value": "$2a $10$H0cK06cAnceieSNuaI3JT.TI8DfX49XkdVcNbHC4G2X92lAhCAstS" }, { "Name": "Users.5#Name", "Value": "MSMMegatronTeam" }, { "Name": "Users.5#Privilege", "Value": "10" }, { "Name": "Users.5#Enable", "Value": true }, { "Name": "Users.5#objectGuid", "Value": "d22005b6-0ce5-40ed-88d0-7f7759b52f25" }, { "Name": "Users.5#Password", "Value": null }, { "Name": "Users.5#directoryType", "Value": "AD" }, { "Name": "Users.5#directoryName", "Value": "dell.
PAGE 369
{ }, { }, { }, { }, { }, { }, { }, { } } ] } ] } "Name": "LDAP.1#serverType", "Value": "MANUAL" "Name": "LDAP.1#DomainController1", "Value": "10.36.0.167" "Name": "LDAP.1#Port", "Value": 636 "Name": "LDAP.1#BaseDN", "Value": "dc=dell,dc=com" "Name": "LDAP.1#NetworkTimeout", "Value": 120 "Name": "LDAP.1#SearchTimeout", "Value": 120 "Name": "LDAP.1#CertValidationEnable", "Value": false "Name": "LDAP.1#certificateFile", "Value": "" Table 131.
PAGE 370
/api/ApplicationService/Actions/ ApplicationService.ApplyConfiguration POST method for ApplicationService.ApplyConfiguration This method updates the system settings. Description Updates the system settings. Privilege APPLIANCE_SETUP HTTP response codes 200 Example request body 370 { "SystemConfiguration": { "Comments": [ "Export type is Normal,JSON" ], "Model": "POWEREDGE MX7000", "ServiceTag": "01PTCMSM", "TimeStamp": "2018-09-25T13:39:10.933Z", "Components": [ { "FQDD": "MM.Embedded.
PAGE 371
{ }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, "Name": "LoginSecurity.1#LockoutByIPEnable", "Value": true "Name": "LoginSecurity.1#IPRangeEnable", "Value": false "Name": "RemoteSystemLog.1#RemoteSyslogEnable", "Value": true "Name": "RemoteSystemLog.1#destinationAddress", "Value": "10.36.0.167" "Name": "RemoteSystemLog.1#Port", "Value": 514 "Name": "RemoteSystemLog.2#RemoteSyslogEnable", "Value": false "Name": "RemoteSystemLog.
PAGE 372
{ }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, 372 "Name": "SNMPAlerts.1#DestinationIP", "Value": "10.36.0.167" "Name": "SNMPAlerts.1#port", "Value": 162 "Name": "SNMPAlerts.1#version", "Value": "SNMPV1" "Name": "SNMPAlerts.1#CommunityString", "Value": "public" "Name": "SNMPAlerts.2#Enable", "Value": false "Name": "SNMPAlerts.2#DestinationIP", "Value": null "Name": "SNMPAlerts.2#port", "Value": 0 "Name": "SNMPAlerts.2#version", "Value": null "Name": "SNMPAlerts.
PAGE 373
{ }, { }, { }, { }, { }, { }, { }, { "Name": "SNMPAlerts.4#CommunityString", "Value": null "Name": "TimeConfig.1#TimeZone", "Value": "TZ_ID_11" "Name": "TimeConfig.1#NTPEnable", "Value": false "Name": "TimeConfig.1#NTPServer1", "Value": null "Name": "TimeConfig.1#NTPServer2", "Value": null "Name": "TimeConfig.1#NTPServer3", "Value": null "Name": "TimeConfig.1#systemTime", "Value": "2018-09-25 08:39:07" "Name": "LocalAccessConfiguration.
PAGE 374
}, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { 374 "Name": "EmailAlertsConf.1#useSSL", "Value": false "Name": "EmailAlertsConf.1#user", "Value": null "Name": "EmailAlertsConf.1#Password", "Value": null "Name": "SNMPService.1#Enable", "Value": true "Name": "SNMPService.1#Port", "Value": 161 "Name": "SNMPService.1#CommunityName", "Value": "public" "Name": "SSH.1#Enable", "Value": true "Name": "SSH.1#Port", "Value": 22 "Name": "SSH.
PAGE 375
}, { }, { }, { }, { }, { }, { }, { }, { "Name": "Network#MgmtVLANId", "Value": "1" "Name": "Network#EnableVLAN", "Value": false "Name": "Network#Ipv4Settings#EnableIPv4", "Value": true "Name": "Network#Ipv4Settings#EnableDHCP", "Value": true "Name": "Network#Ipv4Settings#StaticIPAddress", "Value": "" "Name": "Network#Ipv4Settings#StaticSubnetMask", "Value": "" "Name": "Network#Ipv4Settings#StaticGateway", "Value": "" "Name": "Network#Ipv4Settings#UseDHCPObtainDNSServerAddresses", "Value": true }, { "Name"
PAGE 376
}, { }, { }, { }, { }, { }, { }, { }, { }, { }, { "Name": "Network#Ipv6Settings#StaticAlternateDNSServer", "Value": "" "Name": "Network#GeneralSettings#EnableNIC", "Value": true "Name": "Network#GeneralSettings#RegisterDNS", "Value": true "Name": "Network#GeneralSettings#DnsName", "Value": "MX-01PTCMSM1234" "Name": "Network#GeneralSettings#UseDHCPForDomainName", "Value": true "Name": "Network#GeneralSettings#DnsDomainName", "Value": "" "Name": "Network#GeneralSettings#AutoNegotiation", "Value": true "Name"
PAGE 377
}, { }, { }, { }, { }, { "Name": "Users.2#Privilege", "Value": "10" "Name": "Users.2#Enable", "Value": true "Name": "Users.2#Password", "Value": null "Name": "Users.3#userType", "Value": 1 "Name": "Users.3#SHA256Password", "Value": "$2a $10$dTg7igLe1neXnZthG9vzP.8ML.tcUOxyeP.i3XRD7eYfKMlJOqMDe" }, { "Name": "Users.3#Name", "Value": "ravi" }, { "Name": "Users.3#Privilege", "Value": "10" }, { "Name": "Users.3#Enable", "Value": true }, { "Name": "Users.3#Password", "Value": null }, { "Name": "Users.
PAGE 378
{ }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, 378 "Name": "Users.5#Name", "Value": "MSMMegatronTeam" "Name": "Users.5#Privilege", "Value": "10" "Name": "Users.5#Enable", "Value": true "Name": "Users.5#objectGuid", "Value": "d22005b6-0ce5-40ed-88d0-7f7759b52f25" "Name": "Users.5#Password", "Value": null "Name": "Users.5#directoryType", "Value": "AD" "Name": "Users.5#directoryName", "Value": "dell.com" "Name": "ActiveDirectory.1#name", "Value": "dell.
PAGE 379
{ }, { }, { }, { }, { }, { }, { } Example response body { } } ] } ] } "Name": "LDAP.1#DomainController1", "Value": "10.36.0.167" "Name": "LDAP.1#Port", "Value": 636 "Name": "LDAP.1#BaseDN", "Value": "dc=dell,dc=com" "Name": "LDAP.1#NetworkTimeout", "Value": 120 "Name": "LDAP.1#SearchTimeout", "Value": 120 "Name": "LDAP.1#CertValidationEnable", "Value": false "Name": "LDAP.1#certificateFile", "Value": "" "JobId": 38758 Table 132.
PAGE 380
Brand /api/ApplicationService/Actions/ApplicationService.BrandInfo This URI represents the brand information. POST method for BrandInfo This method returns the brand information. Description Returns the brand information. Privilege VIEW HTTP response codes 200 Example response body { } "BrowserTitle": "globalNavigation.consoleBrowserTitle", "ConsoleTitle": "globalNavigation.
PAGE 381
OR { } Example response body { } "BrandType":"DEFAULT" 200 OK Multichassis management /api/ManagementDomainService This method represents the role of the chassis in a Multi-Chassis Management (MCM)domain. GET method for ManagementDomainService This method returns the role of the chassis in a MCM domain. Description Returns the role of the chassis in a MCM domain. Privilege VIEW HTTP response codes 200 Example response body Output — Standalone chassis: { "@odata.
PAGE 382
} Output — Lead chassis: { "@odata.context": "/api/ $metadata#ManagementDomainService.ManagementDomainService", "@odata.type": "#ManagementDomainService.ManagementDomainService", "@odata.
PAGE 383
ManagementDomainService/ConfigurationTypes" } Table 133. Attributes Attribute Description GroupId Unique group ID across different domains. DeviceGroupId Group configuration record ID. GroupName Name of the group. GroupDescription Description of the group. JoinApproval Join approval ● Automatic: Join requests from a standalone chassis are automatically approved. ● Manual: Join requests from a standalone chassis are queued on the lead for administrator's approval.
PAGE 384
}, { }, { }, { }, { } Example response body } "ConfigType": "SecuritySettings", "Enabled": false "ConfigType": "NetworkServices", "Enabled": false "ConfigType": "LocalAccessConfiguration", "Enabled": false } ],"VirtualIPConfiguration": { "IPv4": { "StaticIPv4Address":"10.35.155.155", "SubnetMask":"255.255.255.32", "Gateway":"10.35.2.
PAGE 385
{ }, { } Example response body } "ConfigType": "LocalAccessConfiguration", "Enabled": false Request for editing a group { } Example request body ] "ConfigType": "NetworkServices", "Enabled": false "JobId": 36181, "Status": "SUCCESS" Request for configuring static IPv4 on the lead chassis { } "GroupName": "256", "GroupDescription": "", "JoinApproval": "Manual", "ConfigReplication": [ { "ConfigType": "UserAuthentication", "Enabled": false }, { "ConfigType": "NetworkServices", "Enabled": false }, {
PAGE 386
Example response body Request for configuring static IPv4 on the lead chassis { "GroupId": "4964", "Status": "Success" } NOTE: You can use the API, /api/JobService/Jobs(JobId) for polling the job status. Table 134. Attributes Attribute Description GroupId Unique group ID across different domains. GroupName Name of the group. GroupDescription Description of the group. JoinApproval Join approval ● Automatic: Join requests from a stand-alone chassis are automatically approved.
PAGE 387
Example response body { "@odata.context": "/api/ $metadata#Collection(ManagementDomainService.DiscoveredDomain)", "@odata.count": 3, "value": [ { "@odata.type": "#ManagementDomainService.DiscoveredDomain", "GroupId": "053ca12c-e181-4502-b4b5-7f5090bbf08c", "GroupName": "null", "GroupDescription": "", "PublicAddress": [ "10.35.0.
PAGE 388
Table 135. Attributes (continued) Attribute Description GroupName Group name for the MCM domain group. GroupDescription Description of the group. Address IP address of the domain. Name Name of the chassis. Description Description. Identifier Service Tag of the chassis. DomainTypeId Information for internal programmatic use. DomainTypeValue Information for internal programmatic use. DomainRoleTypeId ID of the domain role.
PAGE 389
}, { "@odata.type": "#ManagementDomainService.ConfigurationType", "@odata.id": "/api/ManagementDomainService/ConfigurationTypes(3)", "Id": 3, "Name": "AlertDestinations", "Description": "Alert Destinations" }, { "@odata.type": "#ManagementDomainService.ConfigurationType", "@odata.id": "/api/ManagementDomainService/ConfigurationTypes(4)", "Id": 4, "Name": "LocalAccessConfiguration", "Description": "Local Access configuration" }, { "@odata.type": "#ManagementDomainService.ConfigurationType", "@odata.
PAGE 390
/api/ManagementDomainService/ConfigurationTypes(Id) This URI represents a specific configuration type supported on the management domain service. GET method for ConfigurationTypes(Id) This method returns the details of a specific configuration type supported on the domain service. Description Returns the details of a specific configuration type. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "$metadata#ManagementDomainService.ConfigurationType/ $entity", "@odata.
PAGE 391
HTTP response codes 200 Example request body Example response body N/A { "@odata.context": "/api/ $metadata#Collection(ManagementDomainService.Domain)", "@odata.count": 1, "value":[ { "@odata.type": "#ManagementDomainService.Domain", "@odata.id": "/api/ManagementDomainService/Domains(10100)", "Id": 10100, "DeviceId": 10069, "PublicAddress":["100.97.208.
PAGE 392
Table 138. Attributes (continued) Attribute Description Local ● TRUE — Indicates that this domain is the local domain where the API is run. ● FALSE — Indicates that this domain is the remote domain where the API is run. GroupId Unique identifier of the group across different domains. GroupName Group name for the MCM domain group. BackupLead Indicates if the domain is a backup lead. Capabilities Indicates the capabilities of the domain.
PAGE 393
} "Port": "443", "Local": true, "GroupId": "4e361023-07cc-4b98-af3f-ba7c2ef2f5b9", "GroupName": "DDD" Table 139. Attributes Attribute Description Id Record ID. DeviceId Device ID. Address IP address. Name Name of the chassis. Description Description of the chassis. Identifier Service Tag of the chassis. DomainTypeId Information for internal programmatic use. DomainTypeValue Information for internal programmatic use. DomainRoleTypeId ID of the domain role.
PAGE 394
"@odata.context": "/api/ $metadata#Collection(ManagementDomainService.PendingDomain)", "@odata.count": 1, "value": [ { "@odata.type": "#ManagementDomainService.PendingDomain", "@odata.id": "/api/ManagementDomainService/PendingDomains(36197)", "Id": 36197, "JobId": 36196, "State": 1001, "PublicAddress": [ "10.35.224.67" ], "Name": "MX-MCM1", "Description": "POWEREDGE MX7000", "Identifier": "MCM1", "DomainType": "MSM", "Version": "1.00.10" } ] } Table 140. Attributes Attribute Description Id Record ID.
PAGE 395
/api/ManagementDomainService/PendingDomains(Id) This URI represents a specific pending domain-related requests in the collection of pending requests. GET method for PendingDomains(Id) This method returns a specific pending request that is made for joining an MCM domain group. Description Returns a specific pending request for joining an MCM domain group. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "$metadata#ManagementDomainService.
PAGE 396
/api/ManagementDomainService/Actions/ ManagementDomainService.Domains POST method for ManagementDomainService.Domains This method adds a chassis domain to the MCM domain group. This API is applicable only to a LEAD domain. If you run this API on other types of domains, the HTTP response 400 is returned. Description Adds a chassis domain to the MCM domain group.
PAGE 397
/api/ManagementDomainService/Actions/ ManagementDomainService.Join POST method for ManagementDomainService.Join This method allows a standalone chassis (OME–Modular) to join an MCM domain group. Description Allows a standalone chassis (OME–Modular) to join an MCM domain group. Privilege APPLIANCE_SETUP HTTP response codes 200 Example request body { } Example response body { } "GroupId": "671497bc-9d61-4067-afcd-48f9df5e8dd2" "JobId": 12764, "Status": "PENDING" Table 143.
PAGE 398
Table 144. Attributes Attribute Description JobId Job ID created for the operation. Status Status of the operation. NOTE: The Status is always displayed as SUCCESS. To track the status, use the JobId. /api/ManagementDomainService/Actions/ ManagementDomainService.Delete POST method for ManagementDomainService.Delete This method removes a specific member chassis domain from an MCM domain group. This API is applicable only to LEAD domains.
PAGE 399
HTTP response codes Example request body 200 { } Example response body { } "GroupId": "671497bc-9d61-4067-afcd-48f9df5e8dd2" "JobId": 13514, "Status": "SUCCESS" Table 146. Attributes Attribute Description GroupId Group ID of the lead domain. JobId Job ID for the delete operation. NOTE: Use the Job API to poll the status of the delete JobId. After the job is complete, all the chassis domains in the group transition to STANDALONE type. Status Status of the delete operation.
PAGE 400
} Example request body Example response body "Status": "SUCCESS" Approving or rejecting multiple pending requests [ { "Id": 36197, "Approval": true }, { "Id": 36198, "Approval": false } ] Approving or rejecting multiple pending requests { "Status": "SUCCESS" } Table 147. Attributes Attribute name Description Id ID of the pending domain that requested to join the group. Approval Indicates if the request is approved or rejected.
PAGE 401
Table 148. Attributes Attribute Description Id Member chassis identifier on the lead. JobId Job ID for tracking the status of unassigning the backup lead. NOTE: Use the API, /api/JobService/ Jobs(JobId) to poll the status of the assign JobId. /api/ManagementDomainService/Actions/ ManagementDomainService.ReassignBackupLead This URI unassigns the existing backup lead in the chassis group and assigns a member in the group as the new backup lead.
PAGE 402
Privilege APPLIANCE_SETUP HTTP Response Code 200 Example request body [{ "Id":25706 }] Example response body { } "JobId": 25857 Table 150. Attributes Attribute Description Id Member chassis identifier on the lead. JobId Job ID for tracking the status of the task of unassigning the backup lead. /api/ManagementDomainService/Actions/ ManagementDomainService.PromoteBackupLead This URI promotes the backup lead chassis as the lead chassis of the group.
PAGE 403
Table 151. Attributes (continued) Attribute Description PurgeLeadReferences If this flag is passed as true, all old lead references are purged on new lead during the promote process. JobId Job ID for tracking the status of the unassign backup lead operation. NOTE: You can use the API, /api/JobService/ Jobs(JobId) to poll the job status. /api/ManagementDomainService/Actions/ ManagementDomainService.
PAGE 404
FIPS mode settings /api/ApplicationService/Security/SecurityConfiguration This URI represents the security configuration. GET method for SecurityConfiguration This method returns the security configuration. Description Returns the security configuration. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "/api/ $metadata#ApplicationService.FIPSModeConfiguration/$entity", "@odata.type": "#ApplicationService.FIPSModeConfiguration", "@odata.
PAGE 405
"NodeTypes@odata.navigationLink": "/api/NetworkService/NodeTypes", "FabricHealthStatuses@odata.navigationLink": "/api/NetworkService/ FabricHealthStatuses", "FabricActivityTypes@odata.navigationLink": "/api/NetworkService/ FabricActivityTypes", "FabricActivityStatuses@odata.navigationLink": "/api/NetworkService/ FabricActivityStatuses", "PortRoles@odata.navigationLink": "/api/NetworkService/PortRoles", "PortBlinkStatuses@odata.
PAGE 406
"Severity": "Warning", "Resolution": "Make sure that all the ISLs are connected as per the specification.", "Category": "Audit", "DetailedDescription": "", "TimeStamp": "2018-07-18T05:29:52Z" }, { "MessageId": "NFAB0018", "Message": "The network fabric is not healthy because uplinks are not configured.", "MessageArgs": [], "Severity": "Warning", "Resolution": "Make sure at least one uplink is configured to the fabric.
PAGE 407
} Example for creating fabric "Description": "update 01", "OverrideLLDPConfiguration": "Disabled", "FabricDesignMapping": [ { "DesignNode": "Switch-A", "PhysicalNode": "CBJXLN2" }, { "DesignNode": "Switch-B", "PhysicalNode": "F13RPK2" } ], "FabricDesign": { "Name": "2xMX9116n_Fabric_Switching_Engines_in_different_chassis" } Example response body { } "Name": "Fabric 1", "Description": "Description 01", "OverrideLLDPConfiguration": "Disabled", "FabricDesignMapping": [ { "DesignNode": "Switch-A", "Physical
PAGE 408
Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "/api/ $metadata#Collection(NetworkService.FabricDesign)", "@odata.count": 3, "value": [ { "@odata.type": "#NetworkService.FabricDesign", "@odata.
PAGE 409
}, { }, { "DestinationInterface": "ethernet1/1/40" "SourceNode": "Switch-A", "SourceInterface": "ethernet1/1/39", "DestinationNode": "Switch-B", "DestinationInterface": "ethernet1/1/39" } ], "FabricDesignNode": [ { "NodeName": "Switch-A", "ChassisName": "Chassis-X", "Slot": "Slot-A1", "Type": "WeaverSwitch" }, { "NodeName": "Switch-B", "ChassisName": "Chassis-X", "Slot": "Slot-A2", "Type": "WeaverSwitch" } ] "@odata.type": "#NetworkService.FabricDesign", "@odata.
PAGE 410
} ] } ] /api/NetworkService/Fabrics(Id) This URI represents a specific fabric in the fabric collection. GET method for Fabrics(Id) This method returns a specific fabric from the collection of fabrics. Description Returns a specific fabric. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "/api/$metadata#NetworkService.Fabric/$entity", "@odata.type": "#NetworkService.Fabric", "@odata.
PAGE 411
[ { }, { "DesignNode": "Switch-A", "PhysicalNode": "41F2MN2" "DesignNode": "Switch-B", "PhysicalNode": "41F4MN2" } ], "Switches@odata.navigationLink": "/api/NetworkService/ Fabrics('31db245a-9865-4a23-9697-4902cd2d5421')/Switches", "Servers@odata.navigationLink": "/api/NetworkService/ Fabrics('31db245a-9865-4a23-9697-4902cd2d5421')/Servers", "FabricDesign": { "@odata.id": "/api/NetworkService/ Fabrics('31db245a-9865-4a23-9697-4902cd2d5421')/FabricDesign" }, "ValidationErrors@odata.
PAGE 412
Table 154. Attributes Attribute name Description ID The identifier of the fabric. Name The fabric name. Description The fabric name description. DesignNode DesignNode must be identical to the name provided in the selected fabric design. PhysicalNode Service Tag of the switch that you want to configure for the given fabric. FabricDesign Name (FabricDesign) The fabric design name. DELETE method for Fabrics(Id) This method deletes a specific fabric. Description Deletes a specific fabric.
PAGE 413
{ }, { } "SourceNode": "Switch-A", "SourceInterface": "ethernet1/1/40", "DestinationNode": "Switch-B", "DestinationInterface": "ethernet1/1/40" "SourceNode": "Switch-A", "SourceInterface": "ethernet1/1/39", "DestinationNode": "Switch-B", "DestinationInterface": "ethernet1/1/39" } ], "FabricDesignNode": [ { "NodeName": "Switch-A", "ChassisName": "Chassis-X", "Slot": "Slot-A1", "Type": "WeaverSwitch" }, { "NodeName": "Switch-B", "ChassisName": "Chassis-Y", "Slot": "Slot-A2", "Type": "WeaverSwitch" } ] /a
PAGE 414
"ProblemLink": { "SourceNode": "", "SourceInterface": "", "DestinationNode": "", "DestinationInterface": "" }, "RecommendedLink": { "SourceNode": "", "SourceInterface": "", "DestinationNode": "", "DestinationInterface": "" }, "RecommendedAction": "Make sure that the I/O Modules are in different slots", "Timestamp": "1531891792" }, { "@odata.type": "#NetworkService.ValidationError", "@odata.
PAGE 415
}, "RecommendedLink": { "SourceNode": "DPM4XC2", "SourceInterface": "DPM4XC2:ethernet1/1/42", "DestinationNode": "DPM4XC1", "DestinationInterface": "DPM4XC1:ethernet1/1/42" }, "RecommendedAction": "Make sure that the links are connected as per design.", "Timestamp": "1531891792" }, { "@odata.type": "#NetworkService.ValidationError", "@odata.
PAGE 416
"DestinationInterface": "DPM4XC2:ethernet1/1/42" }, "RecommendedAction": "Make sure that the links are connected as per design.", "Timestamp": "1531891792" } ] } /api/NetworkService/Fabrics(Id)/Uplinks This URI represents the uplinks of a specific fabric. GET method for Uplinks for a specific fabric This method returns the uplinks of a specific fabric. Description Returns the uplinks of a specific fabric. Privilege VIEW HTTP response codes 200 Example response body { "@odata.
PAGE 417
Example request body { } Example response body "Name":"Uplink_Ethernet_Fabric-B", "Description":"Ethernet Uplink created from REST.", "MediaType":"Ethernet", "Ports":[ { "Id": "6ZB1XC2:ethernet1/1/41" }, { "Id": "5ZB1XC2:ethernet1/1/41" } ], "Networks":[ { "Id":95614 } ] Uplink Id Table 155. Attributes Attribute name Description ID The identifier of the fabric. Name The fabric name. Description The fabric name description. MediaType Type of the uplink.
PAGE 418
"Summary": { "PortCount": 4, "NetworkCount": 2 }, "Ports@odata.navigationLink": "/api/NetworkService/ Fabrics('43be623e-0d74-4f6d-87b3-3ea40bf6372d')/Uplinks('bda43da9d6d8-4fc5-98b7-cb9030e8008e')/Ports", "Networks@odata.navigationLink": "/api/NetworkService/ Fabrics('43be623e-0d74-4f6d-87b3-3ea40bf6372d')/Uplinks('bda43da9d6d8-4fc5-98b7-cb9030e8008e')/Networks" } PUT method for Uplinks(Id) This method updates a specific uplink. Description Updates a specific uplink.
PAGE 419
"IdentityCount":65, "StartingMacAddress": "YGBgYGAA" }, "InitiatorConfig": { "IqnPrefix":"Iqn.MyIqnPrefix" } } }, "FcoeSettings": { "Mac": { "IdentityCount":75, "StartingMacAddress": "cHBwcHAA" } }, "FcSettings": { "Wwnn": { "IdentityCount":85, "StartingAddress": "IACAgICAgAA=" }, "Wwpn": { "IdentityCount":85, "StartingAddress": "IAGAgICAgAA=" } } Table 156. Attributes Attribute name Description ID The identifier of the target uplink.
PAGE 420
/api/NetworkService/Fabrics(Id)/Uplinks(Id)/Ports This URI represents the uplink ports of a specific uplink in a fabric. GET method for Ports for a specific uplink This method returns the uplink ports of a specific uplink in a fabric. Description Returns the uplink ports. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "/api/$metadata#Collection(NetworkService.Port)", "@odata.count": 4, "value": [ { "@odata.type": "#NetworkService.Port", "@odata.
PAGE 421
}, { "Name": "", "Description": "", "Type": "PhysicalEthernet", "MediaType": "Ethernet", "NodeServiceTag": "1ZB1XC2", "PortNumber": "ethernet1/1/40", "Status": "Down", "AdminStatus": "Enabled", "CurrentSpeed": "0", "MaxSpeed": "0", "ConfiguredSpeed": "0", "OpticsType": "NotPresent", "BlinkStatus": "OFF", "Role": "Uplink" "@odata.type": "#NetworkService.Port", "@odata.
PAGE 422
}, { "Id": 25375, "Name": "1", "Description": "1", "VlanMaximum": 11, "VlanMinimum": 11, "Type": 1, "CreatedBy": "root", "CreationTime": "2018-07-11 03:35:11.590", "UpdatedBy": null, "UpdatedTime": "2018-07-11 03:35:11.590", "InternalRefNWUUId": "fd4d9ece-732e-4beb-8613-ab986889fe43" "@odata.type": "#NetworkConfigurationService.Network", "@odata.
PAGE 423
api/NetworkService/Fabrics(arg1)/ NetworkService.GetApplicableUplinkUntaggedNetworks This API gets the untagged networks that can be added to the uplink. POST method for getting untagged networks This method gets the applicable untagged networks that can be added to the uplink. Description Gets the applicable untagged networks that can be added to the uplink. Privilege VIEW HTTP Response Code Example response body { } "UplinkType":1 /api/NetworkService/Fabrics(Id)/ NetworkService.
PAGE 424
{ }, { }, { }, { }, { 424 ] } "Id": "1ZB1XC2:ethernet1/1/43", "Name": "", "Description": "", "PortNumber": "1ZB1XC2:ethernet1/1/43" "Id": "1ZB1XC2:ethernet1/1/37", "Name": "", "Description": "", "PortNumber": "1ZB1XC2:ethernet1/1/37" "Id": "1ZB1XC2:ethernet1/1/36", "Name": "", "Description": "", "PortNumber": "1ZB1XC2:ethernet1/1/36" "Id": "1ZB1XC2:ethernet1/1/35", "Name": "", "Description": "", "PortNumber": "1ZB1XC2:ethernet1/1/35" "NodeServiceTag": "DPM4XC1", "Ports": [ { "Id": "DPM4XC1:ethernet
PAGE 425
{ }, { }, { } ] } ] } "Id": "DPM4XC1:ethernet1/1/38", "Name": "", "Description": "", "PortNumber": "DPM4XC1:ethernet1/1/38" "Id": "DPM4XC1:ethernet1/1/36", "Name": "", "Description": "", "PortNumber": "DPM4XC1:ethernet1/1/36" "Id": "DPM4XC1:ethernet1/1/42", "Name": "", "Description": "", "PortNumber": "DPM4XC1:ethernet1/1/42" Table 157. Attributes Attribute name Description UplinkType ID of the uplink type. For more information, see /api/ NetworkService/UplinkTypes).
PAGE 426
"DeviceSubscription": { "@odata.id": null }, "DeviceSpecificData": { "@odata.id": null }, "DeviceManagement": [], "InventoryDetails": [ { "@odata.id": "/api/NetworkService/Fabrics('123e4567-e89b-12d3a456-426655440000')/Switches(0)/InventoryDetails" } ], "HardwareLogs": [ { "@odata.id": "/api/NetworkService/Fabrics('123e4567-e89b-12d3a456-426655440000')/Switches(0)/HardwareLogs" } ], "SubSystemHealth": [ { "@odata.
PAGE 427
Example response body { "@odata.context": "$metadata#Collection(DeviceService.Device)", "@odata.count": 1, "value": [ { "@odata.id": "/api/NetworkService/Fabrics('123e4567-e89b-12d3a456-426655440000')/Servers(0)", "Id": 0, "Type": 1000, "Identifier": "7IUJMNBGJ", "ChassisServiceTag": "9FHJSUIK1", "Model": "ServerModel1", "PowerState": 2, "Status": 3000, "AssetTag": "7IUJMNBGJ", "SystemId": 0, "DeviceName": "ServerNode", "LastInventoryTime": null, "DeviceCapabilities": [], "DeviceSubscription": { "@odata.
PAGE 428
} ] /api/NetworkService/Fabrics(Id)/ISLLinks This URI represents the ISL links of a specific fabric. GET method for ISLLinks This method returns the ISL link details for a specific fabric. Description Returns the ISL link details for a fabric. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "/api/$metadata#Collection(NetworkService.ISLLink)", "@odata.count": 4, "value": [ { "@odata.type": "#NetworkService.ISLLink", "@odata.
PAGE 429
}, { } "PortNumber": "41F2MN2:ethernet1/1/10:1", "PortName": null "@odata.type": "#NetworkService.ISLLink", "@odata.
PAGE 430
Example response body { "@odata.context": "/api/$metadata#NetworkService.Topology/$entity", "@odata.type": "#NetworkService.Topology", "@odata.id": "/api/NetworkService/ Fabrics('43be623e-0d74-4f6d-87b3-3ea40bf6372d')/Topology", "Nodes@odata.navigationLink": "/api/NetworkService/ Fabrics('43be623e-0d74-4f6d-87b3-3ea40bf6372d')/Topology/Nodes" } /api/NetworkService/Fabrics(Id)/Topology/Nodes This URI represents the nodes for a fabric topology.
PAGE 431
a456-426655440000')/Switches(0)/HardwareLogs" } ], "SubSystemHealth": [ { "@odata.id": "/api/NetworkService/Fabrics('123e4567-e89b-12d3a456-426655440000')/Switches(0)/SubSystemHealth" } ], "RecentActivity": [ { "@odata.id": "/api/NetworkService/Fabrics('123e4567-e89b-12d3a456-426655440000')/Switches(0)/RecentActivity" } ], "InventoryTypes": { "@odata.id": "/api/NetworkService/Fabrics('123e4567-e89b-12d3a456-426655440000')/Switches(0)/InventoryTypes" }, "Settings": [ { "@odata.
PAGE 432
"DeviceName": "ServerNode", "LastInventoryTime": null, "DeviceCapabilities": [], "DeviceSubscription": { "@odata.id": null }, "DeviceSpecificData": { "@odata.id": null }, "DeviceManagement": [], "InventoryDetails": [ { "@odata.id": "/api/NetworkService/Fabrics('123e4567-e89b-12d3a456-426655440000')/Servers(0)/InventoryDetails" } ], "HardwareLogs": [ { "@odata.id": "/api/NetworkService/Fabrics('123e4567-e89b-12d3a456-426655440000')/Servers(0)/HardwareLogs" } ], "SubSystemHealth": [ { "@odata.
PAGE 433
HTTP response codes Example response body 200 { "@odata.context": "/api/$metadata#Collection(NetworkService.Node)", "@odata.count": 2, "value": [ { "@odata.type": "#NetworkService.Node", "@odata.id": "/api/NetworkService/ Fabrics('43be623e-0d74-4f6d-87b3-3ea40bf6372d')/Topology/Nodes('Switch %3A1ZB1XC2')", "Id": "Switch:1ZB1XC2", "Type": "NETWORK_IOM", "ParentNodeId": "SKY00201234567890123456789012345", "Location": "IOM-B1", "NodeInformation": { "@odata.type": "#NetworkService.
PAGE 434
/api/NetworkService/Actions/NetworkService.RemoveFabrics POST method for NetworkService.RemoveFabrics This method deletes multiple fabrics. Description Deletes multiple fabrics. Privilege FABRIC_MANAGEMENT HTTP response codes 204 Example request body { } Example response body { } "FabricIds":["Fabric-1","Fabric-2'] "Fabric-1": true, "Fabric-2": true /api/NetworkService/Actions/NetworkService.RemoveUplinks POST method for NetworkService.RemoveUplinks This method deletes multiple fabric uplinks.
PAGE 435
/api/NetworkService/FabricDesigns(Id)/ NetworkService.GetApplicableNodes POST method for GetApplicableNodes This method returns the available nodes applicable to a fabric design. Description Returns applicable nodes.
PAGE 436
Example response body { "@odata.context": "/api/ $metadata#Collection(NetworkService.UplinkType)", "@odata.count": 4, "value": [ { "@odata.type": "#NetworkService.UplinkType", "Id": 1, "Name": "Ethernet" }, { "@odata.type": "#NetworkService.UplinkType", "Id": 2, "Name": "FCoE" }, { "@odata.type": "#NetworkService.UplinkType", "Id": 3, "Name": "FC Gateway" }, { "@odata.type": "#NetworkService.
PAGE 437
} ] /api/NetworkService/FabricActivityTypes This URI represents the activities that can be performed using fabrics. GET method for FabricActivityTypes This method returns the list of activities that can be performed using fabrics. Description Returns the list of activities for a fabric. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "/api/ $metadata#Collection(NetworkService.EnumerationEntry)", "@odata.count": 5, "value": [ { "@odata.type": "#NetworkService.
PAGE 438
Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "/api/ $metadata#Collection(NetworkService.EnumerationEntry)", "@odata.count": 12, "value": [ { "@odata.type": "#NetworkService.EnumerationEntry", "Id": "2020", "Name": "Scheduled" }, { "@odata.type": "#NetworkService.EnumerationEntry", "Id": "2030", "Name": "Queued" }, { "@odata.type": "#NetworkService.EnumerationEntry", "Id": "2040", "Name": "Starting" }, { "@odata.type": "#NetworkService.
PAGE 439
} ] } /api/NetworkService/FabricHealthStatuses This URI represents the possible health states of the fabric. GET method for FabricHealthStatuses This method returns the possible health states of the fabric. Description Returns the possible health states of the fabric. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "/api/ $metadata#Collection(NetworkService.EnumerationEntry)", "@odata.count": 5, "value": [ { "@odata.type": "#NetworkService.
PAGE 440
Privilege VIEW HTTP response codes 200 Example response body { "@odata.id": "/api/NetworkService/MultiChassisDomain", "Topology": { "@odata.id": "/api/NetworkService/MultiChassisDomain/Topology" }, "ValidationErrors@odata.navigationLink": "/api/NetworkService/ MultiChassisDomain/ValidationErrors" } /api/NetworkService/MultiChassisDomain/Topology This URI represents the topology of an MCM group.
PAGE 441
{ "@odata.type": "#NetworkService.Node", "@odata.id": "/api/NetworkService/MultiChassisDomain/Topology/ Nodes('Chassis%3ASKY002P1234567890123456789012345')", "Id": "Chassis:SKY002P1234567890123456789012345", "Type": "CHASSIS", "ParentNodeId": null, "Location": null, "NodeInformation": { "@odata.type": "#NetworkService.
PAGE 442
"@odata.context": "/api/$metadata#NetworkService.Node/$entity", "@odata.type": "#NetworkService.Node", "@odata.id": "/api/NetworkService/MultiChassisDomain/Topology/ Nodes('Chassis:SKY00201234567890123456789012345')", "Id": "Chassis:SKY00201234567890123456789012345", "Type": "CHASSIS", "ParentNodeId": null, "Location": null, "NodeInformation": { "@odata.type": "#NetworkService.
PAGE 443
"Name": "IOM-B1" }, "ChildNodes@odata.navigationLink": "/api/NetworkService/ MultiChassisDomain/Topology/Nodes('Switch%3A1ZB1XC2')/ChildNodes" }, { "@odata.type": "#NetworkService.Node", "@odata.id": "/api/NetworkService/MultiChassisDomain/Topology/ Nodes('Switch%3ADPM4XC1')", "Id": "Switch:DPM4XC1", "Type": "NETWORK_IOM", "ParentNodeId": "SKY00201234567890123456789012345", "Location": "IOM-B2", "NodeInformation": { "@odata.type": "#NetworkService.
PAGE 444
"ChassisServiceTag": "SKY00201234567890123456789012345", "Description": "Unable to validate the fabric because the design link ICL-2_FORWARD not connected as per design 2NodeHESameChassis.
PAGE 445
"DestinationInterface": "1ZB1XC2:ethernet1/1/42" }, "RecommendedLink": { "SourceNode": "DPM4XC1", "SourceInterface": "DPM4XC1:ethernet1/1/42", "DestinationNode": "1ZB1XC2", "DestinationInterface": "1ZB1XC2:ethernet1/1/42" }, "RecommendedAction": "Make sure that the links are connected as per design.", "Timestamp": "1531280042" }, { "@odata.type": "#NetworkService.ValidationError", "@odata.
PAGE 446
"DestinationNode": "DPM4XC1", "DestinationInterface": "DPM4XC1:ethernet1/1/42" }, "RecommendedAction": "Make sure that the links are connected as per design.", "Timestamp": "1531280042" } ] } /api/NetworkService/PortAdminStatuses This URI represents the possible admin statuses of the ports. GET method for PortAdminStatuses This method returns the possible admin statuses of a port. Description Returns the possible admin statuses of a port.
PAGE 447
HTTP response codes Example response body 200 { "@odata.context": "/api/ $metadata#Collection(NetworkService.EnumerationEntry)", "@odata.count": 3, "value": [ { "@odata.type": "#NetworkService.EnumerationEntry", "Id": "Disabled", "Name": "Disabled" }, { "@odata.type": "#NetworkService.EnumerationEntry", "Id": "Enabled", "Name": "Enabled" }, { "@odata.type": "#NetworkService.
PAGE 448
Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "/api/ $metadata#Collection(NetworkService.EnumerationEntry)", "@odata.count": 5, "value": [ { "@odata.type": "#NetworkService.EnumerationEntry", "Id": "Spinner", "Name": "Spinner" }, { "@odata.type": "#NetworkService.EnumerationEntry", "Id": "Unknown", "Name": "Unknown" }, { "@odata.type": "#NetworkService.EnumerationEntry", "Id": "EndHost", "Name": "EndHost" }, { "@odata.type": "#NetworkService.
PAGE 449
{ }, { } ] } "@odata.type": "#NetworkService.EnumerationEntry", "Id": "NoTeaming", "Name": "NoTeaming" "@odata.type": "#NetworkService.EnumerationEntry", "Id": "Other", "Name": "Other" api/NetworkService/ServerProfiles This URI lists all server profiles by ID and service tag. GET method for server profiles This method lists all server profiles by ID and service tag. Description Lists all server profiles by ID and service tag. Privilege HTTP response code Example response body 200 { "@odata.
PAGE 450
NetworkService/ServerProfiles('8YCF0T2')",…}, {"@odata.type": "#NetworkService.ServerProfile", NetworkService/ServerProfiles('17QFBS2')",…}, {"@odata.type": "#NetworkService.ServerProfile", NetworkService/ServerProfiles('96P80T2')",…}, {"@odata.type": "#NetworkService.ServerProfile", NetworkService/ServerProfiles('8ZKF0T2')",…}, {"@odata.type": "#NetworkService.ServerProfile", NetworkService/ServerProfiles('17WFBS2')",…}, {"@odata.type": "#NetworkService.
PAGE 451
$entity", "@odata.type": "#NetworkService.ServerProfile", "@odata.id": "/api/NetworkService/ServerProfiles('PFSTN16')", "Id": "PFSTN16", "ServerServiceTag": "PFSTN16", "ServerInterfaceProfiles@odata.navigationLink": "/api/NetworkService/ ServerProfiles('PFSTN16')/ServerInterfaceProfiles" } Table 158. Attributes Attribute Description Id Server profile identifier. ServerServiceTag Service tag of the server.
PAGE 452
Table 159. Attributes (continued) Attribute Description ServerInterfaceProfiles Sub payload that takes information that is associated with a server NIC. The request can take one or more server interface profiles, as part of the payload. ServerInterfaceProfiles/Id Server NIC identifier. ServerInterfaceProfiles/NativeVLAN Untagged VLAN configured for the given NIC. ServerInterfaceProfiles/Networks/Id Tagged VLANs configured for the given NIC.
PAGE 453
ServerProfiles('PFSTN16')/ServerInterfaceProfiles/Networks(25076)", "Id": 25076, "Name": "10", "Description": "10", "VlanMaximum": 10, "VlanMinimum": 10, "Type": 1, "CreatedBy": "system", "CreationTime": "1970-01-31 00:08:21.946", "UpdatedBy": null, "UpdatedTime": "1970-01-31 00:08:21.946", "InternalRefNWUUId": "991f2843-376e-49f3-a407e5118f1d85ba" }, … ] }, { "@odata.type": "#NetworkService.ServerInterfaceProfile", "@odata.id": "/api/NetworkService/ServerProfiles('PFSTN16')/ ServerInterfaceProfiles('NIC.
PAGE 454
"@odata.type": "#NetworkService.ServerInterfaceProfile", "@odata.id": "/api/NetworkService/ServerProfiles('PFSTN16')/ ServerInterfaceProfiles('NIC.Mezzanine.1A-2-1')", "Id": "NIC.Mezzanine.1A-2-1", "OnboardedPort": "8T61XC2:ethernet1/1/4", "NativeVLAN": 0, "Networks@odata.count": 0, "Networks": [] /api/NetworkService/ServerProfiles(arg1)/ServerInterfaceProfiles(arg2)/ Networks(arg3) This URI returns the configured tagged VLANs for a server profile in the Fabric Manager.
PAGE 455
Example response body { "@odata.context": "/api/ $metadata#Collection(NetworkConfigurationService.Network)", "@odata.count": 2, "value": [ { "@odata.type": "#NetworkConfigurationService.Network", "@odata.id": "/api/NetworkService/ServerProfiles('PFSTN16')/ ServerInterfaceProfiles('NIC.Mezzanine.1A-1-1')/Networks(25076)", "Id": 25076, "Name": "10", "Description": "10", "VlanMaximum": 10, "VlanMinimum": 10, "Type": 1, "CreatedBy": "system", "CreationTime": "1970-01-31 00:08:21.
PAGE 456
api/NetworkService/ServerProfiles(Id1)/ ServerInterfaceProfiles(Id2) This URI gets server interface profiles by IDs. GET method for server interface profiles Add your section content here. /api/NetworkService/Actions/ NetworkService.ApplyServersInterfaceProfiles This URI updates one or more server profile IDs at a time. You can also use this URI to set multiple server profiles at a time. A job is created in the OME - Modular web interface to track the progress of the server profile configuration task.
PAGE 457
Table 161. Attributes (continued) Attribute Description BondingTechnology Indicates the NIC bonding technology that is configured for the server profile. Enables the NIC teaming type that you want to configure for a profile. The supported options are: ● LACP ● Others ● NoTeaming NicBonded Indicates if the given NIC port participates in the NIC teaming. It is a binary attribute. /api/NetworkService/Actions/ NetworkService.
PAGE 458
Table 162. Attributes Attribute Description JobId ID of the job that is created as part of the request. You can track the progress of the request using the Job ID. BondingTechnology Indicates the NIC bonding technology that is configured for the server profile. Enables the NIC teaming type that you want to configure for a profile. The supported options are: ● LACP ● Others ● NoTeaming NicBonded Indicates if the given NIC port participates in the NIC teaming. It is a binary attribute.
PAGE 459
/api/NetworkService/Actions/ NetworkService.DeleteServerNetworks This API enables you to delete network profiles from an existing interface profile for one or many targeted servers. POST method for deleting server networks This method enables you to delete network profiles from an existing interface profile for one or many targeted servers. To run this API, you must have a server profile with NICs that were deployed using the server deployment process, on the system.
PAGE 460
{ }, { }, { }, { } ] } "@odata.type": "#NetworkService.FeatureCapability", "Name": "ServerBondingConfiguration" "@odata.type": "#NetworkService.FeatureCapability", "Name": "PortVLANConfiguration" "@odata.type": "#NetworkService.FeatureCapability", "Name": "FabricLLDPConfiguration" "@odata.type": "#NetworkService.FeatureCapability", "Name": "FCoEUplinkUntaggedVlanConfiguration" Port configuration in Fabrics /api/JobService/Jobs This URI enables you to configure the ports in fabrics.
PAGE 461
] } "TargetType": { "Id":4000, "Name":"DEVICE" } POST method for enabling or disabling auto-negotiation This method enables or disables auto-negotiation. Description Enables or disables auto-negotiation.
PAGE 462
Example request body "Params": [ { "Key":"operationName", "Value":"CONFIGURE_PORT_NAME_DESCRIPTION" }, { "Key":"interfaceId", "Value":"GF86XC2:1/1/9" }, { "Key":"name", "Value":"Port A" }, { "Key":"description", "Value":"This is Port A." } ], "Targets": [ { "Id":2664, "Data":"", "TargetType": { "Id":4000, "Name":"DEVICE" } } ] POST method for configuration port speed or breakout This method configures the port speed or breakout. Description Configures the port speed or breakout.
PAGE 463
}, { } "Value": "D23RPK2:port-group1/1/16" "Key": "operationName", "Value": "CONFIGURE_PORT_BREAK_OUT" } ], "JobType": { "@odata.type": "#JobService.JobType", "Id": 3, "Name": "DeviceAction_Task", "Internal": false } Table 163. Attributes Attribute name Description TargetType (Id) Network IOM device ID. InterfaceId Port name. Key Operation name. Depending on the type of configuration you want to perform, select the operation name as provided in the Input snippet.
PAGE 464
{ }, { } "Key":"assignmentMode", "Value":"1" "Key":"serverSlots", "Value": } ], "Targets": [ { "Id":, "Data":"", "TargetType": { "Id":1000, "Name":"DEVICE" } } ] Clear enclosure assignment POST method for clearing enclosure assignment Description Creates a job to clear the storage assignments in Enclosure Assigned mode.
PAGE 465
} Assign drives POST method for drive assignment Description Creates a job to assign individual storage drives to server slots.
PAGE 466
HTTP response codes Example request body 201 { } "JobName":"Storage Assignment", "JobDescription":"Storage Assignment Task", "Schedule":"startnow", "State":"Enabled", "JobType":{ "Id":3, "Name":"DeviceAction_Task" }, "Params":[ { "Key":"operationName", "Value":"CLEAR_STORAGE_ASSIGNMENT" }, { "Key":"assignmentMode", "Value":"2" }, { "Key":"driveSlotIds", "Value":
PAGE 467
} } "Value": "FORCE_ACTIVE" ], "Targets": [ { "Id":, "Data":"", "TargetType": { "Id": 1000, "Name": "DEVICE" } } ] Clear configuration on SAS IOM POST method for clearing SAS IOM configuration Description Creates a job to clear the configuration on SAS IOM.
PAGE 468
Extract SAS IOM logs to NFS share POST method for exporting SAS IOM logs to NFS share Description Creates a job to extract logs from SAS IOM to a NFS share. Privilege STORAGE_MANAGEMENT HTTP response codes 201 Example request body { } "Id": 0, "JobName": "Extract Log", "JobDescription": "Extract device log to NFS location", "Schedule": "startnow", "State": "Enabled", "JobType": { "Id": 18, "Name": "DebugLogs_Task" }, "Targets": [ { "Id": e.
PAGE 469
Example request body { } "Id": 0, "JobName": "Extract Log", "JobDescription": "Extract device log to CIFS location", "Schedule": "startnow", "State": "Enabled", "JobType": { "Id": 18, "Name": "DebugLogs_Task" }, "Targets": [ { "Id": e.g: 2614, "Data": "", "TargetType": { "Id": 1000, "Name": "DEVICE" } } ], "Params": [ { "Key": "OPERATION_NAME", "Value": "EXTRACT_LOGS" }, { "Key": "shareAddress", "Value": e.g: "100.100.100.
PAGE 470
Quick Deploy /api/JobService/Jobs This URI represents Quick-Deploy jobs. POST method for Quick-Deploy Jobs This method creates a Quick-Deploy job. Description Creates a Quick-Deploy job.
PAGE 471
}, { }, { "Value":"0" "Key":"gatewayV6", "Value":"255.255.255.0" "Key":"SlotId=1", "Value":"SlotSelected=true;SlotType=3000;IPV4Address=10.27.0.1;IPV6Address=ax0" }, { "Key":"SlotId=2", "Value":"SlotSelected=true;SlotType=2000;IPV4Address=10.35.0.
PAGE 472
}, { }, { "Key": "gatewayV6", "Value": "255.255.255.0" "Key": "SlotId=1", "Value": "SlotSelected=true;SlotType=3000;IPV4Address=10.27.0.1;IPV6Address=ax0" }, { "Key": "SlotId=2", "Value": "SlotSelected=true;SlotType=2000;IPV4Address=10.35.0.25;IPV6Address=" } ] } Table 164. Attributes Attribute name Description Id ID of job. The default ID for POST is 0. JobName Name of the Quick-Deploy Job. JobDescription Description of the Quick-Deploy Job. Schedule The schedule to start the Job.
PAGE 473
Table 164. Attributes (continued) Attribute name Description ● SlotSelected=true or false. Indicates if the slot is selected for applying Quick Deploy. ● SlotType = The type of slot. ● Sled type is 2000. ● IPV4Address = IPV4 address to be set at slot level. ● PV6Address = IPV6 address to be set at slot level.
PAGE 474
PUT method for server profiles This method updates the server profile by ID. To run /api/NetworkService /ServerProfiles(arg1), you must have an existing server profile that is deployed on the system using the server deployment process. Description Updates the server profile. Privilege FABRIC_MANAGEMENT HTTP Response Code 201 Example request body { } Example response body "Id": "PFSTN16", "ServerServiceTag":"PFSTN16", "ServerInterfaceProfiles": [{ "Id": "NIC.Mezzanine.
PAGE 475
/api/NetworkService /ServerProfiles(arg1)/ ServerInterfaceProfiles This URI represents the server interface profiles information. GET method for Server Interface profiles This method returns all server interface profiles that are configured for a server on the Fabric Manager. Description Returns all server interface profiles that are configured for a server profile. Privilege VIEW HTTP Response Code 200 Example response body { "@odata.context": "/api/ $metadata#Collection(NetworkService.
PAGE 476
Table 167. Attributes Attribute Description Id NIC profile identifier. OnboardedPort IOM port that connected to the onboarded NIC. NativeVLAN Untagged VLAN configured for the NIC. /api/NetworkService /ServerProfiles(arg1)/ ServerInterfaceProfiles(arg2) This URI represents the server interface profiles information that is configured for a server profile on the Fabric Manager. GET method for NetworkService.
PAGE 477
"value": [ { "@odata.type": "#NetworkConfigurationService.Network", "@odata.id": "/api/NetworkService/ServerProfiles('PFSTN16')/ ServerInterfaceProfiles('NIC.Mezzanine.1A-1-1')/Networks(25076)", "Id": 25076, "Name": "10", "Description": "10", "VlanMaximum": 10, "VlanMinimum": 10, "Type": 1, "CreatedBy": "system", "CreationTime": "1970-01-31 00:08:21.946", "UpdatedBy": null, "UpdatedTime": "1970-01-31 00:08:21.946", "InternalRefNWUUId": "991f2843-376e-49f3-a407-e5118f1d85ba" }, { "@odata.
PAGE 478
} "CreatedBy": "system", "CreationTime": "1970-01-31 00:08:21.946", "UpdatedBy": null, "UpdatedTime": "1970-01-31 00:08:21.946", "InternalRefNWUUId": "991f2843-376e-49f3-a407-e5118f1d85ba" /api/NetworkService/Actions/ NetworkService.ApplyServersInterfaceProfiles This URI performs bulk update on one or more server profiles simultaneously. To run this URI, you must have a server profile that is deployed using the server deployment process, on the system.
PAGE 479
17 APIs specific to OpenManage Enterprise Topics: • • • • • • • • • • • • • • • • Application settings Console update Mobile Console Preferences Alerts Incoming Alerts Warranty Network Configuration Troubleshoot service Query support service Groups service Devices Auto deploy Monitor Plugin Manager Power Metrics Application settings Console update /api/JobService/Jobs This URI updates the OpenManage Enterprise appliance. POST method for Jobs This method updates the OpenManage Enterprise appliance.
PAGE 480
} "Params": [ { "Key":"connectionProfile", "Value":"0" } ], "Targets": [ { "Id":500, "Data":"", "TargetType": { "Id":6000, "Name":"GROUP" } } ] /api/ConsoleUpdateService/Updates?$filter= Auto eq true This URI represents the update job status of the OpenManage Enterprise appliance. GET method for Updates?$filter= Auto eq true This method returns the update job status of OpenManage Enterprise. Description Returns the update job status of OpenManage Enterprise.
PAGE 481
GET method for UpdateBundleInfo This method returns the job status of the downloaded console update bundle of the OpenManage Enterprise appliance. Description Returns the update job status of the downloaded console update bundle of the OpenManage Enterprise appliance. Privilege VIEW HTTP response code 200 /api/ConsoleUpdateService/Actions/ ConsoleUpdateService.DeleteUpgradeBundle This URL deletes the downloaded console update bundle. NOTE: This API is available in OpenManage Enterprise 3.3.
PAGE 482
Mobile /api/AlertService/MobileSubscriptions This URI returns all mobile subscriptions. GET method for MobileSubscriptions This method returns all the mobile subscriptions. Description Returns all the mobile subscriptions. Privilege VIEW HTTP response codes 200 Example Response Body { "@odata.context": "$metadata#Collection(AlertService.MobileSubscription)", "@odata.count": 1, "value": [ { "@odata.
PAGE 483
Example Response Body { "@odata.context": "$metadata#AlertService.SubscriptionNotificationService/$entity", "@odata.id": "/api/AlertService/SubscriptionNotificationService", "Id": 1, "Status": 2, "Enabled": false, "DateLastRegistration": "1970-01-01 00:00:00.0", "StatusMessage": "The notification service is disabled or is initializing.", "Token": "", "URL": null, "DateLastCommFailure": "2017-08-08 19:50:00.087", "CommFailuresBackoff": "2017-08-08 19:50:00.087" } /api/AlertService/Actions/ AlertService.
PAGE 484
HTTP response codes Example Request Body 200 ["7cb19d45-cae5-4eesdf6-sdasdfsaaasd02daf-asd8aasd5fcefsdf00a85"] /api/AlertService/Actions/ AlertService.EnableSubscriptionNotificationService This URI enables the mobile subscription notifications. POST method for AlertService.EnableSubscriptionNotificationService This method enables notifications of mobile subscriptions. Description Enables notifications of mobile subscriptions.
PAGE 485
"SeverityType": 2, "SeverityName": "Info", "AlertDeviceId": 0, "AlertDeviceName": "10.210.137.100", "AlertDeviceType": 0, "AlertDeviceIpAddress": "xx.xx.xx.xx", "AlertDeviceMacAddress": null, "AlertDeviceIdentifier": null, "AlertDeviceAssetTag": null, "DefinitionId": -126170178, "CatalogName": "OMSA", "CategoryId": 1000, "CategoryName": "System Health", "SubCategoryId": 61, "SubCategoryName": "Redundancy", "StatusType": 2000, "StatusName": "Not-Acknowledged", "TimeStamp": "2018-09-10 17:45:46.
PAGE 486
"ConsoleSetting": [ { "Name": "DEVICE_PREFERRED_NAME", "DefaultValue": "SYSTEM_NAME", "Value": "PREFER_NETBIOS,PREFER_IDRAC_SYSTEM_HOSTNAME", "DataType": "", "GroupName": "" }, { "Name": "INVALID_DEVICE_HOSTNAME", "Value": "localhost,localhost.
PAGE 487
https:///api/JobService/Jobs(10011) PUT method for Jobs(10011) Description Configures the health poll interval for the device health settings. Privilege JOB_MANAGEMENT HTTP response codes 200 Example Request Body { "ConsoleSetting": [{ "Name": "REPORTS_MAX_RESULTS_LIMIT", "Value": "0", "DataType": "java.lang.Integer", "GroupName": "" } ] } https:///api/ApplicationService/Settings POST method for ReportSettings Description Configures the maximum limit for the reports.
PAGE 488
{ } ] } "Name": "EMAIL_SENDER", "DefaultValue": "admin@dell.com", "Value": "admin@dell.com", "DataType": "java.lang.String", "GroupName": "" POST method for TrapForwarding Description Configures the OpenManage Enterprise trap forwarding settings.
PAGE 489
https:///api/AlertService/AlertDestinations/ SMTPConfiguration POST method for SMTPConfiguration Description Configures the email and SMTP configuration for alerts. Privilege MONITORING_SETUP HTTP response codes 200 Example Request Body { } "DestinationAddress": "10.35.2.0", "UseCredentials": true, "PortNumber": 25, "UseSSL": true, "Credential": { "User": "root", "Password": "calvin" } https:///api/AlertService/AlertDestinations/Actions/ AlertDestinations.
PAGE 490
}, { ] } "DestinationAddress": null, "PortNumber": 0, "Version": null, "SnmpV1V2Credential": null, "SnmpV3Credential": null "Id": 4, "Enabled": false, "DestinationAddress": null, "PortNumber": 0, "Version": null, "SnmpV1V2Credential": null, "SnmpV3Credential": null https:///api/AlertService/AlertDestinations/Actions/ AlertDestinations.ApplySyslogConfig POST method for AlertDestinations.ApplySyslogConfig Description Configures the server for alerts.
PAGE 491
Incoming Alerts https:///api/ApplicationService/Settings POST method for Jobs Description Configures the SNMP configuration for incoming alerts. Privilege JOB_MANAGEMENT HTTP response codes 200 Example Request Body { "Id": ,// Refer task api to get the jobId for this Job name.
PAGE 492
}, { }, { ] } } "JobId": 0, "Key": "communityString", "Value": "lex" "JobId": 0, "Key": "overwriteUSM", "Value": "true" Warranty https:///api/ApplicationService/Settings POST method for Warranty settings Description Creates the warranty settings. Privilege APPLIANCE_SETUP Example Request Body { "ConsoleSetting": [ { "Name": "WARRANTY_SCOREBOARD", "DefaultValue": "false", "Value": "true", "DataType": "java.lang.
PAGE 493
Example response body { "@odata.context": "/api/ $metadata#Collection(Network.AdapterConfigurations)", "@odata.count": 2, "value": [ { "@odata.type": "#Network.AdapterConfigurations", "@odata.
PAGE 494
"fe80::20c:29ff:fe08:600c/64", "UseDHCPForDNSServerNames": false, "Ipv6Dns": [] }, "DnsSetting": { "DnsFQDName": "", "DnsDomainName": "" } }, "Delay": 0, "PrimaryInterface": true }, { "@odata.type": "#Network.AdapterConfigurations", "@odata.
PAGE 495
"fe80::ecb2:915e:5a6f:817b/64", "UseDHCPForDNSServerNames": false, "Ipv6Dns": [] }, "DnsSetting": null }, "Delay": 0, "PrimaryInterface": false } ] } /api/ApplicationService/Network/AdapterConfigurations('ens33') This URL returns the network adapter information that is based on the interface name. NOTE: The interface name of the network adapter in an appliance varies based on the hypervisor.
PAGE 496
"DnsDomainName": "", "FqdndomainName": "", "Ipv4CurrentPreferredDNSServer": "Ipv4CurrentAlternateDNSServer": "Ipv6CurrentPreferredDNSServer": "Ipv6CurrentAlternateDNSServer": "", "", "", "" }, "CurrentSettings": { "Ipv4Settings": { "Enable": true, "EnableDhcp": true, "CurrentIPAddress": [ "XX.XXX.X.XXX" ], "CurrentSubnetMask": "255.255.248.0", "CurrentGateway": "10.255.0.1", "UseDHCPForDNSServerNames": true, "Ipv4Dns": [ "XX.XX.X.X", "XX.X.X.
PAGE 497
} "Ipv4Configuration": { "Enable": true, "EnableDHCP": true, "StaticIPAddress": "", "StaticSubnetMask": "", "StaticGateway": "", "UseDHCPForDNSServerNames": true, "StaticPreferredDNSServer": "", "StaticAlternateDNSServer": "" }, "Ipv6Configuration": { "Enable": false, "EnableAutoConfiguration": false, "StaticIPAddress": "", "StaticPrefixLength": 0, "StaticGateway": "", "UseDHCPForDNSServerNames": false, "StaticPreferredDNSServer": "", "StaticAlternateDNSServer": "" }, "ManagementVLAN": { "EnableVLAN": fals
PAGE 498
"Value": "{\"interfaceName\":\"ens36\",\"profileName \":\"ens36\",\"enableNIC\":true,\"ipv4Configuration\":{\"enable \":true,\"enableDHCP\":true,\"staticIPAddress\":\"\",\"staticSubnetMask \":\"\",\"staticGateway\":\"\",\"useDHCPForDNSServerNames \":false,\"staticPreferredDNSServer\":\"\",\"staticAlternateDNSServer \":\"\"},\"ipv6Configuration\":{\"enable\":true,\"enableAutoConfiguration \":true,\"staticIPAddress\":\"\",\"staticPrefixLength\":0,\"staticGateway \":\"\",\"useDHCPForDNSServerNames\":false,\"st
PAGE 499
"UpdatedBy": null, "LastRunStatus": { "Id": 2080, "Name": "New" }, "JobType": { "Id": 207, "Name": "OMERealtime_Task", "Internal": true }, "JobStatus": { "Id": 2080, "Name": "New" }, "Targets": [], "Params": [ { "JobId": 10085, "Key": "Nmcli_Update", "Value": "{\"interfaceName\":\"ens36\",\"profileName \":\"ens36\",\"enableNIC\":true,\"ipv4Configuration\":{\"enable \":true,\"enableDHCP\":true,\"staticIPAddress\":\"\",\"staticSubnetMask \":\"\",\"staticGateway\":\"\",\"useDHCPForDNSServerNames \":false,\"sta
PAGE 500
Example to create a TSR job Example request body { } Example to create a diagnostic job 500 "Id":0, "JobName":"TSR", "JobDescription":"TSRTask", "Schedule":"startnow", "State":"Enabled", "JobType": { "Id":125, "Name":"Diagnostic_Task" }, "Params": [ { "Key":"deviceTypes", "Value":"1000" }, { "Key":"operationName", "Value":"SERVER_EXECUTE_TSR" }, { "Key":"fileName", "Value":"TSR" }, { "Key":"OPERATION_NAME", "Value":"SERVER_EXECUTE_TSR" }, { "Key":"ShareType", "Value":"2" }, { "Key":"DataSelectorArrayIn"
PAGE 501
} "State":"Enabled", "JobType": { "Id":25, "Name":"Diagnostic_Task" }, "Params": [ { "Key":"deviceTypes", "Value":"1000" }, { "Key":"fileName", "Value":"FinalTest" }, { "Key":"operationName", "Value":"SERVER_DIAGNOSTIC" }, { "Key":"OPERATION_NAME", "Value":"SERVER_DIAGNOSTIC" }, { "Key":"ShareType", "Value":"2" }, { "Key":"RunMode", "Value":"0" }, { "Key":"RebootJobType", "Value":"2" }, { "Key":"ScheduledStartTime", "Value":"TIME_NOW" } ], "Targets": [ { "Id":3714, "Data":"", "TargetType": { "Id":3714, "Na
PAGE 502
● URI for remote diagnostic files—api/TroubleshootService/Files?$filter=DeviceId eq 25085 and DeviceOperation eq 'SERVER_DIAGNOSTIC' Privilege VIEW HTTP response codes 200 Example Response Body "value": [ { "@odata.type": "#TroubleshootService.FileResponseModel", "DeviceId": 25085, "DeviceOperation": "SERVER_EXECUTE_TSR", "JobId": 0, "FileName": "TSR.zip", "FilePath": "/shared/dell/omc/cifs/idrac/F3TPXK2/ SERVER_EXECUTE_TSR/TSR/TSR.zip" } ] Table 169.
PAGE 503
/api/TroubleShootService/Actions/ TroubleShootService.GetArchivedConsoleLogs This URI retrieves the appliance service logs. POST method for TroubleShootService.GetArchivedConsoleLogs This method retrieves the appliance service log files as a .ZIP file. Description Retrieves the appliance service log files. Privilege VIEW HTTP response codes 200 Example Response Body java.io.File /api/TroubleShootService/Actions/ TroubleShootService.
PAGE 504
$metadata#Collection(QuerySupportService.Query)", "@odata.count": 6, "value": [ { "@odata.type": "#QuerySupportService.Query", "@odata.id": "/api/QuerySupportService/Queries(10001)", "Id": 10001, "Name": "Device Overview Report", "UsageId": 2, "FilterText": "", "ContextId": 2, "Conditions": [], "ResultFields": [], "SortFields": [] }, { "@odata.type": "#QuerySupportService.Query", "@odata.
PAGE 505
[ } "FilterText": "", "ContextId": 2, "Conditions": { "LogicalOperatorId": 0, "LeftParen": true, "FieldId": 52, "OperatorId": 11, "Value": "PowerEdge", "RightParen": true } ], "ResultFields": [ 50, 53, 52 ], "SortFields": [] /api/QuerySupportService/QueryContextSummaries This URI represents summary information for all query contexts. GET method for QueryContextSummaries This method returns summary information for all Query Contexts.
PAGE 506
{ { } "Description": null, "BaseCategoryId": 2 }, "@odata.type": "#QuerySupportService.QueryContextSummary", "@odata.id": "/api/QuerySupportService/QueryContextSummaries(2)", "Id": 2, "Name": "Devices", "Description": null, "BaseCategoryId": 1 }, "@odata.type": "#QuerySupportService.QueryContextSummary", "@odata.
PAGE 507
HTTP response codes Example Response Body 200 { "@odata.context": "/api/$metadata#QuerySupportService.QueryContext/ $entity", "@odata.type": "#QuerySupportService.QueryContext", "@odata.
PAGE 508
] }, { } "Id": 5000, "Name": "No Status" "Id": 19, "Name": "Device Model", "TableId": 5, "Description": null, "FieldTypeId": 1, "StrMaxLen": 256, "EnumOpts": [] }, { "Id": 20, "Name": "Device Service Tag", "TableId": 5, "Description": null, "FieldTypeId": 1, "StrMaxLen": 256, "EnumOpts": [] }, { "Id": 23, "Name": "Device Asset Tag", "TableId": 5, "Description": null, "FieldTypeId": 1, "StrMaxLen": 256, "EnumOpts": [] }, { "Id": 15, "Name": "Sub-Category Prefix", "TableId": 4, "Description": null, "FieldT
PAGE 509
} ] "TableId": 1, "Description": null, "FieldTypeId": 1, "StrMaxLen": 256, "EnumOpts": [] }, { "Id": 2, "Name": "Alert Message", "TableId": 1, "Description": null, "FieldTypeId": 1, "StrMaxLen": 2048, "EnumOpts": [] } /api/QuerySupportService/QueryContexts(Id)/ QuerySupportService.GetFiltersForContext This URI represents summary information for all filters (queries) defined by using a specific Query Context. GET method for QuerySupportService.
PAGE 510
}, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { 510 "Id": 1008, "Name": "Fibre Channel Switches", "UsageId": 1, "FilterText": "", "ContextId": 2 "Id": 1017, "Name": "HCI Appliances", "UsageId": 1, "FilterText": "", "ContextId": 2 "Id": 1014, "Name": "Hypervisor Systems", "UsageId": 1, "FilterText": "", "ContextId": 2 "Id": 1016, "Name": "Hyper-V Servers", "UsageId": 1, "FilterText": "", "ContextId": 2 "Id": 1011, "Name": "Linux Servers", "UsageId": 1, "FilterText": "", "ContextId": 2 "Id"
PAGE 511
}, { }, { }, { }, { }, { }, { }, { }, { ] } "Id": 1002, "Name": "PowerEdge FX2", "UsageId": 1, "FilterText": "", "ContextId": 2 "Id": 1003, "Name": "PowerEdge M1000e", "UsageId": 1, "FilterText": "", "ContextId": 2 "Id": 1004, "Name": "PowerEdge VRTX", "UsageId": 1, "FilterText": "", "ContextId": 2 "Id": 1009, "Name": "Servers", "UsageId": 1, "FilterText": "", "ContextId": 2 "Id": 1012, "Name": "Storage Devices", "UsageId": 1, "FilterText": "", "ContextId": 2 "Id": 1015, "Name": "VMware ESXi Serve
PAGE 512
Table 170. Attributes (continued) Attribute Description UsageId 1=Query Group, 2=Report FilterText Unused ContextId The Query Context identifier of the filter. It should match the Query Context ID in the request. /api/QuerySupportService/OperatorInfo This URI represents the supported logical operators of a query. GET method for OperatorInfo This method returns a list of supported logical operators for each field type. Description Returns a list of supported logical operators for each field type.
PAGE 513
"Name": "is null" }, { "Id": 10, "Name": "is not null" }, { "Id": 11, "Name": "begins with" }, { "Id": 12, "Name": "ends with" }, { "Id": 13, "Name": "before" }, { "Id": 14, "Name": "after" } ], "FieldTypes": [ { "FieldTypeId": 1, "Name": "String", "OperatorIds": [ 1, 2, 3, 4, 5, 6, 11, 12, 7, 8, 9, 10 ] }, { "FieldTypeId": 2, "Name": "Number", "OperatorIds": [ 1, 2, 3, 4, 5, 6, 9, 10 ] }, { "FieldTypeId": 3, "Name": "Date-Time", "OperatorIds": [ 1, 2, 13, 14, 9, 10 ] }, APIs specific to OpenManage Enterpr
PAGE 514
{ } ] "FieldTypeId": 4, "Name": "Enum", "OperatorIds": [ 1, 2, 9, 10 ] }, { "FieldTypeId": 5, "Name": "Boolean", "OperatorIds": [ 1, 2, 9, 10 ] } /api/QuerySupportService/Filters This URI represents summary information for all filters. GET method for Filters This method returns summary information for all filters. Description Returns summary information for all filters. Privilege VIEW HTTP response codes 200 Example Response Body { "@odata.
PAGE 515
{ }, { }, { }, { ] } } "@odata.type": "#QuerySupportService.Filter", "@odata.id": "/api/QuerySupportService/Filters(1007)", "Id": 1007, "Name": "Dell Networking Switches", "UsageId": 1, "FilterText": "", "ContextId": 2, "Conditions": [] "@odata.type": "#QuerySupportService.Filter", "@odata.id": "/api/QuerySupportService/Filters(1008)", "Id": 1008, "Name": "Fibre Channel Switches", "UsageId": 1, "FilterText": "", "ContextId": 2, "Conditions": [] "@odata.type": "#QuerySupportService.Filter", "@odata.
PAGE 516
} "FilterText": "", "ContextId": 2, "Conditions": [ { "LogicalOperatorId": "LeftParen": true, "FieldId": 59, "OperatorId": 1, "Value": "101", "RightParen": true }, { "LogicalOperatorId": "LeftParen": true, "FieldId": 59, "OperatorId": 1, "Value": "102", "RightParen": true }, { "LogicalOperatorId": "LeftParen": true, "FieldId": 59, "OperatorId": 1, "Value": "202", "RightParen": true }, { "LogicalOperatorId": "LeftParen": true, "FieldId": 59, "OperatorId": 1, "Value": "203", "RightParen": true } ] 0, 2, 2
PAGE 517
Example Response Body { } "Id": 1564, "Name": "Test Group1", "Description": "Test Group1", "TypeId": 3000, "MembershipTypeId": 12, "GlobalStatus": 0, "ParentId": 0, "CreatedBy": "root", "UpdatedBy": "", "CreationTime": "2017-06-08 20:14:37.252", "UpdatedTime": "2017-06-08 20:14:37.252", "Visible": true, "Editable": true, "DefinitionId": 400, "DefinitionDescription": "UserDefined" /api/GroupService/Groups(Id)/SubGroups(Id) This URI represents a subgroup within a group.
PAGE 518
Example Response Body { } "@odata.context": "$metadata#Collection(GroupService.StatusSummary)", "@odata.count": 3, "value": [ { "StatusType": 4000, "Count": 26 }, { "StatusType": 3000, "Count": 4 }, { "StatusType": 1000, "Count": 15 } ] /api/GroupService/Groups(Id)/EventStatusSummary This URI represents the events status counts. GET method for EventStatusSummary This method returns events status counts per status values. Description Returns events status counts per status values.
PAGE 519
/api/GroupService/Groups(group id)/EventSeveritySummary? $filter=StatusType eq 2000 This URL returns the count of unacknowledged alerts. GET method for EventSeveritySummary?$filter=StatusType eq 2000 This method returns the count of unacknowledged alerts. Description Returns the count of unacknowledged alerts. /api/GroupService/Groups(group id)/EventSeveritySummary? $filter=StatusType eq 1000 This URL returns the count of acknowledged alerts.
PAGE 520
/api/GroupService/Actions/GroupService.CreateGroup This URI represents creation of a group. POST method for GroupService.CreateGroup This method creates a group. Description Creates a group.
PAGE 521
} } "ParentId": 1021 /api/GroupService/Actions/GroupService.Clone This URI represents cloning of a group. POST method for GroupService.Clone This method clones a group. Description Clones a group. Privilege GROUP_MANAGEMENT HTTP response codes 200 Example Request Body { } "Id": 3164, "Name": "Test Group-My122-cloned", "Description": "Test Group123-4", "GlobalStatus": 0, "DefinitionId": 0, "ParentId": 12 /api/GroupService/Actions/GroupService.DeleteGroup This URI represents deleting a group.
PAGE 522
/api/GroupService/Actions/GroupService.AddMemberDevices This URI represents adding devices to a group. POST method for GroupService.AddMemberDevices This method adds devices to a group. Description Adds devices to a group. Privilege GROUP_MANAGEMENT HTTP response codes 204 Example Request Body } { "GroupId":2614, "MemberDeviceIds" : [2514] /api/GroupService/Actions/GroupService.RemoveMemberDevices This URI represents removing devices from a group. POST method for GroupService.
PAGE 523
Example Request Body { } "UserId" : 3864, "GroupIds" : [1314, 1264] Devices /api/DeviceService/HostKeys This URL returns the list of known host keys. GET method for HostKeys Description This method returns the list of known host keys. Privilege DEVICE_CONFIGURATION HTTP response codes 200 Example response body { "@odata.context": "/api/$metadata#Collection(DeviceService.HostKey)", "@odata.count": 1, "value": [ { "@odata.type": "#DeviceService.HostKey", "@odata.
PAGE 524
Example request body { "HostKeys":[ { "Id":0, "Identifier":"10.35.155.
PAGE 525
} Auto deploy /api/AutoDeployService/Targets This URL is used to get all the auto deploy targets. GET method for Targets Description This method is used to get all the auto deploy targets. Privilege AUTO_DEPLOY_MANAGEMENT HTTP response codes 200 Example Response Body { "@odata.context": "/api/ $metadata#Collection(AutoDeployService.AutoDeployTarget)", "@odata.count": 2, "value": [ { "@odata.type": "#AutoDeployService.AutoDeployTarget", "@odata.
PAGE 526
} /api/AutoDeployService/Actions/AutoDeployService.Verify This URL validates the identifiers. Post method for AutoDeployService.Verify Description This method validates the identifiers.
PAGE 527
/api/AutoDeployService/Actions/AutoDeployService.Delete This URL deletes the list of autoDeployDevice IDs. POST method for AutoDeployService.Delete Description This method deletes the list of autoDeployDevice IDs. Privilege AUTO_DEPLOY_MANAGEMENT HTTP response codes 200 Example Request Body Case 1: Send AutoDeployDeviceIds – to delete the selected devices in the auto deploy wizard.
PAGE 528
"IpAddress": "xx.xx.xx.xx", "ShareName": "10.22.33.22", "User": "asdf", "Password": "asdf" } }, "Attributes": [] } /api/AutoDeployService/AutoDeploy(AutoDeployId) This URL cancels the autodeploy request before finalizing the request and deletes all the identifiers that are added in the validation API. Delete method for AutoDeploy(AutoDeployId) Description This method cancels the autodeploy request before finalizing the request and deletes all the identifiers that are added in the validation API.
PAGE 529
}, { }, { }, { "@odata.id": "/api/DiscoveryConfigService/Jobs(25249)", "JobId": 25249, "JobName": "Discovery-2017033110553636", "JobDescription": "Discovery-2017033110553636", "JobSchedule": "", "JobStartTime": "2018-09-14 01:24:25.322", "JobEndTime": null, "JobProgress": "89", "JobStatusId": 2050, "JobNextRun": null, "JobEnabled": true, "UpdatedBy": "admin", "LastUpdateTime": "2018-09-14 01:24:25.
PAGE 530
}, { } ] } "JobSchedule": "", "JobStartTime": "2018-09-13 15:59:08.565", "JobEndTime": "2018-09-13 16:02:09.36", "JobProgress": "100", "JobStatusId": 2070, "JobNextRun": null, "JobEnabled": true, "UpdatedBy": "admin", "LastUpdateTime": "2018-09-13 16:02:09.361", "DiscoveryConfigGroupId": 5, "DiscoveryConfigExpectedDeviceCount": 256, "DiscoveryConfigDiscoveredDeviceCount": 0, "DiscoveryConfigEmailRecipient": null, "DiscoveredDevicesByType": [] "@odata.type": "#DiscoveryConfigService.
PAGE 531
/api/DiscoveryConfigService/DiscoveryConfigGroups This URI creates a discovery job. POST method for DiscoveryConfigGroups This method creates a discovery job. Description Creates a discovery job.
PAGE 532
"DiscoveryConfigTargetId":0, "NetworkAddressDetail":"xx.xx.xx.xx", "AddressType":30, "Disabled":false, "Exclude":false } ], "ConnectionProfileId":0, "ConnectionProfile":"{\"profileName\":\"\",\"profileDescription \":\"\",\"type\":\"DISCOVERY\",\"credentials\":[{\"id\":0,\"type \":\"WSMAN\",\"authType\":\"Basic\",\"modified\":false,\"credentials\": {\"username\":\"root\",\"password\":\"calvin\",\"caCheck \":false,\"cnCheck\":false,\"port\":443,\"retries\":3,\"timeout \":60,\"isHttp\":false,\"keepAlive\":fal
PAGE 533
Example to run discovery job with multiple protocols Example request body Example to email a discovery task after completion Example request body { "DiscoveryConfigGroupName":"Discovery-2017091614032525", "DiscoveryConfigGroupDescription":"null", "DiscoveryConfigModels":[ { "DiscoveryConfigId":916140325, "DiscoveryConfigDescription":"", "DiscoveryConfigStatus":"", "DiscoveryConfigTargets":[ { "DiscoveryConfigTargetId":0, "NetworkAddressDetail":"xx.xx.xx.
PAGE 534
"DiscoveryConfigStatus":"", "DiscoveryConfigTargets":[ { "DiscoveryConfigTargetId":0, "NetworkAddressDetail":"10.0.0.0", "AddressType":30, "Disabled":false, "Exclude":false } ], "ConnectionProfileId":0, "ConnectionProfile":"{\"profileName\":\"\",\"profileDescription \":\"\",\"type\":\"DISCOVERY\",\"credentials\":[{\"id\":0,\"type \":\"WSMAN\",\"authType\":\"Basic\",\"modified\":false,\"credentials\": {\"username\":\"root\",\"password\":\"calvin\",\"caCheck \":false,\"cnCheck\":false,\"port\":443,\"retries\"
PAGE 535
/api/DiscoveryConfigService/Actions/DiscoveryConfigService.Parse This URI represents discovery ranges parsed from a .CSV file. POST method for DiscoveryConfigService.Parse This method parses the discovery ranges from the .CSV file. Description Parses the discovery ranges from the .CSV file. Privilege DISCOVERY_MANAGEMENT HTTP response codes 201 Example request body { fileName="abc.csv" } /api/DiscoveryConfigService/DiscoveryConfigGroups(groupId) This URI updates a discovery task.
PAGE 536
} Example response body }, "CreateGroup":true, "TrapDestination":false { "DiscoveryConfigGroupId": 11, "DiscoveryConfigGroupName": "Discovery-2018022611572222-updated", "DiscoveryConfigGroupDescription": "Discovery-2018022611572222updated", "DiscoveryStatusEmailRecipient": null, "DiscoveryConfigParentGroupId": 0, "CreateGroup": true, "DiscoveryConfigModels": [ { "DiscoveryConfigId": 331105536, "DiscoveryConfigDescription": "", "DiscoveryConfigStatus": "", "DiscoveryConfigTargets": [ { "DiscoveryConfigTa
PAGE 537
Table 175. Attributes (continued) Attribute name Description Description Definition for discovery Task Schedule Discovery job schedule information TaskId Id of the job ConnectionProfileId Connection profile Id DeviceTypeList List of all device types DiscoveryConfiglist Config details Warranty service /api/WarrantyService/Warranties This URI represents the retrieval of warranty information from OpenManage Enterprise.
PAGE 538
Table 176.
PAGE 539
Example request body { "Id":0, "JobName":"Warranty Task4", "JobDescription":"Warranty Task", "Schedule":"startnow", "State":"Enabled", "JobType": { "Id":130, "Name":"Warranty_Task" }, "Params":[ { "Key":"warrantyCollectionType", "Value":"complete" } ], "Targets": [ { "Id":500, "Data":"", "TargetType": { "Id":6000, "Name":"GROUP" } } } ] Report service /api/ReportService/ReportDefs This URI represents the OpenManage Enterprise report definitions.
PAGE 540
HTTP response codes Example response body 200 { "@odata.context": "/api/$metadata#Collection(ReportService.ReportDef)", "@odata.count": 21, "value": [{ "@odata.type": "#ReportService.ReportDef", "@odata.id": "/api/ReportService/ReportDefs(10042)", "Id": 10042, "Name": "Alert Counts per Device Report", "Description": "This report contains alert counts per severity and totals per Device.", "IsBuiltIn": true, "LastEditedBy": "admin", "LastRunDate": "2018-09-11 15:36:17.
PAGE 541
{ } "Id": 1008, "Name": "Total", "Width": 20, "Sequence": 9 } ], "FilterGroupId": 0, "QsmQuery": false, "ReportResults": { "@odata.id": "/api/ReportService/ReportDefs(10042)/ReportResults" } }] Table 177.
PAGE 542
}, { }, { "Name":"Device Model" "Width":20, "Sequence":3, "Name":"Software Component ID" "Width":20, "Sequence":4, "Name":"Software Description" } ], "FilterGroupId":64, "QueryDefRequest":{ "ContextId":3, "ResultFields":[ { "FieldId":61 }, { "FieldId":64 }, { "FieldId":63 }, { "FieldId":99 }, { "FieldId":102 } ], "SortFields":[ } } ] PUT method for ReportDefs This method updates a report. Description Updates a report.
PAGE 543
} "Width": 25, "Sequence": 2 }], "QueryDefRequest": { "ContextId": 2, "Conditions": [{ "LogicalOperatorId": 1, "LeftParen": false, "FieldId": 65, "OperatorId": 1, "Value": "1000", "RightParen": false }], "ResultFields": [{ "FieldId": 71 }, { "FieldId": 68 }, { "FieldId": 69 }, { "FieldId": 70 }, { "FieldId": 65 }], "SortFields": [{ "FieldId": 65, "SortDir": 0 }] } Table 178. Attributes Attribute name Description ID Report ID Name Report Name Description Definition of the report.
PAGE 544
"Id": 3, "Title": "Device Overview Report", "TaskId": 25031, "ResultRowColumns": [{ "Id": 21, "Name": "Device Name", "Width": 20, "Sequence": 0 }, { "Id": 22, "Name": "Device Type", "Width": 20, "Sequence": 1 }, { "Id": 23, "Name": "Device Model", "Width": 20, "Sequence": 2 }, { "Id": 24, "Name": "Identifier", "Width": 20, "Sequence": 3 }, { "Id": 25, "Name": "Device Asset Tag", "Width": 25, "Sequence": 4 }, { "Id": 26, "Name": "Datacenter", "Width": 25, "Sequence": 5 }, { "Id": 27, "Name": "Aisle", "Width"
PAGE 545
HTTP response codes Example response body 200 { "@odata.context": "/api/ $metadata#Collection(ReportService.ReportResultRow)", "@odata.count": 1, "value": [ { "@odata.type": "#ReportService.ReportResultRow", "Values": [ "iDRAC-792B0M2", "SERVER", "PowerEdge R640", "792B0M2", "", "", "", "" ] } ] } /api/ReportService/Actions/ReportService.RunReport This URI is used to run a report. POST method for Running Reports This method is used to run reports. Description Used to run reports.
PAGE 546
Example request body { } "ReportDefId":1564, "Format":"pdf" /api/ReportService/Actions/ReportService.DeleteReports This URI represents the reports deletion. POST method for ReportService.DeleteReports This method deletes all the reports. Description Deletes all the reports. Privilege REPORT_MANAGEMENT HTTP response codes 200 Example request body [1564] /api/ReportService/Actions/ReportService.CloneReport This URI represents cloning of a report. POST method for ReportService.
PAGE 547
HTTP response codes Example request body 200 { "ReportDefId":10037, "Format":"pdf", "EmailIds":"abcd@xyz.com" } MIB import service /api/MIBImportService/MIBS This URI represents the MIB traps. GET method for MIBS This method returns the traps imported from all the MIBs. All the traps with information are listed and they an be grouped based on the catalog name. Description Returns the traps imported from all the MIBs. Privilege VIEW HTTP response codes 200 Example request body { "@odata.
PAGE 548
} "SnmpEventId": 1000, "SpecificTrapId": 5405 }] /api/MIBImportService/Actions/MIBImportService.Save This URI represents the saved traps from MIBs. POST method for MIBImportService.Save This method saves parsed traps from MIB in the appliance. This URI provides functionality to save traps already parsed from the MIB. Description Saves parsed traps from MIB in the appliance. Privilege TRAP_MANAGEMENT HTTP response codes 200 Example response body 548 [{ "EnterpriseOid": ".1.3.6.1.4.1.674.10892.
PAGE 549
/api/MIBImportService/Actions/MIBImportService.Parse This URI represents the trap information by parsing MIBs. POST method for MIBImportService.Parse This method parses MIB files to get trap information. This URI accepts absolute file paths of the MIB file that need to be parsed. Description Parses MIB files to get trap information. Privilege TRAP_MANAGEMENT HTTP response codes 200 Example request body ["/tmp/parseMib/10892.mib"] /api/MIBImportService/Actions/MIBImportService.
PAGE 550
} "Name": "Unknown", "Description": "Unknown" }] /api/MIBImportService/MIBImportService/EventCatalogs This URI represents the event catalogs. GET method for EventCatalogs This method returns the event catalogs. Description Returns the event catalogs. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "/api/ $metadata#Collection(MIBImportService.MIBEventCatalog)", "@odata.count": 46, "value": [{ "@odata.type": "#MIBImportService.MIBEventCatalog", "@odata.
PAGE 551
} }] Plugin Manager NOTE: The APIs in this section can be used only when the power plug-in is installed on OpenManage Enterprise. /api/PluginService/Plugins This URL returns the plug-in list. GET method for Plugins Description This method returns all the available plug-in. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "/api/$metadata#Collection(PluginService.Plugin)", "@odata.count": 1, "value": [ { "@odata.type": "#PluginService.Plugin", "@odata.
PAGE 552
} ] Table 179. Attributes Attribute Description Id Plug-in ID Name Plug-in name UpdateAvailable Is update available for the plug-in. Installed Is the plug-in already installed or not? Enabled Is the plug-in enabled or not? Publisher Plug-in publisher CurrentVersion Current installed version. Description Description associated with the plug-in. InstalledDate Last installed date of the plug-in. LastUpdatedDate Last updated date of the plug-in.
PAGE 553
(CMC) Enterprise license, OpenManage Enterprise Power Manager leverages information from the OpenManage Enterprise console for platform-level power management. OpenManage Enterprise Power Manager then communicates with Integrated Dell Remote Access Controller (iDRAC) or CMC on each managed server or chassis to provide power-management data, as well as execution of control policy - making it easy for IT professionals to identify areas to gain efficiencies and cut wasteful costs.
PAGE 554
Table 180. Attributes Attribute Description Version Version of the plug-in. Description Description associated with the plug-in version. PackageSize Package size of the plug-in in bytes. ReleaseNoteURL Release note URL for the plug-in version. MinimumOmeVersionRequired Minimum OpenManage Enterprise version required for the plug-in version. /api/PluginService/Actions/ PluginService.CheckPluginCompatibility This URL validates the plug-in to check if it is compatible with OpenMange Enterprise.
PAGE 555
Table 181. Attributes (continued) Attribute Description Compatible Is the plug-in version compatible with the given OpenManage Enterprise version or not? /api/PluginService/Actions/PluginService.UpdateConsolePlugins This URL is used to install or uninstall, enable or disable, or update the plug-in. POST method for PluginService.UpdateConsolePlugins Description This method is used to install or uninstall, enable or disable, or update the plug-in.
PAGE 556
Power Metrics NOTE: The APIs in this section can be used only when the power plug-in is installed on OpenManage Enterprise. /api/MetricService/Metrics This URL returns all the device or group metrics. POST method for Metrics Description This method returns all the device or group metrics.
PAGE 557
Table 183. Attributes (continued) Attribute Description MetricTypes Types of metrics supported. Duration Duration of metric data collection. SortOrder Order of metric data collected.
PAGE 558
Table 183. Attributes (continued) Attribute Description 8 Six Months 9 One Year Sort Order 0 Descending 1 Ascending /api/MetricService/TopEnergyConsumption This URL represents the most high energy consumption. POST method for TopEnergyConsumption Description This method returns the information of the most high energy consumption.
PAGE 559
Table 184. Attributes Attribute Description PluginId ID of plug-in. Top Top values, 1–5. EntityType Type of entity device or group. DeviceType Type of device—server or chassis. Duration Duration Entity Type 0 Device 1 Group Device Type 1000 Server 2000 Chassis Duration 4 One day 5 One week 6 Two weeks 7 One month 8 Three months 9 Six months 10 One year /api/MetricService/EnergyConsumption This URL returns the energy consumption of the device.
PAGE 560
Table 185. Attributes Attribute Description PluginId ID of a plug-in. EntityType Type of an entity, only device. EntityId ID of an entity, only device. Duration Duration Total Energy Energy Consumption in KWH. Duration 1 One hour 2 Six hours 3 Twelve hours 4 One day 5 Seven days 6 One month 7 Three months 8 Six months 9 One year /api/MetricService/MetricTypes This URL returns all the supported metric types.
PAGE 561
}, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { }, { "Id": 3, "Name": "AVG_POWER", "Description": "Average System Power Consumption" "@odata.type": "#MetricService.MetricType", "Id": 4, "Name": "INSTANT_POWER", "Description": "Instant System Power" "@odata.type": "#MetricService.MetricType", "Id": 5, "Name": "MAX_INLET_TEMP", "Description": "Maximum Inlet Temperature" "@odata.type": "#MetricService.
PAGE 562
}, { }, { }, { }, { } ] } "Id": 15, "Name": "MAX_UTIL_IO", "Description": "Maximum IO utilization" "@odata.type": "#MetricService.MetricType", "Id": 16, "Name": "MIN_UTIL_IO", "Description": "Minimum IO utilization" "@odata.type": "#MetricService.MetricType", "Id": 17, "Name": "AVG_UTIL_IO", "Description": "Average IO utilization" "@odata.type": "#MetricService.MetricType", "Id": 18, "Name": "SYS_AIRFLOW", "Description": "System Air Flow" "@odata.type": "#MetricService.
PAGE 563
}, { ] } } "Type": "3", "Value": "192.75" Table 186. Attributes Attribute Description PluginId ID of a plug-in. EntityType Type of an entity—device or group. EntityId ID of an entity—device or group. Duration Duration MetricTypes Type that is supported by the metric.
PAGE 564
} Example response body { } "PluginId": "2F6D05BE-EE4B-4B0E-B873-C8D2F64A4625", "EntityId": 10079, "Type": "Temperature", "State": "Unknown", "UpperWarning": "100", "UpperCritical": "150", "LowerWarning": "70", "LowerCritical": "80" Table 187. Attributes Attribute Description PluginId ID of a plug-in. EntityId ID of an entity—device or group. Type Type—temperature or power. State State of an entity—unknown, normal, warning, critical. UpperWarning Upper limit threshold of state warning.
PAGE 565
} "EntityId": 10079, "Type": "Temperature", "State": "Unknown", "UpperCritical": "40", "UpperWarning": "30", "LowerWarning": "20", "LowerCritical": "10" Table 188.
PAGE 566
18 Redfish resource model Dell EMC incrementally improves the support for API and the associated operations during the life cycle of the products. The limited Redfish implementation follows the industry-standard DMTF specifications. For more information, see the documentation available on the DMTF website.
PAGE 567
"DeviceService":{"@odata.id": "/api/DeviceService"}, "OAuthService":{"@odata.id": "/api/OAuthService"}, "SessionService":{"@odata.id": "/api/SessionService"}, "AlertService":{"@odata.id": "/api/AlertService"} } }, "Id": "RootService", "Name": "Root Service", "Links":{ "Sessions":{ "@odata.id": "/redfish/v1/SessionService/Sessions" }, "Oem":{ } }, "RedfishVersion": "1.2.0", "CompositionService":{ "@odata.id": "/redfish/v1/CompositionService" }, "AccountService":{ "@odata.
PAGE 568
PAGE 569
PAGE 570
PAGE 571
MessageRegistryCollection_v1.xml">
PAGE 572
PAGE 573
PAGE 574
PAGE 575
Example response body { "@odata.
PAGE 576
/redfish/v1/SessionService This URI represents the collection of session services. GET method for SessionService This method returns a collection of session service. Description Returns a collection of session service. Privilege VIEW HTTP response codes 200 Example response body { } "@odata.context": "$metadata#SessionService.SessionService", "@odata.
PAGE 577
"@odata.context": "$metadata#Collection(SessionService.Session)", "@odata.count": 1, "value": [ { "@odata.id": "/api/SessionService/Sessions('7b723932-a119-4843a5b7-7a122e4def99')", "Id": "7b723932-a119-4843-a5b7-7a122e4def99", "Description": "root", "Name": "API", "UserName": "root", "Password": null, "Roles": [ "ADMINISTRATOR" ], "IpAddress": "xx.xx.xx.xx", "StartTimeStamp": "2017-04-17 20:07:12.357", "LastAccessedTimeStamp": "2017-04-17 20:07:45.482" } ] } Table 190.
PAGE 578
} "StartTimeStamp": "2017-04-17 20:07:12.357", "LastAccessedTimeStamp": "2017-04-17 20:07:12.357" Table 191. Attributes Attribute name Description Id ID of the session service. UserName User name of the active session. Password Password of the active session. Roles Privilege assigned to the role. IpAddress IP Address of session source. StartTimeStamp Date and time when the session began. LastAccessedTimeStamp Date and time when the session was last accessed.
PAGE 579
DELETE method for Members(Id) This method deletes a session. Description Deletes a session. Privilege SECURITY_SETUP HTTP response code 204 Example request body /api/SessionService/Sessions/Sessions(‘7b723932-a119-4843a5b7-7a122e4def99’) Redfish—Account Service This resource enables you to access the account configuration. Using this resource, you can view the accounts and their roles, update the configuration of accounts, delete accounts, and so on.
PAGE 580
} "AccountLockoutCounterResetAfter": 900, "Accounts": { "@odata.id": "/redfish/v1/AccountService/Accounts" }, "Roles": { "@odata.id": "/redfish/v1/AccountService/Roles" } Table 192. Attributes Attribute name Description ID ID of the account service. Description Description of the account service. Name Name of the account service. ByUserName Indicates if the service is configured by user name. ByIPAddress Indicates if the service is configured by IP address.
PAGE 581
} Example response body { } "Id": "10", "Description": "MSM User Accounts", "Name": "Account Service", "Status": { "State": "Enabled", "HealthRollup": "OK", "Health": "OK" }, "ServiceEnabled": false, "AuthFailureLoggingThreshold": 3, "MinPasswordLength": 8, "MaxPasswordLength": 20, "AccountLockoutThreshold": 3, "AccountLockoutDuration": 30, "AccountLockoutCounterResetAfter": 900 "Id": "10", "Description": "MSM User Accounts", "Name": "Account Service", "Status": { "State": "Enabled", "HealthRollup": "O
PAGE 582
Table 193. Attributes (continued) Attribute name Description AccountLockoutThreshold The number of failed login attempts after which a user account is locked for the specified duration. 0 indicates that the account is never locked. AccountLockoutDuration Number of seconds for which an account is locked after the account lockout threshold is met. This value must be equal to or greater than the value for AccountLockoutResetAfter. 0 indicates that the account is never locked.
PAGE 583
"Name": "compute", "Password": null, "UserName": "compute", "RoleId": "10", "Locked": false, "Enabled": true } ] } Table 194. Attributes Attribute name Description Id ID of the account. UserTypeId ID of the type of user. DirectoryServiceId ID of the directory service. Description Description of the user. Name Name of the user. This value is the same as user name. Password Password for the user. This value is not displayed while retrieving the details. UserName User name of the account.
PAGE 584
} "Locked": false, "IsBuiltin": false, "Enabled": true Table 195. Attributes Attribute name Description Id ID of the account. UserTypeId ID of the type of user. DirectoryServiceId ID of the directory service. Description Description of the user. Name Name of the user. This value is the same as user name. Password Password for the user. This value is not displayed when retrieving the details. UserName User name of the account. RoleId Role for the account.
PAGE 585
} "Links": null Table 196. Attributes Attribute name Description Id ID of the account. UserTypeId ID of the type of user. DirectoryServiceId ID of the directory service. Description Description of the user. Name Name of the user. This value is the same as user name. Password Password for the user. This value is not displayed when retrieving the details. UserName User name of the account. RoleId Role for the account. Locked Indicates whether the account is locked.
PAGE 586
Table 197. Attributes Attribute name Description Id ID of the account. UserTypeId ID of the type of user. DirectoryServiceId ID of the directory service. Description Description of the user. Name Name of the user. This value is the same as user name. Password Password for the user. This value is not displayed when retrieving the details. UserName User name of the account. RoleId Role for the account. Locked Indicates whether the account is locked.
PAGE 587
"value":[ { "@odata.type": "#Role.v1_2_2.Role", "@odata.id": "/redfish/v1/AccountService/Roles/Members('10')", "Id": "10", "Description": "Privileges to do all operations", "Name": "CHASSIS_ADMINISTRATOR", "IsPredefined": true }, { "@odata.type": "#Role.v1_2_2.Role", "@odata.id": "/redfish/v1/AccountService/Roles/Members('11')", "Id": "11", "Description": "Allowed to deploy services from a template and perform operations on service.
PAGE 588
Redfish—Message Registry This resource enables you to access the message services. Using this resource, you can access the messages services, base messages, and Event And Error Messages for error handling and audits. Use the URIs in this resource to access the message registry and the list of event and error messages. /redfish/v1/Registries This URI represents a collection of the message services. GET method for Registries This method returns a collection of message services.
PAGE 589
"Description": "MSM Message Registry File locations", "Name": "MSM Message Registry File", "Languages":[ "en", "fr", "zh", "ja", "es", "de", "ko" ], "Registry": "MSM 1.0", "Location":[ { "Language": "en", "Uri": "/redfish/v1/MessageRegistryCollection/ Members('EEMIRegistry.v1_0_0_en')" }, { "Language": "fr", "Uri": "/redfish/v1/MessageRegistryCollection/ Members('EEMIRegistry.v1_0_0_fr')" }, { "Language": "zh", "Uri": "/redfish/v1/MessageRegistryCollection/ Members('EEMIRegistry.
PAGE 590
Example response body { "@odata.context": "/redfish/ v1/$metadata#MessageRegistry.v1_0_0.MessageRegistry/$entity", "@odata.type": "#MessageRegistry.v1_0_0.MessageRegistry", "@odata.id": "/redfish/v1/MessageRegistryCollection/Members('Messages')", "Oem": null, "Id": "Messages", "Description": "This registry defines the MSM messages for Redfish", "Name": "MSM EEMI Registry", "Language": "Messages", "RegistryPrefix": "MSM", "RegistryVersion": "1.0.
PAGE 591
{ }, { }, { }, { } ] } "@odata.id": "/redfish/v1/Chassis/Members('25011')" "@odata.id": "/redfish/v1/Chassis/Members('25015')" "@odata.id": "/redfish/v1/Chassis/Members('25010')" "@odata.id": "/redfish/v1/Chassis/Members('25009')" redfish/v1/Chassis/Members(id) This method represents chassis instance information, by IDs. GET method for chassis members This method returns details about the chassis member. Description Returns details about chassis members.
PAGE 592
"GracefulShutdown", "PowerCycle"], "target": "/redfish/v1/Chassis/Members('10057')/Actions/Chassis.Reset" } }, "PowerState": "On", "Thermal":{ "@odata.id": "/redfish/v1/Chassis/Members('10057')/Thermal" }, "Power":{ "@odata.id": "/redfish/v1/Chassis/Members('10057')/Power" } } redfish/v1/Chassis/Members(id)/Power This API returns the chassis power information. GET method for chassis power information This method returns the chassis power information.
PAGE 593
} }, "PowerState": "On", "Thermal":{ "@odata.id": "/redfish/v1/Chassis/Members('10057')/Thermal" }, "Power":{ "@odata.id": "/redfish/v1/Chassis/Members('10057')/Power" } } redfish/v1/Chassis/Members(id)/Power/PowerControl() This API represents the power control information of the member chassis. Get method for power control information This method returns the power control information of the member chassis. Description Returns the power control information of the member chassis.
PAGE 594
Privilege VIEW HTTP response code 200 Example response body { "@odata.context": "/redfish/v1/$metadata#Power.v1_0_0.PowerSupply", "@odata.type": "#Power.v1_0_0.PowerSupply", "@odata.id": "/redfish/v1/Chassis/Members('10054')/Power/ PowerSupplies('PSU.Slot.2')", "MemberId": "PSU.Slot.2", "Name": "PSU.Slot.
PAGE 595
redfish/v1/Chassis/Members(id)/Thermal/Temperatures() This API represents chassis temperature information. GET method for temperature information This method returns chassis temperature information. Description Returns chassis temperature information. Privilege VIEW HTTP response code 200 Example response body { "@odata.context": "/redfish/v1/$metadata#Thermal.v1_0_0.Temperature", "@odata.type": "#Thermal.v1_0_0.Temperature", "@odata.
PAGE 596
redfish/v1/Managers/Members() This API represents the chassis manager information. GET method for chassis manager information This API returns the chassis manager information. Description Returns the chassis manager information. Privilege VIEW HTTP response code 200 Example response body { "@odata.context": "/redfish/v1/$metadata#Manager.v1_0_0.Manager", "@odata.type": "#Manager.v1_0_0.Manager", "@odata.
PAGE 597
redfish/v1/Chassis/Members(id)/Actions/Chassis.Reset This API represents chassis reset information. POST method for chassis reset This method resets the chassis. Description Resets the chassis. Privilege DEVICE_CONFIGURATION HTTP response codes 202 Example request body { "ResetType": "" } Table 200. Attributes Attribute name Description ResetType The allowed values are: ● ● ● ● On ForceOff Graceful Shutdown PowerCycle Some of the options work based on the type of the device.
PAGE 598
Redfish—Systems This API represents server information. /redfish/v1/Systems This URI represents the systems. GET method for Systems This method returns the collection of the systems. Description Returns the collection of systems. Privilege VIEW HTTP response codes 200 Example response body { "@odata.context": "/redfish/ v1/$metadata#ComputerSystemCollection.ComputerSystemCollection", "@odata.type": "#ComputerSystemCollection.ComputerSystemCollection", "@odata.
PAGE 599
"Description": "Server Device", "Name": "idrac-7C1000D", "SystemType": "Physical", "Links":{ "ResourceBlocks":[ { "@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/ Members('19')" }, {"@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/ Members('2')"}, {"@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/ Members('3')"}, {"@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/ Members('4')"}, {"@odata.
PAGE 600
}, "#ComputerSystem.Reset":{ "ResetType@Redfish.AllowableValues":["On", "ForceOff", "GracefulShutdown", "PowerCycle"], "target": "/redfish/v1/Systems/Members('10055')/Actions/ ComputerSystem.Reset" }, "#ComputerSystem.AddResourceBlock":{ "target": "/redfish/v1/Systems/Members('10055')/Actions/ ComputerSystem.AddResourceBlock" }, "#ComputerSystem.RemoveResourceBlock":{ "target": "/redfish/v1/Systems/Members('10055')/Actions/ ComputerSystem.
PAGE 601
{ "@odata.id": "/redfish/v1/Systems/Members('10055')/Processors/ Members('9776')" }, { "@odata.id": "/redfish/v1/Systems/Members('10055')/Processors/ Members('9777')" } ] } redfish/v1/Systems/Members(id)/Processors/Members(id) This API represents server processor information of specific systems. GET method for processors by IDs This method returns server processor information, by device ID. Description Returns server processor information.
PAGE 602
Example response body { "@odata.context": "/redfish/ v1/$metadata#EthernetInterfaceCollection.EthernetInterfaceCollection", "@odata.type": "#EthernetInterfaceCollection.EthernetInterfaceCollection", "@odata.id": "/redfish/v1/Systems/Members('10189')/EthernetInterfaces", "Name": "Ethernet Interface Collection", "Members@odata.count": 8, "Members":[ { "@odata.id": "/redfish/v1/Systems/Members('10189')/EthernetInterfaces/ Members('15674')" }, { "@odata.
PAGE 603
Members('15676')", "Id": "15676", "Name": "NIC.Mezzanine.2B-1-1", "InterfaceEnabled": false, "PermanentMACAddress": "24:6E:96:9C:E8:5C", "MACAddress": "24:6E:96:9C:E8:5C", "SpeedMbps": 0, "AutoNeg": false, "FullDuplex": false, "MTUSize": 0, "MaxIPv6StaticAddresses": 0, "IPv4Addresses":[], "IPv6AddressPolicyTable":[], "IPv6Addresses":[], "IPv6StaticAddresses":[], "NameServers":[] } redfish/v1/Systems/Members(id)/SimpleStorage This API represents simple server storage information.
PAGE 604
redfish/v1/Systems/Members(id)/SimpleStorage/Members This API represents the simple server storage. Get method for storage devices This method returns the simple server storage details. Description Returns the simple server storage details. Privilege VIEW HTTP response code 200 Example response body { "@odata.context": "/redfish/ v1/$metadata#Collection(SimpleStorage.SimpleStorage)", "@odata.count": 4, "value":[ { "@odata.type": "#SimpleStorage.v1_0_0.SimpleStorage", "@odata.
PAGE 605
"Id": "10053", "Description": "", "Name": "PERC H730P MX", "UefiDevicePath": "", "Devices":[], "Status":{ "State": "Enabled", "HealthRollup": "OK", "Health": "OK" } } redfish/v1/Systems/Members(id)/Actions/ ComputerSystem.Reset This API resets the state of the server. POST method to reset server state This method resets the state of the server. Description Resets the server state. Privilege DEVICE_CONFIGURATION HTTP response codes 202 Example request body { "ResetType": "" } Table 202.
PAGE 606
HTTP response code Example response body 200 { "@odata.context": "/redfish/ v1/$metadata#CompositionService.v1_0_0.CompositionService", "@odata.type": "#CompositionService.v1_0_0.CompositionService", "@odata.id": "/redfish/v1/CompositionService", "Id": "CompositionService", "Description": "Composition Service", "Name": "Composition Service", "Status":{ "State": "Enabled", "HealthRollup": "OK", "Health": "OK" }, "ServiceEnabled": true, "ResourceBlocks":{ "@odata.
PAGE 607
Members('54')" }, { "@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/ Members('55')" }, { "@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/ Members('57')" }, { "@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/ Members('60')" }, { "@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/ Members('35')" }, { "@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/ Members('36')" }, { "@odata.
PAGE 608
Members('49')" }, { "@odata.id": "/redfish/v1/CompositionService/ResourceBlocks/ Members('50')" } ] } redfish/v1/CompositionService/ResourceBlocks/ Members() This API represents the power information of a device, by the device ID. GET method for ResourceBlocks by ID This API returns the power information of a device, by device ID. Description Returns the power information of a device, by device ID. Privilege VIEW HTTP response code 200 Example response body 608 { "@odata.
PAGE 609
{ "@odata.id": "/redfish/v1/Systems/Members('10189')" } ], "Drives@odata.count": 0, "Drives":[] } redfish/v1/CompositionService/ResourceZones This API represents power control information. GET method for ResourceZones This method returns the power control information. Description Returns the power control information. Privilege VIEW HTTP response code 200 Example response body { "@odata.context": "/redfish/v1/$metadata#ZoneCollection.ZoneCollection", "@odata.type": "#ZoneCollection.
PAGE 610
redfish/v1/CompositionService/ResourceZones/ Members() This API represents power supply information, by device ID. GET method for ResourceZones by ID This method returns the power supply information, by device ID. Description Returns the power supply information, by device ID. Privilege VIEW HTTP response code 200 Example response body { "@odata.context": "/redfish/v1/$metadata#Zone.v1_0_0.Zone", "@odata.type": "#Zone.v1_0_0.Zone", "@odata.
PAGE 611
} } /redfish/v1/Systems/Members()/Actions/ ComputerSystem.RemoveResourceBlock This API represents removing a member chassis from a chassis group. POST method for removing ResourceBlock This method removes member chassis from a chassis group. Description Removes member chassis from a chassis group. Privilege DEVICE_CONFIGURATION HTTP response code 202 Example request body { "ResourceBlock": { "@odata.