@aws-sdk/client-cloudwatch-logs 3.940.0 → 3.943.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 (61) hide show
  1. package/README.md +40 -0
  2. package/dist-cjs/index.js +328 -71
  3. package/dist-es/CloudWatchLogs.js +10 -0
  4. package/dist-es/commands/AssociateSourceToS3TableIntegrationCommand.js +16 -0
  5. package/dist-es/commands/DisassociateSourceFromS3TableIntegrationCommand.js +16 -0
  6. package/dist-es/commands/GetLogFieldsCommand.js +16 -0
  7. package/dist-es/commands/ListAggregateLogGroupSummariesCommand.js +16 -0
  8. package/dist-es/commands/ListSourcesForS3TableIntegrationCommand.js +16 -0
  9. package/dist-es/commands/index.js +5 -0
  10. package/dist-es/models/enums.js +14 -0
  11. package/dist-es/models/errors.js +32 -32
  12. package/dist-es/pagination/ListSourcesForS3TableIntegrationPaginator.js +4 -0
  13. package/dist-es/pagination/index.js +1 -0
  14. package/dist-es/schemas/schemas_0.js +207 -39
  15. package/dist-types/CloudWatchLogs.d.ts +35 -0
  16. package/dist-types/CloudWatchLogsClient.d.ts +7 -2
  17. package/dist-types/commands/AssociateSourceToS3TableIntegrationCommand.d.ts +97 -0
  18. package/dist-types/commands/CreateScheduledQueryCommand.d.ts +4 -2
  19. package/dist-types/commands/DeleteAccountPolicyCommand.d.ts +8 -3
  20. package/dist-types/commands/DeleteIndexPolicyCommand.d.ts +8 -3
  21. package/dist-types/commands/DeleteScheduledQueryCommand.d.ts +4 -2
  22. package/dist-types/commands/DescribeFieldIndexesCommand.d.ts +1 -0
  23. package/dist-types/commands/DescribeLogGroupsCommand.d.ts +3 -2
  24. package/dist-types/commands/DescribeQueriesCommand.d.ts +4 -0
  25. package/dist-types/commands/DisassociateSourceFromS3TableIntegrationCommand.d.ts +92 -0
  26. package/dist-types/commands/GetLogFieldsCommand.d.ts +107 -0
  27. package/dist-types/commands/GetLogGroupFieldsCommand.d.ts +2 -0
  28. package/dist-types/commands/GetQueryResultsCommand.d.ts +3 -0
  29. package/dist-types/commands/GetScheduledQueryCommand.d.ts +4 -2
  30. package/dist-types/commands/GetScheduledQueryHistoryCommand.d.ts +4 -2
  31. package/dist-types/commands/ListAggregateLogGroupSummariesCommand.d.ts +118 -0
  32. package/dist-types/commands/ListLogGroupsCommand.d.ts +14 -2
  33. package/dist-types/commands/ListScheduledQueriesCommand.d.ts +4 -2
  34. package/dist-types/commands/ListSourcesForS3TableIntegrationCommand.d.ts +106 -0
  35. package/dist-types/commands/PutAccountPolicyCommand.d.ts +19 -6
  36. package/dist-types/commands/PutIndexPolicyCommand.d.ts +12 -4
  37. package/dist-types/commands/StartQueryCommand.d.ts +9 -3
  38. package/dist-types/commands/StopQueryCommand.d.ts +4 -0
  39. package/dist-types/commands/UpdateScheduledQueryCommand.d.ts +4 -2
  40. package/dist-types/commands/index.d.ts +5 -0
  41. package/dist-types/models/enums.d.ts +38 -0
  42. package/dist-types/models/errors.d.ts +34 -32
  43. package/dist-types/models/models_0.d.ts +479 -102
  44. package/dist-types/pagination/ListSourcesForS3TableIntegrationPaginator.d.ts +7 -0
  45. package/dist-types/pagination/index.d.ts +1 -0
  46. package/dist-types/schemas/schemas_0.d.ts +28 -0
  47. package/dist-types/ts3.4/CloudWatchLogs.d.ts +97 -0
  48. package/dist-types/ts3.4/CloudWatchLogsClient.d.ts +30 -0
  49. package/dist-types/ts3.4/commands/AssociateSourceToS3TableIntegrationCommand.d.ts +51 -0
  50. package/dist-types/ts3.4/commands/DisassociateSourceFromS3TableIntegrationCommand.d.ts +51 -0
  51. package/dist-types/ts3.4/commands/GetLogFieldsCommand.d.ts +47 -0
  52. package/dist-types/ts3.4/commands/ListAggregateLogGroupSummariesCommand.d.ts +51 -0
  53. package/dist-types/ts3.4/commands/ListSourcesForS3TableIntegrationCommand.d.ts +51 -0
  54. package/dist-types/ts3.4/commands/index.d.ts +5 -0
  55. package/dist-types/ts3.4/models/enums.d.ts +19 -0
  56. package/dist-types/ts3.4/models/errors.d.ts +21 -21
  57. package/dist-types/ts3.4/models/models_0.d.ts +81 -0
  58. package/dist-types/ts3.4/pagination/ListSourcesForS3TableIntegrationPaginator.d.ts +11 -0
  59. package/dist-types/ts3.4/pagination/index.d.ts +1 -0
  60. package/dist-types/ts3.4/schemas/schemas_0.d.ts +28 -0
  61. package/package.json +5 -5
@@ -1,4 +1,4 @@
1
- import { ActionStatus, AnomalyDetectorStatus, DataProtectionStatus, DeliveryDestinationType, Distribution, EntityRejectionErrorType, EvaluationFrequency, EventSource, ExecutionStatus, ExportTaskStatusCode, FlattenedElement, IndexSource, InheritedProperty, IntegrationStatus, IntegrationType, LogGroupClass, OCSFVersion, OpenSearchResourceStatusType, OrderBy, OutputFormat, PolicyScope, PolicyType, QueryLanguage, QueryStatus, ScheduledQueryDestinationType, ScheduledQueryState, Scope, StandardUnit, State, SuppressionState, SuppressionType, SuppressionUnit, Type } from "./enums";
1
+ import { ActionStatus, AnomalyDetectorStatus, DataProtectionStatus, DeliveryDestinationType, Distribution, EntityRejectionErrorType, EvaluationFrequency, EventSource, ExecutionStatus, ExportTaskStatusCode, FlattenedElement, IndexSource, IndexType, InheritedProperty, IntegrationStatus, IntegrationType, ListAggregateLogGroupSummariesGroupBy, LogGroupClass, OCSFVersion, OpenSearchResourceStatusType, OrderBy, OutputFormat, PolicyScope, PolicyType, QueryLanguage, QueryStatus, S3TableIntegrationSourceStatus, ScheduledQueryDestinationType, ScheduledQueryState, Scope, StandardUnit, State, SuppressionState, SuppressionType, SuppressionUnit, Type } from "./enums";
2
2
  import { InternalStreamingException, SessionStreamingException, SessionTimeoutException } from "./errors";
3
3
  /**
4
4
  * <p>A structure that contains information about one CloudWatch Logs account policy.</p>
@@ -77,6 +77,45 @@ export interface AddKeys {
77
77
  */
78
78
  entries: AddKeyEntry[] | undefined;
79
79
  }
