AutoCloseable
@Generated("software.amazon.awssdk:codegen") public interface DirectoryAsyncClient extends AutoCloseable
builder()
method.
AWS Directory Service is a web service that makes it easy for you to setup and run directories in the AWS cloud, or connect your AWS resources with an existing on-premises Microsoft Active Directory. This guide provides detailed information about AWS Directory Service operations, data types, parameters, and errors. For information about AWS Directory Services features, see AWS Directory Service and the AWS Directory Service Administration Guide.
AWS provides SDKs that consist of libraries and sample code for various programming languages and platforms (Java, Ruby, .Net, iOS, Android, etc.). The SDKs provide a convenient way to create programmatic access to AWS Directory Service and other AWS services. For more information about the AWS SDKs, including how to download and install them, see Tools for Amazon Web Services.
Modifier and Type | Method | Description |
---|---|---|
default CompletableFuture<AddIpRoutesResponse> |
addIpRoutes(AddIpRoutesRequest addIpRoutesRequest) |
If the DNS server for your on-premises domain uses a publicly addressable IP address, you must add a CIDR address
block to correctly route traffic to and from your Microsoft AD on Amazon Web Services.
|
default CompletableFuture<AddTagsToResourceResponse> |
addTagsToResource(AddTagsToResourceRequest addTagsToResourceRequest) |
Adds or overwrites one or more tags for the specified directory.
|
static DirectoryAsyncClientBuilder |
builder() |
Create a builder that can be used to configure and create a
DirectoryAsyncClient . |
default CompletableFuture<CancelSchemaExtensionResponse> |
cancelSchemaExtension(CancelSchemaExtensionRequest cancelSchemaExtensionRequest) |
Cancels an in-progress schema extension to a Microsoft AD directory.
|
default CompletableFuture<ConnectDirectoryResponse> |
connectDirectory(ConnectDirectoryRequest connectDirectoryRequest) |
Creates an AD Connector to connect to an on-premises directory.
|
static DirectoryAsyncClient |
create() |
Create a
DirectoryAsyncClient with the region loaded from the
DefaultAwsRegionProviderChain and credentials loaded from the
DefaultCredentialsProvider . |
default CompletableFuture<CreateAliasResponse> |
createAlias(CreateAliasRequest createAliasRequest) |
Creates an alias for a directory and assigns the alias to the directory.
|
default CompletableFuture<CreateComputerResponse> |
createComputer(CreateComputerRequest createComputerRequest) |
Creates a computer account in the specified directory, and joins the computer to the directory.
|
default CompletableFuture<CreateConditionalForwarderResponse> |
createConditionalForwarder(CreateConditionalForwarderRequest createConditionalForwarderRequest) |
Creates a conditional forwarder associated with your AWS directory.
|
default CompletableFuture<CreateDirectoryResponse> |
createDirectory(CreateDirectoryRequest createDirectoryRequest) |
Creates a Simple AD directory.
|
default CompletableFuture<CreateMicrosoftADResponse> |
createMicrosoftAD(CreateMicrosoftADRequest createMicrosoftADRequest) |
Creates a Microsoft AD in the AWS cloud.
|
default CompletableFuture<CreateSnapshotResponse> |
createSnapshot(CreateSnapshotRequest createSnapshotRequest) |
Creates a snapshot of a Simple AD or Microsoft AD directory in the AWS cloud.
|
default CompletableFuture<CreateTrustResponse> |
createTrust(CreateTrustRequest createTrustRequest) |
AWS Directory Service for Microsoft Active Directory allows you to configure trust relationships.
|
default CompletableFuture<DeleteConditionalForwarderResponse> |
deleteConditionalForwarder(DeleteConditionalForwarderRequest deleteConditionalForwarderRequest) |
Deletes a conditional forwarder that has been set up for your AWS directory.
|
default CompletableFuture<DeleteDirectoryResponse> |
deleteDirectory(DeleteDirectoryRequest deleteDirectoryRequest) |
Deletes an AWS Directory Service directory.
|
default CompletableFuture<DeleteSnapshotResponse> |
deleteSnapshot(DeleteSnapshotRequest deleteSnapshotRequest) |
Deletes a directory snapshot.
|
default CompletableFuture<DeleteTrustResponse> |
deleteTrust(DeleteTrustRequest deleteTrustRequest) |
Deletes an existing trust relationship between your Microsoft AD in the AWS cloud and an external domain.
|
default CompletableFuture<DeregisterEventTopicResponse> |
deregisterEventTopic(DeregisterEventTopicRequest deregisterEventTopicRequest) |
Removes the specified directory as a publisher to the specified SNS topic.
|
default CompletableFuture<DescribeConditionalForwardersResponse> |
describeConditionalForwarders(DescribeConditionalForwardersRequest describeConditionalForwardersRequest) |
Obtains information about the conditional forwarders for this account.
|
default CompletableFuture<DescribeDirectoriesResponse> |
describeDirectories(DescribeDirectoriesRequest describeDirectoriesRequest) |
Obtains information about the directories that belong to this account.
|
default CompletableFuture<DescribeEventTopicsResponse> |
describeEventTopics(DescribeEventTopicsRequest describeEventTopicsRequest) |
Obtains information about which SNS topics receive status messages from the specified directory.
|
default CompletableFuture<DescribeSnapshotsResponse> |
describeSnapshots(DescribeSnapshotsRequest describeSnapshotsRequest) |
Obtains information about the directory snapshots that belong to this account.
|
default CompletableFuture<DescribeTrustsResponse> |
describeTrusts(DescribeTrustsRequest describeTrustsRequest) |
Obtains information about the trust relationships for this account.
|
default CompletableFuture<DisableRadiusResponse> |
disableRadius(DisableRadiusRequest disableRadiusRequest) |
Disables multi-factor authentication (MFA) with the Remote Authentication Dial In User Service (RADIUS) server
for an AD Connector directory.
|
default CompletableFuture<DisableSsoResponse> |
disableSso(DisableSsoRequest disableSsoRequest) |
Disables single-sign on for a directory.
|
default CompletableFuture<EnableRadiusResponse> |
enableRadius(EnableRadiusRequest enableRadiusRequest) |
Enables multi-factor authentication (MFA) with the Remote Authentication Dial In User Service (RADIUS) server for
an AD Connector directory.
|
default CompletableFuture<EnableSsoResponse> |
enableSso(EnableSsoRequest enableSsoRequest) |
Enables single sign-on for a directory.
|
default CompletableFuture<GetDirectoryLimitsResponse> |
getDirectoryLimits(GetDirectoryLimitsRequest getDirectoryLimitsRequest) |
Obtains directory limit information for the current region.
|
default CompletableFuture<GetSnapshotLimitsResponse> |
getSnapshotLimits(GetSnapshotLimitsRequest getSnapshotLimitsRequest) |
Obtains the manual snapshot limits for a directory.
|
default CompletableFuture<ListIpRoutesResponse> |
listIpRoutes(ListIpRoutesRequest listIpRoutesRequest) |
Lists the address blocks that you have added to a directory.
|
default CompletableFuture<ListSchemaExtensionsResponse> |
listSchemaExtensions(ListSchemaExtensionsRequest listSchemaExtensionsRequest) |
Lists all schema extensions applied to a Microsoft AD Directory.
|
default CompletableFuture<ListTagsForResourceResponse> |
listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) |
Lists all tags on a directory.
|
default CompletableFuture<RegisterEventTopicResponse> |
registerEventTopic(RegisterEventTopicRequest registerEventTopicRequest) |
Associates a directory with an SNS topic.
|
default CompletableFuture<RemoveIpRoutesResponse> |
removeIpRoutes(RemoveIpRoutesRequest removeIpRoutesRequest) |
Removes IP address blocks from a directory.
|
default CompletableFuture<RemoveTagsFromResourceResponse> |
removeTagsFromResource(RemoveTagsFromResourceRequest removeTagsFromResourceRequest) |
Removes tags from a directory.
|
default CompletableFuture<RestoreFromSnapshotResponse> |
restoreFromSnapshot(RestoreFromSnapshotRequest restoreFromSnapshotRequest) |
Restores a directory using an existing directory snapshot.
|
default CompletableFuture<StartSchemaExtensionResponse> |
startSchemaExtension(StartSchemaExtensionRequest startSchemaExtensionRequest) |
Applies a schema extension to a Microsoft AD directory.
|
default CompletableFuture<UpdateConditionalForwarderResponse> |
updateConditionalForwarder(UpdateConditionalForwarderRequest updateConditionalForwarderRequest) |
Updates a conditional forwarder that has been set up for your AWS directory.
|
default CompletableFuture<UpdateRadiusResponse> |
updateRadius(UpdateRadiusRequest updateRadiusRequest) |
Updates the Remote Authentication Dial In User Service (RADIUS) server information for an AD Connector directory.
|
default CompletableFuture<VerifyTrustResponse> |
verifyTrust(VerifyTrustRequest verifyTrustRequest) |
AWS Directory Service for Microsoft Active Directory allows you to configure and verify trust relationships.
|
close
static DirectoryAsyncClient create()
DirectoryAsyncClient
with the region loaded from the
DefaultAwsRegionProviderChain
and credentials loaded from the
DefaultCredentialsProvider
.static DirectoryAsyncClientBuilder builder()
DirectoryAsyncClient
.default CompletableFuture<AddIpRoutesResponse> addIpRoutes(AddIpRoutesRequest addIpRoutesRequest)
If the DNS server for your on-premises domain uses a publicly addressable IP address, you must add a CIDR address block to correctly route traffic to and from your Microsoft AD on Amazon Web Services. AddIpRoutes adds this address block. You can also use AddIpRoutes to facilitate routing traffic that uses public IP ranges from your Microsoft AD on AWS to a peer VPC.
Before you call AddIpRoutes, ensure that all of the required permissions have been explicitly granted through a policy. For details about what permissions are required to run the AddIpRoutes operation, see AWS Directory Service API Permissions: Actions, Resources, and Conditions Reference.
addIpRoutesRequest
- default CompletableFuture<AddTagsToResourceResponse> addTagsToResource(AddTagsToResourceRequest addTagsToResourceRequest)
Adds or overwrites one or more tags for the specified directory. Each directory can have a maximum of 50 tags. Each tag consists of a key and optional value. Tag keys must be unique to each resource.
addTagsToResourceRequest
- default CompletableFuture<CancelSchemaExtensionResponse> cancelSchemaExtension(CancelSchemaExtensionRequest cancelSchemaExtensionRequest)
Cancels an in-progress schema extension to a Microsoft AD directory. Once a schema extension has started
replicating to all domain controllers, the task can no longer be canceled. A schema extension can be canceled
during any of the following states; Initializing
, CreatingSnapshot
, and
UpdatingSchema
.
cancelSchemaExtensionRequest
- default CompletableFuture<ConnectDirectoryResponse> connectDirectory(ConnectDirectoryRequest connectDirectoryRequest)
Creates an AD Connector to connect to an on-premises 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 AWS Directory Service API Permissions: Actions, Resources, and Conditions Reference.
connectDirectoryRequest
- Contains the inputs for the ConnectDirectory operation.default CompletableFuture<CreateAliasResponse> createAlias(CreateAliasRequest createAliasRequest)
Creates an alias for a directory and assigns the alias to the directory. The alias is used to construct the
access URL for the directory, such as http://<alias>.awsapps.com
.
After an alias has been created, it cannot be deleted or reused, so this operation should only be used when absolutely necessary.
createAliasRequest
- Contains the inputs for the CreateAlias operation.default CompletableFuture<CreateComputerResponse> createComputer(CreateComputerRequest createComputerRequest)
Creates a computer account in the specified directory, and joins the computer to the directory.
createComputerRequest
- Contains the inputs for the CreateComputer operation.default CompletableFuture<CreateConditionalForwarderResponse> createConditionalForwarder(CreateConditionalForwarderRequest createConditionalForwarderRequest)
Creates a conditional forwarder associated with your AWS directory. Conditional forwarders are required in order to set up a trust relationship with another domain. The conditional forwarder points to the trusted domain.
createConditionalForwarderRequest
- Initiates the creation of a conditional forwarder for your AWS Directory Service for Microsoft Active
Directory. Conditional forwarders are required in order to set up a trust relationship with another
domain.default CompletableFuture<CreateDirectoryResponse> createDirectory(CreateDirectoryRequest createDirectoryRequest)
Creates a Simple AD directory.
Before you call CreateDirectory, ensure that all of the required permissions have been explicitly granted through a policy. For details about what permissions are required to run the CreateDirectory operation, see AWS Directory Service API Permissions: Actions, Resources, and Conditions Reference.
createDirectoryRequest
- Contains the inputs for the CreateDirectory operation.default CompletableFuture<CreateMicrosoftADResponse> createMicrosoftAD(CreateMicrosoftADRequest createMicrosoftADRequest)
Creates a Microsoft AD in the AWS cloud.
Before you call CreateMicrosoftAD, ensure that all of the required permissions have been explicitly granted through a policy. For details about what permissions are required to run the CreateMicrosoftAD operation, see AWS Directory Service API Permissions: Actions, Resources, and Conditions Reference.
createMicrosoftADRequest
- Creates a Microsoft AD in the AWS cloud.default CompletableFuture<CreateSnapshotResponse> createSnapshot(CreateSnapshotRequest createSnapshotRequest)
Creates a snapshot of a Simple AD or Microsoft AD directory in the AWS cloud.
You cannot take snapshots of AD Connector directories.
createSnapshotRequest
- Contains the inputs for the CreateSnapshot operation.default CompletableFuture<CreateTrustResponse> createTrust(CreateTrustRequest createTrustRequest)
AWS Directory Service for Microsoft Active Directory allows you to configure trust relationships. For example, you can establish a trust between your Microsoft AD in the AWS cloud, and your existing on-premises Microsoft Active Directory. This would allow you to provide users and groups access to resources in either domain, with a single set of credentials.
This action initiates the creation of the AWS side of a trust relationship between a Microsoft AD in the AWS cloud and an external domain.
createTrustRequest
- AWS Directory Service for Microsoft Active Directory allows you to configure trust relationships. For
example, you can establish a trust between your Microsoft AD in the AWS cloud, and your existing
on-premises Microsoft Active Directory. This would allow you to provide users and groups access to
resources in either domain, with a single set of credentials.
This action initiates the creation of the AWS side of a trust relationship between a Microsoft AD in the AWS cloud and an external domain.
default CompletableFuture<DeleteConditionalForwarderResponse> deleteConditionalForwarder(DeleteConditionalForwarderRequest deleteConditionalForwarderRequest)
Deletes a conditional forwarder that has been set up for your AWS directory.
deleteConditionalForwarderRequest
- Deletes a conditional forwarder.default CompletableFuture<DeleteDirectoryResponse> deleteDirectory(DeleteDirectoryRequest deleteDirectoryRequest)
Deletes an AWS Directory Service directory.
Before you call DeleteDirectory, ensure that all of the required permissions have been explicitly granted through a policy. For details about what permissions are required to run the DeleteDirectory operation, see AWS Directory Service API Permissions: Actions, Resources, and Conditions Reference.
deleteDirectoryRequest
- Contains the inputs for the DeleteDirectory operation.default CompletableFuture<DeleteSnapshotResponse> deleteSnapshot(DeleteSnapshotRequest deleteSnapshotRequest)
Deletes a directory snapshot.
deleteSnapshotRequest
- Contains the inputs for the DeleteSnapshot operation.default CompletableFuture<DeleteTrustResponse> deleteTrust(DeleteTrustRequest deleteTrustRequest)
Deletes an existing trust relationship between your Microsoft AD in the AWS cloud and an external domain.
deleteTrustRequest
- Deletes the local side of an existing trust relationship between the Microsoft AD in the AWS cloud and the
external domain.default CompletableFuture<DeregisterEventTopicResponse> deregisterEventTopic(DeregisterEventTopicRequest deregisterEventTopicRequest)
Removes the specified directory as a publisher to the specified SNS topic.
deregisterEventTopicRequest
- Removes the specified directory as a publisher to the specified SNS topic.default CompletableFuture<DescribeConditionalForwardersResponse> describeConditionalForwarders(DescribeConditionalForwardersRequest describeConditionalForwardersRequest)
Obtains information about the conditional forwarders for this account.
If no input parameters are provided for RemoteDomainNames, this request describes all conditional forwarders for the specified directory ID.
describeConditionalForwardersRequest
- Describes a conditional forwarder.default CompletableFuture<DescribeDirectoriesResponse> describeDirectories(DescribeDirectoriesRequest describeDirectoriesRequest)
Obtains information about the directories that belong to this account.
You can retrieve information about specific directories by passing the directory identifiers in the DirectoryIds parameter. Otherwise, all directories that belong to the current account are returned.
This operation supports pagination with the use of the NextToken request and response parameters. If more results are available, the DescribeDirectoriesResult.NextToken member contains a token that you pass in the next call to DescribeDirectories to retrieve the next set of items.
You can also specify a maximum number of return results with the Limit parameter.
describeDirectoriesRequest
- Contains the inputs for the DescribeDirectories operation.default CompletableFuture<DescribeEventTopicsResponse> describeEventTopics(DescribeEventTopicsRequest describeEventTopicsRequest)
Obtains information about which SNS topics receive status messages from the specified directory.
If no input parameters are provided, such as DirectoryId or TopicName, this request describes all of the associations in the account.
describeEventTopicsRequest
- Describes event topics.default CompletableFuture<DescribeSnapshotsResponse> describeSnapshots(DescribeSnapshotsRequest describeSnapshotsRequest)
Obtains information about the directory snapshots that belong to this account.
This operation supports pagination with the use of the NextToken request and response parameters. If more results are available, the DescribeSnapshots.NextToken member contains a token that you pass in the next call to DescribeSnapshots to retrieve the next set of items.
You can also specify a maximum number of return results with the Limit parameter.
describeSnapshotsRequest
- Contains the inputs for the DescribeSnapshots operation.default CompletableFuture<DescribeTrustsResponse> describeTrusts(DescribeTrustsRequest describeTrustsRequest)
Obtains information about the trust relationships for this account.
If no input parameters are provided, such as DirectoryId or TrustIds, this request describes all the trust relationships belonging to the account.
describeTrustsRequest
- Describes the trust relationships for a particular Microsoft AD in the AWS cloud. If no input parameters
are are provided, such as directory ID or trust ID, this request describes all the trust relationships.default CompletableFuture<DisableRadiusResponse> disableRadius(DisableRadiusRequest disableRadiusRequest)
Disables multi-factor authentication (MFA) with the Remote Authentication Dial In User Service (RADIUS) server for an AD Connector directory.
disableRadiusRequest
- Contains the inputs for the DisableRadius operation.default CompletableFuture<DisableSsoResponse> disableSso(DisableSsoRequest disableSsoRequest)
Disables single-sign on for a directory.
disableSsoRequest
- Contains the inputs for the DisableSso operation.default CompletableFuture<EnableRadiusResponse> enableRadius(EnableRadiusRequest enableRadiusRequest)
Enables multi-factor authentication (MFA) with the Remote Authentication Dial In User Service (RADIUS) server for an AD Connector directory.
enableRadiusRequest
- Contains the inputs for the EnableRadius operation.default CompletableFuture<EnableSsoResponse> enableSso(EnableSsoRequest enableSsoRequest)
Enables single sign-on for a directory.
enableSsoRequest
- Contains the inputs for the EnableSso operation.default CompletableFuture<GetDirectoryLimitsResponse> getDirectoryLimits(GetDirectoryLimitsRequest getDirectoryLimitsRequest)
Obtains directory limit information for the current region.
getDirectoryLimitsRequest
- Contains the inputs for the GetDirectoryLimits operation.default CompletableFuture<GetSnapshotLimitsResponse> getSnapshotLimits(GetSnapshotLimitsRequest getSnapshotLimitsRequest)
Obtains the manual snapshot limits for a directory.
getSnapshotLimitsRequest
- Contains the inputs for the GetSnapshotLimits operation.default CompletableFuture<ListIpRoutesResponse> listIpRoutes(ListIpRoutesRequest listIpRoutesRequest)
Lists the address blocks that you have added to a directory.
listIpRoutesRequest
- default CompletableFuture<ListSchemaExtensionsResponse> listSchemaExtensions(ListSchemaExtensionsRequest listSchemaExtensionsRequest)
Lists all schema extensions applied to a Microsoft AD Directory.
listSchemaExtensionsRequest
- default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
Lists all tags on a directory.
listTagsForResourceRequest
- default CompletableFuture<RegisterEventTopicResponse> registerEventTopic(RegisterEventTopicRequest registerEventTopicRequest)
Associates a directory with an SNS topic. This establishes the directory as a publisher to the specified SNS topic. You can then receive email or text (SMS) messages when the status of your directory changes. You get notified if your directory goes from an Active status to an Impaired or Inoperable status. You also receive a notification when the directory returns to an Active status.
registerEventTopicRequest
- Registers a new event topic.default CompletableFuture<RemoveIpRoutesResponse> removeIpRoutes(RemoveIpRoutesRequest removeIpRoutesRequest)
Removes IP address blocks from a directory.
removeIpRoutesRequest
- default CompletableFuture<RemoveTagsFromResourceResponse> removeTagsFromResource(RemoveTagsFromResourceRequest removeTagsFromResourceRequest)
Removes tags from a directory.
removeTagsFromResourceRequest
- default CompletableFuture<RestoreFromSnapshotResponse> restoreFromSnapshot(RestoreFromSnapshotRequest restoreFromSnapshotRequest)
Restores a directory using an existing directory snapshot.
When you restore a directory from a snapshot, any changes made to the directory after the snapshot date are overwritten.
This action returns as soon as the restore operation is initiated. You can monitor the progress of the restore
operation by calling the DescribeDirectories operation with the directory identifier. When the
DirectoryDescription.Stage value changes to Active
, the restore operation is complete.
restoreFromSnapshotRequest
- An object representing the inputs for the RestoreFromSnapshot operation.default CompletableFuture<StartSchemaExtensionResponse> startSchemaExtension(StartSchemaExtensionRequest startSchemaExtensionRequest)
Applies a schema extension to a Microsoft AD directory.
startSchemaExtensionRequest
- default CompletableFuture<UpdateConditionalForwarderResponse> updateConditionalForwarder(UpdateConditionalForwarderRequest updateConditionalForwarderRequest)
Updates a conditional forwarder that has been set up for your AWS directory.
updateConditionalForwarderRequest
- Updates a conditional forwarder.default CompletableFuture<UpdateRadiusResponse> updateRadius(UpdateRadiusRequest updateRadiusRequest)
Updates the Remote Authentication Dial In User Service (RADIUS) server information for an AD Connector directory.
updateRadiusRequest
- Contains the inputs for the UpdateRadius operation.default CompletableFuture<VerifyTrustResponse> verifyTrust(VerifyTrustRequest verifyTrustRequest)
AWS Directory Service for Microsoft Active Directory allows you to configure and verify trust relationships.
This action verifies a trust relationship between your Microsoft AD in the AWS cloud and an external domain.
verifyTrustRequest
- Initiates the verification of an existing trust relationship between a Microsoft AD in the AWS cloud and
an external domain.Copyright © 2017 Amazon Web Services, Inc. All Rights Reserved.