Struct aws_sdk_workspaces::Client

pub struct Client { /* private fields */ }

Client for Amazon WorkSpaces

Client for invoking operations on Amazon WorkSpaces. Each operation on Amazon WorkSpaces is a method on this this struct. .send() MUST be invoked on the generated operations to dispatch the request to the service.

Constructing a Client

A Config is required to construct a client. For most use cases, the aws-config crate should be used to automatically resolve this config using aws_config::load_from_env(), since this will resolve an SdkConfig which can be shared across multiple different AWS SDK clients. This config resolution process can be customized by calling aws_config::from_env() instead, which returns a ConfigLoader that uses the builder pattern to customize the default config.

In the simplest case, creating a client looks as follows:

let config = ::aws_config::load_from_env().await;
let client = aws_sdk_workspaces::Client::new(&config);

Occasionally, SDKs may have additional service-specific that can be set on the Config that is absent from SdkConfig, or slightly different settings for a specific client may be desired. The Config struct implements From<&SdkConfig>, so setting these specific settings can be done as follows:

let sdk_config = ::aws_config::load_from_env().await;
let config = aws_sdk_workspaces::config::Builder::from(&sdk_config)
    .some_service_specific_setting("value")
    .build();

See the aws-config docs and Config for more information on customizing configuration.

Note: Client construction is expensive due to connection thread pool initialization, and should be done once at application start-up.

Using the Client

A client has a function for every operation that can be performed by the service. For example, the AssociateConnectionAlias operation has a Client::associate_connection_alias, function which returns a builder for that operation. The fluent builder ultimately has a send() function that returns an async future that returns a result, as illustrated below:

let result = client.associate_connection_alias()
    .alias_id("example")
    .send()
    .await;

The underlying HTTP requests that get made by this can be modified with the customize_operation function on the fluent builder. See the customize module for more information.

Implementations

impl Client

pub fn associate_connection_alias( &self ) -> AssociateConnectionAliasFluentBuilder

Constructs a fluent builder for the AssociateConnectionAlias operation.

• The fluent builder is configurable:
  • alias_id(impl ::std::convert::Into<String>) / set_alias_id(Option<String>):

    The identifier of the connection alias.

  • resource_id(impl ::std::convert::Into<String>) / set_resource_id(Option<String>):

    The identifier of the directory to associate the connection alias with.

• On success, responds with AssociateConnectionAliasOutput with field(s):
  • connection_identifier(Option<String>):

    The identifier of the connection alias association. You use the connection identifier in the DNS TXT record when you’re configuring your DNS routing policies.

• On failure, responds with SdkError<AssociateConnectionAliasError>

impl Client

pub fn associate_ip_groups(&self) -> AssociateIpGroupsFluentBuilder

Constructs a fluent builder for the AssociateIpGroups operation.

• The fluent builder is configurable:
  • directory_id(impl ::std::convert::Into<String>) / set_directory_id(Option<String>):

    The identifier of the directory.

  • group_ids(Vec<String>) / set_group_ids(Option<Vec<String>>):

    The identifiers of one or more IP access control groups.

• On success, responds with AssociateIpGroupsOutput
• On failure, responds with SdkError<AssociateIpGroupsError>

impl Client

pub fn authorize_ip_rules(&self) -> AuthorizeIpRulesFluentBuilder

Constructs a fluent builder for the AuthorizeIpRules operation.

• The fluent builder is configurable:
  • group_id(impl ::std::convert::Into<String>) / set_group_id(Option<String>):

    The identifier of the group.

  • user_rules(Vec<IpRuleItem>) / set_user_rules(Option<Vec<IpRuleItem>>):

    The rules to add to the group.

• On success, responds with AuthorizeIpRulesOutput
• On failure, responds with SdkError<AuthorizeIpRulesError>

impl Client

pub fn copy_workspace_image(&self) -> CopyWorkspaceImageFluentBuilder

Constructs a fluent builder for the CopyWorkspaceImage operation.

• The fluent builder is configurable:
  • name(impl ::std::convert::Into<String>) / set_name(Option<String>):

    The name of the image.

  • description(impl ::std::convert::Into<String>) / set_description(Option<String>):

    A description of the image.

  • source_image_id(impl ::std::convert::Into<String>) / set_source_image_id(Option<String>):

    The identifier of the source image.

  • source_region(impl ::std::convert::Into<String>) / set_source_region(Option<String>):

    The identifier of the source Region.

  • tags(Vec<Tag>) / set_tags(Option<Vec<Tag>>):

    The tags for the image.

• On success, responds with CopyWorkspaceImageOutput with field(s):
  • image_id(Option<String>):

    The identifier of the image.

• On failure, responds with SdkError<CopyWorkspaceImageError>

impl Client

pub fn create_connect_client_add_in( &self ) -> CreateConnectClientAddInFluentBuilder

Constructs a fluent builder for the CreateConnectClientAddIn operation.

• The fluent builder is configurable:
  • resource_id(impl ::std::convert::Into<String>) / set_resource_id(Option<String>):

    The directory identifier for which to configure the client add-in.

  • name(impl ::std::convert::Into<String>) / set_name(Option<String>):

    The name of the client add-in.

  • url(impl ::std::convert::Into<String>) / set_url(Option<String>):

    The endpoint URL of the Amazon Connect client add-in.

• On success, responds with CreateConnectClientAddInOutput with field(s):
  • add_in_id(Option<String>):

    The client add-in identifier.

• On failure, responds with SdkError<CreateConnectClientAddInError>

impl Client

pub fn create_connection_alias(&self) -> CreateConnectionAliasFluentBuilder

Constructs a fluent builder for the CreateConnectionAlias operation.

• The fluent builder is configurable:
  • connection_string(impl ::std::convert::Into<String>) / set_connection_string(Option<String>):

    A connection string in the form of a fully qualified domain name (FQDN), such as www.example.com.

    After you create a connection string, it is always associated to your Amazon Web Services account. You cannot recreate the same connection string with a different account, even if you delete all instances of it from the original account. The connection string is globally reserved for your account.

  • tags(Vec<Tag>) / set_tags(Option<Vec<Tag>>):

    The tags to associate with the connection alias.

• On success, responds with CreateConnectionAliasOutput with field(s):
  • alias_id(Option<String>):

    The identifier of the connection alias.

• On failure, responds with SdkError<CreateConnectionAliasError>

impl Client

pub fn create_ip_group(&self) -> CreateIpGroupFluentBuilder

Constructs a fluent builder for the CreateIpGroup operation.

• The fluent builder is configurable:
  • group_name(impl ::std::convert::Into<String>) / set_group_name(Option<String>):

    The name of the group.

  • group_desc(impl ::std::convert::Into<String>) / set_group_desc(Option<String>):

    The description of the group.

  • user_rules(Vec<IpRuleItem>) / set_user_rules(Option<Vec<IpRuleItem>>):

    The rules to add to the group.

  • tags(Vec<Tag>) / set_tags(Option<Vec<Tag>>):

    The tags. Each WorkSpaces resource can have a maximum of 50 tags.

• On success, responds with CreateIpGroupOutput with field(s):
  • group_id(Option<String>):

    The identifier of the group.

• On failure, responds with SdkError<CreateIpGroupError>

impl Client

pub fn create_standby_workspaces(&self) -> CreateStandbyWorkspacesFluentBuilder

Constructs a fluent builder for the CreateStandbyWorkspaces operation.

