aws-sdk-cloudwatchlogs 1.129.0 → 1.131.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.
@@ -958,6 +958,133 @@ module Aws::CloudWatchLogs
958
958
  include Aws::Structure
959
959
  end
960
960
 
961
+ # @!attribute [rw] name
962
+ # A unique name for the scheduled query within the region for an AWS
963
+ # account. The name can contain letters, numbers, underscores,
964
+ # hyphens, forward slashes, periods, and hash symbols.
965
+ # @return [String]
966
+ #
967
+ # @!attribute [rw] description
968
+ # An optional description for the scheduled query to help identify its
969
+ # purpose.
970
+ # @return [String]
971
+ #
972
+ # @!attribute [rw] query_language
973
+ # The query language to use for the scheduled query. Valid values are
974
+ # LogsQL (CloudWatch Logs Insights query language), PPL (OpenSearch
975
+ # Service Piped Processing Language), and SQL (OpenSearch Service
976
+ # Structured Query Language).
977
+ # @return [String]
978
+ #
979
+ # @!attribute [rw] query_string
980
+ # The CloudWatch Logs Insights query string to execute. This is the
981
+ # actual query that will be run against your log data on the specified
982
+ # schedule.
983
+ # @return [String]
984
+ #
985
+ # @!attribute [rw] log_group_identifiers
986
+ # The log group identifiers to query. You can specify log group names
987
+ # or log group ARNs. If querying log groups in a source account from a
988
+ # monitoring account, you must specify the ARN of the log group.
989
+ # @return [Array<String>]
990
+ #
991
+ # @!attribute [rw] schedule_expression
992
+ # A cron expression that defines when the scheduled query runs. The
993
+ # format is cron(fields) where fields consist of six space-separated
994
+ # values: minutes, hours, day\_of\_month, month, day\_of\_week, year.
995
+ # @return [String]
996
+ #
997
+ # @!attribute [rw] timezone
998
+ # The timezone in which the schedule expression is evaluated. If not
999
+ # provided, defaults to UTC.
1000
+ # @return [String]
1001
+ #
1002
+ # @!attribute [rw] start_time_offset
1003
+ # Time offset in seconds from the execution time for the start of the
1004
+ # query time range. This defines the lookback period for the query
1005
+ # (for example, 3600 for the last hour).
1006
+ # @return [Integer]
1007
+ #
1008
+ # @!attribute [rw] destination_configuration
1009
+ # Configuration for destinations where the query results will be
1010
+ # delivered after successful execution. You can configure delivery to
1011
+ # S3 buckets or EventBridge event buses.
1012
+ # @return [Types::DestinationConfiguration]
1013
+ #
1014
+ # @!attribute [rw] schedule_start_time
1015
+ # The start time for the query schedule in Unix epoch time (seconds
1016
+ # since January 1, 1970, 00:00:00 UTC). If not specified, the schedule
1017
+ # starts immediately.
1018
+ # @return [Integer]
1019
+ #
1020
+ # @!attribute [rw] schedule_end_time
1021
+ # The end time for the query schedule in Unix epoch time (seconds
1022
+ # since January 1, 1970, 00:00:00 UTC). If not specified, the schedule
1023
+ # runs indefinitely.
1024
+ # @return [Integer]
1025
+ #
1026
+ # @!attribute [rw] execution_role_arn
1027
+ # The Amazon Resource Name (ARN) of the IAM role that CloudWatch Logs
1028
+ # will assume to execute the scheduled query and deliver results to
1029
+ # the specified destinations.
1030
+ # @return [String]
1031
+ #
1032
+ # @!attribute [rw] state
1033
+ # The initial state of the scheduled query. Valid values are ENABLED
1034
+ # (the query will run according to its schedule) and DISABLED (the
1035
+ # query is paused and will not run). If not provided, defaults to
1036
+ # ENABLED.
1037
+ # @return [String]
1038
+ #
1039
+ # @!attribute [rw] tags
1040
+ # An optional list of key-value pairs to associate with the resource.
1041
+ #
1042
+ # For more information about tagging, see [Tagging Amazon Web Services
1043
+ # resources][1]
1044
+ #
1045
+ #
1046
+ #
1047
+ # [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
1048
+ # @return [Hash<String,String>]
1049
+ #
1050
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/CreateScheduledQueryRequest AWS API Documentation
1051
+ #
1052
+ class CreateScheduledQueryRequest < Struct.new(
1053
+ :name,
1054
+ :description,
1055
+ :query_language,
1056
+ :query_string,
1057
+ :log_group_identifiers,
1058
+ :schedule_expression,
1059
+ :timezone,
1060
+ :start_time_offset,
1061
+ :destination_configuration,
1062
+ :schedule_start_time,
1063
+ :schedule_end_time,
1064
+ :execution_role_arn,
1065
+ :state,
1066
+ :tags)
1067
+ SENSITIVE = []
1068
+ include Aws::Structure
1069
+ end
1070
+
1071
+ # @!attribute [rw] scheduled_query_arn
1072
+ # The Amazon Resource Name (ARN) of the created scheduled query.
1073
+ # @return [String]
1074
+ #
1075
+ # @!attribute [rw] state
1076
+ # The current state of the scheduled query (ENABLED or DISABLED).
1077
+ # @return [String]
1078
+ #
1079
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/CreateScheduledQueryResponse AWS API Documentation
1080
+ #
1081
+ class CreateScheduledQueryResponse < Struct.new(
1082
+ :scheduled_query_arn,
1083
+ :state)
1084
+ SENSITIVE = []
1085
+ include Aws::Structure
1086
+ end
1087
+
961
1088
  # The event was already logged.
