aws-sdk-cloudwatchlogs 1.129.0 → 1.130.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
  #
@@ -6326,8 +6715,23 @@ module Aws::CloudWatchLogs
6326
6715
  # @!attribute [rw] log_type
6327
6716
  # Defines the type of log that the source is sending.
6328
6717
  #
6329
- # * For Amazon Bedrock, the valid value is `APPLICATION_LOGS` and
6330
- # `TRACES`.
6718
+ # * For Amazon Bedrock Agents, the valid values are `APPLICATION_LOGS`
6719
+ # and `EVENT_LOGS`.
6720
+ #
6721
+ # * For Amazon Bedrock Knowledge Bases, the valid value is
6722
+ # `APPLICATION_LOGS`.
6723
+ #
6724
+ # * For Amazon Bedrock AgentCore Runtime, the valid values are
6725
+ # `APPLICATION_LOGS`, `USAGE_LOGS` and `TRACES`.
6726
+ #
6727
+ # * For Amazon Bedrock AgentCore Tools, the valid values are
6728
+ # `APPLICATION_LOGS`, `USAGE_LOGS` and `TRACES`.
6729
+ #
6730
+ # * For Amazon Bedrock AgentCore Identity, the valid values are
6731
+ # `APPLICATION_LOGS` and `TRACES`.
6732
+ #
6733
+ # * For Amazon Bedrock AgentCore Gateway, the valid values are
6734
+ # `APPLICATION_LOGS` and `TRACES`.
6331
6735
  #
6332
6736
  # * For CloudFront, the valid value is `ACCESS_LOGS`.
6333
6737
  #
@@ -6347,10 +6751,11 @@ module Aws::CloudWatchLogs
6347
6751
  # * For PCS, the valid values are `PCS_SCHEDULER_LOGS` and
6348
6752
  # `PCS_JOBCOMP_LOGS`.
6349
6753
  #
6350
- # * For Amazon Q, the valid value is `EVENT_LOGS`.
6754
+ # * For Amazon Q, the valid values are `EVENT_LOGS` and
6755
+ # `SYNC_JOB_LOGS`.
6351
6756
  #
6352
6757
  # * For Amazon SES mail manager, the valid values are
6353
- # `APPLICATION_LOG` and `TRAFFIC_POLICY_DEBUG_LOGS`.
6758
+ # `APPLICATION_LOGS` and `TRAFFIC_POLICY_DEBUG_LOGS`.
6354
6759
  #
6355
6760
  # * For Amazon WorkMail, the valid values are `ACCESS_CONTROL_LOGS`,
6356
6761
  # `AUTHENTICATION_LOGS`, `WORKMAIL_AVAILABILITY_PROVIDER_LOGS`,
@@ -7471,6 +7876,28 @@ module Aws::CloudWatchLogs
7471
7876
  include Aws::Structure
7472
7877
  end
7473
7878
 
7879
+ # Configuration details for delivering scheduled query results to an
7880
+ # Amazon S3 bucket.
7881
+ #
7882
+ # @!attribute [rw] destination_identifier
7883
+ # The S3 URI where query results will be stored (e.g.,
7884
+ # s3://bucket-name/prefix/).
7885
+ # @return [String]
7886
+ #
7887
+ # @!attribute [rw] role_arn
7888
+ # The ARN of the IAM role that CloudWatch Logs will assume to write
7889
+ # results to the S3 bucket.
7890
+ # @return [String]
7891
+ #
7892
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/S3Configuration AWS API Documentation
7893
+ #
7894
+ class S3Configuration < Struct.new(
7895
+ :destination_identifier,
7896
+ :role_arn)
7897
+ SENSITIVE = []
7898
+ include Aws::Structure
7899
+ end
7900
+
7474
7901
  # This structure contains delivery configurations that apply only when
7475
7902
  # the delivery destination resource is an S3 bucket.
7476
7903
  #
@@ -7501,6 +7928,104 @@ module Aws::CloudWatchLogs
7501
7928
  include Aws::Structure
7502
7929
  end
7503
7930
 
