|Parameter Name||Required||Service Affecting||Data Type||Default Value||Possible Values||Description|
|Description||Yes||No||string||none||64 - Max Length||The description of the Domain Controller that will be referenced by the Active Directory Configuration resource.|
|LDAPQuery||Yes||No||string||none||256 - Max Length||Applies a filter to the Search Scope (defined in the Active Directory Configuration resource) to limit the number of active directory users included in the cache.|
|SearchScope||Yes||No||string||none||256 - Max Length||Specifies the tree location in Active Directory to use at the starting point for search queries or authentication requests.|
|LdapTimeout||No||No||int||5||Possible values: ||Controls the timeout value used when querying the domain controller. If there is no response before this timeout value has passed then the attempt will be aborted for that session. Note: this should only be changed from the default of 5 seconds if it has been determined to not be enough.|
|DomainController||Yes||No||string||none||256 - Max Length||Specifies an IP address or Fully Qualified Domain Name (FQDN) of the Domain Controller.|
|PreferredIpVersion||Yes||No||Enum||0||Possible values: ||Specifies whether the FQDN should be resolved into IPv4 addresses or IPv6 addresses.|
|UserName||Yes||No||string||none||256 - Max Length||Specifies username (BindDN) to use for querying the Active Directory.|
|EncryptedPassword||Yes||No||string||none||256 - Max Length||Specifies password (BindPW) to use for querying the Active Directory.|
|DCPriority||Yes||Yes||int||0||Possible values: ||Sets the priority of the DC which determines in what order AD will be queried.
This has no affect when using the AD cache.
Each DC type (Auth and call routing) have their own set of priorities.
Priority of 0 indicates not configured. Set a valid priority.
|DCType||Yes||No||Enum||0||Possible values: ||Determines whether this DC will be used for user authentication, call routing or On Premise lookup.|
|DCRole||Yes||No||Enum||0||Possible values: ||Indicates if this DC is intended to be a backup of another DC. If this value is set to Backup then this DC will not be queried while refreshing the AD cache or for call route lookups unless the primary DC is down. Applies to Call Route DC's only.|
|PrimaryDCRow||Yes||No||int||0||Possible values: ||This option only visible if DCRole is set to Backup. Must be a valid row number of another DC which this DC is intended to be a backup to. This value automatically set to 0 if DCRole is set to Primary. Applies to Call Route DC's only.|
The POST can contain either only the attributes that are being updated, or the full set of attributes for the resource