• The fluent builder is configurable:
  • primary_region(impl ::std::convert::Into<String>) / set_primary_region(Option<String>):

    The Region of the primary WorkSpace.

  • standby_workspaces(Vec<StandbyWorkspace>) / set_standby_workspaces(Option<Vec<StandbyWorkspace>>):

    Information about the standby WorkSpace to be created.

• On success, responds with CreateStandbyWorkspacesOutput with field(s):
  • failed_standby_requests(Option<Vec<FailedCreateStandbyWorkspacesRequest>>):

    Information about the standby WorkSpace that could not be created.

  • pending_standby_requests(Option<Vec<PendingCreateStandbyWorkspacesRequest>>):

    Information about the standby WorkSpace that was created.

• On failure, responds with SdkError<CreateStandbyWorkspacesError>

impl Client

pub fn create_tags(&self) -> CreateTagsFluentBuilder

Constructs a fluent builder for the CreateTags operation.

• The fluent builder is configurable:
  • resource_id(impl ::std::convert::Into<String>) / set_resource_id(Option<String>):

    The identifier of the WorkSpaces resource. The supported resource types are WorkSpaces, registered directories, images, custom bundles, IP access control groups, and connection aliases.

  • tags(Vec<Tag>) / set_tags(Option<Vec<Tag>>):

    The tags. Each WorkSpaces resource can have a maximum of 50 tags.

• On success, responds with CreateTagsOutput
• On failure, responds with SdkError<CreateTagsError>

impl Client

pub fn create_updated_workspace_image( &self ) -> CreateUpdatedWorkspaceImageFluentBuilder

Constructs a fluent builder for the CreateUpdatedWorkspaceImage operation.

• The fluent builder is configurable:
  • name(impl ::std::convert::Into<String>) / set_name(Option<String>):

    The name of the new updated WorkSpace image.

  • description(impl ::std::convert::Into<String>) / set_description(Option<String>):

    A description of whether updates for the WorkSpace image are available.

  • source_image_id(impl ::std::convert::Into<String>) / set_source_image_id(Option<String>):

    The identifier of the source WorkSpace image.

  • tags(Vec<Tag>) / set_tags(Option<Vec<Tag>>):

    The tags that you want to add to the new updated WorkSpace image.

    To add tags at the same time when you’re creating the updated image, you must create an IAM policy that grants your IAM user permissions to use workspaces:CreateTags.

• On success, responds with CreateUpdatedWorkspaceImageOutput with field(s):
  • image_id(Option<String>):

    The identifier of the new updated WorkSpace image.

• On failure, responds with SdkError<CreateUpdatedWorkspaceImageError>

impl Client

pub fn create_workspace_bundle(&self) -> CreateWorkspaceBundleFluentBuilder

Constructs a fluent builder for the CreateWorkspaceBundle operation.

• The fluent builder is configurable:
  • bundle_name(impl ::std::convert::Into<String>) / set_bundle_name(Option<String>):

    The name of the bundle.

  • bundle_description(impl ::std::convert::Into<String>) / set_bundle_description(Option<String>):

    The description of the bundle.

  • image_id(impl ::std::convert::Into<String>) / set_image_id(Option<String>):

    The identifier of the image that is used to create the bundle.

  • compute_type(ComputeType) / set_compute_type(Option<ComputeType>):

    Describes the compute type of the bundle.

  • user_storage(UserStorage) / set_user_storage(Option<UserStorage>):

    Describes the user volume for a WorkSpace bundle.

  • root_storage(RootStorage) / set_root_storage(Option<RootStorage>):

    Describes the root volume for a WorkSpace bundle.

  • tags(Vec<Tag>) / set_tags(Option<Vec<Tag>>):

    The tags associated with the bundle.

    To add tags at the same time when you’re creating the bundle, you must create an IAM policy that grants your IAM user permissions to use workspaces:CreateTags.

• On success, responds with CreateWorkspaceBundleOutput with field(s):
  • workspace_bundle(Option<WorkspaceBundle>):

    Describes a WorkSpace bundle.

• On failure, responds with SdkError<CreateWorkspaceBundleError>

impl Client

pub fn create_workspace_image(&self) -> CreateWorkspaceImageFluentBuilder

Constructs a fluent builder for the CreateWorkspaceImage operation.

• The fluent builder is configurable:
  • name(impl ::std::convert::Into<String>) / set_name(Option<String>):

    The name of the new WorkSpace image.

  • description(impl ::std::convert::Into<String>) / set_description(Option<String>):

    The description of the new WorkSpace image.

  • workspace_id(impl ::std::convert::Into<String>) / set_workspace_id(Option<String>):

    The identifier of the source WorkSpace

  • tags(Vec<Tag>) / set_tags(Option<Vec<Tag>>):

    The tags that you want to add to the new WorkSpace image. To add tags when you’re creating the image, you must create an IAM policy that grants your IAM user permission to use workspaces:CreateTags.

• On success, responds with CreateWorkspaceImageOutput with field(s):
  • image_id(Option<String>):

    The identifier of the new WorkSpace image.

  • name(Option<String>):

    The name of the image.

  • description(Option<String>):

    The description of the image.

  • operating_system(Option<OperatingSystem>):

    The operating system that the image is running.

  • state(Option<WorkspaceImageState>):

    The availability status of the image.

  • required_tenancy(Option<WorkspaceImageRequiredTenancy>):

    Specifies whether the image is running on dedicated hardware. When Bring Your Own License (BYOL) is enabled, this value is set to DEDICATED. For more information, see Bring Your Own Windows Desktop Images..

  • created(Option<DateTime>):

    The date when the image was created.

  • owner_account_id(Option<String>):

    The identifier of the Amazon Web Services account that owns the image.

• On failure, responds with SdkError<CreateWorkspaceImageError>

impl Client

pub fn create_workspaces(&self) -> CreateWorkspacesFluentBuilder

Constructs a fluent builder for the CreateWorkspaces operation.

• The fluent builder is configurable:
  • workspaces(Vec<WorkspaceRequest>) / set_workspaces(Option<Vec<WorkspaceRequest>>):

    The WorkSpaces to create. You can specify up to 25 WorkSpaces.

• On success, responds with CreateWorkspacesOutput with field(s):
  • failed_requests(Option<Vec<FailedCreateWorkspaceRequest>>):

    Information about the WorkSpaces that could not be created.

  • pending_requests(Option<Vec<Workspace>>):

    Information about the WorkSpaces that were created.

    Because this operation is asynchronous, the identifier returned is not immediately available for use with other operations. For example, if you call DescribeWorkspaces before the WorkSpace is created, the information returned can be incomplete.

• On failure, responds with SdkError<CreateWorkspacesError>

impl Client

pub fn delete_client_branding(&self) -> DeleteClientBrandingFluentBuilder

Constructs a fluent builder for the DeleteClientBranding operation.

• The fluent builder is configurable:
  • resource_id(impl ::std::convert::Into<String>) / set_resource_id(Option<String>):

    The directory identifier of the WorkSpace for which you want to delete client branding.

  • platforms(Vec<ClientDeviceType>) / set_platforms(Option<Vec<ClientDeviceType>>):

    The device type for which you want to delete client branding.

• On success, responds with DeleteClientBrandingOutput
• On failure, responds with SdkError<DeleteClientBrandingError>

impl Client

pub fn delete_connect_client_add_in( &self ) -> DeleteConnectClientAddInFluentBuilder

Constructs a fluent builder for the DeleteConnectClientAddIn operation.

