aws-sdk-workspaces 1.56.0 → 1.57.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d744c28322568927e2f029fe06e12bb9fa84f3c30ffc7a69cde3f70ace536fc7
-  data.tar.gz: 4963fcbe3a97f0f3f43b3190b1132c79da09b862d6193da8620ee7dd1dfb0a09
+  metadata.gz: 582afd683dcae06804e3e3d69f69d4bac644d7a2c4d2bde8717a60a8ac8f0e9a
+  data.tar.gz: e5188f5da0d5e0a8c584f3c5d71dc1259bff018601d5b96f7be0aa0773d15103
 SHA512:
-  metadata.gz: 502175c09328db19e59b895baf83aca03a1f00f2022b3d64766bba2dfb9793e53dac26e1723078dc00e004f9193014b1585133d4f46b0e3d5d3063e7add622c4
-  data.tar.gz: 57be9a89f44b72cbb67edb71616cf1c0ad7a90a7cdea35f4d33daead06b7e241c3abba813ac68867ca3dd4a017461e9e693adc3a24bb74e8b87bd5ff2b1db5e8
+  metadata.gz: f9b30aa3adcbd68381d2951f509d581a0d9d861b2d1e1847e534e4ae333182f26cc7e59bfcee742a3b3497bf49a497c6afbf304bbd9effa66fc2c83e552f84ca
+  data.tar.gz: e9bda8ca5722cea65c87cc82cd790d8c878563fdbb1734ca77711982a124e33b7db84c048c5b6d92a9f39c8149c3a0e7bc28040a3dc0effde96819a7c642122e

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.57.0 (2021-09-30)
+------------------
+
+* Feature - Added CreateUpdatedWorkspaceImage API to update WorkSpace images with latest software and drivers. Updated DescribeWorkspaceImages API to display if there are updates available for WorkSpace images.
+
 1.56.0 (2021-09-01)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.56.0
+1.57.0

data/lib/aws-sdk-workspaces/client.rb

@@ -448,18 +448,16 @@ module Aws::WorkSpaces
     # Region. For more information about copying images, see [ Copy a Custom
     # WorkSpaces Image][1].
     #
-    # <note markdown="1"> In the China (Ningxia) Region, you can copy images only within the
+    # In the China (Ningxia) Region, you can copy images only within the
     # same Region.
     #
-    #  In the AWS GovCloud (US-West) Region, to copy images to and from other
-    # AWS Regions, contact AWS Support.
-    #
-    #  </note>
+    # In Amazon Web Services GovCloud (US), to copy images to and from other
+    # Regions, contact Amazon Web Services Support.
     #
     # Before copying a shared image, be sure to verify that it has been
-    # shared from the correct AWS account. To determine if an image has been
-    # shared and to see the AWS account ID that owns an image, use the
-    # [DescribeWorkSpaceImages][2] and
+    # shared from the correct Amazon Web Services account. To determine if
+    # an image has been shared and to see the ID of the Amazon Web Services
+    # account that owns an image, use the [DescribeWorkSpaceImages][2] and
     # [DescribeWorkspaceImagePermissions][3] API operations.
     #
     #
@@ -528,10 +526,10 @@ module Aws::WorkSpaces
     #   (FQDN), such as `www.example.com`.
     #
     #   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.
+    #   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.
     #
     # @option params [Array<Types::Tag>] :tags
     #   The tags to associate with the connection alias.
@@ -662,6 +660,79 @@ module Aws::WorkSpaces
       req.send_request(options)
     end
 
