/* * 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.Runtime.ExceptionServices; using System.Threading; using System.Threading.Tasks; using System.Collections.Generic; using System.Net; using Amazon.CloudWatchLogs.Model; using Amazon.CloudWatchLogs.Model.Internal.MarshallTransformations; using Amazon.CloudWatchLogs.Internal; using Amazon.Runtime; using Amazon.Runtime.Internal; using Amazon.Runtime.Internal.Auth; using Amazon.Runtime.Internal.Transform; namespace Amazon.CloudWatchLogs { /// /// Implementation 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 class AmazonCloudWatchLogsClient : AmazonServiceClient, IAmazonCloudWatchLogs { private static IServiceMetadata serviceMetadata = new AmazonCloudWatchLogsMetadata(); #region Constructors /// /// Constructs AmazonCloudWatchLogsClient with the credentials loaded from the application's /// default configuration, and if unsuccessful from the Instance Profile service on an EC2 instance. /// /// Example App.config with credentials set. /// /// <?xml version="1.0" encoding="utf-8" ?> /// <configuration> /// <appSettings> /// <add key="AWSProfileName" value="AWS Default"/> /// </appSettings> /// </configuration> /// /// /// public AmazonCloudWatchLogsClient() : base(FallbackCredentialsFactory.GetCredentials(), new AmazonCloudWatchLogsConfig()) { } /// /// Constructs AmazonCloudWatchLogsClient with the credentials loaded from the application's /// default configuration, and if unsuccessful from the Instance Profile service on an EC2 instance. /// /// Example App.config with credentials set. /// /// <?xml version="1.0" encoding="utf-8" ?> /// <configuration> /// <appSettings> /// <add key="AWSProfileName" value="AWS Default"/> /// </appSettings> /// </configuration> /// /// /// /// The region to connect. public AmazonCloudWatchLogsClient(RegionEndpoint region) : base(FallbackCredentialsFactory.GetCredentials(), new AmazonCloudWatchLogsConfig{RegionEndpoint = region}) { } /// /// Constructs AmazonCloudWatchLogsClient with the credentials loaded from the application's /// default configuration, and if unsuccessful from the Instance Profile service on an EC2 instance. /// /// Example App.config with credentials set. /// /// <?xml version="1.0" encoding="utf-8" ?> /// <configuration> /// <appSettings> /// <add key="AWSProfileName" value="AWS Default"/> /// </appSettings> /// </configuration> /// /// /// /// The AmazonCloudWatchLogsClient Configuration Object public AmazonCloudWatchLogsClient(AmazonCloudWatchLogsConfig config) : base(FallbackCredentialsFactory.GetCredentials(config), config){} /// /// Constructs AmazonCloudWatchLogsClient with AWS Credentials /// /// AWS Credentials public AmazonCloudWatchLogsClient(AWSCredentials credentials) : this(credentials, new AmazonCloudWatchLogsConfig()) { } /// /// Constructs AmazonCloudWatchLogsClient with AWS Credentials /// /// AWS Credentials /// The region to connect. public AmazonCloudWatchLogsClient(AWSCredentials credentials, RegionEndpoint region) : this(credentials, new AmazonCloudWatchLogsConfig{RegionEndpoint = region}) { } /// /// Constructs AmazonCloudWatchLogsClient with AWS Credentials and an /// AmazonCloudWatchLogsClient Configuration object. /// /// AWS Credentials /// The AmazonCloudWatchLogsClient Configuration Object public AmazonCloudWatchLogsClient(AWSCredentials credentials, AmazonCloudWatchLogsConfig clientConfig) : base(credentials, clientConfig) { } /// /// Constructs AmazonCloudWatchLogsClient with AWS Access Key ID and AWS Secret Key /// /// AWS Access Key ID /// AWS Secret Access Key public AmazonCloudWatchLogsClient(string awsAccessKeyId, string awsSecretAccessKey) : this(awsAccessKeyId, awsSecretAccessKey, new AmazonCloudWatchLogsConfig()) { } /// /// Constructs AmazonCloudWatchLogsClient with AWS Access Key ID and AWS Secret Key /// /// AWS Access Key ID /// AWS Secret Access Key /// The region to connect. public AmazonCloudWatchLogsClient(string awsAccessKeyId, string awsSecretAccessKey, RegionEndpoint region) : this(awsAccessKeyId, awsSecretAccessKey, new AmazonCloudWatchLogsConfig() {RegionEndpoint=region}) { } /// /// Constructs AmazonCloudWatchLogsClient with AWS Access Key ID, AWS Secret Key and an /// AmazonCloudWatchLogsClient Configuration object. /// /// AWS Access Key ID /// AWS Secret Access Key /// The AmazonCloudWatchLogsClient Configuration Object public AmazonCloudWatchLogsClient(string awsAccessKeyId, string awsSecretAccessKey, AmazonCloudWatchLogsConfig clientConfig) : base(awsAccessKeyId, awsSecretAccessKey, clientConfig) { } /// /// Constructs AmazonCloudWatchLogsClient with AWS Access Key ID and AWS Secret Key /// /// AWS Access Key ID /// AWS Secret Access Key /// AWS Session Token public AmazonCloudWatchLogsClient(string awsAccessKeyId, string awsSecretAccessKey, string awsSessionToken) : this(awsAccessKeyId, awsSecretAccessKey, awsSessionToken, new AmazonCloudWatchLogsConfig()) { } /// /// Constructs AmazonCloudWatchLogsClient with AWS Access Key ID and AWS Secret Key /// /// AWS Access Key ID /// AWS Secret Access Key /// AWS Session Token /// The region to connect. public AmazonCloudWatchLogsClient(string awsAccessKeyId, string awsSecretAccessKey, string awsSessionToken, RegionEndpoint region) : this(awsAccessKeyId, awsSecretAccessKey, awsSessionToken, new AmazonCloudWatchLogsConfig{RegionEndpoint = region}) { } /// /// Constructs AmazonCloudWatchLogsClient with AWS Access Key ID, AWS Secret Key and an /// AmazonCloudWatchLogsClient Configuration object. /// /// AWS Access Key ID /// AWS Secret Access Key /// AWS Session Token /// The AmazonCloudWatchLogsClient Configuration Object public AmazonCloudWatchLogsClient(string awsAccessKeyId, string awsSecretAccessKey, string awsSessionToken, AmazonCloudWatchLogsConfig clientConfig) : base(awsAccessKeyId, awsSecretAccessKey, awsSessionToken, clientConfig) { } #endregion #if AWS_ASYNC_ENUMERABLES_API private ICloudWatchLogsPaginatorFactory _paginators; /// /// Paginators for the service /// public ICloudWatchLogsPaginatorFactory Paginators { get { if (this._paginators == null) { this._paginators = new CloudWatchLogsPaginatorFactory(this); } return this._paginators; } } #endif #region Overrides /// /// Creates the signer for the service. /// protected override AbstractAWSSigner CreateSigner() { return new AWS4Signer(); } /// /// Customizes the runtime pipeline. /// /// Runtime pipeline for the current client. protected override void CustomizeRuntimePipeline(RuntimePipeline pipeline) { pipeline.RemoveHandler(); pipeline.AddHandlerAfter(new AmazonCloudWatchLogsEndpointResolver()); } /// /// Capture metadata for the service. /// protected override IServiceMetadata ServiceMetadata { get { return serviceMetadata; } } #endregion #region Dispose /// /// Disposes the service client. /// protected override void Dispose(bool disposing) { base.Dispose(disposing); } #endregion #region AssociateKmsKey internal virtual AssociateKmsKeyResponse AssociateKmsKey(AssociateKmsKeyRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = AssociateKmsKeyRequestMarshaller.Instance; options.ResponseUnmarshaller = AssociateKmsKeyResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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. /// ///
  • /// /// Specify the logGroupName parameter to cause all log events stored in /// the log group to be encrypted with that key. Only the log events ingested after the /// key is associated are encrypted with that key. /// /// /// /// Associating a KMS key with a log group overrides any existing associations between /// the log group and a KMS key. After a KMS key is associated with a log group, all newly /// ingested data for the log group 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. /// /// /// /// Associating a key with a log group does not cause the results of queries of that log /// group to be encrypted with that key. To have query results encrypted with a KMS key, /// you must use an AssociateKmsKey operation with the resourceIdentifier /// parameter that specifies a query-result resource. /// ///
  • /// /// Specify the resourceIdentifier parameter with a query-result /// resource, to use that key to encrypt the stored results of all future StartQuery /// operations in the account. The response from a GetQueryResults /// operation will still return the query results in plain text. /// /// /// /// Even if you have not associated a key with your query results, the query results are /// encrypted when stored, using the default CloudWatch Logs method. /// /// /// /// If you run a query from a monitoring account that queries logs in a source account, /// the query results key from the monitoring account, if any, is used. /// ///
/// /// 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 public virtual Task AssociateKmsKeyAsync(AssociateKmsKeyRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = AssociateKmsKeyRequestMarshaller.Instance; options.ResponseUnmarshaller = AssociateKmsKeyResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region CancelExportTask internal virtual CancelExportTaskResponse CancelExportTask(CancelExportTaskRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = CancelExportTaskRequestMarshaller.Instance; options.ResponseUnmarshaller = CancelExportTaskResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task CancelExportTaskAsync(CancelExportTaskRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = CancelExportTaskRequestMarshaller.Instance; options.ResponseUnmarshaller = CancelExportTaskResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region CreateExportTask internal virtual CreateExportTaskResponse CreateExportTask(CreateExportTaskRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = CreateExportTaskRequestMarshaller.Instance; options.ResponseUnmarshaller = CreateExportTaskResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task CreateExportTaskAsync(CreateExportTaskRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = CreateExportTaskRequestMarshaller.Instance; options.ResponseUnmarshaller = CreateExportTaskResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region CreateLogGroup internal virtual CreateLogGroupResponse CreateLogGroup(CreateLogGroupRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = CreateLogGroupRequestMarshaller.Instance; options.ResponseUnmarshaller = CreateLogGroupResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task CreateLogGroupAsync(CreateLogGroupRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = CreateLogGroupRequestMarshaller.Instance; options.ResponseUnmarshaller = CreateLogGroupResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region CreateLogStream internal virtual CreateLogStreamResponse CreateLogStream(CreateLogStreamRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = CreateLogStreamRequestMarshaller.Instance; options.ResponseUnmarshaller = CreateLogStreamResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task CreateLogStreamAsync(CreateLogStreamRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = CreateLogStreamRequestMarshaller.Instance; options.ResponseUnmarshaller = CreateLogStreamResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region DeleteAccountPolicy internal virtual DeleteAccountPolicyResponse DeleteAccountPolicy(DeleteAccountPolicyRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = DeleteAccountPolicyRequestMarshaller.Instance; options.ResponseUnmarshaller = DeleteAccountPolicyResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task DeleteAccountPolicyAsync(DeleteAccountPolicyRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = DeleteAccountPolicyRequestMarshaller.Instance; options.ResponseUnmarshaller = DeleteAccountPolicyResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region DeleteDataProtectionPolicy internal virtual DeleteDataProtectionPolicyResponse DeleteDataProtectionPolicy(DeleteDataProtectionPolicyRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = DeleteDataProtectionPolicyRequestMarshaller.Instance; options.ResponseUnmarshaller = DeleteDataProtectionPolicyResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task DeleteDataProtectionPolicyAsync(DeleteDataProtectionPolicyRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = DeleteDataProtectionPolicyRequestMarshaller.Instance; options.ResponseUnmarshaller = DeleteDataProtectionPolicyResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region DeleteDestination internal virtual DeleteDestinationResponse DeleteDestination(DeleteDestinationRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = DeleteDestinationRequestMarshaller.Instance; options.ResponseUnmarshaller = DeleteDestinationResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task DeleteDestinationAsync(DeleteDestinationRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = DeleteDestinationRequestMarshaller.Instance; options.ResponseUnmarshaller = DeleteDestinationResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region DeleteLogGroup internal virtual DeleteLogGroupResponse DeleteLogGroup(DeleteLogGroupRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = DeleteLogGroupRequestMarshaller.Instance; options.ResponseUnmarshaller = DeleteLogGroupResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task DeleteLogGroupAsync(DeleteLogGroupRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = DeleteLogGroupRequestMarshaller.Instance; options.ResponseUnmarshaller = DeleteLogGroupResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region DeleteLogStream internal virtual DeleteLogStreamResponse DeleteLogStream(DeleteLogStreamRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = DeleteLogStreamRequestMarshaller.Instance; options.ResponseUnmarshaller = DeleteLogStreamResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task DeleteLogStreamAsync(DeleteLogStreamRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = DeleteLogStreamRequestMarshaller.Instance; options.ResponseUnmarshaller = DeleteLogStreamResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region DeleteMetricFilter internal virtual DeleteMetricFilterResponse DeleteMetricFilter(DeleteMetricFilterRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = DeleteMetricFilterRequestMarshaller.Instance; options.ResponseUnmarshaller = DeleteMetricFilterResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task DeleteMetricFilterAsync(DeleteMetricFilterRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = DeleteMetricFilterRequestMarshaller.Instance; options.ResponseUnmarshaller = DeleteMetricFilterResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region DeleteQueryDefinition internal virtual DeleteQueryDefinitionResponse DeleteQueryDefinition(DeleteQueryDefinitionRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = DeleteQueryDefinitionRequestMarshaller.Instance; options.ResponseUnmarshaller = DeleteQueryDefinitionResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task DeleteQueryDefinitionAsync(DeleteQueryDefinitionRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = DeleteQueryDefinitionRequestMarshaller.Instance; options.ResponseUnmarshaller = DeleteQueryDefinitionResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region DeleteResourcePolicy internal virtual DeleteResourcePolicyResponse DeleteResourcePolicy(DeleteResourcePolicyRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = DeleteResourcePolicyRequestMarshaller.Instance; options.ResponseUnmarshaller = DeleteResourcePolicyResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task DeleteResourcePolicyAsync(DeleteResourcePolicyRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = DeleteResourcePolicyRequestMarshaller.Instance; options.ResponseUnmarshaller = DeleteResourcePolicyResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region DeleteRetentionPolicy internal virtual DeleteRetentionPolicyResponse DeleteRetentionPolicy(DeleteRetentionPolicyRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = DeleteRetentionPolicyRequestMarshaller.Instance; options.ResponseUnmarshaller = DeleteRetentionPolicyResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task DeleteRetentionPolicyAsync(DeleteRetentionPolicyRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = DeleteRetentionPolicyRequestMarshaller.Instance; options.ResponseUnmarshaller = DeleteRetentionPolicyResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region DeleteSubscriptionFilter internal virtual DeleteSubscriptionFilterResponse DeleteSubscriptionFilter(DeleteSubscriptionFilterRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = DeleteSubscriptionFilterRequestMarshaller.Instance; options.ResponseUnmarshaller = DeleteSubscriptionFilterResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task DeleteSubscriptionFilterAsync(DeleteSubscriptionFilterRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = DeleteSubscriptionFilterRequestMarshaller.Instance; options.ResponseUnmarshaller = DeleteSubscriptionFilterResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region DescribeAccountPolicies internal virtual DescribeAccountPoliciesResponse DescribeAccountPolicies(DescribeAccountPoliciesRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = DescribeAccountPoliciesRequestMarshaller.Instance; options.ResponseUnmarshaller = DescribeAccountPoliciesResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task DescribeAccountPoliciesAsync(DescribeAccountPoliciesRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = DescribeAccountPoliciesRequestMarshaller.Instance; options.ResponseUnmarshaller = DescribeAccountPoliciesResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region DescribeDestinations internal virtual DescribeDestinationsResponse DescribeDestinations(DescribeDestinationsRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = DescribeDestinationsRequestMarshaller.Instance; options.ResponseUnmarshaller = DescribeDestinationsResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task DescribeDestinationsAsync(DescribeDestinationsRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = DescribeDestinationsRequestMarshaller.Instance; options.ResponseUnmarshaller = DescribeDestinationsResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region DescribeExportTasks internal virtual DescribeExportTasksResponse DescribeExportTasks(DescribeExportTasksRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = DescribeExportTasksRequestMarshaller.Instance; options.ResponseUnmarshaller = DescribeExportTasksResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task DescribeExportTasksAsync(DescribeExportTasksRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = DescribeExportTasksRequestMarshaller.Instance; options.ResponseUnmarshaller = DescribeExportTasksResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region DescribeLogGroups internal virtual DescribeLogGroupsResponse DescribeLogGroups() { return DescribeLogGroups(new DescribeLogGroupsRequest()); } internal virtual DescribeLogGroupsResponse DescribeLogGroups(DescribeLogGroupsRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = DescribeLogGroupsRequestMarshaller.Instance; options.ResponseUnmarshaller = DescribeLogGroupsResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task DescribeLogGroupsAsync(System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { return DescribeLogGroupsAsync(new DescribeLogGroupsRequest(), 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 public virtual Task DescribeLogGroupsAsync(DescribeLogGroupsRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = DescribeLogGroupsRequestMarshaller.Instance; options.ResponseUnmarshaller = DescribeLogGroupsResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region DescribeLogStreams internal virtual DescribeLogStreamsResponse DescribeLogStreams(DescribeLogStreamsRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = DescribeLogStreamsRequestMarshaller.Instance; options.ResponseUnmarshaller = DescribeLogStreamsResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task DescribeLogStreamsAsync(DescribeLogStreamsRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = DescribeLogStreamsRequestMarshaller.Instance; options.ResponseUnmarshaller = DescribeLogStreamsResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region DescribeMetricFilters internal virtual DescribeMetricFiltersResponse DescribeMetricFilters(DescribeMetricFiltersRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = DescribeMetricFiltersRequestMarshaller.Instance; options.ResponseUnmarshaller = DescribeMetricFiltersResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task DescribeMetricFiltersAsync(DescribeMetricFiltersRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = DescribeMetricFiltersRequestMarshaller.Instance; options.ResponseUnmarshaller = DescribeMetricFiltersResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region DescribeQueries internal virtual DescribeQueriesResponse DescribeQueries(DescribeQueriesRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = DescribeQueriesRequestMarshaller.Instance; options.ResponseUnmarshaller = DescribeQueriesResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task DescribeQueriesAsync(DescribeQueriesRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = DescribeQueriesRequestMarshaller.Instance; options.ResponseUnmarshaller = DescribeQueriesResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region DescribeQueryDefinitions internal virtual DescribeQueryDefinitionsResponse DescribeQueryDefinitions(DescribeQueryDefinitionsRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = DescribeQueryDefinitionsRequestMarshaller.Instance; options.ResponseUnmarshaller = DescribeQueryDefinitionsResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task DescribeQueryDefinitionsAsync(DescribeQueryDefinitionsRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = DescribeQueryDefinitionsRequestMarshaller.Instance; options.ResponseUnmarshaller = DescribeQueryDefinitionsResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region DescribeResourcePolicies internal virtual DescribeResourcePoliciesResponse DescribeResourcePolicies(DescribeResourcePoliciesRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = DescribeResourcePoliciesRequestMarshaller.Instance; options.ResponseUnmarshaller = DescribeResourcePoliciesResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task DescribeResourcePoliciesAsync(DescribeResourcePoliciesRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = DescribeResourcePoliciesRequestMarshaller.Instance; options.ResponseUnmarshaller = DescribeResourcePoliciesResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region DescribeSubscriptionFilters internal virtual DescribeSubscriptionFiltersResponse DescribeSubscriptionFilters(DescribeSubscriptionFiltersRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = DescribeSubscriptionFiltersRequestMarshaller.Instance; options.ResponseUnmarshaller = DescribeSubscriptionFiltersResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task DescribeSubscriptionFiltersAsync(DescribeSubscriptionFiltersRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = DescribeSubscriptionFiltersRequestMarshaller.Instance; options.ResponseUnmarshaller = DescribeSubscriptionFiltersResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region DisassociateKmsKey internal virtual DisassociateKmsKeyResponse DisassociateKmsKey(DisassociateKmsKeyRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = DisassociateKmsKeyRequestMarshaller.Instance; options.ResponseUnmarshaller = DisassociateKmsKeyResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task DisassociateKmsKeyAsync(DisassociateKmsKeyRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = DisassociateKmsKeyRequestMarshaller.Instance; options.ResponseUnmarshaller = DisassociateKmsKeyResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region FilterLogEvents internal virtual FilterLogEventsResponse FilterLogEvents(FilterLogEventsRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = FilterLogEventsRequestMarshaller.Instance; options.ResponseUnmarshaller = FilterLogEventsResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task FilterLogEventsAsync(FilterLogEventsRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = FilterLogEventsRequestMarshaller.Instance; options.ResponseUnmarshaller = FilterLogEventsResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region GetDataProtectionPolicy internal virtual GetDataProtectionPolicyResponse GetDataProtectionPolicy(GetDataProtectionPolicyRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = GetDataProtectionPolicyRequestMarshaller.Instance; options.ResponseUnmarshaller = GetDataProtectionPolicyResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task GetDataProtectionPolicyAsync(GetDataProtectionPolicyRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = GetDataProtectionPolicyRequestMarshaller.Instance; options.ResponseUnmarshaller = GetDataProtectionPolicyResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region GetLogEvents internal virtual GetLogEventsResponse GetLogEvents(GetLogEventsRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = GetLogEventsRequestMarshaller.Instance; options.ResponseUnmarshaller = GetLogEventsResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task GetLogEventsAsync(GetLogEventsRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = GetLogEventsRequestMarshaller.Instance; options.ResponseUnmarshaller = GetLogEventsResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region GetLogGroupFields internal virtual GetLogGroupFieldsResponse GetLogGroupFields(GetLogGroupFieldsRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = GetLogGroupFieldsRequestMarshaller.Instance; options.ResponseUnmarshaller = GetLogGroupFieldsResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task GetLogGroupFieldsAsync(GetLogGroupFieldsRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = GetLogGroupFieldsRequestMarshaller.Instance; options.ResponseUnmarshaller = GetLogGroupFieldsResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region GetLogRecord internal virtual GetLogRecordResponse GetLogRecord(GetLogRecordRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = GetLogRecordRequestMarshaller.Instance; options.ResponseUnmarshaller = GetLogRecordResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task GetLogRecordAsync(GetLogRecordRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = GetLogRecordRequestMarshaller.Instance; options.ResponseUnmarshaller = GetLogRecordResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region GetQueryResults internal virtual GetQueryResultsResponse GetQueryResults(GetQueryResultsRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = GetQueryResultsRequestMarshaller.Instance; options.ResponseUnmarshaller = GetQueryResultsResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task GetQueryResultsAsync(GetQueryResultsRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = GetQueryResultsRequestMarshaller.Instance; options.ResponseUnmarshaller = GetQueryResultsResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region ListTagsForResource internal virtual ListTagsForResourceResponse ListTagsForResource(ListTagsForResourceRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = ListTagsForResourceRequestMarshaller.Instance; options.ResponseUnmarshaller = ListTagsForResourceResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task ListTagsForResourceAsync(ListTagsForResourceRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = ListTagsForResourceRequestMarshaller.Instance; options.ResponseUnmarshaller = ListTagsForResourceResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region ListTagsLogGroup [Obsolete("Please use the generic tagging API ListTagsForResource")] internal virtual ListTagsLogGroupResponse ListTagsLogGroup(ListTagsLogGroupRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = ListTagsLogGroupRequestMarshaller.Instance; options.ResponseUnmarshaller = ListTagsLogGroupResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// /// /// 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")] public virtual Task ListTagsLogGroupAsync(ListTagsLogGroupRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = ListTagsLogGroupRequestMarshaller.Instance; options.ResponseUnmarshaller = ListTagsLogGroupResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region PutAccountPolicy internal virtual PutAccountPolicyResponse PutAccountPolicy(PutAccountPolicyRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = PutAccountPolicyRequestMarshaller.Instance; options.ResponseUnmarshaller = PutAccountPolicyResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task PutAccountPolicyAsync(PutAccountPolicyRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = PutAccountPolicyRequestMarshaller.Instance; options.ResponseUnmarshaller = PutAccountPolicyResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region PutDataProtectionPolicy internal virtual PutDataProtectionPolicyResponse PutDataProtectionPolicy(PutDataProtectionPolicyRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = PutDataProtectionPolicyRequestMarshaller.Instance; options.ResponseUnmarshaller = PutDataProtectionPolicyResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task PutDataProtectionPolicyAsync(PutDataProtectionPolicyRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = PutDataProtectionPolicyRequestMarshaller.Instance; options.ResponseUnmarshaller = PutDataProtectionPolicyResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region PutDestination internal virtual PutDestinationResponse PutDestination(PutDestinationRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = PutDestinationRequestMarshaller.Instance; options.ResponseUnmarshaller = PutDestinationResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task PutDestinationAsync(PutDestinationRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = PutDestinationRequestMarshaller.Instance; options.ResponseUnmarshaller = PutDestinationResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region PutDestinationPolicy internal virtual PutDestinationPolicyResponse PutDestinationPolicy(PutDestinationPolicyRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = PutDestinationPolicyRequestMarshaller.Instance; options.ResponseUnmarshaller = PutDestinationPolicyResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task PutDestinationPolicyAsync(PutDestinationPolicyRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = PutDestinationPolicyRequestMarshaller.Instance; options.ResponseUnmarshaller = PutDestinationPolicyResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region PutLogEvents internal virtual PutLogEventsResponse PutLogEvents(PutLogEventsRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = PutLogEventsRequestMarshaller.Instance; options.ResponseUnmarshaller = PutLogEventsResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task PutLogEventsAsync(PutLogEventsRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = PutLogEventsRequestMarshaller.Instance; options.ResponseUnmarshaller = PutLogEventsResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region PutMetricFilter internal virtual PutMetricFilterResponse PutMetricFilter(PutMetricFilterRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = PutMetricFilterRequestMarshaller.Instance; options.ResponseUnmarshaller = PutMetricFilterResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task PutMetricFilterAsync(PutMetricFilterRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = PutMetricFilterRequestMarshaller.Instance; options.ResponseUnmarshaller = PutMetricFilterResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region PutQueryDefinition internal virtual PutQueryDefinitionResponse PutQueryDefinition(PutQueryDefinitionRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = PutQueryDefinitionRequestMarshaller.Instance; options.ResponseUnmarshaller = PutQueryDefinitionResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task PutQueryDefinitionAsync(PutQueryDefinitionRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = PutQueryDefinitionRequestMarshaller.Instance; options.ResponseUnmarshaller = PutQueryDefinitionResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region PutResourcePolicy internal virtual PutResourcePolicyResponse PutResourcePolicy(PutResourcePolicyRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = PutResourcePolicyRequestMarshaller.Instance; options.ResponseUnmarshaller = PutResourcePolicyResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task PutResourcePolicyAsync(PutResourcePolicyRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = PutResourcePolicyRequestMarshaller.Instance; options.ResponseUnmarshaller = PutResourcePolicyResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region PutRetentionPolicy internal virtual PutRetentionPolicyResponse PutRetentionPolicy(PutRetentionPolicyRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = PutRetentionPolicyRequestMarshaller.Instance; options.ResponseUnmarshaller = PutRetentionPolicyResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task PutRetentionPolicyAsync(PutRetentionPolicyRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = PutRetentionPolicyRequestMarshaller.Instance; options.ResponseUnmarshaller = PutRetentionPolicyResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region PutSubscriptionFilter internal virtual PutSubscriptionFilterResponse PutSubscriptionFilter(PutSubscriptionFilterRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = PutSubscriptionFilterRequestMarshaller.Instance; options.ResponseUnmarshaller = PutSubscriptionFilterResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task PutSubscriptionFilterAsync(PutSubscriptionFilterRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = PutSubscriptionFilterRequestMarshaller.Instance; options.ResponseUnmarshaller = PutSubscriptionFilterResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region StartQuery internal virtual StartQueryResponse StartQuery(StartQueryRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = StartQueryRequestMarshaller.Instance; options.ResponseUnmarshaller = StartQueryResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task StartQueryAsync(StartQueryRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = StartQueryRequestMarshaller.Instance; options.ResponseUnmarshaller = StartQueryResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region StopQuery internal virtual StopQueryResponse StopQuery(StopQueryRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = StopQueryRequestMarshaller.Instance; options.ResponseUnmarshaller = StopQueryResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task StopQueryAsync(StopQueryRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = StopQueryRequestMarshaller.Instance; options.ResponseUnmarshaller = StopQueryResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region TagLogGroup [Obsolete("Please use the generic tagging API TagResource")] internal virtual TagLogGroupResponse TagLogGroup(TagLogGroupRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = TagLogGroupRequestMarshaller.Instance; options.ResponseUnmarshaller = TagLogGroupResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// /// /// 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")] public virtual Task TagLogGroupAsync(TagLogGroupRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = TagLogGroupRequestMarshaller.Instance; options.ResponseUnmarshaller = TagLogGroupResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region TagResource internal virtual TagResourceResponse TagResource(TagResourceRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = TagResourceRequestMarshaller.Instance; options.ResponseUnmarshaller = TagResourceResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task TagResourceAsync(TagResourceRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = TagResourceRequestMarshaller.Instance; options.ResponseUnmarshaller = TagResourceResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region TestMetricFilter internal virtual TestMetricFilterResponse TestMetricFilter(TestMetricFilterRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = TestMetricFilterRequestMarshaller.Instance; options.ResponseUnmarshaller = TestMetricFilterResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task TestMetricFilterAsync(TestMetricFilterRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = TestMetricFilterRequestMarshaller.Instance; options.ResponseUnmarshaller = TestMetricFilterResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region UntagLogGroup [Obsolete("Please use the generic tagging API UntagResource")] internal virtual UntagLogGroupResponse UntagLogGroup(UntagLogGroupRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = UntagLogGroupRequestMarshaller.Instance; options.ResponseUnmarshaller = UntagLogGroupResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// /// /// 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")] public virtual Task UntagLogGroupAsync(UntagLogGroupRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = UntagLogGroupRequestMarshaller.Instance; options.ResponseUnmarshaller = UntagLogGroupResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion #region UntagResource internal virtual UntagResourceResponse UntagResource(UntagResourceRequest request) { var options = new InvokeOptions(); options.RequestMarshaller = UntagResourceRequestMarshaller.Instance; options.ResponseUnmarshaller = UntagResourceResponseUnmarshaller.Instance; return Invoke(request, options); } /// /// 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 public virtual Task UntagResourceAsync(UntagResourceRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken)) { var options = new InvokeOptions(); options.RequestMarshaller = UntagResourceRequestMarshaller.Instance; options.ResponseUnmarshaller = UntagResourceResponseUnmarshaller.Instance; return InvokeAsync(request, options, cancellationToken); } #endregion } }