com.amazonaws.services.workspaces

Class AmazonWorkspacesClient

java.lang.Object

com.amazonaws.AmazonWebServiceClient

com.amazonaws.services.workspaces.AmazonWorkspacesClient

All Implemented Interfaces:

AmazonWorkspaces

Direct Known Subclasses:

AmazonWorkspacesAsyncClient

@ThreadSafe
 @Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public class AmazonWorkspacesClient
extends AmazonWebServiceClient
implements AmazonWorkspaces

Client for accessing Amazon WorkSpaces. All service calls made using this client are blocking, and will not return until the service call completes.

Amazon WorkSpaces Service

Amazon WorkSpaces enables you to provision virtual, cloud-based Microsoft Windows desktops for your users.

Field Summary

Fields inherited from class com.amazonaws.AmazonWebServiceClient

LOGGING_AWS_REQUEST_METRIC

Fields inherited from interface com.amazonaws.services.workspaces.AmazonWorkspaces

ENDPOINT_PREFIX

Constructor Summary

Constructors

Constructor and Description
AmazonWorkspacesClient() Deprecated. use AmazonWorkspacesClientBuilder.defaultClient()
AmazonWorkspacesClient(AWSCredentials awsCredentials) Deprecated. use AwsClientBuilder.withCredentials(AWSCredentialsProvider) for example: AmazonWorkspacesClientBuilder.standard().withCredentials(new AWSStaticCredentialsProvider(awsCredentials)).build();
AmazonWorkspacesClient(AWSCredentials awsCredentials, ClientConfiguration clientConfiguration) Deprecated. use AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AwsClientBuilder.withClientConfiguration(ClientConfiguration)
AmazonWorkspacesClient(AWSCredentialsProvider awsCredentialsProvider) Deprecated. use AwsClientBuilder.withCredentials(AWSCredentialsProvider)
AmazonWorkspacesClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration) Deprecated. use AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AwsClientBuilder.withClientConfiguration(ClientConfiguration)
AmazonWorkspacesClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration, RequestMetricCollector requestMetricCollector) Deprecated. use AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AwsClientBuilder.withClientConfiguration(ClientConfiguration) and AwsClientBuilder.withMetricsCollector(RequestMetricCollector)
AmazonWorkspacesClient(ClientConfiguration clientConfiguration) Deprecated. use AwsClientBuilder.withClientConfiguration(ClientConfiguration)

Method Summary

Modifier and Type	Method and Description
static AmazonWorkspacesClientBuilder	builder()
CreateTagsResult	createTags(CreateTagsRequest request) Creates tags for the specified WorkSpace.
CreateWorkspacesResult	createWorkspaces(CreateWorkspacesRequest request) Creates one or more WorkSpaces.
DeleteTagsResult	deleteTags(DeleteTagsRequest request) Deletes the specified tags from a WorkSpace.
DescribeTagsResult	describeTags(DescribeTagsRequest request) Describes the tags for the specified WorkSpace.
DescribeWorkspaceBundlesResult	describeWorkspaceBundles() Simplified method form for invoking the DescribeWorkspaceBundles operation.
DescribeWorkspaceBundlesResult	describeWorkspaceBundles(DescribeWorkspaceBundlesRequest request) Describes the available WorkSpace bundles.
DescribeWorkspaceDirectoriesResult	describeWorkspaceDirectories() Simplified method form for invoking the DescribeWorkspaceDirectories operation.
DescribeWorkspaceDirectoriesResult	describeWorkspaceDirectories(DescribeWorkspaceDirectoriesRequest request) Describes the available AWS Directory Service directories that are registered with Amazon WorkSpaces.
DescribeWorkspacesResult	describeWorkspaces() Simplified method form for invoking the DescribeWorkspaces operation.
DescribeWorkspacesResult	describeWorkspaces(DescribeWorkspacesRequest request) Describes the specified WorkSpaces.
DescribeWorkspacesConnectionStatusResult	describeWorkspacesConnectionStatus(DescribeWorkspacesConnectionStatusRequest request) Describes the connection status of the specified WorkSpaces.
ResponseMetadata	getCachedResponseMetadata(AmazonWebServiceRequest request) Returns additional metadata for a previously executed successful, request, typically used for debugging issues where a service isn't acting as expected.
ModifyWorkspacePropertiesResult	modifyWorkspaceProperties(ModifyWorkspacePropertiesRequest request) Modifies the specified WorkSpace properties.
RebootWorkspacesResult	rebootWorkspaces(RebootWorkspacesRequest request) Reboots the specified WorkSpaces.
RebuildWorkspacesResult	rebuildWorkspaces(RebuildWorkspacesRequest request) Rebuilds the specified WorkSpaces.
StartWorkspacesResult	startWorkspaces(StartWorkspacesRequest request) Starts the specified WorkSpaces.
StopWorkspacesResult	stopWorkspaces(StopWorkspacesRequest request) Stops the specified WorkSpaces.
TerminateWorkspacesResult	terminateWorkspaces(TerminateWorkspacesRequest request) Terminates the specified WorkSpaces.

