2024/07/12 - Amazon WorkLink - 33 new api methods
Removes a certificate authority (CA).
See also: AWS API Documentation
Request Syntax
client.disassociate_website_certificate_authority( FleetArn='string', WebsiteCaId='string' )
string
[REQUIRED]
The ARN of the fleet.
string
[REQUIRED]
A unique identifier for the CA.
dict
Response Syntax
{}
Response Structure
(dict) --
Updates fleet metadata, such as DisplayName.
See also: AWS API Documentation
Request Syntax
client.update_fleet_metadata( FleetArn='string', DisplayName='string', OptimizeForEndUserLocation=True|False )
string
[REQUIRED]
The ARN of the fleet.
string
The fleet name to display. The existing DisplayName is unset if null is passed.
boolean
The option to optimize for better performance by routing traffic through the closest AWS Region to users, which may be outside of your home Region.
dict
Response Syntax
{}
Response Structure
(dict) --
Deletes a fleet. Prevents users from accessing previously associated websites.
See also: AWS API Documentation
Request Syntax
client.delete_fleet( FleetArn='string' )
string
[REQUIRED]
The ARN of the fleet.
dict
Response Syntax
{}
Response Structure
(dict) --
Provides information about the domain.
See also: AWS API Documentation
Request Syntax
client.describe_domain( FleetArn='string', DomainName='string' )
string
[REQUIRED]
The ARN of the fleet.
string
[REQUIRED]
The name of the domain.
dict
Response Syntax
{ 'DomainName': 'string', 'DisplayName': 'string', 'CreatedTime': datetime(2015, 1, 1), 'DomainStatus': 'PENDING_VALIDATION'|'ASSOCIATING'|'ACTIVE'|'INACTIVE'|'DISASSOCIATING'|'DISASSOCIATED'|'FAILED_TO_ASSOCIATE'|'FAILED_TO_DISASSOCIATE', 'AcmCertificateArn': 'string' }
Response Structure
(dict) --
DomainName (string) --
The name of the domain.
DisplayName (string) --
The name to display.
CreatedTime (datetime) --
The time that the domain was added.
DomainStatus (string) --
The current state for the domain.
AcmCertificateArn (string) --
The ARN of an issued ACM certificate that is valid for the domain being associated.
Disassociates a website authorization provider from a specified fleet. After the disassociation, users can't load any associated websites that require this authorization provider.
See also: AWS API Documentation
Request Syntax
client.disassociate_website_authorization_provider( FleetArn='string', AuthorizationProviderId='string' )
string
[REQUIRED]
The ARN of the fleet.
string
[REQUIRED]
A unique identifier for the authorization provider.
dict
Response Syntax
{}
Response Structure
(dict) --
Describes the configuration for delivering audit streams to the customer account.
See also: AWS API Documentation
Request Syntax
client.describe_audit_stream_configuration( FleetArn='string' )
string
[REQUIRED]
The ARN of the fleet.
dict
Response Syntax
{ 'AuditStreamArn': 'string' }
Response Structure
(dict) --
AuditStreamArn (string) --
The ARN of the Amazon Kinesis data stream that will receive the audit events.
Updates domain metadata, such as DisplayName.
See also: AWS API Documentation
Request Syntax
client.update_domain_metadata( FleetArn='string', DomainName='string', DisplayName='string' )
string
[REQUIRED]
The ARN of the fleet.
string
[REQUIRED]
The name of the domain.
string
The name to display.
dict
Response Syntax
{}
Response Structure
(dict) --
Updates the device policy configuration for the fleet.
See also: AWS API Documentation
Request Syntax
client.update_device_policy_configuration( FleetArn='string', DeviceCaCertificate='string' )
string
[REQUIRED]
The ARN of the fleet.
string
The certificate chain, including intermediate certificates and the root certificate authority certificate used to issue device certificates.
dict
Response Syntax
{}
Response Structure
(dict) --
Retrieves a list of certificate authorities added for the current account and Region.
See also: AWS API Documentation
Request Syntax
client.list_website_certificate_authorities( FleetArn='string', MaxResults=123, NextToken='string' )
string
[REQUIRED]
The ARN of the fleet.
integer
The maximum number of results to be included in the next page.
string
The pagination token used to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.
dict
Response Syntax
{ 'WebsiteCertificateAuthorities': [ { 'WebsiteCaId': 'string', 'CreatedTime': datetime(2015, 1, 1), 'DisplayName': 'string' }, ], 'NextToken': 'string' }
Response Structure
(dict) --
WebsiteCertificateAuthorities (list) --
Information about the certificates.
(dict) --
The summary of the certificate authority (CA).
WebsiteCaId (string) --
A unique identifier for the CA.
CreatedTime (datetime) --
The time when the CA was added.
DisplayName (string) --
The name to display.
NextToken (string) --
The pagination token used to retrieve the next page of results for this operation. If there are no more pages, this value is null.
Associates a website authorization provider with a specified fleet. This is used to authorize users against associated websites in the company network.
See also: AWS API Documentation
Request Syntax
client.associate_website_authorization_provider( FleetArn='string', AuthorizationProviderType='SAML', DomainName='string' )
string
[REQUIRED]
The ARN of the fleet.
string
[REQUIRED]
The authorization provider type.
string
The domain name of the authorization provider. This applies only to SAML-based authorization providers.
dict
Response Syntax
{ 'AuthorizationProviderId': 'string' }
Response Structure
(dict) --
AuthorizationProviderId (string) --
A unique identifier for the authorization provider.
Disassociates a domain from Amazon WorkLink. End users lose the ability to access the domain with Amazon WorkLink.
See also: AWS API Documentation
Request Syntax
client.disassociate_domain( FleetArn='string', DomainName='string' )
string
[REQUIRED]
The ARN of the fleet.
string
[REQUIRED]
The name of the domain.
dict
Response Syntax
{}
Response Structure
(dict) --
Retrieves a list of domains associated to a specified fleet.
See also: AWS API Documentation
Request Syntax
client.list_domains( FleetArn='string', NextToken='string', MaxResults=123 )
string
[REQUIRED]
The ARN of the fleet.
string
The pagination token used to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.
integer
The maximum number of results to be included in the next page.
dict
Response Syntax
{ 'Domains': [ { 'DomainName': 'string', 'DisplayName': 'string', 'CreatedTime': datetime(2015, 1, 1), 'DomainStatus': 'PENDING_VALIDATION'|'ASSOCIATING'|'ACTIVE'|'INACTIVE'|'DISASSOCIATING'|'DISASSOCIATED'|'FAILED_TO_ASSOCIATE'|'FAILED_TO_DISASSOCIATE' }, ], 'NextToken': 'string' }
Response Structure
(dict) --
Domains (list) --
Information about the domains.
(dict) --
The summary of the domain.
DomainName (string) --
The name of the domain.
DisplayName (string) --
The name to display.
CreatedTime (datetime) --
The time that the domain was created.
DomainStatus (string) --
The status of the domain.
NextToken (string) --
The pagination token used to retrieve the next page of results for this operation. If there are no more pages, this value is null.
Retrieves a list of tags for the specified resource.
See also: AWS API Documentation
Request Syntax
client.list_tags_for_resource( ResourceArn='string' )
string
[REQUIRED]
The Amazon Resource Name (ARN) of the fleet.
dict
Response Syntax
{ 'Tags': { 'string': 'string' } }
Response Structure
(dict) --
Tags (dict) --
The tags attached to the resource. A tag is a key-value pair.
(string) --
(string) --
Describes the identity provider configuration of the specified fleet.
See also: AWS API Documentation
Request Syntax
client.describe_identity_provider_configuration( FleetArn='string' )
string
[REQUIRED]
The ARN of the fleet.
dict
Response Syntax
{ 'IdentityProviderType': 'SAML', 'ServiceProviderSamlMetadata': 'string', 'IdentityProviderSamlMetadata': 'string' }
Response Structure
(dict) --
IdentityProviderType (string) --
The type of identity provider.
ServiceProviderSamlMetadata (string) --
The SAML metadata document uploaded to the user’s identity provider.
IdentityProviderSamlMetadata (string) --
The SAML metadata document provided by the user’s identity provider.
Provides information about a user's device.
See also: AWS API Documentation
Request Syntax
client.describe_device( FleetArn='string', DeviceId='string' )
string
[REQUIRED]
The ARN of the fleet.
string
[REQUIRED]
A unique identifier for a registered user's device.
dict
Response Syntax
{ 'Status': 'ACTIVE'|'SIGNED_OUT', 'Model': 'string', 'Manufacturer': 'string', 'OperatingSystem': 'string', 'OperatingSystemVersion': 'string', 'PatchLevel': 'string', 'FirstAccessedTime': datetime(2015, 1, 1), 'LastAccessedTime': datetime(2015, 1, 1), 'Username': 'string' }
Response Structure
(dict) --
Status (string) --
The current state of the device.
Model (string) --
The model of the device.
Manufacturer (string) --
The manufacturer of the device.
OperatingSystem (string) --
The operating system of the device.
OperatingSystemVersion (string) --
The operating system version of the device.
PatchLevel (string) --
The operating system patch level of the device.
FirstAccessedTime (datetime) --
The date that the device first signed in to Amazon WorkLink.
LastAccessedTime (datetime) --
The date that the device last accessed Amazon WorkLink.
Username (string) --
The user name associated with the device.
Retrieves a list of devices registered with the specified fleet.
See also: AWS API Documentation
Request Syntax
client.list_devices( FleetArn='string', NextToken='string', MaxResults=123 )
string
[REQUIRED]
The ARN of the fleet.
string
The pagination token used to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.
integer
The maximum number of results to be included in the next page.
dict
Response Syntax
{ 'Devices': [ { 'DeviceId': 'string', 'DeviceStatus': 'ACTIVE'|'SIGNED_OUT' }, ], 'NextToken': 'string' }
Response Structure
(dict) --
Devices (list) --
Information about the devices.
(dict) --
The summary of devices.
DeviceId (string) --
The ID of the device.
DeviceStatus (string) --
The status of the device.
NextToken (string) --
The pagination token used to retrieve the next page of results for this operation. If there are no more pages, this value is null.
Provides basic information for the specified fleet, excluding identity provider, networking, and device configuration details.
See also: AWS API Documentation
Request Syntax
client.describe_fleet_metadata( FleetArn='string' )
string
[REQUIRED]
The Amazon Resource Name (ARN) of the fleet.
dict
Response Syntax
{ 'CreatedTime': datetime(2015, 1, 1), 'LastUpdatedTime': datetime(2015, 1, 1), 'FleetName': 'string', 'DisplayName': 'string', 'OptimizeForEndUserLocation': True|False, 'CompanyCode': 'string', 'FleetStatus': 'CREATING'|'ACTIVE'|'DELETING'|'DELETED'|'FAILED_TO_CREATE'|'FAILED_TO_DELETE', 'Tags': { 'string': 'string' } }
Response Structure
(dict) --
CreatedTime (datetime) --
The time that the fleet was created.
LastUpdatedTime (datetime) --
The time that the fleet was last updated.
FleetName (string) --
The name of the fleet.
DisplayName (string) --
The name to display.
OptimizeForEndUserLocation (boolean) --
The option to optimize for better performance by routing traffic through the closest AWS Region to users, which may be outside of your home Region.
CompanyCode (string) --
The identifier used by users to sign in to the Amazon WorkLink app.
FleetStatus (string) --
The current state of the fleet.
Tags (dict) --
The tags attached to the resource. A tag is a key-value pair.
(string) --
(string) --
Updates the identity provider configuration for the fleet.
See also: AWS API Documentation
Request Syntax
client.update_identity_provider_configuration( FleetArn='string', IdentityProviderType='SAML', IdentityProviderSamlMetadata='string' )
string
[REQUIRED]
The ARN of the fleet.
string
[REQUIRED]
The type of identity provider.
string
The SAML metadata document provided by the customer’s identity provider. The existing IdentityProviderSamlMetadata is unset if null is passed.
dict
Response Syntax
{}
Response Structure
(dict) --
Retrieves a list of fleets for the current account and Region.
See also: AWS API Documentation
Request Syntax
client.list_fleets( NextToken='string', MaxResults=123 )
string
The pagination token used to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.
integer
The maximum number of results to be included in the next page.
dict
Response Syntax
{ 'FleetSummaryList': [ { 'FleetArn': 'string', 'CreatedTime': datetime(2015, 1, 1), 'LastUpdatedTime': datetime(2015, 1, 1), 'FleetName': 'string', 'DisplayName': 'string', 'CompanyCode': 'string', 'FleetStatus': 'CREATING'|'ACTIVE'|'DELETING'|'DELETED'|'FAILED_TO_CREATE'|'FAILED_TO_DELETE', 'Tags': { 'string': 'string' } }, ], 'NextToken': 'string' }
Response Structure
(dict) --
FleetSummaryList (list) --
The summary list of the fleets.
(dict) --
The summary of the fleet.
FleetArn (string) --
The Amazon Resource Name (ARN) of the fleet.
CreatedTime (datetime) --
The time when the fleet was created.
LastUpdatedTime (datetime) --
The time when the fleet was last updated.
FleetName (string) --
The name of the fleet.
DisplayName (string) --
The name of the fleet to display.
CompanyCode (string) --
The identifier used by users to sign into the Amazon WorkLink app.
FleetStatus (string) --
The status of the fleet.
Tags (dict) --
The tags attached to the resource. A tag is a key-value pair.
(string) --
(string) --
NextToken (string) --
The pagination token used to retrieve the next page of results for this operation. If there are no more pages, this value is null.
Imports the root certificate of a certificate authority (CA) used to obtain TLS certificates used by associated websites within the company network.
See also: AWS API Documentation
Request Syntax
client.associate_website_certificate_authority( FleetArn='string', Certificate='string', DisplayName='string' )
string
[REQUIRED]
The ARN of the fleet.
string
[REQUIRED]
The root certificate of the CA.
string
The certificate name to display.
dict
Response Syntax
{ 'WebsiteCaId': 'string' }
Response Structure
(dict) --
WebsiteCaId (string) --
A unique identifier for the CA.
Updates the company network configuration for the fleet.
See also: AWS API Documentation
Request Syntax
client.update_company_network_configuration( FleetArn='string', VpcId='string', SubnetIds=[ 'string', ], SecurityGroupIds=[ 'string', ] )
string
[REQUIRED]
The ARN of the fleet.
string
[REQUIRED]
The VPC with connectivity to associated websites.
list
[REQUIRED]
The subnets used for X-ENI connections from Amazon WorkLink rendering containers.
(string) --
list
[REQUIRED]
The security groups associated with access to the provided subnets.
(string) --
dict
Response Syntax
{}
Response Structure
(dict) --
Describes the networking configuration to access the internal websites associated with the specified fleet.
See also: AWS API Documentation
Request Syntax
client.describe_company_network_configuration( FleetArn='string' )
string
[REQUIRED]
The ARN of the fleet.
dict
Response Syntax
{ 'VpcId': 'string', 'SubnetIds': [ 'string', ], 'SecurityGroupIds': [ 'string', ] }
Response Structure
(dict) --
VpcId (string) --
The VPC with connectivity to associated websites.
SubnetIds (list) --
The subnets used for X-ENI connections from Amazon WorkLink rendering containers.
(string) --
SecurityGroupIds (list) --
The security groups associated with access to the provided subnets.
(string) --
Provides information about the certificate authority.
See also: AWS API Documentation
Request Syntax
client.describe_website_certificate_authority( FleetArn='string', WebsiteCaId='string' )
string
[REQUIRED]
The ARN of the fleet.
string
[REQUIRED]
A unique identifier for the certificate authority.
dict
Response Syntax
{ 'Certificate': 'string', 'CreatedTime': datetime(2015, 1, 1), 'DisplayName': 'string' }
Response Structure
(dict) --
Certificate (string) --
The root certificate of the certificate authority.
CreatedTime (datetime) --
The time that the certificate authority was added.
DisplayName (string) --
The certificate name to display.
Moves a domain to INACTIVE status if it was in the ACTIVE status.
See also: AWS API Documentation
Request Syntax
client.revoke_domain_access( FleetArn='string', DomainName='string' )
string
[REQUIRED]
The ARN of the fleet.
string
[REQUIRED]
The name of the domain.
dict
Response Syntax
{}
Response Structure
(dict) --
Updates the audit stream configuration for the fleet.
See also: AWS API Documentation
Request Syntax
client.update_audit_stream_configuration( FleetArn='string', AuditStreamArn='string' )
string
[REQUIRED]
The ARN of the fleet.
string
The ARN of the Amazon Kinesis data stream that receives the audit events.
dict
Response Syntax
{}
Response Structure
(dict) --
Removes one or more tags from the specified resource.
See also: AWS API Documentation
Request Syntax
client.untag_resource( ResourceArn='string', TagKeys=[ 'string', ] )
string
[REQUIRED]
The Amazon Resource Name (ARN) of the fleet.
list
[REQUIRED]
The list of tag keys to remove from the resource.
(string) --
dict
Response Syntax
{}
Response Structure
(dict) --
Signs the user out from all of their devices. The user can sign in again if they have valid credentials.
See also: AWS API Documentation
Request Syntax
client.sign_out_user( FleetArn='string', Username='string' )
string
[REQUIRED]
The ARN of the fleet.
string
[REQUIRED]
The name of the user.
dict
Response Syntax
{}
Response Structure
(dict) --
Adds or overwrites one or more tags for the specified resource, such as a fleet. Each tag consists of a key and an optional value. If a resource already has a tag with the same key, this operation updates its value.
See also: AWS API Documentation
Request Syntax
client.tag_resource( ResourceArn='string', Tags={ 'string': 'string' } )
string
[REQUIRED]
The Amazon Resource Name (ARN) of the fleet.
dict
[REQUIRED]
The tags to add to the resource. A tag is a key-value pair.
(string) --
(string) --
dict
Response Syntax
{}
Response Structure
(dict) --
Creates a fleet. A fleet consists of resources and the configuration that delivers associated websites to authorized users who download and set up the Amazon WorkLink app.
See also: AWS API Documentation
Request Syntax
client.create_fleet( FleetName='string', DisplayName='string', OptimizeForEndUserLocation=True|False, Tags={ 'string': 'string' } )
string
[REQUIRED]
A unique name for the fleet.
string
The fleet name to display.
boolean
The option to optimize for better performance by routing traffic through the closest AWS Region to users, which may be outside of your home Region.
dict
The tags to add to the resource. A tag is a key-value pair.
(string) --
(string) --
dict
Response Syntax
{ 'FleetArn': 'string' }
Response Structure
(dict) --
FleetArn (string) --
The Amazon Resource Name (ARN) of the fleet.
Describes the device policy configuration for the specified fleet.
See also: AWS API Documentation
Request Syntax
client.describe_device_policy_configuration( FleetArn='string' )
string
[REQUIRED]
The ARN of the fleet.
dict
Response Syntax
{ 'DeviceCaCertificate': 'string' }
Response Structure
(dict) --
DeviceCaCertificate (string) --
The certificate chain, including intermediate certificates and the root certificate authority certificate used to issue device certificates.
Specifies a domain to be associated to Amazon WorkLink.
See also: AWS API Documentation
Request Syntax
client.associate_domain( FleetArn='string', DomainName='string', DisplayName='string', AcmCertificateArn='string' )
string
[REQUIRED]
The Amazon Resource Name (ARN) of the fleet.
string
[REQUIRED]
The fully qualified domain name (FQDN).
string
The name to display.
string
[REQUIRED]
The ARN of an issued ACM certificate that is valid for the domain being associated.
dict
Response Syntax
{}
Response Structure
(dict) --
Moves a domain to ACTIVE status if it was in the INACTIVE status.
See also: AWS API Documentation
Request Syntax
client.restore_domain_access( FleetArn='string', DomainName='string' )
string
[REQUIRED]
The ARN of the fleet.
string
[REQUIRED]
The name of the domain.
dict
Response Syntax
{}
Response Structure
(dict) --
Retrieves a list of website authorization providers associated with a specified fleet.
See also: AWS API Documentation
Request Syntax
client.list_website_authorization_providers( FleetArn='string', NextToken='string', MaxResults=123 )
string
[REQUIRED]
The ARN of the fleet.
string
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.
integer
The maximum number of results to be included in the next page.
dict
Response Syntax
{ 'WebsiteAuthorizationProviders': [ { 'AuthorizationProviderId': 'string', 'AuthorizationProviderType': 'SAML', 'DomainName': 'string', 'CreatedTime': datetime(2015, 1, 1) }, ], 'NextToken': 'string' }
Response Structure
(dict) --
WebsiteAuthorizationProviders (list) --
The website authorization providers.
(dict) --
The summary of the website authorization provider.
AuthorizationProviderId (string) --
A unique identifier for the authorization provider.
AuthorizationProviderType (string) --
The authorization provider type.
DomainName (string) --
The domain name of the authorization provider. This applies only to SAML-based authorization providers.
CreatedTime (datetime) --
The time of creation.
NextToken (string) --
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.