• The fluent builder is configurable:
  • add_in_id(impl ::std::convert::Into<String>) / set_add_in_id(Option<String>):

    The identifier of the client add-in to delete.

  • resource_id(impl ::std::convert::Into<String>) / set_resource_id(Option<String>):

    The directory identifier for which the client add-in is configured.

• On success, responds with DeleteConnectClientAddInOutput
• On failure, responds with SdkError<DeleteConnectClientAddInError>

impl Client

pub fn delete_connection_alias(&self) -> DeleteConnectionAliasFluentBuilder

Constructs a fluent builder for the DeleteConnectionAlias operation.

• The fluent builder is configurable:
  • alias_id(impl ::std::convert::Into<String>) / set_alias_id(Option<String>):

    The identifier of the connection alias to delete.

• On success, responds with DeleteConnectionAliasOutput
• On failure, responds with SdkError<DeleteConnectionAliasError>

impl Client

pub fn delete_ip_group(&self) -> DeleteIpGroupFluentBuilder

Constructs a fluent builder for the DeleteIpGroup operation.

• The fluent builder is configurable:
  • group_id(impl ::std::convert::Into<String>) / set_group_id(Option<String>):

    The identifier of the IP access control group.

• On success, responds with DeleteIpGroupOutput
• On failure, responds with SdkError<DeleteIpGroupError>

impl Client

pub fn delete_tags(&self) -> DeleteTagsFluentBuilder

Constructs a fluent builder for the DeleteTags operation.

• The fluent builder is configurable:
  • resource_id(impl ::std::convert::Into<String>) / set_resource_id(Option<String>):

    The identifier of the WorkSpaces resource. The supported resource types are WorkSpaces, registered directories, images, custom bundles, IP access control groups, and connection aliases.

  • tag_keys(Vec<String>) / set_tag_keys(Option<Vec<String>>):

    The tag keys.

• On success, responds with DeleteTagsOutput
• On failure, responds with SdkError<DeleteTagsError>

impl Client

pub fn delete_workspace_bundle(&self) -> DeleteWorkspaceBundleFluentBuilder

Constructs a fluent builder for the DeleteWorkspaceBundle operation.

• The fluent builder is configurable:
  • bundle_id(impl ::std::convert::Into<String>) / set_bundle_id(Option<String>):

    The identifier of the bundle.

• On success, responds with DeleteWorkspaceBundleOutput
• On failure, responds with SdkError<DeleteWorkspaceBundleError>

impl Client

pub fn delete_workspace_image(&self) -> DeleteWorkspaceImageFluentBuilder

Constructs a fluent builder for the DeleteWorkspaceImage operation.

• The fluent builder is configurable:
  • image_id(impl ::std::convert::Into<String>) / set_image_id(Option<String>):

    The identifier of the image.

• On success, responds with DeleteWorkspaceImageOutput
• On failure, responds with SdkError<DeleteWorkspaceImageError>

impl Client

pub fn deregister_workspace_directory( &self ) -> DeregisterWorkspaceDirectoryFluentBuilder

Constructs a fluent builder for the DeregisterWorkspaceDirectory operation.

• The fluent builder is configurable:
  • directory_id(impl ::std::convert::Into<String>) / set_directory_id(Option<String>):

    The identifier of the directory. If any WorkSpaces are registered to this directory, you must remove them before you deregister the directory, or you will receive an OperationNotSupportedException error.

• On success, responds with DeregisterWorkspaceDirectoryOutput
• On failure, responds with SdkError<DeregisterWorkspaceDirectoryError>

impl Client

pub fn describe_account(&self) -> DescribeAccountFluentBuilder

Constructs a fluent builder for the DescribeAccount operation.

• The fluent builder takes no input, just send it.
• On success, responds with DescribeAccountOutput with field(s):
  • dedicated_tenancy_support(Option<DedicatedTenancySupportResultEnum>):

    The status of BYOL (whether BYOL is enabled or disabled).

  • dedicated_tenancy_management_cidr_range(Option<String>):

    The IP address range, specified as an IPv4 CIDR block, used for the management network interface.

    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.

• On failure, responds with SdkError<DescribeAccountError>

impl Client

pub fn describe_account_modifications( &self ) -> DescribeAccountModificationsFluentBuilder

Constructs a fluent builder for the DescribeAccountModifications operation.

• The fluent builder is configurable:
  • next_token(impl ::std::convert::Into<String>) / set_next_token(Option<String>):

    If you received a NextToken from a previous call that was paginated, provide this token to receive the next set of results.

• On success, responds with DescribeAccountModificationsOutput with field(s):
  • account_modifications(Option<Vec<AccountModification>>):

    The list of modifications to the configuration of BYOL.

  • next_token(Option<String>):

    The token to use to retrieve the next page of results. This value is null when there are no more results to return.

• On failure, responds with SdkError<DescribeAccountModificationsError>

impl Client

pub fn describe_client_branding(&self) -> DescribeClientBrandingFluentBuilder

Constructs a fluent builder for the DescribeClientBranding operation.

• The fluent builder is configurable:
  • resource_id(impl ::std::convert::Into<String>) / set_resource_id(Option<String>):

    The directory identifier of the WorkSpace for which you want to view client branding information.

• On success, responds with DescribeClientBrandingOutput with field(s):
  • device_type_windows(Option<DefaultClientBrandingAttributes>):

    The branding information for Windows devices.

  • device_type_osx(Option<DefaultClientBrandingAttributes>):

    The branding information for macOS devices.

  • device_type_android(Option<DefaultClientBrandingAttributes>):

    The branding information for Android devices.

  • device_type_ios(Option<IosClientBrandingAttributes>):

    The branding information for iOS devices.

  • device_type_linux(Option<DefaultClientBrandingAttributes>):

    The branding information for Linux devices.

  • device_type_web(Option<DefaultClientBrandingAttributes>):

    The branding information for Web access.

• On failure, responds with SdkError<DescribeClientBrandingError>

impl Client

pub fn describe_client_properties( &self ) -> DescribeClientPropertiesFluentBuilder

Constructs a fluent builder for the DescribeClientProperties operation.

• The fluent builder is configurable:
  • resource_ids(Vec<String>) / set_resource_ids(Option<Vec<String>>):

    The resource identifier, in the form of directory IDs.

• On success, responds with DescribeClientPropertiesOutput with field(s):
  • client_properties_list(Option<Vec<ClientPropertiesResult>>):

    Information about the specified Amazon WorkSpaces clients.

• On failure, responds with SdkError<DescribeClientPropertiesError>

impl Client

pub fn describe_connect_client_add_ins( &self ) -> DescribeConnectClientAddInsFluentBuilder

Constructs a fluent builder for the DescribeConnectClientAddIns operation.

• The fluent builder is configurable:
  • resource_id(impl ::std::convert::Into<String>) / set_resource_id(Option<String>):

    The directory identifier for which the client add-in is configured.

  • next_token(impl ::std::convert::Into<String>) / set_next_token(Option<String>):

    If you received a NextToken from a previous call that was paginated, provide this token to receive the next set of results.

  • max_results(i32) / set_max_results(Option<i32>):

    The maximum number of items to return.

• On success, responds with DescribeConnectClientAddInsOutput with field(s):
  • add_ins(Option<Vec<ConnectClientAddIn>>):

    Information about client add-ins.

  • next_token(Option<String>):

    The token to use to retrieve the next page of results. This value is null when there are no more results to return.

• On failure, responds with SdkError<DescribeConnectClientAddInsError>

impl Client

pub fn describe_connection_alias_permissions( &self ) -> DescribeConnectionAliasPermissionsFluentBuilder

Constructs a fluent builder for the DescribeConnectionAliasPermissions operation.

• The fluent builder is configurable:
  • alias_id(impl ::std::convert::Into<String>) / set_alias_id(Option<String>):

    The identifier of the connection alias.

  • next_token(impl ::std::convert::Into<String>) / set_next_token(Option<String>):

    If you received a NextToken from a previous call that was paginated, provide this token to receive the next set of results.

  • max_results(i32) / set_max_results(Option<i32>):

    The maximum number of results to return.

• On success, responds with DescribeConnectionAliasPermissionsOutput with field(s):
  • alias_id(Option<String>):

    The identifier of the connection alias.

  • connection_alias_permissions(Option<Vec<ConnectionAliasPermission>>):

    The permissions associated with a connection alias.

  • next_token(Option<String>):

    The token to use to retrieve the next page of results. This value is null when there are no more results to return.

• On failure, responds with SdkError<DescribeConnectionAliasPermissionsError>

impl Client

pub fn describe_connection_aliases( &self ) -> DescribeConnectionAliasesFluentBuilder

Constructs a fluent builder for the DescribeConnectionAliases operation.

• The fluent builder is configurable:
  • alias_ids(Vec<String>) / set_alias_ids(Option<Vec<String>>):

    The identifiers of the connection aliases to describe.

  • resource_id(impl ::std::convert::Into<String>) / set_resource_id(Option<String>):

    The identifier of the directory associated with the connection alias.

  • limit(i32) / set_limit(Option<i32>):

    The maximum number of connection aliases to return.

  • next_token(impl ::std::convert::Into<String>) / set_next_token(Option<String>):

    If you received a NextToken from a previous call that was paginated, provide this token to receive the next set of results.

• On success, responds with DescribeConnectionAliasesOutput with field(s):
  • connection_aliases(Option<Vec<ConnectionAlias>>):

    Information about the specified connection aliases.

  • next_token(Option<String>):

    The token to use to retrieve the next page of results. This value is null when there are no more results to return.

• On failure, responds with SdkError<DescribeConnectionAliasesError>

impl Client

pub fn describe_ip_groups(&self) -> DescribeIpGroupsFluentBuilder

Constructs a fluent builder for the DescribeIpGroups operation.

• The fluent builder is configurable:
  • group_ids(Vec<String>) / set_group_ids(Option<Vec<String>>):

    The identifiers of one or more IP access control groups.

  • next_token(impl ::std::convert::Into<String>) / set_next_token(Option<String>):

    If you received a NextToken from a previous call that was paginated, provide this token to receive the next set of results.

  • max_results(i32) / set_max_results(Option<i32>):

    The maximum number of items to return.

• On success, responds with DescribeIpGroupsOutput with field(s):
  • result(Option<Vec<WorkspacesIpGroup>>):

    Information about the IP access control groups.

  • next_token(Option<String>):

    The token to use to retrieve the next page of results. This value is null when there are no more results to return.

• On failure, responds with SdkError<DescribeIpGroupsError>

impl Client

pub fn describe_tags(&self) -> DescribeTagsFluentBuilder

Constructs a fluent builder for the DescribeTags operation.

• The fluent builder is configurable:
  • resource_id(impl ::std::convert::Into<String>) / set_resource_id(Option<String>):

    The identifier of the WorkSpaces resource. The supported resource types are WorkSpaces, registered directories, images, custom bundles, IP access control groups, and connection aliases.

• On success, responds with DescribeTagsOutput with field(s):
  • tag_list(Option<Vec<Tag>>):

    The tags.

• On failure, responds with SdkError<DescribeTagsError>

impl Client

pub fn describe_workspace_bundles( &self ) -> DescribeWorkspaceBundlesFluentBuilder

Constructs a fluent builder for the DescribeWorkspaceBundles operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • bundle_ids(Vec<String>) / set_bundle_ids(Option<Vec<String>>):

    The identifiers of the bundles. You cannot combine this parameter with any other filter.

  • owner(impl ::std::convert::Into<String>) / set_owner(Option<String>):

    The owner of the bundles. You cannot combine this parameter with any other filter.

    To describe the bundles provided by Amazon Web Services, specify AMAZON. To describe the bundles that belong to your account, don’t specify a value.

  • next_token(impl ::std::convert::Into<String>) / set_next_token(Option<String>):

    The token for the next set of results. (You received this token from a previous call.)

• On success, responds with DescribeWorkspaceBundlesOutput with field(s):
  • bundles(Option<Vec<WorkspaceBundle>>):

    Information about the bundles.

  • next_token(Option<String>):

    The token to use to retrieve the next page of results. This value is null when there are no more results to return. This token is valid for one day and must be used within that time frame.

• On failure, responds with SdkError<DescribeWorkspaceBundlesError>

impl Client

pub fn describe_workspace_directories( &self ) -> DescribeWorkspaceDirectoriesFluentBuilder

Constructs a fluent builder for the DescribeWorkspaceDirectories operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • directory_ids(Vec<String>) / set_directory_ids(Option<Vec<String>>):

    The identifiers of the directories. If the value is null, all directories are retrieved.

  • limit(i32) / set_limit(Option<i32>):

    The maximum number of directories to return.

  • next_token(impl ::std::convert::Into<String>) / set_next_token(Option<String>):

    If you received a NextToken from a previous call that was paginated, provide this token to receive the next set of results.

• On success, responds with DescribeWorkspaceDirectoriesOutput with field(s):
  • directories(Option<Vec<WorkspaceDirectory>>):

    Information about the directories.

  • next_token(Option<String>):

    The token to use to retrieve the next page of results. This value is null when there are no more results to return.

• On failure, responds with SdkError<DescribeWorkspaceDirectoriesError>

impl Client

pub fn describe_workspace_image_permissions( &self ) -> DescribeWorkspaceImagePermissionsFluentBuilder

Constructs a fluent builder for the DescribeWorkspaceImagePermissions operation.

• The fluent builder is configurable:
  • image_id(impl ::std::convert::Into<String>) / set_image_id(Option<String>):

    The identifier of the image.

  • next_token(impl ::std::convert::Into<String>) / set_next_token(Option<String>):

    If you received a NextToken from a previous call that was paginated, provide this token to receive the next set of results.

  • max_results(i32) / set_max_results(Option<i32>):

    The maximum number of items to return.

• On success, responds with DescribeWorkspaceImagePermissionsOutput with field(s):
  • image_id(Option<String>):

    The identifier of the image.

  • image_permissions(Option<Vec<ImagePermission>>):

    The identifiers of the Amazon Web Services accounts that the image has been shared with.

  • next_token(Option<String>):

    The token to use to retrieve the next page of results. This value is null when there are no more results to return.

• On failure, responds with SdkError<DescribeWorkspaceImagePermissionsError>

impl Client

pub fn describe_workspace_images(&self) -> DescribeWorkspaceImagesFluentBuilder

Constructs a fluent builder for the DescribeWorkspaceImages operation.

• The fluent builder is configurable:
  • image_ids(Vec<String>) / set_image_ids(Option<Vec<String>>):

    The identifier of the image.

  • image_type(ImageType) / set_image_type(Option<ImageType>):

    The type (owned or shared) of the image.

  • next_token(impl ::std::convert::Into<String>) / set_next_token(Option<String>):

    If you received a NextToken from a previous call that was paginated, provide this token to receive the next set of results.

  • max_results(i32) / set_max_results(Option<i32>):

    The maximum number of items to return.