Methods inherited from class com.amazonaws.AmazonWebServiceClient

addRequestHandler, addRequestHandler, configureRegion, getEndpointPrefix, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, shutdown, withEndpoint, withRegion, withRegion, withTimeOffset

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.amazonaws.services.workspaces.AmazonWorkspaces

setEndpoint, setRegion, shutdown

Constructor Detail

AmazonWorkspacesClient

@Deprecated
public AmazonWorkspacesClient()

Deprecated. use AmazonWorkspacesClientBuilder.defaultClient()

Constructs a new client to invoke service methods on Amazon WorkSpaces. A credentials provider chain will be used that searches for credentials in this order:

• Environment Variables - AWS_ACCESS_KEY_ID and AWS_SECRET_KEY
• Java System Properties - aws.accessKeyId and aws.secretKey
• Instance profile credentials delivered through the Amazon EC2 metadata service

All service calls made using this new client object are blocking, and will not return until the service call completes.

See Also:

DefaultAWSCredentialsProviderChain

AmazonWorkspacesClient

@Deprecated
public AmazonWorkspacesClient(ClientConfiguration clientConfiguration)

Deprecated. use AwsClientBuilder.withClientConfiguration(ClientConfiguration)

Constructs a new client to invoke service methods on Amazon WorkSpaces. A credentials provider chain will be used that searches for credentials in this order:

• Environment Variables - AWS_ACCESS_KEY_ID and AWS_SECRET_KEY
• Java System Properties - aws.accessKeyId and aws.secretKey
• Instance profile credentials delivered through the Amazon EC2 metadata service

All service calls made using this new client object are blocking, and will not return until the service call completes.

Parameters:

clientConfiguration - The client configuration options controlling how this client connects to Amazon WorkSpaces (ex: proxy settings, retry counts, etc.).

See Also:

DefaultAWSCredentialsProviderChain

AmazonWorkspacesClient

@Deprecated
public AmazonWorkspacesClient(AWSCredentials awsCredentials)

Deprecated. use AwsClientBuilder.withCredentials(AWSCredentialsProvider) for example: AmazonWorkspacesClientBuilder.standard().withCredentials(new AWSStaticCredentialsProvider(awsCredentials)).build();

Constructs a new client to invoke service methods on Amazon WorkSpaces using the specified AWS account credentials.

All service calls made using this new client object are blocking, and will not return until the service call completes.

Parameters:

awsCredentials - The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.

AmazonWorkspacesClient

@Deprecated
public AmazonWorkspacesClient(AWSCredentials awsCredentials,
                                          ClientConfiguration clientConfiguration)

Deprecated. use AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AwsClientBuilder.withClientConfiguration(ClientConfiguration)

Constructs a new client to invoke service methods on Amazon WorkSpaces using the specified AWS account credentials and client configuration options.

All service calls made using this new client object are blocking, and will not return until the service call completes.

Parameters:

awsCredentials - The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.

