@aws-sdk/client-ivs 3.41.0 → 3.46.0

package/dist-types/IvsClient.d.ts

@@ -20,20 +20,22 @@ import { GetPlaybackKeyPairCommandInput, GetPlaybackKeyPairCommandOutput } from
 import { GetRecordingConfigurationCommandInput, GetRecordingConfigurationCommandOutput } from "./commands/GetRecordingConfigurationCommand";
 import { GetStreamCommandInput, GetStreamCommandOutput } from "./commands/GetStreamCommand";
 import { GetStreamKeyCommandInput, GetStreamKeyCommandOutput } from "./commands/GetStreamKeyCommand";
+import { GetStreamSessionCommandInput, GetStreamSessionCommandOutput } from "./commands/GetStreamSessionCommand";
 import { ImportPlaybackKeyPairCommandInput, ImportPlaybackKeyPairCommandOutput } from "./commands/ImportPlaybackKeyPairCommand";
 import { ListChannelsCommandInput, ListChannelsCommandOutput } from "./commands/ListChannelsCommand";
 import { ListPlaybackKeyPairsCommandInput, ListPlaybackKeyPairsCommandOutput } from "./commands/ListPlaybackKeyPairsCommand";
 import { ListRecordingConfigurationsCommandInput, ListRecordingConfigurationsCommandOutput } from "./commands/ListRecordingConfigurationsCommand";
 import { ListStreamKeysCommandInput, ListStreamKeysCommandOutput } from "./commands/ListStreamKeysCommand";
 import { ListStreamsCommandInput, ListStreamsCommandOutput } from "./commands/ListStreamsCommand";
+import { ListStreamSessionsCommandInput, ListStreamSessionsCommandOutput } from "./commands/ListStreamSessionsCommand";
 import { ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput } from "./commands/ListTagsForResourceCommand";
 import { PutMetadataCommandInput, PutMetadataCommandOutput } from "./commands/PutMetadataCommand";
 import { StopStreamCommandInput, StopStreamCommandOutput } from "./commands/StopStreamCommand";
 import { TagResourceCommandInput, TagResourceCommandOutput } from "./commands/TagResourceCommand";
 import { UntagResourceCommandInput, UntagResourceCommandOutput } from "./commands/UntagResourceCommand";
 import { UpdateChannelCommandInput, UpdateChannelCommandOutput } from "./commands/UpdateChannelCommand";