• On success, responds with DescribeWorkspaceImagesOutput with field(s):
  • images(Option<Vec<WorkspaceImage>>):

    Information about the images.

  • next_token(Option<String>):

    The token to use to retrieve the next page of results. This value is null when there are no more results to return.

• On failure, responds with SdkError<DescribeWorkspaceImagesError>

impl Client

pub fn describe_workspace_snapshots( &self ) -> DescribeWorkspaceSnapshotsFluentBuilder

Constructs a fluent builder for the DescribeWorkspaceSnapshots operation.

• The fluent builder is configurable:
  • workspace_id(impl ::std::convert::Into<String>) / set_workspace_id(Option<String>):

    The identifier of the WorkSpace.

• On success, responds with DescribeWorkspaceSnapshotsOutput with field(s):
  • rebuild_snapshots(Option<Vec<Snapshot>>):

    Information about the snapshots that can be used to rebuild a WorkSpace. These snapshots include the user volume.

  • restore_snapshots(Option<Vec<Snapshot>>):

    Information about the snapshots that can be used to restore a WorkSpace. These snapshots include both the root volume and the user volume.

• On failure, responds with SdkError<DescribeWorkspaceSnapshotsError>

impl Client

pub fn describe_workspaces(&self) -> DescribeWorkspacesFluentBuilder

Constructs a fluent builder for the DescribeWorkspaces operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • workspace_ids(Vec<String>) / set_workspace_ids(Option<Vec<String>>):

    The identifiers of the WorkSpaces. You cannot combine this parameter with any other filter.

    Because the CreateWorkspaces operation is asynchronous, the identifier it returns is not immediately available. If you immediately call DescribeWorkspaces with this identifier, no information is returned.

  • directory_id(impl ::std::convert::Into<String>) / set_directory_id(Option<String>):

    The identifier of the directory. In addition, you can optionally specify a specific directory user (see UserName). You cannot combine this parameter with any other filter.

  • user_name(impl ::std::convert::Into<String>) / set_user_name(Option<String>):

    The name of the directory user. You must specify this parameter with DirectoryId.

  • bundle_id(impl ::std::convert::Into<String>) / set_bundle_id(Option<String>):

    The identifier of the bundle. All WorkSpaces that are created from this bundle are retrieved. You cannot combine this parameter with any other filter.

  • limit(i32) / set_limit(Option<i32>):

    The maximum number of items to return.

  • next_token(impl ::std::convert::Into<String>) / set_next_token(Option<String>):

    If you received a NextToken from a previous call that was paginated, provide this token to receive the next set of results.

• On success, responds with DescribeWorkspacesOutput with field(s):
  • workspaces(Option<Vec<Workspace>>):

    Information about the WorkSpaces.

    Because CreateWorkspaces is an asynchronous operation, some of the returned information could be incomplete.

  • next_token(Option<String>):

    The token to use to retrieve the next page of results. This value is null when there are no more results to return.

• On failure, responds with SdkError<DescribeWorkspacesError>

impl Client

pub fn describe_workspaces_connection_status( &self ) -> DescribeWorkspacesConnectionStatusFluentBuilder

Constructs a fluent builder for the DescribeWorkspacesConnectionStatus operation.

• The fluent builder is configurable:
  • workspace_ids(Vec<String>) / set_workspace_ids(Option<Vec<String>>):

    The identifiers of the WorkSpaces. You can specify up to 25 WorkSpaces.

  • next_token(impl ::std::convert::Into<String>) / set_next_token(Option<String>):

    If you received a NextToken from a previous call that was paginated, provide this token to receive the next set of results.

• On success, responds with DescribeWorkspacesConnectionStatusOutput with field(s):
  • workspaces_connection_status(Option<Vec<WorkspaceConnectionStatus>>):

    Information about the connection status of the WorkSpace.

  • next_token(Option<String>):

    The token to use to retrieve the next page of results. This value is null when there are no more results to return.

• On failure, responds with SdkError<DescribeWorkspacesConnectionStatusError>

impl Client

pub fn disassociate_connection_alias( &self ) -> DisassociateConnectionAliasFluentBuilder

Constructs a fluent builder for the DisassociateConnectionAlias operation.

• The fluent builder is configurable:
  • alias_id(impl ::std::convert::Into<String>) / set_alias_id(Option<String>):

    The identifier of the connection alias to disassociate.

• On success, responds with DisassociateConnectionAliasOutput
• On failure, responds with SdkError<DisassociateConnectionAliasError>

impl Client

pub fn disassociate_ip_groups(&self) -> DisassociateIpGroupsFluentBuilder

Constructs a fluent builder for the DisassociateIpGroups operation.

• The fluent builder is configurable:
  • directory_id(impl ::std::convert::Into<String>) / set_directory_id(Option<String>):

    The identifier of the directory.

  • group_ids(Vec<String>) / set_group_ids(Option<Vec<String>>):

    The identifiers of one or more IP access control groups.

• On success, responds with DisassociateIpGroupsOutput
• On failure, responds with SdkError<DisassociateIpGroupsError>

impl Client

pub fn import_client_branding(&self) -> ImportClientBrandingFluentBuilder

Constructs a fluent builder for the ImportClientBranding operation.

• The fluent builder is configurable:
  • resource_id(impl ::std::convert::Into<String>) / set_resource_id(Option<String>):

    The directory identifier of the WorkSpace for which you want to import client branding.

  • device_type_windows(DefaultImportClientBrandingAttributes) / set_device_type_windows(Option<DefaultImportClientBrandingAttributes>):

    The branding information to import for Windows devices.

  • device_type_osx(DefaultImportClientBrandingAttributes) / set_device_type_osx(Option<DefaultImportClientBrandingAttributes>):

    The branding information to import for macOS devices.

  • device_type_android(DefaultImportClientBrandingAttributes) / set_device_type_android(Option<DefaultImportClientBrandingAttributes>):

    The branding information to import for Android devices.

  • device_type_ios(IosImportClientBrandingAttributes) / set_device_type_ios(Option<IosImportClientBrandingAttributes>):

    The branding information to import for iOS devices.

  • device_type_linux(DefaultImportClientBrandingAttributes) / set_device_type_linux(Option<DefaultImportClientBrandingAttributes>):

    The branding information to import for Linux devices.

  • device_type_web(DefaultImportClientBrandingAttributes) / set_device_type_web(Option<DefaultImportClientBrandingAttributes>):

    The branding information to import for web access.

• On success, responds with ImportClientBrandingOutput with field(s):
  • device_type_windows(Option<DefaultClientBrandingAttributes>):

    The branding information configured for Windows devices.

  • device_type_osx(Option<DefaultClientBrandingAttributes>):

    The branding information configured for macOS devices.

  • device_type_android(Option<DefaultClientBrandingAttributes>):

    The branding information configured for Android devices.

  • device_type_ios(Option<IosClientBrandingAttributes>):

    The branding information configured for iOS devices.

  • device_type_linux(Option<DefaultClientBrandingAttributes>):

    The branding information configured for Linux devices.

  • device_type_web(Option<DefaultClientBrandingAttributes>):

    The branding information configured for web access.

• On failure, responds with SdkError<ImportClientBrandingError>

impl Client

pub fn import_workspace_image(&self) -> ImportWorkspaceImageFluentBuilder

Constructs a fluent builder for the ImportWorkspaceImage operation.

