@aws-sdk/client-cloudwatch-logs 3.888.0 → 3.891.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (96) hide show
  1. package/dist-cjs/index.js +4 -0
  2. package/dist-es/protocols/Aws_json1_1.js +4 -0
  3. package/dist-types/commands/AssociateKmsKeyCommand.d.ts +2 -0
  4. package/dist-types/commands/CancelExportTaskCommand.d.ts +2 -0
  5. package/dist-types/commands/CreateDeliveryCommand.d.ts +2 -0
  6. package/dist-types/commands/CreateExportTaskCommand.d.ts +2 -0
  7. package/dist-types/commands/CreateLogAnomalyDetectorCommand.d.ts +2 -0
  8. package/dist-types/commands/CreateLogGroupCommand.d.ts +2 -0
  9. package/dist-types/commands/CreateLogStreamCommand.d.ts +2 -0
  10. package/dist-types/commands/DeleteAccountPolicyCommand.d.ts +2 -0
  11. package/dist-types/commands/DeleteDataProtectionPolicyCommand.d.ts +2 -0
  12. package/dist-types/commands/DeleteDeliveryCommand.d.ts +2 -0
  13. package/dist-types/commands/DeleteDeliveryDestinationCommand.d.ts +2 -0
  14. package/dist-types/commands/DeleteDeliveryDestinationPolicyCommand.d.ts +2 -0
  15. package/dist-types/commands/DeleteDeliverySourceCommand.d.ts +2 -0
  16. package/dist-types/commands/DeleteDestinationCommand.d.ts +2 -0
  17. package/dist-types/commands/DeleteIndexPolicyCommand.d.ts +2 -0
  18. package/dist-types/commands/DeleteIntegrationCommand.d.ts +2 -0
  19. package/dist-types/commands/DeleteLogAnomalyDetectorCommand.d.ts +2 -0
  20. package/dist-types/commands/DeleteLogGroupCommand.d.ts +2 -0
  21. package/dist-types/commands/DeleteLogStreamCommand.d.ts +2 -0
  22. package/dist-types/commands/DeleteMetricFilterCommand.d.ts +2 -0
  23. package/dist-types/commands/DeleteQueryDefinitionCommand.d.ts +2 -0
  24. package/dist-types/commands/DeleteResourcePolicyCommand.d.ts +2 -0
  25. package/dist-types/commands/DeleteRetentionPolicyCommand.d.ts +2 -0
  26. package/dist-types/commands/DeleteSubscriptionFilterCommand.d.ts +2 -0
  27. package/dist-types/commands/DeleteTransformerCommand.d.ts +2 -0
  28. package/dist-types/commands/DescribeAccountPoliciesCommand.d.ts +2 -0
  29. package/dist-types/commands/DescribeConfigurationTemplatesCommand.d.ts +2 -0
  30. package/dist-types/commands/DescribeDeliveriesCommand.d.ts +4 -2
  31. package/dist-types/commands/DescribeDeliveryDestinationsCommand.d.ts +2 -0
  32. package/dist-types/commands/DescribeDeliverySourcesCommand.d.ts +2 -0
  33. package/dist-types/commands/DescribeDestinationsCommand.d.ts +2 -0
  34. package/dist-types/commands/DescribeExportTasksCommand.d.ts +2 -0
  35. package/dist-types/commands/DescribeFieldIndexesCommand.d.ts +4 -2
  36. package/dist-types/commands/DescribeIndexPoliciesCommand.d.ts +3 -1
  37. package/dist-types/commands/DescribeLogGroupsCommand.d.ts +2 -0
  38. package/dist-types/commands/DescribeLogStreamsCommand.d.ts +2 -0
  39. package/dist-types/commands/DescribeMetricFiltersCommand.d.ts +6 -0
  40. package/dist-types/commands/DescribeQueriesCommand.d.ts +2 -0
  41. package/dist-types/commands/DescribeQueryDefinitionsCommand.d.ts +2 -0
  42. package/dist-types/commands/DescribeResourcePoliciesCommand.d.ts +2 -0
  43. package/dist-types/commands/DescribeSubscriptionFiltersCommand.d.ts +6 -0
  44. package/dist-types/commands/DisassociateKmsKeyCommand.d.ts +2 -0
  45. package/dist-types/commands/FilterLogEventsCommand.d.ts +3 -1
  46. package/dist-types/commands/GetDataProtectionPolicyCommand.d.ts +2 -0
  47. package/dist-types/commands/GetDeliveryCommand.d.ts +2 -0
  48. package/dist-types/commands/GetDeliveryDestinationCommand.d.ts +2 -0
  49. package/dist-types/commands/GetDeliveryDestinationPolicyCommand.d.ts +2 -0
  50. package/dist-types/commands/GetDeliverySourceCommand.d.ts +2 -0
  51. package/dist-types/commands/GetIntegrationCommand.d.ts +2 -0
  52. package/dist-types/commands/GetLogAnomalyDetectorCommand.d.ts +2 -0
  53. package/dist-types/commands/GetLogEventsCommand.d.ts +2 -0
  54. package/dist-types/commands/GetLogGroupFieldsCommand.d.ts +2 -0
  55. package/dist-types/commands/GetLogObjectCommand.d.ts +13 -4
  56. package/dist-types/commands/GetLogRecordCommand.d.ts +2 -0
  57. package/dist-types/commands/GetQueryResultsCommand.d.ts +2 -0
  58. package/dist-types/commands/GetTransformerCommand.d.ts +2 -0
  59. package/dist-types/commands/ListAnomaliesCommand.d.ts +2 -0
  60. package/dist-types/commands/ListIntegrationsCommand.d.ts +2 -0
  61. package/dist-types/commands/ListLogAnomalyDetectorsCommand.d.ts +2 -0
  62. package/dist-types/commands/ListLogGroupsCommand.d.ts +2 -0
  63. package/dist-types/commands/ListLogGroupsForQueryCommand.d.ts +2 -0
  64. package/dist-types/commands/ListTagsForResourceCommand.d.ts +2 -0
  65. package/dist-types/commands/ListTagsLogGroupCommand.d.ts +2 -0
  66. package/dist-types/commands/PutAccountPolicyCommand.d.ts +58 -23
  67. package/dist-types/commands/PutDataProtectionPolicyCommand.d.ts +2 -0
  68. package/dist-types/commands/PutDeliveryDestinationCommand.d.ts +4 -1
  69. package/dist-types/commands/PutDeliveryDestinationPolicyCommand.d.ts +2 -0
  70. package/dist-types/commands/PutDeliverySourceCommand.d.ts +2 -0
  71. package/dist-types/commands/PutDestinationCommand.d.ts +2 -0
  72. package/dist-types/commands/PutDestinationPolicyCommand.d.ts +2 -0
  73. package/dist-types/commands/PutIndexPolicyCommand.d.ts +28 -0
  74. package/dist-types/commands/PutIntegrationCommand.d.ts +2 -0
  75. package/dist-types/commands/PutLogEventsCommand.d.ts +2 -0
  76. package/dist-types/commands/PutMetricFilterCommand.d.ts +6 -0
  77. package/dist-types/commands/PutQueryDefinitionCommand.d.ts +2 -0
  78. package/dist-types/commands/PutResourcePolicyCommand.d.ts +2 -0
  79. package/dist-types/commands/PutRetentionPolicyCommand.d.ts +2 -0
  80. package/dist-types/commands/PutSubscriptionFilterCommand.d.ts +6 -0
  81. package/dist-types/commands/PutTransformerCommand.d.ts +2 -0
  82. package/dist-types/commands/StartLiveTailCommand.d.ts +2 -0
  83. package/dist-types/commands/StartQueryCommand.d.ts +2 -0
  84. package/dist-types/commands/StopQueryCommand.d.ts +2 -0
  85. package/dist-types/commands/TagLogGroupCommand.d.ts +2 -0
  86. package/dist-types/commands/TagResourceCommand.d.ts +2 -0
  87. package/dist-types/commands/TestMetricFilterCommand.d.ts +2 -0
  88. package/dist-types/commands/TestTransformerCommand.d.ts +2 -0
  89. package/dist-types/commands/UntagLogGroupCommand.d.ts +4 -2
  90. package/dist-types/commands/UntagResourceCommand.d.ts +2 -0
  91. package/dist-types/commands/UpdateAnomalyCommand.d.ts +2 -0
  92. package/dist-types/commands/UpdateDeliveryConfigurationCommand.d.ts +2 -0
  93. package/dist-types/commands/UpdateLogAnomalyDetectorCommand.d.ts +2 -0
  94. package/dist-types/models/models_0.d.ts +100 -28
  95. package/dist-types/ts3.4/models/models_0.d.ts +8 -0
  96. package/package.json +19 -19
