aws-sdk-workspaces 1.27.0 → 1.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c4ff694f83486348a00a9cad023fe84c20285d3e
-  data.tar.gz: 48718773841a57f56ad5d618700cd7e5c15892c3
+  metadata.gz: f0cb46ce9b3f3759081c104a53e26083eec5a609
+  data.tar.gz: 1f62e40aec30db7c2d193805d0a0cee83c28f394
 SHA512:
-  metadata.gz: 83cff1d3c52db0df908d954824adcf2a4e355590fb0c70327f16178be6ed7e906fa605e3670d2c45cf1599a2f51ba10643ecf2c43ec4e9ea28af2d067781a66e
-  data.tar.gz: 671a29056ccfc1e1b86643e1aa8fd0b7d5f84793faeec31e348a2d90007c10a148a38e1e9ce2a0b0fe52c0d11f5a71e947ae71ad5d4f6d37e0359e1c00492bf5
+  metadata.gz: b4aea4fefbee3b26ccfacb6807d8b1e51b5e7a97d4435d88cb81f96fe1f1a3549889bc0d5a55c5d400b274bdbb35fc8ae3f9bd59df48fd1e65b58447780f1e03
+  data.tar.gz: 561894f80301d380a9f59b5dba7845cebcb397f5ebaa32a79a47c537ad2ce8daa6a7764c5476d0ca0f20f754187f503bd0d8f9ff4e473e93a62f254a387c9aec

data/lib/aws-sdk-workspaces.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-workspaces/customizations'
 # @service
 module Aws::WorkSpaces
 
-  GEM_VERSION = '1.27.0'
+  GEM_VERSION = '1.28.0'
 
 end

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

@@ -537,7 +537,7 @@ module Aws::WorkSpaces
     #   resp.pending_requests[0].directory_id #=> String
     #   resp.pending_requests[0].user_name #=> String
     #   resp.pending_requests[0].ip_address #=> String
-    #   resp.pending_requests[0].state #=> String, one of "PENDING", "AVAILABLE", "IMPAIRED", "UNHEALTHY", "REBOOTING", "STARTING", "REBUILDING", "MAINTENANCE", "ADMIN_MAINTENANCE", "TERMINATING", "TERMINATED", "SUSPENDED", "UPDATING", "STOPPING", "STOPPED", "ERROR"
+    #   resp.pending_requests[0].state #=> String, one of "PENDING", "AVAILABLE", "IMPAIRED", "UNHEALTHY", "REBOOTING", "STARTING", "REBUILDING", "RESTORING", "MAINTENANCE", "ADMIN_MAINTENANCE", "TERMINATING", "TERMINATED", "SUSPENDED", "UPDATING", "STOPPING", "STOPPED", "ERROR"
     #   resp.pending_requests[0].bundle_id #=> String
     #   resp.pending_requests[0].subnet_id #=> String
     #   resp.pending_requests[0].error_message #=> String
@@ -969,6 +969,38 @@ module Aws::WorkSpaces
       req.send_request(options)
     end
 