• The fluent builder is configurable:
  • ec2_image_id(impl ::std::convert::Into<String>) / set_ec2_image_id(Option<String>):

    The identifier of the EC2 image.

  • ingestion_process(WorkspaceImageIngestionProcess) / set_ingestion_process(Option<WorkspaceImageIngestionProcess>):

    The ingestion process to be used when importing the image, depending on which protocol you want to use for your BYOL Workspace image, either PCoIP, WorkSpaces Streaming Protocol (WSP), or bring your own protocol (BYOP). To use WSP, specify a value that ends in _WSP. To use PCoIP, specify a value that does not end in _WSP. To use BYOP, specify a value that ends in _BYOP.

    For non-GPU-enabled bundles (bundles other than Graphics or GraphicsPro), specify BYOL_REGULAR, BYOL_REGULAR_WSP, or BYOL_REGULAR_BYOP, depending on the protocol.

    The BYOL_REGULAR_BYOP and BYOL_GRAPHICS_G4DN_BYOP values are only supported by Amazon WorkSpaces Core. Contact your account team to be allow-listed to use these values. For more information, see Amazon WorkSpaces Core.

  • image_name(impl ::std::convert::Into<String>) / set_image_name(Option<String>):

    The name of the WorkSpace image.

  • image_description(impl ::std::convert::Into<String>) / set_image_description(Option<String>):

    The description of the WorkSpace image.

  • tags(Vec<Tag>) / set_tags(Option<Vec<Tag>>):

    The tags. Each WorkSpaces resource can have a maximum of 50 tags.

  • applications(Vec<Application>) / set_applications(Option<Vec<Application>>):

    If specified, the version of Microsoft Office to subscribe to. Valid only for Windows 10 and 11 BYOL images. For more information about subscribing to Office for BYOL images, see Bring Your Own Windows Desktop Licenses.

    • Although this parameter is an array, only one item is allowed at this time.

    • Windows 11 only supports Microsoft_Office_2019.

• On success, responds with ImportWorkspaceImageOutput with field(s):
  • image_id(Option<String>):

    The identifier of the WorkSpace image.

• On failure, responds with SdkError<ImportWorkspaceImageError>

impl Client

pub fn list_available_management_cidr_ranges( &self ) -> ListAvailableManagementCidrRangesFluentBuilder

Constructs a fluent builder for the ListAvailableManagementCidrRanges operation.

• The fluent builder is configurable:
  • management_cidr_range_constraint(impl ::std::convert::Into<String>) / set_management_cidr_range_constraint(Option<String>):

    The IP address range to search. Specify an IP address range that is compatible with your network and in CIDR notation (that is, specify the range as an IPv4 CIDR block).

  • max_results(i32) / set_max_results(Option<i32>):

    The maximum number of items to return.

  • next_token(impl ::std::convert::Into<String>) / set_next_token(Option<String>):

    If you received a NextToken from a previous call that was paginated, provide this token to receive the next set of results.

• On success, responds with ListAvailableManagementCidrRangesOutput with field(s):
  • management_cidr_ranges(Option<Vec<String>>):

    The list of available IP address ranges, specified as IPv4 CIDR blocks.

  • next_token(Option<String>):

    The token to use to retrieve the next page of results. This value is null when there are no more results to return.

• On failure, responds with SdkError<ListAvailableManagementCidrRangesError>

impl Client

pub fn migrate_workspace(&self) -> MigrateWorkspaceFluentBuilder

Constructs a fluent builder for the MigrateWorkspace operation.

• The fluent builder is configurable:
  • source_workspace_id(impl ::std::convert::Into<String>) / set_source_workspace_id(Option<String>):

    The identifier of the WorkSpace to migrate from.

  • bundle_id(impl ::std::convert::Into<String>) / set_bundle_id(Option<String>):

    The identifier of the target bundle type to migrate the WorkSpace to.

• On success, responds with MigrateWorkspaceOutput with field(s):
  • source_workspace_id(Option<String>):

    The original identifier of the WorkSpace that is being migrated.

  • target_workspace_id(Option<String>):

    The new identifier of the WorkSpace that is being migrated. If the migration does not succeed, the target WorkSpace ID will not be used, and the WorkSpace will still have the original WorkSpace ID.

• On failure, responds with SdkError<MigrateWorkspaceError>

impl Client

pub fn modify_account(&self) -> ModifyAccountFluentBuilder

Constructs a fluent builder for the ModifyAccount operation.

• The fluent builder is configurable:
  • dedicated_tenancy_support(DedicatedTenancySupportEnum) / set_dedicated_tenancy_support(Option<DedicatedTenancySupportEnum>):

    The status of BYOL.

  • dedicated_tenancy_management_cidr_range(impl ::std::convert::Into<String>) / set_dedicated_tenancy_management_cidr_range(Option<String>):

    The IP address range, specified as an IPv4 CIDR block, for the management network interface. Specify an IP address range that is compatible with your network and in CIDR notation (that is, specify the range as an IPv4 CIDR block). The CIDR block size must be /16 (for example, 203.0.113.25/16). It must also be specified as available by the ListAvailableManagementCidrRanges operation.

• On success, responds with ModifyAccountOutput
• On failure, responds with SdkError<ModifyAccountError>

impl Client

pub fn modify_certificate_based_auth_properties( &self ) -> ModifyCertificateBasedAuthPropertiesFluentBuilder

Constructs a fluent builder for the ModifyCertificateBasedAuthProperties operation.

• The fluent builder is configurable:
  • resource_id(impl ::std::convert::Into<String>) / set_resource_id(Option<String>):

    The resource identifiers, in the form of directory IDs.

  • certificate_based_auth_properties(CertificateBasedAuthProperties) / set_certificate_based_auth_properties(Option<CertificateBasedAuthProperties>):

    The properties of the certificate-based authentication.

  • properties_to_delete(Vec<DeletableCertificateBasedAuthProperty>) / set_properties_to_delete(Option<Vec<DeletableCertificateBasedAuthProperty>>):

    The properties of the certificate-based authentication you want to delete.

• On success, responds with ModifyCertificateBasedAuthPropertiesOutput
• On failure, responds with SdkError<ModifyCertificateBasedAuthPropertiesError>

impl Client

pub fn modify_client_properties(&self) -> ModifyClientPropertiesFluentBuilder

Constructs a fluent builder for the ModifyClientProperties operation.

• The fluent builder is configurable:
  • resource_id(impl ::std::convert::Into<String>) / set_resource_id(Option<String>):

    The resource identifiers, in the form of directory IDs.

  • client_properties(ClientProperties) / set_client_properties(Option<ClientProperties>):

    Information about the Amazon WorkSpaces client.

• On success, responds with ModifyClientPropertiesOutput
• On failure, responds with SdkError<ModifyClientPropertiesError>

impl Client

pub fn modify_saml_properties(&self) -> ModifySamlPropertiesFluentBuilder

Constructs a fluent builder for the ModifySamlProperties operation.

• The fluent builder is configurable:
  • resource_id(impl ::std::convert::Into<String>) / set_resource_id(Option<String>):

    The directory identifier for which you want to configure SAML properties.

  • saml_properties(SamlProperties) / set_saml_properties(Option<SamlProperties>):

    The properties for configuring SAML 2.0 authentication.

  • properties_to_delete(Vec<DeletableSamlProperty>) / set_properties_to_delete(Option<Vec<DeletableSamlProperty>>):

    The SAML properties to delete as part of your request.

    Specify one of the following options:

    • SAML_PROPERTIES_USER_ACCESS_URL to delete the user access URL.

    • SAML_PROPERTIES_RELAY_STATE_PARAMETER_NAME to delete the relay state parameter name.

