feat(client-workspaces-web): WorkSpaces Secure Browser now enables Ad…

…ministrators to view and manage end-user browsing sessions via Session Management APIs.
aws · Sep 19, 2024 · 7913a4b · 7913a4b
1 parent 0b63507
commit 7913a4b
Show file tree

Hide file tree

Showing 14 changed files with 1,586 additions and 165 deletions.
diff --git a/clients/client-workspaces-web/README.md b/clients/client-workspaces-web/README.md
@@ -6,12 +6,13 @@
 
 AWS SDK for JavaScript WorkSpacesWeb Client for Node.js, Browser and React Native.
 
-<p>Amazon WorkSpaces Secure Browser is a low cost, fully managed WorkSpace built specifically to facilitate
-secure, web-based workloads. WorkSpaces Secure Browser makes it easy for customers to safely provide
-their employees with access to internal websites and SaaS web applications without the
-administrative burden of appliances or specialized client software. WorkSpaces Secure Browser provides
-simple policy tools tailored for user interactions, while offloading common tasks like
-capacity management, scaling, and maintaining browser images.</p>
+<p>Amazon WorkSpaces Secure Browser is a low cost, fully managed WorkSpace built
+specifically to facilitate secure, web-based workloads. WorkSpaces Secure Browser makes it
+easy for customers to safely provide their employees with access to internal websites and
+SaaS web applications without the administrative burden of appliances or specialized client
+software. WorkSpaces Secure Browser provides simple policy tools tailored for user
+interactions, while offloading common tasks like capacity management, scaling, and
+maintaining browser images.</p>
 
 ## Installing
 
@@ -431,6 +432,14 @@ DisassociateUserSettings
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/workspaces-web/command/DisassociateUserSettingsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-workspaces-web/Interface/DisassociateUserSettingsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-workspaces-web/Interface/DisassociateUserSettingsCommandOutput/)
 
+</details>
+<details>
+<summary>
+ExpireSession
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/workspaces-web/command/ExpireSessionCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-workspaces-web/Interface/ExpireSessionCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-workspaces-web/Interface/ExpireSessionCommandOutput/)
+
 </details>
 <details>
 <summary>
@@ -479,6 +488,14 @@ GetPortalServiceProviderMetadata
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/workspaces-web/command/GetPortalServiceProviderMetadataCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-workspaces-web/Interface/GetPortalServiceProviderMetadataCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-workspaces-web/Interface/GetPortalServiceProviderMetadataCommandOutput/)
 
+</details>
+<details>
+<summary>
+GetSession
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/workspaces-web/command/GetSessionCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-workspaces-web/Interface/GetSessionCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-workspaces-web/Interface/GetSessionCommandOutput/)
+
 </details>
 <details>
 <summary>
@@ -551,6 +568,14 @@ ListPortals
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/workspaces-web/command/ListPortalsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-workspaces-web/Interface/ListPortalsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-workspaces-web/Interface/ListPortalsCommandOutput/)
 
+</details>
+<details>
+<summary>
+ListSessions
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/workspaces-web/command/ListSessionsCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-workspaces-web/Interface/ListSessionsCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-workspaces-web/Interface/ListSessionsCommandOutput/)
+
 </details>
 <details>
 <summary>

diff --git a/clients/client-workspaces-web/src/WorkSpacesWeb.ts b/clients/client-workspaces-web/src/WorkSpacesWeb.ts
@@ -142,6 +142,11 @@ import {
   DisassociateUserSettingsCommandInput,
   DisassociateUserSettingsCommandOutput,
 } from "./commands/DisassociateUserSettingsCommand";