+    # Describes the snapshots for the specified WorkSpace.
+    #
+    # @option params [required, String] :workspace_id
+    #   The identifier of the WorkSpace.
+    #
+    # @return [Types::DescribeWorkspaceSnapshotsResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeWorkspaceSnapshotsResult#rebuild_snapshots #rebuild_snapshots} => Array<Types::Snapshot>
+    #   * {Types::DescribeWorkspaceSnapshotsResult#restore_snapshots #restore_snapshots} => Array<Types::Snapshot>
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_workspace_snapshots({
+    #     workspace_id: "WorkspaceId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.rebuild_snapshots #=> Array
+    #   resp.rebuild_snapshots[0].snapshot_time #=> Time
+    #   resp.restore_snapshots #=> Array
+    #   resp.restore_snapshots[0].snapshot_time #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/workspaces-2015-04-08/DescribeWorkspaceSnapshots AWS API Documentation
+    #
+    # @overload describe_workspace_snapshots(params = {})
+    # @param [Hash] params ({})
+    def describe_workspace_snapshots(params = {}, options = {})
+      req = build_request(:describe_workspace_snapshots, params)
+      req.send_request(options)
+    end
+
     # Describes the specified WorkSpaces.
     #
     # You can filter the results by using the bundle identifier, directory
@@ -1026,7 +1058,7 @@ module Aws::WorkSpaces
     #   resp.workspaces[0].directory_id #=> String
     #   resp.workspaces[0].user_name #=> String
     #   resp.workspaces[0].ip_address #=> String
-    #   resp.workspaces[0].state #=> String, one of "PENDING", "AVAILABLE", "IMPAIRED", "UNHEALTHY", "REBOOTING", "STARTING", "REBUILDING", "MAINTENANCE", "ADMIN_MAINTENANCE", "TERMINATING", "TERMINATED", "SUSPENDED", "UPDATING", "STOPPING", "STOPPED", "ERROR"
+    #   resp.workspaces[0].state #=> String, one of "PENDING", "AVAILABLE", "IMPAIRED", "UNHEALTHY", "REBOOTING", "STARTING", "REBUILDING", "RESTORING", "MAINTENANCE", "ADMIN_MAINTENANCE", "TERMINATING", "TERMINATED", "SUSPENDED", "UPDATING", "STOPPING", "STOPPED", "ERROR"
     #   resp.workspaces[0].bundle_id #=> String
     #   resp.workspaces[0].subnet_id #=> String
     #   resp.workspaces[0].error_message #=> String
@@ -1436,6 +1468,42 @@ module Aws::WorkSpaces
       req.send_request(options)
     end
 
+    # Restores the specified WorkSpace to its last known healthy state.
+    #
+    # You cannot restore a WorkSpace unless its state is ` AVAILABLE`,
+    # `ERROR`, or `UNHEALTHY`.
+    #
+    # Restoring a WorkSpace is a potentially destructive action that can
+    # result in the loss of data. For more information, see [Restore a
+    # WorkSpace][1].
+    #
+    # This operation is asynchronous and returns before the WorkSpace is
+    # completely restored.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/workspaces/latest/adminguide/restore-workspace.html
+    #
+    # @option params [required, String] :workspace_id
+    #   The identifier of the WorkSpace.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.restore_workspace({
+    #     workspace_id: "WorkspaceId", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/workspaces-2015-04-08/RestoreWorkspace AWS API Documentation
+    #
+    # @overload restore_workspace(params = {})
+    # @param [Hash] params ({})
+    def restore_workspace(params = {}, options = {})
+      req = build_request(:restore_workspace, params)
+      req.send_request(options)
+    end
+
     # Removes one or more rules from the specified IP access control group.
     #
     # @option params [required, String] :group_id
@@ -1627,7 +1695,7 @@ module Aws::WorkSpaces
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-workspaces'
-      context[:gem_version] = '1.27.0'
+      context[:gem_version] = '1.28.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -69,6 +69,8 @@ module Aws::WorkSpaces
     DescribeWorkspaceDirectoriesResult = Shapes::StructureShape.new(name: 'DescribeWorkspaceDirectoriesResult')
     DescribeWorkspaceImagesRequest = Shapes::StructureShape.new(name: 'DescribeWorkspaceImagesRequest')
     DescribeWorkspaceImagesResult = Shapes::StructureShape.new(name: 'DescribeWorkspaceImagesResult')
+    DescribeWorkspaceSnapshotsRequest = Shapes::StructureShape.new(name: 'DescribeWorkspaceSnapshotsRequest')
+    DescribeWorkspaceSnapshotsResult = Shapes::StructureShape.new(name: 'DescribeWorkspaceSnapshotsResult')
     DescribeWorkspacesConnectionStatusRequest = Shapes::StructureShape.new(name: 'DescribeWorkspacesConnectionStatusRequest')
     DescribeWorkspacesConnectionStatusResult = Shapes::StructureShape.new(name: 'DescribeWorkspacesConnectionStatusResult')
     DescribeWorkspacesRequest = Shapes::StructureShape.new(name: 'DescribeWorkspacesRequest')
@@ -147,6 +149,8 @@ module Aws::WorkSpaces
     ResourceLimitExceededException = Shapes::StructureShape.new(name: 'ResourceLimitExceededException')
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
     ResourceUnavailableException = Shapes::StructureShape.new(name: 'ResourceUnavailableException')
+    RestoreWorkspaceRequest = Shapes::StructureShape.new(name: 'RestoreWorkspaceRequest')
+    RestoreWorkspaceResult = Shapes::StructureShape.new(name: 'RestoreWorkspaceResult')
     RevokeIpRulesRequest = Shapes::StructureShape.new(name: 'RevokeIpRulesRequest')
     RevokeIpRulesResult = Shapes::StructureShape.new(name: 'RevokeIpRulesResult')
     RootStorage = Shapes::StructureShape.new(name: 'RootStorage')
@@ -154,6 +158,8 @@ module Aws::WorkSpaces
     RunningMode = Shapes::StringShape.new(name: 'RunningMode')
     RunningModeAutoStopTimeoutInMinutes = Shapes::IntegerShape.new(name: 'RunningModeAutoStopTimeoutInMinutes')
     SecurityGroupId = Shapes::StringShape.new(name: 'SecurityGroupId')
+    Snapshot = Shapes::StructureShape.new(name: 'Snapshot')
+    SnapshotList = Shapes::ListShape.new(name: 'SnapshotList')
     StartRequest = Shapes::StructureShape.new(name: 'StartRequest')
     StartWorkspaceRequests = Shapes::ListShape.new(name: 'StartWorkspaceRequests')
     StartWorkspacesRequest = Shapes::StructureShape.new(name: 'StartWorkspacesRequest')
@@ -368,6 +374,13 @@ module Aws::WorkSpaces
     DescribeWorkspaceImagesResult.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "NextToken"))
     DescribeWorkspaceImagesResult.struct_class = Types::DescribeWorkspaceImagesResult
 
