@aws-sdk/client-ivs 3.360.0 → 3.361.0

package/dist-es/protocols/Aws_restJson1.js

@@ -42,6 +42,26 @@ export const se_BatchGetStreamKeyCommand = async (input, context) => {
         body,
     });
 };
+export const se_BatchStartViewerSessionRevocationCommand = async (input, context) => {
+    const { hostname, protocol = "https", port, path: basePath } = await context.endpoint();
+    const headers = {
+        "content-type": "application/json",
+    };
+    const resolvedPath = `${basePath?.endsWith("/") ? basePath.slice(0, -1) : basePath || ""}` + "/BatchStartViewerSessionRevocation";
+    let body;
+    body = JSON.stringify(take(input, {
+        viewerSessions: (_) => _json(_),
+    }));
+    return new __HttpRequest({
+        protocol,
+        hostname,
+        port,
+        method: "POST",
+        headers,
+        path: resolvedPath,
+        body,
+    });
+};
 export const se_CreateChannelCommand = async (input, context) => {
     const { hostname, protocol = "https", port, path: basePath } = await context.endpoint();
     const headers = {
@@ -505,6 +525,28 @@ export const se_PutMetadataCommand = async (input, context) => {
         body,
     });
 };
+export const se_StartViewerSessionRevocationCommand = async (input, context) => {
+    const { hostname, protocol = "https", port, path: basePath } = await context.endpoint();
+    const headers = {
+        "content-type": "application/json",
+    };
+    const resolvedPath = `${basePath?.endsWith("/") ? basePath.slice(0, -1) : basePath || ""}` + "/StartViewerSessionRevocation";
+    let body;
+    body = JSON.stringify(take(input, {
+        channelArn: [],
+        viewerId: [],
+        viewerSessionVersionsLessThanOrEqualTo: [],
+    }));
+    return new __HttpRequest({
+        protocol,
+        hostname,
+        port,
+        method: "POST",
+        headers,
+        path: resolvedPath,
+        body,
+    });
+};
 export const se_StopStreamCommand = async (input, context) => {
     const { hostname, protocol = "https", port, path: basePath } = await context.endpoint();
     const headers = {
@@ -652,6 +694,39 @@ const de_BatchGetStreamKeyCommandError = async (output, context) => {
         errorCode,
     });
 };
+export const de_BatchStartViewerSessionRevocationCommand = async (output, context) => {
+    if (output.statusCode !== 200 && output.statusCode >= 300) {
+        return de_BatchStartViewerSessionRevocationCommandError(output, context);
+    }
+    const contents = map({
+        $metadata: deserializeMetadata(output),
+    });
+    const data = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
+    const doc = take(data, {
+        errors: _json,
+    });
+    Object.assign(contents, doc);
+    return contents;
+};
+const de_BatchStartViewerSessionRevocationCommandError = async (output, context) => {
+    const parsedOutput = {
+        ...output,
+        body: await parseErrorBody(output.body, context),
+    };
+    const errorCode = loadRestJsonErrorCode(output, parsedOutput.body);
+    switch (errorCode) {
+        case "ValidationException":
+        case "com.amazonaws.ivs#ValidationException":
+            throw await de_ValidationExceptionRes(parsedOutput, context);
+        default:
+            const parsedBody = parsedOutput.body;
+            return throwDefaultError({
+                output,
+                parsedBody,
+                errorCode,
+            });
+    }
+};
 export const de_CreateChannelCommand = async (output, context) => {
     if (output.statusCode !== 200 && output.statusCode >= 300) {
         return de_CreateChannelCommandError(output, context);
@@ -1548,6 +1623,44 @@ const de_PutMetadataCommandError = async (output, context) => {
             });
     }
 };