80
+ /**
81
+ * <p>A key-value pair that identifies how log groups are grouped in aggregate summaries.</p>
82
+ * @public
83
+ */
84
+ export interface GroupingIdentifier {
85
+ /**
86
+ * <p>The key that identifies the grouping characteristic. The format of the key uses dot
87
+ * notation. Examples are, <code>dataSource.Name</code>, <code>dataSource.Type</code>, and
88
+ * <code>dataSource.Format</code>.</p>
89
+ * @public
90
+ */
91
+ key?: string | undefined;
92
+ /**
93
+ * <p>The value associated with the grouping characteristic. Examples are
94
+ * <code>amazon_vpc</code>, <code>flow</code>, and <code>OCSF</code>.</p>
95
+ * @public
96
+ */
97
+ value?: string | undefined;
98
+ }
99
+ /**
100
+ * <p>Contains an aggregate summary of log groups grouped by data source characteristics,
101
+ * including the count of log groups and their grouping identifiers.</p>
102
+ * @public
103
+ */
104
+ export interface AggregateLogGroupSummary {
105
+ /**
106
+ * <p>The number of log groups in this aggregate summary group.</p>
107
+ * @public
108
+ */
109
+ logGroupCount?: number | undefined;
110
+ /**
111
+ * <p>An array of key-value pairs that identify the data source characteristics used to group
112
+ * the log groups.</p>
113
+ * <p>The size and content of this array depends on the <code>groupBy</code> parameter specified
114
+ * in the request.</p>
115
+ * @public
116
+ */
117
+ groupingIdentifiers?: GroupingIdentifier[] | undefined;
118
+ }
80
119
  /**
81
120
  * <p>A structure that represents a valid record field header and whether it is
82
121
  * mandatory.</p>
@@ -387,6 +426,51 @@ export interface AssociateKmsKeyRequest {
387
426
  */
388
427
  resourceIdentifier?: string | undefined;
389
428
  }
429
+ /**
430
+ * <p>Represents a data source that categorizes logs by originating service and log type,
431
+ * providing service-based organization complementing traditional log groups.</p>
432
+ * @public
433
+ */
434
+ export interface DataSource {
435
+ /**
436
+ * <p>The name of the data source.</p>
437
+ * @public
438
+ */
439
+ name: string | undefined;
440
+ /**
441
+ * <p>The type of the data source.</p>
442
+ * @public
443
+ */
444
+ type?: string | undefined;
445
+ }
446
+ /**
447
+ * @public
448
+ */
449
+ export interface AssociateSourceToS3TableIntegrationRequest {
450
+ /**
451
+ * <p>The Amazon Resource Name (ARN) of the S3 Table Integration to associate the data source
452
+ * with.</p>
453
+ * @public
454
+ */
455
+ integrationArn: string | undefined;
456
+ /**
457
+ * <p>The data source to associate with the S3 Table Integration. Contains the name and type of
458
+ * the data source.</p>
459
+ * @public
460
+ */
461
+ dataSource: DataSource | undefined;
462
+ }
463
+ /**
464
+ * @public
465
+ */
466
+ export interface AssociateSourceToS3TableIntegrationResponse {
467
+ /**
468
+ * <p>The unique identifier for the association between the data source and S3 Table
469
+ * Integration.</p>
470
+ * @public
471
+ */
472
+ identifier?: string | undefined;
473
+ }
390
474
  /**
391
475
  * @public
392
476
  */
@@ -867,28 +951,28 @@ export interface CreateLogStreamRequest {
867
951
  logStreamName: string | undefined;
868
952
  }
869
953
  /**
870
- * <p>Configuration details for delivering scheduled query results to an Amazon S3 bucket.</p>
954
+ * <p>Configuration for Amazon S3 destination where scheduled query results are delivered.</p>
871
955
  * @public
872
956
  */
873
957
  export interface S3Configuration {
874
958
  /**
875
- * <p>The S3 URI where query results will be stored (e.g., s3://bucket-name/prefix/).</p>
959
+ * <p>The Amazon S3 URI where query results are delivered. Must be a valid S3 URI format.</p>
876
960
  * @public
877
961
  */
878
962
  destinationIdentifier: string | undefined;
879
963
  /**
880
- * <p>The ARN of the IAM role that CloudWatch Logs will assume to write results to the S3 bucket.</p>
964
+ * <p>The ARN of the IAM role that grants permissions to write query results to the specified Amazon S3 destination.</p>
881
965
  * @public
882
966
  */
883
967
  roleArn: string | undefined;
884
968
  }
885
969
  /**
886
- * <p>Configuration for destinations where scheduled query results are delivered, such as S3 buckets or EventBridge event buses.</p>
970
+ * <p>Configuration for where to deliver scheduled query results. Specifies the destination type and associated settings for result delivery.</p>
887
971
  * @public
888
972
  */
