feat(client-appstream): This release introduces configurable clipboard, allowing admins to specify the maximum length of text that can be copied by the users from their device to the remote session and vice-versa.

Author: awstools

clients/client-appstream/src/commands/CreateStackCommand.ts

@@ -63,6 +63,7 @@ export interface CreateStackCommandOutput extends CreateStackResult, __MetadataB
  *     { // UserSetting
  *       Action: "CLIPBOARD_COPY_FROM_LOCAL_DEVICE" || "CLIPBOARD_COPY_TO_LOCAL_DEVICE" || "FILE_UPLOAD" || "FILE_DOWNLOAD" || "PRINTING_TO_LOCAL_DEVICE" || "DOMAIN_PASSWORD_SIGNIN" || "DOMAIN_SMART_CARD_SIGNIN", // required
  *       Permission: "ENABLED" || "DISABLED", // required
+ *       MaximumLength: Number("int"),
  *     },
  *   ],
  *   ApplicationSettings: { // ApplicationSettings
@@ -115,6 +116,7 @@ export interface CreateStackCommandOutput extends CreateStackResult, __MetadataB
  * //       { // UserSetting
  * //         Action: "CLIPBOARD_COPY_FROM_LOCAL_DEVICE" || "CLIPBOARD_COPY_TO_LOCAL_DEVICE" || "FILE_UPLOAD" || "FILE_DOWNLOAD" || "PRINTING_TO_LOCAL_DEVICE" || "DOMAIN_PASSWORD_SIGNIN" || "DOMAIN_SMART_CARD_SIGNIN", // required
  * //         Permission: "ENABLED" || "DISABLED", // required
+ * //         MaximumLength: Number("int"),
  * //       },
  * //     ],
  * //     ApplicationSettings: { // ApplicationSettingsResponse
@@ -160,6 +162,9 @@ export interface CreateStackCommandOutput extends CreateStackResult, __MetadataB
  * @throws {@link LimitExceededException} (client fault)
  *  <p>The requested limit exceeds the permitted limit for an account.</p>
  *
+ * @throws {@link OperationNotPermittedException} (client fault)
+ *  <p>The attempted operation is not permitted.</p>
+ *
  * @throws {@link ResourceAlreadyExistsException} (client fault)
  *  <p>The specified resource already exists.</p>
  *

clients/client-appstream/src/commands/DescribeStacksCommand.ts

@@ -81,6 +81,7 @@ export interface DescribeStacksCommandOutput extends DescribeStacksResult, __Met
  * //         { // UserSetting
  * //           Action: "CLIPBOARD_COPY_FROM_LOCAL_DEVICE" || "CLIPBOARD_COPY_TO_LOCAL_DEVICE" || "FILE_UPLOAD" || "FILE_DOWNLOAD" || "PRINTING_TO_LOCAL_DEVICE" || "DOMAIN_PASSWORD_SIGNIN" || "DOMAIN_SMART_CARD_SIGNIN", // required
  * //           Permission: "ENABLED" || "DISABLED", // required
+ * //           MaximumLength: Number("int"),
  * //         },
  * //       ],
  * //       ApplicationSettings: { // ApplicationSettingsResponse

clients/client-appstream/src/commands/UpdateStackCommand.ts

@@ -67,6 +67,7 @@ export interface UpdateStackCommandOutput extends UpdateStackResult, __MetadataB
  *     { // UserSetting
  *       Action: "CLIPBOARD_COPY_FROM_LOCAL_DEVICE" || "CLIPBOARD_COPY_TO_LOCAL_DEVICE" || "FILE_UPLOAD" || "FILE_DOWNLOAD" || "PRINTING_TO_LOCAL_DEVICE" || "DOMAIN_PASSWORD_SIGNIN" || "DOMAIN_SMART_CARD_SIGNIN", // required
  *       Permission: "ENABLED" || "DISABLED", // required
+ *       MaximumLength: Number("int"),
  *     },
  *   ],
  *   ApplicationSettings: { // ApplicationSettings
@@ -116,6 +117,7 @@ export interface UpdateStackCommandOutput extends UpdateStackResult, __MetadataB
  * //       { // UserSetting
  * //         Action: "CLIPBOARD_COPY_FROM_LOCAL_DEVICE" || "CLIPBOARD_COPY_TO_LOCAL_DEVICE" || "FILE_UPLOAD" || "FILE_DOWNLOAD" || "PRINTING_TO_LOCAL_DEVICE" || "DOMAIN_PASSWORD_SIGNIN" || "DOMAIN_SMART_CARD_SIGNIN", // required
  * //         Permission: "ENABLED" || "DISABLED", // required
+ * //         MaximumLength: Number("int"),
  * //       },
  * //     ],
  * //     ApplicationSettings: { // ApplicationSettingsResponse

clients/client-appstream/src/models/models_0.ts

@@ -3310,6 +3310,16 @@ export interface UserSetting {
    * <p>Indicates whether the action is enabled or disabled.</p>
    */
   Permission: Permission | undefined;
+
+  /**
+   * @public
+   * <p>Specifies the number of characters that can be copied by end users from the local device to the remote session, and to the local device from the remote session.</p>
+   *          <p>This can be specified only for the <code>CLIPBOARD_COPY_FROM_LOCAL_DEVICE</code> and <code>CLIPBOARD_COPY_TO_LOCAL_DEVICE</code> actions.</p>
+   *          <p>This defaults to 20,971,520 (20 MB) when unspecified and the permission is <code>ENABLED</code>. This can't be specified when the permission is <code>DISABLED</code>. </p>
+   *          <p>This can only be specified for AlwaysOn and OnDemand fleets. The attribute is not supported on Elastic fleets.</p>
+   *          <p>The value can be between 1 and 20,971,520 (20 MB).</p>
+   */
+  MaximumLength?: number;
 }
 
 /**

clients/client-appstream/src/protocols/Aws_json1_1.ts

@@ -2331,6 +2331,9 @@ const de_CreateStackCommandError = async (
     case "LimitExceededException":
     case "com.amazonaws.appstream#LimitExceededException":
       throw await de_LimitExceededExceptionRes(parsedOutput, context);
+    case "OperationNotPermittedException":
+    case "com.amazonaws.appstream#OperationNotPermittedException":
+      throw await de_OperationNotPermittedExceptionRes(parsedOutput, context);
     case "ResourceAlreadyExistsException":
     case "com.amazonaws.appstream#ResourceAlreadyExistsException":
       throw await de_ResourceAlreadyExistsExceptionRes(parsedOutput, context);