+export const de_StartViewerSessionRevocationCommand = async (output, context) => {
+    if (output.statusCode !== 200 && output.statusCode >= 300) {
+        return de_StartViewerSessionRevocationCommandError(output, context);
+    }
+    const contents = map({
+        $metadata: deserializeMetadata(output),
+    });
+    await collectBody(output.body, context);
+    return contents;
+};
+const de_StartViewerSessionRevocationCommandError = async (output, context) => {
+    const parsedOutput = {
+        ...output,
+        body: await parseErrorBody(output.body, context),
+    };
+    const errorCode = loadRestJsonErrorCode(output, parsedOutput.body);
+    switch (errorCode) {
+        case "AccessDeniedException":
+        case "com.amazonaws.ivs#AccessDeniedException":
+            throw await de_AccessDeniedExceptionRes(parsedOutput, context);
+        case "InternalServerException":
+        case "com.amazonaws.ivs#InternalServerException":
+            throw await de_InternalServerExceptionRes(parsedOutput, context);
+        case "ThrottlingException":
+        case "com.amazonaws.ivs#ThrottlingException":
+            throw await de_ThrottlingExceptionRes(parsedOutput, context);
+        case "ValidationException":
+        case "com.amazonaws.ivs#ValidationException":
+            throw await de_ValidationExceptionRes(parsedOutput, context);
+        default:
+            const parsedBody = parsedOutput.body;
+            return throwDefaultError({
+                output,
+                parsedBody,
+                errorCode,
+            });
+    }
+};
 export const de_StopStreamCommand = async (output, context) => {
     if (output.statusCode !== 200 && output.statusCode >= 300) {
         return de_StopStreamCommandError(output, context);

package/dist-types/Ivs.d.ts

@@ -1,6 +1,7 @@
 import { HttpHandlerOptions as __HttpHandlerOptions } from "@aws-sdk/types";
 import { BatchGetChannelCommandInput, BatchGetChannelCommandOutput } from "./commands/BatchGetChannelCommand";
 import { BatchGetStreamKeyCommandInput, BatchGetStreamKeyCommandOutput } from "./commands/BatchGetStreamKeyCommand";
+import { BatchStartViewerSessionRevocationCommandInput, BatchStartViewerSessionRevocationCommandOutput } from "./commands/BatchStartViewerSessionRevocationCommand";
 import { CreateChannelCommandInput, CreateChannelCommandOutput } from "./commands/CreateChannelCommand";
 import { CreateRecordingConfigurationCommandInput, CreateRecordingConfigurationCommandOutput } from "./commands/CreateRecordingConfigurationCommand";
 import { CreateStreamKeyCommandInput, CreateStreamKeyCommandOutput } from "./commands/CreateStreamKeyCommand";
@@ -23,6 +24,7 @@ import { ListStreamsCommandInput, ListStreamsCommandOutput } from "./commands/Li
 import { ListStreamSessionsCommandInput, ListStreamSessionsCommandOutput } from "./commands/ListStreamSessionsCommand";
 import { ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput } from "./commands/ListTagsForResourceCommand";
 import { PutMetadataCommandInput, PutMetadataCommandOutput } from "./commands/PutMetadataCommand";
+import { StartViewerSessionRevocationCommandInput, StartViewerSessionRevocationCommandOutput } from "./commands/StartViewerSessionRevocationCommand";
 import { StopStreamCommandInput, StopStreamCommandOutput } from "./commands/StopStreamCommand";
 import { TagResourceCommandInput, TagResourceCommandOutput } from "./commands/TagResourceCommand";
 import { UntagResourceCommandInput, UntagResourceCommandOutput } from "./commands/UntagResourceCommand";
@@ -41,6 +43,12 @@ export interface Ivs {
     batchGetStreamKey(args: BatchGetStreamKeyCommandInput, options?: __HttpHandlerOptions): Promise<BatchGetStreamKeyCommandOutput>;
     batchGetStreamKey(args: BatchGetStreamKeyCommandInput, cb: (err: any, data?: BatchGetStreamKeyCommandOutput) => void): void;
     batchGetStreamKey(args: BatchGetStreamKeyCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: BatchGetStreamKeyCommandOutput) => void): void;
+    /**
+     * @see {@link BatchStartViewerSessionRevocationCommand}
+     */
+    batchStartViewerSessionRevocation(args: BatchStartViewerSessionRevocationCommandInput, options?: __HttpHandlerOptions): Promise<BatchStartViewerSessionRevocationCommandOutput>;
+    batchStartViewerSessionRevocation(args: BatchStartViewerSessionRevocationCommandInput, cb: (err: any, data?: BatchStartViewerSessionRevocationCommandOutput) => void): void;
+    batchStartViewerSessionRevocation(args: BatchStartViewerSessionRevocationCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: BatchStartViewerSessionRevocationCommandOutput) => void): void;
     /**
      * @see {@link CreateChannelCommand}
      */
@@ -173,6 +181,12 @@ export interface Ivs {
     putMetadata(args: PutMetadataCommandInput, options?: __HttpHandlerOptions): Promise<PutMetadataCommandOutput>;
     putMetadata(args: PutMetadataCommandInput, cb: (err: any, data?: PutMetadataCommandOutput) => void): void;
     putMetadata(args: PutMetadataCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: PutMetadataCommandOutput) => void): void;
+    /**
+     * @see {@link StartViewerSessionRevocationCommand}
+     */
+    startViewerSessionRevocation(args: StartViewerSessionRevocationCommandInput, options?: __HttpHandlerOptions): Promise<StartViewerSessionRevocationCommandOutput>;
+    startViewerSessionRevocation(args: StartViewerSessionRevocationCommandInput, cb: (err: any, data?: StartViewerSessionRevocationCommandOutput) => void): void;
+    startViewerSessionRevocation(args: StartViewerSessionRevocationCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: StartViewerSessionRevocationCommandOutput) => void): void;
     /**
      * @see {@link StopStreamCommand}
      */