• On success, responds with ModifySamlPropertiesOutput
• On failure, responds with SdkError<ModifySamlPropertiesError>

impl Client

pub fn modify_selfservice_permissions( &self ) -> ModifySelfservicePermissionsFluentBuilder

Constructs a fluent builder for the ModifySelfservicePermissions operation.

• The fluent builder is configurable:
  • resource_id(impl ::std::convert::Into<String>) / set_resource_id(Option<String>):

    The identifier of the directory.

  • selfservice_permissions(SelfservicePermissions) / set_selfservice_permissions(Option<SelfservicePermissions>):

    The permissions to enable or disable self-service capabilities.

• On success, responds with ModifySelfservicePermissionsOutput
• On failure, responds with SdkError<ModifySelfservicePermissionsError>

impl Client

pub fn modify_workspace_access_properties( &self ) -> ModifyWorkspaceAccessPropertiesFluentBuilder

Constructs a fluent builder for the ModifyWorkspaceAccessProperties operation.

• The fluent builder is configurable:
  • resource_id(impl ::std::convert::Into<String>) / set_resource_id(Option<String>):

    The identifier of the directory.

  • workspace_access_properties(WorkspaceAccessProperties) / set_workspace_access_properties(Option<WorkspaceAccessProperties>):

    The device types and operating systems to enable or disable for access.

• On success, responds with ModifyWorkspaceAccessPropertiesOutput
• On failure, responds with SdkError<ModifyWorkspaceAccessPropertiesError>

impl Client

pub fn modify_workspace_creation_properties( &self ) -> ModifyWorkspaceCreationPropertiesFluentBuilder

Constructs a fluent builder for the ModifyWorkspaceCreationProperties operation.

• The fluent builder is configurable:
  • resource_id(impl ::std::convert::Into<String>) / set_resource_id(Option<String>):

    The identifier of the directory.

  • workspace_creation_properties(WorkspaceCreationProperties) / set_workspace_creation_properties(Option<WorkspaceCreationProperties>):

    The default properties for creating WorkSpaces.

• On success, responds with ModifyWorkspaceCreationPropertiesOutput
• On failure, responds with SdkError<ModifyWorkspaceCreationPropertiesError>

impl Client

pub fn modify_workspace_properties( &self ) -> ModifyWorkspacePropertiesFluentBuilder

Constructs a fluent builder for the ModifyWorkspaceProperties operation.

• The fluent builder is configurable:
  • workspace_id(impl ::std::convert::Into<String>) / set_workspace_id(Option<String>):

    The identifier of the WorkSpace.

  • workspace_properties(WorkspaceProperties) / set_workspace_properties(Option<WorkspaceProperties>):

    The properties of the WorkSpace.

• On success, responds with ModifyWorkspacePropertiesOutput
• On failure, responds with SdkError<ModifyWorkspacePropertiesError>

impl Client

pub fn modify_workspace_state(&self) -> ModifyWorkspaceStateFluentBuilder

Constructs a fluent builder for the ModifyWorkspaceState operation.

• The fluent builder is configurable:
  • workspace_id(impl ::std::convert::Into<String>) / set_workspace_id(Option<String>):

    The identifier of the WorkSpace.

  • workspace_state(TargetWorkspaceState) / set_workspace_state(Option<TargetWorkspaceState>):

    The WorkSpace state.

• On success, responds with ModifyWorkspaceStateOutput
• On failure, responds with SdkError<ModifyWorkspaceStateError>

impl Client

pub fn reboot_workspaces(&self) -> RebootWorkspacesFluentBuilder

Constructs a fluent builder for the RebootWorkspaces operation.

• The fluent builder is configurable:
  • reboot_workspace_requests(Vec<RebootRequest>) / set_reboot_workspace_requests(Option<Vec<RebootRequest>>):

    The WorkSpaces to reboot. You can specify up to 25 WorkSpaces.

• On success, responds with RebootWorkspacesOutput with field(s):
  • failed_requests(Option<Vec<FailedWorkspaceChangeRequest>>):

    Information about the WorkSpaces that could not be rebooted.

• On failure, responds with SdkError<RebootWorkspacesError>

impl Client

pub fn rebuild_workspaces(&self) -> RebuildWorkspacesFluentBuilder

Constructs a fluent builder for the RebuildWorkspaces operation.

• The fluent builder is configurable:
  • rebuild_workspace_requests(Vec<RebuildRequest>) / set_rebuild_workspace_requests(Option<Vec<RebuildRequest>>):

    The WorkSpace to rebuild. You can specify a single WorkSpace.

• On success, responds with RebuildWorkspacesOutput with field(s):
  • failed_requests(Option<Vec<FailedWorkspaceChangeRequest>>):

    Information about the WorkSpace that could not be rebuilt.

• On failure, responds with SdkError<RebuildWorkspacesError>

impl Client

pub fn register_workspace_directory( &self ) -> RegisterWorkspaceDirectoryFluentBuilder

Constructs a fluent builder for the RegisterWorkspaceDirectory operation.

• The fluent builder is configurable:
  • directory_id(impl ::std::convert::Into<String>) / set_directory_id(Option<String>):

    The identifier of the directory. You cannot register a directory if it does not have a status of Active. If the directory does not have a status of Active, you will receive an InvalidResourceStateException error. If you have already registered the maximum number of directories that you can register with Amazon WorkSpaces, you will receive a ResourceLimitExceededException error. Deregister directories that you are not using for WorkSpaces, and try again.

  • subnet_ids(Vec<String>) / set_subnet_ids(Option<Vec<String>>):

    The identifiers of the subnets for your virtual private cloud (VPC). Make sure that the subnets are in supported Availability Zones. The subnets must also be in separate Availability Zones. If these conditions are not met, you will receive an OperationNotSupportedException error.

  • enable_work_docs(bool) / set_enable_work_docs(Option<bool>):

    Indicates whether Amazon WorkDocs is enabled or disabled. If you have enabled this parameter and WorkDocs is not available in the Region, you will receive an OperationNotSupportedException error. Set EnableWorkDocs to disabled, and try again.

  • enable_self_service(bool) / set_enable_self_service(Option<bool>):

    Indicates whether self-service capabilities are enabled or disabled.

  • tenancy(Tenancy) / set_tenancy(Option<Tenancy>):

    Indicates whether your WorkSpace directory is dedicated or shared. To use Bring Your Own License (BYOL) images, this value must be set to DEDICATED and your Amazon Web Services account must be enabled for BYOL. If your account has not been enabled for BYOL, you will receive an InvalidParameterValuesException error. For more information about BYOL images, see Bring Your Own Windows Desktop Images.

  • tags(Vec<Tag>) / set_tags(Option<Vec<Tag>>):

    The tags associated with the directory.

• On success, responds with RegisterWorkspaceDirectoryOutput
• On failure, responds with SdkError<RegisterWorkspaceDirectoryError>

impl Client

pub fn restore_workspace(&self) -> RestoreWorkspaceFluentBuilder

Constructs a fluent builder for the RestoreWorkspace operation.

• The fluent builder is configurable:
  • workspace_id(impl ::std::convert::Into<String>) / set_workspace_id(Option<String>):

    The identifier of the WorkSpace.

• On success, responds with RestoreWorkspaceOutput
• On failure, responds with SdkError<RestoreWorkspaceError>