-export declare type ServiceInputTypes = BatchGetChannelCommandInput | BatchGetStreamKeyCommandInput | CreateChannelCommandInput | CreateRecordingConfigurationCommandInput | CreateStreamKeyCommandInput | DeleteChannelCommandInput | DeletePlaybackKeyPairCommandInput | DeleteRecordingConfigurationCommandInput | DeleteStreamKeyCommandInput | GetChannelCommandInput | GetPlaybackKeyPairCommandInput | GetRecordingConfigurationCommandInput | GetStreamCommandInput | GetStreamKeyCommandInput | ImportPlaybackKeyPairCommandInput | ListChannelsCommandInput | ListPlaybackKeyPairsCommandInput | ListRecordingConfigurationsCommandInput | ListStreamKeysCommandInput | ListStreamsCommandInput | ListTagsForResourceCommandInput | PutMetadataCommandInput | StopStreamCommandInput | TagResourceCommandInput | UntagResourceCommandInput | UpdateChannelCommandInput;
-export declare type ServiceOutputTypes = BatchGetChannelCommandOutput | BatchGetStreamKeyCommandOutput | CreateChannelCommandOutput | CreateRecordingConfigurationCommandOutput | CreateStreamKeyCommandOutput | DeleteChannelCommandOutput | DeletePlaybackKeyPairCommandOutput | DeleteRecordingConfigurationCommandOutput | DeleteStreamKeyCommandOutput | GetChannelCommandOutput | GetPlaybackKeyPairCommandOutput | GetRecordingConfigurationCommandOutput | GetStreamCommandOutput | GetStreamKeyCommandOutput | ImportPlaybackKeyPairCommandOutput | ListChannelsCommandOutput | ListPlaybackKeyPairsCommandOutput | ListRecordingConfigurationsCommandOutput | ListStreamKeysCommandOutput | ListStreamsCommandOutput | ListTagsForResourceCommandOutput | PutMetadataCommandOutput | StopStreamCommandOutput | TagResourceCommandOutput | UntagResourceCommandOutput | UpdateChannelCommandOutput;
+export declare 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 declare 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 interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__HttpHandlerOptions>> {
     /**
      * The HTTP handler to use. Fetch in browser and Https in Nodejs.
@@ -165,7 +167,6 @@ export interface IvsClientResolvedConfig extends IvsClientResolvedConfigType {
  *          </p>
  *          <p>For a summary of notable documentation changes in each release, see <a href="https://docs.aws.amazon.com/ivs/latest/userguide/doc-history.html"> Document
  *       History</a>.</p>
- *
  *          <p>
  *             <b>Allowed Header Values</b>
  *          </p>
@@ -355,11 +356,21 @@ export interface IvsClientResolvedConfig extends IvsClientResolvedConfigType {
  *             </li>
  *             <li>
  *                <p>
+ *                   <a>GetStreamSession</a> — Gets metadata on a specified stream.</p>
+ *             </li>
+ *             <li>
+ *                <p>
  *                   <a>ListStreams</a> — Gets summary information about live streams in
  *           your account, in the Amazon Web Services region where the API request is processed.</p>
  *             </li>
  *             <li>
  *                <p>
+ *                   <a>ListStreamSessions</a> — Gets a summary of current and previous
+ *           streams for a specified channel in your account, in the AWS region where the API request
+ *           is processed.</p>
+ *             </li>
+ *             <li>
+ *                <p>
  *                   <a>StopStream</a> — Disconnects the incoming RTMPS stream for the
  *           specified channel. Can be used in conjunction with <a>DeleteStreamKey</a> to
  *           prevent further streaming to a channel.</p>

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

@@ -9,16 +9,16 @@ export interface CreateRecordingConfigurationCommandOutput extends CreateRecordi
 /**
  * <p>Creates a new recording configuration, used to enable recording to Amazon S3.</p>
  *          <p>
- *             <b>Known issue:</b> In the us-east-1 region, if you use the Amazon Web Services
- *       CLI to create a recording configuration, it returns success even if the S3 bucket is in a
- *       different region. In this case, the <code>state</code> of the recording configuration is
- *         <code>CREATE_FAILED</code> (instead of <code>ACTIVE</code>). (In other regions, the CLI
- *       correctly returns failure if the bucket is in a different region.)</p>
+ *             <b>Known issue:</b> In the us-east-1 region, if you use the
+ *         Amazon Web Services CLI to create a recording configuration, it returns success even if the
+ *       S3 bucket is in a different region. In this case, the <code>state</code> of the recording
+ *       configuration is <code>CREATE_FAILED</code> (instead of <code>ACTIVE</code>). (In other
+ *       regions, the CLI correctly returns failure if the bucket is in a different region.)</p>
  *          <p>
- *             <b>Workaround:</b> Ensure that your S3 bucket is in the same region as the recording
- *       configuration. If you create a recording configuration in a different region as your S3
- *       bucket, delete that recording configuration and create a new one with an S3 bucket from the
- *       correct region.</p>
+ *             <b>Workaround:</b> Ensure that your S3 bucket is in the same
+ *       region as the recording configuration. If you create a recording configuration in a different
+ *       region as your S3 bucket, delete that recording configuration and create a new one with an S3
+ *       bucket from the correct region.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -11,7 +11,8 @@ export interface DeleteChannelCommandOutput extends __MetadataBearer {
  *          <p>If you try to delete a live channel, you will get an error (409 ConflictException). To
  *       delete a channel that is live, call <a>StopStream</a>, wait for the Amazon
  *       EventBridge "Stream End" event (to verify that the stream's state was changed from Live to
- *       Offline), then call DeleteChannel. (See <a href="https://docs.aws.amazon.com/ivs/latest/userguide/eventbridge.html"> Using EventBridge with Amazon IVS</a>.) </p>
+ *       Offline), then call DeleteChannel. (See <a href="https://docs.aws.amazon.com/ivs/latest/userguide/eventbridge.html"> Using EventBridge with Amazon IVS</a>.)
+ *     </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -0,0 +1,35 @@
+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 { GetStreamSessionRequest, GetStreamSessionResponse } from "../models/models_0";
+export interface GetStreamSessionCommandInput extends GetStreamSessionRequest {
+}
+export interface GetStreamSessionCommandOutput extends GetStreamSessionResponse, __MetadataBearer {
+}
+/**
+ * <p>Gets metadata on a specified stream.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { IvsClient, GetStreamSessionCommand } from "@aws-sdk/client-ivs"; // ES Modules import
+ * // const { IvsClient, GetStreamSessionCommand } = require("@aws-sdk/client-ivs"); // CommonJS import
+ * const client = new IvsClient(config);
+ * const command = new GetStreamSessionCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link GetStreamSessionCommandInput} for command's `input` shape.
+ * @see {@link GetStreamSessionCommandOutput} for command's `response` shape.
+ * @see {@link IvsClientResolvedConfig | config} for IvsClient's `config` shape.
+ *
+ */
+export declare class GetStreamSessionCommand extends $Command<GetStreamSessionCommandInput, GetStreamSessionCommandOutput, IvsClientResolvedConfig> {
+    readonly input: GetStreamSessionCommandInput;
+    constructor(input: GetStreamSessionCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: IvsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<GetStreamSessionCommandInput, GetStreamSessionCommandOutput>;
+    private serialize;
+    private deserialize;
+}

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

@@ -7,9 +7,9 @@ export interface ListChannelsCommandInput extends ListChannelsRequest {
 export interface ListChannelsCommandOutput extends ListChannelsResponse, __MetadataBearer {
 }
 /**
- * <p>Gets summary information about all channels in your account, in the Amazon Web Services region where the
- *       API request is processed. This list can be filtered to match a specified name or
- *       recording-configuration ARN. Filters are mutually exclusive and cannot be used together. If
+ * <p>Gets summary information about all channels in your account, in the Amazon Web Services
+ *       region where the API request is processed. This list can be filtered to match a specified name
+ *       or recording-configuration ARN. Filters are mutually exclusive and cannot be used together. If
  *       you try to use both filters, you will get an error (409 ConflictException).</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

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

@@ -7,8 +7,8 @@ export interface ListRecordingConfigurationsCommandInput extends ListRecordingCo
 export interface ListRecordingConfigurationsCommandOutput extends ListRecordingConfigurationsResponse, __MetadataBearer {
 }
 /**
- * <p>Gets summary information about all recording configurations in your account, in the Amazon Web Services
- *       region where the API request is processed.</p>
+ * <p>Gets summary information about all recording configurations in your account, in the
+ *         Amazon Web Services region where the API request is processed.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -0,0 +1,36 @@
+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 { ListStreamSessionsRequest, ListStreamSessionsResponse } from "../models/models_0";
+export interface ListStreamSessionsCommandInput extends ListStreamSessionsRequest {
+}
+export interface ListStreamSessionsCommandOutput extends ListStreamSessionsResponse, __MetadataBearer {
+}
+/**
+ * <p>Gets a summary of current and previous streams for a specified channel in your account, in
+ *       the AWS region where the API request is processed.</p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { IvsClient, ListStreamSessionsCommand } from "@aws-sdk/client-ivs"; // ES Modules import
+ * // const { IvsClient, ListStreamSessionsCommand } = require("@aws-sdk/client-ivs"); // CommonJS import
+ * const client = new IvsClient(config);
+ * const command = new ListStreamSessionsCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link ListStreamSessionsCommandInput} for command's `input` shape.
+ * @see {@link ListStreamSessionsCommandOutput} for command's `response` shape.
+ * @see {@link IvsClientResolvedConfig | config} for IvsClient's `config` shape.
+ *
+ */
+export declare class ListStreamSessionsCommand extends $Command<ListStreamSessionsCommandInput, ListStreamSessionsCommandOutput, IvsClientResolvedConfig> {
+    readonly input: ListStreamSessionsCommandInput;
+    constructor(input: ListStreamSessionsCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: IvsClientResolvedConfig, options?: __HttpHandlerOptions): Handler<ListStreamSessionsCommandInput, ListStreamSessionsCommandOutput>;
+    private serialize;
+    private deserialize;
+}

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

@@ -7,8 +7,8 @@ export interface ListStreamsCommandInput extends ListStreamsRequest {
 export interface ListStreamsCommandOutput extends ListStreamsResponse, __MetadataBearer {
 }
 /**
- * <p>Gets summary information about live streams in your account, in the Amazon Web Services region where the
- *       API request is processed.</p>
+ * <p>Gets summary information about live streams in your account, in the Amazon Web Services
+ *       region where the API request is processed.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -7,7 +7,7 @@ export interface PutMetadataCommandInput extends PutMetadataRequest {
 export interface PutMetadataCommandOutput extends __MetadataBearer {
 }
 /**
- * <p>Inserts metadata into the active stream of the specified channel.  At most 5 requests per
+ * <p>Inserts metadata into the active stream of the specified channel. At most 5 requests per
  *       second per channel are allowed, each with a maximum 1 KB payload. (If 5 TPS is not sufficient
  *       for your needs, we recommend batching your data into a single PutMetadata call.) At most 155
  *       requests per second per account are allowed. Also see <a href="https://docs.aws.amazon.com/ivs/latest/userguide/metadata.html">Embedding Metadata within a Video Stream</a> in

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

@@ -12,11 +12,13 @@ export * from "./GetPlaybackKeyPairCommand";
 export * from "./GetRecordingConfigurationCommand";
 export * from "./GetStreamCommand";
 export * from "./GetStreamKeyCommand";
+export * from "./GetStreamSessionCommand";
 export * from "./ImportPlaybackKeyPairCommand";
 export * from "./ListChannelsCommand";
 export * from "./ListPlaybackKeyPairsCommand";
 export * from "./ListRecordingConfigurationsCommand";
 export * from "./ListStreamKeysCommand";
+export * from "./ListStreamSessionsCommand";
 export * from "./ListStreamsCommand";
 export * from "./ListTagsForResourceCommand";
 export * from "./PutMetadataCommand";

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

@@ -212,8 +212,8 @@ export interface CreateChannelRequest {
     /**
      * <p>Channel latency mode. Use <code>NORMAL</code> to broadcast and deliver live video up to
      *       Full HD. Use <code>LOW</code> for near-real-time interaction with viewers. (Note: In the
-     *       Amazon IVS console, <code>LOW</code> and <code>NORMAL</code> correspond to Ultra-low and Standard,
-     *       respectively.) Default: <code>LOW</code>.</p>
+     *       Amazon IVS console, <code>LOW</code> and <code>NORMAL</code> correspond to Ultra-low and
+     *       Standard, respectively.) Default: <code>LOW</code>.</p>
      */
     latencyMode?: ChannelLatencyMode | string;
     /**
@@ -716,6 +716,10 @@ export interface _Stream {
      * <p>Channel ARN for the stream.</p>
      */
     channelArn?: string;
+    /**
+     * <p>Unique identifier for a live or previously live stream in the specified channel.</p>
+     */
+    streamId?: string;
     /**
      * <p>URL of the master playlist, required by the video player to play the HLS stream.</p>
      */
@@ -782,6 +786,196 @@ export declare namespace GetStreamKeyResponse {
      */
     const filterSensitiveLog: (obj: GetStreamKeyResponse) => any;
 }
+export interface GetStreamSessionRequest {
+    /**
+     * <p>ARN of the channel resource</p>
+     */
+    channelArn: string | undefined;
+    /**
+     * <p>Unique identifier for a live or previously live stream in the specified channel. If no
+     *         <code>streamId</code> is provided, this returns the most recent stream session for the
+     *       channel, if it exists.</p>
+     */
+    streamId?: string;
+}
+export declare namespace GetStreamSessionRequest {
+    /**
+     * @internal
+     */
+    const filterSensitiveLog: (obj: GetStreamSessionRequest) => any;
+}
+/**
+ * <p>Object specifying a stream’s audio configuration.</p>
+ */
+export interface AudioConfiguration {
+    /**
+     * <p>Codec used for the audio encoding.</p>
+     */
+    codec?: string;
+    /**
+     * <p>The expected ingest bitrate (bits per second). This is configured in the encoder.</p>
+     */
+    targetBitrate?: number;
+    /**
+     * <p>Number of audio samples recorded per second.</p>
+     */
+    sampleRate?: number;
+    /**
+     * <p>Number of audio channels.</p>
+     */
+    channels?: number;
+}
+export declare namespace AudioConfiguration {
+    /**
+     * @internal
+     */
+    const filterSensitiveLog: (obj: AudioConfiguration) => any;
+}
+/**
+ * <p>Object specifying a stream’s video configuration.</p>
+ */
+export interface VideoConfiguration {
+    /**
+     * <p>Indicates to the decoder the requirements for decoding the stream. For definitions of the
+     *       valid values, see the H.264 specification.</p>
+     */
+    avcProfile?: string;
+    /**
+     * <p>Indicates the degree of required decoder performance for a profile. Normally this is set
+     *       automatically by the encoder. For details, see the H.264 specification.</p>
+     */
+    avcLevel?: string;
+    /**
+     * <p>Codec used for the video encoding.</p>
+     */
+    codec?: string;
+    /**
+     * <p>Software or hardware used to encode the video.</p>
+     */
+    encoder?: string;
+    /**
+     * <p>The expected ingest bitrate (bits per second). This is configured in the encoder.</p>
+     */
+    targetBitrate?: number;
+    /**
+     * <p>The expected ingest framerate. This is configured in the encoder.</p>
+     */
+    targetFramerate?: number;
+    /**
+     * <p>Video-resolution height in pixels.</p>
+     */
+    videoHeight?: number;
+    /**
+     * <p>Video-resolution width in pixels.</p>
+     */
+    videoWidth?: number;
+}
+export declare namespace VideoConfiguration {
+    /**
+     * @internal
+     */
+    const filterSensitiveLog: (obj: VideoConfiguration) => any;
+}
+/**
+ * <p>Object specifying the ingest configuration set up by the broadcaster, usually in an
+ *       encoder.</p>
+ */
+export interface IngestConfiguration {
+    /**
+     * <p>Encoder settings for video.</p>
+     */
+    video?: VideoConfiguration;
+    /**
+     * <p>Encoder settings for audio.</p>
+     */
+    audio?: AudioConfiguration;
+}
+export declare namespace IngestConfiguration {
+    /**
+     * @internal
+     */
+    const filterSensitiveLog: (obj: IngestConfiguration) => any;
+}
+/**
+ * <p>Object specifying a stream’s events. For a list of events, see <a href="https://docs.aws.amazon.com/ivs/latest/userguide/eventbridge.html">Using Amazon EventBridge with Amazon
+ *       IVS</a>.</p>
+ */
+export interface StreamEvent {
+    /**
+     * <p>Name that identifies the stream event within a <code>type</code>.</p>
+     */
+    name?: string;
+    /**
+     * <p>Logical group for certain events.</p>
+     */
+    type?: string;
+    /**
+     * <p>UTC ISO-8601 formatted timestamp of when the event occurred.</p>
+     */
+    eventTime?: Date;
+}
+export declare namespace StreamEvent {
+    /**
+     * @internal
+     */
+    const filterSensitiveLog: (obj: StreamEvent) => any;
+}
+/**
+ * <p>Object that captures the Amazon IVS configuration that the customer provisioned, the
+ *       ingest configurations that the broadcaster used, and the most recent Amazon IVS stream events
+ *       it encountered.</p>
+ */
+export interface StreamSession {
+    /**
+     * <p>Unique identifier for a live or previously live stream in the specified channel.</p>
+     */
+    streamId?: string;
+    /**
+     * <p>UTC ISO-8601 formatted timestamp of when the channel went live.</p>
+     */
+    startTime?: Date;
+    /**
+     * <p>UTC ISO-8601 formatted timestamp of when the channel went offline. For live streams, this
+     *       is <code>NULL</code>.</p>
+     */
+    endTime?: Date;
+    /**
+     * <p>The properties of the channel at the time of going live.</p>
+     */
+    channel?: Channel;
+    /**
+     * <p>The properties of the incoming RTMP stream for the stream.</p>
+     */
+    ingestConfiguration?: IngestConfiguration;
+    /**
+     * <p>The properties of recording the live stream.</p>
+     */
+    recordingConfiguration?: RecordingConfiguration;
+    /**
+     * <p>List of Amazon IVS events that the stream encountered. The list is sorted by most recent
+     *       events and contains up to 500 events. For Amazon IVS events, see <a href="https://docs.aws.amazon.com/ivs/latest/userguide/eventbridge.html">Using Amazon EventBridge with Amazon
+     *       IVS</a>.</p>
+     */
+    truncatedEvents?: StreamEvent[];
+}
+export declare namespace StreamSession {
+    /**
+     * @internal
+     */
+    const filterSensitiveLog: (obj: StreamSession) => any;
+}
+export interface GetStreamSessionResponse {
+    /**
+     * <p>List of stream details.</p>
+     */
+    streamSession?: StreamSession;
+}
+export declare namespace GetStreamSessionResponse {
+    /**
+     * @internal
+     */
+    const filterSensitiveLog: (obj: GetStreamSessionResponse) => any;
+}
 export interface ImportPlaybackKeyPairRequest {
     /**
      * <p>The public portion of a customer-generated key pair.</p>
@@ -1090,7 +1284,26 @@ export declare namespace ListStreamKeysResponse {
      */
     const filterSensitiveLog: (obj: ListStreamKeysResponse) => any;
 }
+/**
+ * <p>Object specifying the stream attribute on which to filter.</p>
+ */
+export interface StreamFilters {
+    /**
+     * <p>The stream’s health.</p>
+     */
+    health?: StreamHealth | string;
+}
+export declare namespace StreamFilters {
+    /**
+     * @internal
+     */
+    const filterSensitiveLog: (obj: StreamFilters) => any;
+}
 export interface ListStreamsRequest {
+    /**
+     * <p>Filters the stream list to match the specified criterion.</p>
+     */
+    filterBy?: StreamFilters;
     /**
      * <p>The first stream to retrieve. This is used for pagination; see the <code>nextToken</code>
      *       response field.</p>
@@ -1115,6 +1328,10 @@ export interface StreamSummary {
      * <p>Channel ARN for the stream.</p>
      */
     channelArn?: string;
+    /**
+     * <p>Unique identifier for a live or previously live stream in the specified channel.</p>
+     */
+    streamId?: string;
     /**
      * <p>The stream’s state.</p>
      */
@@ -1158,6 +1375,72 @@ export declare namespace ListStreamsResponse {
      */
     const filterSensitiveLog: (obj: ListStreamsResponse) => any;
 }
+export interface ListStreamSessionsRequest {
+    /**
+     * <p>Channel ARN used to filter the list.</p>
+     */
+    channelArn: string | undefined;
+    /**
+     * <p>The first stream to retrieve. This is used for pagination; see the <code>nextToken</code>
+     *       response field.</p>
+     */
+    nextToken?: string;
+    /**
+     * <p>Maximum number of streams to return. Default: 50.</p>
+     */
+    maxResults?: number;
+}
+export declare namespace ListStreamSessionsRequest {
+    /**
+     * @internal
+     */
+    const filterSensitiveLog: (obj: ListStreamSessionsRequest) => any;
+}
+/**
+ * <p>Summary information about a stream session.</p>
+ */
+export interface StreamSessionSummary {
+    /**
+     * <p>Unique identifier for a live or previously live stream in the specified channel.</p>
+     */
+    streamId?: string;
+    /**
+     * <p>UTC ISO-8601 formatted timestamp of when the channel went live.</p>
+     */
+    startTime?: Date;
+    /**
+     * <p>UTC ISO-8601 formatted timestamp of when the channel went offline. For live streams, this
+     *       is <code>NULL</code>.</p>
+     */
+    endTime?: Date;
+    /**
+     * <p>If <code>true</code>, this stream encountered a quota breach or failure.</p>
+     */
+    hasErrorEvent?: boolean;
+}
+export declare namespace StreamSessionSummary {
+    /**
+     * @internal
+     */
+    const filterSensitiveLog: (obj: StreamSessionSummary) => any;
+}
+export interface ListStreamSessionsResponse {
+    /**
+     * <p/>
+     */
+    streamSessions: StreamSessionSummary[] | undefined;
+    /**
+     * <p>If there are more streams than <code>maxResults</code>, use <code>nextToken</code> in the
+     *       request to get the next set.</p>
+     */
+    nextToken?: string;
+}
+export declare namespace ListStreamSessionsResponse {
+    /**
+     * @internal
+     */
+    const filterSensitiveLog: (obj: ListStreamSessionsResponse) => any;
+}
 export interface ListTagsForResourceRequest {
     /**
      * <p>The ARN of the resource to be retrieved.</p>
@@ -1315,10 +1598,10 @@ export interface UpdateChannelRequest {
      */
     name?: string;
     /**
-     * <p>Channel latency mode. Use <code>NORMAL</code> to broadcast and deliver live video up to Full HD. Use
-     *       <code>LOW</code> for near-real-time interaction with viewers. (Note: In the Amazon IVS console,
-     *         <code>LOW</code> and <code>NORMAL</code> correspond to Ultra-low and Standard,
-     *       respectively.)</p>
+     * <p>Channel latency mode. Use <code>NORMAL</code> to broadcast and deliver live video up to
+     *       Full HD. Use <code>LOW</code> for near-real-time interaction with viewers. (Note: In the
+     *       Amazon IVS console, <code>LOW</code> and <code>NORMAL</code> correspond to Ultra-low and
+     *       Standard, respectively.)</p>
      */
     latencyMode?: ChannelLatencyMode | string;
     /**

package/dist-types/pagination/ListStreamSessionsPaginator.d.ts

@@ -0,0 +1,4 @@
+import { Paginator } from "@aws-sdk/types";
+import { ListStreamSessionsCommandInput, ListStreamSessionsCommandOutput } from "../commands/ListStreamSessionsCommand";
+import { IvsPaginationConfiguration } from "./Interfaces";
+export declare function paginateListStreamSessions(config: IvsPaginationConfiguration, input: ListStreamSessionsCommandInput, ...additionalArguments: any): Paginator<ListStreamSessionsCommandOutput>;

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

@@ -3,4 +3,5 @@ export * from "./ListChannelsPaginator";
 export * from "./ListPlaybackKeyPairsPaginator";
 export * from "./ListRecordingConfigurationsPaginator";
 export * from "./ListStreamKeysPaginator";
+export * from "./ListStreamSessionsPaginator";
 export * from "./ListStreamsPaginator";

package/dist-types/protocols/Aws_restJson1.d.ts

@@ -14,12 +14,14 @@ import { GetPlaybackKeyPairCommandInput, GetPlaybackKeyPairCommandOutput } from
 import { GetRecordingConfigurationCommandInput, GetRecordingConfigurationCommandOutput } from "../commands/GetRecordingConfigurationCommand";
 import { GetStreamCommandInput, GetStreamCommandOutput } from "../commands/GetStreamCommand";
 import { GetStreamKeyCommandInput, GetStreamKeyCommandOutput } from "../commands/GetStreamKeyCommand";
+import { GetStreamSessionCommandInput, GetStreamSessionCommandOutput } from "../commands/GetStreamSessionCommand";
 import { ImportPlaybackKeyPairCommandInput, ImportPlaybackKeyPairCommandOutput } from "../commands/ImportPlaybackKeyPairCommand";
 import { ListChannelsCommandInput, ListChannelsCommandOutput } from "../commands/ListChannelsCommand";
 import { ListPlaybackKeyPairsCommandInput, ListPlaybackKeyPairsCommandOutput } from "../commands/ListPlaybackKeyPairsCommand";
 import { ListRecordingConfigurationsCommandInput, ListRecordingConfigurationsCommandOutput } from "../commands/ListRecordingConfigurationsCommand";
 import { ListStreamKeysCommandInput, ListStreamKeysCommandOutput } from "../commands/ListStreamKeysCommand";
 import { ListStreamsCommandInput, ListStreamsCommandOutput } from "../commands/ListStreamsCommand";
+import { ListStreamSessionsCommandInput, ListStreamSessionsCommandOutput } from "../commands/ListStreamSessionsCommand";
 import { ListTagsForResourceCommandInput, ListTagsForResourceCommandOutput } from "../commands/ListTagsForResourceCommand";
 import { PutMetadataCommandInput, PutMetadataCommandOutput } from "../commands/PutMetadataCommand";
 import { StopStreamCommandInput, StopStreamCommandOutput } from "../commands/StopStreamCommand";
@@ -40,12 +42,14 @@ export declare const serializeAws_restJson1GetPlaybackKeyPairCommand: (input: Ge
 export declare const serializeAws_restJson1GetRecordingConfigurationCommand: (input: GetRecordingConfigurationCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
 export declare const serializeAws_restJson1GetStreamCommand: (input: GetStreamCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
 export declare const serializeAws_restJson1GetStreamKeyCommand: (input: GetStreamKeyCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
+export declare const serializeAws_restJson1GetStreamSessionCommand: (input: GetStreamSessionCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
 export declare const serializeAws_restJson1ImportPlaybackKeyPairCommand: (input: ImportPlaybackKeyPairCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
 export declare const serializeAws_restJson1ListChannelsCommand: (input: ListChannelsCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
 export declare const serializeAws_restJson1ListPlaybackKeyPairsCommand: (input: ListPlaybackKeyPairsCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
 export declare const serializeAws_restJson1ListRecordingConfigurationsCommand: (input: ListRecordingConfigurationsCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
 export declare const serializeAws_restJson1ListStreamKeysCommand: (input: ListStreamKeysCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
 export declare const serializeAws_restJson1ListStreamsCommand: (input: ListStreamsCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
+export declare const serializeAws_restJson1ListStreamSessionsCommand: (input: ListStreamSessionsCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
 export declare const serializeAws_restJson1ListTagsForResourceCommand: (input: ListTagsForResourceCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
 export declare const serializeAws_restJson1PutMetadataCommand: (input: PutMetadataCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
 export declare const serializeAws_restJson1StopStreamCommand: (input: StopStreamCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
@@ -66,12 +70,14 @@ export declare const deserializeAws_restJson1GetPlaybackKeyPairCommand: (output:
 export declare const deserializeAws_restJson1GetRecordingConfigurationCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<GetRecordingConfigurationCommandOutput>;
 export declare const deserializeAws_restJson1GetStreamCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<GetStreamCommandOutput>;
 export declare const deserializeAws_restJson1GetStreamKeyCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<GetStreamKeyCommandOutput>;
+export declare const deserializeAws_restJson1GetStreamSessionCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<GetStreamSessionCommandOutput>;
 export declare const deserializeAws_restJson1ImportPlaybackKeyPairCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<ImportPlaybackKeyPairCommandOutput>;
 export declare const deserializeAws_restJson1ListChannelsCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<ListChannelsCommandOutput>;
 export declare const deserializeAws_restJson1ListPlaybackKeyPairsCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<ListPlaybackKeyPairsCommandOutput>;
 export declare const deserializeAws_restJson1ListRecordingConfigurationsCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<ListRecordingConfigurationsCommandOutput>;
 export declare const deserializeAws_restJson1ListStreamKeysCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<ListStreamKeysCommandOutput>;
 export declare const deserializeAws_restJson1ListStreamsCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<ListStreamsCommandOutput>;
+export declare const deserializeAws_restJson1ListStreamSessionsCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<ListStreamSessionsCommandOutput>;
 export declare const deserializeAws_restJson1ListTagsForResourceCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<ListTagsForResourceCommandOutput>;
 export declare const deserializeAws_restJson1PutMetadataCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<PutMetadataCommandOutput>;
 export declare const deserializeAws_restJson1StopStreamCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<StopStreamCommandOutput>;