Bind

Bind

All the listed privileges are required -

Privileges Description
GLOBAL_CONFIG_MANAGEMENT Caller should have permission to this privilege, to perform this operation.
Request
URI
POST
https://{api_host}/rest/external/v1/ad-domains/action/bind
COPY
Request Body
ADDomainSpec of type(s) application/json
Required
{
    "ad_domain_advanced_settings": {
        "ad_domain_auto_discovery": true,
        "ad_domain_context": "dc=abc,dc=com",
        "ad_domain_controllers": [
            "example.com",
            "example1.com"
        ],
        "ad_domain_preferred_site": "Bengaluru",
        "port": 389
    },
    "dns_name": "example.com",
    "netbios_name": "EXAMPLE",
    "primary_account": {
        "password": [
            "<password>"
        ],
        "username": "Administrator"
    }
}
ad_domain_advanced_settings
Required

ad_domain_advanced_settings

string As ^((?!-)[A-Za-z0-9-]{1,63}(?<!-)\.)+[A-Za-z0-9]{2,63}$
dns_name
Required

The DNS name of the domain.

string
netbios_name
Required

The NetBIOS name of the domain.

primary_account
Required

primary_account

Authentication
This operation uses the following authentication methods.
Responses
201

Created

Returns ADDomainBindInfo of type(s) */*
{
    "id": "S-1-5-21-3861703653-2745738756-3849765893"
}
string
id
Optional

Unique ID representing the AD domain.


400

Bad Request

Operation doesn't return any data structure

401

User is not authenticated

Operation doesn't return any data structure

403

Access to the resource is forbidden

Operation doesn't return any data structure

409

Conflict

Operation doesn't return any data structure