+    DescribeWorkspaceSnapshotsRequest.add_member(:workspace_id, Shapes::ShapeRef.new(shape: WorkspaceId, required: true, location_name: "WorkspaceId"))
+    DescribeWorkspaceSnapshotsRequest.struct_class = Types::DescribeWorkspaceSnapshotsRequest
+
+    DescribeWorkspaceSnapshotsResult.add_member(:rebuild_snapshots, Shapes::ShapeRef.new(shape: SnapshotList, location_name: "RebuildSnapshots"))
+    DescribeWorkspaceSnapshotsResult.add_member(:restore_snapshots, Shapes::ShapeRef.new(shape: SnapshotList, location_name: "RestoreSnapshots"))
+    DescribeWorkspaceSnapshotsResult.struct_class = Types::DescribeWorkspaceSnapshotsResult
+
     DescribeWorkspacesConnectionStatusRequest.add_member(:workspace_ids, Shapes::ShapeRef.new(shape: WorkspaceIdList, location_name: "WorkspaceIds"))
     DescribeWorkspacesConnectionStatusRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "NextToken"))
     DescribeWorkspacesConnectionStatusRequest.struct_class = Types::DescribeWorkspacesConnectionStatusRequest
@@ -540,6 +553,11 @@ module Aws::WorkSpaces
     ResourceUnavailableException.add_member(:resource_id, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "ResourceId"))
     ResourceUnavailableException.struct_class = Types::ResourceUnavailableException
 
+    RestoreWorkspaceRequest.add_member(:workspace_id, Shapes::ShapeRef.new(shape: WorkspaceId, required: true, location_name: "WorkspaceId"))
+    RestoreWorkspaceRequest.struct_class = Types::RestoreWorkspaceRequest
+
+    RestoreWorkspaceResult.struct_class = Types::RestoreWorkspaceResult
+
     RevokeIpRulesRequest.add_member(:group_id, Shapes::ShapeRef.new(shape: IpGroupId, required: true, location_name: "GroupId"))
     RevokeIpRulesRequest.add_member(:user_rules, Shapes::ShapeRef.new(shape: IpRevokedRuleList, required: true, location_name: "UserRules"))
     RevokeIpRulesRequest.struct_class = Types::RevokeIpRulesRequest
@@ -549,6 +567,11 @@ module Aws::WorkSpaces
     RootStorage.add_member(:capacity, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "Capacity"))
     RootStorage.struct_class = Types::RootStorage
 
+    Snapshot.add_member(:snapshot_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "SnapshotTime"))
+    Snapshot.struct_class = Types::Snapshot
+
+    SnapshotList.member = Shapes::ShapeRef.new(shape: Snapshot)
+
     StartRequest.add_member(:workspace_id, Shapes::ShapeRef.new(shape: WorkspaceId, location_name: "WorkspaceId"))
     StartRequest.struct_class = Types::StartRequest
 
@@ -910,6 +933,17 @@ module Aws::WorkSpaces
         o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
       end)
 