+    # Creates a new updated WorkSpace image based on the specified source
+    # image. The new updated WorkSpace image has the latest drivers and
+    # other updates required by the Amazon WorkSpaces components.
+    #
+    # To determine which WorkSpace images need to be updated with the latest
+    # Amazon WorkSpaces requirements, use [ DescribeWorkspaceImages][1].
+    #
+    # <note markdown="1"> * Only Windows 10 WorkSpace images can be programmatically updated at
+    #   this time.
+    #
+    # * Microsoft Windows updates and other application updates are not
+    #   included in the update process.
+    #
+    # * The source WorkSpace image is not deleted. You can delete the source
+    #   image after you've verified your new updated image and created a
+    #   new bundle.
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/workspaces/latest/api/API_DescribeWorkspaceImages.html
+    #
+    # @option params [required, String] :name
+    #   The name of the new updated WorkSpace image.
+    #
+    # @option params [required, String] :description
+    #   A description of whether updates for the WorkSpace image are
+    #   available.
+    #
+    # @option params [required, String] :source_image_id
+    #   The identifier of the source WorkSpace image.
+    #
+    # @option params [Array<Types::Tag>] :tags
+    #   The tags that you want to add to the new updated WorkSpace image.
+    #
+    #   <note markdown="1"> 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`.
+    #
+    #    </note>
+    #
+    # @return [Types::CreateUpdatedWorkspaceImageResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateUpdatedWorkspaceImageResult#image_id #image_id} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_updated_workspace_image({
+    #     name: "WorkspaceImageName", # required
+    #     description: "WorkspaceImageDescription", # required
+    #     source_image_id: "WorkspaceImageId", # required
+    #     tags: [
+    #       {
+    #         key: "TagKey", # required
+    #         value: "TagValue",
+    #       },
+    #     ],
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.image_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/workspaces-2015-04-08/CreateUpdatedWorkspaceImage AWS API Documentation
+    #
+    # @overload create_updated_workspace_image(params = {})
+    # @param [Hash] params ({})
+    def create_updated_workspace_image(params = {}, options = {})
+      req = build_request(:create_updated_workspace_image, params)
+      req.send_request(options)
+    end
+
     # Creates the specified WorkSpace bundle. For more information about
     # creating WorkSpace bundles, see [ Create a Custom WorkSpaces Image and
     # Bundle][1].
@@ -995,8 +1066,8 @@ module Aws::WorkSpaces
     # use with WorkSpaces. If there are no WorkSpaces being used with your
     # Simple AD or AD Connector directory for 30 consecutive days, this
     # directory will be automatically deregistered for use with Amazon
-    # WorkSpaces, and you will be charged for this directory as per the [AWS
-    # Directory Services pricing terms][1].
+    # WorkSpaces, and you will be charged for this directory as per the
+    # [Directory Service pricing terms][1].
     #
     #  To delete empty directories, see [ Delete the Directory for Your
     # WorkSpaces][2]. If you delete your Simple AD or AD Connector
@@ -1125,9 +1196,9 @@ module Aws::WorkSpaces
     end
 
     # 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][1].
+    # granted to another Amazon Web Services account for the specified
+    # connection alias. For more information, see [ Cross-Region Redirection
+    # for Amazon WorkSpaces][1].
     #
     #
     #
@@ -1322,8 +1393,9 @@ module Aws::WorkSpaces
     #   The owner of the bundles. You cannot combine this parameter with any
     #   other filter.
     #
-    #   To describe the bundles provided by AWS, specify `AMAZON`. To describe
-    #   the bundles that belong to your account, don't specify a value.
+    #   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.
     #
     # @option params [String] :next_token
     #   The token for the next set of results. (You received this token from a
@@ -1447,7 +1519,7 @@ module Aws::WorkSpaces
     end
 
     # Describes the permissions that the owner of an image has granted to
-    # other AWS accounts for an image.
+    # other Amazon Web Services accounts for an image.
     #
     # @option params [required, String] :image_id
     #   The identifier of the image.
@@ -1533,6 +1605,8 @@ module Aws::WorkSpaces
     #   resp.images[0].error_message #=> String
     #   resp.images[0].created #=> Time
     #   resp.images[0].owner_account_id #=> String
+    #   resp.images[0].updates.update_available #=> Boolean
+    #   resp.images[0].updates.description #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/workspaces-2015-04-08/DescribeWorkspaceImages AWS API Documentation
@@ -1705,7 +1779,7 @@ module Aws::WorkSpaces
 
     # 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 [
+    # directories in different Regions. For more information, see [
     # Cross-Region Redirection for Amazon WorkSpaces][1].
     #
     # <note markdown="1"> Before performing this operation, call [ DescribeConnectionAliases][2]