962
1089
  #
963
1090
  # `PutLogEvents` actions are now always accepted and never return
@@ -1336,6 +1463,22 @@ module Aws::CloudWatchLogs
1336
1463
  include Aws::Structure
1337
1464
  end
1338
1465
 
1466
+ # @!attribute [rw] identifier
1467
+ # The name or ARN of the scheduled query to delete.
1468
+ # @return [String]
1469
+ #
1470
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/DeleteScheduledQueryRequest AWS API Documentation
1471
+ #
1472
+ class DeleteScheduledQueryRequest < Struct.new(
1473
+ :identifier)
1474
+ SENSITIVE = []
1475
+ include Aws::Structure
1476
+ end
1477
+
1478
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/DeleteScheduledQueryResponse AWS API Documentation
1479
+ #
1480
+ class DeleteScheduledQueryResponse < Aws::EmptyStructure; end
1481
+
1339
1482
  # @!attribute [rw] log_group_name
1340
1483
  # The name of the log group.
1341
1484
  # @return [String]
@@ -2552,6 +2695,21 @@ module Aws::CloudWatchLogs
2552
2695
  include Aws::Structure
2553
2696
  end
2554
2697
 
2698
+ # Configuration for destinations where scheduled query results are
2699
+ # delivered, such as S3 buckets or EventBridge event buses.
2700
+ #
2701
+ # @!attribute [rw] s3_configuration
2702
+ # Configuration for delivering query results to an Amazon S3 bucket.
2703
+ # @return [Types::S3Configuration]
2704
+ #
2705
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/DestinationConfiguration AWS API Documentation
2706
+ #
2707
+ class DestinationConfiguration < Struct.new(
2708
+ :s3_configuration)
2709
+ SENSITIVE = []
2710
+ include Aws::Structure
2711
+ end
2712
+
2555
2713
  # @!attribute [rw] log_group_name
2556
2714
  # The name of the log group.
2557
2715
  #
@@ -3547,6 +3705,188 @@ module Aws::CloudWatchLogs
3547
3705
  include Aws::Structure
3548
3706
  end
3549
3707
 