clientConfiguration - The client configuration options controlling how this client connects to Amazon WorkSpaces (ex: proxy settings, retry counts, etc.).

AmazonWorkspacesClient

@Deprecated
public AmazonWorkspacesClient(AWSCredentialsProvider awsCredentialsProvider)

Deprecated. use AwsClientBuilder.withCredentials(AWSCredentialsProvider)

Constructs a new client to invoke service methods on Amazon WorkSpaces using the specified AWS account credentials provider.

All service calls made using this new client object are blocking, and will not return until the service call completes.

Parameters:

awsCredentialsProvider - The AWS credentials provider which will provide credentials to authenticate requests with AWS services.

AmazonWorkspacesClient

@Deprecated
public AmazonWorkspacesClient(AWSCredentialsProvider awsCredentialsProvider,
                                          ClientConfiguration clientConfiguration)

Deprecated. use AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AwsClientBuilder.withClientConfiguration(ClientConfiguration)

Constructs a new client to invoke service methods on Amazon WorkSpaces using the specified AWS account credentials provider and client configuration options.

All service calls made using this new client object are blocking, and will not return until the service call completes.

Parameters:

awsCredentialsProvider - The AWS credentials provider which will provide credentials to authenticate requests with AWS services.

clientConfiguration - The client configuration options controlling how this client connects to Amazon WorkSpaces (ex: proxy settings, retry counts, etc.).

AmazonWorkspacesClient

@Deprecated
public AmazonWorkspacesClient(AWSCredentialsProvider awsCredentialsProvider,
                                          ClientConfiguration clientConfiguration,
                                          RequestMetricCollector requestMetricCollector)

Deprecated. use AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AwsClientBuilder.withClientConfiguration(ClientConfiguration) and AwsClientBuilder.withMetricsCollector(RequestMetricCollector)

Constructs a new client to invoke service methods on Amazon WorkSpaces using the specified AWS account credentials provider, client configuration options, and request metric collector.

All service calls made using this new client object are blocking, and will not return until the service call completes.

Parameters:

awsCredentialsProvider - The AWS credentials provider which will provide credentials to authenticate requests with AWS services.

clientConfiguration - The client configuration options controlling how this client connects to Amazon WorkSpaces (ex: proxy settings, retry counts, etc.).

requestMetricCollector - optional request metric collector

Method Detail

builder

public static AmazonWorkspacesClientBuilder builder()

createTags

public CreateTagsResult createTags(CreateTagsRequest request)

Creates tags for the specified WorkSpace.

Specified by:

createTags in interface AmazonWorkspaces

Parameters:

createTagsRequest -

Returns:

Result of the CreateTags operation returned by the service.

Throws:

ResourceNotFoundException - The resource could not be found.

InvalidParameterValuesException - One or more parameter values are not valid.

ResourceLimitExceededException - Your resource limits have been exceeded.

See Also:

AWS API Documentation

createWorkspaces

public CreateWorkspacesResult createWorkspaces(CreateWorkspacesRequest request)

Creates one or more WorkSpaces.

This operation is asynchronous and returns before the WorkSpaces are created.

Specified by:

createWorkspaces in interface AmazonWorkspaces

Parameters:

createWorkspacesRequest -

Returns:

Result of the CreateWorkspaces operation returned by the service.

Throws:

ResourceLimitExceededException - Your resource limits have been exceeded.

InvalidParameterValuesException - One or more parameter values are not valid.

See Also:

AWS API Documentation

deleteTags

public DeleteTagsResult deleteTags(DeleteTagsRequest request)

Deletes the specified tags from a WorkSpace.

Specified by:

deleteTags in interface AmazonWorkspaces

Parameters:

deleteTagsRequest -

Returns:

Result of the DeleteTags operation returned by the service.

Throws:

ResourceNotFoundException - The resource could not be found.

InvalidParameterValuesException - One or more parameter values are not valid.

See Also:

AWS API Documentation

describeTags

public DescribeTagsResult describeTags(DescribeTagsRequest request)

Describes the tags for the specified WorkSpace.

