/* * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). * You may not use this file except in compliance with the License. * A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either * express or implied. See the License for the specific language governing * permissions and limitations under the License. */ /* * Do not modify this file. This file is generated from the logs-2014-03-28.normal.json service model. */ using System; using System.Threading; using System.Threading.Tasks; using System.Collections.Generic; using Amazon.Runtime; using Amazon.CloudWatchLogs.Model; namespace Amazon.CloudWatchLogs { /// /// Interface for accessing CloudWatchLogs /// /// You can use Amazon CloudWatch Logs to monitor, store, and access your log files from /// EC2 instances, CloudTrail, and other sources. You can then retrieve the associated /// log data from CloudWatch Logs using the CloudWatch console. Alternatively, you can /// use CloudWatch Logs commands in the Amazon Web Services CLI, CloudWatch Logs API, /// or CloudWatch Logs SDK. /// /// /// /// You can use CloudWatch Logs to: /// /// /// public partial interface IAmazonCloudWatchLogs : IAmazonService, IDisposable { #if AWS_ASYNC_ENUMERABLES_API /// /// Paginators for the service /// ICloudWatchLogsPaginatorFactory Paginators { get; } #endif #region AssociateKmsKey /// /// Associates the specified KMS key with either one log group in the account, or with /// all stored CloudWatch Logs query insights results in the account. /// /// /// /// When you use AssociateKmsKey, you specify either the logGroupName /// parameter or the resourceIdentifier parameter. You can't specify both /// of those parameters in the same operation. /// /// /// /// If you delete the key that is used to encrypt log events or log group query results, /// then all the associated stored log events or query results that were encrypted with /// that key will be unencryptable and unusable. /// /// /// /// CloudWatch Logs supports only symmetric KMS keys. Do not use an associate an asymmetric /// KMS key with your log group or query results. For more information, see Using /// Symmetric and Asymmetric Keys. /// /// /// /// It can take up to 5 minutes for this operation to take effect. /// /// /// /// If you attempt to associate a KMS key with a log group but the KMS key does not exist /// or the KMS key is disabled, you receive an InvalidParameterException /// error. /// /// /// Container for the necessary parameters to execute the AssociateKmsKey service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the AssociateKmsKey service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// Multiple concurrent requests to update the same resource were in conflict. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for AssociateKmsKey Operation Task AssociateKmsKeyAsync(AssociateKmsKeyRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region CancelExportTask /// /// Cancels the specified export task. /// /// /// /// The task must be in the PENDING or RUNNING state. /// /// /// Container for the necessary parameters to execute the CancelExportTask service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the CancelExportTask service method, as returned by CloudWatchLogs. /// /// The operation is not valid on the specified resource. /// /// /// A parameter is specified incorrectly. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for CancelExportTask Operation Task CancelExportTaskAsync(CancelExportTaskRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region CreateExportTask /// /// Creates an export task so that you can efficiently export data from a log group to /// an Amazon S3 bucket. When you perform a CreateExportTask operation, you /// must use credentials that have permission to write to the S3 bucket that you specify /// as the destination. /// /// /// /// Exporting log data to S3 buckets that are encrypted by KMS is supported. Exporting /// log data to Amazon S3 buckets that have S3 Object Lock enabled with a retention period /// is also supported. /// /// /// /// Exporting to S3 buckets that are encrypted with AES-256 is supported. /// /// /// /// This is an asynchronous call. If all the required information is provided, this operation /// initiates an export task and responds with the ID of the task. After the task has /// started, you can use DescribeExportTasks /// to get the status of the export task. Each account can only have one active (RUNNING /// or PENDING) export task at a time. To cancel an export task, use CancelExportTask. /// /// /// /// You can export logs from multiple log groups or multiple time ranges to the same S3 /// bucket. To separate log data for each export task, specify a prefix to be used as /// the Amazon S3 key prefix for all exported objects. /// /// /// /// Time-based sorting on chunks of log data inside an exported file is not guaranteed. /// You can sort the exported log field data by using Linux utilities. /// /// /// /// Container for the necessary parameters to execute the CreateExportTask service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the CreateExportTask service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// You have reached the maximum number of resources that can be created. /// /// /// Multiple concurrent requests to update the same resource were in conflict. /// /// /// The specified resource already exists. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for CreateExportTask Operation Task CreateExportTaskAsync(CreateExportTaskRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region CreateLogGroup /// /// Creates a log group with the specified name. You can create up to 20,000 log groups /// per account. /// /// /// /// You must use the following guidelines when naming a log group: /// ///
  • /// /// Log group names must be unique within a Region for an Amazon Web Services account. /// ///
  • /// /// Log group names can be between 1 and 512 characters long. /// ///
  • /// /// Log group names consist of the following characters: a-z, A-Z, 0-9, '_' (underscore), /// '-' (hyphen), '/' (forward slash), '.' (period), and '#' (number sign) /// ///
/// /// When you create a log group, by default the log events in the log group do not expire. /// To set a retention policy so that events expire and are deleted after a specified /// time, use PutRetentionPolicy. /// /// /// /// If you associate an KMS key with the log group, ingested data is encrypted using the /// KMS key. This association is stored as long as the data encrypted with the KMS key /// is still within CloudWatch Logs. This enables CloudWatch Logs to decrypt this data /// whenever it is requested. /// /// /// /// If you attempt to associate a KMS key with the log group but the KMS key does not /// exist or the KMS key is disabled, you receive an InvalidParameterException /// error. /// /// /// /// CloudWatch Logs supports only symmetric KMS keys. Do not associate an asymmetric KMS /// key with your log group. For more information, see Using /// Symmetric and Asymmetric Keys. /// /// /// /// Container for the necessary parameters to execute the CreateLogGroup service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the CreateLogGroup service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// You have reached the maximum number of resources that can be created. /// /// /// Multiple concurrent requests to update the same resource were in conflict. /// /// /// The specified resource already exists. /// /// /// The service cannot complete the request. /// /// REST API Reference for CreateLogGroup Operation Task CreateLogGroupAsync(CreateLogGroupRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region CreateLogStream /// /// Creates a log stream for the specified log group. A log stream is a sequence of log /// events that originate from a single source, such as an application instance or a resource /// that is being monitored. /// /// /// /// There is no limit on the number of log streams that you can create for a log group. /// There is a limit of 50 TPS on CreateLogStream operations, after which /// transactions are throttled. /// /// /// /// You must use the following guidelines when naming a log stream: /// ///
  • /// /// Log stream names must be unique within the log group. /// ///
  • /// /// Log stream names can be between 1 and 512 characters long. /// ///
  • /// /// Don't use ':' (colon) or '*' (asterisk) characters. /// ///
/// /// Container for the necessary parameters to execute the CreateLogStream service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the CreateLogStream service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// The specified resource already exists. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for CreateLogStream Operation Task CreateLogStreamAsync(CreateLogStreamRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DeleteAccountPolicy /// /// Deletes a CloudWatch Logs account policy. /// /// /// /// To use this operation, you must be signed on with the logs:DeleteDataProtectionPolicy /// and logs:DeleteAccountPolicy permissions. /// /// /// Container for the necessary parameters to execute the DeleteAccountPolicy service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DeleteAccountPolicy service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// Multiple concurrent requests to update the same resource were in conflict. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for DeleteAccountPolicy Operation Task DeleteAccountPolicyAsync(DeleteAccountPolicyRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DeleteDataProtectionPolicy /// /// Deletes the data protection policy from the specified log group. /// /// /// /// For more information about data protection policies, see PutDataProtectionPolicy. /// /// /// Container for the necessary parameters to execute the DeleteDataProtectionPolicy service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DeleteDataProtectionPolicy service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// Multiple concurrent requests to update the same resource were in conflict. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for DeleteDataProtectionPolicy Operation Task DeleteDataProtectionPolicyAsync(DeleteDataProtectionPolicyRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DeleteDestination /// /// Deletes the specified destination, and eventually disables all the subscription filters /// that publish to it. This operation does not delete the physical resource encapsulated /// by the destination. /// /// Container for the necessary parameters to execute the DeleteDestination service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DeleteDestination service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// Multiple concurrent requests to update the same resource were in conflict. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for DeleteDestination Operation Task DeleteDestinationAsync(DeleteDestinationRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DeleteLogGroup /// /// Deletes the specified log group and permanently deletes all the archived log events /// associated with the log group. /// /// Container for the necessary parameters to execute the DeleteLogGroup service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DeleteLogGroup service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// Multiple concurrent requests to update the same resource were in conflict. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for DeleteLogGroup Operation Task DeleteLogGroupAsync(DeleteLogGroupRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DeleteLogStream /// /// Deletes the specified log stream and permanently deletes all the archived log events /// associated with the log stream. /// /// Container for the necessary parameters to execute the DeleteLogStream service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DeleteLogStream service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// Multiple concurrent requests to update the same resource were in conflict. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for DeleteLogStream Operation Task DeleteLogStreamAsync(DeleteLogStreamRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DeleteMetricFilter /// /// Deletes the specified metric filter. /// /// Container for the necessary parameters to execute the DeleteMetricFilter service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DeleteMetricFilter service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// Multiple concurrent requests to update the same resource were in conflict. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for DeleteMetricFilter Operation Task DeleteMetricFilterAsync(DeleteMetricFilterRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DeleteQueryDefinition /// /// Deletes a saved CloudWatch Logs Insights query definition. A query definition contains /// details about a saved CloudWatch Logs Insights query. /// /// /// /// Each DeleteQueryDefinition operation can delete one query definition. /// /// /// /// You must have the logs:DeleteQueryDefinition permission to be able to /// perform this operation. /// /// /// Container for the necessary parameters to execute the DeleteQueryDefinition service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DeleteQueryDefinition service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for DeleteQueryDefinition Operation Task DeleteQueryDefinitionAsync(DeleteQueryDefinitionRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DeleteResourcePolicy /// /// Deletes a resource policy from this account. This revokes the access of the identities /// in that policy to put log events to this account. /// /// Container for the necessary parameters to execute the DeleteResourcePolicy service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DeleteResourcePolicy service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for DeleteResourcePolicy Operation Task DeleteResourcePolicyAsync(DeleteResourcePolicyRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DeleteRetentionPolicy /// /// Deletes the specified retention policy. /// /// /// /// Log events do not expire if they belong to log groups without a retention policy. /// /// /// Container for the necessary parameters to execute the DeleteRetentionPolicy service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DeleteRetentionPolicy service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// Multiple concurrent requests to update the same resource were in conflict. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for DeleteRetentionPolicy Operation Task DeleteRetentionPolicyAsync(DeleteRetentionPolicyRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DeleteSubscriptionFilter /// /// Deletes the specified subscription filter. /// /// Container for the necessary parameters to execute the DeleteSubscriptionFilter service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DeleteSubscriptionFilter service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// Multiple concurrent requests to update the same resource were in conflict. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for DeleteSubscriptionFilter Operation Task DeleteSubscriptionFilterAsync(DeleteSubscriptionFilterRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DescribeAccountPolicies /// /// Returns a list of all CloudWatch Logs account policies in the account. /// /// Container for the necessary parameters to execute the DescribeAccountPolicies service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DescribeAccountPolicies service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// Multiple concurrent requests to update the same resource were in conflict. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for DescribeAccountPolicies Operation Task DescribeAccountPoliciesAsync(DescribeAccountPoliciesRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DescribeDestinations /// /// Lists all your destinations. The results are ASCII-sorted by destination name. /// /// Container for the necessary parameters to execute the DescribeDestinations service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DescribeDestinations service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// The service cannot complete the request. /// /// REST API Reference for DescribeDestinations Operation Task DescribeDestinationsAsync(DescribeDestinationsRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DescribeExportTasks /// /// Lists the specified export tasks. You can list all your export tasks or filter the /// results based on task ID or task status. /// /// Container for the necessary parameters to execute the DescribeExportTasks service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DescribeExportTasks service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// The service cannot complete the request. /// /// REST API Reference for DescribeExportTasks Operation Task DescribeExportTasksAsync(DescribeExportTasksRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DescribeLogGroups /// /// Lists the specified log groups. You can list all your log groups or filter the results /// by prefix. The results are ASCII-sorted by log group name. /// /// /// /// CloudWatch Logs doesn’t support IAM policies that control access to the DescribeLogGroups /// action by using the aws:ResourceTag/key-name condition key. Other /// CloudWatch Logs actions do support the use of the aws:ResourceTag/key-name /// condition key to control access. For more information about using tags to /// control access, see Controlling /// access to Amazon Web Services resources using tags. /// /// /// /// If you are using CloudWatch cross-account observability, you can use this operation /// in a monitoring account and view data from the linked source accounts. For more information, /// see CloudWatch /// cross-account observability. /// /// /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DescribeLogGroups service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// The service cannot complete the request. /// /// REST API Reference for DescribeLogGroups Operation Task DescribeLogGroupsAsync(System.Threading.CancellationToken cancellationToken = default(CancellationToken)); /// /// Lists the specified log groups. You can list all your log groups or filter the results /// by prefix. The results are ASCII-sorted by log group name. /// /// /// /// CloudWatch Logs doesn’t support IAM policies that control access to the DescribeLogGroups /// action by using the aws:ResourceTag/key-name condition key. Other /// CloudWatch Logs actions do support the use of the aws:ResourceTag/key-name /// condition key to control access. For more information about using tags to /// control access, see Controlling /// access to Amazon Web Services resources using tags. /// /// /// /// If you are using CloudWatch cross-account observability, you can use this operation /// in a monitoring account and view data from the linked source accounts. For more information, /// see CloudWatch /// cross-account observability. /// /// /// Container for the necessary parameters to execute the DescribeLogGroups service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DescribeLogGroups service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// The service cannot complete the request. /// /// REST API Reference for DescribeLogGroups Operation Task DescribeLogGroupsAsync(DescribeLogGroupsRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DescribeLogStreams /// /// Lists the log streams for the specified log group. You can list all the log streams /// or filter the results by prefix. You can also control how the results are ordered. /// /// /// /// You can specify the log group to search by using either logGroupIdentifier /// or logGroupName. You must include one of these two parameters, but you /// can't include both. /// /// /// /// This operation has a limit of five transactions per second, after which transactions /// are throttled. /// /// /// /// If you are using CloudWatch cross-account observability, you can use this operation /// in a monitoring account and view data from the linked source accounts. For more information, /// see CloudWatch /// cross-account observability. /// /// /// Container for the necessary parameters to execute the DescribeLogStreams service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DescribeLogStreams service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for DescribeLogStreams Operation Task DescribeLogStreamsAsync(DescribeLogStreamsRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DescribeMetricFilters /// /// Lists the specified metric filters. You can list all of the metric filters or filter /// the results by log name, prefix, metric name, or metric namespace. The results are /// ASCII-sorted by filter name. /// /// Container for the necessary parameters to execute the DescribeMetricFilters service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DescribeMetricFilters service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for DescribeMetricFilters Operation Task DescribeMetricFiltersAsync(DescribeMetricFiltersRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DescribeQueries /// /// Returns a list of CloudWatch Logs Insights queries that are scheduled, running, or /// have been run recently in this account. You can request all queries or limit it to /// queries of a specific log group or queries with a certain status. /// /// Container for the necessary parameters to execute the DescribeQueries service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DescribeQueries service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for DescribeQueries Operation Task DescribeQueriesAsync(DescribeQueriesRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DescribeQueryDefinitions /// /// This operation returns a paginated list of your saved CloudWatch Logs Insights query /// definitions. /// /// /// /// You can use the queryDefinitionNamePrefix parameter to limit the results /// to only the query definitions that have names that start with a certain string. /// /// /// Container for the necessary parameters to execute the DescribeQueryDefinitions service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DescribeQueryDefinitions service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// The service cannot complete the request. /// /// REST API Reference for DescribeQueryDefinitions Operation Task DescribeQueryDefinitionsAsync(DescribeQueryDefinitionsRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DescribeResourcePolicies /// /// Lists the resource policies in this account. /// /// Container for the necessary parameters to execute the DescribeResourcePolicies service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DescribeResourcePolicies service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// The service cannot complete the request. /// /// REST API Reference for DescribeResourcePolicies Operation Task DescribeResourcePoliciesAsync(DescribeResourcePoliciesRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DescribeSubscriptionFilters /// /// Lists the subscription filters for the specified log group. You can list all the subscription /// filters or filter the results by prefix. The results are ASCII-sorted by filter name. /// /// Container for the necessary parameters to execute the DescribeSubscriptionFilters service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DescribeSubscriptionFilters service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for DescribeSubscriptionFilters Operation Task DescribeSubscriptionFiltersAsync(DescribeSubscriptionFiltersRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region DisassociateKmsKey /// /// Disassociates the specified KMS key from the specified log group or from all CloudWatch /// Logs Insights query results in the account. /// /// /// /// When you use DisassociateKmsKey, you specify either the logGroupName /// parameter or the resourceIdentifier parameter. You can't specify both /// of those parameters in the same operation. /// ///
  • /// /// Specify the logGroupName parameter to stop using the KMS key to encrypt /// future log events ingested and stored in the log group. Instead, they will be encrypted /// with the default CloudWatch Logs method. The log events that were ingested while the /// key was associated with the log group are still encrypted with that key. Therefore, /// CloudWatch Logs will need permissions for the key whenever that data is accessed. /// ///
  • /// /// Specify the resourceIdentifier parameter with the query-result /// resource to stop using the KMS key to encrypt the results of all future StartQuery /// operations in the account. They will instead be encrypted with the default CloudWatch /// Logs method. The results from queries that ran while the key was associated with the /// account are still encrypted with that key. Therefore, CloudWatch Logs will need permissions /// for the key whenever that data is accessed. /// ///
/// /// It can take up to 5 minutes for this operation to take effect. /// /// /// Container for the necessary parameters to execute the DisassociateKmsKey service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the DisassociateKmsKey service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// Multiple concurrent requests to update the same resource were in conflict. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for DisassociateKmsKey Operation Task DisassociateKmsKeyAsync(DisassociateKmsKeyRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region FilterLogEvents /// /// Lists log events from the specified log group. You can list all the log events or /// filter the results using a filter pattern, a time range, and the name of the log stream. /// /// /// /// You must have the logs:FilterLogEvents permission to perform this operation. /// /// /// /// You can specify the log group to search by using either logGroupIdentifier /// or logGroupName. You must include one of these two parameters, but you /// can't include both. /// /// /// /// By default, this operation returns as many log events as can fit in 1 MB (up to 10,000 /// log events) or all the events found within the specified time range. If the results /// include a token, that means there are more log events available. You can get additional /// results by specifying the token in a subsequent call. This operation can return empty /// results while there are more log events available through the token. /// /// /// /// The returned log events are sorted by event timestamp, the timestamp when the event /// was ingested by CloudWatch Logs, and the ID of the PutLogEvents request. /// /// /// /// If you are using CloudWatch cross-account observability, you can use this operation /// in a monitoring account and view data from the linked source accounts. For more information, /// see CloudWatch /// cross-account observability. /// /// /// Container for the necessary parameters to execute the FilterLogEvents service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the FilterLogEvents service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for FilterLogEvents Operation Task FilterLogEventsAsync(FilterLogEventsRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetDataProtectionPolicy /// /// Returns information about a log group data protection policy. /// /// Container for the necessary parameters to execute the GetDataProtectionPolicy service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetDataProtectionPolicy service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// Multiple concurrent requests to update the same resource were in conflict. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for GetDataProtectionPolicy Operation Task GetDataProtectionPolicyAsync(GetDataProtectionPolicyRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetLogEvents /// /// Lists log events from the specified log stream. You can list all of the log events /// or filter using a time range. /// /// /// /// By default, this operation returns as many log events as can fit in a response size /// of 1MB (up to 10,000 log events). You can get additional log events by specifying /// one of the tokens in a subsequent call. This operation can return empty results while /// there are more log events available through the token. /// /// /// /// If you are using CloudWatch cross-account observability, you can use this operation /// in a monitoring account and view data from the linked source accounts. For more information, /// see CloudWatch /// cross-account observability. /// /// /// /// You can specify the log group to search by using either logGroupIdentifier /// or logGroupName. You must include one of these two parameters, but you /// can't include both. /// /// /// Container for the necessary parameters to execute the GetLogEvents service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetLogEvents service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for GetLogEvents Operation Task GetLogEventsAsync(GetLogEventsRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetLogGroupFields /// /// Returns a list of the fields that are included in log events in the specified log /// group. Includes the percentage of log events that contain each field. The search is /// limited to a time period that you specify. /// /// /// /// You can specify the log group to search by using either logGroupIdentifier /// or logGroupName. You must specify one of these parameters, but you can't /// specify both. /// /// /// /// In the results, fields that start with @ are fields generated by CloudWatch /// Logs. For example, @timestamp is the timestamp of each log event. For /// more information about the fields that are generated by CloudWatch logs, see Supported /// Logs and Discovered Fields. /// /// /// /// The response results are sorted by the frequency percentage, starting with the highest /// percentage. /// /// /// /// If you are using CloudWatch cross-account observability, you can use this operation /// in a monitoring account and view data from the linked source accounts. For more information, /// see CloudWatch /// cross-account observability. /// /// /// Container for the necessary parameters to execute the GetLogGroupFields service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetLogGroupFields service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// You have reached the maximum number of resources that can be created. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for GetLogGroupFields Operation Task GetLogGroupFieldsAsync(GetLogGroupFieldsRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetLogRecord /// /// Retrieves all of the fields and values of a single log event. All fields are retrieved, /// even if the original query that produced the logRecordPointer retrieved /// only a subset of fields. Fields are returned as field name/field value pairs. /// /// /// /// The full unparsed log event is returned within @message. /// /// /// Container for the necessary parameters to execute the GetLogRecord service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetLogRecord service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// You have reached the maximum number of resources that can be created. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for GetLogRecord Operation Task GetLogRecordAsync(GetLogRecordRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region GetQueryResults /// /// Returns the results from the specified query. /// /// /// /// Only the fields requested in the query are returned, along with a @ptr /// field, which is the identifier for the log record. You can use the value of @ptr /// in a GetLogRecord /// operation to get the full log record. /// /// /// /// GetQueryResults does not start running a query. To run a query, use /// StartQuery. /// /// /// /// If the value of the Status field in the output is Running, /// this operation returns only partial results. If you see a value of Scheduled /// or Running for the status, you can retry the operation later to see the /// final results. /// /// /// /// If you are using CloudWatch cross-account observability, you can use this operation /// in a monitoring account to start queries in linked source accounts. For more information, /// see CloudWatch /// cross-account observability. /// /// /// Container for the necessary parameters to execute the GetQueryResults service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the GetQueryResults service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for GetQueryResults Operation Task GetQueryResultsAsync(GetQueryResultsRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region ListTagsForResource /// /// Displays the tags associated with a CloudWatch Logs resource. Currently, log groups /// and destinations support tagging. /// /// Container for the necessary parameters to execute the ListTagsForResource service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the ListTagsForResource service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for ListTagsForResource Operation Task ListTagsForResourceAsync(ListTagsForResourceRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region ListTagsLogGroup /// /// /// /// The ListTagsLogGroup operation is on the path to deprecation. We recommend that you /// use ListTagsForResource /// instead. /// /// /// /// Lists the tags for the specified log group. /// /// /// Container for the necessary parameters to execute the ListTagsLogGroup service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the ListTagsLogGroup service method, as returned by CloudWatchLogs. /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for ListTagsLogGroup Operation [Obsolete("Please use the generic tagging API ListTagsForResource")] Task ListTagsLogGroupAsync(ListTagsLogGroupRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region PutAccountPolicy /// /// Creates an account-level data protection policy that applies to all log groups in /// the account. A data protection policy can help safeguard sensitive data that's ingested /// by your log groups by auditing and masking the sensitive log data. Each account can /// have only one account-level policy. /// /// /// /// Sensitive data is detected and masked when it is ingested into a log group. When you /// set a data protection policy, log events ingested into the log groups before that /// time are not masked. /// /// /// /// If you use PutAccountPolicy to create a data protection policy for your /// whole account, it applies to both existing log groups and all log groups that are /// created later in this account. The account policy is applied to existing log groups /// with eventual consistency. It might take up to 5 minutes before sensitive data in /// existing log groups begins to be masked. /// /// /// /// By default, when a user views a log event that includes masked data, the sensitive /// data is replaced by asterisks. A user who has the logs:Unmask permission /// can use a GetLogEvents /// or FilterLogEvents /// operation with the unmask parameter set to true to view /// the unmasked log events. Users with the logs:Unmask can also view unmasked /// data in the CloudWatch Logs console by running a CloudWatch Logs Insights query with /// the unmask query command. /// /// /// /// For more information, including a list of types of data that can be audited and masked, /// see Protect /// sensitive log data with masking. /// /// /// /// To use the PutAccountPolicy operation, you must be signed on with the /// logs:PutDataProtectionPolicy and logs:PutAccountPolicy permissions. /// /// /// /// The PutAccountPolicy operation applies to all log groups in the account. /// You can also use PutDataProtectionPolicy /// to create a data protection policy that applies to just one log group. If a log group /// has its own data protection policy and the account also has an account-level data /// protection policy, then the two policies are cumulative. Any sensitive term specified /// in either policy is masked. /// /// /// Container for the necessary parameters to execute the PutAccountPolicy service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the PutAccountPolicy service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// You have reached the maximum number of resources that can be created. /// /// /// Multiple concurrent requests to update the same resource were in conflict. /// /// /// The service cannot complete the request. /// /// REST API Reference for PutAccountPolicy Operation Task PutAccountPolicyAsync(PutAccountPolicyRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region PutDataProtectionPolicy /// /// Creates a data protection policy for the specified log group. A data protection policy /// can help safeguard sensitive data that's ingested by the log group by auditing and /// masking the sensitive log data. /// /// /// /// Sensitive data is detected and masked when it is ingested into the log group. When /// you set a data protection policy, log events ingested into the log group before that /// time are not masked. /// /// /// /// By default, when a user views a log event that includes masked data, the sensitive /// data is replaced by asterisks. A user who has the logs:Unmask permission /// can use a GetLogEvents /// or FilterLogEvents /// operation with the unmask parameter set to true to view /// the unmasked log events. Users with the logs:Unmask can also view unmasked /// data in the CloudWatch Logs console by running a CloudWatch Logs Insights query with /// the unmask query command. /// /// /// /// For more information, including a list of types of data that can be audited and masked, /// see Protect /// sensitive log data with masking. /// /// /// /// The PutDataProtectionPolicy operation applies to only the specified log /// group. You can also use PutAccountPolicy /// to create an account-level data protection policy that applies to all log groups in /// the account, including both existing log groups and log groups that are created level. /// If a log group has its own data protection policy and the account also has an account-level /// data protection policy, then the two policies are cumulative. Any sensitive term specified /// in either policy is masked. /// /// /// Container for the necessary parameters to execute the PutDataProtectionPolicy service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the PutDataProtectionPolicy service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// You have reached the maximum number of resources that can be created. /// /// /// Multiple concurrent requests to update the same resource were in conflict. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for PutDataProtectionPolicy Operation Task PutDataProtectionPolicyAsync(PutDataProtectionPolicyRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region PutDestination /// /// Creates or updates a destination. This operation is used only to create destinations /// for cross-account subscriptions. /// /// /// /// A destination encapsulates a physical resource (such as an Amazon Kinesis stream). /// With a destination, you can subscribe to a real-time stream of log events for a different /// account, ingested using PutLogEvents. /// /// /// /// Through an access policy, a destination controls what is written to it. By default, /// PutDestination does not set any access policy with the destination, which /// means a cross-account user cannot call PutSubscriptionFilter /// against this destination. To enable this, the destination owner must call PutDestinationPolicy /// after PutDestination. /// /// /// /// To perform a PutDestination operation, you must also have the iam:PassRole /// permission. /// /// /// Container for the necessary parameters to execute the PutDestination service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the PutDestination service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// Multiple concurrent requests to update the same resource were in conflict. /// /// /// The service cannot complete the request. /// /// REST API Reference for PutDestination Operation Task PutDestinationAsync(PutDestinationRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region PutDestinationPolicy /// /// Creates or updates an access policy associated with an existing destination. An access /// policy is an IAM /// policy document that is used to authorize claims to register a subscription filter /// against a given destination. /// /// Container for the necessary parameters to execute the PutDestinationPolicy service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the PutDestinationPolicy service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// Multiple concurrent requests to update the same resource were in conflict. /// /// /// The service cannot complete the request. /// /// REST API Reference for PutDestinationPolicy Operation Task PutDestinationPolicyAsync(PutDestinationPolicyRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region PutLogEvents /// /// Uploads a batch of log events to the specified log stream. /// /// /// /// The sequence token is now ignored in PutLogEvents actions. PutLogEvents /// actions are always accepted and never return InvalidSequenceTokenException /// or DataAlreadyAcceptedException even if the sequence token is not valid. /// You can use parallel PutLogEvents actions on the same log stream. /// /// /// /// The batch of events must satisfy the following constraints: /// ///
  • /// /// The maximum batch size is 1,048,576 bytes. This size is calculated as the sum of all /// event messages in UTF-8, plus 26 bytes for each log event. /// ///
  • /// /// None of the log events in the batch can be more than 2 hours in the future. /// ///
  • /// /// None of the log events in the batch can be more than 14 days in the past. Also, none /// of the log events can be from earlier than the retention period of the log group. /// ///
  • /// /// The log events in the batch must be in chronological order by their timestamp. The /// timestamp is the time that the event occurred, expressed as the number of milliseconds /// after Jan 1, 1970 00:00:00 UTC. (In Amazon Web Services Tools for PowerShell /// and the Amazon Web Services SDK for .NET, the timestamp is specified in .NET format: /// yyyy-mm-ddThh:mm:ss. For example, 2017-09-15T13:45:30.) /// /// ///
  • /// /// A batch of log events in a single request cannot span more than 24 hours. Otherwise, /// the operation fails. /// ///
  • /// /// Each log event can be no larger than 256 KB. /// ///
  • /// /// The maximum number of log events in a batch is 10,000. /// ///
  • /// /// The quota of five requests per second per log stream has been removed. Instead, PutLogEvents /// actions are throttled based on a per-second per-account quota. You can request an /// increase to the per-second throttling quota by using the Service Quotas service. /// ///
/// /// If a call to PutLogEvents returns "UnrecognizedClientException" the most /// likely cause is a non-valid Amazon Web Services access key ID or secret key. /// /// /// Container for the necessary parameters to execute the PutLogEvents service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the PutLogEvents service method, as returned by CloudWatchLogs. /// /// The event was already logged. /// /// /// /// PutLogEvents actions are now always accepted and never return DataAlreadyAcceptedException /// regardless of whether a given batch of log events has already been accepted. /// /// /// /// /// A parameter is specified incorrectly. /// /// /// The sequence token is not valid. You can get the correct sequence token in the expectedSequenceToken /// field in the InvalidSequenceTokenException message. /// /// /// /// PutLogEvents actions are now always accepted and never return InvalidSequenceTokenException /// regardless of receiving an invalid sequence token. /// /// /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// /// The most likely cause is an Amazon Web Services access key ID or secret key that's /// not valid. /// /// REST API Reference for PutLogEvents Operation Task PutLogEventsAsync(PutLogEventsRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region PutMetricFilter /// /// Creates or updates a metric filter and associates it with the specified log group. /// With metric filters, you can configure rules to extract metric data from log events /// ingested through PutLogEvents. /// /// /// /// The maximum number of metric filters that can be associated with a log group is 100. /// /// /// /// When you create a metric filter, you can also optionally assign a unit and dimensions /// to the metric that is created. /// /// /// /// Metrics extracted from log events are charged as custom metrics. To prevent unexpected /// high charges, do not specify high-cardinality fields such as IPAddress /// or requestID as dimensions. Each different value found for a dimension /// is treated as a separate metric and accrues charges as a separate custom metric. /// /// /// /// CloudWatch Logs disables a metric filter if it generates 1,000 different name/value /// pairs for your specified dimensions within a certain amount of time. This helps to /// prevent accidental high charges. /// /// /// /// You can also set up a billing alarm to alert you if your charges are higher than expected. /// For more information, see /// Creating a Billing Alarm to Monitor Your Estimated Amazon Web Services Charges. /// /// /// /// /// Container for the necessary parameters to execute the PutMetricFilter service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the PutMetricFilter service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// You have reached the maximum number of resources that can be created. /// /// /// Multiple concurrent requests to update the same resource were in conflict. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for PutMetricFilter Operation Task PutMetricFilterAsync(PutMetricFilterRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region PutQueryDefinition /// /// Creates or updates a query definition for CloudWatch Logs Insights. For more information, /// see Analyzing /// Log Data with CloudWatch Logs Insights. /// /// /// /// To update a query definition, specify its queryDefinitionId in your request. /// The values of name, queryString, and logGroupNames /// are changed to the values that you specify in your update operation. No current values /// are retained from the current query definition. For example, imagine updating a current /// query definition that includes log groups. If you don't specify the logGroupNames /// parameter in your update operation, the query definition changes to contain no log /// groups. /// /// /// /// You must have the logs:PutQueryDefinition permission to be able to perform /// this operation. /// /// /// Container for the necessary parameters to execute the PutQueryDefinition service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the PutQueryDefinition service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// You have reached the maximum number of resources that can be created. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for PutQueryDefinition Operation Task PutQueryDefinitionAsync(PutQueryDefinitionRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region PutResourcePolicy /// /// Creates or updates a resource policy allowing other Amazon Web Services services to /// put log events to this account, such as Amazon Route 53. An account can have up to /// 10 resource policies per Amazon Web Services Region. /// /// Container for the necessary parameters to execute the PutResourcePolicy service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the PutResourcePolicy service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// You have reached the maximum number of resources that can be created. /// /// /// The service cannot complete the request. /// /// REST API Reference for PutResourcePolicy Operation Task PutResourcePolicyAsync(PutResourcePolicyRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region PutRetentionPolicy /// /// Sets the retention of the specified log group. With a retention policy, you can configure /// the number of days for which to retain log events in the specified log group. /// /// /// /// CloudWatch Logs doesn’t immediately delete log events when they reach their retention /// setting. It typically takes up to 72 hours after that before log events are deleted, /// but in rare situations might take longer. /// /// /// /// To illustrate, imagine that you change a log group to have a longer retention setting /// when it contains log events that are past the expiration date, but haven’t been deleted. /// Those log events will take up to 72 hours to be deleted after the new retention date /// is reached. To make sure that log data is deleted permanently, keep a log group at /// its lower retention setting until 72 hours after the previous retention period ends. /// Alternatively, wait to change the retention setting until you confirm that the earlier /// log events are deleted. /// /// /// /// Container for the necessary parameters to execute the PutRetentionPolicy service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the PutRetentionPolicy service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// Multiple concurrent requests to update the same resource were in conflict. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for PutRetentionPolicy Operation Task PutRetentionPolicyAsync(PutRetentionPolicyRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region PutSubscriptionFilter /// /// Creates or updates a subscription filter and associates it with the specified log /// group. With subscription filters, you can subscribe to a real-time stream of log events /// ingested through PutLogEvents /// and have them delivered to a specific destination. When log events are sent to the /// receiving service, they are Base64 encoded and compressed with the GZIP format. /// /// /// /// The following destinations are supported for subscription filters: /// ///
  • /// /// An Amazon Kinesis data stream belonging to the same account as the subscription filter, /// for same-account delivery. /// ///
  • /// /// A logical destination created with PutDestination /// that belongs to a different account, for cross-account delivery. We currently support /// Kinesis Data Streams and Kinesis Data Firehose as logical destinations. /// ///
  • /// /// An Amazon Kinesis Data Firehose delivery stream that belongs to the same account as /// the subscription filter, for same-account delivery. /// ///
  • /// /// An Lambda function that belongs to the same account as the subscription filter, for /// same-account delivery. /// ///
/// /// Each log group can have up to two subscription filters associated with it. If you /// are updating an existing filter, you must specify the correct name in filterName. /// /// /// /// /// To perform a PutSubscriptionFilter operation for any destination except /// a Lambda function, you must also have the iam:PassRole permission. /// /// /// Container for the necessary parameters to execute the PutSubscriptionFilter service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the PutSubscriptionFilter service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// You have reached the maximum number of resources that can be created. /// /// /// Multiple concurrent requests to update the same resource were in conflict. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for PutSubscriptionFilter Operation Task PutSubscriptionFilterAsync(PutSubscriptionFilterRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region StartQuery /// /// Schedules a query of a log group using CloudWatch Logs Insights. You specify the log /// group and time range to query and the query string to use. /// /// /// /// For more information, see CloudWatch /// Logs Insights Query Syntax. /// /// /// /// After you run a query using StartQuery, the query results are stored /// by CloudWatch Logs. You can use GetQueryResults /// to retrieve the results of a query, using the queryId that StartQuery /// returns. /// /// /// /// If you have associated a KMS key with the query results in this account, then StartQuery /// uses that key to encrypt the results when it stores them. If no key is associated /// with query results, the query results are encrypted with the default CloudWatch Logs /// encryption method. /// /// /// /// Queries time out after 60 minutes of runtime. If your queries are timing out, reduce /// the time range being searched or partition your query into a number of queries. /// /// /// /// If you are using CloudWatch cross-account observability, you can use this operation /// in a monitoring account to start a query in a linked source account. For more information, /// see CloudWatch /// cross-account observability. For a cross-account StartQuery operation, /// the query definition must be defined in the monitoring account. /// /// /// /// You can have up to 30 concurrent CloudWatch Logs insights queries, including queries /// that have been added to dashboards. /// /// /// Container for the necessary parameters to execute the StartQuery service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the StartQuery service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// You have reached the maximum number of resources that can be created. /// /// /// The query string is not valid. Details about this error are displayed in a QueryCompileError /// object. For more information, see QueryCompileError. /// /// /// /// For more information about valid query syntax, see CloudWatch /// Logs Insights Query Syntax. /// /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for StartQuery Operation Task StartQueryAsync(StartQueryRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region StopQuery /// /// Stops a CloudWatch Logs Insights query that is in progress. If the query has already /// ended, the operation returns an error indicating that the specified query is not running. /// /// Container for the necessary parameters to execute the StopQuery service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the StopQuery service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for StopQuery Operation Task StopQueryAsync(StopQueryRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region TagLogGroup /// /// /// /// The TagLogGroup operation is on the path to deprecation. We recommend that you use /// TagResource /// instead. /// /// /// /// Adds or updates the specified tags for the specified log group. /// /// /// /// To list the tags for a log group, use ListTagsForResource. /// To remove tags, use UntagResource. /// /// /// /// For more information about tags, see Tag /// Log Groups in Amazon CloudWatch Logs in the Amazon CloudWatch Logs User Guide. /// /// /// /// CloudWatch Logs doesn’t support IAM policies that prevent users from assigning specified /// tags to log groups using the aws:Resource/key-name or aws:TagKeys /// condition keys. For more information about using tags to control access, see Controlling /// access to Amazon Web Services resources using tags. /// /// /// Container for the necessary parameters to execute the TagLogGroup service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the TagLogGroup service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// The specified resource does not exist. /// /// REST API Reference for TagLogGroup Operation [Obsolete("Please use the generic tagging API TagResource")] Task TagLogGroupAsync(TagLogGroupRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region TagResource /// /// Assigns one or more tags (key-value pairs) to the specified CloudWatch Logs resource. /// Currently, the only CloudWatch Logs resources that can be tagged are log groups and /// destinations. /// /// /// /// Tags can help you organize and categorize your resources. You can also use them to /// scope user permissions by granting a user permission to access or change only resources /// with certain tag values. /// /// /// /// Tags don't have any semantic meaning to Amazon Web Services and are interpreted strictly /// as strings of characters. /// /// /// /// You can use the TagResource action with a resource that already has tags. /// If you specify a new tag key for the alarm, this tag is appended to the list of tags /// associated with the alarm. If you specify a tag key that is already associated with /// the alarm, the new tag value that you specify replaces the previous value for that /// tag. /// /// /// /// You can associate as many as 50 tags with a CloudWatch Logs resource. /// /// /// Container for the necessary parameters to execute the TagResource service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the TagResource service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// /// A resource can have no more than 50 tags. /// /// REST API Reference for TagResource Operation Task TagResourceAsync(TagResourceRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region TestMetricFilter /// /// Tests the filter pattern of a metric filter against a sample of log event messages. /// You can use this operation to validate the correctness of a metric filter pattern. /// /// Container for the necessary parameters to execute the TestMetricFilter service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the TestMetricFilter service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// The service cannot complete the request. /// /// REST API Reference for TestMetricFilter Operation Task TestMetricFilterAsync(TestMetricFilterRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region UntagLogGroup /// /// /// /// The UntagLogGroup operation is on the path to deprecation. We recommend that you use /// UntagResource /// instead. /// /// /// /// Removes the specified tags from the specified log group. /// /// /// /// To list the tags for a log group, use ListTagsForResource. /// To add tags, use TagResource. /// /// /// /// CloudWatch Logs doesn’t support IAM policies that prevent users from assigning specified /// tags to log groups using the aws:Resource/key-name or aws:TagKeys /// condition keys. /// /// /// Container for the necessary parameters to execute the UntagLogGroup service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the UntagLogGroup service method, as returned by CloudWatchLogs. /// /// The specified resource does not exist. /// /// REST API Reference for UntagLogGroup Operation [Obsolete("Please use the generic tagging API UntagResource")] Task UntagLogGroupAsync(UntagLogGroupRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion #region UntagResource /// /// Removes one or more tags from the specified resource. /// /// Container for the necessary parameters to execute the UntagResource service method. /// /// A cancellation token that can be used by other objects or threads to receive notice of cancellation. /// /// /// The response from the UntagResource service method, as returned by CloudWatchLogs. /// /// A parameter is specified incorrectly. /// /// /// The specified resource does not exist. /// /// /// The service cannot complete the request. /// /// REST API Reference for UntagResource Operation Task UntagResourceAsync(UntagResourceRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)); #endregion } }