+      api.add_operation(:describe_workspace_snapshots, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DescribeWorkspaceSnapshots"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: DescribeWorkspaceSnapshotsRequest)
+        o.output = Shapes::ShapeRef.new(shape: DescribeWorkspaceSnapshotsResult)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterValuesException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+      end)
+
       api.add_operation(:describe_workspaces, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DescribeWorkspaces"
         o.http_method = "POST"
@@ -1037,6 +1071,17 @@ module Aws::WorkSpaces
         o.output = Shapes::ShapeRef.new(shape: RebuildWorkspacesResult)
       end)
 
+      api.add_operation(:restore_workspace, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "RestoreWorkspace"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: RestoreWorkspaceRequest)
+        o.output = Shapes::ShapeRef.new(shape: RestoreWorkspaceResult)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterValuesException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+      end)
+
       api.add_operation(:revoke_ip_rules, Seahorse::Model::Operation.new.tap do |o|
         o.name = "RevokeIpRules"
         o.http_method = "POST"

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

@@ -816,6 +816,43 @@ module Aws::WorkSpaces
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass DescribeWorkspaceSnapshotsRequest
+    #   data as a hash:
+    #
+    #       {
+    #         workspace_id: "WorkspaceId", # required
+    #       }
+    #
+    # @!attribute [rw] workspace_id
+    #   The identifier of the WorkSpace.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/workspaces-2015-04-08/DescribeWorkspaceSnapshotsRequest AWS API Documentation
+    #
+    class DescribeWorkspaceSnapshotsRequest < Struct.new(
+      :workspace_id)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] rebuild_snapshots
+    #   Information about the snapshots that can be used to rebuild a
+    #   WorkSpace. These snapshots include the root volume.
+    #   @return [Array<Types::Snapshot>]
+    #
+    # @!attribute [rw] restore_snapshots
+    #   Information about the snapshots that can be used to restore a
+    #   WorkSpace. These snapshots include both the root volume and the user
+    #   volume.
+    #   @return [Array<Types::Snapshot>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/workspaces-2015-04-08/DescribeWorkspaceSnapshotsResult AWS API Documentation
+    #
+    class DescribeWorkspaceSnapshotsResult < Struct.new(
+      :rebuild_snapshots,
+      :restore_snapshots)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass DescribeWorkspacesConnectionStatusRequest
     #   data as a hash:
     #
@@ -992,8 +1029,9 @@ module Aws::WorkSpaces
     end
 
     # Describes a WorkSpace that could not be rebooted. (RebootWorkspaces),
-    # rebuilt (RebuildWorkspaces), terminated (TerminateWorkspaces), started
-    # (StartWorkspaces), or stopped (StopWorkspaces).
+    # rebuilt (RebuildWorkspaces), restored (RestoreWorkspace), terminated
+    # (TerminateWorkspaces), started (StartWorkspaces), or stopped
+    # (StopWorkspaces).
     #
     # @!attribute [rw] workspace_id
     #   The identifier of the WorkSpace.
@@ -1549,6 +1587,28 @@ module Aws::WorkSpaces
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass RestoreWorkspaceRequest
+    #   data as a hash:
+    #
+    #       {
+    #         workspace_id: "WorkspaceId", # required
+    #       }
+    #
+    # @!attribute [rw] workspace_id
+    #   The identifier of the WorkSpace.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/workspaces-2015-04-08/RestoreWorkspaceRequest AWS API Documentation
+    #
+    class RestoreWorkspaceRequest < Struct.new(
+      :workspace_id)
+      include Aws::Structure
+    end
+
+    # @see http://docs.aws.amazon.com/goto/WebAPI/workspaces-2015-04-08/RestoreWorkspaceResult AWS API Documentation
+    #
+    class RestoreWorkspaceResult < Aws::EmptyStructure; end
+
     # @note When making an API call, you may pass RevokeIpRulesRequest
     #   data as a hash:
     #
@@ -1590,6 +1650,19 @@ module Aws::WorkSpaces
       include Aws::Structure
     end
 
+    # Describes a snapshot.
+    #
+    # @!attribute [rw] snapshot_time
+    #   The time when the snapshot was created.
+    #   @return [Time]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/workspaces-2015-04-08/Snapshot AWS API Documentation
+    #
+    class Snapshot < Struct.new(
+      :snapshot_time)
+      include Aws::Structure
+    end
+
     # Information used to start a WorkSpace.
     #
     # @note When making an API call, you may pass StartRequest

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-workspaces
 version: !ruby/object:Gem::Version
-  version: 1.27.0
+  version: 1.28.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-07-25 00:00:00.000000000 Z
+date: 2019-09-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core