Specified by:

describeTags in interface AmazonWorkspaces

Parameters:

describeTagsRequest -

Returns:

Result of the DescribeTags operation returned by the service.

Throws:

ResourceNotFoundException - The resource could not be found.

See Also:

AWS API Documentation

describeWorkspaceBundles

public DescribeWorkspaceBundlesResult describeWorkspaceBundles(DescribeWorkspaceBundlesRequest request)

Describes the available WorkSpace bundles.

You can filter the results using either bundle ID or owner, but not both.

Specified by:

describeWorkspaceBundles in interface AmazonWorkspaces

Parameters:

describeWorkspaceBundlesRequest -

Returns:

Result of the DescribeWorkspaceBundles operation returned by the service.

Throws:

InvalidParameterValuesException - One or more parameter values are not valid.

See Also:

AWS API Documentation

describeWorkspaceBundles

public DescribeWorkspaceBundlesResult describeWorkspaceBundles()

Description copied from interface: AmazonWorkspaces

Simplified method form for invoking the DescribeWorkspaceBundles operation.

Specified by:

describeWorkspaceBundles in interface AmazonWorkspaces

See Also:

AmazonWorkspaces.describeWorkspaceBundles(DescribeWorkspaceBundlesRequest)

describeWorkspaceDirectories

public DescribeWorkspaceDirectoriesResult describeWorkspaceDirectories(DescribeWorkspaceDirectoriesRequest request)

Describes the available AWS Directory Service directories that are registered with Amazon WorkSpaces.

Specified by:

describeWorkspaceDirectories in interface AmazonWorkspaces

Parameters:

describeWorkspaceDirectoriesRequest -

Returns:

Result of the DescribeWorkspaceDirectories operation returned by the service.

Throws:

InvalidParameterValuesException - One or more parameter values are not valid.

See Also:

AWS API Documentation

describeWorkspaceDirectories

public DescribeWorkspaceDirectoriesResult describeWorkspaceDirectories()

Description copied from interface: AmazonWorkspaces

Simplified method form for invoking the DescribeWorkspaceDirectories operation.

Specified by:

describeWorkspaceDirectories in interface AmazonWorkspaces

See Also:

AmazonWorkspaces.describeWorkspaceDirectories(DescribeWorkspaceDirectoriesRequest)

describeWorkspaces

public DescribeWorkspacesResult describeWorkspaces(DescribeWorkspacesRequest request)

Describes the specified WorkSpaces.

You can filter the results using bundle ID, directory ID, or owner, but you can specify only one filter at a time.

Specified by:

describeWorkspaces in interface AmazonWorkspaces

Parameters:

describeWorkspacesRequest -

Returns:

Result of the DescribeWorkspaces operation returned by the service.

Throws:

InvalidParameterValuesException - One or more parameter values are not valid.

ResourceUnavailableException - The specified resource is not available.

See Also:

AWS API Documentation

describeWorkspaces

public DescribeWorkspacesResult describeWorkspaces()

Description copied from interface: AmazonWorkspaces

Simplified method form for invoking the DescribeWorkspaces operation.

Specified by:

describeWorkspaces in interface AmazonWorkspaces

See Also:

AmazonWorkspaces.describeWorkspaces(DescribeWorkspacesRequest)

describeWorkspacesConnectionStatus

public DescribeWorkspacesConnectionStatusResult describeWorkspacesConnectionStatus(DescribeWorkspacesConnectionStatusRequest request)

Describes the connection status of the specified WorkSpaces.

Specified by:

describeWorkspacesConnectionStatus in interface AmazonWorkspaces

Parameters:

describeWorkspacesConnectionStatusRequest -

Returns:

Result of the DescribeWorkspacesConnectionStatus operation returned by the service.

Throws:

InvalidParameterValuesException - One or more parameter values are not valid.

See Also:

AWS API Documentation

modifyWorkspaceProperties

public ModifyWorkspacePropertiesResult modifyWorkspaceProperties(ModifyWorkspacePropertiesRequest request)

Modifies the specified WorkSpace properties.