@@ -1768,9 +1842,9 @@ module Aws::WorkSpaces
 
     # Imports the specified Windows 10 Bring Your Own License (BYOL) image
     # into Amazon WorkSpaces. The image must be an already licensed Amazon
-    # EC2 image that is in your AWS account, and you must own the image. For
-    # more information about creating BYOL images, see [ Bring Your Own
-    # Windows Desktop Licenses][1].
+    # EC2 image that is in your Amazon Web Services account, and you must
+    # own the image. For more information about creating BYOL images, see [
+    # Bring Your Own Windows Desktop Licenses][1].
     #
     #
     #
@@ -1851,9 +1925,9 @@ module Aws::WorkSpaces
     # that you can use for the network management interface when you enable
     # Bring Your Own License (BYOL).
     #
-    # This operation can be run only by AWS accounts that are enabled for
-    # BYOL. If your account isn't enabled for BYOL, you'll receive an
-    # `AccessDeniedException` error.
+    # This operation can be run only by Amazon Web Services accounts that
+    # are enabled for BYOL. If your account isn't enabled for BYOL, you'll
+    # receive an `AccessDeniedException` error.
     #
     # The management network interface is connected to a secure Amazon
     # WorkSpaces management network. It is used for interactive streaming of
@@ -2322,10 +2396,10 @@ module Aws::WorkSpaces
     # @option params [String] :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 AWS 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][1].
+    #   `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][1].
     #
     #
     #
@@ -2503,7 +2577,7 @@ module Aws::WorkSpaces
     #
     # Terminating a WorkSpace is a permanent action and cannot be undone.
     # The user's data is destroyed. If you need to archive any user data,
-    # contact AWS Support before terminating the WorkSpace.
+    # contact Amazon Web Services Support before terminating the WorkSpace.
     #
     # You can terminate a WorkSpace that is in any state except `SUSPENDED`.
     #
@@ -2519,8 +2593,8 @@ module Aws::WorkSpaces
     # use with WorkSpaces. If there are no WorkSpaces being used with your
     # Simple AD or AD Connector directory for 30 consecutive days, this
     # directory will be automatically deregistered for use with Amazon
-    # WorkSpaces, and you will be charged for this directory as per the [AWS
-    # Directory Services pricing terms][2].
+    # WorkSpaces, and you will be charged for this directory as per the
+    # [Directory Service pricing terms][2].
     #
     #  To delete empty directories, see [ Delete the Directory for Your
     # WorkSpaces][3]. If you delete your Simple AD or AD Connector
@@ -2600,7 +2674,7 @@ module Aws::WorkSpaces
     #
     # @option params [required, Types::ConnectionAliasPermission] :connection_alias_permission
     #   Indicates whether to share or unshare the connection alias with the
-    #   specified AWS account.
+    #   specified Amazon Web Services account.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -2692,22 +2766,20 @@ module Aws::WorkSpaces
       req.send_request(options)
     end
 
-    # Shares or unshares an image with one account in the same AWS Region by
-    # specifying whether that account has permission to copy the image. If
-    # the copy image permission is granted, the image is shared with that
-    # account. If the copy image permission is revoked, the image is
-    # unshared with the account.
+    # Shares or unshares an image with one account in the same Amazon Web
+    # Services Region by specifying whether that account has permission to
+    # copy the image. If the copy image permission is granted, the image is
+    # shared with that account. If the copy image permission is revoked, the
+    # image is unshared with the account.
     #
     # After an image has been shared, the recipient account can copy the
-    # image to other AWS Regions as needed.
+    # image to other Regions as needed.
     #
-    # <note markdown="1"> In the China (Ningxia) Region, you can copy images only within the
+    # In the China (Ningxia) Region, you can copy images only within the
     # same Region.
     #
-    #  In the AWS GovCloud (US-West) Region, to copy images to and from other
-    # AWS Regions, contact AWS Support.
-    #
-    #  </note>
+    # In Amazon Web Services GovCloud (US), to copy images to and from other
+    # Regions, contact Amazon Web Services Support.
     #
     # For more information about sharing images, see [ Share or Unshare a
     # Custom WorkSpaces Image][1].
@@ -2715,10 +2787,11 @@ module Aws::WorkSpaces
     # <note markdown="1"> * To delete an image that has been shared, you must unshare the image
     #   before you delete it.
     #
-    # * Sharing Bring Your Own License (BYOL) images across AWS accounts
-    #   isn't supported at this time in the AWS GovCloud (US-West) Region.
-    #   To share BYOL images across accounts in the AWS GovCloud (US-West)
-    #   Region, contact AWS Support.
+    # * Sharing Bring Your Own License (BYOL) images across Amazon Web
+    #   Services accounts isn't supported at this time in Amazon Web
+    #   Services GovCloud (US). To share BYOL images across accounts in
+    #   Amazon Web Services GovCloud (US), contact Amazon Web Services
+    #   Support.
     #
     #  </note>
     #
@@ -2734,10 +2807,11 @@ module Aws::WorkSpaces
     #   after an image has been shared.
     #
     # @option params [required, String] :shared_account_id
-    #   The identifier of the AWS account to share or unshare the image with.
+    #   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
-    #   AWS account ID.
+    #   Amazon Web Services account ID.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -2771,7 +2845,7 @@ module Aws::WorkSpaces
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-workspaces'
-      context[:gem_version] = '1.56.0'
+      context[:gem_version] = '1.57.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-workspaces/client_api.rb

@@ -60,6 +60,8 @@ module Aws::WorkSpaces
     CreateIpGroupResult = Shapes::StructureShape.new(name: 'CreateIpGroupResult')
     CreateTagsRequest = Shapes::StructureShape.new(name: 'CreateTagsRequest')
     CreateTagsResult = Shapes::StructureShape.new(name: 'CreateTagsResult')
+    CreateUpdatedWorkspaceImageRequest = Shapes::StructureShape.new(name: 'CreateUpdatedWorkspaceImageRequest')
+    CreateUpdatedWorkspaceImageResult = Shapes::StructureShape.new(name: 'CreateUpdatedWorkspaceImageResult')
     CreateWorkspaceBundleRequest = Shapes::StructureShape.new(name: 'CreateWorkspaceBundleRequest')
     CreateWorkspaceBundleResult = Shapes::StructureShape.new(name: 'CreateWorkspaceBundleResult')
     CreateWorkspacesRequest = Shapes::StructureShape.new(name: 'CreateWorkspacesRequest')
@@ -238,6 +240,8 @@ module Aws::WorkSpaces
     UnsupportedWorkspaceConfigurationException = Shapes::StructureShape.new(name: 'UnsupportedWorkspaceConfigurationException')
     UpdateConnectionAliasPermissionRequest = Shapes::StructureShape.new(name: 'UpdateConnectionAliasPermissionRequest')
     UpdateConnectionAliasPermissionResult = Shapes::StructureShape.new(name: 'UpdateConnectionAliasPermissionResult')
+    UpdateDescription = Shapes::StringShape.new(name: 'UpdateDescription')
+    UpdateResult = Shapes::StructureShape.new(name: 'UpdateResult')
     UpdateRulesOfIpGroupRequest = Shapes::StructureShape.new(name: 'UpdateRulesOfIpGroupRequest')
     UpdateRulesOfIpGroupResult = Shapes::StructureShape.new(name: 'UpdateRulesOfIpGroupResult')
     UpdateWorkspaceBundleRequest = Shapes::StructureShape.new(name: 'UpdateWorkspaceBundleRequest')
@@ -388,6 +392,15 @@ module Aws::WorkSpaces
 
     CreateTagsResult.struct_class = Types::CreateTagsResult
 