7931
+ # Information about a destination where scheduled query results are
7932
+ # processed and delivered.
7933
+ #
7934
+ # @!attribute [rw] destination_type
7935
+ # The type of destination (S3 or EVENTBRIDGE).
7936
+ # @return [String]
7937
+ #
7938
+ # @!attribute [rw] destination_identifier
7939
+ # The destination identifier (S3 URI or EventBridge ARN).
7940
+ # @return [String]
7941
+ #
7942
+ # @!attribute [rw] status
7943
+ # The processing status for this destination (IN\_PROGRESS, ERROR,
7944
+ # FAILED, or COMPLETE).
7945
+ # @return [String]
7946
+ #
7947
+ # @!attribute [rw] processed_identifier
7948
+ # The processed identifier returned for the destination (S3 key or
7949
+ # event ID).
7950
+ # @return [String]
7951
+ #
7952
+ # @!attribute [rw] error_message
7953
+ # Error message if the destination processing failed.
7954
+ # @return [String]
7955
+ #
7956
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/ScheduledQueryDestination AWS API Documentation
7957
+ #
7958
+ class ScheduledQueryDestination < Struct.new(
7959
+ :destination_type,
7960
+ :destination_identifier,
7961
+ :status,
7962
+ :processed_identifier,
7963
+ :error_message)
7964
+ SENSITIVE = []
7965
+ include Aws::Structure
7966
+ end
7967
+
7968
+ # Summary information about a scheduled query, used in list operations.
7969
+ #
7970
+ # @!attribute [rw] scheduled_query_arn
7971
+ # The ARN of the scheduled query.
7972
+ # @return [String]
7973
+ #
7974
+ # @!attribute [rw] name
7975
+ # The name of the scheduled query.
7976
+ # @return [String]
7977
+ #
7978
+ # @!attribute [rw] state
7979
+ # The current state of the scheduled query (ENABLED or DISABLED).
7980
+ # @return [String]
7981
+ #
7982
+ # @!attribute [rw] last_triggered_time
7983
+ # The time when the scheduled query was last executed.
7984
+ # @return [Integer]
7985
+ #
7986
+ # @!attribute [rw] last_execution_status
7987
+ # The status of the last execution (Running, Complete, Failed,
7988
+ # Timeout, or InvalidQuery).
7989
+ # @return [String]
7990
+ #
7991
+ # @!attribute [rw] schedule_expression
7992
+ # The cron expression that defines when the scheduled query runs.
7993
+ # @return [String]
7994
+ #
7995
+ # @!attribute [rw] timezone
7996
+ # The timezone in which the schedule expression is evaluated.
7997
+ # @return [String]
7998
+ #
7999
+ # @!attribute [rw] destination_configuration
8000
+ # Configuration for destinations where the query results are
8001
+ # delivered.
8002
+ # @return [Types::DestinationConfiguration]
8003
+ #
8004
+ # @!attribute [rw] creation_time
8005
+ # The time when the scheduled query was created.
8006
+ # @return [Integer]
8007
+ #
8008
+ # @!attribute [rw] last_updated_time
8009
+ # The time when the scheduled query was last updated.
8010
+ # @return [Integer]
8011
+ #
8012
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/ScheduledQuerySummary AWS API Documentation
8013
+ #
8014
+ class ScheduledQuerySummary < Struct.new(
8015
+ :scheduled_query_arn,
8016
+ :name,
8017
+ :state,
8018
+ :last_triggered_time,
8019
+ :last_execution_status,
8020
+ :schedule_expression,
8021
+ :timezone,
8022
+ :destination_configuration,
8023
+ :creation_time,
8024
+ :last_updated_time)
8025
+ SENSITIVE = []
8026
+ include Aws::Structure
8027
+ end
8028
+
7504
8029
  # Represents the search status of a log stream.
7505
8030
  #
7506
8031
  # @!attribute [rw] log_stream_name
@@ -8147,6 +8672,46 @@ module Aws::CloudWatchLogs
8147
8672
  include Aws::Structure
8148
8673
  end
8149
8674
 