3708
+ # @!attribute [rw] identifier
3709
+ # The name or ARN of the scheduled query to retrieve history for.
3710
+ # @return [String]
3711
+ #
3712
+ # @!attribute [rw] start_time
3713
+ # The start time for the history retrieval window in Unix epoch time.
3714
+ # @return [Integer]
3715
+ #
3716
+ # @!attribute [rw] end_time
3717
+ # The end time for the history retrieval window in Unix epoch time.
3718
+ # @return [Integer]
3719
+ #
3720
+ # @!attribute [rw] execution_statuses
3721
+ # Filter results by execution status (Running, Complete, Failed,
3722
+ # Timeout, or InvalidQuery).
3723
+ # @return [Array<String>]
3724
+ #
3725
+ # @!attribute [rw] max_results
3726
+ # The maximum number of history records to return in a single call.
3727
+ # @return [Integer]
3728
+ #
3729
+ # @!attribute [rw] next_token
3730
+ # The token for the next set of items to return. The token expires
3731
+ # after 24 hours.
3732
+ # @return [String]
3733
+ #
3734
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/GetScheduledQueryHistoryRequest AWS API Documentation
3735
+ #
3736
+ class GetScheduledQueryHistoryRequest < Struct.new(
3737
+ :identifier,
3738
+ :start_time,
3739
+ :end_time,
3740
+ :execution_statuses,
3741
+ :max_results,
3742
+ :next_token)
3743
+ SENSITIVE = []
3744
+ include Aws::Structure
3745
+ end
3746
+
3747
+ # @!attribute [rw] name
3748
+ # The name of the scheduled query.
3749
+ # @return [String]
3750
+ #
3751
+ # @!attribute [rw] scheduled_query_arn
3752
+ # The ARN of the scheduled query.
3753
+ # @return [String]
3754
+ #
3755
+ # @!attribute [rw] trigger_history
3756
+ # The list of execution history records for the scheduled query.
3757
+ # @return [Array<Types::TriggerHistoryRecord>]
3758
+ #
3759
+ # @!attribute [rw] next_token
3760
+ # The token for the next set of items to return. The token expires
3761
+ # after 24 hours.
3762
+ # @return [String]
3763
+ #
3764
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/GetScheduledQueryHistoryResponse AWS API Documentation
3765
+ #
3766
+ class GetScheduledQueryHistoryResponse < Struct.new(
3767
+ :name,
3768
+ :scheduled_query_arn,
3769
+ :trigger_history,
3770
+ :next_token)
3771
+ SENSITIVE = []
3772
+ include Aws::Structure
3773
+ end
3774
+
3775
+ # @!attribute [rw] identifier
3776
+ # The name or ARN of the scheduled query to retrieve.
3777
+ # @return [String]
3778
+ #
3779
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/GetScheduledQueryRequest AWS API Documentation
3780
+ #
3781
+ class GetScheduledQueryRequest < Struct.new(
3782
+ :identifier)
3783
+ SENSITIVE = []
3784
+ include Aws::Structure
3785
+ end
3786
+
3787
+ # @!attribute [rw] scheduled_query_arn
3788
+ # The Amazon Resource Name (ARN) of the scheduled query.
3789
+ # @return [String]
3790
+ #
3791
+ # @!attribute [rw] name
3792
+ # The name of the scheduled query.
3793
+ # @return [String]
3794
+ #
3795
+ # @!attribute [rw] description
3796
+ # The description of the scheduled query.
3797
+ # @return [String]
3798
+ #
3799
+ # @!attribute [rw] query_language
3800
+ # The query language used by the scheduled query (LogsQL, PPL, or
3801
+ # SQL).
3802
+ # @return [String]
3803
+ #
3804
+ # @!attribute [rw] query_string
3805
+ # The CloudWatch Logs Insights query string being executed.
3806
+ # @return [String]
3807
+ #
3808
+ # @!attribute [rw] log_group_identifiers
3809
+ # The log group identifiers being queried by the scheduled query.
3810
+ # @return [Array<String>]
3811
+ #
3812
+ # @!attribute [rw] schedule_expression
3813
+ # The cron expression that defines when the scheduled query runs.
3814
+ # @return [String]
3815
+ #
3816
+ # @!attribute [rw] timezone
3817
+ # The timezone in which the schedule expression is evaluated.
3818
+ # @return [String]
3819
+ #
3820
+ # @!attribute [rw] start_time_offset
3821
+ # Time offset in seconds from the execution time for the start of the
3822
+ # query time range.
3823
+ # @return [Integer]
3824
+ #
3825
+ # @!attribute [rw] destination_configuration
3826
+ # Configuration for destinations where the query results are
3827
+ # delivered.
3828
+ # @return [Types::DestinationConfiguration]
3829
+ #
3830
+ # @!attribute [rw] state
3831
+ # The current state of the scheduled query (ENABLED or DISABLED).
3832
+ # @return [String]
3833
+ #
3834
+ # @!attribute [rw] last_triggered_time
3835
+ # The time when the scheduled query was last executed, in Unix epoch
3836
+ # time.
3837
+ # @return [Integer]
3838
+ #
3839
+ # @!attribute [rw] last_execution_status
3840
+ # The status of the last executed query (Running, Complete, Failed,
3841
+ # Timeout, or InvalidQuery).
3842
+ # @return [String]
3843
+ #
3844
+ # @!attribute [rw] schedule_start_time
3845
+ # The start time for the query schedule in Unix epoch time.
3846
+ # @return [Integer]
3847
+ #
3848
+ # @!attribute [rw] schedule_end_time
3849
+ # The end time for the query schedule in Unix epoch time.
3850
+ # @return [Integer]
3851
+ #
3852
+ # @!attribute [rw] execution_role_arn
3853
+ # The ARN of the IAM role used to execute the scheduled query.
3854
+ # @return [String]
3855
+ #
3856
+ # @!attribute [rw] creation_time
3857
+ # The time when the scheduled query was created, in Unix epoch time.
3858
+ # @return [Integer]
3859
+ #
3860
+ # @!attribute [rw] last_updated_time
3861
+ # The time when the scheduled query was last updated, in Unix epoch
3862
+ # time.
3863
+ # @return [Integer]
3864
+ #
3865
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/GetScheduledQueryResponse AWS API Documentation
3866
+ #
3867
+ class GetScheduledQueryResponse < Struct.new(
3868
+ :scheduled_query_arn,
3869
+ :name,
3870
+ :description,
3871
+ :query_language,
3872
+ :query_string,
3873
+ :log_group_identifiers,
3874
+ :schedule_expression,
3875
+ :timezone,
3876
+ :start_time_offset,
3877
+ :destination_configuration,
3878
+ :state,
3879
+ :last_triggered_time,
3880
+ :last_execution_status,
3881
+ :schedule_start_time,
3882
+ :schedule_end_time,
3883
+ :execution_role_arn,
3884
+ :creation_time,
3885
+ :last_updated_time)
3886
+ SENSITIVE = []
3887
+ include Aws::Structure
3888
+ end
3889
+
3550
3890
  # @!attribute [rw] log_group_identifier