+    CreateUpdatedWorkspaceImageRequest.add_member(:name, Shapes::ShapeRef.new(shape: WorkspaceImageName, required: true, location_name: "Name"))
+    CreateUpdatedWorkspaceImageRequest.add_member(:description, Shapes::ShapeRef.new(shape: WorkspaceImageDescription, required: true, location_name: "Description"))
+    CreateUpdatedWorkspaceImageRequest.add_member(:source_image_id, Shapes::ShapeRef.new(shape: WorkspaceImageId, required: true, location_name: "SourceImageId"))
+    CreateUpdatedWorkspaceImageRequest.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
+    CreateUpdatedWorkspaceImageRequest.struct_class = Types::CreateUpdatedWorkspaceImageRequest
+
+    CreateUpdatedWorkspaceImageResult.add_member(:image_id, Shapes::ShapeRef.new(shape: WorkspaceImageId, location_name: "ImageId"))
+    CreateUpdatedWorkspaceImageResult.struct_class = Types::CreateUpdatedWorkspaceImageResult
+
     CreateWorkspaceBundleRequest.add_member(:bundle_name, Shapes::ShapeRef.new(shape: WorkspaceBundleName, required: true, location_name: "BundleName"))
     CreateWorkspaceBundleRequest.add_member(:bundle_description, Shapes::ShapeRef.new(shape: WorkspaceBundleDescription, required: true, location_name: "BundleDescription"))
     CreateWorkspaceBundleRequest.add_member(:image_id, Shapes::ShapeRef.new(shape: WorkspaceImageId, required: true, location_name: "ImageId"))
@@ -847,6 +860,10 @@ module Aws::WorkSpaces
 
     UpdateConnectionAliasPermissionResult.struct_class = Types::UpdateConnectionAliasPermissionResult
 
+    UpdateResult.add_member(:update_available, Shapes::ShapeRef.new(shape: BooleanObject, location_name: "UpdateAvailable"))
+    UpdateResult.add_member(:description, Shapes::ShapeRef.new(shape: UpdateDescription, location_name: "Description"))
+    UpdateResult.struct_class = Types::UpdateResult
+
     UpdateRulesOfIpGroupRequest.add_member(:group_id, Shapes::ShapeRef.new(shape: IpGroupId, required: true, location_name: "GroupId"))
     UpdateRulesOfIpGroupRequest.add_member(:user_rules, Shapes::ShapeRef.new(shape: IpRuleList, required: true, location_name: "UserRules"))
     UpdateRulesOfIpGroupRequest.struct_class = Types::UpdateRulesOfIpGroupRequest
@@ -954,6 +971,7 @@ module Aws::WorkSpaces
     WorkspaceImage.add_member(:error_message, Shapes::ShapeRef.new(shape: Description, location_name: "ErrorMessage"))
     WorkspaceImage.add_member(:created, Shapes::ShapeRef.new(shape: Timestamp, location_name: "Created"))
     WorkspaceImage.add_member(:owner_account_id, Shapes::ShapeRef.new(shape: AwsAccount, location_name: "OwnerAccountId"))
+    WorkspaceImage.add_member(:updates, Shapes::ShapeRef.new(shape: UpdateResult, location_name: "Updates"))
     WorkspaceImage.struct_class = Types::WorkspaceImage
 
     WorkspaceImageIdList.member = Shapes::ShapeRef.new(shape: WorkspaceImageId)
@@ -1104,6 +1122,21 @@ module Aws::WorkSpaces
         o.errors << Shapes::ShapeRef.new(shape: ResourceLimitExceededException)
       end)
 