@@ -450,7 +464,7 @@ export interface Ivs {
  *             </li>
  *          </ul>
  *          <p>
- *             <b>PlaybackKeyPair Endpoints</b>
+ *             <b>Private Channel Endpoints</b>
  *          </p>
  *          <p>For more information, see <a href="https://docs.aws.amazon.com/ivs/latest/userguide/private-channels.html">Setting Up Private Channels</a> in the
  *         <i>Amazon IVS User Guide</i>.</p>
@@ -481,6 +495,18 @@ export interface Ivs {
  *           pair. This invalidates future viewer tokens generated using the key pair’s
  *             <code>privateKey</code>.</p>
  *             </li>
+ *             <li>
+ *                <p>
+ *                   <a>StartViewerSessionRevocation</a> — Starts the process of revoking
+ *           the viewer session associated with a specified channel ARN and viewer ID. Optionally, you
+ *           can provide a version to revoke viewer sessions less than and including that
+ *           version.</p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a>BatchStartViewerSessionRevocation</a> — Performs <a>StartViewerSessionRevocation</a> on multiple channel ARN and viewer ID pairs
+ *           simultaneously.</p>
+ *             </li>
  *          </ul>
  *          <p>
  *             <b>RecordingConfiguration Endpoints</b>

package/dist-types/IvsClient.d.ts

@@ -10,6 +10,7 @@ import { HttpHandler as __HttpHandler } from "@smithy/protocol-http";
 import { Decoder as __Decoder, Encoder as __Encoder, Provider as __Provider, StreamCollector as __StreamCollector } from "@smithy/types";
 import { BatchGetChannelCommandInput, BatchGetChannelCommandOutput } from "./commands/BatchGetChannelCommand";
 import { BatchGetStreamKeyCommandInput, BatchGetStreamKeyCommandOutput } from "./commands/BatchGetStreamKeyCommand";
+import { BatchStartViewerSessionRevocationCommandInput, BatchStartViewerSessionRevocationCommandOutput } from "./commands/BatchStartViewerSessionRevocationCommand";
 import { CreateChannelCommandInput, CreateChannelCommandOutput } from "./commands/CreateChannelCommand";
 import { CreateRecordingConfigurationCommandInput, CreateRecordingConfigurationCommandOutput } from "./commands/CreateRecordingConfigurationCommand";
 import { CreateStreamKeyCommandInput, CreateStreamKeyCommandOutput } from "./commands/CreateStreamKeyCommand";
@@ -32,6 +33,7 @@ import { ListStreamsCommandInput, ListStreamsCommandOutput } from "./commands/Li
 import { ListStreamSessionsCommandInput, ListStreamSessionsCommandOutput } from "./commands/ListStreamSessionsCommand";
 import { ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput } from "./commands/ListTagsForResourceCommand";
 import { PutMetadataCommandInput, PutMetadataCommandOutput } from "./commands/PutMetadataCommand";
+import { StartViewerSessionRevocationCommandInput, StartViewerSessionRevocationCommandOutput } from "./commands/StartViewerSessionRevocationCommand";
 import { StopStreamCommandInput, StopStreamCommandOutput } from "./commands/StopStreamCommand";
 import { TagResourceCommandInput, TagResourceCommandOutput } from "./commands/TagResourceCommand";
 import { UntagResourceCommandInput, UntagResourceCommandOutput } from "./commands/UntagResourceCommand";
@@ -41,11 +43,11 @@ export { __Client };
 /**
  * @public
  */
-export type ServiceInputTypes = BatchGetChannelCommandInput | BatchGetStreamKeyCommandInput | CreateChannelCommandInput | CreateRecordingConfigurationCommandInput | CreateStreamKeyCommandInput | DeleteChannelCommandInput | DeletePlaybackKeyPairCommandInput | DeleteRecordingConfigurationCommandInput | DeleteStreamKeyCommandInput | GetChannelCommandInput | GetPlaybackKeyPairCommandInput | GetRecordingConfigurationCommandInput | GetStreamCommandInput | GetStreamKeyCommandInput | GetStreamSessionCommandInput | ImportPlaybackKeyPairCommandInput | ListChannelsCommandInput | ListPlaybackKeyPairsCommandInput | ListRecordingConfigurationsCommandInput | ListStreamKeysCommandInput | ListStreamSessionsCommandInput | ListStreamsCommandInput | ListTagsForResourceCommandInput | PutMetadataCommandInput | StopStreamCommandInput | TagResourceCommandInput | UntagResourceCommandInput | UpdateChannelCommandInput;
+export type ServiceInputTypes = BatchGetChannelCommandInput | BatchGetStreamKeyCommandInput | BatchStartViewerSessionRevocationCommandInput | CreateChannelCommandInput | CreateRecordingConfigurationCommandInput | CreateStreamKeyCommandInput | DeleteChannelCommandInput | DeletePlaybackKeyPairCommandInput | DeleteRecordingConfigurationCommandInput | DeleteStreamKeyCommandInput | GetChannelCommandInput | GetPlaybackKeyPairCommandInput | GetRecordingConfigurationCommandInput | GetStreamCommandInput | GetStreamKeyCommandInput | GetStreamSessionCommandInput | ImportPlaybackKeyPairCommandInput | ListChannelsCommandInput | ListPlaybackKeyPairsCommandInput | ListRecordingConfigurationsCommandInput | ListStreamKeysCommandInput | ListStreamSessionsCommandInput | ListStreamsCommandInput | ListTagsForResourceCommandInput | PutMetadataCommandInput | StartViewerSessionRevocationCommandInput | StopStreamCommandInput | TagResourceCommandInput | UntagResourceCommandInput | UpdateChannelCommandInput;
 /**
  * @public
  */
-export type ServiceOutputTypes = BatchGetChannelCommandOutput | BatchGetStreamKeyCommandOutput | CreateChannelCommandOutput | CreateRecordingConfigurationCommandOutput | CreateStreamKeyCommandOutput | DeleteChannelCommandOutput | DeletePlaybackKeyPairCommandOutput | DeleteRecordingConfigurationCommandOutput | DeleteStreamKeyCommandOutput | GetChannelCommandOutput | GetPlaybackKeyPairCommandOutput | GetRecordingConfigurationCommandOutput | GetStreamCommandOutput | GetStreamKeyCommandOutput | GetStreamSessionCommandOutput | ImportPlaybackKeyPairCommandOutput | ListChannelsCommandOutput | ListPlaybackKeyPairsCommandOutput | ListRecordingConfigurationsCommandOutput | ListStreamKeysCommandOutput | ListStreamSessionsCommandOutput | ListStreamsCommandOutput | ListTagsForResourceCommandOutput | PutMetadataCommandOutput | StopStreamCommandOutput | TagResourceCommandOutput | UntagResourceCommandOutput | UpdateChannelCommandOutput;
+export type ServiceOutputTypes = BatchGetChannelCommandOutput | BatchGetStreamKeyCommandOutput | BatchStartViewerSessionRevocationCommandOutput | CreateChannelCommandOutput | CreateRecordingConfigurationCommandOutput | CreateStreamKeyCommandOutput | DeleteChannelCommandOutput | DeletePlaybackKeyPairCommandOutput | DeleteRecordingConfigurationCommandOutput | DeleteStreamKeyCommandOutput | GetChannelCommandOutput | GetPlaybackKeyPairCommandOutput | GetRecordingConfigurationCommandOutput | GetStreamCommandOutput | GetStreamKeyCommandOutput | GetStreamSessionCommandOutput | ImportPlaybackKeyPairCommandOutput | ListChannelsCommandOutput | ListPlaybackKeyPairsCommandOutput | ListRecordingConfigurationsCommandOutput | ListStreamKeysCommandOutput | ListStreamSessionsCommandOutput | ListStreamsCommandOutput | ListTagsForResourceCommandOutput | PutMetadataCommandOutput | StartViewerSessionRevocationCommandOutput | StopStreamCommandOutput | TagResourceCommandOutput | UntagResourceCommandOutput | UpdateChannelCommandOutput;
 /**
  * @public
  */
@@ -423,7 +425,7 @@ export interface IvsClientResolvedConfig extends IvsClientResolvedConfigType {
  *             </li>
  *          </ul>
  *          <p>
- *             <b>PlaybackKeyPair Endpoints</b>
+ *             <b>Private Channel Endpoints</b>
  *          </p>
  *          <p>For more information, see <a href="https://docs.aws.amazon.com/ivs/latest/userguide/private-channels.html">Setting Up Private Channels</a> in the
  *         <i>Amazon IVS User Guide</i>.</p>
@@ -454,6 +456,18 @@ export interface IvsClientResolvedConfig extends IvsClientResolvedConfigType {
  *           pair. This invalidates future viewer tokens generated using the key pair’s
  *             <code>privateKey</code>.</p>
  *             </li>
+ *             <li>
+ *                <p>
+ *                   <a>StartViewerSessionRevocation</a> — Starts the process of revoking
+ *           the viewer session associated with a specified channel ARN and viewer ID. Optionally, you
+ *           can provide a version to revoke viewer sessions less than and including that
+ *           version.</p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a>BatchStartViewerSessionRevocation</a> — Performs <a>StartViewerSessionRevocation</a> on multiple channel ARN and viewer ID pairs
+ *           simultaneously.</p>
+ *             </li>
  *          </ul>
  *          <p>
  *             <b>RecordingConfiguration Endpoints</b>

package/dist-types/commands/BatchStartViewerSessionRevocationCommand.d.ts

@@ -0,0 +1,90 @@
+import { EndpointParameterInstructions } from "@aws-sdk/middleware-endpoint";
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
+import { IvsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../IvsClient";
+import { BatchStartViewerSessionRevocationRequest, BatchStartViewerSessionRevocationResponse } from "../models/models_0";
+/**
+ * @public
+ */
+export { __MetadataBearer, $Command };
+/**
+ * @public
+ *
+ * The input for {@link BatchStartViewerSessionRevocationCommand}.
+ */
+export interface BatchStartViewerSessionRevocationCommandInput extends BatchStartViewerSessionRevocationRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link BatchStartViewerSessionRevocationCommand}.
+ */
+export interface BatchStartViewerSessionRevocationCommandOutput extends BatchStartViewerSessionRevocationResponse, __MetadataBearer {
+}
+/**
+ * @public
+ * <p>Performs <a>StartViewerSessionRevocation</a> on multiple channel ARN and viewer
+ *       ID pairs simultaneously.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { IvsClient, BatchStartViewerSessionRevocationCommand } from "@aws-sdk/client-ivs"; // ES Modules import
+ * // const { IvsClient, BatchStartViewerSessionRevocationCommand } = require("@aws-sdk/client-ivs"); // CommonJS import
+ * const client = new IvsClient(config);
+ * const input = { // BatchStartViewerSessionRevocationRequest
+ *   viewerSessions: [ // BatchStartViewerSessionRevocationViewerSessionList // required
+ *     { // BatchStartViewerSessionRevocationViewerSession
+ *       channelArn: "STRING_VALUE", // required
+ *       viewerId: "STRING_VALUE", // required
+ *       viewerSessionVersionsLessThanOrEqualTo: Number("int"),
+ *     },
+ *   ],
+ * };
+ * const command = new BatchStartViewerSessionRevocationCommand(input);
+ * const response = await client.send(command);
+ * // { // BatchStartViewerSessionRevocationResponse
+ * //   errors: [ // BatchStartViewerSessionRevocationErrors
+ * //     { // BatchStartViewerSessionRevocationError
+ * //       channelArn: "STRING_VALUE", // required
+ * //       viewerId: "STRING_VALUE", // required
+ * //       code: "STRING_VALUE",
+ * //       message: "STRING_VALUE",
+ * //     },
+ * //   ],
+ * // };
+ *
+ * ```
+ *
+ * @param BatchStartViewerSessionRevocationCommandInput - {@link BatchStartViewerSessionRevocationCommandInput}
+ * @returns {@link BatchStartViewerSessionRevocationCommandOutput}
+ * @see {@link BatchStartViewerSessionRevocationCommandInput} for command's `input` shape.
+ * @see {@link BatchStartViewerSessionRevocationCommandOutput} for command's `response` shape.
+ * @see {@link IvsClientResolvedConfig | config} for IvsClient's `config` shape.
+ *
+ * @throws {@link ValidationException} (client fault)
+ *  <p/>
+ *
+ * @throws {@link IvsServiceException}
+ * <p>Base exception class for all service exceptions from Ivs service.</p>
+ *
+ */
+export declare class BatchStartViewerSessionRevocationCommand extends $Command<BatchStartViewerSessionRevocationCommandInput, BatchStartViewerSessionRevocationCommandOutput, IvsClientResolvedConfig> {
+    readonly input: BatchStartViewerSessionRevocationCommandInput;
+    static getEndpointParameterInstructions(): EndpointParameterInstructions;
+    /**
+     * @public
+     */
+    constructor(input: BatchStartViewerSessionRevocationCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: IvsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<BatchStartViewerSessionRevocationCommandInput, BatchStartViewerSessionRevocationCommandOutput>;
+    /**
+     * @internal
+     */
+    private serialize;
+    /**
+     * @internal
+     */
+    private deserialize;
+}

package/dist-types/commands/StartViewerSessionRevocationCommand.d.ts

@@ -0,0 +1,89 @@
+import { EndpointParameterInstructions } from "@aws-sdk/middleware-endpoint";
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
+import { IvsClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../IvsClient";
+import { StartViewerSessionRevocationRequest, StartViewerSessionRevocationResponse } from "../models/models_0";
+/**
+ * @public
+ */
+export { __MetadataBearer, $Command };
+/**
+ * @public
+ *
+ * The input for {@link StartViewerSessionRevocationCommand}.
+ */
+export interface StartViewerSessionRevocationCommandInput extends StartViewerSessionRevocationRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link StartViewerSessionRevocationCommand}.
+ */
+export interface StartViewerSessionRevocationCommandOutput extends StartViewerSessionRevocationResponse, __MetadataBearer {
+}
+/**
+ * @public
+ * <p>Starts the process of revoking the viewer session associated with a specified channel ARN
+ *       and viewer ID. Optionally, you can provide a version to revoke viewer sessions less than and
+ *       including that version. For instructions on associating a viewer ID with a viewer session, see
+ *         <a href="https://docs.aws.amazon.com/ivs/latest/userguide/private-channels.html">Setting Up
+ *         Private Channels</a>.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { IvsClient, StartViewerSessionRevocationCommand } from "@aws-sdk/client-ivs"; // ES Modules import
+ * // const { IvsClient, StartViewerSessionRevocationCommand } = require("@aws-sdk/client-ivs"); // CommonJS import
+ * const client = new IvsClient(config);
+ * const input = { // StartViewerSessionRevocationRequest
+ *   channelArn: "STRING_VALUE", // required
+ *   viewerId: "STRING_VALUE", // required
+ *   viewerSessionVersionsLessThanOrEqualTo: Number("int"),
+ * };
+ * const command = new StartViewerSessionRevocationCommand(input);
+ * const response = await client.send(command);
+ * // {};
+ *
+ * ```
+ *
+ * @param StartViewerSessionRevocationCommandInput - {@link StartViewerSessionRevocationCommandInput}
+ * @returns {@link StartViewerSessionRevocationCommandOutput}
+ * @see {@link StartViewerSessionRevocationCommandInput} for command's `input` shape.
+ * @see {@link StartViewerSessionRevocationCommandOutput} for command's `response` shape.
+ * @see {@link IvsClientResolvedConfig | config} for IvsClient's `config` shape.
+ *
+ * @throws {@link AccessDeniedException} (client fault)
+ *  <p/>
+ *
+ * @throws {@link InternalServerException} (server fault)
+ *  <p/>
+ *
+ * @throws {@link ThrottlingException} (client fault)
+ *  <p/>
+ *
+ * @throws {@link ValidationException} (client fault)
+ *  <p/>
+ *
+ * @throws {@link IvsServiceException}
+ * <p>Base exception class for all service exceptions from Ivs service.</p>
+ *
+ */
+export declare class StartViewerSessionRevocationCommand extends $Command<StartViewerSessionRevocationCommandInput, StartViewerSessionRevocationCommandOutput, IvsClientResolvedConfig> {
+    readonly input: StartViewerSessionRevocationCommandInput;
+    static getEndpointParameterInstructions(): EndpointParameterInstructions;
+    /**
+     * @public
+     */
+    constructor(input: StartViewerSessionRevocationCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: IvsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<StartViewerSessionRevocationCommandInput, StartViewerSessionRevocationCommandOutput>;
+    /**
+     * @internal
+     */
+    private serialize;
+    /**
+     * @internal
+     */
+    private deserialize;
+}

package/dist-types/commands/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./BatchGetChannelCommand";
 export * from "./BatchGetStreamKeyCommand";
+export * from "./BatchStartViewerSessionRevocationCommand";
 export * from "./CreateChannelCommand";
 export * from "./CreateRecordingConfigurationCommand";
 export * from "./CreateStreamKeyCommand";
@@ -22,6 +23,7 @@ export * from "./ListStreamSessionsCommand";
 export * from "./ListStreamsCommand";
 export * from "./ListTagsForResourceCommand";
 export * from "./PutMetadataCommand";
+export * from "./StartViewerSessionRevocationCommand";
 export * from "./StopStreamCommand";
 export * from "./TagResourceCommand";
 export * from "./UntagResourceCommand";

package/dist-types/index.d.ts

@@ -249,7 +249,7 @@
  *             </li>
  *          </ul>
  *          <p>
- *             <b>PlaybackKeyPair Endpoints</b>
+ *             <b>Private Channel Endpoints</b>
  *          </p>
  *          <p>For more information, see <a href="https://docs.aws.amazon.com/ivs/latest/userguide/private-channels.html">Setting Up Private Channels</a> in the
  *         <i>Amazon IVS User Guide</i>.</p>
@@ -280,6 +280,18 @@
  *           pair. This invalidates future viewer tokens generated using the key pair’s
  *             <code>privateKey</code>.</p>
  *             </li>
+ *             <li>
+ *                <p>
+ *                   <a>StartViewerSessionRevocation</a> — Starts the process of revoking
+ *           the viewer session associated with a specified channel ARN and viewer ID. Optionally, you
+ *           can provide a version to revoke viewer sessions less than and including that
+ *           version.</p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a>BatchStartViewerSessionRevocation</a> — Performs <a>StartViewerSessionRevocation</a> on multiple channel ARN and viewer ID pairs
+ *           simultaneously.</p>
+ *             </li>
  *          </ul>
  *          <p>
  *             <b>RecordingConfiguration Endpoints</b>

package/dist-types/models/models_0.d.ts

@@ -263,6 +263,84 @@ export interface BatchGetStreamKeyResponse {
      */
     errors?: BatchError[];
 }
+/**
+ * @public
+ * <p>A viewer session to revoke in the call to <a>BatchStartViewerSessionRevocation</a>.</p>
+ */
+export interface BatchStartViewerSessionRevocationViewerSession {
+    /**
+     * <p>The ARN of the channel associated with the viewer session to revoke.</p>
+     */
+    channelArn: string | undefined;
+    /**
+     * <p>The ID of the viewer associated with the viewer session to revoke. Do not use this field
+     *       for personally identifying, confidential, or sensitive information.</p>
+     */
+    viewerId: string | undefined;
+    /**
+     * <p>An optional filter on which versions of the viewer session to revoke. All versions less
+     *       than or equal to the specified version will be revoked. Default: 0.</p>
+     */
+    viewerSessionVersionsLessThanOrEqualTo?: number;
+}
+/**
+ * @public
+ */
+export interface BatchStartViewerSessionRevocationRequest {
+    /**
+     * <p>Array of viewer sessions, one per channel-ARN and viewer-ID pair.</p>
+     */
+    viewerSessions: BatchStartViewerSessionRevocationViewerSession[] | undefined;
+}
+/**
+ * @public
+ * <p>Error for a request in the batch for BatchStartViewerSessionRevocation. Each error is
+ *       related to a specific channel-ARN and viewer-ID pair.</p>
+ */
+export interface BatchStartViewerSessionRevocationError {
+    /**
+     * <p>Channel ARN.</p>
+     */
+    channelArn: string | undefined;
+    /**
+     * <p>The ID of the viewer session to revoke.</p>
+     */
+    viewerId: string | undefined;
+    /**
+     * <p>Error code.</p>
+     */
+    code?: string;
+    /**
+     * <p>Error message, determined by the application.</p>
+     */
+    message?: string;
+}
+/**
+ * @public
+ */
+export interface BatchStartViewerSessionRevocationResponse {
+    /**
+     * <p>Each error object is related to a specific <code>channelArn</code> and
+     *         <code>viewerId</code> pair in the request.</p>
+     */
+    errors?: BatchStartViewerSessionRevocationError[];
+}
+/**
+ * @public
+ * <p/>
+ */
+export declare class ValidationException extends __BaseException {
+    readonly name: "ValidationException";
+    readonly $fault: "client";
+    /**
+     * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
+     */
+    exceptionMessage?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<ValidationException, __BaseException>);
+}
 /**
  * @public
  */
@@ -431,22 +509,6 @@ export declare class ServiceQuotaExceededException extends __BaseException {
      */
     constructor(opts: __ExceptionOptionType<ServiceQuotaExceededException, __BaseException>);
 }
-/**
- * @public
- * <p/>
- */
-export declare class ValidationException extends __BaseException {
-    readonly name: "ValidationException";
-    readonly $fault: "client";
-    /**
-     * <p>The input fails to satisfy the constraints specified by an Amazon Web Services service.</p>
-     */
-    exceptionMessage?: string;
-    /**
-     * @internal
-     */
-    constructor(opts: __ExceptionOptionType<ValidationException, __BaseException>);
-}
 /**
  * @public
  * <p/>
@@ -1579,6 +1641,30 @@ export declare class ThrottlingException extends __BaseException {
      */
     constructor(opts: __ExceptionOptionType<ThrottlingException, __BaseException>);
 }
+/**
+ * @public
+ */
+export interface StartViewerSessionRevocationRequest {
+    /**
+     * <p>The ARN of the channel associated with the viewer session to revoke.</p>
+     */
+    channelArn: string | undefined;
+    /**
+     * <p>The ID of the viewer associated with the viewer session to revoke. Do not use this field
+     *       for personally identifying, confidential, or sensitive information.</p>
+     */
+    viewerId: string | undefined;
+    /**
+     * <p>An optional filter on which versions of the viewer session to revoke. All versions less
+     *       than or equal to the specified version will be revoked. Default: 0.</p>
+     */
+    viewerSessionVersionsLessThanOrEqualTo?: number;
+}
+/**
+ * @public
+ */
+export interface StartViewerSessionRevocationResponse {
+}
 /**
  * @public
  */
@@ -1748,9 +1834,10 @@ export interface UpdateChannelRequest {
      */
     insecureIngest?: boolean;
     /**
-     * <p>Optional transcode preset for the channel. This is selectable only for <code>ADVANCED_HD</code> and
-     *       <code>ADVANCED_SD</code> channel types. For those channel types, the default <code>preset</code> is
-     *       <code>HIGHER_BANDWIDTH_DELIVERY</code>. For other channel types (<code>BASIC</code> and <code>STANDARD</code>), <code>preset</code> is the empty
+     * <p>Optional transcode preset for the channel. This is selectable only for
+     *         <code>ADVANCED_HD</code> and <code>ADVANCED_SD</code> channel types. For those channel
+     *       types, the default <code>preset</code> is <code>HIGHER_BANDWIDTH_DELIVERY</code>. For other
+     *       channel types (<code>BASIC</code> and <code>STANDARD</code>), <code>preset</code> is the empty
      *       string (<code>""</code>).</p>
      */
     preset?: TranscodePreset | string;