3551
3891
  # Specify either the name or ARN of the log group to return
3552
3892
  # transformer information for. If the log group is in a source account
@@ -3748,6 +4088,13 @@ module Aws::CloudWatchLogs
3748
4088
  include Aws::Structure
3749
4089
  end
3750
4090
 
4091
+ # An internal server error occurred while processing the request. This
4092
+ # is typically a temporary issue and the request can be retried.
4093
+ #
4094
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/InternalServerException AWS API Documentation
4095
+ #
4096
+ class InternalServerException < Aws::EmptyStructure; end
4097
+
3751
4098
  # An internal error occurred during the streaming of log data. This
3752
4099
  # exception is thrown when there's an issue with the internal streaming
3753
4100
  # mechanism used by the GetLogObject operation.
@@ -4069,6 +4416,48 @@ module Aws::CloudWatchLogs
4069
4416
  include Aws::Structure
4070
4417
  end
4071
4418
 
4419
+ # @!attribute [rw] max_results
4420
+ # The maximum number of scheduled queries to return in a single call.
4421
+ # @return [Integer]
4422
+ #
4423
+ # @!attribute [rw] next_token
4424
+ # The token for the next set of items to return. The token expires
4425
+ # after 24 hours.
4426
+ # @return [String]
4427
+ #
4428
+ # @!attribute [rw] state
4429
+ # Filter results by the state of scheduled queries (ENABLED or
4430
+ # DISABLED).
4431
+ # @return [String]
4432
+ #
4433
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/ListScheduledQueriesRequest AWS API Documentation
4434
+ #
4435
+ class ListScheduledQueriesRequest < Struct.new(
4436
+ :max_results,
4437
+ :next_token,
4438
+ :state)
4439
+ SENSITIVE = []
4440
+ include Aws::Structure
4441
+ end
4442
+
4443
+ # @!attribute [rw] next_token
4444
+ # The token for the next set of items to return. The token expires
4445
+ # after 24 hours.
4446
+ # @return [String]
4447
+ #
4448
+ # @!attribute [rw] scheduled_queries
4449
+ # The list of scheduled queries with summary information.
4450
+ # @return [Array<Types::ScheduledQuerySummary>]
4451
+ #
4452
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/ListScheduledQueriesResponse AWS API Documentation
4453
+ #
4454
+ class ListScheduledQueriesResponse < Struct.new(
4455
+ :next_token,
4456
+ :scheduled_queries)
4457
+ SENSITIVE = []
4458
+ include Aws::Structure
4459
+ end
4460
+
4072
4461
  # @!attribute [rw] resource_arn
4073
4462
  # The ARN of the resource that you want to view tags for.
4074
4463
  #
@@ -5538,8 +5927,8 @@ module Aws::CloudWatchLogs
5538
5927
  # This processor converts logs into [Open Cybersecurity Schema Framework
5539
5928
  # (OCSF)][1] events.
5540
5929
  #
5541
- # For more information about this processor including examples, see [
5542
- # parseToOSCF][2] in the *CloudWatch Logs User Guide*.
5930
+ # For more information about this processor including examples, see
5931
+ # [parseToOCSF][2] in the *CloudWatch Logs User Guide*.
5543
5932
  #
