![]() |
![]()
| ![]() |
![]()
NAMEPaws::AppStream - Perl Interface to AWS Amazon AppStream SYNOPSISuse Paws; my $obj = Paws->service('AppStream'); my $res = $obj->Method( Arg1 => $val1, Arg2 => [ 'V1', 'V2' ], # if Arg3 is an object, the HashRef will be used as arguments to the constructor # of the arguments type Arg3 => { Att1 => 'Val1' }, # if Arg4 is an array of objects, the HashRefs will be passed as arguments to # the constructor of the arguments type Arg4 => [ { Att1 => 'Val1' }, { Att1 => 'Val2' } ], ); DESCRIPTIONAmazon AppStream 2.0 This is the Amazon AppStream 2.0 API Reference. This documentation provides descriptions and syntax for each of the actions and data types in AppStream 2.0. AppStream 2.0 is a fully managed, secure application streaming service that lets you stream desktop applications to users without rewriting applications. AppStream 2.0 manages the AWS resources that are required to host and run your applications, scales automatically, and provides access to your users on demand. You can call the AppStream 2.0 API operations by using an interface VPC endpoint (interface endpoint). For more information, see Access AppStream 2.0 API Operations and CLI Commands Through an Interface VPC Endpoint (https://docs.aws.amazon.com/appstream2/latest/developerguide/access-api-cli-through-interface-vpc-endpoint.html) in the Amazon AppStream 2.0 Administration Guide. To learn more about AppStream 2.0, see the following resources:
For the AWS API documentation, see <https://docs.aws.amazon.com/goto/WebAPI/appstream2-2016-12-01> METHODSAssociateFleetEach argument is described in detail in: Paws::AppStream::AssociateFleet Returns: a Paws::AppStream::AssociateFleetResult instance Associates the specified fleet with the specified stack. BatchAssociateUserStackEach argument is described in detail in: Paws::AppStream::BatchAssociateUserStack Returns: a Paws::AppStream::BatchAssociateUserStackResult instance Associates the specified users with the specified stacks. Users in a user pool cannot be assigned to stacks with fleets that are joined to an Active Directory domain. BatchDisassociateUserStackEach argument is described in detail in: Paws::AppStream::BatchDisassociateUserStack Returns: a Paws::AppStream::BatchDisassociateUserStackResult instance Disassociates the specified users from the specified stacks. CopyImage
Each argument is described in detail in: Paws::AppStream::CopyImage Returns: a Paws::AppStream::CopyImageResponse instance Copies the image within the same region or to a new region within the same AWS account. Note that any tags you added to the image will not be copied. CreateDirectoryConfig
Each argument is described in detail in: Paws::AppStream::CreateDirectoryConfig Returns: a Paws::AppStream::CreateDirectoryConfigResult instance Creates a Directory Config object in AppStream 2.0. This object includes the configuration information required to join fleets and image builders to Microsoft Active Directory domains. CreateFleet
Each argument is described in detail in: Paws::AppStream::CreateFleet Returns: a Paws::AppStream::CreateFleetResult instance Creates a fleet. A fleet consists of streaming instances that run a specified image. CreateImageBuilder
Each argument is described in detail in: Paws::AppStream::CreateImageBuilder Returns: a Paws::AppStream::CreateImageBuilderResult instance Creates an image builder. An image builder is a virtual machine that is used to create an image. The initial state of the builder is "PENDING". When it is ready, the state is "RUNNING". CreateImageBuilderStreamingURL
Each argument is described in detail in: Paws::AppStream::CreateImageBuilderStreamingURL Returns: a Paws::AppStream::CreateImageBuilderStreamingURLResult instance Creates a URL to start an image builder streaming session. CreateStack
Each argument is described in detail in: Paws::AppStream::CreateStack Returns: a Paws::AppStream::CreateStackResult instance Creates a stack to start streaming applications to users. A stack consists of an associated fleet, user access policies, and storage configurations. CreateStreamingURL
Each argument is described in detail in: Paws::AppStream::CreateStreamingURL Returns: a Paws::AppStream::CreateStreamingURLResult instance Creates a temporary URL to start an AppStream 2.0 streaming session for the specified user. A streaming URL enables application streaming to be tested without user setup. CreateUpdatedImage
Each argument is described in detail in: Paws::AppStream::CreateUpdatedImage Returns: a Paws::AppStream::CreateUpdatedImageResult instance Creates a new image with the latest Windows operating system updates, driver updates, and AppStream 2.0 agent software. For more information, see the "Update an Image by Using Managed AppStream 2.0 Image Updates" section in Administer Your AppStream 2.0 Images (https://docs.aws.amazon.com/appstream2/latest/developerguide/administer-images.html), in the Amazon AppStream 2.0 Administration Guide. CreateUsageReportSubscriptionEach argument is described in detail in: Paws::AppStream::CreateUsageReportSubscription Returns: a Paws::AppStream::CreateUsageReportSubscriptionResult instance Creates a usage report subscription. Usage reports are generated daily. CreateUser
Each argument is described in detail in: Paws::AppStream::CreateUser Returns: a Paws::AppStream::CreateUserResult instance Creates a new user in the user pool. DeleteDirectoryConfigEach argument is described in detail in: Paws::AppStream::DeleteDirectoryConfig Returns: a Paws::AppStream::DeleteDirectoryConfigResult instance Deletes the specified Directory Config object from AppStream 2.0. This object includes the information required to join streaming instances to an Active Directory domain. DeleteFleetEach argument is described in detail in: Paws::AppStream::DeleteFleet Returns: a Paws::AppStream::DeleteFleetResult instance Deletes the specified fleet. DeleteImageEach argument is described in detail in: Paws::AppStream::DeleteImage Returns: a Paws::AppStream::DeleteImageResult instance Deletes the specified image. You cannot delete an image when it is in use. After you delete an image, you cannot provision new capacity using the image. DeleteImageBuilderEach argument is described in detail in: Paws::AppStream::DeleteImageBuilder Returns: a Paws::AppStream::DeleteImageBuilderResult instance Deletes the specified image builder and releases the capacity. DeleteImagePermissionsEach argument is described in detail in: Paws::AppStream::DeleteImagePermissions Returns: a Paws::AppStream::DeleteImagePermissionsResult instance Deletes permissions for the specified private image. After you delete permissions for an image, AWS accounts to which you previously granted these permissions can no longer use the image. DeleteStackEach argument is described in detail in: Paws::AppStream::DeleteStack Returns: a Paws::AppStream::DeleteStackResult instance Deletes the specified stack. After the stack is deleted, the application streaming environment provided by the stack is no longer available to users. Also, any reservations made for application streaming sessions for the stack are released. DeleteUsageReportSubscriptionEach argument is described in detail in: Paws::AppStream::DeleteUsageReportSubscription Returns: a Paws::AppStream::DeleteUsageReportSubscriptionResult instance Disables usage report generation. DeleteUserEach argument is described in detail in: Paws::AppStream::DeleteUser Returns: a Paws::AppStream::DeleteUserResult instance Deletes a user from the user pool. DescribeDirectoryConfigs
Each argument is described in detail in: Paws::AppStream::DescribeDirectoryConfigs Returns: a Paws::AppStream::DescribeDirectoryConfigsResult instance Retrieves a list that describes one or more specified Directory Config objects for AppStream 2.0, if the names for these objects are provided. Otherwise, all Directory Config objects in the account are described. These objects include the configuration information required to join fleets and image builders to Microsoft Active Directory domains. Although the response syntax in this topic includes the account password, this password is not returned in the actual response. DescribeFleets
Each argument is described in detail in: Paws::AppStream::DescribeFleets Returns: a Paws::AppStream::DescribeFleetsResult instance Retrieves a list that describes one or more specified fleets, if the fleet names are provided. Otherwise, all fleets in the account are described. DescribeImageBuilders
Each argument is described in detail in: Paws::AppStream::DescribeImageBuilders Returns: a Paws::AppStream::DescribeImageBuildersResult instance Retrieves a list that describes one or more specified image builders, if the image builder names are provided. Otherwise, all image builders in the account are described. DescribeImagePermissions
Each argument is described in detail in: Paws::AppStream::DescribeImagePermissions Returns: a Paws::AppStream::DescribeImagePermissionsResult instance Retrieves a list that describes the permissions for shared AWS account IDs on a private image that you own. DescribeImages
Each argument is described in detail in: Paws::AppStream::DescribeImages Returns: a Paws::AppStream::DescribeImagesResult instance Retrieves a list that describes one or more specified images, if the image names or image ARNs are provided. Otherwise, all images in the account are described. DescribeSessions
Each argument is described in detail in: Paws::AppStream::DescribeSessions Returns: a Paws::AppStream::DescribeSessionsResult instance Retrieves a list that describes the streaming sessions for a specified stack and fleet. If a UserId is provided for the stack and fleet, only streaming sessions for that user are described. If an authentication type is not provided, the default is to authenticate users using a streaming URL. DescribeStacks
Each argument is described in detail in: Paws::AppStream::DescribeStacks Returns: a Paws::AppStream::DescribeStacksResult instance Retrieves a list that describes one or more specified stacks, if the stack names are provided. Otherwise, all stacks in the account are described. DescribeUsageReportSubscriptions
Each argument is described in detail in: Paws::AppStream::DescribeUsageReportSubscriptions Returns: a Paws::AppStream::DescribeUsageReportSubscriptionsResult instance Retrieves a list that describes one or more usage report subscriptions. DescribeUsers
Each argument is described in detail in: Paws::AppStream::DescribeUsers Returns: a Paws::AppStream::DescribeUsersResult instance Retrieves a list that describes one or more specified users in the user pool. DescribeUserStackAssociations
Each argument is described in detail in: Paws::AppStream::DescribeUserStackAssociations Returns: a Paws::AppStream::DescribeUserStackAssociationsResult instance Retrieves a list that describes the UserStackAssociation objects. You must specify either or both of the following:
DisableUserEach argument is described in detail in: Paws::AppStream::DisableUser Returns: a Paws::AppStream::DisableUserResult instance Disables the specified user in the user pool. Users can't sign in to AppStream 2.0 until they are re-enabled. This action does not delete the user. DisassociateFleetEach argument is described in detail in: Paws::AppStream::DisassociateFleet Returns: a Paws::AppStream::DisassociateFleetResult instance Disassociates the specified fleet from the specified stack. EnableUserEach argument is described in detail in: Paws::AppStream::EnableUser Returns: a Paws::AppStream::EnableUserResult instance Enables a user in the user pool. After being enabled, users can sign in to AppStream 2.0 and open applications from the stacks to which they are assigned. ExpireSessionEach argument is described in detail in: Paws::AppStream::ExpireSession Returns: a Paws::AppStream::ExpireSessionResult instance Immediately stops the specified streaming session. ListAssociatedFleets
Each argument is described in detail in: Paws::AppStream::ListAssociatedFleets Returns: a Paws::AppStream::ListAssociatedFleetsResult instance Retrieves the name of the fleet that is associated with the specified stack. ListAssociatedStacks
Each argument is described in detail in: Paws::AppStream::ListAssociatedStacks Returns: a Paws::AppStream::ListAssociatedStacksResult instance Retrieves the name of the stack with which the specified fleet is associated. ListTagsForResourceEach argument is described in detail in: Paws::AppStream::ListTagsForResource Returns: a Paws::AppStream::ListTagsForResourceResponse instance Retrieves a list of all tags for the specified AppStream 2.0 resource. You can tag AppStream 2.0 image builders, images, fleets, and stacks. For more information about tags, see Tagging Your Resources (https://docs.aws.amazon.com/appstream2/latest/developerguide/tagging-basic.html) in the Amazon AppStream 2.0 Administration Guide. StartFleetEach argument is described in detail in: Paws::AppStream::StartFleet Returns: a Paws::AppStream::StartFleetResult instance Starts the specified fleet. StartImageBuilder
Each argument is described in detail in: Paws::AppStream::StartImageBuilder Returns: a Paws::AppStream::StartImageBuilderResult instance Starts the specified image builder. StopFleetEach argument is described in detail in: Paws::AppStream::StopFleet Returns: a Paws::AppStream::StopFleetResult instance Stops the specified fleet. StopImageBuilderEach argument is described in detail in: Paws::AppStream::StopImageBuilder Returns: a Paws::AppStream::StopImageBuilderResult instance Stops the specified image builder. TagResourceEach argument is described in detail in: Paws::AppStream::TagResource Returns: a Paws::AppStream::TagResourceResponse instance Adds or overwrites one or more tags for the specified AppStream 2.0 resource. You can tag AppStream 2.0 image builders, images, fleets, and stacks. 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. To list the current tags for your resources, use ListTagsForResource. To disassociate tags from your resources, use UntagResource. For more information about tags, see Tagging Your Resources (https://docs.aws.amazon.com/appstream2/latest/developerguide/tagging-basic.html) in the Amazon AppStream 2.0 Administration Guide. UntagResourceEach argument is described in detail in: Paws::AppStream::UntagResource Returns: a Paws::AppStream::UntagResourceResponse instance Disassociates one or more specified tags from the specified AppStream 2.0 resource. To list the current tags for your resources, use ListTagsForResource. For more information about tags, see Tagging Your Resources (https://docs.aws.amazon.com/appstream2/latest/developerguide/tagging-basic.html) in the Amazon AppStream 2.0 Administration Guide. UpdateDirectoryConfig
Each argument is described in detail in: Paws::AppStream::UpdateDirectoryConfig Returns: a Paws::AppStream::UpdateDirectoryConfigResult instance Updates the specified Directory Config object in AppStream 2.0. This object includes the configuration information required to join fleets and image builders to Microsoft Active Directory domains. UpdateFleet
Each argument is described in detail in: Paws::AppStream::UpdateFleet Returns: a Paws::AppStream::UpdateFleetResult instance Updates the specified fleet. If the fleet is in the "STOPPED" state, you can update any attribute except the fleet name. If the fleet is in the "RUNNING" state, you can update the "DisplayName", "ComputeCapacity", "ImageARN", "ImageName", "IdleDisconnectTimeoutInSeconds", and "DisconnectTimeoutInSeconds" attributes. If the fleet is in the "STARTING" or "STOPPING" state, you can't update it. UpdateImagePermissionsEach argument is described in detail in: Paws::AppStream::UpdateImagePermissions Returns: a Paws::AppStream::UpdateImagePermissionsResult instance Adds or updates permissions for the specified private image. UpdateStack
Each argument is described in detail in: Paws::AppStream::UpdateStack Returns: a Paws::AppStream::UpdateStackResult instance Updates the specified fields for the specified stack. PAGINATORSPaginator methods are helpers that repetively call methods that return partial results DescribeAllDirectoryConfigs(sub { },[DirectoryNames => ArrayRef[Str|Undef], MaxResults => Int, NextToken => Str])DescribeAllDirectoryConfigs([DirectoryNames => ArrayRef[Str|Undef], MaxResults => Int, NextToken => Str])If passed a sub as first parameter, it will call the sub for each element found in : - DirectoryConfigs, passing the object as the first parameter, and the string 'DirectoryConfigs' as the second parameter If not, it will return a a Paws::AppStream::DescribeDirectoryConfigsResult instance with all the "param"s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory. DescribeAllFleets(sub { },[Names => ArrayRef[Str|Undef], NextToken => Str])DescribeAllFleets([Names => ArrayRef[Str|Undef], NextToken => Str])If passed a sub as first parameter, it will call the sub for each element found in : - Fleets, passing the object as the first parameter, and the string 'Fleets' as the second parameter If not, it will return a a Paws::AppStream::DescribeFleetsResult instance with all the "param"s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory. DescribeAllImageBuilders(sub { },[MaxResults => Int, Names => ArrayRef[Str|Undef], NextToken => Str])DescribeAllImageBuilders([MaxResults => Int, Names => ArrayRef[Str|Undef], NextToken => Str])If passed a sub as first parameter, it will call the sub for each element found in : - ImageBuilders, passing the object as the first parameter, and the string 'ImageBuilders' as the second parameter If not, it will return a a Paws::AppStream::DescribeImageBuildersResult instance with all the "param"s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory. DescribeAllImages(sub { },[Arns => ArrayRef[Str|Undef], MaxResults => Int, Names => ArrayRef[Str|Undef], NextToken => Str, Type => Str])DescribeAllImages([Arns => ArrayRef[Str|Undef], MaxResults => Int, Names => ArrayRef[Str|Undef], NextToken => Str, Type => Str])If passed a sub as first parameter, it will call the sub for each element found in : - Images, passing the object as the first parameter, and the string 'Images' as the second parameter If not, it will return a a Paws::AppStream::DescribeImagesResult instance with all the "param"s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory. DescribeAllSessions(sub { },FleetName => Str, StackName => Str, [AuthenticationType => Str, Limit => Int, NextToken => Str, UserId => Str])DescribeAllSessions(FleetName => Str, StackName => Str, [AuthenticationType => Str, Limit => Int, NextToken => Str, UserId => Str])If passed a sub as first parameter, it will call the sub for each element found in : - Sessions, passing the object as the first parameter, and the string 'Sessions' as the second parameter If not, it will return a a Paws::AppStream::DescribeSessionsResult instance with all the "param"s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory. DescribeAllStacks(sub { },[Names => ArrayRef[Str|Undef], NextToken => Str])DescribeAllStacks([Names => ArrayRef[Str|Undef], NextToken => Str])If passed a sub as first parameter, it will call the sub for each element found in : - Stacks, passing the object as the first parameter, and the string 'Stacks' as the second parameter If not, it will return a a Paws::AppStream::DescribeStacksResult instance with all the "param"s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory. DescribeAllUsers(sub { },AuthenticationType => Str, [MaxResults => Int, NextToken => Str])DescribeAllUsers(AuthenticationType => Str, [MaxResults => Int, NextToken => Str])If passed a sub as first parameter, it will call the sub for each element found in : - Users, passing the object as the first parameter, and the string 'Users' as the second parameter If not, it will return a a Paws::AppStream::DescribeUsersResult instance with all the "param"s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory. DescribeAllUserStackAssociations(sub { },[AuthenticationType => Str, MaxResults => Int, NextToken => Str, StackName => Str, UserName => Str])DescribeAllUserStackAssociations([AuthenticationType => Str, MaxResults => Int, NextToken => Str, StackName => Str, UserName => Str])If passed a sub as first parameter, it will call the sub for each element found in : - UserStackAssociations, passing the object as the first parameter, and the string 'UserStackAssociations' as the second parameter If not, it will return a a Paws::AppStream::DescribeUserStackAssociationsResult instance with all the "param"s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory. ListAllAssociatedFleets(sub { },StackName => Str, [NextToken => Str])ListAllAssociatedFleets(StackName => Str, [NextToken => Str])If passed a sub as first parameter, it will call the sub for each element found in : - Names, passing the object as the first parameter, and the string 'Names' as the second parameter If not, it will return a a Paws::AppStream::ListAssociatedFleetsResult instance with all the "param"s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory. ListAllAssociatedStacks(sub { },FleetName => Str, [NextToken => Str])ListAllAssociatedStacks(FleetName => Str, [NextToken => Str])If passed a sub as first parameter, it will call the sub for each element found in : - Names, passing the object as the first parameter, and the string 'Names' as the second parameter If not, it will return a a Paws::AppStream::ListAssociatedStacksResult instance with all the "param"s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory. SEE ALSOThis service class forms part of Paws BUGS and CONTRIBUTIONSThe source code is located here: <https://github.com/pplu/aws-sdk-perl> Please report bugs to: <https://github.com/pplu/aws-sdk-perl/issues>
|