directoryservice/aws.sdk.kotlin.services.directoryservice/DirectoryClient/connectDirectory

connectDirectory

abstract suspend fun connectDirectory(input: ConnectDirectoryRequest): ConnectDirectoryResponse

Creates an AD Connector to connect to a self-managed directory.

Before you call ConnectDirectory, ensure that all of the required permissions have been explicitly granted through a policy. For details about what permissions are required to run the ConnectDirectory operation, see Directory Service API Permissions: Actions, Resources, and Conditions Reference.

Samples

import aws.sdk.kotlin.services.directoryservice.model.DirectoryConnectSettings
import aws.sdk.kotlin.services.directoryservice.model.DirectorySize

fun main() { 
   //sampleStart 
   // The following example creates an AD Connector to connect to an on premises directory.
val resp = directoryClient.connectDirectory {
    name = "corp.example.com"
    shortName = "corp"
    password = "Str0ngP@ssw0rd"
    description = "Connector to corp"
    size = DirectorySize.fromValue("Small")
    connectSettings = DirectoryConnectSettings {
        customerUserName = "Administrator"
        vpcId = "vpc-45025421"
        subnetIds = listOf<String>(
            "subnet-ba0146de",
            "subnet-bef46bc8"
        )
        customerDnsIps = listOf<String>(
            "172.30.21.228"
        )
    }
} 
   //sampleEnd
}