5544
5933
  #
5545
5934
  #
@@ -5561,12 +5950,20 @@ module Aws::CloudWatchLogs
5561
5950
  # log events.
5562
5951
  # @return [String]
5563
5952
  #
5953
+ # @!attribute [rw] mapping_version
5954
+ # Identifies the specific release of the Open Cybersecurity Schema
5955
+ # Framework (OCSF) transformer being used to parse OCSF data. Defaults
5956
+ # to the latest version if not specified. Does not automatically
5957
+ # update.
5958
+ # @return [String]
5959
+ #
5564
5960
  # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/ParseToOCSF AWS API Documentation
5565
5961
  #
5566
5962
  class ParseToOCSF < Struct.new(
5567
5963
  :source,
5568
5964
  :event_source,
5569
- :ocsf_version)
5965
+ :ocsf_version,
5966
+ :mapping_version)
5570
5967
  SENSITIVE = []
5571
5968
  include Aws::Structure
5572
5969
  end
@@ -6326,8 +6723,23 @@ module Aws::CloudWatchLogs
6326
6723
  # @!attribute [rw] log_type
6327
6724
  # Defines the type of log that the source is sending.
6328
6725
  #
6329
- # * For Amazon Bedrock, the valid value is `APPLICATION_LOGS` and
6330
- # `TRACES`.
6726
+ # * For Amazon Bedrock Agents, the valid values are `APPLICATION_LOGS`
6727
+ # and `EVENT_LOGS`.
6728
+ #
6729
+ # * For Amazon Bedrock Knowledge Bases, the valid value is
6730
+ # `APPLICATION_LOGS`.
6731
+ #
6732
+ # * For Amazon Bedrock AgentCore Runtime, the valid values are
6733
+ # `APPLICATION_LOGS`, `USAGE_LOGS` and `TRACES`.
6734
+ #
6735
+ # * For Amazon Bedrock AgentCore Tools, the valid values are
6736
+ # `APPLICATION_LOGS`, `USAGE_LOGS` and `TRACES`.
6737
+ #
6738
+ # * For Amazon Bedrock AgentCore Identity, the valid values are
6739
+ # `APPLICATION_LOGS` and `TRACES`.
6740
+ #
6741
+ # * For Amazon Bedrock AgentCore Gateway, the valid values are
6742
+ # `APPLICATION_LOGS` and `TRACES`.
6331
6743
  #
6332
6744
  # * For CloudFront, the valid value is `ACCESS_LOGS`.
6333
6745
  #
@@ -6344,13 +6756,19 @@ module Aws::CloudWatchLogs
6344
6756
  #
6345
6757
  # * For IAM Identity Center, the valid value is `ERROR_LOGS`.
6346
6758
  #
6759
+ # * For Network Load Balancer, the valid value is `NLB_ACCESS_LOGS`.
6760
+ #
6347
6761
  # * For PCS, the valid values are `PCS_SCHEDULER_LOGS` and
6348
6762
  # `PCS_JOBCOMP_LOGS`.
6349
6763
  #
6350
- # * For Amazon Q, the valid value is `EVENT_LOGS`.
6764
+ # * For Amazon Web Services RTB Fabric, the valid values is
6765
+ # `APPLICATION_LOGS`.
6766
+ #
6767
+ # * For Amazon Q, the valid values are `EVENT_LOGS` and
6768
+ # `SYNC_JOB_LOGS`.
6351
6769
  #
6352
6770
  # * For Amazon SES mail manager, the valid values are
6353
- # `APPLICATION_LOG` and `TRAFFIC_POLICY_DEBUG_LOGS`.
6771
+ # `APPLICATION_LOGS` and `TRAFFIC_POLICY_DEBUG_LOGS`.
6354
6772
  #
6355
6773
  # * For Amazon WorkMail, the valid values are `ACCESS_CONTROL_LOGS`,
6356
6774
  # `AUTHENTICATION_LOGS`, `WORKMAIL_AVAILABILITY_PROVIDER_LOGS`,
@@ -7471,6 +7889,28 @@ module Aws::CloudWatchLogs
7471
7889
  include Aws::Structure
7472
7890
  end
7473
7891
 