+      api.add_operation(:create_updated_workspace_image, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "CreateUpdatedWorkspaceImage"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: CreateUpdatedWorkspaceImageRequest)
+        o.output = Shapes::ShapeRef.new(shape: CreateUpdatedWorkspaceImageResult)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceLimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceAlreadyExistsException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: OperationNotSupportedException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidResourceStateException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterValuesException)
+      end)
+
       api.add_operation(:create_workspace_bundle, Seahorse::Model::Operation.new.tap do |o|
         o.name = "CreateWorkspaceBundle"
         o.http_method = "POST"

data/lib/aws-sdk-workspaces/types.rb

@@ -256,7 +256,8 @@ module Aws::WorkSpaces
     #   @return [String]
     #
     # @!attribute [rw] owner_account_id
-    #   The identifier of the AWS account that owns the connection alias.
+    #   The identifier of the Amazon Web Services account that owns the
+    #   connection alias.
     #   @return [String]
     #
     # @!attribute [rw] associations
@@ -288,8 +289,8 @@ module Aws::WorkSpaces
     #   @return [String]
     #
     # @!attribute [rw] associated_account_id
-    #   The identifier of the AWS account that associated the connection
-    #   alias with a directory.
+    #   The identifier of the Amazon Web Services account that associated
+    #   the connection alias with a directory.
     #   @return [String]
     #
     # @!attribute [rw] resource_id
@@ -330,13 +331,13 @@ module Aws::WorkSpaces
     #       }
     #
     # @!attribute [rw] shared_account_id
-    #   The identifier of the AWS account that the connection alias is
-    #   shared with.
+    #   The identifier of the Amazon Web Services account that the
+    #   connection alias is shared with.
     #   @return [String]
     #
     # @!attribute [rw] allow_association
-    #   Indicates whether the specified AWS account is allowed to associate
-    #   the connection alias with a directory.
+    #   Indicates whether the specified Amazon Web Services account is
+    #   allowed to associate the connection alias with a directory.
     #   @return [Boolean]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/workspaces-2015-04-08/ConnectionAliasPermission AWS API Documentation
@@ -426,10 +427,10 @@ module Aws::WorkSpaces
     #   (FQDN), such as `www.example.com`.
     #
     #   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.
+    #   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.
     #   @return [String]
     #
     # @!attribute [rw] tags
@@ -552,6 +553,67 @@ module Aws::WorkSpaces
     #
     class CreateTagsResult < Aws::EmptyStructure; end
 
+    # @note When making an API call, you may pass CreateUpdatedWorkspaceImageRequest
+    #   data as a hash:
+    #
+    #       {
+    #         name: "WorkspaceImageName", # required
+    #         description: "WorkspaceImageDescription", # required
+    #         source_image_id: "WorkspaceImageId", # required
+    #         tags: [
+    #           {
+    #             key: "TagKey", # required
+    #             value: "TagValue",
+    #           },
+    #         ],
+    #       }
+    #
+    # @!attribute [rw] name
+    #   The name of the new updated WorkSpace image.
+    #   @return [String]
+    #
+    # @!attribute [rw] description
+    #   A description of whether updates for the WorkSpace image are
+    #   available.
+    #   @return [String]
+    #
+    # @!attribute [rw] source_image_id
+    #   The identifier of the source WorkSpace image.
+    #   @return [String]
+    #
+    # @!attribute [rw] tags
+    #   The tags that you want to add to the new updated WorkSpace image.
+    #
+    #   <note markdown="1"> 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`.
+    #
+    #    </note>
+    #   @return [Array<Types::Tag>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/workspaces-2015-04-08/CreateUpdatedWorkspaceImageRequest AWS API Documentation
+    #
+    class CreateUpdatedWorkspaceImageRequest < Struct.new(
+      :name,
+      :description,
+      :source_image_id,
+      :tags)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] image_id
+    #   The identifier of the new updated WorkSpace image.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/workspaces-2015-04-08/CreateUpdatedWorkspaceImageResult AWS API Documentation
+    #
+    class CreateUpdatedWorkspaceImageResult < Struct.new(
+      :image_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass CreateWorkspaceBundleRequest
     #   data as a hash:
     #
@@ -1231,9 +1293,9 @@ module Aws::WorkSpaces
     #   The owner of the bundles. You cannot combine this parameter with any
     #   other filter.
     #
-    #   To describe the bundles provided by AWS, specify `AMAZON`. To
-    #   describe the bundles that belong to your account, don't specify a
-    #   value.
+    #   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.
     #   @return [String]
     #
     # @!attribute [rw] next_token
@@ -1358,8 +1420,8 @@ module Aws::WorkSpaces
     #   @return [String]
     #
     # @!attribute [rw] image_permissions
-    #   The identifiers of the AWS accounts that the image has been shared
-    #   with.
+    #   The identifiers of the Amazon Web Services accounts that the image
+    #   has been shared with.
     #   @return [Array<Types::ImagePermission>]
     #
     # @!attribute [rw] next_token
@@ -1704,17 +1766,17 @@ module Aws::WorkSpaces
       include Aws::Structure
     end
 
-    # Describes the AWS accounts that have been granted permission to use a
-    # shared image. For more information about sharing images, see [ Share
-    # or Unshare a Custom WorkSpaces Image][1].
+    # Describes the Amazon Web Services accounts that have been granted
+    # permission to use a shared image. For more information about sharing
+    # images, see [ Share or Unshare a Custom WorkSpaces Image][1].
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/workspaces/latest/adminguide/share-custom-image.html
     #
     # @!attribute [rw] shared_account_id
-    #   The identifier of the AWS account that an image has been shared
-    #   with.
+    #   The identifier of the Amazon Web Services account that an image has
+    #   been shared with.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/workspaces-2015-04-08/ImagePermission AWS API Documentation
@@ -2424,10 +2486,11 @@ module Aws::WorkSpaces
     # @!attribute [rw] 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 AWS 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][1].
+    #   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][1].
     #
     #
     #
@@ -2940,7 +3003,7 @@ module Aws::WorkSpaces
     #
     # @!attribute [rw] connection_alias_permission
     #   Indicates whether to share or unshare the connection alias with the
-    #   specified AWS account.
+    #   specified Amazon Web Services account.
     #   @return [Types::ConnectionAliasPermission]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/workspaces-2015-04-08/UpdateConnectionAliasPermissionRequest AWS API Documentation
@@ -2956,6 +3019,33 @@ module Aws::WorkSpaces
     #
     class UpdateConnectionAliasPermissionResult < Aws::EmptyStructure; end
 
+    # Describes whether a WorkSpace image needs to be updated with the
+    # latest drivers and other components required by Amazon WorkSpaces.
+    #
+    # <note markdown="1"> Only Windows 10 WorkSpace images can be programmatically updated at
+    # this time.
+    #
+    #  </note>
+    #
+    # @!attribute [rw] update_available
+    #   Indicates whether updated drivers or other components are available
+    #   for the specified WorkSpace image.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] description
+    #   A description of whether updates for the WorkSpace image are pending
+    #   or available.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/workspaces-2015-04-08/UpdateResult AWS API Documentation
+    #
+    class UpdateResult < Struct.new(
+      :update_available,
+      :description)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass UpdateRulesOfIpGroupRequest
     #   data as a hash:
     #
@@ -3038,11 +3128,11 @@ module Aws::WorkSpaces
     #   @return [Boolean]
     #
     # @!attribute [rw] shared_account_id
-    #   The identifier of the AWS account to share or unshare the image
-    #   with.
+    #   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 AWS account ID.
+    #   correct Amazon Web Services account ID.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/workspaces-2015-04-08/UpdateWorkspaceImagePermissionRequest AWS API Documentation
@@ -3087,8 +3177,7 @@ module Aws::WorkSpaces
     #   @return [String]
     #
     # @!attribute [rw] directory_id
-    #   The identifier of the AWS Directory Service directory for the
-    #   WorkSpace.
+    #   The identifier of the Directory Service directory for the WorkSpace.
     #   @return [String]
     #
     # @!attribute [rw] user_name
@@ -3144,9 +3233,8 @@ module Aws::WorkSpaces
     #   @return [String]
     #
     # @!attribute [rw] volume_encryption_key
-    #   The symmetric AWS KMS customer master key (CMK) used to encrypt data
-    #   stored on your WorkSpace. Amazon WorkSpaces does not support
-    #   asymmetric CMKs.
+    #   The symmetric KMS key used to encrypt data stored on your WorkSpace.
+    #   Amazon WorkSpaces does not support asymmetric KMS keys.
     #   @return [String]
     #
     # @!attribute [rw] user_volume_encryption_enabled
@@ -3211,26 +3299,12 @@ module Aws::WorkSpaces
     #
     # @!attribute [rw] device_type_windows
     #   Indicates whether users can use Windows clients to access their
-    #   WorkSpaces. To restrict WorkSpaces access to trusted devices (also
-    #   known as managed devices) with valid certificates, specify a value
-    #   of `TRUST`. For more information, see [Restrict WorkSpaces Access to
-    #   Trusted Devices][1].
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/workspaces/latest/adminguide/trusted-devices.html
+    #   WorkSpaces.
     #   @return [String]
     #
     # @!attribute [rw] device_type_osx
     #   Indicates whether users can use macOS clients to access their
-    #   WorkSpaces. To restrict WorkSpaces access to trusted devices (also
-    #   known as managed devices) with valid certificates, specify a value
-    #   of `TRUST`. For more information, see [Restrict WorkSpaces Access to
-    #   Trusted Devices][1].
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/workspaces/latest/adminguide/trusted-devices.html
+    #   WorkSpaces.
     #   @return [String]
     #
     # @!attribute [rw] device_type_web
@@ -3244,8 +3318,8 @@ module Aws::WorkSpaces
     #   @return [String]
     #
     # @!attribute [rw] device_type_android
-    #   Indicates whether users can use Android devices to access their
-    #   WorkSpaces.
+    #   Indicates whether users can use Android and Android-compatible
+    #   Chrome OS devices to access their WorkSpaces.
     #   @return [String]
     #
     # @!attribute [rw] device_type_chrome_os
@@ -3290,7 +3364,7 @@ module Aws::WorkSpaces
     #
     # @!attribute [rw] owner
     #   The owner of the bundle. This is the account identifier of the
-    #   owner, or `AMAZON` if the bundle is provided by AWS.
+    #   owner, or `AMAZON` if the bundle is provided by Amazon Web Services.
     #   @return [String]
     #
     # @!attribute [rw] description
@@ -3628,14 +3702,19 @@ module Aws::WorkSpaces
     #
     # @!attribute [rw] created
     #   The date when the image was created. If the image has been shared,
-    #   the AWS account that the image has been shared with sees the
-    #   original creation date of the image.
+    #   the Amazon Web Services account that the image has been shared with
+    #   sees the original creation date of the image.
     #   @return [Time]
     #
     # @!attribute [rw] owner_account_id
-    #   The identifier of the AWS account that owns the image.
+    #   The identifier of the Amazon Web Services account that owns the
+    #   image.
     #   @return [String]
     #
+    # @!attribute [rw] updates
+    #   The updates (if any) that are available for the specified image.
+    #   @return [Types::UpdateResult]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/workspaces-2015-04-08/WorkspaceImage AWS API Documentation
     #
     class WorkspaceImage < Struct.new(
@@ -3648,7 +3727,8 @@ module Aws::WorkSpaces
       :error_code,
       :error_message,
       :created,
-      :owner_account_id)
+      :owner_account_id,
+      :updates)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -3749,14 +3829,14 @@ module Aws::WorkSpaces
     #       }
     #
     # @!attribute [rw] directory_id