Specified by:

modifyWorkspaceProperties in interface AmazonWorkspaces

Parameters:

modifyWorkspacePropertiesRequest -

Returns:

Result of the ModifyWorkspaceProperties operation returned by the service.

Throws:

InvalidParameterValuesException - One or more parameter values are not valid.

InvalidResourceStateException - The state of the WorkSpace is not valid for this operation.

OperationInProgressException - The properties of this WorkSpace are currently being modified. Try again in a moment.

UnsupportedWorkspaceConfigurationException - The configuration of this WorkSpace is not supported for this operation. For more information, see the Amazon WorkSpaces Administration Guide.

ResourceNotFoundException - The resource could not be found.

AccessDeniedException - The user is not authorized to access a resource.

ResourceUnavailableException - The specified resource is not available.

See Also:

AWS API Documentation

rebootWorkspaces

public RebootWorkspacesResult rebootWorkspaces(RebootWorkspacesRequest request)

Reboots the specified WorkSpaces.

You cannot reboot a WorkSpace unless its state is AVAILABLE, IMPAIRED, or INOPERABLE.

This operation is asynchronous and returns before the WorkSpaces have rebooted.

Specified by:

rebootWorkspaces in interface AmazonWorkspaces

Parameters:

rebootWorkspacesRequest -

Returns:

Result of the RebootWorkspaces operation returned by the service.

See Also:

AWS API Documentation

rebuildWorkspaces

public RebuildWorkspacesResult rebuildWorkspaces(RebuildWorkspacesRequest request)

Rebuilds the specified WorkSpaces.

You cannot rebuild a WorkSpace unless its state is AVAILABLE or ERROR.

Rebuilding a WorkSpace is a potentially destructive action that can result in the loss of data. For more information, see Rebuild a WorkSpace.

This operation is asynchronous and returns before the WorkSpaces have been completely rebuilt.

Specified by:

rebuildWorkspaces in interface AmazonWorkspaces

Parameters:

rebuildWorkspacesRequest -

Returns:

Result of the RebuildWorkspaces operation returned by the service.

See Also:

AWS API Documentation

startWorkspaces

public StartWorkspacesResult startWorkspaces(StartWorkspacesRequest request)

Starts the specified WorkSpaces.

You cannot start a WorkSpace unless it has a running mode of AutoStop and a state of STOPPED.

Specified by:

startWorkspaces in interface AmazonWorkspaces

Parameters:

startWorkspacesRequest -

Returns:

Result of the StartWorkspaces operation returned by the service.

See Also:

AWS API Documentation

stopWorkspaces

public StopWorkspacesResult stopWorkspaces(StopWorkspacesRequest request)

Stops the specified WorkSpaces.

You cannot stop a WorkSpace unless it has a running mode of AutoStop and a state of AVAILABLE, IMPAIRED, UNHEALTHY, or ERROR.

Specified by:

stopWorkspaces in interface AmazonWorkspaces

Parameters:

stopWorkspacesRequest -

Returns:

Result of the StopWorkspaces operation returned by the service.

See Also:

AWS API Documentation

terminateWorkspaces

public TerminateWorkspacesResult terminateWorkspaces(TerminateWorkspacesRequest request)

Terminates the specified WorkSpaces.

Terminating a WorkSpace is a permanent action and cannot be undone. The user's data is destroyed. If you need to archive any user data, contact Amazon Web Services before terminating the WorkSpace.

You can terminate a WorkSpace that is in any state except SUSPENDED.

This operation is asynchronous and returns before the WorkSpaces have been completely terminated.

Specified by:

terminateWorkspaces in interface AmazonWorkspaces

Parameters:

terminateWorkspacesRequest -

Returns:

Result of the TerminateWorkspaces operation returned by the service.

See Also:

AWS API Documentation

getCachedResponseMetadata

public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)

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

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

Specified by:

getCachedResponseMetadata in interface AmazonWorkspaces

Parameters:

request - The originally executed request

Returns:

The response metadata for the specified request, or null if none is available.