Interface DirectoryServiceDataAsyncClient
-
- All Superinterfaces:
AutoCloseable,AwsClient,SdkAutoCloseable,SdkClient
@Generated("software.amazon.awssdk:codegen") @ThreadSafe public interface DirectoryServiceDataAsyncClient extends AwsClient
Service client for accessing AWS Directory Service Data asynchronously. This can be created using the staticbuilder()method.The asynchronous client performs non-blocking I/O when configured with anySdkAsyncHttpClientsupported in the SDK. However, full non-blocking is not guaranteed as the async client may perform blocking calls in some cases such as credentials retrieval and endpoint discovery as part of the async API call.Amazon Web Services Directory Service Data is an extension of Directory Service. This API reference provides detailed information about Directory Service Data operations and object types.
With Directory Service Data, you can create, read, update, and delete users, groups, and memberships from your Managed Microsoft AD without additional costs and without deploying dedicated management instances. You can also perform built-in object management tasks across directories without direct network connectivity, which simplifies provisioning and access management to achieve fully automated deployments. Directory Service Data supports user and group write operations, such as
CreateUserandCreateGroup, within the organizational unit (OU) of your Managed Microsoft AD. Directory Service Data supports read operations, such asListUsersandListGroups, on all users, groups, and group memberships within your Managed Microsoft AD and across trusted realms. Directory Service Data supports adding and removing group members in your OU and the Amazon Web Services Delegated Groups OU, so you can grant and deny access to specific roles and permissions. For more information, see Manage users and groups in the Directory Service Administration Guide.Directory management operations and configuration changes made against the Directory Service API will also reflect in Directory Service Data API with eventual consistency. You can expect a short delay between management changes, such as adding a new directory trust and calling the Directory Service Data API for the newly created trusted realm.
Directory Service Data connects to your Managed Microsoft AD domain controllers and performs operations on underlying directory objects. When you create your Managed Microsoft AD, you choose subnets for domain controllers that Directory Service creates on your behalf. If a domain controller is unavailable, Directory Service Data uses an available domain controller. As a result, you might notice eventual consistency while objects replicate from one domain controller to another domain controller. For more information, see What gets created in the Directory Service Administration Guide. Directory limits vary by Managed Microsoft AD edition:
-
Standard edition – Supports 8 transactions per second (TPS) for read operations and 4 TPS for write operations per directory. There's a concurrency limit of 10 concurrent requests.
-
Enterprise edition – Supports 16 transactions per second (TPS) for read operations and 8 TPS for write operations per directory. There's a concurrency limit of 10 concurrent requests.
-
Amazon Web Services Account - Supports a total of 100 TPS for Directory Service Data operations across all directories.
Directory Service Data only supports the Managed Microsoft AD directory type and is only available in the primary Amazon Web Services Region. For more information, see Managed Microsoft AD and Primary vs additional Regions in the Directory Service Administration Guide.
-
-
Field Summary
Fields Modifier and Type Field Description static StringSERVICE_METADATA_IDValue for looking up the service's metadata from theServiceMetadataProvider.static StringSERVICE_NAME
-
Method Summary
-
Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable
close
-
Methods inherited from interface software.amazon.awssdk.core.SdkClient
serviceName
-
-
-
-
Field Detail
-
SERVICE_NAME
static final String SERVICE_NAME
- See Also:
- Constant Field Values
-
SERVICE_METADATA_ID
static final String SERVICE_METADATA_ID
Value for looking up the service's metadata from theServiceMetadataProvider.- See Also:
- Constant Field Values
-
-
Method Detail
-
addGroupMember
default CompletableFuture<AddGroupMemberResponse> addGroupMember(AddGroupMemberRequest addGroupMemberRequest)
Adds an existing user, group, or computer as a group member.
- Parameters:
addGroupMemberRequest-- Returns:
- A Java Future containing the result of the AddGroupMember operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ConflictException This error will occur when you try to create a resource that conflicts with an
existing object. It can also occur when adding a member to a group that the member is already in.
This error can be caused by a request sent within the 8-hour idempotency window with the same client token but different input parameters. Client tokens should not be re-used across different requests. After 8 hours, any request with the same client token is treated as a new request.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
addGroupMember
default CompletableFuture<AddGroupMemberResponse> addGroupMember(Consumer<AddGroupMemberRequest.Builder> addGroupMemberRequest)
Adds an existing user, group, or computer as a group member.
This is a convenience which creates an instance of the
AddGroupMemberRequest.Builderavoiding the need to create one manually viaAddGroupMemberRequest.builder()- Parameters:
addGroupMemberRequest- AConsumerthat will call methods onAddGroupMemberRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the AddGroupMember operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ConflictException This error will occur when you try to create a resource that conflicts with an
existing object. It can also occur when adding a member to a group that the member is already in.
This error can be caused by a request sent within the 8-hour idempotency window with the same client token but different input parameters. Client tokens should not be re-used across different requests. After 8 hours, any request with the same client token is treated as a new request.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
createGroup
default CompletableFuture<CreateGroupResponse> createGroup(CreateGroupRequest createGroupRequest)
Creates a new group.
- Parameters:
createGroupRequest-- Returns:
- A Java Future containing the result of the CreateGroup operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ConflictException This error will occur when you try to create a resource that conflicts with an
existing object. It can also occur when adding a member to a group that the member is already in.
This error can be caused by a request sent within the 8-hour idempotency window with the same client token but different input parameters. Client tokens should not be re-used across different requests. After 8 hours, any request with the same client token is treated as a new request.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
- See Also:
- AWS API Documentation
-
createGroup
default CompletableFuture<CreateGroupResponse> createGroup(Consumer<CreateGroupRequest.Builder> createGroupRequest)
Creates a new group.
This is a convenience which creates an instance of the
CreateGroupRequest.Builderavoiding the need to create one manually viaCreateGroupRequest.builder()- Parameters:
createGroupRequest- AConsumerthat will call methods onCreateGroupRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the CreateGroup operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ConflictException This error will occur when you try to create a resource that conflicts with an
existing object. It can also occur when adding a member to a group that the member is already in.
This error can be caused by a request sent within the 8-hour idempotency window with the same client token but different input parameters. Client tokens should not be re-used across different requests. After 8 hours, any request with the same client token is treated as a new request.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
- See Also:
- AWS API Documentation
-
createUser
default CompletableFuture<CreateUserResponse> createUser(CreateUserRequest createUserRequest)
Creates a new user.
- Parameters:
createUserRequest-- Returns:
- A Java Future containing the result of the CreateUser operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ConflictException This error will occur when you try to create a resource that conflicts with an
existing object. It can also occur when adding a member to a group that the member is already in.
This error can be caused by a request sent within the 8-hour idempotency window with the same client token but different input parameters. Client tokens should not be re-used across different requests. After 8 hours, any request with the same client token is treated as a new request.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
- See Also:
- AWS API Documentation
-
createUser
default CompletableFuture<CreateUserResponse> createUser(Consumer<CreateUserRequest.Builder> createUserRequest)
Creates a new user.
This is a convenience which creates an instance of the
CreateUserRequest.Builderavoiding the need to create one manually viaCreateUserRequest.builder()- Parameters:
createUserRequest- AConsumerthat will call methods onCreateUserRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the CreateUser operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ConflictException This error will occur when you try to create a resource that conflicts with an
existing object. It can also occur when adding a member to a group that the member is already in.
This error can be caused by a request sent within the 8-hour idempotency window with the same client token but different input parameters. Client tokens should not be re-used across different requests. After 8 hours, any request with the same client token is treated as a new request.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
- See Also:
- AWS API Documentation
-
deleteGroup
default CompletableFuture<DeleteGroupResponse> deleteGroup(DeleteGroupRequest deleteGroupRequest)
Deletes a group.
- Parameters:
deleteGroupRequest-- Returns:
- A Java Future containing the result of the DeleteGroup operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ConflictException This error will occur when you try to create a resource that conflicts with an
existing object. It can also occur when adding a member to a group that the member is already in.
This error can be caused by a request sent within the 8-hour idempotency window with the same client token but different input parameters. Client tokens should not be re-used across different requests. After 8 hours, any request with the same client token is treated as a new request.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
deleteGroup
default CompletableFuture<DeleteGroupResponse> deleteGroup(Consumer<DeleteGroupRequest.Builder> deleteGroupRequest)
Deletes a group.
This is a convenience which creates an instance of the
DeleteGroupRequest.Builderavoiding the need to create one manually viaDeleteGroupRequest.builder()- Parameters:
deleteGroupRequest- AConsumerthat will call methods onDeleteGroupRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the DeleteGroup operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ConflictException This error will occur when you try to create a resource that conflicts with an
existing object. It can also occur when adding a member to a group that the member is already in.
This error can be caused by a request sent within the 8-hour idempotency window with the same client token but different input parameters. Client tokens should not be re-used across different requests. After 8 hours, any request with the same client token is treated as a new request.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
deleteUser
default CompletableFuture<DeleteUserResponse> deleteUser(DeleteUserRequest deleteUserRequest)
Deletes a user.
- Parameters:
deleteUserRequest-- Returns:
- A Java Future containing the result of the DeleteUser operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ConflictException This error will occur when you try to create a resource that conflicts with an
existing object. It can also occur when adding a member to a group that the member is already in.
This error can be caused by a request sent within the 8-hour idempotency window with the same client token but different input parameters. Client tokens should not be re-used across different requests. After 8 hours, any request with the same client token is treated as a new request.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
deleteUser
default CompletableFuture<DeleteUserResponse> deleteUser(Consumer<DeleteUserRequest.Builder> deleteUserRequest)
Deletes a user.
This is a convenience which creates an instance of the
DeleteUserRequest.Builderavoiding the need to create one manually viaDeleteUserRequest.builder()- Parameters:
deleteUserRequest- AConsumerthat will call methods onDeleteUserRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the DeleteUser operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ConflictException This error will occur when you try to create a resource that conflicts with an
existing object. It can also occur when adding a member to a group that the member is already in.
This error can be caused by a request sent within the 8-hour idempotency window with the same client token but different input parameters. Client tokens should not be re-used across different requests. After 8 hours, any request with the same client token is treated as a new request.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
describeGroup
default CompletableFuture<DescribeGroupResponse> describeGroup(DescribeGroupRequest describeGroupRequest)
Returns information about a specific group.
- Parameters:
describeGroupRequest-- Returns:
- A Java Future containing the result of the DescribeGroup operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
describeGroup
default CompletableFuture<DescribeGroupResponse> describeGroup(Consumer<DescribeGroupRequest.Builder> describeGroupRequest)
Returns information about a specific group.
This is a convenience which creates an instance of the
DescribeGroupRequest.Builderavoiding the need to create one manually viaDescribeGroupRequest.builder()- Parameters:
describeGroupRequest- AConsumerthat will call methods onDescribeGroupRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the DescribeGroup operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
describeUser
default CompletableFuture<DescribeUserResponse> describeUser(DescribeUserRequest describeUserRequest)
Returns information about a specific user.
- Parameters:
describeUserRequest-- Returns:
- A Java Future containing the result of the DescribeUser operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
describeUser
default CompletableFuture<DescribeUserResponse> describeUser(Consumer<DescribeUserRequest.Builder> describeUserRequest)
Returns information about a specific user.
This is a convenience which creates an instance of the
DescribeUserRequest.Builderavoiding the need to create one manually viaDescribeUserRequest.builder()- Parameters:
describeUserRequest- AConsumerthat will call methods onDescribeUserRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the DescribeUser operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
disableUser
default CompletableFuture<DisableUserResponse> disableUser(DisableUserRequest disableUserRequest)
Deactivates an active user account. For information about how to enable an inactive user account, see ResetUserPassword in the Directory Service API Reference.
- Parameters:
disableUserRequest-- Returns:
- A Java Future containing the result of the DisableUser operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ConflictException This error will occur when you try to create a resource that conflicts with an
existing object. It can also occur when adding a member to a group that the member is already in.
This error can be caused by a request sent within the 8-hour idempotency window with the same client token but different input parameters. Client tokens should not be re-used across different requests. After 8 hours, any request with the same client token is treated as a new request.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
disableUser
default CompletableFuture<DisableUserResponse> disableUser(Consumer<DisableUserRequest.Builder> disableUserRequest)
Deactivates an active user account. For information about how to enable an inactive user account, see ResetUserPassword in the Directory Service API Reference.
This is a convenience which creates an instance of the
DisableUserRequest.Builderavoiding the need to create one manually viaDisableUserRequest.builder()- Parameters:
disableUserRequest- AConsumerthat will call methods onDisableUserRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the DisableUser operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ConflictException This error will occur when you try to create a resource that conflicts with an
existing object. It can also occur when adding a member to a group that the member is already in.
This error can be caused by a request sent within the 8-hour idempotency window with the same client token but different input parameters. Client tokens should not be re-used across different requests. After 8 hours, any request with the same client token is treated as a new request.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
listGroupMembers
default CompletableFuture<ListGroupMembersResponse> listGroupMembers(ListGroupMembersRequest listGroupMembersRequest)
Returns member information for the specified group.
This operation supports pagination with the use of the
NextTokenrequest and response parameters. If more results are available, theListGroupMembers.NextTokenmember contains a token that you pass in the next call toListGroupMembers. This retrieves the next set of items.You can also specify a maximum number of return results with the
MaxResultsparameter.- Parameters:
listGroupMembersRequest-- Returns:
- A Java Future containing the result of the ListGroupMembers operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
listGroupMembers
default CompletableFuture<ListGroupMembersResponse> listGroupMembers(Consumer<ListGroupMembersRequest.Builder> listGroupMembersRequest)
Returns member information for the specified group.
This operation supports pagination with the use of the
NextTokenrequest and response parameters. If more results are available, theListGroupMembers.NextTokenmember contains a token that you pass in the next call toListGroupMembers. This retrieves the next set of items.You can also specify a maximum number of return results with the
MaxResultsparameter.
This is a convenience which creates an instance of the
ListGroupMembersRequest.Builderavoiding the need to create one manually viaListGroupMembersRequest.builder()- Parameters:
listGroupMembersRequest- AConsumerthat will call methods onListGroupMembersRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ListGroupMembers operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
listGroupMembersPaginator
default ListGroupMembersPublisher listGroupMembersPaginator(ListGroupMembersRequest listGroupMembersRequest)
This is a variant of
listGroupMembers(software.amazon.awssdk.services.directoryservicedata.model.ListGroupMembersRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.directoryservicedata.paginators.ListGroupMembersPublisher publisher = client.listGroupMembersPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.directoryservicedata.paginators.ListGroupMembersPublisher publisher = client.listGroupMembersPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.directoryservicedata.model.ListGroupMembersResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.directoryservicedata.model.ListGroupMembersResponse response) { //... }; });Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listGroupMembers(software.amazon.awssdk.services.directoryservicedata.model.ListGroupMembersRequest)operation.- Parameters:
listGroupMembersRequest-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
listGroupMembersPaginator
default ListGroupMembersPublisher listGroupMembersPaginator(Consumer<ListGroupMembersRequest.Builder> listGroupMembersRequest)
This is a variant of
listGroupMembers(software.amazon.awssdk.services.directoryservicedata.model.ListGroupMembersRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.directoryservicedata.paginators.ListGroupMembersPublisher publisher = client.listGroupMembersPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.directoryservicedata.paginators.ListGroupMembersPublisher publisher = client.listGroupMembersPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.directoryservicedata.model.ListGroupMembersResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.directoryservicedata.model.ListGroupMembersResponse response) { //... }; });Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listGroupMembers(software.amazon.awssdk.services.directoryservicedata.model.ListGroupMembersRequest)operation.
This is a convenience which creates an instance of the
ListGroupMembersRequest.Builderavoiding the need to create one manually viaListGroupMembersRequest.builder()- Parameters:
listGroupMembersRequest- AConsumerthat will call methods onListGroupMembersRequest.Builderto create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
listGroups
default CompletableFuture<ListGroupsResponse> listGroups(ListGroupsRequest listGroupsRequest)
Returns group information for the specified directory.
This operation supports pagination with the use of the
NextTokenrequest and response parameters. If more results are available, theListGroups.NextTokenmember contains a token that you pass in the next call toListGroups. This retrieves the next set of items.You can also specify a maximum number of return results with the
MaxResultsparameter.- Parameters:
listGroupsRequest-- Returns:
- A Java Future containing the result of the ListGroups operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
- See Also:
- AWS API Documentation
-
listGroups
default CompletableFuture<ListGroupsResponse> listGroups(Consumer<ListGroupsRequest.Builder> listGroupsRequest)
Returns group information for the specified directory.
This operation supports pagination with the use of the
NextTokenrequest and response parameters. If more results are available, theListGroups.NextTokenmember contains a token that you pass in the next call toListGroups. This retrieves the next set of items.You can also specify a maximum number of return results with the
MaxResultsparameter.
This is a convenience which creates an instance of the
ListGroupsRequest.Builderavoiding the need to create one manually viaListGroupsRequest.builder()- Parameters:
listGroupsRequest- AConsumerthat will call methods onListGroupsRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ListGroups operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
- See Also:
- AWS API Documentation
-
listGroupsForMember
default CompletableFuture<ListGroupsForMemberResponse> listGroupsForMember(ListGroupsForMemberRequest listGroupsForMemberRequest)
Returns group information for the specified member.
This operation supports pagination with the use of the
NextTokenrequest and response parameters. If more results are available, theListGroupsForMember.NextTokenmember contains a token that you pass in the next call toListGroupsForMember. This retrieves the next set of items.You can also specify a maximum number of return results with the
MaxResultsparameter.- Parameters:
listGroupsForMemberRequest-- Returns:
- A Java Future containing the result of the ListGroupsForMember operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
listGroupsForMember
default CompletableFuture<ListGroupsForMemberResponse> listGroupsForMember(Consumer<ListGroupsForMemberRequest.Builder> listGroupsForMemberRequest)
Returns group information for the specified member.
This operation supports pagination with the use of the
NextTokenrequest and response parameters. If more results are available, theListGroupsForMember.NextTokenmember contains a token that you pass in the next call toListGroupsForMember. This retrieves the next set of items.You can also specify a maximum number of return results with the
MaxResultsparameter.
This is a convenience which creates an instance of the
ListGroupsForMemberRequest.Builderavoiding the need to create one manually viaListGroupsForMemberRequest.builder()- Parameters:
listGroupsForMemberRequest- AConsumerthat will call methods onListGroupsForMemberRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ListGroupsForMember operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
listGroupsForMemberPaginator
default ListGroupsForMemberPublisher listGroupsForMemberPaginator(ListGroupsForMemberRequest listGroupsForMemberRequest)
This is a variant of
listGroupsForMember(software.amazon.awssdk.services.directoryservicedata.model.ListGroupsForMemberRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.directoryservicedata.paginators.ListGroupsForMemberPublisher publisher = client.listGroupsForMemberPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.directoryservicedata.paginators.ListGroupsForMemberPublisher publisher = client.listGroupsForMemberPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.directoryservicedata.model.ListGroupsForMemberResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.directoryservicedata.model.ListGroupsForMemberResponse response) { //... }; });Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listGroupsForMember(software.amazon.awssdk.services.directoryservicedata.model.ListGroupsForMemberRequest)operation.- Parameters:
listGroupsForMemberRequest-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
listGroupsForMemberPaginator
default ListGroupsForMemberPublisher listGroupsForMemberPaginator(Consumer<ListGroupsForMemberRequest.Builder> listGroupsForMemberRequest)
This is a variant of
listGroupsForMember(software.amazon.awssdk.services.directoryservicedata.model.ListGroupsForMemberRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.directoryservicedata.paginators.ListGroupsForMemberPublisher publisher = client.listGroupsForMemberPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.directoryservicedata.paginators.ListGroupsForMemberPublisher publisher = client.listGroupsForMemberPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.directoryservicedata.model.ListGroupsForMemberResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.directoryservicedata.model.ListGroupsForMemberResponse response) { //... }; });Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listGroupsForMember(software.amazon.awssdk.services.directoryservicedata.model.ListGroupsForMemberRequest)operation.
This is a convenience which creates an instance of the
ListGroupsForMemberRequest.Builderavoiding the need to create one manually viaListGroupsForMemberRequest.builder()- Parameters:
listGroupsForMemberRequest- AConsumerthat will call methods onListGroupsForMemberRequest.Builderto create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
listGroupsPaginator
default ListGroupsPublisher listGroupsPaginator(ListGroupsRequest listGroupsRequest)
This is a variant of
listGroups(software.amazon.awssdk.services.directoryservicedata.model.ListGroupsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.directoryservicedata.paginators.ListGroupsPublisher publisher = client.listGroupsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.directoryservicedata.paginators.ListGroupsPublisher publisher = client.listGroupsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.directoryservicedata.model.ListGroupsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.directoryservicedata.model.ListGroupsResponse response) { //... }; });Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listGroups(software.amazon.awssdk.services.directoryservicedata.model.ListGroupsRequest)operation.- Parameters:
listGroupsRequest-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
- See Also:
- AWS API Documentation
-
listGroupsPaginator
default ListGroupsPublisher listGroupsPaginator(Consumer<ListGroupsRequest.Builder> listGroupsRequest)
This is a variant of
listGroups(software.amazon.awssdk.services.directoryservicedata.model.ListGroupsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.directoryservicedata.paginators.ListGroupsPublisher publisher = client.listGroupsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.directoryservicedata.paginators.ListGroupsPublisher publisher = client.listGroupsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.directoryservicedata.model.ListGroupsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.directoryservicedata.model.ListGroupsResponse response) { //... }; });Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listGroups(software.amazon.awssdk.services.directoryservicedata.model.ListGroupsRequest)operation.
This is a convenience which creates an instance of the
ListGroupsRequest.Builderavoiding the need to create one manually viaListGroupsRequest.builder()- Parameters:
listGroupsRequest- AConsumerthat will call methods onListGroupsRequest.Builderto create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
- See Also:
- AWS API Documentation
-
listUsers
default CompletableFuture<ListUsersResponse> listUsers(ListUsersRequest listUsersRequest)
Returns user information for the specified directory.
This operation supports pagination with the use of the
NextTokenrequest and response parameters. If more results are available, theListUsers.NextTokenmember contains a token that you pass in the next call toListUsers. This retrieves the next set of items.You can also specify a maximum number of return results with the
MaxResultsparameter.- Parameters:
listUsersRequest-- Returns:
- A Java Future containing the result of the ListUsers operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
- See Also:
- AWS API Documentation
-
listUsers
default CompletableFuture<ListUsersResponse> listUsers(Consumer<ListUsersRequest.Builder> listUsersRequest)
Returns user information for the specified directory.
This operation supports pagination with the use of the
NextTokenrequest and response parameters. If more results are available, theListUsers.NextTokenmember contains a token that you pass in the next call toListUsers. This retrieves the next set of items.You can also specify a maximum number of return results with the
MaxResultsparameter.
This is a convenience which creates an instance of the
ListUsersRequest.Builderavoiding the need to create one manually viaListUsersRequest.builder()- Parameters:
listUsersRequest- AConsumerthat will call methods onListUsersRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the ListUsers operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
- See Also:
- AWS API Documentation
-
listUsersPaginator
default ListUsersPublisher listUsersPaginator(ListUsersRequest listUsersRequest)
This is a variant of
listUsers(software.amazon.awssdk.services.directoryservicedata.model.ListUsersRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.directoryservicedata.paginators.ListUsersPublisher publisher = client.listUsersPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.directoryservicedata.paginators.ListUsersPublisher publisher = client.listUsersPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.directoryservicedata.model.ListUsersResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.directoryservicedata.model.ListUsersResponse response) { //... }; });Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listUsers(software.amazon.awssdk.services.directoryservicedata.model.ListUsersRequest)operation.- Parameters:
listUsersRequest-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
- See Also:
- AWS API Documentation
-
listUsersPaginator
default ListUsersPublisher listUsersPaginator(Consumer<ListUsersRequest.Builder> listUsersRequest)
This is a variant of
listUsers(software.amazon.awssdk.services.directoryservicedata.model.ListUsersRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.directoryservicedata.paginators.ListUsersPublisher publisher = client.listUsersPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.directoryservicedata.paginators.ListUsersPublisher publisher = client.listUsersPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.directoryservicedata.model.ListUsersResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.directoryservicedata.model.ListUsersResponse response) { //... }; });Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
listUsers(software.amazon.awssdk.services.directoryservicedata.model.ListUsersRequest)operation.
This is a convenience which creates an instance of the
ListUsersRequest.Builderavoiding the need to create one manually viaListUsersRequest.builder()- Parameters:
listUsersRequest- AConsumerthat will call methods onListUsersRequest.Builderto create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
- See Also:
- AWS API Documentation
-
removeGroupMember
default CompletableFuture<RemoveGroupMemberResponse> removeGroupMember(RemoveGroupMemberRequest removeGroupMemberRequest)
Removes a member from a group.
- Parameters:
removeGroupMemberRequest-- Returns:
- A Java Future containing the result of the RemoveGroupMember operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ConflictException This error will occur when you try to create a resource that conflicts with an
existing object. It can also occur when adding a member to a group that the member is already in.
This error can be caused by a request sent within the 8-hour idempotency window with the same client token but different input parameters. Client tokens should not be re-used across different requests. After 8 hours, any request with the same client token is treated as a new request.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
removeGroupMember
default CompletableFuture<RemoveGroupMemberResponse> removeGroupMember(Consumer<RemoveGroupMemberRequest.Builder> removeGroupMemberRequest)
Removes a member from a group.
This is a convenience which creates an instance of the
RemoveGroupMemberRequest.Builderavoiding the need to create one manually viaRemoveGroupMemberRequest.builder()- Parameters:
removeGroupMemberRequest- AConsumerthat will call methods onRemoveGroupMemberRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the RemoveGroupMember operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ConflictException This error will occur when you try to create a resource that conflicts with an
existing object. It can also occur when adding a member to a group that the member is already in.
This error can be caused by a request sent within the 8-hour idempotency window with the same client token but different input parameters. Client tokens should not be re-used across different requests. After 8 hours, any request with the same client token is treated as a new request.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
searchGroups
default CompletableFuture<SearchGroupsResponse> searchGroups(SearchGroupsRequest searchGroupsRequest)
Searches the specified directory for a group. You can find groups that match the
SearchStringparameter with the value of their attributes included in theSearchStringparameter.This operation supports pagination with the use of the
NextTokenrequest and response parameters. If more results are available, theSearchGroups.NextTokenmember contains a token that you pass in the next call toSearchGroups. This retrieves the next set of items.You can also specify a maximum number of return results with the
MaxResultsparameter.- Parameters:
searchGroupsRequest-- Returns:
- A Java Future containing the result of the SearchGroups operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
- See Also:
- AWS API Documentation
-
searchGroups
default CompletableFuture<SearchGroupsResponse> searchGroups(Consumer<SearchGroupsRequest.Builder> searchGroupsRequest)
Searches the specified directory for a group. You can find groups that match the
SearchStringparameter with the value of their attributes included in theSearchStringparameter.This operation supports pagination with the use of the
NextTokenrequest and response parameters. If more results are available, theSearchGroups.NextTokenmember contains a token that you pass in the next call toSearchGroups. This retrieves the next set of items.You can also specify a maximum number of return results with the
MaxResultsparameter.
This is a convenience which creates an instance of the
SearchGroupsRequest.Builderavoiding the need to create one manually viaSearchGroupsRequest.builder()- Parameters:
searchGroupsRequest- AConsumerthat will call methods onSearchGroupsRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the SearchGroups operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
- See Also:
- AWS API Documentation
-
searchGroupsPaginator
default SearchGroupsPublisher searchGroupsPaginator(SearchGroupsRequest searchGroupsRequest)
This is a variant of
searchGroups(software.amazon.awssdk.services.directoryservicedata.model.SearchGroupsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.directoryservicedata.paginators.SearchGroupsPublisher publisher = client.searchGroupsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.directoryservicedata.paginators.SearchGroupsPublisher publisher = client.searchGroupsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.directoryservicedata.model.SearchGroupsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.directoryservicedata.model.SearchGroupsResponse response) { //... }; });Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
searchGroups(software.amazon.awssdk.services.directoryservicedata.model.SearchGroupsRequest)operation.- Parameters:
searchGroupsRequest-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
- See Also:
- AWS API Documentation
-
searchGroupsPaginator
default SearchGroupsPublisher searchGroupsPaginator(Consumer<SearchGroupsRequest.Builder> searchGroupsRequest)
This is a variant of
searchGroups(software.amazon.awssdk.services.directoryservicedata.model.SearchGroupsRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.directoryservicedata.paginators.SearchGroupsPublisher publisher = client.searchGroupsPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.directoryservicedata.paginators.SearchGroupsPublisher publisher = client.searchGroupsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.directoryservicedata.model.SearchGroupsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.directoryservicedata.model.SearchGroupsResponse response) { //... }; });Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
searchGroups(software.amazon.awssdk.services.directoryservicedata.model.SearchGroupsRequest)operation.
This is a convenience which creates an instance of the
SearchGroupsRequest.Builderavoiding the need to create one manually viaSearchGroupsRequest.builder()- Parameters:
searchGroupsRequest- AConsumerthat will call methods onSearchGroupsRequest.Builderto create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
- See Also:
- AWS API Documentation
-
searchUsers
default CompletableFuture<SearchUsersResponse> searchUsers(SearchUsersRequest searchUsersRequest)
Searches the specified directory for a user. You can find users that match the
SearchStringparameter with the value of their attributes included in theSearchStringparameter.This operation supports pagination with the use of the
NextTokenrequest and response parameters. If more results are available, theSearchUsers.NextTokenmember contains a token that you pass in the next call toSearchUsers. This retrieves the next set of items.You can also specify a maximum number of return results with the
MaxResultsparameter.- Parameters:
searchUsersRequest-- Returns:
- A Java Future containing the result of the SearchUsers operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
- See Also:
- AWS API Documentation
-
searchUsers
default CompletableFuture<SearchUsersResponse> searchUsers(Consumer<SearchUsersRequest.Builder> searchUsersRequest)
Searches the specified directory for a user. You can find users that match the
SearchStringparameter with the value of their attributes included in theSearchStringparameter.This operation supports pagination with the use of the
NextTokenrequest and response parameters. If more results are available, theSearchUsers.NextTokenmember contains a token that you pass in the next call toSearchUsers. This retrieves the next set of items.You can also specify a maximum number of return results with the
MaxResultsparameter.
This is a convenience which creates an instance of the
SearchUsersRequest.Builderavoiding the need to create one manually viaSearchUsersRequest.builder()- Parameters:
searchUsersRequest- AConsumerthat will call methods onSearchUsersRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the SearchUsers operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
- See Also:
- AWS API Documentation
-
searchUsersPaginator
default SearchUsersPublisher searchUsersPaginator(SearchUsersRequest searchUsersRequest)
This is a variant of
searchUsers(software.amazon.awssdk.services.directoryservicedata.model.SearchUsersRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.directoryservicedata.paginators.SearchUsersPublisher publisher = client.searchUsersPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.directoryservicedata.paginators.SearchUsersPublisher publisher = client.searchUsersPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.directoryservicedata.model.SearchUsersResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.directoryservicedata.model.SearchUsersResponse response) { //... }; });Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
searchUsers(software.amazon.awssdk.services.directoryservicedata.model.SearchUsersRequest)operation.- Parameters:
searchUsersRequest-- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
- See Also:
- AWS API Documentation
-
searchUsersPaginator
default SearchUsersPublisher searchUsersPaginator(Consumer<SearchUsersRequest.Builder> searchUsersRequest)
This is a variant of
searchUsers(software.amazon.awssdk.services.directoryservicedata.model.SearchUsersRequest)operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see
Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a newSubscriptioni.e., a new contract to stream data from the starting request.The following are few ways to use the response class:
1) Using the subscribe helper method
2) Using a custom subscribersoftware.amazon.awssdk.services.directoryservicedata.paginators.SearchUsersPublisher publisher = client.searchUsersPaginator(request); CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response }); future.get();
As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.software.amazon.awssdk.services.directoryservicedata.paginators.SearchUsersPublisher publisher = client.searchUsersPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.directoryservicedata.model.SearchUsersResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.directoryservicedata.model.SearchUsersResponse response) { //... }; });Please notice that the configuration of MaxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.
Note: If you prefer to have control on service calls, use the
searchUsers(software.amazon.awssdk.services.directoryservicedata.model.SearchUsersRequest)operation.
This is a convenience which creates an instance of the
SearchUsersRequest.Builderavoiding the need to create one manually viaSearchUsersRequest.builder()- Parameters:
searchUsersRequest- AConsumerthat will call methods onSearchUsersRequest.Builderto create a request.- Returns:
- A custom publisher that can be subscribed to request a stream of response pages.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
- See Also:
- AWS API Documentation
-
updateGroup
default CompletableFuture<UpdateGroupResponse> updateGroup(UpdateGroupRequest updateGroupRequest)
Updates group information.
- Parameters:
updateGroupRequest-- Returns:
- A Java Future containing the result of the UpdateGroup operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ConflictException This error will occur when you try to create a resource that conflicts with an
existing object. It can also occur when adding a member to a group that the member is already in.
This error can be caused by a request sent within the 8-hour idempotency window with the same client token but different input parameters. Client tokens should not be re-used across different requests. After 8 hours, any request with the same client token is treated as a new request.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
updateGroup
default CompletableFuture<UpdateGroupResponse> updateGroup(Consumer<UpdateGroupRequest.Builder> updateGroupRequest)
Updates group information.
This is a convenience which creates an instance of the
UpdateGroupRequest.Builderavoiding the need to create one manually viaUpdateGroupRequest.builder()- Parameters:
updateGroupRequest- AConsumerthat will call methods onUpdateGroupRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the UpdateGroup operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ConflictException This error will occur when you try to create a resource that conflicts with an
existing object. It can also occur when adding a member to a group that the member is already in.
This error can be caused by a request sent within the 8-hour idempotency window with the same client token but different input parameters. Client tokens should not be re-used across different requests. After 8 hours, any request with the same client token is treated as a new request.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
updateUser
default CompletableFuture<UpdateUserResponse> updateUser(UpdateUserRequest updateUserRequest)
Updates user information.
- Parameters:
updateUserRequest-- Returns:
- A Java Future containing the result of the UpdateUser operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ConflictException This error will occur when you try to create a resource that conflicts with an
existing object. It can also occur when adding a member to a group that the member is already in.
This error can be caused by a request sent within the 8-hour idempotency window with the same client token but different input parameters. Client tokens should not be re-used across different requests. After 8 hours, any request with the same client token is treated as a new request.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
updateUser
default CompletableFuture<UpdateUserResponse> updateUser(Consumer<UpdateUserRequest.Builder> updateUserRequest)
Updates user information.
This is a convenience which creates an instance of the
UpdateUserRequest.Builderavoiding the need to create one manually viaUpdateUserRequest.builder()- Parameters:
updateUserRequest- AConsumerthat will call methods onUpdateUserRequest.Builderto create a request.- Returns:
- A Java Future containing the result of the UpdateUser operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()to retrieve the underlying exception.- ResourceNotFoundException The resource couldn't be found.
- AccessDeniedException You don't have permission to perform the request or access the directory. It
can also occur when the
DirectoryIddoesn't exist or the user, member, or group might be outside of your organizational unit (OU).Make sure that you have the authentication and authorization to perform the action. Review the directory information in the request, and make sure that the object isn't outside of your OU.
- InternalServerException The operation didn't succeed because an internal error occurred. Try again later.
- ValidationException The request isn't valid. Review the details in the error message to update the invalid parameters or values in your request.
- DirectoryUnavailableException The request could not be completed due to a problem in the configuration or current state of the specified directory.
- ConflictException This error will occur when you try to create a resource that conflicts with an
existing object. It can also occur when adding a member to a group that the member is already in.
This error can be caused by a request sent within the 8-hour idempotency window with the same client token but different input parameters. Client tokens should not be re-used across different requests. After 8 hours, any request with the same client token is treated as a new request.
- ThrottlingException The limit on the number of requests per second has been exceeded.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- DirectoryServiceDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
- AWS API Documentation
-
serviceClientConfiguration
default DirectoryServiceDataServiceClientConfiguration serviceClientConfiguration()
- Specified by:
serviceClientConfigurationin interfaceAwsClient- Specified by:
serviceClientConfigurationin interfaceSdkClient
-
create
static DirectoryServiceDataAsyncClient create()
Create aDirectoryServiceDataAsyncClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider.
-
builder
static DirectoryServiceDataAsyncClientBuilder builder()
Create a builder that can be used to configure and create aDirectoryServiceDataAsyncClient.
-
-