Interface WorkspacesInstancesAsyncClient
- All Superinterfaces:
AutoCloseable,AwsClient,SdkAutoCloseable,SdkClient
builder() method.The asynchronous client performs non-blocking I/O when configured with any
SdkAsyncHttpClient supported 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 WorkSpaces Instances provides an API framework for managing virtual workspace environments across multiple AWS regions, enabling programmatic creation and configuration of desktop infrastructure.
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringValue for looking up the service's metadata from theServiceMetadataProvider.static final String -
Method Summary
Modifier and TypeMethodDescriptiondefault CompletableFuture<AssociateVolumeResponse> associateVolume(Consumer<AssociateVolumeRequest.Builder> associateVolumeRequest) Attaches a volume to a WorkSpace Instance.default CompletableFuture<AssociateVolumeResponse> associateVolume(AssociateVolumeRequest associateVolumeRequest) Attaches a volume to a WorkSpace Instance.builder()Create a builder that can be used to configure and create aWorkspacesInstancesAsyncClient.create()Create aWorkspacesInstancesAsyncClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider.default CompletableFuture<CreateVolumeResponse> createVolume(Consumer<CreateVolumeRequest.Builder> createVolumeRequest) Creates a new volume for WorkSpace Instances.default CompletableFuture<CreateVolumeResponse> createVolume(CreateVolumeRequest createVolumeRequest) Creates a new volume for WorkSpace Instances.createWorkspaceInstance(Consumer<CreateWorkspaceInstanceRequest.Builder> createWorkspaceInstanceRequest) Launches a new WorkSpace Instance with specified configuration parameters, enabling programmatic workspace deployment.createWorkspaceInstance(CreateWorkspaceInstanceRequest createWorkspaceInstanceRequest) Launches a new WorkSpace Instance with specified configuration parameters, enabling programmatic workspace deployment.default CompletableFuture<DeleteVolumeResponse> deleteVolume(Consumer<DeleteVolumeRequest.Builder> deleteVolumeRequest) Deletes a specified volume.default CompletableFuture<DeleteVolumeResponse> deleteVolume(DeleteVolumeRequest deleteVolumeRequest) Deletes a specified volume.deleteWorkspaceInstance(Consumer<DeleteWorkspaceInstanceRequest.Builder> deleteWorkspaceInstanceRequest) Deletes the specified WorkSpacedeleteWorkspaceInstance(DeleteWorkspaceInstanceRequest deleteWorkspaceInstanceRequest) Deletes the specified WorkSpacedisassociateVolume(Consumer<DisassociateVolumeRequest.Builder> disassociateVolumeRequest) Detaches a volume from a WorkSpace Instance.disassociateVolume(DisassociateVolumeRequest disassociateVolumeRequest) Detaches a volume from a WorkSpace Instance.getWorkspaceInstance(Consumer<GetWorkspaceInstanceRequest.Builder> getWorkspaceInstanceRequest) Retrieves detailed information about a specific WorkSpace Instance.getWorkspaceInstance(GetWorkspaceInstanceRequest getWorkspaceInstanceRequest) Retrieves detailed information about a specific WorkSpace Instance.listInstanceTypes(Consumer<ListInstanceTypesRequest.Builder> listInstanceTypesRequest) Retrieves a list of instance types supported by Amazon WorkSpaces Instances, enabling precise workspace infrastructure configuration.listInstanceTypes(ListInstanceTypesRequest listInstanceTypesRequest) Retrieves a list of instance types supported by Amazon WorkSpaces Instances, enabling precise workspace infrastructure configuration.default ListInstanceTypesPublisherlistInstanceTypesPaginator(Consumer<ListInstanceTypesRequest.Builder> listInstanceTypesRequest) This is a variant oflistInstanceTypes(software.amazon.awssdk.services.workspacesinstances.model.ListInstanceTypesRequest)operation.default ListInstanceTypesPublisherlistInstanceTypesPaginator(ListInstanceTypesRequest listInstanceTypesRequest) This is a variant oflistInstanceTypes(software.amazon.awssdk.services.workspacesinstances.model.ListInstanceTypesRequest)operation.default CompletableFuture<ListRegionsResponse> listRegions(Consumer<ListRegionsRequest.Builder> listRegionsRequest) Retrieves a list of AWS regions supported by Amazon WorkSpaces Instances, enabling region discovery for workspace deployments.default CompletableFuture<ListRegionsResponse> listRegions(ListRegionsRequest listRegionsRequest) Retrieves a list of AWS regions supported by Amazon WorkSpaces Instances, enabling region discovery for workspace deployments.default ListRegionsPublisherlistRegionsPaginator(Consumer<ListRegionsRequest.Builder> listRegionsRequest) This is a variant oflistRegions(software.amazon.awssdk.services.workspacesinstances.model.ListRegionsRequest)operation.default ListRegionsPublisherlistRegionsPaginator(ListRegionsRequest listRegionsRequest) This is a variant oflistRegions(software.amazon.awssdk.services.workspacesinstances.model.ListRegionsRequest)operation.listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) Retrieves tags for a WorkSpace Instance.listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) Retrieves tags for a WorkSpace Instance.listWorkspaceInstances(Consumer<ListWorkspaceInstancesRequest.Builder> listWorkspaceInstancesRequest) Retrieves a collection of WorkSpaces Instances based on specified filters.listWorkspaceInstances(ListWorkspaceInstancesRequest listWorkspaceInstancesRequest) Retrieves a collection of WorkSpaces Instances based on specified filters.default ListWorkspaceInstancesPublisherlistWorkspaceInstancesPaginator(Consumer<ListWorkspaceInstancesRequest.Builder> listWorkspaceInstancesRequest) This is a variant oflistWorkspaceInstances(software.amazon.awssdk.services.workspacesinstances.model.ListWorkspaceInstancesRequest)operation.default ListWorkspaceInstancesPublisherlistWorkspaceInstancesPaginator(ListWorkspaceInstancesRequest listWorkspaceInstancesRequest) This is a variant oflistWorkspaceInstances(software.amazon.awssdk.services.workspacesinstances.model.ListWorkspaceInstancesRequest)operation.The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfigurationdefault CompletableFuture<TagResourceResponse> tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) Adds tags to a WorkSpace Instance.default CompletableFuture<TagResourceResponse> tagResource(TagResourceRequest tagResourceRequest) Adds tags to a WorkSpace Instance.default CompletableFuture<UntagResourceResponse> untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) Removes tags from a WorkSpace Instance.default CompletableFuture<UntagResourceResponse> untagResource(UntagResourceRequest untagResourceRequest) Removes tags from a WorkSpace Instance.Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable
closeMethods inherited from interface software.amazon.awssdk.core.SdkClient
serviceName
-
Field Details
-
SERVICE_NAME
- See Also:
-
SERVICE_METADATA_ID
Value for looking up the service's metadata from theServiceMetadataProvider.- See Also:
-
-
Method Details
-
associateVolume
default CompletableFuture<AssociateVolumeResponse> associateVolume(AssociateVolumeRequest associateVolumeRequest) Attaches a volume to a WorkSpace Instance.
- Parameters:
associateVolumeRequest- Specifies volume attachment parameters.- Returns:
- A Java Future containing the result of the AssociateVolume 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- ResourceNotFoundException Indicates the requested resource could not be found.
- InternalServerException Indicates an unexpected server-side error occurred.
- ConflictException Signals a conflict with the current state of the resource.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
associateVolume
default CompletableFuture<AssociateVolumeResponse> associateVolume(Consumer<AssociateVolumeRequest.Builder> associateVolumeRequest) Attaches a volume to a WorkSpace Instance.
This is a convenience which creates an instance of the
AssociateVolumeRequest.Builderavoiding the need to create one manually viaAssociateVolumeRequest.builder()- Parameters:
associateVolumeRequest- AConsumerthat will call methods onAssociateVolumeRequest.Builderto create a request. Specifies volume attachment parameters.- Returns:
- A Java Future containing the result of the AssociateVolume 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- ResourceNotFoundException Indicates the requested resource could not be found.
- InternalServerException Indicates an unexpected server-side error occurred.
- ConflictException Signals a conflict with the current state of the resource.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createVolume
default CompletableFuture<CreateVolumeResponse> createVolume(CreateVolumeRequest createVolumeRequest) Creates a new volume for WorkSpace Instances.
- Parameters:
createVolumeRequest- Specifies volume creation parameters.- Returns:
- A Java Future containing the result of the CreateVolume 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- InternalServerException Indicates an unexpected server-side error occurred.
- ServiceQuotaExceededException Indicates that a service quota has been exceeded.
- ConflictException Signals a conflict with the current state of the resource.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createVolume
default CompletableFuture<CreateVolumeResponse> createVolume(Consumer<CreateVolumeRequest.Builder> createVolumeRequest) Creates a new volume for WorkSpace Instances.
This is a convenience which creates an instance of the
CreateVolumeRequest.Builderavoiding the need to create one manually viaCreateVolumeRequest.builder()- Parameters:
createVolumeRequest- AConsumerthat will call methods onCreateVolumeRequest.Builderto create a request. Specifies volume creation parameters.- Returns:
- A Java Future containing the result of the CreateVolume 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- InternalServerException Indicates an unexpected server-side error occurred.
- ServiceQuotaExceededException Indicates that a service quota has been exceeded.
- ConflictException Signals a conflict with the current state of the resource.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createWorkspaceInstance
default CompletableFuture<CreateWorkspaceInstanceResponse> createWorkspaceInstance(CreateWorkspaceInstanceRequest createWorkspaceInstanceRequest) Launches a new WorkSpace Instance with specified configuration parameters, enabling programmatic workspace deployment.
- Parameters:
createWorkspaceInstanceRequest- Defines the configuration parameters for creating a new WorkSpaces Instance.- Returns:
- A Java Future containing the result of the CreateWorkspaceInstance 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- InternalServerException Indicates an unexpected server-side error occurred.
- ServiceQuotaExceededException Indicates that a service quota has been exceeded.
- ConflictException Signals a conflict with the current state of the resource.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
createWorkspaceInstance
default CompletableFuture<CreateWorkspaceInstanceResponse> createWorkspaceInstance(Consumer<CreateWorkspaceInstanceRequest.Builder> createWorkspaceInstanceRequest) Launches a new WorkSpace Instance with specified configuration parameters, enabling programmatic workspace deployment.
This is a convenience which creates an instance of the
CreateWorkspaceInstanceRequest.Builderavoiding the need to create one manually viaCreateWorkspaceInstanceRequest.builder()- Parameters:
createWorkspaceInstanceRequest- AConsumerthat will call methods onCreateWorkspaceInstanceRequest.Builderto create a request. Defines the configuration parameters for creating a new WorkSpaces Instance.- Returns:
- A Java Future containing the result of the CreateWorkspaceInstance 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- InternalServerException Indicates an unexpected server-side error occurred.
- ServiceQuotaExceededException Indicates that a service quota has been exceeded.
- ConflictException Signals a conflict with the current state of the resource.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteVolume
default CompletableFuture<DeleteVolumeResponse> deleteVolume(DeleteVolumeRequest deleteVolumeRequest) Deletes a specified volume.
- Parameters:
deleteVolumeRequest- Specifies the volume to delete.- Returns:
- A Java Future containing the result of the DeleteVolume 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- ResourceNotFoundException Indicates the requested resource could not be found.
- InternalServerException Indicates an unexpected server-side error occurred.
- ConflictException Signals a conflict with the current state of the resource.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteVolume
default CompletableFuture<DeleteVolumeResponse> deleteVolume(Consumer<DeleteVolumeRequest.Builder> deleteVolumeRequest) Deletes a specified volume.
This is a convenience which creates an instance of the
DeleteVolumeRequest.Builderavoiding the need to create one manually viaDeleteVolumeRequest.builder()- Parameters:
deleteVolumeRequest- AConsumerthat will call methods onDeleteVolumeRequest.Builderto create a request. Specifies the volume to delete.- Returns:
- A Java Future containing the result of the DeleteVolume 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- ResourceNotFoundException Indicates the requested resource could not be found.
- InternalServerException Indicates an unexpected server-side error occurred.
- ConflictException Signals a conflict with the current state of the resource.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteWorkspaceInstance
default CompletableFuture<DeleteWorkspaceInstanceResponse> deleteWorkspaceInstance(DeleteWorkspaceInstanceRequest deleteWorkspaceInstanceRequest) Deletes the specified WorkSpace
- Parameters:
deleteWorkspaceInstanceRequest- The WorkSpace to delete- Returns:
- A Java Future containing the result of the DeleteWorkspaceInstance 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- ResourceNotFoundException Indicates the requested resource could not be found.
- InternalServerException Indicates an unexpected server-side error occurred.
- ConflictException Signals a conflict with the current state of the resource.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
deleteWorkspaceInstance
default CompletableFuture<DeleteWorkspaceInstanceResponse> deleteWorkspaceInstance(Consumer<DeleteWorkspaceInstanceRequest.Builder> deleteWorkspaceInstanceRequest) Deletes the specified WorkSpace
This is a convenience which creates an instance of the
DeleteWorkspaceInstanceRequest.Builderavoiding the need to create one manually viaDeleteWorkspaceInstanceRequest.builder()- Parameters:
deleteWorkspaceInstanceRequest- AConsumerthat will call methods onDeleteWorkspaceInstanceRequest.Builderto create a request. The WorkSpace to delete- Returns:
- A Java Future containing the result of the DeleteWorkspaceInstance 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- ResourceNotFoundException Indicates the requested resource could not be found.
- InternalServerException Indicates an unexpected server-side error occurred.
- ConflictException Signals a conflict with the current state of the resource.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
disassociateVolume
default CompletableFuture<DisassociateVolumeResponse> disassociateVolume(DisassociateVolumeRequest disassociateVolumeRequest) Detaches a volume from a WorkSpace Instance.
- Parameters:
disassociateVolumeRequest- Specifies volume detachment parameters.- Returns:
- A Java Future containing the result of the DisassociateVolume 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- ResourceNotFoundException Indicates the requested resource could not be found.
- InternalServerException Indicates an unexpected server-side error occurred.
- ConflictException Signals a conflict with the current state of the resource.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
disassociateVolume
default CompletableFuture<DisassociateVolumeResponse> disassociateVolume(Consumer<DisassociateVolumeRequest.Builder> disassociateVolumeRequest) Detaches a volume from a WorkSpace Instance.
This is a convenience which creates an instance of the
DisassociateVolumeRequest.Builderavoiding the need to create one manually viaDisassociateVolumeRequest.builder()- Parameters:
disassociateVolumeRequest- AConsumerthat will call methods onDisassociateVolumeRequest.Builderto create a request. Specifies volume detachment parameters.- Returns:
- A Java Future containing the result of the DisassociateVolume 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- ResourceNotFoundException Indicates the requested resource could not be found.
- InternalServerException Indicates an unexpected server-side error occurred.
- ConflictException Signals a conflict with the current state of the resource.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
getWorkspaceInstance
default CompletableFuture<GetWorkspaceInstanceResponse> getWorkspaceInstance(GetWorkspaceInstanceRequest getWorkspaceInstanceRequest) Retrieves detailed information about a specific WorkSpace Instance.
- Parameters:
getWorkspaceInstanceRequest- Identifies the WorkSpaces Instance to retrieve detailed information for.- Returns:
- A Java Future containing the result of the GetWorkspaceInstance 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- ResourceNotFoundException Indicates the requested resource could not be found.
- InternalServerException Indicates an unexpected server-side error occurred.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
getWorkspaceInstance
default CompletableFuture<GetWorkspaceInstanceResponse> getWorkspaceInstance(Consumer<GetWorkspaceInstanceRequest.Builder> getWorkspaceInstanceRequest) Retrieves detailed information about a specific WorkSpace Instance.
This is a convenience which creates an instance of the
GetWorkspaceInstanceRequest.Builderavoiding the need to create one manually viaGetWorkspaceInstanceRequest.builder()- Parameters:
getWorkspaceInstanceRequest- AConsumerthat will call methods onGetWorkspaceInstanceRequest.Builderto create a request. Identifies the WorkSpaces Instance to retrieve detailed information for.- Returns:
- A Java Future containing the result of the GetWorkspaceInstance 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- ResourceNotFoundException Indicates the requested resource could not be found.
- InternalServerException Indicates an unexpected server-side error occurred.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listInstanceTypes
default CompletableFuture<ListInstanceTypesResponse> listInstanceTypes(ListInstanceTypesRequest listInstanceTypesRequest) Retrieves a list of instance types supported by Amazon WorkSpaces Instances, enabling precise workspace infrastructure configuration.
- Parameters:
listInstanceTypesRequest- Defines input parameters for retrieving supported WorkSpaces Instances instance types.- Returns:
- A Java Future containing the result of the ListInstanceTypes 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- InternalServerException Indicates an unexpected server-side error occurred.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listInstanceTypes
default CompletableFuture<ListInstanceTypesResponse> listInstanceTypes(Consumer<ListInstanceTypesRequest.Builder> listInstanceTypesRequest) Retrieves a list of instance types supported by Amazon WorkSpaces Instances, enabling precise workspace infrastructure configuration.
This is a convenience which creates an instance of the
ListInstanceTypesRequest.Builderavoiding the need to create one manually viaListInstanceTypesRequest.builder()- Parameters:
listInstanceTypesRequest- AConsumerthat will call methods onListInstanceTypesRequest.Builderto create a request. Defines input parameters for retrieving supported WorkSpaces Instances instance types.- Returns:
- A Java Future containing the result of the ListInstanceTypes 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- InternalServerException Indicates an unexpected server-side error occurred.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listInstanceTypesPaginator
default ListInstanceTypesPublisher listInstanceTypesPaginator(ListInstanceTypesRequest listInstanceTypesRequest) This is a variant of
listInstanceTypes(software.amazon.awssdk.services.workspacesinstances.model.ListInstanceTypesRequest)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.workspacesinstances.paginators.ListInstanceTypesPublisher publisher = client.listInstanceTypesPaginator(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.workspacesinstances.paginators.ListInstanceTypesPublisher publisher = client.listInstanceTypesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.workspacesinstances.model.ListInstanceTypesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.workspacesinstances.model.ListInstanceTypesResponse 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
listInstanceTypes(software.amazon.awssdk.services.workspacesinstances.model.ListInstanceTypesRequest)operation.- Parameters:
listInstanceTypesRequest- Defines input parameters for retrieving supported WorkSpaces Instances instance types.- 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- InternalServerException Indicates an unexpected server-side error occurred.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listInstanceTypesPaginator
default ListInstanceTypesPublisher listInstanceTypesPaginator(Consumer<ListInstanceTypesRequest.Builder> listInstanceTypesRequest) This is a variant of
listInstanceTypes(software.amazon.awssdk.services.workspacesinstances.model.ListInstanceTypesRequest)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.workspacesinstances.paginators.ListInstanceTypesPublisher publisher = client.listInstanceTypesPaginator(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.workspacesinstances.paginators.ListInstanceTypesPublisher publisher = client.listInstanceTypesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.workspacesinstances.model.ListInstanceTypesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.workspacesinstances.model.ListInstanceTypesResponse 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
listInstanceTypes(software.amazon.awssdk.services.workspacesinstances.model.ListInstanceTypesRequest)operation.
This is a convenience which creates an instance of the
ListInstanceTypesRequest.Builderavoiding the need to create one manually viaListInstanceTypesRequest.builder()- Parameters:
listInstanceTypesRequest- AConsumerthat will call methods onListInstanceTypesRequest.Builderto create a request. Defines input parameters for retrieving supported WorkSpaces Instances instance types.- 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- InternalServerException Indicates an unexpected server-side error occurred.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listRegions
Retrieves a list of AWS regions supported by Amazon WorkSpaces Instances, enabling region discovery for workspace deployments.
- Parameters:
listRegionsRequest- Defines input parameters for retrieving supported WorkSpaces Instances regions.- Returns:
- A Java Future containing the result of the ListRegions 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- InternalServerException Indicates an unexpected server-side error occurred.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listRegions
default CompletableFuture<ListRegionsResponse> listRegions(Consumer<ListRegionsRequest.Builder> listRegionsRequest) Retrieves a list of AWS regions supported by Amazon WorkSpaces Instances, enabling region discovery for workspace deployments.
This is a convenience which creates an instance of the
ListRegionsRequest.Builderavoiding the need to create one manually viaListRegionsRequest.builder()- Parameters:
listRegionsRequest- AConsumerthat will call methods onListRegionsRequest.Builderto create a request. Defines input parameters for retrieving supported WorkSpaces Instances regions.- Returns:
- A Java Future containing the result of the ListRegions 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- InternalServerException Indicates an unexpected server-side error occurred.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listRegionsPaginator
This is a variant of
listRegions(software.amazon.awssdk.services.workspacesinstances.model.ListRegionsRequest)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.workspacesinstances.paginators.ListRegionsPublisher publisher = client.listRegionsPaginator(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.workspacesinstances.paginators.ListRegionsPublisher publisher = client.listRegionsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.workspacesinstances.model.ListRegionsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.workspacesinstances.model.ListRegionsResponse 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
listRegions(software.amazon.awssdk.services.workspacesinstances.model.ListRegionsRequest)operation.- Parameters:
listRegionsRequest- Defines input parameters for retrieving supported WorkSpaces Instances regions.- 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- InternalServerException Indicates an unexpected server-side error occurred.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listRegionsPaginator
default ListRegionsPublisher listRegionsPaginator(Consumer<ListRegionsRequest.Builder> listRegionsRequest) This is a variant of
listRegions(software.amazon.awssdk.services.workspacesinstances.model.ListRegionsRequest)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.workspacesinstances.paginators.ListRegionsPublisher publisher = client.listRegionsPaginator(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.workspacesinstances.paginators.ListRegionsPublisher publisher = client.listRegionsPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.workspacesinstances.model.ListRegionsResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.workspacesinstances.model.ListRegionsResponse 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
listRegions(software.amazon.awssdk.services.workspacesinstances.model.ListRegionsRequest)operation.
This is a convenience which creates an instance of the
ListRegionsRequest.Builderavoiding the need to create one manually viaListRegionsRequest.builder()- Parameters:
listRegionsRequest- AConsumerthat will call methods onListRegionsRequest.Builderto create a request. Defines input parameters for retrieving supported WorkSpaces Instances regions.- 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- InternalServerException Indicates an unexpected server-side error occurred.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listTagsForResource
default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) Retrieves tags for a WorkSpace Instance.
- Parameters:
listTagsForResourceRequest- Specifies the WorkSpace Instance to retrieve tags for.- Returns:
- A Java Future containing the result of the ListTagsForResource 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ResourceNotFoundException Indicates the requested resource could not be found.
- ThrottlingException Indicates the request rate has exceeded limits.
- InternalServerException Indicates an unexpected server-side error occurred.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listTagsForResource
default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest) Retrieves tags for a WorkSpace Instance.
This is a convenience which creates an instance of the
ListTagsForResourceRequest.Builderavoiding the need to create one manually viaListTagsForResourceRequest.builder()- Parameters:
listTagsForResourceRequest- AConsumerthat will call methods onListTagsForResourceRequest.Builderto create a request. Specifies the WorkSpace Instance to retrieve tags for.- Returns:
- A Java Future containing the result of the ListTagsForResource 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ResourceNotFoundException Indicates the requested resource could not be found.
- ThrottlingException Indicates the request rate has exceeded limits.
- InternalServerException Indicates an unexpected server-side error occurred.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listWorkspaceInstances
default CompletableFuture<ListWorkspaceInstancesResponse> listWorkspaceInstances(ListWorkspaceInstancesRequest listWorkspaceInstancesRequest) Retrieves a collection of WorkSpaces Instances based on specified filters.
- Parameters:
listWorkspaceInstancesRequest- Defines filters and pagination parameters for retrieving WorkSpaces Instances.- Returns:
- A Java Future containing the result of the ListWorkspaceInstances 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- InternalServerException Indicates an unexpected server-side error occurred.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listWorkspaceInstances
default CompletableFuture<ListWorkspaceInstancesResponse> listWorkspaceInstances(Consumer<ListWorkspaceInstancesRequest.Builder> listWorkspaceInstancesRequest) Retrieves a collection of WorkSpaces Instances based on specified filters.
This is a convenience which creates an instance of the
ListWorkspaceInstancesRequest.Builderavoiding the need to create one manually viaListWorkspaceInstancesRequest.builder()- Parameters:
listWorkspaceInstancesRequest- AConsumerthat will call methods onListWorkspaceInstancesRequest.Builderto create a request. Defines filters and pagination parameters for retrieving WorkSpaces Instances.- Returns:
- A Java Future containing the result of the ListWorkspaceInstances 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- InternalServerException Indicates an unexpected server-side error occurred.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listWorkspaceInstancesPaginator
default ListWorkspaceInstancesPublisher listWorkspaceInstancesPaginator(ListWorkspaceInstancesRequest listWorkspaceInstancesRequest) This is a variant of
listWorkspaceInstances(software.amazon.awssdk.services.workspacesinstances.model.ListWorkspaceInstancesRequest)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.workspacesinstances.paginators.ListWorkspaceInstancesPublisher publisher = client.listWorkspaceInstancesPaginator(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.workspacesinstances.paginators.ListWorkspaceInstancesPublisher publisher = client.listWorkspaceInstancesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.workspacesinstances.model.ListWorkspaceInstancesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.workspacesinstances.model.ListWorkspaceInstancesResponse 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
listWorkspaceInstances(software.amazon.awssdk.services.workspacesinstances.model.ListWorkspaceInstancesRequest)operation.- Parameters:
listWorkspaceInstancesRequest- Defines filters and pagination parameters for retrieving WorkSpaces Instances.- 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- InternalServerException Indicates an unexpected server-side error occurred.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
listWorkspaceInstancesPaginator
default ListWorkspaceInstancesPublisher listWorkspaceInstancesPaginator(Consumer<ListWorkspaceInstancesRequest.Builder> listWorkspaceInstancesRequest) This is a variant of
listWorkspaceInstances(software.amazon.awssdk.services.workspacesinstances.model.ListWorkspaceInstancesRequest)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.workspacesinstances.paginators.ListWorkspaceInstancesPublisher publisher = client.listWorkspaceInstancesPaginator(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.workspacesinstances.paginators.ListWorkspaceInstancesPublisher publisher = client.listWorkspaceInstancesPaginator(request); publisher.subscribe(new Subscriber<software.amazon.awssdk.services.workspacesinstances.model.ListWorkspaceInstancesResponse>() { public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... }; public void onNext(software.amazon.awssdk.services.workspacesinstances.model.ListWorkspaceInstancesResponse 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
listWorkspaceInstances(software.amazon.awssdk.services.workspacesinstances.model.ListWorkspaceInstancesRequest)operation.
This is a convenience which creates an instance of the
ListWorkspaceInstancesRequest.Builderavoiding the need to create one manually viaListWorkspaceInstancesRequest.builder()- Parameters:
listWorkspaceInstancesRequest- AConsumerthat will call methods onListWorkspaceInstancesRequest.Builderto create a request. Defines filters and pagination parameters for retrieving WorkSpaces Instances.- 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ThrottlingException Indicates the request rate has exceeded limits.
- InternalServerException Indicates an unexpected server-side error occurred.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
tagResource
Adds tags to a WorkSpace Instance.
- Parameters:
tagResourceRequest- Specifies tags to add to a WorkSpace Instance.- Returns:
- A Java Future containing the result of the TagResource 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ResourceNotFoundException Indicates the requested resource could not be found.
- ThrottlingException Indicates the request rate has exceeded limits.
- InternalServerException Indicates an unexpected server-side error occurred.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
tagResource
default CompletableFuture<TagResourceResponse> tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest) Adds tags to a WorkSpace Instance.
This is a convenience which creates an instance of the
TagResourceRequest.Builderavoiding the need to create one manually viaTagResourceRequest.builder()- Parameters:
tagResourceRequest- AConsumerthat will call methods onTagResourceRequest.Builderto create a request. Specifies tags to add to a WorkSpace Instance.- Returns:
- A Java Future containing the result of the TagResource 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ResourceNotFoundException Indicates the requested resource could not be found.
- ThrottlingException Indicates the request rate has exceeded limits.
- InternalServerException Indicates an unexpected server-side error occurred.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
untagResource
default CompletableFuture<UntagResourceResponse> untagResource(UntagResourceRequest untagResourceRequest) Removes tags from a WorkSpace Instance.
- Parameters:
untagResourceRequest- Specifies tags to remove from a WorkSpace Instance.- Returns:
- A Java Future containing the result of the UntagResource 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ResourceNotFoundException Indicates the requested resource could not be found.
- ThrottlingException Indicates the request rate has exceeded limits.
- InternalServerException Indicates an unexpected server-side error occurred.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
untagResource
default CompletableFuture<UntagResourceResponse> untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest) Removes tags from a WorkSpace Instance.
This is a convenience which creates an instance of the
UntagResourceRequest.Builderavoiding the need to create one manually viaUntagResourceRequest.builder()- Parameters:
untagResourceRequest- AConsumerthat will call methods onUntagResourceRequest.Builderto create a request. Specifies tags to remove from a WorkSpace Instance.- Returns:
- A Java Future containing the result of the UntagResource 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.- ValidationException Indicates invalid input parameters in the request.
- AccessDeniedException Indicates insufficient permissions to perform the requested action.
- ResourceNotFoundException Indicates the requested resource could not be found.
- ThrottlingException Indicates the request rate has exceeded limits.
- InternalServerException Indicates an unexpected server-side error occurred.
- 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.
- WorkspacesInstancesException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
serviceClientConfiguration
Description copied from interface:SdkClientThe SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration- Specified by:
serviceClientConfigurationin interfaceAwsClient- Specified by:
serviceClientConfigurationin interfaceSdkClient- Returns:
- SdkServiceClientConfiguration
-
create
Create aWorkspacesInstancesAsyncClientwith the region loaded from theDefaultAwsRegionProviderChainand credentials loaded from theDefaultCredentialsProvider. -
builder
Create a builder that can be used to configure and create aWorkspacesInstancesAsyncClient.
-