impl Client

pub fn revoke_ip_rules(&self) -> RevokeIpRulesFluentBuilder

Constructs a fluent builder for the RevokeIpRules operation.

• The fluent builder is configurable:
  • group_id(impl ::std::convert::Into<String>) / set_group_id(Option<String>):

    The identifier of the group.

  • user_rules(Vec<String>) / set_user_rules(Option<Vec<String>>):

    The rules to remove from the group.

• On success, responds with RevokeIpRulesOutput
• On failure, responds with SdkError<RevokeIpRulesError>

impl Client

pub fn start_workspaces(&self) -> StartWorkspacesFluentBuilder

Constructs a fluent builder for the StartWorkspaces operation.

• The fluent builder is configurable:
  • start_workspace_requests(Vec<StartRequest>) / set_start_workspace_requests(Option<Vec<StartRequest>>):

    The WorkSpaces to start. You can specify up to 25 WorkSpaces.

• On success, responds with StartWorkspacesOutput with field(s):
  • failed_requests(Option<Vec<FailedWorkspaceChangeRequest>>):

    Information about the WorkSpaces that could not be started.

• On failure, responds with SdkError<StartWorkspacesError>

impl Client

pub fn stop_workspaces(&self) -> StopWorkspacesFluentBuilder

Constructs a fluent builder for the StopWorkspaces operation.

• The fluent builder is configurable:
  • stop_workspace_requests(Vec<StopRequest>) / set_stop_workspace_requests(Option<Vec<StopRequest>>):

    The WorkSpaces to stop. You can specify up to 25 WorkSpaces.

• On success, responds with StopWorkspacesOutput with field(s):
  • failed_requests(Option<Vec<FailedWorkspaceChangeRequest>>):

    Information about the WorkSpaces that could not be stopped.

• On failure, responds with SdkError<StopWorkspacesError>

impl Client

pub fn terminate_workspaces(&self) -> TerminateWorkspacesFluentBuilder

Constructs a fluent builder for the TerminateWorkspaces operation.

• The fluent builder is configurable:
  • terminate_workspace_requests(Vec<TerminateRequest>) / set_terminate_workspace_requests(Option<Vec<TerminateRequest>>):

    The WorkSpaces to terminate. You can specify up to 25 WorkSpaces.

• On success, responds with TerminateWorkspacesOutput with field(s):
  • failed_requests(Option<Vec<FailedWorkspaceChangeRequest>>):

    Information about the WorkSpaces that could not be terminated.

• On failure, responds with SdkError<TerminateWorkspacesError>

impl Client

pub fn update_connect_client_add_in( &self ) -> UpdateConnectClientAddInFluentBuilder

Constructs a fluent builder for the UpdateConnectClientAddIn operation.

• The fluent builder is configurable:
  • add_in_id(impl ::std::convert::Into<String>) / set_add_in_id(Option<String>):

    The identifier of the client add-in to update.

  • resource_id(impl ::std::convert::Into<String>) / set_resource_id(Option<String>):

    The directory identifier for which the client add-in is configured.

  • name(impl ::std::convert::Into<String>) / set_name(Option<String>):

    The name of the client add-in.

  • url(impl ::std::convert::Into<String>) / set_url(Option<String>):

    The endpoint URL of the Amazon Connect client add-in.

• On success, responds with UpdateConnectClientAddInOutput
• On failure, responds with SdkError<UpdateConnectClientAddInError>

impl Client

pub fn update_connection_alias_permission( &self ) -> UpdateConnectionAliasPermissionFluentBuilder

Constructs a fluent builder for the UpdateConnectionAliasPermission operation.

• The fluent builder is configurable:
  • alias_id(impl ::std::convert::Into<String>) / set_alias_id(Option<String>):

    The identifier of the connection alias that you want to update permissions for.

  • connection_alias_permission(ConnectionAliasPermission) / set_connection_alias_permission(Option<ConnectionAliasPermission>):

    Indicates whether to share or unshare the connection alias with the specified Amazon Web Services account.

• On success, responds with UpdateConnectionAliasPermissionOutput
• On failure, responds with SdkError<UpdateConnectionAliasPermissionError>

impl Client

pub fn update_rules_of_ip_group(&self) -> UpdateRulesOfIpGroupFluentBuilder

Constructs a fluent builder for the UpdateRulesOfIpGroup operation.

• The fluent builder is configurable:
  • group_id(impl ::std::convert::Into<String>) / set_group_id(Option<String>):

    The identifier of the group.

  • user_rules(Vec<IpRuleItem>) / set_user_rules(Option<Vec<IpRuleItem>>):

    One or more rules.

• On success, responds with UpdateRulesOfIpGroupOutput
• On failure, responds with SdkError<UpdateRulesOfIpGroupError>

impl Client

pub fn update_workspace_bundle(&self) -> UpdateWorkspaceBundleFluentBuilder

Constructs a fluent builder for the UpdateWorkspaceBundle operation.

• The fluent builder is configurable:
  • bundle_id(impl ::std::convert::Into<String>) / set_bundle_id(Option<String>):

    The identifier of the bundle.

  • image_id(impl ::std::convert::Into<String>) / set_image_id(Option<String>):

    The identifier of the image.

• On success, responds with UpdateWorkspaceBundleOutput
• On failure, responds with SdkError<UpdateWorkspaceBundleError>

impl Client

pub fn update_workspace_image_permission( &self ) -> UpdateWorkspaceImagePermissionFluentBuilder

Constructs a fluent builder for the UpdateWorkspaceImagePermission operation.

• The fluent builder is configurable:
  • image_id(impl ::std::convert::Into<String>) / set_image_id(Option<String>):

    The identifier of the image.

  • allow_copy_image(bool) / set_allow_copy_image(Option<bool>):

    The permission to copy the image. This permission can be revoked only after an image has been shared.

  • shared_account_id(impl ::std::convert::Into<String>) / set_shared_account_id(Option<String>):

    The identifier of the Amazon Web Services account to share or unshare the image with.

    Before sharing the image, confirm that you are sharing to the correct Amazon Web Services account ID.

• On success, responds with UpdateWorkspaceImagePermissionOutput
• On failure, responds with SdkError<UpdateWorkspaceImagePermissionError>

impl Client

pub fn with_config( client: Client<DynConnector, DynMiddleware<DynConnector>>, conf: Config ) -> Self

Creates a client with the given service configuration.

pub fn conf(&self) -> &Config

Returns the client’s configuration.

impl Client

pub fn new(sdk_config: &SdkConfig) -> Self

Creates a new client from an SDK Config.

Panics

• This method will panic if the sdk_config is missing an async sleep implementation. If you experience this panic, set the sleep_impl on the Config passed into this function to fix it.
• This method will panic if the sdk_config is missing an HTTP connector. If you experience this panic, set the http_connector on the Config passed into this function to fix it.

pub fn from_conf(conf: Config) -> Self

Creates a new client from the service Config.

Panics

• This method will panic if the conf is missing an async sleep implementation. If you experience this panic, set the sleep_impl on the Config passed into this function to fix it.
• This method will panic if the conf is missing an HTTP connector. If you experience this panic, set the http_connector on the Config passed into this function to fix it.

Trait Implementations

impl Clone for Client

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Client

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<Client<DynConnector, DynMiddleware<DynConnector>, Standard>> for Client

fn from(client: Client<DynConnector, DynMiddleware<DynConnector>>) -> Self

Converts to this type from the input type.