2020/09/11 - Amazon WorkSpaces - 7 new api methods
Changes Adds API support for WorkSpaces Cross-Region Redirection feature.
Retrieves a list that describes the connection aliases used for cross-Region redirection. For more information, see Cross-Region Redirection for Amazon WorkSpaces .
See also: AWS API Documentation
Request Syntax
client.describe_connection_aliases( AliasIds=[ 'string', ], ResourceId='string', Limit=123, NextToken='string' )
list
The identifiers of the connection aliases to describe.
(string) --
string
The identifier of the directory associated with the connection alias.
integer
The maximum number of connection aliases to return.
string
If you received a NextToken from a previous call that was paginated, provide this token to receive the next set of results.
dict
Response Syntax
{ 'ConnectionAliases': [ { 'ConnectionString': 'string', 'AliasId': 'string', 'State': 'CREATING'|'CREATED'|'DELETING', 'OwnerAccountId': 'string', 'Associations': [ { 'AssociationStatus': 'NOT_ASSOCIATED'|'ASSOCIATED_WITH_OWNER_ACCOUNT'|'ASSOCIATED_WITH_SHARED_ACCOUNT'|'PENDING_ASSOCIATION'|'PENDING_DISASSOCIATION', 'AssociatedAccountId': 'string', 'ResourceId': 'string', 'ConnectionIdentifier': 'string' }, ] }, ], 'NextToken': 'string' }
Response Structure
(dict) --
ConnectionAliases (list) --
Information about the specified connection aliases.
(dict) --
Describes a connection alias. Connection aliases are used for cross-Region redirection. For more information, see Cross-Region Redirection for Amazon WorkSpaces .
ConnectionString (string) --
The connection string specified for the connection alias. The connection string must be in the form of a fully qualified domain name (FQDN), such as www.example.com .
AliasId (string) --
The identifier of the connection alias.
State (string) --
The current state of the connection alias.
OwnerAccountId (string) --
The identifier of the AWS account that owns the connection alias.
Associations (list) --
The association status of the connection alias.
(dict) --
Describes a connection alias association that is used for cross-Region redirection. For more information, see Cross-Region Redirection for Amazon WorkSpaces .
AssociationStatus (string) --
The association status of the connection alias.
AssociatedAccountId (string) --
The identifier of the AWS account that associated the connection alias with a directory.
ResourceId (string) --
The identifier of the directory associated with a connection alias.
ConnectionIdentifier (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.
NextToken (string) --
The token to use to retrieve the next set of results, or null if no more results are available.
Creates the specified connection alias for use with cross-Region redirection. For more information, see Cross-Region Redirection for Amazon WorkSpaces .
See also: AWS API Documentation
Request Syntax
client.create_connection_alias( ConnectionString='string', Tags=[ { 'Key': 'string', 'Value': 'string' }, ] )
string
[REQUIRED]
A connection string in the form of a fully qualified domain name (FQDN), such as www.example.com .
Warning
After you create a connection string, it is always associated to your AWS 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.
list
The tags to associate with the connection alias.
(dict) --
Describes a tag.
Key (string) -- [REQUIRED]
The key of the tag.
Value (string) --
The value of the tag.
dict
Response Syntax
{ 'AliasId': 'string' }
Response Structure
(dict) --
AliasId (string) --
The identifier of the connection alias.
Associates the specified connection alias with the specified directory to enable cross-Region redirection. For more information, see Cross-Region Redirection for Amazon WorkSpaces .
Note
Before performing this operation, call DescribeConnectionAliases to make sure that the current state of the connection alias is CREATED .
See also: AWS API Documentation
Request Syntax
client.associate_connection_alias( AliasId='string', ResourceId='string' )
string
[REQUIRED]
The identifier of the connection alias.
string
[REQUIRED]
The identifier of the directory to associate the connection alias with.
dict
Response Syntax
{ 'ConnectionIdentifier': 'string' }
Response Structure
(dict) --
ConnectionIdentifier (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.
Disassociates a connection alias from a directory. Disassociating a connection alias disables cross-Region redirection between two directories in different AWS Regions. For more information, see Cross-Region Redirection for Amazon WorkSpaces .
Note
Before performing this operation, call DescribeConnectionAliases to make sure that the current state of the connection alias is CREATED .
See also: AWS API Documentation
Request Syntax
client.disassociate_connection_alias( AliasId='string' )
string
[REQUIRED]
The identifier of the connection alias to disassociate.
dict
Response Syntax
{}
Response Structure
(dict) --
Deletes the specified connection alias. For more information, see Cross-Region Redirection for Amazon WorkSpaces .
Warning
If you will no longer be using a fully qualified domain name (FQDN) as the registration code for your WorkSpaces users, you must take certain precautions to prevent potential security issues. For more information, see Security Considerations if You Stop Using Cross-Region Redirection .
Note
To delete a connection alias that has been shared, the shared account must first disassociate the connection alias from any directories it has been associated with. Then you must unshare the connection alias from the account it has been shared with. You can delete a connection alias only after it is no longer shared with any accounts or associated with any directories.
See also: AWS API Documentation
Request Syntax
client.delete_connection_alias( AliasId='string' )
string
[REQUIRED]
The identifier of the connection alias to delete.
dict
Response Syntax
{}
Response Structure
(dict) --
Shares or unshares a connection alias with one account by specifying whether that account has permission to associate the connection alias with a directory. If the association permission is granted, the connection alias is shared with that account. If the association permission is revoked, the connection alias is unshared with the account. For more information, see Cross-Region Redirection for Amazon WorkSpaces .
Note
Before performing this operation, call DescribeConnectionAliases to make sure that the current state of the connection alias is CREATED .
To delete a connection alias that has been shared, the shared account must first disassociate the connection alias from any directories it has been associated with. Then you must unshare the connection alias from the account it has been shared with. You can delete a connection alias only after it is no longer shared with any accounts or associated with any directories.
See also: AWS API Documentation
Request Syntax
client.update_connection_alias_permission( AliasId='string', ConnectionAliasPermission={ 'SharedAccountId': 'string', 'AllowAssociation': True|False } )
string
[REQUIRED]
The identifier of the connection alias that you want to update permissions for.
dict
[REQUIRED]
Indicates whether to share or unshare the connection alias with the specified AWS account.
SharedAccountId (string) -- [REQUIRED]
The identifier of the AWS account that the connection alias is shared with.
AllowAssociation (boolean) -- [REQUIRED]
Indicates whether the specified AWS account is allowed to associate the connection alias with a directory.
dict
Response Syntax
{}
Response Structure
(dict) --
Describes the permissions that the owner of a connection alias has granted to another AWS account for the specified connection alias. For more information, see Cross-Region Redirection for Amazon WorkSpaces .
See also: AWS API Documentation
Request Syntax
client.describe_connection_alias_permissions( AliasId='string', NextToken='string', MaxResults=123 )
string
[REQUIRED]
The identifier of the connection alias.
string
If you received a NextToken from a previous call that was paginated, provide this token to receive the next set of results.
integer
The maximum number of results to return.
dict
Response Syntax
{ 'AliasId': 'string', 'ConnectionAliasPermissions': [ { 'SharedAccountId': 'string', 'AllowAssociation': True|False }, ], 'NextToken': 'string' }
Response Structure
(dict) --
AliasId (string) --
The identifier of the connection alias.
ConnectionAliasPermissions (list) --
The permissions associated with a connection alias.
(dict) --
Describes the permissions for a connection alias. Connection aliases are used for cross-Region redirection. For more information, see Cross-Region Redirection for Amazon WorkSpaces .
SharedAccountId (string) --
The identifier of the AWS account that the connection alias is shared with.
AllowAssociation (boolean) --
Indicates whether the specified AWS account is allowed to associate the connection alias with a directory.
NextToken (string) --
The token to use to retrieve the next set of results, or null if no more results are available.