7892
+ # Configuration details for delivering scheduled query results to an
7893
+ # Amazon S3 bucket.
7894
+ #
7895
+ # @!attribute [rw] destination_identifier
7896
+ # The S3 URI where query results will be stored (e.g.,
7897
+ # s3://bucket-name/prefix/).
7898
+ # @return [String]
7899
+ #
7900
+ # @!attribute [rw] role_arn
7901
+ # The ARN of the IAM role that CloudWatch Logs will assume to write
7902
+ # results to the S3 bucket.
7903
+ # @return [String]
7904
+ #
7905
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/S3Configuration AWS API Documentation
7906
+ #
7907
+ class S3Configuration < Struct.new(
7908
+ :destination_identifier,
7909
+ :role_arn)
7910
+ SENSITIVE = []
7911
+ include Aws::Structure
7912
+ end
7913
+
7474
7914
  # This structure contains delivery configurations that apply only when
7475
7915
  # the delivery destination resource is an S3 bucket.
7476
7916
  #
@@ -7501,6 +7941,103 @@ module Aws::CloudWatchLogs
7501
7941
  include Aws::Structure
7502
7942
  end
7503
7943
 
7944
+ # Information about a destination where scheduled query results are
7945
+ # processed and delivered.
7946
+ #
7947
+ # @!attribute [rw] destination_type
7948
+ # The type of destination (S3).
7949
+ # @return [String]
7950
+ #
7951
+ # @!attribute [rw] destination_identifier
7952
+ # The destination identifier (S3 URI).
7953
+ # @return [String]
7954
+ #
7955
+ # @!attribute [rw] status
7956
+ # The processing status for this destination (IN\_PROGRESS, ERROR,
7957
+ # FAILED, or COMPLETE).
7958
+ # @return [String]
7959
+ #
7960
+ # @!attribute [rw] processed_identifier
7961
+ # The processed identifier returned for the destination (S3 key).
7962
+ # @return [String]
7963
+ #
7964
+ # @!attribute [rw] error_message
7965
+ # Error message if the destination processing failed.
7966
+ # @return [String]
7967
+ #
7968
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/ScheduledQueryDestination AWS API Documentation
7969
+ #
7970
+ class ScheduledQueryDestination < Struct.new(
7971
+ :destination_type,
7972
+ :destination_identifier,
7973
+ :status,
7974
+ :processed_identifier,
7975
+ :error_message)
7976
+ SENSITIVE = []
7977
+ include Aws::Structure
7978
+ end
7979
+
7980
+ # Summary information about a scheduled query, used in list operations.
7981
+ #
7982
+ # @!attribute [rw] scheduled_query_arn
7983
+ # The ARN of the scheduled query.
7984
+ # @return [String]
7985
+ #
7986
+ # @!attribute [rw] name
7987
+ # The name of the scheduled query.
7988
+ # @return [String]
7989
+ #
7990
+ # @!attribute [rw] state
7991
+ # The current state of the scheduled query (ENABLED or DISABLED).
7992
+ # @return [String]
7993
+ #
7994
+ # @!attribute [rw] last_triggered_time
7995
+ # The time when the scheduled query was last executed.
7996
+ # @return [Integer]
7997
+ #
7998
+ # @!attribute [rw] last_execution_status
7999
+ # The status of the last execution (Running, Complete, Failed,
8000
+ # Timeout, or InvalidQuery).
8001
+ # @return [String]
8002
+ #
8003
+ # @!attribute [rw] schedule_expression
8004
+ # The cron expression that defines when the scheduled query runs.
8005
+ # @return [String]
8006
+ #
8007
+ # @!attribute [rw] timezone
8008
+ # The timezone in which the schedule expression is evaluated.
8009
+ # @return [String]
8010
+ #
8011
+ # @!attribute [rw] destination_configuration
8012
+ # Configuration for destinations where the query results are
8013
+ # delivered.
8014
+ # @return [Types::DestinationConfiguration]
8015
+ #
8016
+ # @!attribute [rw] creation_time
8017
+ # The time when the scheduled query was created.
8018
+ # @return [Integer]
8019
+ #
8020
+ # @!attribute [rw] last_updated_time
8021
+ # The time when the scheduled query was last updated.
8022
+ # @return [Integer]
8023
+ #
8024
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/ScheduledQuerySummary AWS API Documentation
8025
+ #
8026
+ class ScheduledQuerySummary < Struct.new(
8027
+ :scheduled_query_arn,
8028
+ :name,
8029
+ :state,
8030
+ :last_triggered_time,
8031
+ :last_execution_status,
8032
+ :schedule_expression,
8033
+ :timezone,
8034
+ :destination_configuration,
8035
+ :creation_time,
8036
+ :last_updated_time)
8037
+ SENSITIVE = []
8038
+ include Aws::Structure
8039
+ end
8040
+
7504
8041
  # Represents the search status of a log stream.
