Amazon WorkSpaces Update: Added the migrate feature to Amazon WorkSpaces.

Author: AWS

.changes/next-release/feature-AmazonWorkSpaces-680c697.json

@@ -0,0 +1,5 @@
+{
+    "type": "feature",
+    "category": "Amazon WorkSpaces",
+    "description": "Added the migrate feature to Amazon WorkSpaces."
+}

services/workspaces/src/main/resources/codegen-resources/service-2.json

@@ -371,6 +371,24 @@
       ],
       "documentation":"<p>Retrieves a list of IP address ranges, specified as IPv4 CIDR blocks, that you can use for the network management interface when you enable Bring Your Own License (BYOL). </p> <p>The management network interface is connected to a secure Amazon WorkSpaces management network. It is used for interactive streaming of the WorkSpace desktop to Amazon WorkSpaces clients, and to allow Amazon WorkSpaces to manage the WorkSpace.</p>"
     },
+    "MigrateWorkspace":{
+      "name":"MigrateWorkspace",
+      "http":{
+        "method":"POST",
+        "requestUri":"/"
+      },
+      "input":{"shape":"MigrateWorkspaceRequest"},
+      "output":{"shape":"MigrateWorkspaceResult"},
+      "errors":[
+        {"shape":"InvalidParameterValuesException"},
+        {"shape":"ResourceNotFoundException"},
+        {"shape":"AccessDeniedException"},
+        {"shape":"OperationNotSupportedException"},
+        {"shape":"OperationInProgressException"},
+        {"shape":"ResourceUnavailableException"}
+      ],
+      "documentation":"<p>Migrates a WorkSpace from one operating system or bundle type to another, while retaining the data on the user volume.</p> <p>The migration process recreates the WorkSpace by using a new root volume from the target bundle image and the user volume from the last available snapshot of the original WorkSpace. During migration, the original <code>D:\\Users\\%USERNAME%</code> user profile folder is renamed to <code>D:\\Users\\%USERNAME%MMddyyTHHmmss%.NotMigrated</code>. A new <code>D:\\Users\\%USERNAME%\\</code> folder is generated by the new OS. Certain files in the old user profile are moved to the new user profile.</p> <p>For available migration scenarios, details about what happens during migration, and best practices, see <a href=\"https://docs.aws.amazon.com/workspaces/latest/adminguide/migrate-workspaces.html\">Migrate a WorkSpace</a>.</p>"
+    },
     "ModifyAccount":{
       "name":"ModifyAccount",
       "http":{
@@ -430,7 +448,7 @@
         {"shape":"ResourceNotFoundException"},
         {"shape":"AccessDeniedException"}
       ],
-      "documentation":"<p>Specifies which devices and operating systems users can use to access their Workspaces. For more information, see <a href=\"https://docs.aws.amazon.com/workspaces/latest/adminguide/update-directory-details.html#control-device-access\"> Control Device Access</a>.</p>"
+      "documentation":"<p>Specifies which devices and operating systems users can use to access their WorkSpaces. For more information, see <a href=\"https://docs.aws.amazon.com/workspaces/latest/adminguide/update-directory-details.html#control-device-access\"> Control Device Access</a>.</p>"
     },
     "ModifyWorkspaceCreationProperties":{
       "name":"ModifyWorkspaceCreationProperties",
@@ -857,7 +875,7 @@
         },
         "Tags":{
           "shape":"TagList",
-          "documentation":"<p>The tags. Each WorkSpaces resource can have a maximum of 50 tags.</p>"
+          "documentation":"<p>The tags. Each WorkSpaces resource can have a maximum of 50 tags. If you want to add new tags to a set of existing tags, you must submit all of the existing tags along with the new ones.</p>"
         }
       }
     },
@@ -1552,6 +1570,36 @@
       "max":5,
       "min":1
     },
+    "MigrateWorkspaceRequest":{
+      "type":"structure",
+      "required":[
+        "SourceWorkspaceId",
+        "BundleId"
+      ],
+      "members":{
+        "SourceWorkspaceId":{
+          "shape":"WorkspaceId",
+          "documentation":"<p>The identifier of the WorkSpace to migrate from.</p>"
+        },
+        "BundleId":{
+          "shape":"BundleId",
+          "documentation":"<p>The identifier of the target bundle type to migrate the WorkSpace to.</p>"
+        }
+      }
+    },
+    "MigrateWorkspaceResult":{
+      "type":"structure",
+      "members":{
+        "SourceWorkspaceId":{
+          "shape":"WorkspaceId",
+          "documentation":"<p>The original identifier of the WorkSpace that is being migrated.</p>"
+        },
+        "TargetWorkspaceId":{
+          "shape":"WorkspaceId",
+          "documentation":"<p>The new identifier of the WorkSpace that is being migrated. If the migration does not succeed, the target WorkSpace ID will not be used, and the WorkSpace will still have the original WorkSpace ID.</p>"
+        }
+      }
+    },
     "ModificationResourceEnum":{
       "type":"string",
       "enum":[
@@ -2342,7 +2390,7 @@
         },
         "VolumeEncryptionKey":{
           "shape":"VolumeEncryptionKey",
-          "documentation":"<p>The KMS key used to encrypt data stored on your WorkSpace.</p>"
+          "documentation":"<p>The symmetric AWS KMS customer master key (CMK) used to encrypt data stored on your WorkSpace. Amazon WorkSpaces does not support asymmetric CMKs.</p>"
         },
         "UserVolumeEncryptionEnabled":{
           "shape":"BooleanObject",
@@ -2548,7 +2596,7 @@
         },
         "WorkspaceAccessProperties":{
           "shape":"WorkspaceAccessProperties",
-          "documentation":"<p>The devices and operating systems that users can use to access Workspaces.</p>"
+          "documentation":"<p>The devices and operating systems that users can use to access WorkSpaces.</p>"
         },
         "Tenancy":{
           "shape":"Tenancy",
@@ -2729,7 +2777,7 @@
         },
         "VolumeEncryptionKey":{
           "shape":"VolumeEncryptionKey",
-          "documentation":"<p>The KMS key used to encrypt data stored on your WorkSpace.</p>"
+          "documentation":"<p>The symmetric AWS KMS customer master key (CMK) used to encrypt data stored on your WorkSpace. Amazon WorkSpaces does not support asymmetric CMKs.</p>"
         },
         "UserVolumeEncryptionEnabled":{
           "shape":"BooleanObject",