Interface AWSDirectoryService

    • Method Detail

      • setEndpoint

        void setEndpoint​(String endpoint)
        Overrides the default endpoint for this client ("https://ds.us-east-1.amazonaws.com"). Callers can use this method to control which AWS region they want to work with.

        Callers can pass in just the endpoint (ex: "ds.us-east-1.amazonaws.com") or a full URL, including the protocol (ex: "https://ds.us-east-1.amazonaws.com"). If the protocol is not specified here, the default protocol from this client's ClientConfiguration will be used, which by default is HTTPS.

        For more information on using AWS regions with the AWS SDK for Java, and a complete list of all available endpoints for all AWS services, see: http://developer.amazonwebservices.com/connect/entry.jspa?externalID= 3912

        This method is not threadsafe. An endpoint should be configured when the client is created and before any service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit or retrying.

        Parameters:
        endpoint - The endpoint (ex: "ds.us-east-1.amazonaws.com") or a full URL, including the protocol (ex: "https://ds.us-east-1.amazonaws.com") of the region specific AWS endpoint this client will communicate with.
      • createAlias

        CreateAliasResult 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.

        Parameters:
        createAliasRequest - Contains the inputs for the CreateAlias operation.
        Returns:
        Result of the CreateAlias operation returned by the service.
        Throws:
        EntityAlreadyExistsException - The specified entity already exists.
        EntityDoesNotExistException - The specified entity could not be found.
        InvalidParameterException - One or more parameters are not valid.
        ClientException - A client exception has occurred.
        ServiceException - An exception has occurred in AWS Directory Service.
      • createConditionalForwarder

        CreateConditionalForwarderResult 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.

        Parameters:
        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.
        Returns:
        Result of the CreateConditionalForwarder operation returned by the service.
        Throws:
        EntityAlreadyExistsException - The specified entity already exists.
        EntityDoesNotExistException - The specified entity could not be found.
        DirectoryUnavailableException - The specified directory is unavailable or could not be found.
        InvalidParameterException - One or more parameters are not valid.
        UnsupportedOperationException - The operation is not supported.
        ClientException - A client exception has occurred.
        ServiceException - An exception has occurred in AWS Directory Service.
      • createMicrosoftAD

        CreateMicrosoftADResult createMicrosoftAD​(CreateMicrosoftADRequest createMicrosoftADRequest)
        Creates a Microsoft AD in the AWS cloud.
        Parameters:
        createMicrosoftADRequest - Creates a Microsoft AD in the AWS cloud.
        Returns:
        Result of the CreateMicrosoftAD operation returned by the service.
        Throws:
        DirectoryLimitExceededException - The maximum number of directories in the region has been reached. You can use the GetDirectoryLimits operation to determine your directory limits in the region.
        InvalidParameterException - One or more parameters are not valid.
        ClientException - A client exception has occurred.
        ServiceException - An exception has occurred in AWS Directory Service.
        UnsupportedOperationException - The operation is not supported.
      • createTrust

        CreateTrustResult 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.

        Parameters:
        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.

        Returns:
        Result of the CreateTrust operation returned by the service.
        Throws:
        EntityAlreadyExistsException - The specified entity already exists.
        EntityDoesNotExistException - The specified entity could not be found.
        InvalidParameterException - One or more parameters are not valid.
        ClientException - A client exception has occurred.
        ServiceException - An exception has occurred in AWS Directory Service.
        UnsupportedOperationException - The operation is not supported.
      • deleteTrust

        DeleteTrustResult deleteTrust​(DeleteTrustRequest deleteTrustRequest)
        Deletes an existing trust relationship between your Microsoft AD in the AWS cloud and an external domain.
        Parameters:
        deleteTrustRequest - Deletes the local side of an existing trust relationship between the Microsoft AD in the AWS cloud and the external domain.
        Returns:
        Result of the DeleteTrust operation returned by the service.
        Throws:
        EntityDoesNotExistException - The specified entity could not be found.
        InvalidParameterException - One or more parameters are not valid.
        ClientException - A client exception has occurred.
        ServiceException - An exception has occurred in AWS Directory Service.
        UnsupportedOperationException - The operation is not supported.
      • describeConditionalForwarders

        DescribeConditionalForwardersResult 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.

        Parameters:
        describeConditionalForwardersRequest -
        Returns:
        Result of the DescribeConditionalForwarders operation returned by the service.
        Throws:
        EntityDoesNotExistException - The specified entity could not be found.
        DirectoryUnavailableException - The specified directory is unavailable or could not be found.
        InvalidParameterException - One or more parameters are not valid.
        UnsupportedOperationException - The operation is not supported.
        ClientException - A client exception has occurred.
        ServiceException - An exception has occurred in AWS Directory Service.
      • describeDirectories

        DescribeDirectoriesResult 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.

        Parameters:
        describeDirectoriesRequest - Contains the inputs for the DescribeDirectories operation.
        Returns:
        Result of the DescribeDirectories operation returned by the service.
        Throws:
        EntityDoesNotExistException - The specified entity could not be found.
        InvalidParameterException - One or more parameters are not valid.
        InvalidNextTokenException - The NextToken value is not valid.
        ClientException - A client exception has occurred.
        ServiceException - An exception has occurred in AWS Directory Service.
      • describeEventTopics

        DescribeEventTopicsResult 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.

        Parameters:
        describeEventTopicsRequest -
        Returns:
        Result of the DescribeEventTopics operation returned by the service.
        Throws:
        EntityDoesNotExistException - The specified entity could not be found.
        InvalidParameterException - One or more parameters are not valid.
        ClientException - A client exception has occurred.
        ServiceException - An exception has occurred in AWS Directory Service.
      • describeSnapshots

        DescribeSnapshotsResult 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.

        Parameters:
        describeSnapshotsRequest - Contains the inputs for the DescribeSnapshots operation.
        Returns:
        Result of the DescribeSnapshots operation returned by the service.
        Throws:
        EntityDoesNotExistException - The specified entity could not be found.
        InvalidParameterException - One or more parameters are not valid.
        InvalidNextTokenException - The NextToken value is not valid.
        ClientException - A client exception has occurred.
        ServiceException - An exception has occurred in AWS Directory Service.
      • describeTrusts

        DescribeTrustsResult 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.

        Parameters:
        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.
        Returns:
        Result of the DescribeTrusts operation returned by the service.
        Throws:
        EntityDoesNotExistException - The specified entity could not be found.
        InvalidNextTokenException - The NextToken value is not valid.
        InvalidParameterException - One or more parameters are not valid.
        ClientException - A client exception has occurred.
        ServiceException - An exception has occurred in AWS Directory Service.
        UnsupportedOperationException - The operation is not supported.
      • disableRadius

        DisableRadiusResult disableRadius​(DisableRadiusRequest disableRadiusRequest)

        Disables multi-factor authentication (MFA) with the Remote Authentication Dial In User Service (RADIUS) server for an AD Connector directory.

        Parameters:
        disableRadiusRequest - Contains the inputs for the DisableRadius operation.
        Returns:
        Result of the DisableRadius operation returned by the service.
        Throws:
        EntityDoesNotExistException - The specified entity could not be found.
        ClientException - A client exception has occurred.
        ServiceException - An exception has occurred in AWS Directory Service.
      • registerEventTopic

        RegisterEventTopicResult 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.

        Parameters:
        registerEventTopicRequest -
        Returns:
        Result of the RegisterEventTopic operation returned by the service.
        Throws:
        EntityDoesNotExistException - The specified entity could not be found.
        InvalidParameterException - One or more parameters are not valid.
        ClientException - A client exception has occurred.
        ServiceException - An exception has occurred in AWS Directory Service.
      • restoreFromSnapshot

        RestoreFromSnapshotResult 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.

        Parameters:
        restoreFromSnapshotRequest - An object representing the inputs for the RestoreFromSnapshot operation.
        Returns:
        Result of the RestoreFromSnapshot operation returned by the service.
        Throws:
        EntityDoesNotExistException - The specified entity could not be found.
        InvalidParameterException - One or more parameters are not valid.
        ClientException - A client exception has occurred.
        ServiceException - An exception has occurred in AWS Directory Service.
      • verifyTrust

        VerifyTrustResult 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.

        Parameters:
        verifyTrustRequest - Initiates the verification of an existing trust relationship between a Microsoft AD in the AWS cloud and an external domain.
        Returns:
        Result of the VerifyTrust operation returned by the service.
        Throws:
        EntityDoesNotExistException - The specified entity could not be found.
        InvalidParameterException - One or more parameters are not valid.
        ClientException - A client exception has occurred.
        ServiceException - An exception has occurred in AWS Directory Service.
        UnsupportedOperationException - The operation is not supported.
      • shutdown

        void shutdown()
        Shuts down this client object, releasing any resources that might be held open. This is an optional method, and callers are not expected to call it, but can if they want to explicitly release any open resources. Once a client has been shutdown, it should not be used to make any more requests.
      • getCachedResponseMetadata

        ResponseMetadata getCachedResponseMetadata​(AmazonWebServiceRequest request)
        Returns additional metadata for a previously executed successful request, typically used for debugging issues where a service isn't acting as expected. This data isn't considered part of the result data returned by an operation, so it's available through this separate, diagnostic interface.

        Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.

        Parameters:
        request - The originally executed request.
        Returns:
        The response metadata for the specified request, or null if none is available.