@aws-sdk/client-cloudwatch-logs 3.887.0 → 3.890.0

package/dist-cjs/index.js

@@ -2975,6 +2975,8 @@ var se_MetricTransformations = /* @__PURE__ */ __name((input, context) => {
 var se_PutMetricFilterRequest = /* @__PURE__ */ __name((input, context) => {
   return (0, import_smithy_client.take)(input, {
     applyOnTransformedLogs: [],
+    emitSystemFieldDimensions: import_smithy_client._json,
+    fieldSelectionCriteria: [],
     filterName: [],
     filterPattern: [],
     logGroupName: [],
@@ -3015,6 +3017,8 @@ var de_MetricFilter = /* @__PURE__ */ __name((output, context) => {
   return (0, import_smithy_client.take)(output, {
     applyOnTransformedLogs: import_smithy_client.expectBoolean,
     creationTime: import_smithy_client.expectLong,
+    emitSystemFieldDimensions: import_smithy_client._json,
+    fieldSelectionCriteria: import_smithy_client.expectString,
     filterName: import_smithy_client.expectString,
     filterPattern: import_smithy_client.expectString,
     logGroupName: import_smithy_client.expectString,

package/dist-es/protocols/Aws_json1_1.js

@@ -1996,6 +1996,8 @@ const se_MetricTransformations = (input, context) => {
 const se_PutMetricFilterRequest = (input, context) => {
     return take(input, {
         applyOnTransformedLogs: [],
+        emitSystemFieldDimensions: _json,
+        fieldSelectionCriteria: [],
         filterName: [],
         filterPattern: [],
         logGroupName: [],
@@ -2036,6 +2038,8 @@ const de_MetricFilter = (output, context) => {
     return take(output, {
         applyOnTransformedLogs: __expectBoolean,
         creationTime: __expectLong,
+        emitSystemFieldDimensions: _json,
+        fieldSelectionCriteria: __expectString,
         filterName: __expectString,
         filterPattern: __expectString,
         logGroupName: __expectString,

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

@@ -35,8 +35,8 @@ declare const DescribeDeliveriesCommand_base: {
  *                <i>delivery destination</i>
  *             </a>.</p>
  *          <p>A delivery source represents an Amazon Web Services resource that sends logs to an logs
- *       delivery destination. The destination can be CloudWatch Logs, Amazon S3, Firehose or X-Ray. Only some Amazon Web Services services support being configured as a delivery
- *       source. These services are listed in <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html">Enable logging from
+ *       delivery destination. The destination can be CloudWatch Logs, Amazon S3, Firehose or X-Ray. Only some Amazon Web Services services support being
+ *       configured as a delivery source. These services are listed in <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html">Enable logging from
  *           Amazon Web Services services.</a>
  *          </p>
  * @example

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

@@ -27,8 +27,8 @@ declare const DescribeFieldIndexesCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Returns a list of field indexes listed in the field index policies of one or more log
- *       groups. For more information about field index policies, see <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutIndexPolicy.html">PutIndexPolicy</a>.</p>
+ * <p>Returns a list of custom and default field indexes which are discovered in log data. For
+ *       more information about field index policies, see <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutIndexPolicy.html">PutIndexPolicy</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -27,7 +27,7 @@ declare const DescribeIndexPoliciesCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Returns the field index policies of one or more log groups. For more information about
+ * <p>Returns the field index policies of the specified log group. For more information about
  *       field index policies, see <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutIndexPolicy.html">PutIndexPolicy</a>.</p>
  *          <p>If a specified log group has a log-group level index policy, that policy is returned by
  *       this operation.</p>

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

@@ -66,6 +66,10 @@ declare const DescribeMetricFiltersCommand_base: {
  * //       creationTime: Number("long"),
  * //       logGroupName: "STRING_VALUE",
  * //       applyOnTransformedLogs: true || false,
+ * //       fieldSelectionCriteria: "STRING_VALUE",
+ * //       emitSystemFieldDimensions: [ // EmitSystemFields
+ * //         "STRING_VALUE",
+ * //       ],
  * //     },
  * //   ],
  * //   nextToken: "STRING_VALUE",

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

@@ -55,6 +55,10 @@ declare const DescribeSubscriptionFiltersCommand_base: {
  * //       distribution: "Random" || "ByLogStream",
  * //       applyOnTransformedLogs: true || false,
  * //       creationTime: Number("long"),
+ * //       fieldSelectionCriteria: "STRING_VALUE",
+ * //       emitSystemFields: [ // EmitSystemFields
+ * //         "STRING_VALUE",
+ * //       ],
  * //     },
  * //   ],
  * //   nextToken: "STRING_VALUE",

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

@@ -37,7 +37,7 @@ declare const FilterLogEventsCommand_base: {
  *                <p>A time range</p>
  *             </li>
  *             <li>
- *                <p>The log stream name, or a log stream name prefix that matches mutltiple log
+ *                <p>The log stream name, or a log stream name prefix that matches multiple log
  *           streams</p>
  *             </li>
  *          </ul>

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

@@ -27,10 +27,17 @@ declare const GetLogObjectCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Retrieves a large logging object (LLO) and streams it back. This API is used to fetch the content of large portions of log events that have been ingested through the PutOpenTelemetryLogs API.
- *       When log events contain fields that would cause the total event size to exceed 1MB, CloudWatch Logs automatically processes up to 10 fields, starting with the largest fields. Each field is truncated as needed to keep
- *       the total event size as close to 1MB as possible. The excess portions are stored as Large Log Objects (LLOs) and these fields are processed separately and LLO reference system fields (in the format <code>@ptr.$[path.to.field]</code>) are
- *       added. The path in the reference field reflects the original JSON structure where the large field was located. For example, this could be <code>@ptr.$['input']['message']</code>, <code>@ptr.$['AAA']['BBB']['CCC']['DDD']</code>, <code>@ptr.$['AAA']</code>, or any other path matching your log structure.</p>
+ * <p>Retrieves a large logging object (LLO) and streams it back. This API is used to fetch the
+ *       content of large portions of log events that have been ingested through the
+ *       PutOpenTelemetryLogs API. When log events contain fields that would cause the total event size
+ *       to exceed 1MB, CloudWatch Logs automatically processes up to 10 fields, starting with the
+ *       largest fields. Each field is truncated as needed to keep the total event size as close to 1MB
+ *       as possible. The excess portions are stored as Large Log Objects (LLOs) and these fields are
+ *       processed separately and LLO reference system fields (in the format
+ *         <code>@ptr.$[path.to.field]</code>) are added. The path in the reference field reflects the
+ *       original JSON structure where the large field was located. For example, this could be
+ *         <code>@ptr.$['input']['message']</code>, <code>@ptr.$['AAA']['BBB']['CCC']['DDD']</code>,
+ *         <code>@ptr.$['AAA']</code>, or any other path matching your log structure.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -53,8 +53,8 @@ declare const PutAccountPolicyCommand_base: {
  *             </li>
  *             <li>
  *                <p>To create a metric extraction policy, you must have the
- *             <code>logs:PutMetricExtractionPolicy</code> and
- *             <code>logs:PutAccountPolicy</code> permissions.</p>
+ *             <code>logs:PutMetricExtractionPolicy</code> and <code>logs:PutAccountPolicy</code>
+ *           permissions.</p>
  *             </li>
  *          </ul>
  *          <p>
@@ -149,6 +149,32 @@ declare const PutAccountPolicyCommand_base: {
  *       use the same or overlapping log group name prefixes. For example, if you have one policy
  *       filtered to log groups that start with <code>my-log</code>, you can't have another field index
  *       policy filtered to <code>my-logpprod</code> or <code>my-logging</code>.</p>
+ *          <p>CloudWatch Logs provides default field indexes for all log groups in the Standard log
+ *       class. Default field indexes are automatically available for the following fields: </p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <code>@aws.region</code>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <code>@aws.account</code>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <code>@source.log</code>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <code>traceId</code>
+ *                </p>
+ *             </li>
+ *          </ul>
+ *          <p>Default field indexes are in addition to any custom field indexes you define within your
+ *       policy. Default field indexes are not counted towards your field index quota. </p>
  *          <p>You can also set up a transformer at the log-group level. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutTransformer.html">PutTransformer</a>. If there is both a log-group level transformer created with
  *         <code>PutTransformer</code> and an account-level transformer that could apply to the same
  *       log group, the log group uses only the log-group level transformer. It ignores the
@@ -200,15 +226,16 @@ declare const PutAccountPolicyCommand_base: {
  *          <important>
  *             <p>Creating a policy disables metrics for AWS features that use EMF to create metrics, such
  *         as CloudWatch Container Insights and CloudWatch Application Signals. To prevent turning off
- *         those features by accident, we recommend that you exclude the underlying log-groups through a
- *         selection-criteria such as <code>LogGroupNamePrefix NOT IN ["/aws/containerinsights",
- *         "/aws/ecs/containerinsights", "/aws/application-signals/data"]</code>.</p>
+ *         those features by accident, we recommend that you exclude the underlying log-groups through
+ *         a selection-criteria such as <code>LogGroupNamePrefix NOT IN ["/aws/containerinsights",
+ *           "/aws/ecs/containerinsights", "/aws/application-signals/data"]</code>.</p>
  *          </important>
  *          <p>Each account can have either one account-level metric extraction policy that applies to
  *       all log groups, or up to 5 policies that are each scoped to a subset of log groups with the
- *       <code>selectionCriteria</code> parameter. The selection criteria supports filtering by <code>LogGroupName</code> and
- *       <code>LogGroupNamePrefix</code> using the operators <code>IN</code> and <code>NOT IN</code>. You can specify up to 50 values in each
- *       <code>IN</code> or <code>NOT IN</code> list.</p>
+ *         <code>selectionCriteria</code> parameter. The selection criteria supports filtering by
+ *         <code>LogGroupName</code> and <code>LogGroupNamePrefix</code> using the operators
+ *         <code>IN</code> and <code>NOT IN</code>. You can specify up to 50 values in each
+ *         <code>IN</code> or <code>NOT IN</code> list.</p>
  *          <p>The selection criteria can be specified in these formats:</p>
  *          <p>
  *             <code>LogGroupName IN ["log-group-1", "log-group-2"]</code>
@@ -218,25 +245,31 @@ declare const PutAccountPolicyCommand_base: {
  *          </p>
  *          <p>If you have multiple account-level metric extraction policies with selection criteria, no
  *       two of them can have overlapping criteria. For example, if you have one policy with selection
- *       criteria <code>LogGroupNamePrefix IN ["my-log"]</code>, you can't have another metric extraction policy
- *       with selection criteria <code>LogGroupNamePrefix IN ["/my-log-prod"]</code> or <code>LogGroupNamePrefix IN
- *       ["/my-logging"]</code>, as the set of log groups matching these prefixes would be a subset of the log
- *       groups matching the first policy's prefix, creating an overlap.</p>
- *          <p>When using <code>NOT IN</code>, only one policy with this operator is allowed per account.</p>
- *          <p>When combining policies with <code>IN</code> and <code>NOT IN</code> operators, the overlap check ensures that
- *       policies don't have conflicting effects. Two policies with <code>IN</code> and <code>NOT IN</code> operators do not
- *       overlap if and only if every value in the <code>IN </code>policy is completely contained within some value
- *       in the <code>NOT IN</code> policy. For example:</p>
+ *       criteria <code>LogGroupNamePrefix IN ["my-log"]</code>, you can't have another metric
+ *       extraction policy with selection criteria <code>LogGroupNamePrefix IN ["/my-log-prod"]</code>
+ *       or <code>LogGroupNamePrefix IN ["/my-logging"]</code>, as the set of log groups matching these
+ *       prefixes would be a subset of the log groups matching the first policy's prefix, creating an
+ *       overlap.</p>
+ *          <p>When using <code>NOT IN</code>, only one policy with this operator is allowed per
+ *       account.</p>
+ *          <p>When combining policies with <code>IN</code> and <code>NOT IN</code> operators, the
+ *       overlap check ensures that policies don't have conflicting effects. Two policies with
+ *         <code>IN</code> and <code>NOT IN</code> operators do not overlap if and only if every value
+ *       in the <code>IN </code>policy is completely contained within some value in the <code>NOT
+ *         IN</code> policy. For example:</p>
  *          <ul>
  *             <li>
- *                <p>If you have a <code>NOT IN</code> policy for prefix <code>"/aws/lambda"</code>, you can create an <code>IN</code> policy for
- *           the exact log group name <code>"/aws/lambda/function1"</code> because the set of log groups matching
- *           <code>"/aws/lambda/function1"</code> is a subset of the log groups matching <code>"/aws/lambda"</code>.</p>
+ *                <p>If you have a <code>NOT IN</code> policy for prefix <code>"/aws/lambda"</code>, you
+ *           can create an <code>IN</code> policy for the exact log group name
+ *             <code>"/aws/lambda/function1"</code> because the set of log groups matching
+ *             <code>"/aws/lambda/function1"</code> is a subset of the log groups matching
+ *             <code>"/aws/lambda"</code>.</p>
  *             </li>
  *             <li>
- *                <p>If you have a <code>NOT IN</code> policy for prefix <code>"/aws/lambda"</code>, you cannot create an <code>IN</code> policy
- *           for prefix <code>"/aws"</code> because the set of log groups matching <code>"/aws"</code> is not a subset of the log
- *           groups matching <code>"/aws/lambda"</code>.</p>
+ *                <p>If you have a <code>NOT IN</code> policy for prefix <code>"/aws/lambda"</code>, you
+ *           cannot create an <code>IN</code> policy for prefix <code>"/aws"</code> because the set of
+ *           log groups matching <code>"/aws"</code> is not a subset of the log groups matching
+ *             <code>"/aws/lambda"</code>.</p>
  *             </li>
  *          </ul>
  * @example

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

@@ -30,7 +30,8 @@ declare const PutDeliveryDestinationCommand_base: {
  * <p>Creates or updates a logical <i>delivery destination</i>. A delivery
  *       destination is an Amazon Web Services resource that represents an Amazon Web Services service
  *       that logs can be sent to. CloudWatch Logs, Amazon S3, and Firehose are
- *       supported as logs delivery destinations  and X-Ray as the trace delivery destination.</p>
+ *       supported as logs delivery destinations and X-Ray as the trace delivery
+ *       destination.</p>
  *          <p>To configure logs delivery between a supported Amazon Web Services service and a
  *       destination, you must do the following:</p>
  *          <ul>

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

@@ -45,6 +45,32 @@ declare const PutIndexPolicyCommand_base: {
  *             </code> or <code>requestId IN [<i>value</i>,
  *           <i>value</i>, ...]</code> will process fewer log events to reduce costs, and
  *       have improved performance.</p>
+ *          <p>CloudWatch Logs provides default field indexes for all log groups in the Standard log
+ *       class. Default field indexes are automatically available for the following fields: </p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <code>@aws.region</code>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <code>@aws.account</code>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <code>@source.log</code>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <code>traceId</code>
+ *                </p>
+ *             </li>
+ *          </ul>
+ *          <p>Default field indexes are in addition to any custom field indexes you define within your
+ *       policy. Default field indexes are not counted towards your field index quota. </p>
  *          <p>Each index policy has the following quotas and restrictions:</p>
  *          <ul>
  *             <li>

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

@@ -74,6 +74,10 @@ declare const PutMetricFilterCommand_base: {
  *     },
  *   ],
  *   applyOnTransformedLogs: true || false,
+ *   fieldSelectionCriteria: "STRING_VALUE",
+ *   emitSystemFieldDimensions: [ // EmitSystemFields
+ *     "STRING_VALUE",
+ *   ],
  * };
  * const command = new PutMetricFilterCommand(input);
  * const response = await client.send(command);

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

@@ -76,6 +76,10 @@ declare const PutSubscriptionFilterCommand_base: {
  *   roleArn: "STRING_VALUE",
  *   distribution: "Random" || "ByLogStream",
  *   applyOnTransformedLogs: true || false,
+ *   fieldSelectionCriteria: "STRING_VALUE",
+ *   emitSystemFields: [ // EmitSystemFields
+ *     "STRING_VALUE",
+ *   ],
  * };
  * const command = new PutSubscriptionFilterCommand(input);
  * const response = await client.send(command);

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

@@ -34,8 +34,8 @@ declare const UntagLogGroupCommand_base: {
  *          <p>Removes the specified tags from the specified log group.</p>
  *          <p>To list the tags for a log group, use <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListTagsForResource.html">ListTagsForResource</a>. To add tags, use <a href="https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_TagResource.html">TagResource</a>.</p>
  *          <p>When using IAM policies to control tag management for CloudWatch Logs log groups, the
- *       condition keys <code>aws:Resource/key-name</code> and <code>aws:TagKeys</code> cannot be used to restrict which tags
- *       users can assign. </p>
+ *       condition keys <code>aws:Resource/key-name</code> and <code>aws:TagKeys</code> cannot be used
+ *       to restrict which tags users can assign. </p>
  *
  * @deprecated Please use the generic tagging API UntagResource
  * @example

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

@@ -805,7 +805,7 @@ export interface Delivery {
      */
     deliveryDestinationArn?: string | undefined;
     /**
-     * <p>Displays whether the delivery destination associated with this delivery is CloudWatch Logs, Amazon S3, Firehose,  or X-Ray.</p>
+     * <p>Displays whether the delivery destination associated with this delivery is CloudWatch Logs, Amazon S3, Firehose, or X-Ray.</p>
      * @public
      */
     deliveryDestinationType?: DeliveryDestinationType | undefined;
@@ -1441,12 +1441,14 @@ export interface DeleteResourcePolicyRequest {
      */
     policyName?: string | undefined;
     /**
-     * <p>The ARN of the CloudWatch Logs resource for which the resource policy needs to be deleted</p>
+     * <p>The ARN of the CloudWatch Logs resource for which the resource policy needs to be
+     *       deleted</p>
      * @public
      */
     resourceArn?: string | undefined;
     /**
-     * <p>The expected revision ID of the resource policy. Required when deleting a resource-scoped policy to prevent concurrent modifications.</p>
+     * <p>The expected revision ID of the resource policy. Required when deleting a resource-scoped
+     *       policy to prevent concurrent modifications.</p>
      * @public
      */
     expectedRevisionId?: string | undefined;
@@ -1503,8 +1505,8 @@ export interface DeliveryDestinationConfiguration {
 /**
  * <p>This structure contains information about one <i>delivery destination</i> in
  *       your account. A delivery destination is an Amazon Web Services resource that represents an
- *       Amazon Web Services service that logs can be sent to. CloudWatch Logs, Amazon S3, Firehose, and X-Ray
- *       are supported as delivery destinations.</p>
+ *         Amazon Web Services service that logs can be sent to. CloudWatch Logs, Amazon S3,
+ *         Firehose, and X-Ray are supported as delivery destinations.</p>
  *          <p>To configure logs delivery between a supported Amazon Web Services service and a
  *       destination, you must do the following:</p>
  *          <ul>
@@ -1542,7 +1544,8 @@ export interface DeliveryDestination {
      */
     arn?: string | undefined;
     /**
-     * <p>Displays whether this delivery destination is CloudWatch Logs, Amazon S3, Firehose, or X-Ray.</p>
+     * <p>Displays whether this delivery destination is CloudWatch Logs, Amazon S3,
+     *         Firehose, or X-Ray.</p>
      * @public
      */
     deliveryDestinationType?: DeliveryDestinationType | undefined;
@@ -2781,6 +2784,16 @@ export interface MetricFilter {
      * @public
      */
     applyOnTransformedLogs?: boolean | undefined;
+    /**
+     * <p>The filter expression that specifies which log events are processed by this metric filter based on system fields. Returns the <code>fieldSelectionCriteria</code> value if it was specified when the metric filter was created.</p>
+     * @public
+     */
+    fieldSelectionCriteria?: string | undefined;
+    /**
+     * <p>The list of system fields that are emitted as additional dimensions in the generated metrics. Returns the <code>emitSystemFieldDimensions</code> value if it was specified when the metric filter was created.</p>
+     * @public
+     */
+    emitSystemFieldDimensions?: string[] | undefined;
 }
 /**
  * @public
@@ -3039,7 +3052,8 @@ export interface DescribeResourcePoliciesRequest {
      */
     resourceArn?: string | undefined;
     /**
-     * <p>Specifies the scope of the resource policy. Valid values are <code>ACCOUNT</code> or <code>RESOURCE</code>. When not specified, defaults to <code>ACCOUNT</code>.</p>
+     * <p>Specifies the scope of the resource policy. Valid values are <code>ACCOUNT</code> or
+     *         <code>RESOURCE</code>. When not specified, defaults to <code>ACCOUNT</code>.</p>
      * @public
      */
     policyScope?: PolicyScope | undefined;
@@ -3072,12 +3086,14 @@ export interface ResourcePolicy {
      */
     policyScope?: PolicyScope | undefined;
     /**
-     * <p>The ARN of the CloudWatch Logs resource to which the resource policy is attached. Only populated for resource-scoped policies.</p>
+     * <p>The ARN of the CloudWatch Logs resource to which the resource policy is attached. Only
+     *       populated for resource-scoped policies.</p>
      * @public
      */
     resourceArn?: string | undefined;
     /**
-     * <p>The revision ID of the resource policy. Only populated for resource-scoped policies.</p>
+     * <p>The revision ID of the resource policy. Only populated for resource-scoped
+     *       policies.</p>
      * @public
      */
     revisionId?: string | undefined;
@@ -3190,6 +3206,16 @@ export interface SubscriptionFilter {
      * @public
      */
     creationTime?: number | undefined;
+    /**
+     * <p>The filter expression that specifies which log events are processed by this subscription filter based on system fields. Returns the <code>fieldSelectionCriteria</code> value if it was specified when the subscription filter was created.</p>
+     * @public
+     */
+    fieldSelectionCriteria?: string | undefined;
+    /**
+     * <p>The list of system fields that are included in the log events sent to the subscription destination. Returns the <code>emitSystemFields</code> value if it was specified when the subscription filter was created.</p>
+     * @public
+     */
+    emitSystemFields?: string[] | undefined;
 }
 /**
  * @public
@@ -3311,12 +3337,15 @@ export declare const EventSource: {
  */
 export type EventSource = (typeof EventSource)[keyof typeof EventSource];
 /**
- * <p>A structure containing the extracted fields from a log event. These fields are extracted based on the log format and can be used for structured querying and analysis.</p>
+ * <p>A structure containing the extracted fields from a log event. These fields are extracted
+ *       based on the log format and can be used for structured querying and analysis.</p>
  * @public
  */
 export interface FieldsData {
     /**
-     * <p>The actual log data content returned in the streaming response. This contains the fields and values of the log event in a structured format that can be parsed and processed by the client.</p>
+     * <p>The actual log data content returned in the streaming response. This contains the fields
+     *       and values of the log event in a structured format that can be parsed and processed by the
+     *       client.</p>
      * @public
      */
     data?: Uint8Array | undefined;
@@ -4266,18 +4295,24 @@ export interface GetLogGroupFieldsResponse {
  */
 export interface GetLogObjectRequest {
     /**
-     * <p>A boolean flag that indicates whether to unmask sensitive log data. When set to true, any masked or redacted data in the log object will be displayed in its original form. Default is false.</p>
+     * <p>A boolean flag that indicates whether to unmask sensitive log data. When set to true, any
+     *       masked or redacted data in the log object will be displayed in its original form. Default is
+     *       false.</p>
      * @public
      */
     unmask?: boolean | undefined;
     /**
-     * <p>A pointer to the specific log object to retrieve. This is a required parameter that uniquely identifies the log object within CloudWatch Logs. The pointer is typically obtained from a previous query or filter operation.</p>
+     * <p>A pointer to the specific log object to retrieve. This is a required parameter that
+     *       uniquely identifies the log object within CloudWatch Logs. The pointer is typically obtained
+     *       from a previous query or filter operation.</p>
      * @public
      */
     logObjectPointer: string | undefined;
 }
 /**
- * <p>An internal error occurred during the streaming of log data. This exception is thrown when there's an issue with the internal streaming mechanism used by the GetLogObject operation.</p>
+ * <p>An internal error occurred during the streaming of log data. This exception is thrown when
+ *       there's an issue with the internal streaming mechanism used by the GetLogObject
+ *       operation.</p>
  * @public
  */
 export declare class InternalStreamingException extends __BaseException {
@@ -4289,7 +4324,8 @@ export declare class InternalStreamingException extends __BaseException {
     constructor(opts: __ExceptionOptionType<InternalStreamingException, __BaseException>);
 }
 /**
- * <p>A stream of structured log data returned by the GetLogObject operation. This stream contains log events with their associated metadata and extracted fields.</p>
+ * <p>A stream of structured log data returned by the GetLogObject operation. This stream
+ *       contains log events with their associated metadata and extracted fields.</p>
  * @public
  */
 export type GetLogObjectResponseStream = GetLogObjectResponseStream.InternalStreamingExceptionMember | GetLogObjectResponseStream.FieldsMember | GetLogObjectResponseStream.$UnknownMember;
@@ -4298,7 +4334,8 @@ export type GetLogObjectResponseStream = GetLogObjectResponseStream.InternalStre
  */
 export declare namespace GetLogObjectResponseStream {
     /**
-     * <p>A structure containing the extracted fields from a log event. These fields are extracted based on the log format and can be used for structured querying and analysis.</p>
+     * <p>A structure containing the extracted fields from a log event. These fields are extracted
+     *       based on the log format and can be used for structured querying and analysis.</p>
      * @public
      */
     interface FieldsMember {
@@ -4307,7 +4344,9 @@ export declare namespace GetLogObjectResponseStream {
         $unknown?: never;
     }
     /**
-     * <p>An internal error occurred during the streaming of log data. This exception is thrown when there's an issue with the internal streaming mechanism used by the GetLogObject operation.</p>
+     * <p>An internal error occurred during the streaming of log data. This exception is thrown when
+     *       there's an issue with the internal streaming mechanism used by the GetLogObject
+     *       operation.</p>
      * @public
      */
     interface InternalStreamingExceptionMember {
@@ -4336,7 +4375,8 @@ export declare namespace GetLogObjectResponseStream {
  */
 export interface GetLogObjectResponse {
     /**
-     * <p>A stream of structured log data returned by the GetLogObject operation. This stream contains log events with their associated metadata and extracted fields.</p>
+     * <p>A stream of structured log data returned by the GetLogObject operation. This stream
+     *       contains log events with their associated metadata and extracted fields.</p>
      * @public
      */
     fieldStream?: AsyncIterable<GetLogObjectResponseStream> | undefined;
@@ -4508,7 +4548,7 @@ export interface GetTransformerRequest {
 /**
  * <p>This processor uses pattern matching to parse and structure unstructured data. This
  *       processor can also extract fields from log messages.</p>
- *          <p>For more information about this processor including examples, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch-Logs-Transformation.html#CloudWatch-Logs-Transformation-Grok"> grok</a> in the <i>CloudWatch Logs User Guide</i>.</p>
+ *          <p>For more information about this processor including examples, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch-Logs-Transformation-Processors.html#CloudWatch-Logs-Transformation-Grok">grok</a> in the <i>CloudWatch Logs User Guide</i>.</p>
  * @public
  */
 export interface Grok {
@@ -4520,7 +4560,7 @@ export interface Grok {
     source?: string | undefined;
     /**
      * <p>The grok pattern to match against the log event. For a list of supported grok patterns,
-     *       see <a href="https://docs.aws.amazon.com/mazonCloudWatch/latest/logs/CloudWatch-Logs-Transformation-Processors.html#Grok-Patterns">Supported grok patterns</a>.</p>
+     *       see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch-Logs-Transformation-Processors.html#Grok-Patterns">Supported grok patterns</a>.</p>
      * @public
      */
     match: string | undefined;
@@ -5907,13 +5947,18 @@ export interface PutDeliveryDestinationRequest {
      *       logs.</p>
      *          <note>
      *             <p>
-     *                <code>deliveryDestinationConfiguration</code> is required for CloudWatch Logs, Amazon S3, Firehose log delivery destinations and not required for X-Ray trace delivery destinations. <code>deliveryDestinationType</code> is needed for X-Ray trace delivery destinations but not required for other logs delivery destinations.</p>
+     *                <code>deliveryDestinationConfiguration</code> is required for CloudWatch Logs,
+     *           Amazon S3, Firehose log delivery destinations and not required for
+     *           X-Ray trace delivery destinations. <code>deliveryDestinationType</code> is
+     *         needed for X-Ray trace delivery destinations but not required for other logs
+     *         delivery destinations.</p>
      *          </note>
      * @public
      */
     deliveryDestinationConfiguration?: DeliveryDestinationConfiguration | undefined;
     /**
-     * <p>The type of delivery destination. This parameter specifies the target service where log data will be delivered. Valid values include:</p>
+     * <p>The type of delivery destination. This parameter specifies the target service where log
+     *       data will be delivered. Valid values include:</p>
      *          <ul>
      *             <li>
      *                <p>
@@ -5929,10 +5974,12 @@ export interface PutDeliveryDestinationRequest {
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>XRAY</code> - Amazon Web Services X-Ray for distributed tracing and application monitoring</p>
+     *                   <code>XRAY</code> - Amazon Web Services
+     *           X-Ray for distributed tracing and application monitoring</p>
      *             </li>
      *          </ul>
-     *          <p>The delivery destination type determines the format and configuration options available for log delivery.</p>
+     *          <p>The delivery destination type determines the format and configuration options available
+     *       for log delivery.</p>
      * @public
      */
     deliveryDestinationType?: DeliveryDestinationType | undefined;
@@ -6002,7 +6049,8 @@ export interface PutDeliverySourceRequest {
      * <p>Defines the type of log that the source is sending.</p>
      *          <ul>
      *             <li>
-     *                <p>For Amazon Bedrock, the valid value is <code>APPLICATION_LOGS</code> and <code>TRACES</code>.</p>
+     *                <p>For Amazon Bedrock, the valid value is <code>APPLICATION_LOGS</code> and
+     *             <code>TRACES</code>.</p>
      *             </li>
      *             <li>
      *                <p>For CloudFront, the valid value is <code>ACCESS_LOGS</code>.</p>
@@ -6437,6 +6485,16 @@ export interface PutMetricFilterRequest {
      * @public
      */
     applyOnTransformedLogs?: boolean | undefined;
+    /**
+     * <p>A filter expression that specifies which log events should be processed by this metric filter based on system fields such as source account and source region. Uses selection criteria syntax with operators like <code>=</code>, <code>!=</code>, <code>AND</code>, <code>OR</code>, <code>IN</code>, <code>NOT IN</code>. Example: <code>@aws.region = "us-east-1"</code> or <code>@aws.account IN ["123456789012", "987654321098"]</code>. Maximum length: 2000 characters.</p>
+     * @public
+     */
+    fieldSelectionCriteria?: string | undefined;
+    /**
+     * <p>A list of system fields to emit as additional dimensions in the generated metrics. Valid values are <code>@aws.account</code> and <code>@aws.region</code>. These dimensions help identify the source of centralized log data and count toward the total dimension limit for metric filters.</p>
+     * @public
+     */
+    emitSystemFieldDimensions?: string[] | undefined;
 }
 /**
  * @public
@@ -6532,12 +6590,15 @@ export interface PutResourcePolicyRequest {
      */
     policyDocument?: string | undefined;
     /**
-     * <p>The ARN of the CloudWatch Logs resource to which the resource policy needs to be added or attached. Currently only supports LogGroup ARN.</p>
+     * <p>The ARN of the CloudWatch Logs resource to which the resource policy needs to be added
+     *       or attached. Currently only supports LogGroup ARN.</p>
      * @public
      */
     resourceArn?: string | undefined;
     /**
-     * <p>The expected revision ID of the resource policy. Required when <code>resourceArn</code> is provided to prevent concurrent modifications. Use <code>null</code> when creating a resource policy for the first time.</p>
+     * <p>The expected revision ID of the resource policy. Required when <code>resourceArn</code> is
+     *       provided to prevent concurrent modifications. Use <code>null</code> when creating a resource
+     *       policy for the first time.</p>
      * @public
      */
     expectedRevisionId?: string | undefined;
@@ -6552,7 +6613,8 @@ export interface PutResourcePolicyResponse {
      */
     resourcePolicy?: ResourcePolicy | undefined;
     /**
-     * <p>The revision ID of the created or updated resource policy. Only returned for resource-scoped policies.</p>
+     * <p>The revision ID of the created or updated resource policy. Only returned for
+     *       resource-scoped policies.</p>
      * @public
      */
     revisionId?: string | undefined;
@@ -6647,6 +6709,16 @@ export interface PutSubscriptionFilterRequest {
      * @public
      */
     applyOnTransformedLogs?: boolean | undefined;
+    /**
+     * <p>A filter expression that specifies which log events should be processed by this subscription filter based on system fields such as source account and source region. Uses selection criteria syntax with operators like <code>=</code>, <code>!=</code>, <code>AND</code>, <code>OR</code>, <code>IN</code>, <code>NOT IN</code>. Example: <code>@aws.region NOT IN ["cn-north-1"]</code> or <code>@aws.account = "123456789012" AND @aws.region = "us-east-1"</code>. Maximum length: 2000 characters.</p>
+     * @public
+     */
+    fieldSelectionCriteria?: string | undefined;
+    /**
+     * <p>A list of system fields to include in the log events sent to the subscription destination. Valid values are <code>@aws.account</code> and <code>@aws.region</code>. These fields provide source information for centralized log data in the forwarded payload.</p>
+     * @public
+     */
+    emitSystemFields?: string[] | undefined;
 }
 /**
  * @public

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

@@ -673,6 +673,8 @@ export interface MetricFilter {
   creationTime?: number | undefined;
   logGroupName?: string | undefined;
   applyOnTransformedLogs?: boolean | undefined;
+  fieldSelectionCriteria?: string | undefined;
+  emitSystemFieldDimensions?: string[] | undefined;
 }
 export interface DescribeMetricFiltersResponse {
   metricFilters?: MetricFilter[] | undefined;
@@ -774,6 +776,8 @@ export interface SubscriptionFilter {
   distribution?: Distribution | undefined;
   applyOnTransformedLogs?: boolean | undefined;
   creationTime?: number | undefined;
+  fieldSelectionCriteria?: string | undefined;
+  emitSystemFields?: string[] | undefined;
 }
 export interface DescribeSubscriptionFiltersResponse {
   subscriptionFilters?: SubscriptionFilter[] | undefined;
@@ -1473,6 +1477,8 @@ export interface PutMetricFilterRequest {
   filterPattern: string | undefined;
   metricTransformations: MetricTransformation[] | undefined;
   applyOnTransformedLogs?: boolean | undefined;
+  fieldSelectionCriteria?: string | undefined;
+  emitSystemFieldDimensions?: string[] | undefined;
 }
 export interface PutQueryDefinitionRequest {
   queryLanguage?: QueryLanguage | undefined;
@@ -1507,6 +1513,8 @@ export interface PutSubscriptionFilterRequest {
   roleArn?: string | undefined;
   distribution?: Distribution | undefined;
   applyOnTransformedLogs?: boolean | undefined;
+  fieldSelectionCriteria?: string | undefined;
+  emitSystemFields?: string[] | undefined;
 }
 export interface PutTransformerRequest {
   logGroupIdentifier: string | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-cloudwatch-logs",
   "description": "AWS SDK for JavaScript Cloudwatch Logs Client for Node.js, Browser and React Native",
-  "version": "3.887.0",
+  "version": "3.890.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-cloudwatch-logs",
@@ -20,18 +20,18 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "5.2.0",
     "@aws-crypto/sha256-js": "5.2.0",
-    "@aws-sdk/core": "3.887.0",
-    "@aws-sdk/credential-provider-node": "3.887.0",
+    "@aws-sdk/core": "3.890.0",
+    "@aws-sdk/credential-provider-node": "3.890.0",
     "@aws-sdk/middleware-host-header": "3.887.0",
     "@aws-sdk/middleware-logger": "3.887.0",
     "@aws-sdk/middleware-recursion-detection": "3.887.0",
-    "@aws-sdk/middleware-user-agent": "3.887.0",
-    "@aws-sdk/region-config-resolver": "3.887.0",
+    "@aws-sdk/middleware-user-agent": "3.890.0",
+    "@aws-sdk/region-config-resolver": "3.890.0",
     "@aws-sdk/types": "3.887.0",
-    "@aws-sdk/util-endpoints": "3.887.0",
+    "@aws-sdk/util-endpoints": "3.890.0",
     "@aws-sdk/util-user-agent-browser": "3.887.0",
-    "@aws-sdk/util-user-agent-node": "3.887.0",
-    "@smithy/config-resolver": "^4.2.1",
+    "@aws-sdk/util-user-agent-node": "3.890.0",
+    "@smithy/config-resolver": "^4.2.2",
     "@smithy/core": "^3.11.0",
     "@smithy/eventstream-serde-browser": "^4.1.1",
     "@smithy/eventstream-serde-config-resolver": "^4.2.1",
@@ -40,22 +40,22 @@
     "@smithy/hash-node": "^4.1.1",
     "@smithy/invalid-dependency": "^4.1.1",
     "@smithy/middleware-content-length": "^4.1.1",
-    "@smithy/middleware-endpoint": "^4.2.1",
-    "@smithy/middleware-retry": "^4.2.1",
+    "@smithy/middleware-endpoint": "^4.2.2",
+    "@smithy/middleware-retry": "^4.2.2",
     "@smithy/middleware-serde": "^4.1.1",
     "@smithy/middleware-stack": "^4.1.1",
-    "@smithy/node-config-provider": "^4.2.1",
+    "@smithy/node-config-provider": "^4.2.2",
     "@smithy/node-http-handler": "^4.2.1",
     "@smithy/protocol-http": "^5.2.1",
-    "@smithy/smithy-client": "^4.6.1",
+    "@smithy/smithy-client": "^4.6.2",
     "@smithy/types": "^4.5.0",
     "@smithy/url-parser": "^4.1.1",
     "@smithy/util-base64": "^4.1.0",
     "@smithy/util-body-length-browser": "^4.1.0",
     "@smithy/util-body-length-node": "^4.1.0",
-    "@smithy/util-defaults-mode-browser": "^4.1.1",
-    "@smithy/util-defaults-mode-node": "^4.1.1",
-    "@smithy/util-endpoints": "^3.1.1",
+    "@smithy/util-defaults-mode-browser": "^4.1.2",
+    "@smithy/util-defaults-mode-node": "^4.1.2",
+    "@smithy/util-endpoints": "^3.1.2",
     "@smithy/util-middleware": "^4.1.1",
     "@smithy/util-retry": "^4.1.1",
     "@smithy/util-utf8": "^4.1.0",