7505
8042
  #
7506
8043
  # @!attribute [rw] log_stream_name
@@ -8147,6 +8684,46 @@ module Aws::CloudWatchLogs
8147
8684
  include Aws::Structure
8148
8685
  end
8149
8686
 
8687
+ # A record of a scheduled query execution, including its status and
8688
+ # destination processing information.
8689
+ #
8690
+ # @!attribute [rw] query_id
8691
+ # The unique identifier for the query execution.
8692
+ # @return [String]
8693
+ #
8694
+ # @!attribute [rw] execution_status
8695
+ # The status of the query execution (Running, Complete, Failed,
8696
+ # Timeout, or InvalidQuery).
8697
+ # @return [String]
8698
+ #
8699
+ # @!attribute [rw] triggered_timestamp
8700
+ # The time when the scheduled query was triggered, in Unix epoch time.
8701
+ # @return [Integer]
8702
+ #
8703
+ # @!attribute [rw] error_message
8704
+ # The error message if the scheduled query execution failed. This
8705
+ # field is only populated when the execution status indicates a
8706
+ # failure.
8707
+ # @return [String]
8708
+ #
8709
+ # @!attribute [rw] destinations
8710
+ # The list of destinations where the scheduled query results were
8711
+ # delivered for this execution. This includes S3 buckets configured
8712
+ # for the scheduled query.
8713
+ # @return [Array<Types::ScheduledQueryDestination>]
8714
+ #
8715
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/TriggerHistoryRecord AWS API Documentation
8716
+ #
8717
+ class TriggerHistoryRecord < Struct.new(
8718
+ :query_id,
8719
+ :execution_status,
8720
+ :triggered_timestamp,
8721
+ :error_message,
8722
+ :destinations)
8723
+ SENSITIVE = []
8724
+ include Aws::Structure
8725
+ end
8726
+
8150
8727
  # Use this processor to remove leading and trailing whitespace.
8151
8728
  #
8152
8729
  # For more information about this processor including examples, see [
@@ -8412,6 +8989,179 @@ module Aws::CloudWatchLogs
8412
8989
  include Aws::Structure
8413
8990
  end
8414
8991
 