889
973
  export interface DestinationConfiguration {
890
974
  /**
891
- * <p>Configuration for delivering query results to an Amazon S3 bucket.</p>
975
+ * <p>Configuration for delivering query results to Amazon S3.</p>
892
976
  * @public
893
977
  */
894
978
  s3Configuration: S3Configuration | undefined;
@@ -898,74 +982,72 @@ export interface DestinationConfiguration {
898
982
  */
899
983
  export interface CreateScheduledQueryRequest {
900
984
  /**
901
- * <p>A unique name for the scheduled query within the region for an AWS account. The name can contain letters, numbers, underscores, hyphens, forward slashes, periods, and hash symbols.</p>
985
+ * <p>The name of the scheduled query. The name must be unique within your account and region. Valid characters are alphanumeric characters, hyphens, underscores, and periods. Length must be between 1 and 255 characters.</p>
902
986
  * @public
903
987
  */
904
988
  name: string | undefined;
905
989
  /**
906
- * <p>An optional description for the scheduled query to help identify its purpose.</p>
990
+ * <p>An optional description for the scheduled query to help identify its purpose and functionality.</p>
907
991
  * @public
908
992
  */
909
993
  description?: string | undefined;
910
994
  /**
911
- * <p>The query language to use for the scheduled query. Valid values are LogsQL (CloudWatch Logs Insights query language), PPL (OpenSearch Service Piped Processing Language), and SQL (OpenSearch Service Structured Query Language).</p>
995
+ * <p>The query language to use for the scheduled query. Valid values are <code>LogsQL</code>, <code>PPL</code>, and <code>SQL</code>.</p>
912
996
  * @public
913
997
  */
914
998
  queryLanguage: QueryLanguage | undefined;
915
999
  /**
916
- * <p>The CloudWatch Logs Insights query string to execute. This is the actual query that will be run against your log data on the specified schedule.</p>
1000
+ * <p>The query string to execute. This is the same query syntax used in CloudWatch Logs Insights. Maximum length is 10,000 characters.</p>
917
1001
  * @public
918
1002
  */
919
1003
  queryString: string | undefined;
920
1004
  /**
921
- * <p>The log group identifiers to query. You can specify log group names or log group ARNs. If querying log groups in a source account from a monitoring account, you must specify the ARN of the log group.</p>
1005
+ * <p>An array of log group names or ARNs to query. You can specify between 1 and 50 log groups. Log groups can be identified by name or full ARN.</p>
922
1006
  * @public
923
1007
  */
924
1008
  logGroupIdentifiers?: string[] | undefined;
925
1009
  /**
926
- * <p>A cron expression that defines when the scheduled query runs. The format is cron(fields) where fields consist of six space-separated values: minutes, hours, day_of_month, month, day_of_week, year.</p>
1010
+ * <p>A cron expression that defines when the scheduled query runs. The expression uses standard cron syntax and supports minute-level precision. Maximum length is 256 characters.</p>
927
1011
  * @public
928
1012
  */
929
1013
  scheduleExpression: string | undefined;
930
1014
  /**
931
- * <p>The timezone in which the schedule expression is evaluated. If not provided, defaults to UTC.</p>
1015
+ * <p>The timezone for evaluating the schedule expression. This determines when the scheduled query executes relative to the specified timezone.</p>
932
1016
  * @public
933
1017
  */
934
1018
  timezone?: string | undefined;
935
1019
  /**
936
- * <p>Time offset in seconds from the execution time for the start of the query time range. This defines the lookback period for the query (for example, 3600 for the last hour).</p>
1020
+ * <p>The time offset in seconds that defines the lookback period for the query. This determines how far back in time the query searches from the execution time.</p>
937
1021
  * @public
938
1022
  */
939
1023
  startTimeOffset?: number | undefined;
940
1024
  /**
941
- * <p>Configuration for destinations where the query results will be delivered after successful execution. You can configure delivery to S3 buckets or EventBridge event buses.</p>
1025
+ * <p>Configuration for where to deliver query results. Currently supports Amazon S3 destinations for storing query output.</p>
942
1026
  * @public
943
1027
  */
944
1028
  destinationConfiguration?: DestinationConfiguration | undefined;
945
1029
  /**
946
- * <p>The start time for the query schedule in Unix epoch time (seconds since January 1, 1970, 00:00:00 UTC). If not specified, the schedule starts immediately.</p>
1030
+ * <p>The start time for the scheduled query in Unix epoch format. The query will not execute before this time.</p>
947
1031
  * @public
948
1032
  */
949
1033
  scheduleStartTime?: number | undefined;
950
1034
  /**
951
- * <p>The end time for the query schedule in Unix epoch time (seconds since January 1, 1970, 00:00:00 UTC). If not specified, the schedule runs indefinitely.</p>
1035
+ * <p>The end time for the scheduled query in Unix epoch format. The query will stop executing after this time.</p>
952
1036
  * @public
953
1037
  */
954
1038
  scheduleEndTime?: number | undefined;
955
1039
  /**
956
- * <p>The Amazon Resource Name (ARN) of the IAM role that CloudWatch Logs will assume to execute the scheduled query and deliver results to the specified destinations.</p>
1040
+ * <p>The ARN of the IAM role that grants permissions to execute the query and deliver results to the specified destination. The role must have permissions to read from the specified log groups and write to the destination.</p>
957
1041
  * @public
958
1042
  */
959
1043
  executionRoleArn: string | undefined;
960
1044
  /**
961
- * <p>The initial state of the scheduled query. Valid values are ENABLED (the query will run according to its schedule) and DISABLED (the query is paused and will not run). If not provided, defaults to ENABLED.</p>
1045
+ * <p>The initial state of the scheduled query. Valid values are <code>ENABLED</code> and <code>DISABLED</code>. Default is <code>ENABLED</code>.</p>
962
1046
  * @public
963
1047
  */
964
1048
  state?: ScheduledQueryState | undefined;
965
1049
  /**
966
- * <p>An optional list of key-value pairs to associate with the resource.</p>
967
- * <p>For more information about tagging, see <a href="https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html">Tagging Amazon Web Services resources</a>
968
- * </p>
1050
+ * <p>Key-value pairs to associate with the scheduled query for resource management and cost allocation.</p>
969
1051
  * @public
970
1052
  */
971
1053
  tags?: Record<string, string> | undefined;
@@ -975,12 +1057,12 @@ export interface CreateScheduledQueryRequest {
975
1057
  */
976
1058
  export interface CreateScheduledQueryResponse {
977
1059
  /**
978
- * <p>The Amazon Resource Name (ARN) of the created scheduled query.</p>
1060
+ * <p>The ARN of the created scheduled query.</p>
979
1061
  * @public
980
1062
  */
981
1063
  scheduledQueryArn?: string | undefined;
982
1064
  /**
983
- * <p>The current state of the scheduled query (ENABLED or DISABLED).</p>
1065
+ * <p>The current state of the scheduled query.</p>
984
1066
  * @public
985
1067
  */
986
1068
  state?: ScheduledQueryState | undefined;
@@ -1019,6 +1101,23 @@ export interface CSV {
1019
1101
  */
1020
1102
  source?: string | undefined;
1021
1103
  }
1104
+ /**
1105
+ * <p>Filter criteria for data sources, used to specify which data sources to include in
1106
+ * operations based on name and type.</p>
1107
+ * @public
1108
+ */
1109
+ export interface DataSourceFilter {
1110
+ /**
1111
+ * <p>The name pattern to filter data sources by.</p>
1112
+ * @public
1113
+ */
1114
+ name: string | undefined;
1115
+ /**
1116
+ * <p>The type pattern to filter data sources by.</p>
1117
+ * @public
1118
+ */
1119
+ type?: string | undefined;
1120
+ }
1022
1121
  /**
1023
1122
  * <p>This processor converts a datetime string into a format that you specify. </p>
1024
1123
  * <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-datetimeConverter"> datetimeConverter</a> in the <i>CloudWatch Logs User
@@ -1303,7 +1402,7 @@ export interface DeleteRetentionPolicyRequest {
1303
1402
  */
1304
1403
  export interface DeleteScheduledQueryRequest {
1305
1404
  /**
1306
- * <p>The name or ARN of the scheduled query to delete.</p>
1405
+ * <p>The ARN or name of the scheduled query to delete.</p>
1307
1406
  * @public
1308
1407
  */
1309
1408
  identifier: string | undefined;
@@ -1955,6 +2054,13 @@ export interface FieldIndex {
1955
2054
  * @public
1956
2055
  */
1957
2056
  lastEventTime?: number | undefined;
2057
+ /**
2058
+ * <p>The type of index. Specify <code>FACET</code> for facet-based indexing or
2059
+ * <code>FIELD_INDEX</code> for field-based indexing. This determines how the field is indexed
2060
+ * and can be queried.</p>
2061
+ * @public
2062
+ */
2063
+ type?: IndexType | undefined;
1958
2064
  }
1959
2065
  /**
1960
2066
  * @public
@@ -2998,6 +3104,27 @@ export interface DisassociateKmsKeyRequest {
2998
3104
  */
2999
3105
  resourceIdentifier?: string | undefined;
3000
3106
  }
3107
+ /**
3108
+ * @public
3109
+ */
3110
+ export interface DisassociateSourceFromS3TableIntegrationRequest {
3111
+ /**
3112
+ * <p>The unique identifier of the association to remove between the data source and S3 Table
3113
+ * Integration.</p>
3114
+ * @public
3115
+ */
3116
+ identifier: string | undefined;
3117
+ }
3118
+ /**
3119
+ * @public
3120
+ */
3121
+ export interface DisassociateSourceFromS3TableIntegrationResponse {
3122
+ /**
3123
+ * <p>The unique identifier of the association that was removed.</p>
3124
+ * @public
3125
+ */
3126
+ identifier?: string | undefined;
3127
+ }
3001
3128
  /**
3002
3129
  * <p>The entity associated with the log events in a <code>PutLogEvents</code> call.</p>
3003
3130
  * @public
@@ -3871,6 +3998,21 @@ export interface GetLogEventsResponse {
3871
3998
  */
3872
3999
  nextBackwardToken?: string | undefined;
3873
4000
  }
4001
+ /**
4002
+ * @public
4003
+ */
4004
+ export interface GetLogFieldsRequest {
4005
+ /**
4006
+ * <p>The name of the data source to retrieve log fields for.</p>
4007
+ * @public
4008
+ */
4009
+ dataSourceName: string | undefined;
4010
+ /**
4011
+ * <p>The type of the data source to retrieve log fields for.</p>
4012
+ * @public
4013
+ */
4014
+ dataSourceType: string | undefined;
4015
+ }
3874
4016
  /**
3875
4017
  * @public
3876
4018
  */
@@ -4171,7 +4313,7 @@ export interface GetQueryResultsResponse {
4171
4313
  */
4172
4314
  export interface GetScheduledQueryRequest {
4173
4315
  /**
4174
- * <p>The name or ARN of the scheduled query to retrieve.</p>
4316
+ * <p>The ARN or name of the scheduled query to retrieve.</p>
4175
4317
  * @public
4176
4318
  */
4177
4319
  identifier: string | undefined;
@@ -4181,7 +4323,7 @@ export interface GetScheduledQueryRequest {
4181
4323
  */
4182
4324
  export interface GetScheduledQueryResponse {
4183
4325
  /**
4184
- * <p>The Amazon Resource Name (ARN) of the scheduled query.</p>
4326
+ * <p>The ARN of the scheduled query.</p>
4185
4327
  * @public
4186
4328
  */
4187
4329
  scheduledQueryArn?: string | undefined;
@@ -4196,17 +4338,17 @@ export interface GetScheduledQueryResponse {
4196
4338
  */
4197
4339
  description?: string | undefined;
4198
4340
  /**
4199
- * <p>The query language used by the scheduled query (LogsQL, PPL, or SQL).</p>
4341
+ * <p>The query language used by the scheduled query.</p>
4200
4342
  * @public
4201
4343
  */
4202
4344
  queryLanguage?: QueryLanguage | undefined;
4203
4345
  /**
4204
- * <p>The CloudWatch Logs Insights query string being executed.</p>
4346
+ * <p>The query string executed by the scheduled query.</p>
4205
4347
  * @public
4206
4348
  */
4207
4349
  queryString?: string | undefined;
4208
4350
  /**
4209
- * <p>The log group identifiers being queried by the scheduled query.</p>
4351
+ * <p>The log groups queried by the scheduled query.</p>
4210
4352
  * @public
4211
4353
  */
4212
4354
  logGroupIdentifiers?: string[] | undefined;
@@ -4216,57 +4358,57 @@ export interface GetScheduledQueryResponse {
4216
4358
  */
4217
4359
  scheduleExpression?: string | undefined;
4218
4360
  /**
4219
- * <p>The timezone in which the schedule expression is evaluated.</p>
4361
+ * <p>The timezone used for evaluating the schedule expression.</p>
4220
4362
  * @public
4221
4363
  */
4222
4364
  timezone?: string | undefined;
4223
4365
  /**
4224
- * <p>Time offset in seconds from the execution time for the start of the query time range.</p>
4366
+ * <p>The time offset in seconds that defines the lookback period for the query.</p>
4225
4367
  * @public
4226
4368
  */
4227
4369
  startTimeOffset?: number | undefined;
4228
4370
  /**
4229
- * <p>Configuration for destinations where the query results are delivered.</p>
4371
+ * <p>Configuration for where query results are delivered.</p>
4230
4372
  * @public
4231
4373
  */
4232
4374
  destinationConfiguration?: DestinationConfiguration | undefined;
4233
4375
  /**
4234
- * <p>The current state of the scheduled query (ENABLED or DISABLED).</p>
4376
+ * <p>The current state of the scheduled query.</p>
4235
4377
  * @public
4236
4378
  */
4237
4379
  state?: ScheduledQueryState | undefined;
4238
4380
  /**
4239
- * <p>The time when the scheduled query was last executed, in Unix epoch time.</p>
4381
+ * <p>The timestamp when the scheduled query was last executed.</p>
4240
4382
  * @public
4241
4383
  */
4242
4384
  lastTriggeredTime?: number | undefined;
4243
4385
  /**
4244
- * <p>The status of the last executed query (Running, Complete, Failed, Timeout, or InvalidQuery).</p>
4386
+ * <p>The status of the most recent execution of the scheduled query.</p>
4245
4387
  * @public
4246
4388
  */
4247
4389
  lastExecutionStatus?: ExecutionStatus | undefined;
4248
4390
  /**
4249
- * <p>The start time for the query schedule in Unix epoch time.</p>
4391
+ * <p>The start time for the scheduled query in Unix epoch format.</p>
4250
4392
  * @public
4251
4393
  */
4252
4394
  scheduleStartTime?: number | undefined;
4253
4395
  /**
4254
- * <p>The end time for the query schedule in Unix epoch time.</p>
4396
+ * <p>The end time for the scheduled query in Unix epoch format.</p>
4255
4397
  * @public
4256
4398
  */
4257
4399
  scheduleEndTime?: number | undefined;
4258
4400
  /**
4259
- * <p>The ARN of the IAM role used to execute the scheduled query.</p>
4401
+ * <p>The ARN of the IAM role used to execute the query and deliver results.</p>
4260
4402
  * @public
4261
4403
  */
4262
4404
  executionRoleArn?: string | undefined;
4263
4405
  /**
4264
- * <p>The time when the scheduled query was created, in Unix epoch time.</p>
4406
+ * <p>The timestamp when the scheduled query was created.</p>
4265
4407
  * @public
4266
4408
  */
4267
4409
  creationTime?: number | undefined;
4268
4410
  /**
4269
- * <p>The time when the scheduled query was last updated, in Unix epoch time.</p>
4411
+ * <p>The timestamp when the scheduled query was last updated.</p>
4270
4412
  * @public
4271
4413
  */
4272
4414
  lastUpdatedTime?: number | undefined;
@@ -4276,27 +4418,27 @@ export interface GetScheduledQueryResponse {
4276
4418
  */
4277
4419
  export interface GetScheduledQueryHistoryRequest {
4278
4420
  /**
4279
- * <p>The name or ARN of the scheduled query to retrieve history for.</p>
4421
+ * <p>The ARN or name of the scheduled query to retrieve history for.</p>
4280
4422
  * @public
4281
4423
  */
4282
4424
  identifier: string | undefined;
4283
4425
  /**
4284
- * <p>The start time for the history retrieval window in Unix epoch time.</p>
4426
+ * <p>The start time for the history query in Unix epoch format.</p>
4285
4427
  * @public
4286
4428
  */
4287
4429
  startTime: number | undefined;
4288
4430
  /**
4289
- * <p>The end time for the history retrieval window in Unix epoch time.</p>
4431
+ * <p>The end time for the history query in Unix epoch format.</p>
4290
4432
  * @public
4291
4433
  */
4292
4434
  endTime: number | undefined;
4293
4435
  /**
4294
- * <p>Filter results by execution status (Running, Complete, Failed, Timeout, or InvalidQuery).</p>
4436
+ * <p>An array of execution statuses to filter the history results. Only executions with the specified statuses are returned.</p>
4295
4437
  * @public
4296
4438
  */
4297
4439
  executionStatuses?: ExecutionStatus[] | undefined;
4298
4440
  /**
4299
- * <p>The maximum number of history records to return in a single call.</p>
4441
+ * <p>The maximum number of history records to return. Valid range is 1 to 1000.</p>
4300
4442
  * @public
4301
4443
  */
4302
4444
  maxResults?: number | undefined;
@@ -4308,63 +4450,63 @@ export interface GetScheduledQueryHistoryRequest {
4308
4450
  nextToken?: string | undefined;
4309
4451
  }
4310
4452
  /**
4311
- * <p>Information about a destination where scheduled query results are processed and delivered.</p>
4453
+ * <p>Information about a destination where scheduled query results are processed, including processing status and any error messages.</p>
4312
4454
  * @public
4313
4455
  */
4314
4456
  export interface ScheduledQueryDestination {
4315
4457
  /**
4316
- * <p>The type of destination (S3).</p>
4458
+ * <p>The type of destination for query results.</p>
4317
4459
  * @public
4318
4460
  */
4319
4461
  destinationType?: ScheduledQueryDestinationType | undefined;
4320
4462
  /**
4321
- * <p>The destination identifier (S3 URI).</p>
4463
+ * <p>The identifier for the destination where results are delivered.</p>
4322
4464
  * @public
4323
4465
  */
4324
4466
  destinationIdentifier?: string | undefined;
4325
4467
  /**
4326
- * <p>The processing status for this destination (IN_PROGRESS, ERROR, FAILED, or COMPLETE).</p>
4468
+ * <p>The processing status of the destination delivery.</p>
4327
4469
  * @public
4328
4470
  */
4329
4471
  status?: ActionStatus | undefined;
4330
4472
  /**
4331
- * <p>The processed identifier returned for the destination (S3 key).</p>
4473
+ * <p>The identifier of the processed result at the destination.</p>
4332
4474
  * @public
4333
4475
  */
4334
4476
  processedIdentifier?: string | undefined;
4335
4477
  /**
4336
- * <p>Error message if the destination processing failed.</p>
4478
+ * <p>Error message if destination processing failed.</p>
4337
4479
  * @public
4338
4480
  */
4339
4481
  errorMessage?: string | undefined;
4340
4482
  }
4341
4483
  /**
4342
- * <p>A record of a scheduled query execution, including its status and destination processing information.</p>
4484
+ * <p>A record of a scheduled query execution, including execution status, timestamp, and destination processing results.</p>
4343
4485
  * @public
4344
4486
  */
4345
4487
  export interface TriggerHistoryRecord {
4346
4488
  /**
4347
- * <p>The unique identifier for the query execution.</p>
4489
+ * <p>The unique identifier for this query execution.</p>
4348
4490
  * @public
4349
4491
  */
4350
4492
  queryId?: string | undefined;
4351
4493
  /**
4352
- * <p>The status of the query execution (Running, Complete, Failed, Timeout, or InvalidQuery).</p>
4494
+ * <p>The execution status of the scheduled query run.</p>
4353
4495
  * @public
4354
4496
  */
4355
4497
  executionStatus?: ExecutionStatus | undefined;
4356
4498
  /**
4357
- * <p>The time when the scheduled query was triggered, in Unix epoch time.</p>
4499
+ * <p>The timestamp when the scheduled query execution was triggered.</p>
4358
4500
  * @public
4359
4501
  */
4360
4502
  triggeredTimestamp?: number | undefined;
4361
4503
  /**
4362
- * <p>The error message if the scheduled query execution failed. This field is only populated when the execution status indicates a failure.</p>
4504
+ * <p>Error message if the query execution failed.</p>
4363
4505
  * @public
4364
4506
  */
4365
4507
  errorMessage?: string | undefined;
4366
4508
  /**
4367
- * <p>The list of destinations where the scheduled query results were delivered for this execution. This includes S3 buckets configured for the scheduled query.</p>
4509
+ * <p>Information about destination processing for this query execution.</p>
4368
4510
  * @public
4369
4511
  */
4370
4512
  destinations?: ScheduledQueryDestination[] | undefined;
@@ -4384,7 +4526,7 @@ export interface GetScheduledQueryHistoryResponse {
4384
4526
  */
4385
4527
  scheduledQueryArn?: string | undefined;
4386
4528
  /**
4387
- * <p>The list of execution history records for the scheduled query.</p>
4529
+ * <p>An array of execution history records for the scheduled query.</p>
4388
4530
  * @public
4389
4531
  */
4390
4532
  triggerHistory?: TriggerHistoryRecord[] | undefined;
@@ -4672,8 +4814,7 @@ export interface ParseToOCSF {
4672
4814
  */
4673
4815
  ocsfVersion: OCSFVersion | undefined;
4674
4816
  /**
4675
- * <p>Identifies the specific release of the Open Cybersecurity Schema Framework (OCSF)
4676
- * transformer being used to parse OCSF data. Defaults to the latest version if not specified. Does not automatically update.</p>
4817
+ * <p>The version of the OCSF mapping to use for parsing log data.</p>
4677
4818
  * @public
4678
4819
  */
4679
4820
  mappingVersion?: string | undefined;
@@ -5072,6 +5213,99 @@ export interface IntegrationSummary {
5072
5213
  */
5073
5214
  integrationStatus?: IntegrationStatus | undefined;
5074
5215
  }
5216
+ /**
5217
+ * @public
5218
+ */
5219
+ export interface ListAggregateLogGroupSummariesRequest {
5220
+ /**
5221
+ * <p>When <code>includeLinkedAccounts</code> is set to <code>true</code>, use this parameter to
5222
+ * specify the list of accounts to search. You can specify as many as 20 account IDs in the
5223
+ * array.</p>
5224
+ * @public
5225
+ */
5226
+ accountIdentifiers?: string[] | undefined;
5227
+ /**
5228
+ * <p>If you are using a monitoring account, set this to <code>true</code> to have the operation
5229
+ * return log groups in the accounts listed in <code>accountIdentifiers</code>.</p>
5230
+ * <p>If this parameter is set to <code>true</code> and <code>accountIdentifiers</code> contains
5231
+ * a null value, the operation returns all log groups in the monitoring account and all log
5232
+ * groups in all source accounts that are linked to the monitoring account. </p>
5233
+ * <p>The default for this parameter is <code>false</code>.</p>
5234
+ * @public
5235
+ */
5236
+ includeLinkedAccounts?: boolean | undefined;
5237
+ /**
5238
+ * <p>Filters the results by log group class to include only log groups of the specified
5239
+ * class.</p>
5240
+ * @public
5241
+ */
5242
+ logGroupClass?: LogGroupClass | undefined;
5243
+ /**
5244
+ * <p>Use this parameter to limit the returned log groups to only those with names that match
5245
+ * the pattern that you specify. This parameter is a regular expression that can match prefixes
5246
+ * and substrings, and supports wildcard matching and matching multiple patterns, as in the
5247
+ * following examples. </p>
5248
+ * <ul>
5249
+ * <li>
5250
+ * <p>Use <code>^</code> to match log group names by prefix.</p>
5251
+ * </li>
5252
+ * <li>
5253
+ * <p>For a substring match, specify the string to match. All matches are case
5254
+ * sensitive</p>
5255
+ * </li>
5256
+ * <li>
5257
+ * <p>To match multiple patterns, separate them with a <code>|</code> as in the example
5258
+ * <code>^/aws/lambda|discovery</code>
5259
+ * </p>
5260
+ * </li>
5261
+ * </ul>
5262
+ * <p>You can specify as many as five different regular expression patterns in this field, each
5263
+ * of which must be between 3 and 24 characters. You can include the <code>^</code> symbol as
5264
+ * many as five times, and include the <code>|</code> symbol as many as four times.</p>
5265
+ * @public
5266
+ */
5267
+ logGroupNamePattern?: string | undefined;
5268
+ /**
5269
+ * <p>Filters the results by data source characteristics to include only log groups associated
5270
+ * with the specified data sources.</p>
5271
+ * @public
5272
+ */
5273
+ dataSources?: DataSourceFilter[] | undefined;
5274
+ /**
5275
+ * <p>Specifies how to group the log groups in the summary.</p>
5276
+ * @public
5277
+ */
5278
+ groupBy: ListAggregateLogGroupSummariesGroupBy | undefined;
5279
+ /**
5280
+ * <p>The token for the next set of items to return. The token expires after 24
5281
+ * hours.</p>
5282
+ * @public
5283
+ */
5284
+ nextToken?: string | undefined;
5285
+ /**
5286
+ * <p>The maximum number of aggregated summaries to return. If you omit this parameter, the
5287
+ * default is up to 50 aggregated summaries.</p>
5288
+ * @public
5289
+ */
5290
+ limit?: number | undefined;
5291
+ }
5292
+ /**
5293
+ * @public
5294
+ */
5295
+ export interface ListAggregateLogGroupSummariesResponse {
5296
+ /**
5297
+ * <p>The list of aggregate log group summaries grouped by the specified data source
5298
+ * characteristics.</p>
5299
+ * @public
5300
+ */
5301
+ aggregateLogGroupSummaries?: AggregateLogGroupSummary[] | undefined;
5302
+ /**
5303
+ * <p>The token for the next set of items to return. The token expires after 24
5304
+ * hours.</p>
5305
+ * @public
5306
+ */
5307
+ nextToken?: string | undefined;
5308
+ }
5075
5309
  /**
5076
5310
  * @public
5077
5311
  */
@@ -5255,6 +5489,21 @@ export interface ListLogGroupsRequest {
5255
5489
  * @public
5256
5490
  */
5257
5491
  limit?: number | undefined;
5492
+ /**
5493
+ * <p>An array of data source filters to filter log groups by their associated data sources. You
5494
+ * can filter by data source name, type, or both. Multiple filters within the same dimension are
5495
+ * combined with OR logic, while filters across different dimensions are combined with AND
5496
+ * logic.</p>
5497
+ * @public
5498
+ */
5499
+ dataSources?: DataSourceFilter[] | undefined;
5500
+ /**
5501
+ * <p>An array of field index names to filter log groups that have specific field indexes. Only
5502
+ * log groups containing all specified field indexes are returned. You can specify 1 to 20 field
5503
+ * index names, each with 1 to 512 characters.</p>
5504
+ * @public
5505
+ */
5506
+ fieldIndexNames?: string[] | undefined;
5258
5507
  }
5259
5508
  /**
5260
5509
  * <p>This structure contains information about one log group in your account.</p>
@@ -5338,7 +5587,7 @@ export interface ListLogGroupsForQueryResponse {
5338
5587
  */
5339
5588
  export interface ListScheduledQueriesRequest {
5340
5589
  /**
5341
- * <p>The maximum number of scheduled queries to return in a single call.</p>
5590
+ * <p>The maximum number of scheduled queries to return. Valid range is 1 to 1000.</p>
5342
5591
  * @public
5343
5592
  */
5344
5593
  maxResults?: number | undefined;
@@ -5349,13 +5598,13 @@ export interface ListScheduledQueriesRequest {
5349
5598
  */
5350
5599
  nextToken?: string | undefined;
5351
5600
  /**
5352
- * <p>Filter results by the state of scheduled queries (ENABLED or DISABLED).</p>
5601
+ * <p>Filter scheduled queries by state. Valid values are <code>ENABLED</code> and <code>DISABLED</code>. If not specified, all scheduled queries are returned.</p>
5353
5602
  * @public
5354
5603
  */
5355
5604
  state?: ScheduledQueryState | undefined;
5356
5605
  }
5357
5606
  /**
5358
- * <p>Summary information about a scheduled query, used in list operations.</p>
5607
+ * <p>Summary information about a scheduled query, including basic configuration and execution status.</p>
5359
5608
  * @public
5360
5609
  */
5361
5610
  export interface ScheduledQuerySummary {
@@ -5370,17 +5619,17 @@ export interface ScheduledQuerySummary {
5370
5619
  */
5371
5620
  name?: string | undefined;
5372
5621
  /**
5373
- * <p>The current state of the scheduled query (ENABLED or DISABLED).</p>
5622
+ * <p>The current state of the scheduled query.</p>
5374
5623
  * @public
5375
5624
  */
5376
5625
  state?: ScheduledQueryState | undefined;
5377
5626
  /**
5378
- * <p>The time when the scheduled query was last executed.</p>
5627
+ * <p>The timestamp when the scheduled query was last executed.</p>
5379
5628
  * @public
5380
5629
  */
5381
5630
  lastTriggeredTime?: number | undefined;
5382
5631
  /**
5383
- * <p>The status of the last execution (Running, Complete, Failed, Timeout, or InvalidQuery).</p>
5632
+ * <p>The status of the most recent execution.</p>
5384
5633
  * @public
5385
5634
  */
5386
5635
  lastExecutionStatus?: ExecutionStatus | undefined;
@@ -5390,22 +5639,22 @@ export interface ScheduledQuerySummary {
5390
5639
  */
5391
5640
  scheduleExpression?: string | undefined;
5392
5641
  /**
5393
- * <p>The timezone in which the schedule expression is evaluated.</p>
5642
+ * <p>The timezone used for evaluating the schedule expression.</p>
5394
5643
  * @public
5395
5644
  */
5396
5645
  timezone?: string | undefined;
5397
5646
  /**
5398
- * <p>Configuration for destinations where the query results are delivered.</p>
5647
+ * <p>Configuration for where query results are delivered.</p>
5399
5648
  * @public
5400
5649
  */
5401
5650
  destinationConfiguration?: DestinationConfiguration | undefined;
5402
5651
  /**
5403
- * <p>The time when the scheduled query was created.</p>
5652
+ * <p>The timestamp when the scheduled query was created.</p>
5404
5653
  * @public
5405
5654
  */
5406
5655
  creationTime?: number | undefined;
5407
5656
  /**
5408
- * <p>The time when the scheduled query was last updated.</p>
5657
+ * <p>The timestamp when the scheduled query was last updated.</p>
5409
5658
  * @public
5410
5659
  */
5411
5660
  lastUpdatedTime?: number | undefined;
@@ -5421,11 +5670,82 @@ export interface ListScheduledQueriesResponse {
5421
5670
  */
5422
5671
  nextToken?: string | undefined;
5423
5672
  /**
5424
- * <p>The list of scheduled queries with summary information.</p>
5673
+ * <p>An array of scheduled query summary information.</p>
5425
5674
  * @public
5426
5675
  */
5427
5676
  scheduledQueries?: ScheduledQuerySummary[] | undefined;
5428
5677
  }
5678
+ /**
5679
+ * @public
5680
+ */
5681
+ export interface ListSourcesForS3TableIntegrationRequest {
5682
+ /**
5683
+ * <p>The Amazon Resource Name (ARN) of the S3 Table Integration to list associations
5684
+ * for.</p>
5685
+ * @public
5686
+ */
5687
+ integrationArn: string | undefined;
5688
+ /**
5689
+ * <p>The maximum number of associations to return in a single call. Valid range is 1 to
5690
+ * 100.</p>
5691
+ * @public
5692
+ */
5693
+ maxResults?: number | undefined;
5694
+ /**
5695
+ * <p>The token for the next set of items to return. The token expires after 24
5696
+ * hours.</p>
5697
+ * @public
5698
+ */
5699
+ nextToken?: string | undefined;
5700
+ }
5701
+ /**
5702
+ * <p>Represents a data source association with an S3 Table Integration, including its status
5703
+ * and metadata.</p>
5704
+ * @public
5705
+ */
5706
+ export interface S3TableIntegrationSource {
5707
+ /**
5708
+ * <p>The unique identifier for this data source association.</p>
5709
+ * @public
5710
+ */
5711
+ identifier?: string | undefined;
5712
+ /**
5713
+ * <p>The data source associated with the S3 Table Integration.</p>
5714
+ * @public
5715
+ */
5716
+ dataSource?: DataSource | undefined;
5717
+ /**
5718
+ * <p>The current status of the data source association.</p>
5719
+ * @public
5720
+ */
5721
+ status?: S3TableIntegrationSourceStatus | undefined;
5722
+ /**
5723
+ * <p>Additional information about the status of the data source association.</p>
5724
+ * @public
5725
+ */
5726
+ statusReason?: string | undefined;
5727
+ /**
5728
+ * <p>The timestamp when the data source association was created.</p>
5729
+ * @public
5730
+ */
5731
+ createdTimeStamp?: number | undefined;
5732
+ }
5733
+ /**
5734
+ * @public
5735
+ */
5736
+ export interface ListSourcesForS3TableIntegrationResponse {
5737
+ /**
5738
+ * <p>The list of data source associations for the specified S3 Table Integration.</p>
5739
+ * @public
5740
+ */
5741
+ sources?: S3TableIntegrationSource[] | undefined;
5742
+ /**
5743
+ * <p>The token for the next set of items to return. The token expires after 24
5744
+ * hours.</p>
5745
+ * @public
5746
+ */
5747
+ nextToken?: string | undefined;
5748
+ }
5429
5749
  /**
5430
5750
  * @public
5431
5751
  */
@@ -5952,22 +6272,28 @@ export interface PutDeliverySourceRequest {
5952
6272
  * <p>Defines the type of log that the source is sending.</p>
5953
6273
  * <ul>
5954
6274
  * <li>
5955
- * <p>For Amazon Bedrock Agents, the valid values are <code>APPLICATION_LOGS</code> and <code>EVENT_LOGS</code>.</p>
6275
+ * <p>For Amazon Bedrock Agents, the valid values are <code>APPLICATION_LOGS</code> and
6276
+ * <code>EVENT_LOGS</code>.</p>
5956
6277
  * </li>
5957
6278
  * <li>
5958
- * <p>For Amazon Bedrock Knowledge Bases, the valid value is <code>APPLICATION_LOGS</code>.</p>
6279
+ * <p>For Amazon Bedrock Knowledge Bases, the valid value is
6280
+ * <code>APPLICATION_LOGS</code>.</p>
5959
6281
  * </li>
5960
6282
  * <li>
5961
- * <p>For Amazon Bedrock AgentCore Runtime, the valid values are <code>APPLICATION_LOGS</code>, <code>USAGE_LOGS</code> and <code>TRACES</code>.</p>
6283
+ * <p>For Amazon Bedrock AgentCore Runtime, the valid values are
6284
+ * <code>APPLICATION_LOGS</code>, <code>USAGE_LOGS</code> and <code>TRACES</code>.</p>
5962
6285
  * </li>
5963
6286
  * <li>
5964
- * <p>For Amazon Bedrock AgentCore Tools, the valid values are <code>APPLICATION_LOGS</code>, <code>USAGE_LOGS</code> and <code>TRACES</code>.</p>
6287
+ * <p>For Amazon Bedrock AgentCore Tools, the valid values are
6288
+ * <code>APPLICATION_LOGS</code>, <code>USAGE_LOGS</code> and <code>TRACES</code>.</p>
5965
6289
  * </li>
5966
6290
  * <li>
5967
- * <p>For Amazon Bedrock AgentCore Identity, the valid values are <code>APPLICATION_LOGS</code> and <code>TRACES</code>.</p>
6291
+ * <p>For Amazon Bedrock AgentCore Identity, the valid values are
6292
+ * <code>APPLICATION_LOGS</code> and <code>TRACES</code>.</p>
5968
6293
  * </li>
5969
6294
  * <li>
5970
- * <p>For Amazon Bedrock AgentCore Gateway, the valid values are <code>APPLICATION_LOGS</code> and <code>TRACES</code>.</p>
6295
+ * <p>For Amazon Bedrock AgentCore Gateway, the valid values are
6296
+ * <code>APPLICATION_LOGS</code> and <code>TRACES</code>.</p>
5971
6297
  * </li>
5972
6298
  * <li>
5973
6299
  * <p>For CloudFront, the valid value is <code>ACCESS_LOGS</code>.</p>
@@ -5998,7 +6324,8 @@ export interface PutDeliverySourceRequest {
5998
6324
  * <code>PCS_JOBCOMP_LOGS</code>.</p>
5999
6325
  * </li>
6000
6326
  * <li>
6001
- * <p>For Amazon Web Services RTB Fabric, the valid values is <code>APPLICATION_LOGS</code>.</p>
6327
+ * <p>For Amazon Web Services RTB Fabric, the valid values is
6328
+ * <code>APPLICATION_LOGS</code>.</p>
6002
6329
  * </li>
6003
6330
  * <li>
6004
6331
  * <p>For Amazon Q, the valid values are <code>EVENT_LOGS</code> and
@@ -7290,67 +7617,67 @@ export interface UpdateLogAnomalyDetectorRequest {
7290
7617
  */
7291
7618
  export interface UpdateScheduledQueryRequest {
7292
7619
  /**
7293
- * <p>The name or ARN of the scheduled query to update.</p>
7620
+ * <p>The ARN or name of the scheduled query to update.</p>
7294
7621
  * @public
7295
7622
  */
7296
7623
  identifier: string | undefined;
7297
7624
  /**
7298
- * <p>Updated description for the scheduled query.</p>
7625
+ * <p>An updated description for the scheduled query.</p>
7299
7626
  * @public
7300
7627
  */
7301
7628
  description?: string | undefined;
7302
7629
  /**
7303
- * <p>Updated query language to use (LogsQL, PPL, or SQL).</p>
7630
+ * <p>The updated query language for the scheduled query.</p>
7304
7631
  * @public
7305
7632
  */
7306
7633
  queryLanguage: QueryLanguage | undefined;
7307
7634
  /**
7308
- * <p>Updated CloudWatch Logs Insights query string to execute.</p>
7635
+ * <p>The updated query string to execute.</p>
7309
7636
  * @public
7310
7637
  */
7311
7638
  queryString: string | undefined;
7312
7639
  /**
7313
- * <p>Updated log group identifiers to query.</p>
7640
+ * <p>The updated array of log group names or ARNs to query.</p>
7314
7641
  * @public
7315
7642
  */
7316
7643
  logGroupIdentifiers?: string[] | undefined;
7317
7644
  /**
7318
- * <p>Updated cron expression that defines when the scheduled query runs.</p>
7645
+ * <p>The updated cron expression that defines when the scheduled query runs.</p>
7319
7646
  * @public
7320
7647
  */
7321
7648
  scheduleExpression: string | undefined;
7322
7649
  /**
7323
- * <p>Updated timezone in which the schedule expression is evaluated.</p>
7650
+ * <p>The updated timezone for evaluating the schedule expression.</p>
7324
7651
  * @public
7325
7652
  */
7326
7653
  timezone?: string | undefined;
7327
7654
  /**
7328
- * <p>Updated time offset in seconds from the execution time for the start of the query time range.</p>
7655
+ * <p>The updated time offset in seconds that defines the lookback period for the query.</p>
7329
7656
  * @public
7330
7657
  */
7331
7658
  startTimeOffset?: number | undefined;
7332
7659
  /**
7333
- * <p>Updated configuration for destinations where the query results will be delivered.</p>
7660
+ * <p>The updated configuration for where to deliver query results.</p>
7334
7661
  * @public
7335
7662
  */
7336
7663
  destinationConfiguration?: DestinationConfiguration | undefined;
7337
7664
  /**
7338
- * <p>Updated start time for the query schedule in Unix epoch time.</p>
7665
+ * <p>The updated start time for the scheduled query in Unix epoch format.</p>
7339
7666
  * @public
7340
7667
  */
7341
7668
  scheduleStartTime?: number | undefined;
7342
7669
  /**
7343
- * <p>Updated end time for the query schedule in Unix epoch time.</p>
7670
+ * <p>The updated end time for the scheduled query in Unix epoch format.</p>
7344
7671
  * @public
7345
7672
  */
7346
7673
  scheduleEndTime?: number | undefined;
7347
7674
  /**
7348
- * <p>Updated ARN of the IAM role that CloudWatch Logs will assume to execute the scheduled query.</p>
7675
+ * <p>The updated ARN of the IAM role that grants permissions to execute the query and deliver results.</p>
7349
7676
  * @public
7350
7677
  */
7351
7678
  executionRoleArn: string | undefined;
7352
7679
  /**
7353
- * <p>Updated state of the scheduled query (ENABLED or DISABLED).</p>
7680
+ * <p>The updated state of the scheduled query.</p>
7354
7681
  * @public
7355
7682
  */
7356
7683
  state?: ScheduledQueryState | undefined;
@@ -7375,7 +7702,7 @@ export interface UpdateScheduledQueryResponse {
7375
7702
  */
7376
7703
  description?: string | undefined;
7377
7704
  /**
7378
- * <p>The query language used by the updated scheduled query.</p>
7705
+ * <p>The query language of the updated scheduled query.</p>
7379
7706
  * @public
7380
7707
  */
7381
7708
  queryLanguage?: QueryLanguage | undefined;
@@ -7385,12 +7712,12 @@ export interface UpdateScheduledQueryResponse {
7385
7712
  */
7386
7713
  queryString?: string | undefined;
7387
7714
  /**
7388
- * <p>The log group identifiers of the updated scheduled query.</p>
7715
+ * <p>The log groups queried by the updated scheduled query.</p>
7389
7716
  * @public
7390
7717
  */
7391
7718
  logGroupIdentifiers?: string[] | undefined;
7392
7719
  /**
7393
- * <p>The schedule expression of the updated scheduled query.</p>
7720
+ * <p>The cron expression of the updated scheduled query.</p>
7394
7721
  * @public
7395
7722
  */
7396
7723
  scheduleExpression?: string | undefined;
@@ -7400,7 +7727,7 @@ export interface UpdateScheduledQueryResponse {
7400
7727
  */
7401
7728
  timezone?: string | undefined;
7402
7729
  /**
7403
- * <p>The start time offset of the updated scheduled query.</p>
7730
+ * <p>The time offset of the updated scheduled query.</p>
7404
7731
  * @public
7405
7732
  */
7406
7733
  startTimeOffset?: number | undefined;
@@ -7415,22 +7742,22 @@ export interface UpdateScheduledQueryResponse {
7415
7742
  */
7416
7743
  state?: ScheduledQueryState | undefined;
7417
7744
  /**
7418
- * <p>The time when the updated scheduled query was last executed.</p>
7745
+ * <p>The timestamp when the updated scheduled query was last executed.</p>
7419
7746
  * @public
7420
7747
  */
7421
7748
  lastTriggeredTime?: number | undefined;
7422
7749
  /**
7423
- * <p>The status of the last execution of the updated scheduled query (Running, Complete, Failed, Timeout, or InvalidQuery).</p>
7750
+ * <p>The status of the most recent execution of the updated scheduled query.</p>
7424
7751
  * @public
7425
7752
  */
7426
7753
  lastExecutionStatus?: ExecutionStatus | undefined;
7427
7754
  /**
7428
- * <p>The schedule start time of the updated scheduled query.</p>
7755
+ * <p>The start time of the updated scheduled query.</p>
7429
7756
  * @public
7430
7757
  */
7431
7758
  scheduleStartTime?: number | undefined;
7432
7759
  /**
7433
- * <p>The schedule end time of the updated scheduled query.</p>
7760
+ * <p>The end time of the updated scheduled query.</p>
7434
7761
  * @public
7435
7762
  */
7436
7763
  scheduleEndTime?: number | undefined;
@@ -7440,13 +7767,63 @@ export interface UpdateScheduledQueryResponse {
7440
7767
  */
7441
7768
  executionRoleArn?: string | undefined;
7442
7769
  /**
7443
- * <p>The creation time of the updated scheduled query.</p>
7770
+ * <p>The timestamp when the scheduled query was originally created.</p>
7444
7771
  * @public
7445
7772
  */
7446
7773
  creationTime?: number | undefined;
7447
7774
  /**
7448
- * <p>The last updated time of the scheduled query.</p>
7775
+ * <p>The timestamp when the scheduled query was last updated.</p>
7449
7776
  * @public
7450
7777
  */
7451
7778
  lastUpdatedTime?: number | undefined;
7452
7779
  }
7780
+ /**
7781
+ * <p>Defines the data type structure for a log field, including the type, element information,
7782
+ * and nested fields for complex types.</p>
7783
+ * @public
7784
+ */
7785
+ export interface LogFieldType {
7786
+ /**
7787
+ * <p>The data type of the log field.</p>
7788
+ * @public
7789
+ */
7790
+ type?: string | undefined;
7791
+ /**
7792
+ * <p>For array or collection types, specifies the element type information.</p>
7793
+ * @public
7794
+ */
7795
+ element?: LogFieldType | undefined;
7796
+ /**
7797
+ * <p>For complex types, contains the nested field definitions.</p>
7798
+ * @public
7799
+ */
7800
+ fields?: LogFieldsListItem[] | undefined;
7801
+ }
7802
+ /**
7803
+ * <p>Represents a log field with its name and data type information for a specific data
7804
+ * source.</p>
7805
+ * @public
7806
+ */
7807
+ export interface LogFieldsListItem {
7808
+ /**
7809
+ * <p>The name of the log field.</p>
7810
+ * @public
7811
+ */
7812
+ logFieldName?: string | undefined;
7813
+ /**
7814
+ * <p>The data type information for the log field.</p>
7815
+ * @public
7816
+ */
7817
+ logFieldType?: LogFieldType | undefined;
7818
+ }
7819
+ /**
7820
+ * @public
7821
+ */
7822
+ export interface GetLogFieldsResponse {
7823
+ /**
7824
+ * <p>The list of log fields for the specified data source, including field names and their data
7825
+ * types.</p>
7826
+ * @public
7827
+ */
7828
+ logFields?: LogFieldsListItem[] | undefined;
7829
+ }