@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public interface AmazonWorkspaces
Note: Do not directly implement this interface, new methods are added to it regularly. Extend from
AbstractAmazonWorkspaces
instead.
Amazon WorkSpaces enables you to provision virtual, cloud-based Microsoft Windows and Amazon Linux desktops for your users.
Modifier and Type | Field and Description |
---|---|
static String |
ENDPOINT_PREFIX
The region metadata service name for computing region endpoints.
|
Modifier and Type | Method and Description |
---|---|
AssociateIpGroupsResult |
associateIpGroups(AssociateIpGroupsRequest associateIpGroupsRequest)
Associates the specified IP access control group with the specified directory.
|
AuthorizeIpRulesResult |
authorizeIpRules(AuthorizeIpRulesRequest authorizeIpRulesRequest)
Adds one or more rules to the specified IP access control group.
|
CreateIpGroupResult |
createIpGroup(CreateIpGroupRequest createIpGroupRequest)
Creates an IP access control group.
|
CreateTagsResult |
createTags(CreateTagsRequest createTagsRequest)
Creates the specified tags for the specified WorkSpaces resource.
|
CreateWorkspacesResult |
createWorkspaces(CreateWorkspacesRequest createWorkspacesRequest)
Creates one or more WorkSpaces.
|
DeleteIpGroupResult |
deleteIpGroup(DeleteIpGroupRequest deleteIpGroupRequest)
Deletes the specified IP access control group.
|
DeleteTagsResult |
deleteTags(DeleteTagsRequest deleteTagsRequest)
Deletes the specified tags from the specified WorkSpaces resource.
|
DeleteWorkspaceImageResult |
deleteWorkspaceImage(DeleteWorkspaceImageRequest deleteWorkspaceImageRequest)
Deletes the specified image from your account.
|
DescribeAccountResult |
describeAccount(DescribeAccountRequest describeAccountRequest)
Retrieves a list that describes the configuration of bring your own license (BYOL) for the specified account.
|
DescribeAccountModificationsResult |
describeAccountModifications(DescribeAccountModificationsRequest describeAccountModificationsRequest)
Retrieves a list that describes modifications to the configuration of bring your own license (BYOL) for the
specified account.
|
DescribeClientPropertiesResult |
describeClientProperties(DescribeClientPropertiesRequest describeClientPropertiesRequest)
Retrieves a list that describes one or more specified Amazon WorkSpaces clients.
|
DescribeIpGroupsResult |
describeIpGroups(DescribeIpGroupsRequest describeIpGroupsRequest)
Describes one or more of your IP access control groups.
|
DescribeTagsResult |
describeTags(DescribeTagsRequest describeTagsRequest)
Describes the specified tags for the specified WorkSpaces resource.
|
DescribeWorkspaceBundlesResult |
describeWorkspaceBundles()
Simplified method form for invoking the DescribeWorkspaceBundles operation.
|
DescribeWorkspaceBundlesResult |
describeWorkspaceBundles(DescribeWorkspaceBundlesRequest describeWorkspaceBundlesRequest)
Retrieves a list that describes the available WorkSpace bundles.
|
DescribeWorkspaceDirectoriesResult |
describeWorkspaceDirectories()
Simplified method form for invoking the DescribeWorkspaceDirectories operation.
|
DescribeWorkspaceDirectoriesResult |
describeWorkspaceDirectories(DescribeWorkspaceDirectoriesRequest describeWorkspaceDirectoriesRequest)
Describes the available AWS Directory Service directories that are registered with Amazon WorkSpaces.
|
DescribeWorkspaceImagesResult |
describeWorkspaceImages(DescribeWorkspaceImagesRequest describeWorkspaceImagesRequest)
Retrieves a list that describes one or more specified images, if the image identifiers are provided.
|
DescribeWorkspacesResult |
describeWorkspaces()
Simplified method form for invoking the DescribeWorkspaces operation.
|
DescribeWorkspacesResult |
describeWorkspaces(DescribeWorkspacesRequest describeWorkspacesRequest)
Describes the specified WorkSpaces.
|
DescribeWorkspacesConnectionStatusResult |
describeWorkspacesConnectionStatus(DescribeWorkspacesConnectionStatusRequest describeWorkspacesConnectionStatusRequest)
Describes the connection status of the specified WorkSpaces.
|
DisassociateIpGroupsResult |
disassociateIpGroups(DisassociateIpGroupsRequest disassociateIpGroupsRequest)
Disassociates the specified IP access control group from the specified directory.
|
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.
|
ImportWorkspaceImageResult |
importWorkspaceImage(ImportWorkspaceImageRequest importWorkspaceImageRequest)
Imports the specified Windows 7 or Windows 10 bring your own license (BYOL) image into Amazon WorkSpaces.
|
ListAvailableManagementCidrRangesResult |
listAvailableManagementCidrRanges(ListAvailableManagementCidrRangesRequest listAvailableManagementCidrRangesRequest)
Retrieves a list of IP address ranges, specified as IPv4 CIDR blocks, that you can use for the network management
interface when you enable bring your own license (BYOL).
|
ModifyAccountResult |
modifyAccount(ModifyAccountRequest modifyAccountRequest)
Modifies the configuration of bring your own license (BYOL) for the specified account.
|
ModifyClientPropertiesResult |
modifyClientProperties(ModifyClientPropertiesRequest modifyClientPropertiesRequest)
Modifies the properties of the specified Amazon WorkSpaces clients.
|
ModifyWorkspacePropertiesResult |
modifyWorkspaceProperties(ModifyWorkspacePropertiesRequest modifyWorkspacePropertiesRequest)
Modifies the specified WorkSpace properties.
|
ModifyWorkspaceStateResult |
modifyWorkspaceState(ModifyWorkspaceStateRequest modifyWorkspaceStateRequest)
Sets the state of the specified WorkSpace.
|
RebootWorkspacesResult |
rebootWorkspaces(RebootWorkspacesRequest rebootWorkspacesRequest)
Reboots the specified WorkSpaces.
|
RebuildWorkspacesResult |
rebuildWorkspaces(RebuildWorkspacesRequest rebuildWorkspacesRequest)
Rebuilds the specified WorkSpace.
|
RevokeIpRulesResult |
revokeIpRules(RevokeIpRulesRequest revokeIpRulesRequest)
Removes one or more rules from the specified IP access control group.
|
void |
setEndpoint(String endpoint)
Deprecated.
use
AwsClientBuilder#setEndpointConfiguration(AwsClientBuilder.EndpointConfiguration) for
example:
builder.setEndpointConfiguration(new EndpointConfiguration(endpoint, signingRegion)); |
void |
setRegion(Region region)
Deprecated.
use
AwsClientBuilder#setRegion(String) |
void |
shutdown()
Shuts down this client object, releasing any resources that might be held open.
|
StartWorkspacesResult |
startWorkspaces(StartWorkspacesRequest startWorkspacesRequest)
Starts the specified WorkSpaces.
|
StopWorkspacesResult |
stopWorkspaces(StopWorkspacesRequest stopWorkspacesRequest)
Stops the specified WorkSpaces.
|
TerminateWorkspacesResult |
terminateWorkspaces(TerminateWorkspacesRequest terminateWorkspacesRequest)
Terminates the specified WorkSpaces.
|
UpdateRulesOfIpGroupResult |
updateRulesOfIpGroup(UpdateRulesOfIpGroupRequest updateRulesOfIpGroupRequest)
Replaces the current rules of the specified IP access control group with the specified rules.
|
static final String ENDPOINT_PREFIX
@Deprecated void setEndpoint(String endpoint)
AwsClientBuilder#setEndpointConfiguration(AwsClientBuilder.EndpointConfiguration)
for
example:
builder.setEndpointConfiguration(new EndpointConfiguration(endpoint, signingRegion));
Callers can pass in just the endpoint (ex: "workspaces.us-east-1.amazonaws.com") or a full URL, including the
protocol (ex: "https://workspaces.us-east-1.amazonaws.com"). If the protocol is not specified here, the default
protocol from this client's ClientConfiguration
will be used, which by default is HTTPS.
For more information on using AWS regions with the AWS SDK for Java, and a complete list of all available endpoints for all AWS services, see: https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-region-selection.html#region-selection- choose-endpoint
This method is not threadsafe. An endpoint should be configured when the client is created and before any service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit or retrying.
endpoint
- The endpoint (ex: "workspaces.us-east-1.amazonaws.com") or a full URL, including the protocol (ex:
"https://workspaces.us-east-1.amazonaws.com") of the region specific AWS endpoint this client will
communicate with.@Deprecated void setRegion(Region region)
AwsClientBuilder#setRegion(String)
setEndpoint(String)
, sets the regional endpoint for this client's
service calls. Callers can use this method to control which AWS region they want to work with.
By default, all service endpoints in all regions use the https protocol. To use http instead, specify it in the
ClientConfiguration
supplied at construction.
This method is not threadsafe. A region should be configured when the client is created and before any service requests are made. Changing it afterwards creates inevitable race conditions for any service requests in transit or retrying.
region
- The region this client will communicate with. See Region.getRegion(com.amazonaws.regions.Regions)
for accessing a given region. Must not be null and must be a region where the service is available.Region.getRegion(com.amazonaws.regions.Regions)
,
Region.createClient(Class, com.amazonaws.auth.AWSCredentialsProvider, ClientConfiguration)
,
Region.isServiceSupported(String)
AssociateIpGroupsResult associateIpGroups(AssociateIpGroupsRequest associateIpGroupsRequest)
Associates the specified IP access control group with the specified directory.
associateIpGroupsRequest
- InvalidParameterValuesException
- One or more parameter values are not valid.ResourceNotFoundException
- The resource could not be found.ResourceLimitExceededException
- Your resource limits have been exceeded.InvalidResourceStateException
- The state of the resource is not valid for this operation.AccessDeniedException
- The user is not authorized to access a resource.OperationNotSupportedException
- This operation is not supported.AuthorizeIpRulesResult authorizeIpRules(AuthorizeIpRulesRequest authorizeIpRulesRequest)
Adds one or more rules to the specified IP access control group.
This action gives users permission to access their WorkSpaces from the CIDR address ranges specified in the rules.
authorizeIpRulesRequest
- InvalidParameterValuesException
- One or more parameter values are not valid.ResourceNotFoundException
- The resource could not be found.ResourceLimitExceededException
- Your resource limits have been exceeded.InvalidResourceStateException
- The state of the resource is not valid for this operation.AccessDeniedException
- The user is not authorized to access a resource.CreateIpGroupResult createIpGroup(CreateIpGroupRequest createIpGroupRequest)
Creates an IP access control group.
An IP access control group provides you with the ability to control the IP addresses from which users are allowed to access their WorkSpaces. To specify the CIDR address ranges, add rules to your IP access control group and then associate the group with your directory. You can add rules when you create the group or at any time using AuthorizeIpRules.
There is a default IP access control group associated with your directory. If you don't associate an IP access control group with your directory, the default group is used. The default group includes a default rule that allows users to access their WorkSpaces from anywhere. You cannot modify the default IP access control group for your directory.
createIpGroupRequest
- InvalidParameterValuesException
- One or more parameter values are not valid.ResourceLimitExceededException
- Your resource limits have been exceeded.ResourceAlreadyExistsException
- The specified resource already exists.ResourceCreationFailedException
- The resource could not be created.AccessDeniedException
- The user is not authorized to access a resource.CreateTagsResult createTags(CreateTagsRequest createTagsRequest)
Creates the specified tags for the specified WorkSpaces resource.
createTagsRequest
- ResourceNotFoundException
- The resource could not be found.InvalidParameterValuesException
- One or more parameter values are not valid.ResourceLimitExceededException
- Your resource limits have been exceeded.CreateWorkspacesResult createWorkspaces(CreateWorkspacesRequest createWorkspacesRequest)
Creates one or more WorkSpaces.
This operation is asynchronous and returns before the WorkSpaces are created.
createWorkspacesRequest
- ResourceLimitExceededException
- Your resource limits have been exceeded.InvalidParameterValuesException
- One or more parameter values are not valid.DeleteIpGroupResult deleteIpGroup(DeleteIpGroupRequest deleteIpGroupRequest)
Deletes the specified IP access control group.
You cannot delete an IP access control group that is associated with a directory.
deleteIpGroupRequest
- InvalidParameterValuesException
- One or more parameter values are not valid.ResourceNotFoundException
- The resource could not be found.ResourceAssociatedException
- The resource is associated with a directory.AccessDeniedException
- The user is not authorized to access a resource.DeleteTagsResult deleteTags(DeleteTagsRequest deleteTagsRequest)
Deletes the specified tags from the specified WorkSpaces resource.
deleteTagsRequest
- ResourceNotFoundException
- The resource could not be found.InvalidParameterValuesException
- One or more parameter values are not valid.DeleteWorkspaceImageResult deleteWorkspaceImage(DeleteWorkspaceImageRequest deleteWorkspaceImageRequest)
Deletes the specified image from your account. To delete an image, you must first delete any bundles that are associated with the image.
deleteWorkspaceImageRequest
- ResourceAssociatedException
- The resource is associated with a directory.InvalidResourceStateException
- The state of the resource is not valid for this operation.AccessDeniedException
- The user is not authorized to access a resource.DescribeAccountResult describeAccount(DescribeAccountRequest describeAccountRequest)
Retrieves a list that describes the configuration of bring your own license (BYOL) for the specified account.
describeAccountRequest
- AccessDeniedException
- The user is not authorized to access a resource.DescribeAccountModificationsResult describeAccountModifications(DescribeAccountModificationsRequest describeAccountModificationsRequest)
Retrieves a list that describes modifications to the configuration of bring your own license (BYOL) for the specified account.
describeAccountModificationsRequest
- AccessDeniedException
- The user is not authorized to access a resource.DescribeClientPropertiesResult describeClientProperties(DescribeClientPropertiesRequest describeClientPropertiesRequest)
Retrieves a list that describes one or more specified Amazon WorkSpaces clients.
describeClientPropertiesRequest
- InvalidParameterValuesException
- One or more parameter values are not valid.ResourceNotFoundException
- The resource could not be found.AccessDeniedException
- The user is not authorized to access a resource.DescribeIpGroupsResult describeIpGroups(DescribeIpGroupsRequest describeIpGroupsRequest)
Describes one or more of your IP access control groups.
describeIpGroupsRequest
- InvalidParameterValuesException
- One or more parameter values are not valid.AccessDeniedException
- The user is not authorized to access a resource.DescribeTagsResult describeTags(DescribeTagsRequest describeTagsRequest)
Describes the specified tags for the specified WorkSpaces resource.
describeTagsRequest
- ResourceNotFoundException
- The resource could not be found.DescribeWorkspaceBundlesResult describeWorkspaceBundles(DescribeWorkspaceBundlesRequest describeWorkspaceBundlesRequest)
Retrieves a list that describes the available WorkSpace bundles.
You can filter the results using either bundle ID or owner, but not both.
describeWorkspaceBundlesRequest
- InvalidParameterValuesException
- One or more parameter values are not valid.DescribeWorkspaceBundlesResult describeWorkspaceBundles()
DescribeWorkspaceDirectoriesResult describeWorkspaceDirectories(DescribeWorkspaceDirectoriesRequest describeWorkspaceDirectoriesRequest)
Describes the available AWS Directory Service directories that are registered with Amazon WorkSpaces.
describeWorkspaceDirectoriesRequest
- InvalidParameterValuesException
- One or more parameter values are not valid.DescribeWorkspaceDirectoriesResult describeWorkspaceDirectories()
DescribeWorkspaceImagesResult describeWorkspaceImages(DescribeWorkspaceImagesRequest describeWorkspaceImagesRequest)
Retrieves a list that describes one or more specified images, if the image identifiers are provided. Otherwise, all images in the account are described.
describeWorkspaceImagesRequest
- AccessDeniedException
- The user is not authorized to access a resource.DescribeWorkspacesResult describeWorkspaces(DescribeWorkspacesRequest describeWorkspacesRequest)
Describes the specified WorkSpaces.
You can filter the results by using the bundle identifier, directory identifier, or owner, but you can specify only one filter at a time.
describeWorkspacesRequest
- InvalidParameterValuesException
- One or more parameter values are not valid.ResourceUnavailableException
- The specified resource is not available.DescribeWorkspacesResult describeWorkspaces()
DescribeWorkspacesConnectionStatusResult describeWorkspacesConnectionStatus(DescribeWorkspacesConnectionStatusRequest describeWorkspacesConnectionStatusRequest)
Describes the connection status of the specified WorkSpaces.
describeWorkspacesConnectionStatusRequest
- InvalidParameterValuesException
- One or more parameter values are not valid.DisassociateIpGroupsResult disassociateIpGroups(DisassociateIpGroupsRequest disassociateIpGroupsRequest)
Disassociates the specified IP access control group from the specified directory.
disassociateIpGroupsRequest
- InvalidParameterValuesException
- One or more parameter values are not valid.ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The state of the resource is not valid for this operation.AccessDeniedException
- The user is not authorized to access a resource.ImportWorkspaceImageResult importWorkspaceImage(ImportWorkspaceImageRequest importWorkspaceImageRequest)
Imports the specified Windows 7 or Windows 10 bring your own license (BYOL) image into Amazon WorkSpaces. The image must be an already licensed EC2 image that is in your AWS account, and you must own the image.
importWorkspaceImageRequest
- ResourceLimitExceededException
- Your resource limits have been exceeded.ResourceAlreadyExistsException
- The specified resource already exists.ResourceNotFoundException
- The resource could not be found.OperationNotSupportedException
- This operation is not supported.AccessDeniedException
- The user is not authorized to access a resource.InvalidParameterValuesException
- One or more parameter values are not valid.ListAvailableManagementCidrRangesResult listAvailableManagementCidrRanges(ListAvailableManagementCidrRangesRequest listAvailableManagementCidrRangesRequest)
Retrieves a list of IP address ranges, specified as IPv4 CIDR blocks, that you can use for the network management interface when you enable bring your own license (BYOL).
The management network interface is connected to a secure Amazon WorkSpaces management network. It is used for interactive streaming of the WorkSpace desktop to Amazon WorkSpaces clients, and to allow Amazon WorkSpaces to manage the WorkSpace.
listAvailableManagementCidrRangesRequest
- InvalidParameterValuesException
- One or more parameter values are not valid.AccessDeniedException
- The user is not authorized to access a resource.ModifyAccountResult modifyAccount(ModifyAccountRequest modifyAccountRequest)
Modifies the configuration of bring your own license (BYOL) for the specified account.
modifyAccountRequest
- InvalidParameterValuesException
- One or more parameter values are not valid.AccessDeniedException
- The user is not authorized to access a resource.InvalidResourceStateException
- The state of the resource is not valid for this operation.ResourceUnavailableException
- The specified resource is not available.ResourceNotFoundException
- The resource could not be found.ModifyClientPropertiesResult modifyClientProperties(ModifyClientPropertiesRequest modifyClientPropertiesRequest)
Modifies the properties of the specified Amazon WorkSpaces clients.
modifyClientPropertiesRequest
- InvalidParameterValuesException
- One or more parameter values are not valid.ResourceNotFoundException
- The resource could not be found.AccessDeniedException
- The user is not authorized to access a resource.ModifyWorkspacePropertiesResult modifyWorkspaceProperties(ModifyWorkspacePropertiesRequest modifyWorkspacePropertiesRequest)
Modifies the specified WorkSpace properties.
modifyWorkspacePropertiesRequest
- InvalidParameterValuesException
- One or more parameter values are not valid.InvalidResourceStateException
- The state of the resource 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.ModifyWorkspaceStateResult modifyWorkspaceState(ModifyWorkspaceStateRequest modifyWorkspaceStateRequest)
Sets the state of the specified WorkSpace.
To maintain a WorkSpace without being interrupted, set the WorkSpace state to ADMIN_MAINTENANCE
.
WorkSpaces in this state do not respond to requests to reboot, stop, start, or rebuild. An AutoStop WorkSpace in
this state is not stopped. Users can log into a WorkSpace in the ADMIN_MAINTENANCE
state.
modifyWorkspaceStateRequest
- InvalidParameterValuesException
- One or more parameter values are not valid.InvalidResourceStateException
- The state of the resource is not valid for this operation.ResourceNotFoundException
- The resource could not be found.RebootWorkspacesResult rebootWorkspaces(RebootWorkspacesRequest rebootWorkspacesRequest)
Reboots the specified WorkSpaces.
You cannot reboot a WorkSpace unless its state is AVAILABLE
or UNHEALTHY
.
This operation is asynchronous and returns before the WorkSpaces have rebooted.
rebootWorkspacesRequest
- RebuildWorkspacesResult rebuildWorkspaces(RebuildWorkspacesRequest rebuildWorkspacesRequest)
Rebuilds the specified WorkSpace.
You cannot rebuild a WorkSpace unless its state is AVAILABLE
, ERROR
, or
UNHEALTHY
.
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.
rebuildWorkspacesRequest
- RevokeIpRulesResult revokeIpRules(RevokeIpRulesRequest revokeIpRulesRequest)
Removes one or more rules from the specified IP access control group.
revokeIpRulesRequest
- InvalidParameterValuesException
- One or more parameter values are not valid.ResourceNotFoundException
- The resource could not be found.InvalidResourceStateException
- The state of the resource is not valid for this operation.AccessDeniedException
- The user is not authorized to access a resource.StartWorkspacesResult startWorkspaces(StartWorkspacesRequest startWorkspacesRequest)
Starts the specified WorkSpaces.
You cannot start a WorkSpace unless it has a running mode of AutoStop
and a state of
STOPPED
.
startWorkspacesRequest
- StopWorkspacesResult stopWorkspaces(StopWorkspacesRequest stopWorkspacesRequest)
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
.
stopWorkspacesRequest
- TerminateWorkspacesResult terminateWorkspaces(TerminateWorkspacesRequest terminateWorkspacesRequest)
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.
terminateWorkspacesRequest
- UpdateRulesOfIpGroupResult updateRulesOfIpGroup(UpdateRulesOfIpGroupRequest updateRulesOfIpGroupRequest)
Replaces the current rules of the specified IP access control group with the specified rules.
updateRulesOfIpGroupRequest
- InvalidParameterValuesException
- One or more parameter values are not valid.ResourceNotFoundException
- The resource could not be found.ResourceLimitExceededException
- Your resource limits have been exceeded.InvalidResourceStateException
- The state of the resource is not valid for this operation.AccessDeniedException
- The user is not authorized to access a resource.void shutdown()
ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.
request
- The originally executed request.Copyright © 2013 Amazon Web Services, Inc. All Rights Reserved.