8992
+ # @!attribute [rw] identifier
8993
+ # The name or ARN of the scheduled query to update.
8994
+ # @return [String]
8995
+ #
8996
+ # @!attribute [rw] description
8997
+ # Updated description for the scheduled query.
8998
+ # @return [String]
8999
+ #
9000
+ # @!attribute [rw] query_language
9001
+ # Updated query language to use (LogsQL, PPL, or SQL).
9002
+ # @return [String]
9003
+ #
9004
+ # @!attribute [rw] query_string
9005
+ # Updated CloudWatch Logs Insights query string to execute.
9006
+ # @return [String]
9007
+ #
9008
+ # @!attribute [rw] log_group_identifiers
9009
+ # Updated log group identifiers to query.
9010
+ # @return [Array<String>]
9011
+ #
9012
+ # @!attribute [rw] schedule_expression
9013
+ # Updated cron expression that defines when the scheduled query runs.
9014
+ # @return [String]
9015
+ #
9016
+ # @!attribute [rw] timezone
9017
+ # Updated timezone in which the schedule expression is evaluated.
9018
+ # @return [String]
9019
+ #
9020
+ # @!attribute [rw] start_time_offset
9021
+ # Updated time offset in seconds from the execution time for the start
9022
+ # of the query time range.
9023
+ # @return [Integer]
9024
+ #
9025
+ # @!attribute [rw] destination_configuration
9026
+ # Updated configuration for destinations where the query results will
9027
+ # be delivered.
9028
+ # @return [Types::DestinationConfiguration]
9029
+ #
9030
+ # @!attribute [rw] schedule_start_time
9031
+ # Updated start time for the query schedule in Unix epoch time.
9032
+ # @return [Integer]
9033
+ #
9034
+ # @!attribute [rw] schedule_end_time
9035
+ # Updated end time for the query schedule in Unix epoch time.
9036
+ # @return [Integer]
9037
+ #
9038
+ # @!attribute [rw] execution_role_arn
9039
+ # Updated ARN of the IAM role that CloudWatch Logs will assume to
9040
+ # execute the scheduled query.
9041
+ # @return [String]
9042
+ #
9043
+ # @!attribute [rw] state
9044
+ # Updated state of the scheduled query (ENABLED or DISABLED).
9045
+ # @return [String]
9046
+ #
9047
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/UpdateScheduledQueryRequest AWS API Documentation
9048
+ #
9049
+ class UpdateScheduledQueryRequest < Struct.new(
9050
+ :identifier,
9051
+ :description,
9052
+ :query_language,
9053
+ :query_string,
9054
+ :log_group_identifiers,
9055
+ :schedule_expression,
9056
+ :timezone,
9057
+ :start_time_offset,
9058
+ :destination_configuration,
9059
+ :schedule_start_time,
9060
+ :schedule_end_time,
9061
+ :execution_role_arn,
9062
+ :state)
9063
+ SENSITIVE = []
9064
+ include Aws::Structure
9065
+ end
9066
+
9067
+ # @!attribute [rw] scheduled_query_arn
9068
+ # The ARN of the updated scheduled query.
9069
+ # @return [String]
9070
+ #
9071
+ # @!attribute [rw] name
9072
+ # The name of the updated scheduled query.
9073
+ # @return [String]
9074
+ #
9075
+ # @!attribute [rw] description
9076
+ # The description of the updated scheduled query.
9077
+ # @return [String]
9078
+ #
9079
+ # @!attribute [rw] query_language
9080
+ # The query language used by the updated scheduled query.
9081
+ # @return [String]
9082
+ #
9083
+ # @!attribute [rw] query_string
9084
+ # The query string of the updated scheduled query.
9085
+ # @return [String]
9086
+ #
9087
+ # @!attribute [rw] log_group_identifiers
9088
+ # The log group identifiers of the updated scheduled query.
9089
+ # @return [Array<String>]
9090
+ #
9091
+ # @!attribute [rw] schedule_expression
9092
+ # The schedule expression of the updated scheduled query.
9093
+ # @return [String]
9094
+ #
9095
+ # @!attribute [rw] timezone
9096
+ # The timezone of the updated scheduled query.
9097
+ # @return [String]
9098
+ #
9099
+ # @!attribute [rw] start_time_offset
9100
+ # The start time offset of the updated scheduled query.
9101
+ # @return [Integer]
9102
+ #
9103
+ # @!attribute [rw] destination_configuration
9104
+ # The destination configuration of the updated scheduled query.
9105
+ # @return [Types::DestinationConfiguration]
9106
+ #
9107
+ # @!attribute [rw] state
9108
+ # The state of the updated scheduled query.
9109
+ # @return [String]
9110
+ #
9111
+ # @!attribute [rw] last_triggered_time
9112
+ # The time when the updated scheduled query was last executed.
9113
+ # @return [Integer]
9114
+ #
9115
+ # @!attribute [rw] last_execution_status
9116
+ # The status of the last execution of the updated scheduled query
9117
+ # (Running, Complete, Failed, Timeout, or InvalidQuery).
9118
+ # @return [String]
9119
+ #
9120
+ # @!attribute [rw] schedule_start_time
9121
+ # The schedule start time of the updated scheduled query.
9122
+ # @return [Integer]
9123
+ #
9124
+ # @!attribute [rw] schedule_end_time
9125
+ # The schedule end time of the updated scheduled query.
9126
+ # @return [Integer]
9127
+ #
9128
+ # @!attribute [rw] execution_role_arn
9129
+ # The execution role ARN of the updated scheduled query.
9130
+ # @return [String]
9131
+ #
9132
+ # @!attribute [rw] creation_time
9133
+ # The creation time of the updated scheduled query.
9134
+ # @return [Integer]
9135
+ #
9136
+ # @!attribute [rw] last_updated_time
9137
+ # The last updated time of the scheduled query.
9138
+ # @return [Integer]
9139
+ #
9140
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/UpdateScheduledQueryResponse AWS API Documentation
9141
+ #
9142
+ class UpdateScheduledQueryResponse < Struct.new(
9143
+ :scheduled_query_arn,
9144
+ :name,
9145
+ :description,
9146
+ :query_language,
9147
+ :query_string,
9148
+ :log_group_identifiers,
9149
+ :schedule_expression,
9150
+ :timezone,
9151
+ :start_time_offset,
9152
+ :destination_configuration,
9153
+ :state,
9154
+ :last_triggered_time,
9155
+ :last_execution_status,
9156
+ :schedule_start_time,
9157
+ :schedule_end_time,
9158
+ :execution_role_arn,
9159
+ :creation_time,
9160
+ :last_updated_time)
9161
+ SENSITIVE = []
9162
+ include Aws::Structure
9163
+ end
9164
+
8415
9165
  # This processor converts a string field to uppercase.
8416
9166
  #
8417
9167
  # For more information about this processor including examples, see [