@@ -34,8 +34,8 @@ declare const UntagLogGroupCommand_base: {
34
34
  * <p>Removes the specified tags from the specified log group.</p>
35
35
  * <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>
36
36
  * <p>When using IAM policies to control tag management for CloudWatch Logs log groups, the
37
- * condition keys <code>aws:Resource/key-name</code> and <code>aws:TagKeys</code> cannot be used to restrict which tags
38
- * users can assign. </p>
37
+ * condition keys <code>aws:Resource/key-name</code> and <code>aws:TagKeys</code> cannot be used
38
+ * to restrict which tags users can assign. </p>
39
39
  *
40
40
  * @deprecated Please use the generic tagging API UntagResource
41
41
  * @example
@@ -43,6 +43,8 @@ declare const UntagLogGroupCommand_base: {
43
43
  * ```javascript
44
44
  * import { CloudWatchLogsClient, UntagLogGroupCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
45
45
  * // const { CloudWatchLogsClient, UntagLogGroupCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
46
+ * // import type { CloudWatchLogsClientConfig } from "@aws-sdk/client-cloudwatch-logs";
47
+ * const config = {}; // type is CloudWatchLogsClientConfig
46
48
  * const client = new CloudWatchLogsClient(config);
47
49
  * const input = { // UntagLogGroupRequest
48
50
  * logGroupName: "STRING_VALUE", // required
@@ -33,6 +33,8 @@ declare const UntagResourceCommand_base: {
33
33
  * ```javascript
34
34
  * import { CloudWatchLogsClient, UntagResourceCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
35
35
  * // const { CloudWatchLogsClient, UntagResourceCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
36
+ * // import type { CloudWatchLogsClientConfig } from "@aws-sdk/client-cloudwatch-logs";
37
+ * const config = {}; // type is CloudWatchLogsClientConfig
36
38
  * const client = new CloudWatchLogsClient(config);
37
39
  * const input = { // UntagResourceRequest
38
40
  * resourceArn: "STRING_VALUE", // required
@@ -42,6 +42,8 @@ declare const UpdateAnomalyCommand_base: {
42
42
  * ```javascript
43
43
  * import { CloudWatchLogsClient, UpdateAnomalyCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
44
44
  * // const { CloudWatchLogsClient, UpdateAnomalyCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
45
+ * // import type { CloudWatchLogsClientConfig } from "@aws-sdk/client-cloudwatch-logs";
46
+ * const config = {}; // type is CloudWatchLogsClientConfig
45
47
  * const client = new CloudWatchLogsClient(config);
46
48
  * const input = { // UpdateAnomalyRequest
47
49
  * anomalyId: "STRING_VALUE",
@@ -35,6 +35,8 @@ declare const UpdateDeliveryConfigurationCommand_base: {
35
35
  * ```javascript
36
36
  * import { CloudWatchLogsClient, UpdateDeliveryConfigurationCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
37
37
  * // const { CloudWatchLogsClient, UpdateDeliveryConfigurationCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
38
+ * // import type { CloudWatchLogsClientConfig } from "@aws-sdk/client-cloudwatch-logs";
39
+ * const config = {}; // type is CloudWatchLogsClientConfig
38
40
  * const client = new CloudWatchLogsClient(config);
39
41
  * const input = { // UpdateDeliveryConfigurationRequest
40
42
  * id: "STRING_VALUE", // required
@@ -33,6 +33,8 @@ declare const UpdateLogAnomalyDetectorCommand_base: {
33
33
  * ```javascript
34
34
  * import { CloudWatchLogsClient, UpdateLogAnomalyDetectorCommand } from "@aws-sdk/client-cloudwatch-logs"; // ES Modules import
35
35
  * // const { CloudWatchLogsClient, UpdateLogAnomalyDetectorCommand } = require("@aws-sdk/client-cloudwatch-logs"); // CommonJS import
36
+ * // import type { CloudWatchLogsClientConfig } from "@aws-sdk/client-cloudwatch-logs";
37
+ * const config = {}; // type is CloudWatchLogsClientConfig
36
38
  * const client = new CloudWatchLogsClient(config);
37
39
  * const input = { // UpdateLogAnomalyDetectorRequest
38
40
  * anomalyDetectorArn: "STRING_VALUE", // required
@@ -805,7 +805,7 @@ export interface Delivery {
805
805
  */
806
806
  deliveryDestinationArn?: string | undefined;
807
807
  /**
808
- * <p>Displays whether the delivery destination associated with this delivery is CloudWatch Logs, Amazon S3, Firehose, or X-Ray.</p>
808
+ * <p>Displays whether the delivery destination associated with this delivery is CloudWatch Logs, Amazon S3, Firehose, or X-Ray.</p>
809
809
  * @public
810
810
  */
811
811
  deliveryDestinationType?: DeliveryDestinationType | undefined;
@@ -1441,12 +1441,14 @@ export interface DeleteResourcePolicyRequest {
1441
1441
  */
1442
1442
  policyName?: string | undefined;
1443
1443
  /**
1444
- * <p>The ARN of the CloudWatch Logs resource for which the resource policy needs to be deleted</p>
1444
+ * <p>The ARN of the CloudWatch Logs resource for which the resource policy needs to be
1445
+ * deleted</p>
1445
1446
  * @public
1446
1447
  */
1447
1448
  resourceArn?: string | undefined;
1448
1449
  /**
1449
- * <p>The expected revision ID of the resource policy. Required when deleting a resource-scoped policy to prevent concurrent modifications.</p>
1450
+ * <p>The expected revision ID of the resource policy. Required when deleting a resource-scoped
1451
+ * policy to prevent concurrent modifications.</p>
1450
1452
  * @public
1451
1453
  */
1452
1454
  expectedRevisionId?: string | undefined;
@@ -1503,8 +1505,8 @@ export interface DeliveryDestinationConfiguration {
1503
1505
  /**
1504
1506
  * <p>This structure contains information about one <i>delivery destination</i> in
1505
1507
  * your account. A delivery destination is an Amazon Web Services resource that represents an
1506
- * Amazon Web Services service that logs can be sent to. CloudWatch Logs, Amazon S3, Firehose, and X-Ray
1507
- * are supported as delivery destinations.</p>
1508
+ * Amazon Web Services service that logs can be sent to. CloudWatch Logs, Amazon S3,
1509
+ * Firehose, and X-Ray are supported as delivery destinations.</p>
1508
1510
  * <p>To configure logs delivery between a supported Amazon Web Services service and a
1509
1511
  * destination, you must do the following:</p>
1510
1512
  * <ul>
@@ -1542,7 +1544,8 @@ export interface DeliveryDestination {
1542
1544
  */
1543
1545
  arn?: string | undefined;
1544
1546
  /**
1545
- * <p>Displays whether this delivery destination is CloudWatch Logs, Amazon S3, Firehose, or X-Ray.</p>
1547
+ * <p>Displays whether this delivery destination is CloudWatch Logs, Amazon S3,
1548
+ * Firehose, or X-Ray.</p>
1546
1549
  * @public
1547
1550
  */
1548
1551
  deliveryDestinationType?: DeliveryDestinationType | undefined;
@@ -2781,6 +2784,16 @@ export interface MetricFilter {
2781
2784
  * @public
2782
2785
  */
2783
2786
  applyOnTransformedLogs?: boolean | undefined;
2787
+ /**
2788
+ * <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>
2789
+ * @public
2790
+ */
2791
+ fieldSelectionCriteria?: string | undefined;
2792
+ /**
2793
+ * <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>
2794
+ * @public
2795
+ */
2796
+ emitSystemFieldDimensions?: string[] | undefined;
2784
2797
  }
2785
2798
  /**
2786
2799
  * @public
@@ -3039,7 +3052,8 @@ export interface DescribeResourcePoliciesRequest {
3039
3052
  */
3040
3053
  resourceArn?: string | undefined;
3041
3054
  /**
3042
- * <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>
3055
+ * <p>Specifies the scope of the resource policy. Valid values are <code>ACCOUNT</code> or
3056
+ * <code>RESOURCE</code>. When not specified, defaults to <code>ACCOUNT</code>.</p>
3043
3057
  * @public
3044
3058
  */
3045
3059
  policyScope?: PolicyScope | undefined;
@@ -3072,12 +3086,14 @@ export interface ResourcePolicy {
3072
3086
  */
3073
3087
  policyScope?: PolicyScope | undefined;
3074
3088
  /**
3075
- * <p>The ARN of the CloudWatch Logs resource to which the resource policy is attached. Only populated for resource-scoped policies.</p>
3089
+ * <p>The ARN of the CloudWatch Logs resource to which the resource policy is attached. Only
3090
+ * populated for resource-scoped policies.</p>
3076
3091
  * @public
3077
3092
  */
3078
3093
  resourceArn?: string | undefined;
3079
3094
  /**
3080
- * <p>The revision ID of the resource policy. Only populated for resource-scoped policies.</p>
3095
+ * <p>The revision ID of the resource policy. Only populated for resource-scoped
3096
+ * policies.</p>
3081
3097
  * @public
3082
3098
  */
3083
3099
  revisionId?: string | undefined;
@@ -3190,6 +3206,16 @@ export interface SubscriptionFilter {
3190
3206
  * @public
3191
3207
  */
3192
3208
  creationTime?: number | undefined;
3209
+ /**
3210
+ * <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>
3211
+ * @public
3212
+ */
3213
+ fieldSelectionCriteria?: string | undefined;
3214
+ /**
3215
+ * <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>
3216
+ * @public
3217
+ */
3218
+ emitSystemFields?: string[] | undefined;
3193
3219
  }
3194
3220
  /**
3195
3221
  * @public
@@ -3311,12 +3337,15 @@ export declare const EventSource: {
3311
3337
  */
3312
3338
  export type EventSource = (typeof EventSource)[keyof typeof EventSource];
3313
3339
  /**
3314
- * <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>
3340
+ * <p>A structure containing the extracted fields from a log event. These fields are extracted
3341
+ * based on the log format and can be used for structured querying and analysis.</p>
3315
3342
  * @public
3316
3343
  */
3317
3344
  export interface FieldsData {
3318
3345
  /**
3319
- * <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>
3346
+ * <p>The actual log data content returned in the streaming response. This contains the fields
3347
+ * and values of the log event in a structured format that can be parsed and processed by the
3348
+ * client.</p>
3320
3349
  * @public
3321
3350
  */
3322
3351
  data?: Uint8Array | undefined;
@@ -4266,18 +4295,24 @@ export interface GetLogGroupFieldsResponse {
4266
4295
  */
4267
4296
  export interface GetLogObjectRequest {
4268
4297
  /**
4269
- * <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>
4298
+ * <p>A boolean flag that indicates whether to unmask sensitive log data. When set to true, any
4299
+ * masked or redacted data in the log object will be displayed in its original form. Default is
4300
+ * false.</p>
4270
4301
  * @public
4271
4302
  */
4272
4303
  unmask?: boolean | undefined;
4273
4304
  /**
4274
- * <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>
4305
+ * <p>A pointer to the specific log object to retrieve. This is a required parameter that
4306
+ * uniquely identifies the log object within CloudWatch Logs. The pointer is typically obtained
4307
+ * from a previous query or filter operation.</p>
4275
4308
  * @public
4276
4309
  */
4277
4310
  logObjectPointer: string | undefined;
4278
4311
  }
4279
4312
  /**
4280
- * <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>
4313
+ * <p>An internal error occurred during the streaming of log data. This exception is thrown when
4314
+ * there's an issue with the internal streaming mechanism used by the GetLogObject
4315
+ * operation.</p>
4281
4316
  * @public
4282
4317
  */
4283
4318
  export declare class InternalStreamingException extends __BaseException {
@@ -4289,7 +4324,8 @@ export declare class InternalStreamingException extends __BaseException {
4289
4324
  constructor(opts: __ExceptionOptionType<InternalStreamingException, __BaseException>);
4290
4325
  }
4291
4326
  /**
4292
- * <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>
4327
+ * <p>A stream of structured log data returned by the GetLogObject operation. This stream
4328
+ * contains log events with their associated metadata and extracted fields.</p>
4293
4329
  * @public
4294
4330
  */
4295
4331
  export type GetLogObjectResponseStream = GetLogObjectResponseStream.InternalStreamingExceptionMember | GetLogObjectResponseStream.FieldsMember | GetLogObjectResponseStream.$UnknownMember;
@@ -4298,7 +4334,8 @@ export type GetLogObjectResponseStream = GetLogObjectResponseStream.InternalStre
4298
4334
  */
4299
4335
  export declare namespace GetLogObjectResponseStream {
4300
4336
  /**
4301
- * <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>
4337
+ * <p>A structure containing the extracted fields from a log event. These fields are extracted
4338
+ * based on the log format and can be used for structured querying and analysis.</p>
4302
4339
  * @public
4303
4340
  */
4304
4341
  interface FieldsMember {
@@ -4307,7 +4344,9 @@ export declare namespace GetLogObjectResponseStream {
4307
4344
  $unknown?: never;
4308
4345
  }
4309
4346
  /**
4310
- * <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>
4347
+ * <p>An internal error occurred during the streaming of log data. This exception is thrown when
4348
+ * there's an issue with the internal streaming mechanism used by the GetLogObject
4349
+ * operation.</p>
4311
4350
  * @public
4312
4351
  */
4313
4352
  interface InternalStreamingExceptionMember {
@@ -4336,7 +4375,8 @@ export declare namespace GetLogObjectResponseStream {
4336
4375
  */
4337
4376
  export interface GetLogObjectResponse {
4338
4377
  /**
4339
- * <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>
4378
+ * <p>A stream of structured log data returned by the GetLogObject operation. This stream
4379
+ * contains log events with their associated metadata and extracted fields.</p>
4340
4380
  * @public
4341
4381
  */
4342
4382
  fieldStream?: AsyncIterable<GetLogObjectResponseStream> | undefined;
@@ -4508,7 +4548,7 @@ export interface GetTransformerRequest {
4508
4548
  /**
4509
4549
  * <p>This processor uses pattern matching to parse and structure unstructured data. This
4510
4550
  * processor can also extract fields from log messages.</p>
4511
- * <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>
4551
+ * <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>
4512
4552
  * @public
4513
4553
  */
4514
4554
  export interface Grok {
@@ -4520,7 +4560,7 @@ export interface Grok {
4520
4560
  source?: string | undefined;
4521
4561
  /**
4522
4562
  * <p>The grok pattern to match against the log event. For a list of supported grok patterns,
4523
- * see <a href="https://docs.aws.amazon.com/mazonCloudWatch/latest/logs/CloudWatch-Logs-Transformation-Processors.html#Grok-Patterns">Supported grok patterns</a>.</p>
4563
+ * see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch-Logs-Transformation-Processors.html#Grok-Patterns">Supported grok patterns</a>.</p>
4524
4564
  * @public
4525
4565
  */
4526
4566
  match: string | undefined;
@@ -5907,13 +5947,18 @@ export interface PutDeliveryDestinationRequest {
5907
5947
  * logs.</p>
5908
5948
  * <note>
5909
5949
  * <p>
5910
- * <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>
5950
+ * <code>deliveryDestinationConfiguration</code> is required for CloudWatch Logs,
5951
+ * Amazon S3, Firehose log delivery destinations and not required for
5952
+ * X-Ray trace delivery destinations. <code>deliveryDestinationType</code> is
5953
+ * needed for X-Ray trace delivery destinations but not required for other logs
5954
+ * delivery destinations.</p>
5911
5955
  * </note>
5912
5956
  * @public
5913
5957
  */
5914
5958
  deliveryDestinationConfiguration?: DeliveryDestinationConfiguration | undefined;
5915
5959
  /**
5916
- * <p>The type of delivery destination. This parameter specifies the target service where log data will be delivered. Valid values include:</p>
5960
+ * <p>The type of delivery destination. This parameter specifies the target service where log
5961
+ * data will be delivered. Valid values include:</p>
5917
5962
  * <ul>
5918
5963
  * <li>
5919
5964
  * <p>
@@ -5929,10 +5974,12 @@ export interface PutDeliveryDestinationRequest {
5929
5974
  * </li>
5930
5975
  * <li>
5931
5976
  * <p>
5932
- * <code>XRAY</code> - Amazon Web Services X-Ray for distributed tracing and application monitoring</p>
5977
+ * <code>XRAY</code> - Amazon Web Services
5978
+ * X-Ray for distributed tracing and application monitoring</p>
5933
5979
  * </li>
5934
5980
  * </ul>
5935
- * <p>The delivery destination type determines the format and configuration options available for log delivery.</p>
5981
+ * <p>The delivery destination type determines the format and configuration options available
5982
+ * for log delivery.</p>
5936
5983
  * @public
5937
5984
  */
5938
5985
  deliveryDestinationType?: DeliveryDestinationType | undefined;
@@ -6002,7 +6049,8 @@ export interface PutDeliverySourceRequest {
6002
6049
  * <p>Defines the type of log that the source is sending.</p>
6003
6050
  * <ul>
6004
6051
  * <li>
6005
- * <p>For Amazon Bedrock, the valid value is <code>APPLICATION_LOGS</code> and <code>TRACES</code>.</p>
6052
+ * <p>For Amazon Bedrock, the valid value is <code>APPLICATION_LOGS</code> and
6053
+ * <code>TRACES</code>.</p>
6006
6054
  * </li>
6007
6055
  * <li>
6008
6056
  * <p>For CloudFront, the valid value is <code>ACCESS_LOGS</code>.</p>
@@ -6437,6 +6485,16 @@ export interface PutMetricFilterRequest {
6437
6485
  * @public
6438
6486
  */
6439
6487
  applyOnTransformedLogs?: boolean | undefined;
6488
+ /**
6489
+ * <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>
6490
+ * @public
6491
+ */
6492
+ fieldSelectionCriteria?: string | undefined;
6493
+ /**
6494
+ * <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>
6495
+ * @public
6496
+ */
6497
+ emitSystemFieldDimensions?: string[] | undefined;
6440
6498
  }
6441
6499
  /**
6442
6500
  * @public
@@ -6532,12 +6590,15 @@ export interface PutResourcePolicyRequest {
6532
6590
  */
6533
6591
  policyDocument?: string | undefined;
6534
6592
  /**
6535
- * <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>
6593
+ * <p>The ARN of the CloudWatch Logs resource to which the resource policy needs to be added
6594
+ * or attached. Currently only supports LogGroup ARN.</p>
6536
6595
  * @public
6537
6596
  */
6538
6597
  resourceArn?: string | undefined;
6539
6598
  /**
6540
- * <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>
6599
+ * <p>The expected revision ID of the resource policy. Required when <code>resourceArn</code> is
6600
+ * provided to prevent concurrent modifications. Use <code>null</code> when creating a resource
6601
+ * policy for the first time.</p>
6541
6602
  * @public
6542
6603
  */
6543
6604
  expectedRevisionId?: string | undefined;
@@ -6552,7 +6613,8 @@ export interface PutResourcePolicyResponse {
6552
6613
  */
6553
6614
  resourcePolicy?: ResourcePolicy | undefined;
6554
6615
  /**
6555
- * <p>The revision ID of the created or updated resource policy. Only returned for resource-scoped policies.</p>
6616
+ * <p>The revision ID of the created or updated resource policy. Only returned for
6617
+ * resource-scoped policies.</p>
6556
6618
  * @public
6557
6619
  */
6558
6620
  revisionId?: string | undefined;
@@ -6647,6 +6709,16 @@ export interface PutSubscriptionFilterRequest {
6647
6709
  * @public
6648
6710
  */
6649
6711
  applyOnTransformedLogs?: boolean | undefined;
6712
+ /**
6713
+ * <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>
6714
+ * @public
6715
+ */
6716
+ fieldSelectionCriteria?: string | undefined;
6717
+ /**
6718
+ * <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>
6719
+ * @public
6720
+ */
6721
+ emitSystemFields?: string[] | undefined;
6650
6722
  }
6651
6723
  /**
6652
6724
  * @public
@@ -673,6 +673,8 @@ export interface MetricFilter {
673
673
  creationTime?: number | undefined;
674
674
  logGroupName?: string | undefined;
675
675
  applyOnTransformedLogs?: boolean | undefined;
676
+ fieldSelectionCriteria?: string | undefined;
677
+ emitSystemFieldDimensions?: string[] | undefined;
676
678
  }
677
679
  export interface DescribeMetricFiltersResponse {
678
680
  metricFilters?: MetricFilter[] | undefined;
@@ -774,6 +776,8 @@ export interface SubscriptionFilter {
774
776
  distribution?: Distribution | undefined;
775
777
  applyOnTransformedLogs?: boolean | undefined;
776
778
  creationTime?: number | undefined;
779
+ fieldSelectionCriteria?: string | undefined;
780
+ emitSystemFields?: string[] | undefined;
777
781
  }
778
782
  export interface DescribeSubscriptionFiltersResponse {
779
783
  subscriptionFilters?: SubscriptionFilter[] | undefined;
@@ -1473,6 +1477,8 @@ export interface PutMetricFilterRequest {
1473
1477
  filterPattern: string | undefined;
1474
1478
  metricTransformations: MetricTransformation[] | undefined;
1475
1479
  applyOnTransformedLogs?: boolean | undefined;
1480
+ fieldSelectionCriteria?: string | undefined;
1481
+ emitSystemFieldDimensions?: string[] | undefined;
1476
1482
  }
1477
1483
  export interface PutQueryDefinitionRequest {
1478
1484
  queryLanguage?: QueryLanguage | undefined;
@@ -1507,6 +1513,8 @@ export interface PutSubscriptionFilterRequest {
1507
1513
  roleArn?: string | undefined;
1508
1514
  distribution?: Distribution | undefined;
1509
1515
  applyOnTransformedLogs?: boolean | undefined;
1516
+ fieldSelectionCriteria?: string | undefined;
1517
+ emitSystemFields?: string[] | undefined;
1510
1518
  }
1511
1519
  export interface PutTransformerRequest {
1512
1520
  logGroupIdentifier: string | undefined;
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-cloudwatch-logs",
3
3
  "description": "AWS SDK for JavaScript Cloudwatch Logs Client for Node.js, Browser and React Native",
4
- "version": "3.888.0",
4
+ "version": "3.891.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "node ../../scripts/compilation/inline client-cloudwatch-logs",
@@ -20,18 +20,18 @@
20
20
  "dependencies": {
21
21
  "@aws-crypto/sha256-browser": "5.2.0",
22
22
  "@aws-crypto/sha256-js": "5.2.0",
23
- "@aws-sdk/core": "3.888.0",
24
- "@aws-sdk/credential-provider-node": "3.888.0",
25
- "@aws-sdk/middleware-host-header": "3.887.0",
26
- "@aws-sdk/middleware-logger": "3.887.0",
27
- "@aws-sdk/middleware-recursion-detection": "3.887.0",
28
- "@aws-sdk/middleware-user-agent": "3.888.0",
29
- "@aws-sdk/region-config-resolver": "3.887.0",
23
+ "@aws-sdk/core": "3.890.0",
24
+ "@aws-sdk/credential-provider-node": "3.891.0",
25
+ "@aws-sdk/middleware-host-header": "3.891.0",
26
+ "@aws-sdk/middleware-logger": "3.891.0",
27
+ "@aws-sdk/middleware-recursion-detection": "3.891.0",
28
+ "@aws-sdk/middleware-user-agent": "3.891.0",
29
+ "@aws-sdk/region-config-resolver": "3.890.0",
30
30
  "@aws-sdk/types": "3.887.0",
31
- "@aws-sdk/util-endpoints": "3.887.0",
31
+ "@aws-sdk/util-endpoints": "3.891.0",
32
32
  "@aws-sdk/util-user-agent-browser": "3.887.0",
33
- "@aws-sdk/util-user-agent-node": "3.888.0",
34
- "@smithy/config-resolver": "^4.2.1",
33
+ "@aws-sdk/util-user-agent-node": "3.891.0",
34
+ "@smithy/config-resolver": "^4.2.2",
35
35
  "@smithy/core": "^3.11.0",
36
36
  "@smithy/eventstream-serde-browser": "^4.1.1",
37
37
  "@smithy/eventstream-serde-config-resolver": "^4.2.1",
@@ -40,24 +40,24 @@
40
40
  "@smithy/hash-node": "^4.1.1",
41
41
  "@smithy/invalid-dependency": "^4.1.1",
42
42
  "@smithy/middleware-content-length": "^4.1.1",
43
- "@smithy/middleware-endpoint": "^4.2.1",
44
- "@smithy/middleware-retry": "^4.2.1",
43
+ "@smithy/middleware-endpoint": "^4.2.2",
44
+ "@smithy/middleware-retry": "^4.2.3",
45
45
  "@smithy/middleware-serde": "^4.1.1",
46
46
  "@smithy/middleware-stack": "^4.1.1",
47
- "@smithy/node-config-provider": "^4.2.1",
47
+ "@smithy/node-config-provider": "^4.2.2",
48
48
  "@smithy/node-http-handler": "^4.2.1",
49
49
  "@smithy/protocol-http": "^5.2.1",
50
- "@smithy/smithy-client": "^4.6.1",
50
+ "@smithy/smithy-client": "^4.6.2",
51
51
  "@smithy/types": "^4.5.0",
52
52
  "@smithy/url-parser": "^4.1.1",
53
53
  "@smithy/util-base64": "^4.1.0",
54
54
  "@smithy/util-body-length-browser": "^4.1.0",
55
55
  "@smithy/util-body-length-node": "^4.1.0",
56
- "@smithy/util-defaults-mode-browser": "^4.1.1",
57
- "@smithy/util-defaults-mode-node": "^4.1.1",
58
- "@smithy/util-endpoints": "^3.1.1",
56
+ "@smithy/util-defaults-mode-browser": "^4.1.2",
57
+ "@smithy/util-defaults-mode-node": "^4.1.2",
58
+ "@smithy/util-endpoints": "^3.1.2",
59
59
  "@smithy/util-middleware": "^4.1.1",
60
- "@smithy/util-retry": "^4.1.1",
60
+ "@smithy/util-retry": "^4.1.2",
61
61
  "@smithy/util-utf8": "^4.1.0",
62
62
  "@types/uuid": "^9.0.1",
63
63
  "tslib": "^2.6.2",