-    #   The identifier of the AWS Directory Service directory for the
-    #   WorkSpace. You can use DescribeWorkspaceDirectories to list the
-    #   available directories.
+    #   The identifier of the Directory Service directory for the WorkSpace.
+    #   You can use DescribeWorkspaceDirectories to list the available
+    #   directories.
     #   @return [String]
     #
     # @!attribute [rw] user_name
     #   The user name of the user for the WorkSpace. This user name must
-    #   exist in the AWS Directory Service directory for the WorkSpace.
+    #   exist in the Directory Service directory for the WorkSpace.
     #   @return [String]
     #
     # @!attribute [rw] bundle_id
@@ -3765,9 +3845,8 @@ module Aws::WorkSpaces
     #   @return [String]
     #
     # @!attribute [rw] volume_encryption_key
-    #   The symmetric AWS KMS customer master key (CMK) used to encrypt data
-    #   stored on your WorkSpace. Amazon WorkSpaces does not support
-    #   asymmetric CMKs.
+    #   The symmetric KMS key used to encrypt data stored on your WorkSpace.
+    #   Amazon WorkSpaces does not support asymmetric KMS keys.
     #   @return [String]
     #
     # @!attribute [rw] user_volume_encryption_enabled

data/lib/aws-sdk-workspaces.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-workspaces/customizations'
 # @!group service
 module Aws::WorkSpaces
 
-  GEM_VERSION = '1.56.0'
+  GEM_VERSION = '1.57.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-workspaces
 version: !ruby/object:Gem::Version
-  version: 1.56.0
+  version: 1.57.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-09-01 00:00:00.000000000 Z
+date: 2021-09-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core