8675
+ # A record of a scheduled query execution, including its status and
8676
+ # destination processing information.
8677
+ #
8678
+ # @!attribute [rw] query_id
8679
+ # The unique identifier for the query execution.
8680
+ # @return [String]
8681
+ #
8682
+ # @!attribute [rw] execution_status
8683
+ # The status of the query execution (SUCCEEDED, FAILED, TIMEOUT, or
8684
+ # INVALID\_QUERY).
8685
+ # @return [String]
8686
+ #
8687
+ # @!attribute [rw] triggered_timestamp
8688
+ # The time when the scheduled query was triggered, in Unix epoch time.
8689
+ # @return [Integer]
8690
+ #
8691
+ # @!attribute [rw] error_message
8692
+ # The error message if the scheduled query execution failed. This
8693
+ # field is only populated when the execution status indicates a
8694
+ # failure.
8695
+ # @return [String]
8696
+ #
8697
+ # @!attribute [rw] destinations
8698
+ # The list of destinations where the scheduled query results were
8699
+ # delivered for this execution. This includes S3 buckets and
8700
+ # EventBridge targets configured for the scheduled query.
8701
+ # @return [Array<Types::ScheduledQueryDestination>]
8702
+ #
8703
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/TriggerHistoryRecord AWS API Documentation
8704
+ #
8705
+ class TriggerHistoryRecord < Struct.new(
8706
+ :query_id,
8707
+ :execution_status,
8708
+ :triggered_timestamp,
8709
+ :error_message,
8710
+ :destinations)
8711
+ SENSITIVE = []
8712
+ include Aws::Structure
8713
+ end
8714
+
8150
8715
  # Use this processor to remove leading and trailing whitespace.
8151
8716
  #
8152
8717
  # For more information about this processor including examples, see [
@@ -8412,6 +8977,179 @@ module Aws::CloudWatchLogs
8412
8977
  include Aws::Structure
8413
8978
  end
8414
8979
 