+import {
+  ExpireSessionCommand,
+  ExpireSessionCommandInput,
+  ExpireSessionCommandOutput,
+} from "./commands/ExpireSessionCommand";
 import {
   GetBrowserSettingsCommand,
   GetBrowserSettingsCommandInput,
@@ -168,6 +173,7 @@ import {
   GetPortalServiceProviderMetadataCommandInput,
   GetPortalServiceProviderMetadataCommandOutput,
 } from "./commands/GetPortalServiceProviderMetadataCommand";
+import { GetSessionCommand, GetSessionCommandInput, GetSessionCommandOutput } from "./commands/GetSessionCommand";
 import {
   GetTrustStoreCertificateCommand,
   GetTrustStoreCertificateCommandInput,
@@ -209,6 +215,11 @@ import {
   ListNetworkSettingsCommandOutput,
 } from "./commands/ListNetworkSettingsCommand";
 import { ListPortalsCommand, ListPortalsCommandInput, ListPortalsCommandOutput } from "./commands/ListPortalsCommand";
+import {
+  ListSessionsCommand,
+  ListSessionsCommandInput,
+  ListSessionsCommandOutput,
+} from "./commands/ListSessionsCommand";
 import {
   ListTagsForResourceCommand,
   ListTagsForResourceCommandInput,
@@ -311,12 +322,14 @@ const commands = {
   DisassociateTrustStoreCommand,
   DisassociateUserAccessLoggingSettingsCommand,
   DisassociateUserSettingsCommand,
+  ExpireSessionCommand,
   GetBrowserSettingsCommand,
   GetIdentityProviderCommand,
   GetIpAccessSettingsCommand,
   GetNetworkSettingsCommand,
   GetPortalCommand,
   GetPortalServiceProviderMetadataCommand,
+  GetSessionCommand,
   GetTrustStoreCommand,
   GetTrustStoreCertificateCommand,
   GetUserAccessLoggingSettingsCommand,
@@ -326,6 +339,7 @@ const commands = {
   ListIpAccessSettingsCommand,
   ListNetworkSettingsCommand,
   ListPortalsCommand,
+  ListSessionsCommand,
   ListTagsForResourceCommand,
   ListTrustStoreCertificatesCommand,
   ListTrustStoresCommand,
@@ -809,6 +823,17 @@ export interface WorkSpacesWeb {
     cb: (err: any, data?: DisassociateUserSettingsCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link ExpireSessionCommand}
+   */
+  expireSession(args: ExpireSessionCommandInput, options?: __HttpHandlerOptions): Promise<ExpireSessionCommandOutput>;
+  expireSession(args: ExpireSessionCommandInput, cb: (err: any, data?: ExpireSessionCommandOutput) => void): void;
+  expireSession(
+    args: ExpireSessionCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: ExpireSessionCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link GetBrowserSettingsCommand}
    */
@@ -905,6 +930,17 @@ export interface WorkSpacesWeb {
     cb: (err: any, data?: GetPortalServiceProviderMetadataCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link GetSessionCommand}
+   */
+  getSession(args: GetSessionCommandInput, options?: __HttpHandlerOptions): Promise<GetSessionCommandOutput>;
+  getSession(args: GetSessionCommandInput, cb: (err: any, data?: GetSessionCommandOutput) => void): void;
+  getSession(
+    args: GetSessionCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: GetSessionCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link GetTrustStoreCommand}
    */
@@ -1047,6 +1083,17 @@ export interface WorkSpacesWeb {
     cb: (err: any, data?: ListPortalsCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link ListSessionsCommand}
+   */
+  listSessions(args: ListSessionsCommandInput, options?: __HttpHandlerOptions): Promise<ListSessionsCommandOutput>;
+  listSessions(args: ListSessionsCommandInput, cb: (err: any, data?: ListSessionsCommandOutput) => void): void;
+  listSessions(
+    args: ListSessionsCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: ListSessionsCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link ListTagsForResourceCommand}
    */
@@ -1286,12 +1333,13 @@ export interface WorkSpacesWeb {
 }
 
 /**
- * <p>Amazon WorkSpaces Secure Browser is a low cost, fully managed WorkSpace built specifically to facilitate
- *          secure, web-based workloads. WorkSpaces Secure Browser makes it easy for customers to safely provide
- *          their employees with access to internal websites and SaaS web applications without the
- *          administrative burden of appliances or specialized client software. WorkSpaces Secure Browser provides
- *          simple policy tools tailored for user interactions, while offloading common tasks like
- *          capacity management, scaling, and maintaining browser images.</p>
+ * <p>Amazon WorkSpaces Secure Browser is a low cost, fully managed WorkSpace built
+ *          specifically to facilitate secure, web-based workloads. WorkSpaces Secure Browser makes it
+ *          easy for customers to safely provide their employees with access to internal websites and
+ *          SaaS web applications without the administrative burden of appliances or specialized client
+ *          software. WorkSpaces Secure Browser provides simple policy tools tailored for user
+ *          interactions, while offloading common tasks like capacity management, scaling, and
+ *          maintaining browser images.</p>
  * @public
  */
 export class WorkSpacesWeb extends WorkSpacesWebClient implements WorkSpacesWeb {}

diff --git a/clients/client-workspaces-web/src/WorkSpacesWebClient.ts b/clients/client-workspaces-web/src/WorkSpacesWebClient.ts
@@ -147,6 +147,7 @@ import {
   DisassociateUserSettingsCommandInput,
   DisassociateUserSettingsCommandOutput,
 } from "./commands/DisassociateUserSettingsCommand";
+import { ExpireSessionCommandInput, ExpireSessionCommandOutput } from "./commands/ExpireSessionCommand";
 import { GetBrowserSettingsCommandInput, GetBrowserSettingsCommandOutput } from "./commands/GetBrowserSettingsCommand";
 import {
   GetIdentityProviderCommandInput,
@@ -162,6 +163,7 @@ import {
   GetPortalServiceProviderMetadataCommandInput,
   GetPortalServiceProviderMetadataCommandOutput,
 } from "./commands/GetPortalServiceProviderMetadataCommand";
+import { GetSessionCommandInput, GetSessionCommandOutput } from "./commands/GetSessionCommand";
 import {
   GetTrustStoreCertificateCommandInput,
   GetTrustStoreCertificateCommandOutput,
@@ -189,6 +191,7 @@ import {
   ListNetworkSettingsCommandOutput,
 } from "./commands/ListNetworkSettingsCommand";
 import { ListPortalsCommandInput, ListPortalsCommandOutput } from "./commands/ListPortalsCommand";
+import { ListSessionsCommandInput, ListSessionsCommandOutput } from "./commands/ListSessionsCommand";
 import {
   ListTagsForResourceCommandInput,
   ListTagsForResourceCommandOutput,
@@ -271,12 +274,14 @@ export type ServiceInputTypes =
   | DisassociateTrustStoreCommandInput
   | DisassociateUserAccessLoggingSettingsCommandInput
   | DisassociateUserSettingsCommandInput
+  | ExpireSessionCommandInput
   | GetBrowserSettingsCommandInput
   | GetIdentityProviderCommandInput
   | GetIpAccessSettingsCommandInput
   | GetNetworkSettingsCommandInput
   | GetPortalCommandInput
   | GetPortalServiceProviderMetadataCommandInput
+  | GetSessionCommandInput
   | GetTrustStoreCertificateCommandInput
   | GetTrustStoreCommandInput
   | GetUserAccessLoggingSettingsCommandInput
@@ -286,6 +291,7 @@ export type ServiceInputTypes =
   | ListIpAccessSettingsCommandInput
   | ListNetworkSettingsCommandInput
   | ListPortalsCommandInput
+  | ListSessionsCommandInput
   | ListTagsForResourceCommandInput
   | ListTrustStoreCertificatesCommandInput
   | ListTrustStoresCommandInput
@@ -334,12 +340,14 @@ export type ServiceOutputTypes =
   | DisassociateTrustStoreCommandOutput
   | DisassociateUserAccessLoggingSettingsCommandOutput
   | DisassociateUserSettingsCommandOutput
+  | ExpireSessionCommandOutput
   | GetBrowserSettingsCommandOutput
   | GetIdentityProviderCommandOutput
   | GetIpAccessSettingsCommandOutput
   | GetNetworkSettingsCommandOutput
   | GetPortalCommandOutput
   | GetPortalServiceProviderMetadataCommandOutput
+  | GetSessionCommandOutput
   | GetTrustStoreCertificateCommandOutput
   | GetTrustStoreCommandOutput
   | GetUserAccessLoggingSettingsCommandOutput
@@ -349,6 +357,7 @@ export type ServiceOutputTypes =
   | ListIpAccessSettingsCommandOutput
   | ListNetworkSettingsCommandOutput
   | ListPortalsCommandOutput
+  | ListSessionsCommandOutput
   | ListTagsForResourceCommandOutput
   | ListTrustStoreCertificatesCommandOutput
   | ListTrustStoresCommandOutput
@@ -537,12 +546,13 @@ export type WorkSpacesWebClientResolvedConfigType = __SmithyResolvedConfiguratio
 export interface WorkSpacesWebClientResolvedConfig extends WorkSpacesWebClientResolvedConfigType {}
 
 /**
- * <p>Amazon WorkSpaces Secure Browser is a low cost, fully managed WorkSpace built specifically to facilitate
- *          secure, web-based workloads. WorkSpaces Secure Browser makes it easy for customers to safely provide
- *          their employees with access to internal websites and SaaS web applications without the
- *          administrative burden of appliances or specialized client software. WorkSpaces Secure Browser provides
- *          simple policy tools tailored for user interactions, while offloading common tasks like
- *          capacity management, scaling, and maintaining browser images.</p>
+ * <p>Amazon WorkSpaces Secure Browser is a low cost, fully managed WorkSpace built
+ *          specifically to facilitate secure, web-based workloads. WorkSpaces Secure Browser makes it
+ *          easy for customers to safely provide their employees with access to internal websites and
+ *          SaaS web applications without the administrative burden of appliances or specialized client
+ *          software. WorkSpaces Secure Browser provides simple policy tools tailored for user
+ *          interactions, while offloading common tasks like capacity management, scaling, and
+ *          maintaining browser images.</p>
  * @public
  */
 export class WorkSpacesWebClient extends __Client<

diff --git a/clients/client-workspaces-web/src/commands/CreateUserAccessLoggingSettingsCommand.ts b/clients/client-workspaces-web/src/commands/CreateUserAccessLoggingSettingsCommand.ts
@@ -37,7 +37,8 @@ export interface CreateUserAccessLoggingSettingsCommandOutput
     __MetadataBearer {}
 
 /**
- * <p>Creates a user access logging settings resource that can be associated with a web portal.</p>
+ * <p>Creates a user access logging settings resource that can be associated with a web
+ *          portal.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript