@aws-sdk/client-cloudwatch-logs 3.470.0 → 3.473.0

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

@@ -669,8 +669,8 @@ export declare class ResourceAlreadyExistsException extends __BaseException {
 export interface CreateLogAnomalyDetectorRequest {
     /**
      * @public
-     * <p>An array containing the ARNs of the log groups that this anomaly detector will watch. You must specify
-     *       at least one ARN.</p>
+     * <p>An array containing the ARN of the log group that this anomaly detector will watch. You can specify only one
+     *         log group ARN.</p>
      */
     logGroupArnList: string[] | undefined;
     /**
@@ -784,6 +784,9 @@ export interface CreateLogGroupRequest {
      *             </li>
      *          </ul>
      *          <p>If you omit this parameter, the default of <code>STANDARD</code> is used.</p>
+     *          <important>
+     *             <p>After a log group is created, its class can't be changed.</p>
+     *          </important>
      *          <p>For details about the features supported by each class, see
      *       <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch_Logs_Log_Classes.html">Log classes</a>
      *          </p>
@@ -1071,7 +1074,7 @@ export type OutputFormat = (typeof OutputFormat)[keyof typeof OutputFormat];
  *             </li>
  *             <li>
  *                <p>If you are delivering logs cross-account, you must use
- *          <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationolicy.html">PutDeliveryDestinationPolicy</a>
+ *          <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html">PutDeliveryDestinationPolicy</a>
  *          in the destination account to assign an IAM policy to the
  *          destination. This policy allows delivery to that destination.
  *        </p>
@@ -1140,7 +1143,7 @@ export interface DeliveryDestination {
  *             </li>
  *             <li>
  *                <p>If you are delivering logs cross-account, you must use
- *          <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationolicy.html">PutDeliveryDestinationPolicy</a>
+ *          <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html">PutDeliveryDestinationPolicy</a>
  *          in the destination account to assign an IAM policy to the
  *          destination. This policy allows delivery to that destination.
  *        </p>
@@ -3251,6 +3254,115 @@ export interface ListTagsLogGroupResponse {
      */
     tags?: Record<string, string>;
 }
+/**
+ * @public
+ * <p>This object contains the information for one log event returned in a Live Tail stream.</p>
+ */
+export interface LiveTailSessionLogEvent {
+    /**
+     * @public
+     * <p>The name of the log stream that ingested this log event.</p>
+     */
+    logStreamName?: string;
+    /**
+     * @public
+     * <p>The name or ARN of the log group that ingested this log event.</p>
+     */
+    logGroupIdentifier?: string;
+    /**
+     * @public
+     * <p>The log event message text.</p>
+     */
+    message?: string;
+    /**
+     * @public
+     * <p>The timestamp specifying when this log event was created.</p>
+     */
+    timestamp?: number;
+    /**
+     * @public
+     * <p>The timestamp specifying when this log event was ingested into the log group.</p>
+     */
+    ingestionTime?: number;
+}
+/**
+ * @public
+ * <p>This object contains the metadata for one <code>LiveTailSessionUpdate</code> structure. It indicates whether
+ *     that update includes only a sample of 500 log events out of a larger number of ingested log events, or if it contains
+ *     all of the matching log events ingested during that second of time.</p>
+ */
+export interface LiveTailSessionMetadata {
+    /**
+     * @public
+     * <p>If this is <code>true</code>, then more than 500 log events matched the request for this update, and the
+     *     <code>sessionResults</code> includes a sample of 500 of those events.</p>
+     *          <p>If this is <code>false</code>, then 500 or fewer log events matched the request for this update, so no sampling
+     *       was necessary. In this case, the
+     *       <code>sessionResults</code> array includes all log events that matched your request during this time.</p>
+     */
+    sampled?: boolean;
+}
+/**
+ * @public
+ * <p>This object contains information about this Live Tail session, including the log groups included and the
+ *       log stream filters, if any.</p>
+ */
+export interface LiveTailSessionStart {
+    /**
+     * @public
+     * <p>The unique ID generated by CloudWatch Logs to identify this Live Tail session request.</p>
+     */
+    requestId?: string;
+    /**
+     * @public
+     * <p>The unique ID generated by CloudWatch Logs to identify this Live Tail session.</p>
+     */
+    sessionId?: string;
+    /**
+     * @public
+     * <p>An array of the names and ARNs of the log groups included in this Live Tail session.</p>
+     */
+    logGroupIdentifiers?: string[];
+    /**
+     * @public
+     * <p>If your StartLiveTail operation request included a <code>logStreamNames</code> parameter that filtered the session
+     *     to only include certain log streams, these streams are listed here.</p>
+     */
+    logStreamNames?: string[];
+    /**
+     * @public
+     * <p>If your StartLiveTail operation request included a <code>logStreamNamePrefixes</code> parameter that filtered the session
+     *       to only include log streams that have names that start with certain prefixes, these prefixes are listed here.</p>
+     */
+    logStreamNamePrefixes?: string[];
+    /**
+     * @public
+     * <p>An optional pattern to filter the results to include only log events that match the pattern.
+     *     For example, a filter pattern of <code>error 404</code> displays only log events that include both <code>error</code>
+     *     and <code>404</code>.</p>
+     *          <p>For more information about filter pattern syntax, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html">Filter and Pattern Syntax</a>.</p>
+     */
+    logEventFilterPattern?: string;
+}
+/**
+ * @public
+ * <p>This object contains the log events and metadata for a Live Tail session.</p>
+ */
+export interface LiveTailSessionUpdate {
+    /**
+     * @public
+     * <p>This object contains the session metadata for a Live Tail session.</p>
+     */
+    sessionMetadata?: LiveTailSessionMetadata;
+    /**
+     * @public
+     * <p>An array, where each member of the array includes the information for one log event in the Live Tail session.</p>
+     *          <p>A <code>sessionResults</code> array can include as many as 500 log events. If the number of
+     *       log events matching the request exceeds 500 per second, the
+     *       log events are sampled down to 500 log events to be included in each <code>sessionUpdate</code> structure.</p>
+     */
+    sessionResults?: LiveTailSessionLogEvent[];
+}
 /**
  * @public
  */
@@ -3875,6 +3987,160 @@ export interface PutSubscriptionFilterRequest {
      */
     distribution?: Distribution;
 }
+/**
+ * @public
+ */
+export interface StartLiveTailRequest {
+    /**
+     * @public
+     * <p>An array where each item in the array is a log group to include in the Live Tail session.</p>
+     *          <p>Specify each log group by its ARN. </p>
+     *          <p>If you specify an ARN, the ARN can't end with an asterisk (*).</p>
+     *          <note>
+     *             <p> You can include up to 10 log groups.</p>
+     *          </note>
+     */
+    logGroupIdentifiers: string[] | undefined;
+    /**
+     * @public
+     * <p>If you specify this parameter, then only log events in the log streams that you specify here are
+     *     included in the Live Tail session.</p>
+     *          <note>
+     *             <p>You can specify this parameter only if you specify only one log group in <code>logGroupIdentifiers</code>.</p>
+     *          </note>
+     */
+    logStreamNames?: string[];
+    /**
+     * @public
+     * <p>If you specify this parameter, then only log events in the log streams that have names that start with the
+     *       prefixes that you specify here are
+     *       included in the Live Tail session.</p>
+     *          <note>
+     *             <p>You can specify this parameter only if you specify only one log group in <code>logGroupIdentifiers</code>.</p>
+     *          </note>
+     */
+    logStreamNamePrefixes?: string[];
+    /**
+     * @public
+     * <p>An optional pattern to use to filter the results to include only log events that match the pattern.
+     *       For example, a filter pattern of <code>error 404</code> causes only log events that include both <code>error</code>
+     *       and <code>404</code> to be included in the Live Tail stream.</p>
+     *          <p>Regular expression filter patterns are supported.</p>
+     *          <p>For more information about filter pattern syntax, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html">Filter and Pattern Syntax</a>.</p>
+     */
+    logEventFilterPattern?: string;
+}
+/**
+ * @public
+ * <p>his exception is returned if an unknown error occurs during a Live Tail session.</p>
+ */
+export declare class SessionStreamingException extends __BaseException {
+    readonly name: "SessionStreamingException";
+    readonly $fault: "client";
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<SessionStreamingException, __BaseException>);
+}
+/**
+ * @public
+ * <p>This exception is returned in a Live Tail stream when the Live Tail session times out. Live Tail sessions time
+ *       out after three hours.</p>
+ */
+export declare class SessionTimeoutException extends __BaseException {
+    readonly name: "SessionTimeoutException";
+    readonly $fault: "client";
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<SessionTimeoutException, __BaseException>);
+}
+/**
+ * @public
+ * <p>This object includes the stream returned by your
+ *       <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_StartLiveTail.html">StartLiveTail</a>
+ *       request.</p>
+ */
+export type StartLiveTailResponseStream = StartLiveTailResponseStream.SessionStreamingExceptionMember | StartLiveTailResponseStream.SessionTimeoutExceptionMember | StartLiveTailResponseStream.SessionStartMember | StartLiveTailResponseStream.SessionUpdateMember | StartLiveTailResponseStream.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace StartLiveTailResponseStream {
+    /**
+     * @public
+     * <p>This object contains information about this Live Tail session, including the log groups included and the
+     *     log stream filters, if any.</p>
+     */
+    interface SessionStartMember {
+        sessionStart: LiveTailSessionStart;
+        sessionUpdate?: never;
+        SessionTimeoutException?: never;
+        SessionStreamingException?: never;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     * <p>This object contains the log events and session metadata.</p>
+     */
+    interface SessionUpdateMember {
+        sessionStart?: never;
+        sessionUpdate: LiveTailSessionUpdate;
+        SessionTimeoutException?: never;
+        SessionStreamingException?: never;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     * <p>This exception is returned in the stream when the Live Tail session times out. Live Tail sessions time
+     *     out after three hours.</p>
+     */
+    interface SessionTimeoutExceptionMember {
+        sessionStart?: never;
+        sessionUpdate?: never;
+        SessionTimeoutException: SessionTimeoutException;
+        SessionStreamingException?: never;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     * <p>This exception is returned if an unknown error occurs.</p>
+     */
+    interface SessionStreamingExceptionMember {
+        sessionStart?: never;
+        sessionUpdate?: never;
+        SessionTimeoutException?: never;
+        SessionStreamingException: SessionStreamingException;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        sessionStart?: never;
+        sessionUpdate?: never;
+        SessionTimeoutException?: never;
+        SessionStreamingException?: never;
+        $unknown: [string, any];
+    }
+    interface Visitor<T> {
+        sessionStart: (value: LiveTailSessionStart) => T;
+        sessionUpdate: (value: LiveTailSessionUpdate) => T;
+        SessionTimeoutException: (value: SessionTimeoutException) => T;
+        SessionStreamingException: (value: SessionStreamingException) => T;
+        _: (name: string, value: any) => T;
+    }
+    const visit: <T>(value: StartLiveTailResponseStream, visitor: Visitor<T>) => T;
+}
+/**
+ * @public
+ */
+export interface StartLiveTailResponse {
+    /**
+     * @public
+     * <p>An object that includes the stream returned by your request. It can include both log events and exceptions.</p>
+     */
+    responseStream?: AsyncIterable<StartLiveTailResponseStream>;
+}
 /**
  * @public
  * <p>Reserved.</p>
@@ -4280,3 +4546,11 @@ export interface UpdateLogAnomalyDetectorRequest {
      */
     enabled: boolean | undefined;
 }
+/**
+ * @internal
+ */
+export declare const StartLiveTailResponseStreamFilterSensitiveLog: (obj: StartLiveTailResponseStream) => any;
+/**
+ * @internal
+ */
+export declare const StartLiveTailResponseFilterSensitiveLog: (obj: StartLiveTailResponse) => any;

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

@@ -1,5 +1,5 @@
 import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@smithy/protocol-http";
-import { SerdeContext as __SerdeContext } from "@smithy/types";
+import { EventStreamSerdeContext as __EventStreamSerdeContext, SerdeContext as __SerdeContext } from "@smithy/types";
 import { AssociateKmsKeyCommandInput, AssociateKmsKeyCommandOutput } from "../commands/AssociateKmsKeyCommand";
 import { CancelExportTaskCommandInput, CancelExportTaskCommandOutput } from "../commands/CancelExportTaskCommand";
 import { CreateDeliveryCommandInput, CreateDeliveryCommandOutput } from "../commands/CreateDeliveryCommand";
@@ -64,6 +64,7 @@ import { PutQueryDefinitionCommandInput, PutQueryDefinitionCommandOutput } from
 import { PutResourcePolicyCommandInput, PutResourcePolicyCommandOutput } from "../commands/PutResourcePolicyCommand";
 import { PutRetentionPolicyCommandInput, PutRetentionPolicyCommandOutput } from "../commands/PutRetentionPolicyCommand";
 import { PutSubscriptionFilterCommandInput, PutSubscriptionFilterCommandOutput } from "../commands/PutSubscriptionFilterCommand";
+import { StartLiveTailCommandInput, StartLiveTailCommandOutput } from "../commands/StartLiveTailCommand";
 import { StartQueryCommandInput, StartQueryCommandOutput } from "../commands/StartQueryCommand";
 import { StopQueryCommandInput, StopQueryCommandOutput } from "../commands/StopQueryCommand";
 import { TagLogGroupCommandInput, TagLogGroupCommandOutput } from "../commands/TagLogGroupCommand";
@@ -329,6 +330,10 @@ export declare const se_PutRetentionPolicyCommand: (input: PutRetentionPolicyCom
  * serializeAws_json1_1PutSubscriptionFilterCommand
  */
 export declare const se_PutSubscriptionFilterCommand: (input: PutSubscriptionFilterCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
+/**
+ * serializeAws_json1_1StartLiveTailCommand
+ */
+export declare const se_StartLiveTailCommand: (input: StartLiveTailCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
 /**
  * serializeAws_json1_1StartQueryCommand
  */
@@ -621,6 +626,10 @@ export declare const de_PutRetentionPolicyCommand: (output: __HttpResponse, cont
  * deserializeAws_json1_1PutSubscriptionFilterCommand
  */
 export declare const de_PutSubscriptionFilterCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<PutSubscriptionFilterCommandOutput>;
+/**
+ * deserializeAws_json1_1StartLiveTailCommand
+ */
+export declare const de_StartLiveTailCommand: (output: __HttpResponse, context: __SerdeContext & __EventStreamSerdeContext) => Promise<StartLiveTailCommandOutput>;
 /**
  * deserializeAws_json1_1StartQueryCommand
  */

package/dist-types/runtimeConfig.browser.d.ts

@@ -9,6 +9,7 @@ export declare const getRuntimeConfig: (config: CloudWatchLogsClientConfig) => {
     bodyLengthChecker: import("@smithy/types").BodyLengthCalculator;
     credentialDefaultProvider: (input: any) => import("@smithy/types").Provider<import("@aws-sdk/types").Credentials>;
     defaultUserAgentProvider: import("@smithy/types").Provider<import("@smithy/types").UserAgent>;
+    eventStreamSerdeProvider: import("@smithy/types").EventStreamSerdeProvider;
     maxAttempts: number | import("@smithy/types").Provider<number>;
     region: string | import("@smithy/types").Provider<any>;
     requestHandler: (import("@smithy/types").RequestHandler<any, any, import("@smithy/types").HttpHandlerOptions> & import("@smithy/types").RequestHandler<import("@smithy/protocol-http").HttpRequest, import("@smithy/protocol-http").HttpResponse, import("@smithy/types").HttpHandlerOptions> & {

package/dist-types/runtimeConfig.d.ts

@@ -9,6 +9,7 @@ export declare const getRuntimeConfig: (config: CloudWatchLogsClientConfig) => {
     bodyLengthChecker: import("@smithy/types").BodyLengthCalculator;
     credentialDefaultProvider: (input: any) => import("@smithy/types").Provider<import("@aws-sdk/types").Credentials>;
     defaultUserAgentProvider: import("@smithy/types").Provider<import("@smithy/types").UserAgent>;
+    eventStreamSerdeProvider: import("@smithy/types").EventStreamSerdeProvider;
     maxAttempts: number | import("@smithy/types").Provider<number>;
     region: string | import("@smithy/types").Provider<string>;
     requestHandler: (import("@smithy/types").RequestHandler<any, any, import("@smithy/types").HttpHandlerOptions> & import("@smithy/types").RequestHandler<import("@smithy/protocol-http").HttpRequest, import("@smithy/protocol-http").HttpResponse, import("@smithy/types").HttpHandlerOptions> & {

package/dist-types/runtimeConfig.native.d.ts

@@ -28,6 +28,7 @@ export declare const getRuntimeConfig: (config: CloudWatchLogsClientConfig) => {
     retryMode: string | import("@smithy/types").Provider<string>;
     logger: import("@smithy/types").Logger;
     extensions: import("./runtimeExtensions").RuntimeExtension[];
+    eventStreamSerdeProvider: import("@smithy/types").EventStreamSerdeProvider;
     defaultsMode: import("@smithy/smithy-client").DefaultsMode | import("@smithy/types").Provider<import("@smithy/smithy-client").DefaultsMode>;
     endpoint?: string | import("@smithy/types").Endpoint | import("@smithy/types").Provider<import("@smithy/types").Endpoint> | import("@smithy/types").EndpointV2 | import("@smithy/types").Provider<import("@smithy/types").EndpointV2> | undefined;
     endpointProvider: (endpointParams: import("./endpoint/EndpointParameters").EndpointParameters, context?: {

package/dist-types/ts3.4/CloudWatchLogs.d.ts

@@ -256,6 +256,10 @@ import {
   PutSubscriptionFilterCommandInput,
   PutSubscriptionFilterCommandOutput,
 } from "./commands/PutSubscriptionFilterCommand";
+import {
+  StartLiveTailCommandInput,
+  StartLiveTailCommandOutput,
+} from "./commands/StartLiveTailCommand";
 import {
   StartQueryCommandInput,
   StartQueryCommandOutput,
@@ -1125,6 +1129,19 @@ export interface CloudWatchLogs {
     options: __HttpHandlerOptions,
     cb: (err: any, data?: PutSubscriptionFilterCommandOutput) => void
   ): void;
+  startLiveTail(
+    args: StartLiveTailCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<StartLiveTailCommandOutput>;
+  startLiveTail(
+    args: StartLiveTailCommandInput,
+    cb: (err: any, data?: StartLiveTailCommandOutput) => void
+  ): void;
+  startLiveTail(
+    args: StartLiveTailCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: StartLiveTailCommandOutput) => void
+  ): void;
   startQuery(
     args: StartQueryCommandInput,
     options?: __HttpHandlerOptions

package/dist-types/ts3.4/CloudWatchLogsClient.d.ts

@@ -15,6 +15,10 @@ import {
   RegionInputConfig,
   RegionResolvedConfig,
 } from "@smithy/config-resolver";
+import {
+  EventStreamSerdeInputConfig,
+  EventStreamSerdeResolvedConfig,
+} from "@smithy/eventstream-serde-config-resolver";
 import {
   EndpointInputConfig,
   EndpointResolvedConfig,
@@ -36,6 +40,7 @@ import {
   ChecksumConstructor as __ChecksumConstructor,
   Decoder as __Decoder,
   Encoder as __Encoder,
+  EventStreamSerdeProvider as __EventStreamSerdeProvider,
   HashConstructor as __HashConstructor,
   HttpHandlerOptions as __HttpHandlerOptions,
   Logger as __Logger,
@@ -301,6 +306,10 @@ import {
   PutSubscriptionFilterCommandInput,
   PutSubscriptionFilterCommandOutput,
 } from "./commands/PutSubscriptionFilterCommand";
+import {
+  StartLiveTailCommandInput,
+  StartLiveTailCommandOutput,
+} from "./commands/StartLiveTailCommand";
 import {
   StartQueryCommandInput,
   StartQueryCommandOutput,
@@ -409,6 +418,7 @@ export type ServiceInputTypes =
   | PutResourcePolicyCommandInput
   | PutRetentionPolicyCommandInput
   | PutSubscriptionFilterCommandInput
+  | StartLiveTailCommandInput
   | StartQueryCommandInput
   | StopQueryCommandInput
   | TagLogGroupCommandInput
@@ -483,6 +493,7 @@ export type ServiceOutputTypes =
   | PutResourcePolicyCommandOutput
   | PutRetentionPolicyCommandOutput
   | PutSubscriptionFilterCommandOutput
+  | StartLiveTailCommandOutput
   | StartQueryCommandOutput
   | StopQueryCommandOutput
   | TagLogGroupCommandOutput
@@ -515,6 +526,7 @@ export interface ClientDefaults
   retryMode?: string | __Provider<string>;
   logger?: __Logger;
   extensions?: RuntimeExtension[];
+  eventStreamSerdeProvider?: __EventStreamSerdeProvider;
   defaultsMode?: __DefaultsMode | __Provider<__DefaultsMode>;
 }
 export type CloudWatchLogsClientConfigType = Partial<
@@ -527,6 +539,7 @@ export type CloudWatchLogsClientConfigType = Partial<
   HostHeaderInputConfig &
   AwsAuthInputConfig &
   UserAgentInputConfig &
+  EventStreamSerdeInputConfig &
   ClientInputEndpointParameters;
 export interface CloudWatchLogsClientConfig
   extends CloudWatchLogsClientConfigType {}
@@ -540,6 +553,7 @@ export type CloudWatchLogsClientResolvedConfigType =
     HostHeaderResolvedConfig &
     AwsAuthResolvedConfig &
     UserAgentResolvedConfig &
+    EventStreamSerdeResolvedConfig &
     ClientResolvedEndpointParameters;
 export interface CloudWatchLogsClientResolvedConfig
   extends CloudWatchLogsClientResolvedConfigType {}

package/dist-types/ts3.4/commands/StartLiveTailCommand.d.ts

@@ -0,0 +1,38 @@
+import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
+import { Command as $Command } from "@smithy/smithy-client";
+import {
+  Handler,
+  HttpHandlerOptions as __HttpHandlerOptions,
+  MetadataBearer as __MetadataBearer,
+  MiddlewareStack,
+} from "@smithy/types";
+import {
+  CloudWatchLogsClientResolvedConfig,
+  ServiceInputTypes,
+  ServiceOutputTypes,
+} from "../CloudWatchLogsClient";
+import {
+  StartLiveTailRequest,
+  StartLiveTailResponse,
+} from "../models/models_0";
+export { __MetadataBearer, $Command };
+export interface StartLiveTailCommandInput extends StartLiveTailRequest {}
+export interface StartLiveTailCommandOutput
+  extends StartLiveTailResponse,
+    __MetadataBearer {}
+export declare class StartLiveTailCommand extends $Command<
+  StartLiveTailCommandInput,
+  StartLiveTailCommandOutput,
+  CloudWatchLogsClientResolvedConfig
+> {
+  readonly input: StartLiveTailCommandInput;
+  static getEndpointParameterInstructions(): EndpointParameterInstructions;
+  constructor(input: StartLiveTailCommandInput);
+  resolveMiddleware(
+    clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
+    configuration: CloudWatchLogsClientResolvedConfig,
+    options?: __HttpHandlerOptions
+  ): Handler<StartLiveTailCommandInput, StartLiveTailCommandOutput>;
+  private serialize;
+  private deserialize;
+}

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

@@ -62,6 +62,7 @@ export * from "./PutQueryDefinitionCommand";
 export * from "./PutResourcePolicyCommand";
 export * from "./PutRetentionPolicyCommand";
 export * from "./PutSubscriptionFilterCommand";
+export * from "./StartLiveTailCommand";
 export * from "./StartQueryCommand";
 export * from "./StopQueryCommand";
 export * from "./TagLogGroupCommand";

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

@@ -800,6 +800,28 @@ export interface ListTagsLogGroupRequest {
 export interface ListTagsLogGroupResponse {
   tags?: Record<string, string>;
 }
+export interface LiveTailSessionLogEvent {
+  logStreamName?: string;
+  logGroupIdentifier?: string;
+  message?: string;
+  timestamp?: number;
+  ingestionTime?: number;
+}
+export interface LiveTailSessionMetadata {
+  sampled?: boolean;
+}
+export interface LiveTailSessionStart {
+  requestId?: string;
+  sessionId?: string;
+  logGroupIdentifiers?: string[];
+  logStreamNames?: string[];
+  logStreamNamePrefixes?: string[];
+  logEventFilterPattern?: string;
+}
+export interface LiveTailSessionUpdate {
+  sessionMetadata?: LiveTailSessionMetadata;
+  sessionResults?: LiveTailSessionLogEvent[];
+}
 export interface PutAccountPolicyRequest {
   policyName: string | undefined;
   policyDocument: string | undefined;
@@ -916,6 +938,83 @@ export interface PutSubscriptionFilterRequest {
   roleArn?: string;
   distribution?: Distribution;
 }
+export interface StartLiveTailRequest {
+  logGroupIdentifiers: string[] | undefined;
+  logStreamNames?: string[];
+  logStreamNamePrefixes?: string[];
+  logEventFilterPattern?: string;
+}
+export declare class SessionStreamingException extends __BaseException {
+  readonly name: "SessionStreamingException";
+  readonly $fault: "client";
+  constructor(
+    opts: __ExceptionOptionType<SessionStreamingException, __BaseException>
+  );
+}
+export declare class SessionTimeoutException extends __BaseException {
+  readonly name: "SessionTimeoutException";
+  readonly $fault: "client";
+  constructor(
+    opts: __ExceptionOptionType<SessionTimeoutException, __BaseException>
+  );
+}
+export type StartLiveTailResponseStream =
+  | StartLiveTailResponseStream.SessionStreamingExceptionMember
+  | StartLiveTailResponseStream.SessionTimeoutExceptionMember
+  | StartLiveTailResponseStream.SessionStartMember
+  | StartLiveTailResponseStream.SessionUpdateMember
+  | StartLiveTailResponseStream.$UnknownMember;
+export declare namespace StartLiveTailResponseStream {
+  interface SessionStartMember {
+    sessionStart: LiveTailSessionStart;
+    sessionUpdate?: never;
+    SessionTimeoutException?: never;
+    SessionStreamingException?: never;
+    $unknown?: never;
+  }
+  interface SessionUpdateMember {
+    sessionStart?: never;
+    sessionUpdate: LiveTailSessionUpdate;
+    SessionTimeoutException?: never;
+    SessionStreamingException?: never;
+    $unknown?: never;
+  }
+  interface SessionTimeoutExceptionMember {
+    sessionStart?: never;
+    sessionUpdate?: never;
+    SessionTimeoutException: SessionTimeoutException;
+    SessionStreamingException?: never;
+    $unknown?: never;
+  }
+  interface SessionStreamingExceptionMember {
+    sessionStart?: never;
+    sessionUpdate?: never;
+    SessionTimeoutException?: never;
+    SessionStreamingException: SessionStreamingException;
+    $unknown?: never;
+  }
+  interface $UnknownMember {
+    sessionStart?: never;
+    sessionUpdate?: never;
+    SessionTimeoutException?: never;
+    SessionStreamingException?: never;
+    $unknown: [string, any];
+  }
+  interface Visitor<T> {
+    sessionStart: (value: LiveTailSessionStart) => T;
+    sessionUpdate: (value: LiveTailSessionUpdate) => T;
+    SessionTimeoutException: (value: SessionTimeoutException) => T;
+    SessionStreamingException: (value: SessionStreamingException) => T;
+    _: (name: string, value: any) => T;
+  }
+  const visit: <T>(
+    value: StartLiveTailResponseStream,
+    visitor: Visitor<T>
+  ) => T;
+}
+export interface StartLiveTailResponse {
+  responseStream?: AsyncIterable<StartLiveTailResponseStream>;
+}
 export interface QueryCompileErrorLocation {
   startCharOffset?: number;
   endCharOffset?: number;
@@ -1017,3 +1116,9 @@ export interface UpdateLogAnomalyDetectorRequest {
   anomalyVisibilityTime?: number;
   enabled: boolean | undefined;
 }
+export declare const StartLiveTailResponseStreamFilterSensitiveLog: (
+  obj: StartLiveTailResponseStream
+) => any;
+export declare const StartLiveTailResponseFilterSensitiveLog: (
+  obj: StartLiveTailResponse
+) => any;