8980
+ # @!attribute [rw] identifier
8981
+ # The name or ARN of the scheduled query to update.
8982
+ # @return [String]
8983
+ #
8984
+ # @!attribute [rw] description
8985
+ # Updated description for the scheduled query.
8986
+ # @return [String]
8987
+ #
8988
+ # @!attribute [rw] query_language
8989
+ # Updated query language to use (LogsQL, PPL, or SQL).
8990
+ # @return [String]
8991
+ #
8992
+ # @!attribute [rw] query_string
8993
+ # Updated CloudWatch Logs Insights query string to execute.
8994
+ # @return [String]
8995
+ #
8996
+ # @!attribute [rw] log_group_identifiers
8997
+ # Updated log group identifiers to query.
8998
+ # @return [Array<String>]
8999
+ #
9000
+ # @!attribute [rw] schedule_expression
9001
+ # Updated cron expression that defines when the scheduled query runs.
9002
+ # @return [String]
9003
+ #
9004
+ # @!attribute [rw] timezone
9005
+ # Updated timezone in which the schedule expression is evaluated.
9006
+ # @return [String]
9007
+ #
9008
+ # @!attribute [rw] start_time_offset
9009
+ # Updated time offset in seconds from the execution time for the start
9010
+ # of the query time range.
9011
+ # @return [Integer]
9012
+ #
9013
+ # @!attribute [rw] destination_configuration
9014
+ # Updated configuration for destinations where the query results will
9015
+ # be delivered.
9016
+ # @return [Types::DestinationConfiguration]
9017
+ #
9018
+ # @!attribute [rw] schedule_start_time
9019
+ # Updated start time for the query schedule in Unix epoch time.
9020
+ # @return [Integer]
9021
+ #
9022
+ # @!attribute [rw] schedule_end_time
9023
+ # Updated end time for the query schedule in Unix epoch time.
9024
+ # @return [Integer]
9025
+ #
9026
+ # @!attribute [rw] execution_role_arn
9027
+ # Updated ARN of the IAM role that CloudWatch Logs will assume to
9028
+ # execute the scheduled query.
9029
+ # @return [String]
9030
+ #
9031
+ # @!attribute [rw] state
9032
+ # Updated state of the scheduled query (ENABLED or DISABLED).
9033
+ # @return [String]
9034
+ #
9035
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/UpdateScheduledQueryRequest AWS API Documentation
9036
+ #
9037
+ class UpdateScheduledQueryRequest < Struct.new(
9038
+ :identifier,
9039
+ :description,
9040
+ :query_language,
9041
+ :query_string,
9042
+ :log_group_identifiers,
9043
+ :schedule_expression,
9044
+ :timezone,
9045
+ :start_time_offset,
9046
+ :destination_configuration,
9047
+ :schedule_start_time,
9048
+ :schedule_end_time,
9049
+ :execution_role_arn,
9050
+ :state)
9051
+ SENSITIVE = []
9052
+ include Aws::Structure
9053
+ end
9054
+
9055
+ # @!attribute [rw] scheduled_query_arn
9056
+ # The ARN of the updated scheduled query.
9057
+ # @return [String]
9058
+ #
9059
+ # @!attribute [rw] name
9060
+ # The name of the updated scheduled query.
9061
+ # @return [String]
9062
+ #
9063
+ # @!attribute [rw] description
9064
+ # The description of the updated scheduled query.
9065
+ # @return [String]
9066
+ #
9067
+ # @!attribute [rw] query_language
9068
+ # The query language used by the updated scheduled query.
9069
+ # @return [String]
9070
+ #
9071
+ # @!attribute [rw] query_string
9072
+ # The query string of the updated scheduled query.
9073
+ # @return [String]
9074
+ #
9075
+ # @!attribute [rw] log_group_identifiers
9076
+ # The log group identifiers of the updated scheduled query.
9077
+ # @return [Array<String>]
9078
+ #
9079
+ # @!attribute [rw] schedule_expression
9080
+ # The schedule expression of the updated scheduled query.
9081
+ # @return [String]
9082
+ #
9083
+ # @!attribute [rw] timezone
9084
+ # The timezone of the updated scheduled query.
9085
+ # @return [String]
9086
+ #
9087
+ # @!attribute [rw] start_time_offset
9088
+ # The start time offset of the updated scheduled query.
9089
+ # @return [Integer]
9090
+ #
9091
+ # @!attribute [rw] destination_configuration
9092
+ # The destination configuration of the updated scheduled query.
9093
+ # @return [Types::DestinationConfiguration]
9094
+ #
9095
+ # @!attribute [rw] state
9096
+ # The state of the updated scheduled query.
9097
+ # @return [String]
9098
+ #
9099
+ # @!attribute [rw] last_triggered_time
9100
+ # The time when the updated scheduled query was last executed.
9101
+ # @return [Integer]
9102
+ #
9103
+ # @!attribute [rw] last_execution_status
9104
+ # The status of the last execution of the updated scheduled query
9105
+ # (Running, Complete, Failed, Timeout, or InvalidQuery).
9106
+ # @return [String]
9107
+ #
9108
+ # @!attribute [rw] schedule_start_time
9109
+ # The schedule start time of the updated scheduled query.
9110
+ # @return [Integer]
9111
+ #
9112
+ # @!attribute [rw] schedule_end_time
9113
+ # The schedule end time of the updated scheduled query.
9114
+ # @return [Integer]
9115
+ #
9116
+ # @!attribute [rw] execution_role_arn
9117
+ # The execution role ARN of the updated scheduled query.
9118
+ # @return [String]
9119
+ #
9120
+ # @!attribute [rw] creation_time
9121
+ # The creation time of the updated scheduled query.
9122
+ # @return [Integer]
9123
+ #
9124
+ # @!attribute [rw] last_updated_time
9125
+ # The last updated time of the scheduled query.
9126
+ # @return [Integer]
9127
+ #
9128
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/UpdateScheduledQueryResponse AWS API Documentation
9129
+ #
9130
+ class UpdateScheduledQueryResponse < Struct.new(
9131
+ :scheduled_query_arn,
9132
+ :name,
9133
+ :description,
9134
+ :query_language,
9135
+ :query_string,
9136
+ :log_group_identifiers,
9137
+ :schedule_expression,
9138
+ :timezone,
9139
+ :start_time_offset,
9140
+ :destination_configuration,
9141
+ :state,
9142
+ :last_triggered_time,
9143
+ :last_execution_status,
9144
+ :schedule_start_time,
9145
+ :schedule_end_time,
9146
+ :execution_role_arn,
9147
+ :creation_time,
9148
+ :last_updated_time)
9149
+ SENSITIVE = []
9150
+ include Aws::Structure
9151
+ end
9152
+
8415
9153
  # This processor converts a string field to uppercase.
8416
9154
  #
8417
9155
  # For more information about this processor including examples, see [