GET /osdeployment/globalSettings

Use the GET method to retrieve the current global settings for operating-system deployment.

Authentication

Authentication with user name and password is required.

Request URL

GET https://<management_server_IP>/osdeployment/globalSettings

Query parameters

None

Request body

None

Response codes

Code Description
200 OK
403 Forbidden. The server could not authenticate this session.
500 Internal server error. An internal error occurred.

Response body

Attributes Type Description
deploySettings Object Information about deployment settings
  ipDuplicationCheckEnabled Boolean Indicates whether the duplicate-IP check runs at the beginning of an OS deployment. This can be one of the following values.
  • true. Duplicate-IP check runs

  • false. Duplicate-IP check does not run

  stateTransitionTimeout Integer Amount of time, in seconds, to wait between status updates before failing the OS deployment
globalSetting Object Information about global settings
  activeDirectory Object Information about Active Directory
    allDomains Array of objects Information about all Active Directory domains
      id String ID of the Active Directory domain
      domainName String Name of the Active Directory domain
      OU String Organizational unit of the Active Directory domain
    defaultDomain String Name of the default domain. This is one of the Active Directory domains in the AllDomains list)
  credentials Array of objects Information about user credentials
    name ​​String User name. This can be one of the following values.
  • root. For Linux and ESXi users.
  • Administrator​. For Windows users
    password String Encrypted password
    type String Operating system type. This can be one of the following values.
  • ESXi
  • LINUX
  • RHEL/ESXi (This value will be deprecated in a future release. Use "ESXi" or "LINUX" instead.)
  • WINDOWS
  ipAssignment String Host network setting option for operating-system deployment. This can be one of the following values.
  • dhcpv4
  • staticv4
  • staticv6
  isVLANMode Boolean Indicates whether VLAN mode is used. This can be one of the following values.
  • true. VLAN mode is used.
  • false. VLAN mode is not used.
  licenseKeys Object Information about volume-license keys
    win2012r1 Object Information about volume-license keys for Microsoft Windows 2012 R1
      dataCenterLicenseKey String Volume-license key that is used to deploy the data center version of Microsoft Windows 2012 R1
      standardLicenseKey String Volume-license key that is used to deploy the standard version of Microsoft Windows 2012 R1
    win2012r2 Object Information about volume-license keys for Microsoft Windows 2012 R2
      dataCenterLicenseKey String Volume-license key that is used to deploy the data center version of Microsoft Windows 2012 R2
      standardLicenseKey String Volume-license key that is used to deploy the standard version of Microsoft Windows 2012 R2
    win2016r1 Object Information about volume-license keys for Microsoft Windows 2016 R1
      dataCenterLicenseKey String Volume-license key that is used to deploy the data center version of Microsoft Windows 2016 R1
      standardLicenseKey String Volume-license key that is used to deploy the standard version of Microsoft Windows 2016 R1
    win2019r1 Object Information about volume-license keys for Microsoft Windows 2019 R1
      dataCenterLicenseKey String Volume-license key that is used to deploy the data center version of Microsoft Windows 2019 R1
      standardLicenseKey String Volume-license key that is used to deploy the standard version of Microsoft Windows 2019 R1
result String Result of the request. This can be one of the following values.
  • success. The request completed successfully.
  • failed. The request failed. A descriptive error message was returned.
messages Array of objects Message that is related to the result of the request
  explanation String Additional information to clarify the reason for the message
  id String Message identifier of a returned message
  recovery Array Recovery information
    text String User actions that can be taken to recover from the event
    URL String Link to the help system for more information, if available
  text String Message text associated with the message identifier

Response example

When the request is successful (response code of 200), a message body similar to the following is returned:

{
   "deploySettings": { 
      "ipDuplicationCheckEnabled": false, 
      "stateTransitionTimeout": 120 
   }
   "globalSetting": {
      "activeDirectory": {
         "allDomains": [{
            "domainName": "lenovo", 
            "id": 0, 
            "OU": "lenovo"
         }, 
         {
            "domainName": "lenovox86", 
            "id": 1, 
            "OU": "lenovo-x86"
         }], 
         "defaultDomain": "lenovox86/lenovo-x86"
      }, 
      "credentials": [{
         "name": "root",
         "type": "ESXi",
         "password": null
      },
      {
         "name": "root",
         "type": "LINUX",
         "password": null
      },
      {
         "name": "root",
         "type": "RHEL\/ESXi",
         "password": null
      },
      {
         "name": "Administrator",
         "type": "WINDOWS",
         "password": null
      }]
      "ipAssignment": "staticv4",
      "isVLANMode": true,
      "licenseKeys": {
         "win2019r1": {
            "dataCenterLicenseKey": "AAAA4-BBBBB-CCCCC-DDDDD-EEEEE",
            "standardLicenseKey": "AAAA3-BBBBB-CCCCC-DDDDD-EEEEE"
         },
         "win2016r1": {
            "dataCenterLicenseKey": "AAAAA-BBBBB-CCCCC-DDDDD-EEEEE",
            "standardLicenseKey": "AAAAA-BBBBB-CCCCC-DDDDD-EEEEE"
         },
         "win2012r2": {
            "dataCenterLicenseKey": "AAAAA-BBBBB-CCCCC-DDDDD-EEEEE",
            "standardLicenseKey": "AAAAA-BBBBB-CCCCC-DDDDD-EEEEE"
         }
         "win2012r1": {
            "dataCenterLicenseKey": "AAAAA-BBBBB-CCCCC-DDDDD-EEEEE",
            "standardLicenseKey": "AAAAA-BBBBB-CCCCC-DDDDD-EEEEE"
         }
      }
   },
   "result": "success",
   "messages": []
}

When the request is not successful (such as a response code of 500), a message body similar to the following is returned:

{
    "result": "failed", 
    "messages": [{
        "explanation": "", 
        "id": "FQXHMFC0062M", 
        "recovery": {
            "URL": "", 
            "text": "Attempt to perform the operation again. If the problem persists, contact 
                     Support."
        },
        "text": "Could not get the default credentials to be used during operating system 
                 deployment."
    }]
}