# Data retrieval APIs for Amazon CloudWatch Logs
<a name="amazoncloudwatchlogs"></a>

Amazon CloudWatch Logs provides the following APIs for data retrieval.


****  

| Actions | Description | Access level | 
| --- | --- | --- | 
| <a name="logs-DescribeAccountPolicies"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeAccountPolicies.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeAccountPolicies.html) | Retrieve account policies | List | 
| <a name="logs-DescribeConfigurationTemplates"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeConfigurationTemplates.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeConfigurationTemplates.html) | Retrieve a list of configuration templates of available log types | List | 
| <a name="logs-DescribeDeliveries"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeDeliveries.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeDeliveries.html) | Retrieve a list of deliveries an account | List | 
| <a name="logs-DescribeDeliveryDestinations"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeDeliveryDestinations.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeDeliveryDestinations.html) | Retrieve a list of delivery destinations an account | List | 
| <a name="logs-DescribeDeliverySources"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeDeliverySources.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeDeliverySources.html) | Retrieve a list of delivery sources in an account | List | 
| <a name="logs-DescribeDestinations"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeDestinations.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeDestinations.html) | Return all the destinations that are associated with the AWS account making the request | List | 
| <a name="logs-DescribeExportTasks"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeExportTasks.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeExportTasks.html) | Return all the export tasks that are associated with the AWS account making the request | List | 
| <a name="logs-DescribeFieldIndexes"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeFieldIndexes.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeFieldIndexes.html) | Return all the indexing attributes that are attached with the log groups | List | 
| <a name="logs-DescribeImportTaskBatches"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeImportTaskBatches.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeImportTaskBatches.html) | Return detailed information about the individual batches within an import task, including status and any error | List | 
| <a name="logs-DescribeImportTasks"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeImportTasks.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeImportTasks.html) | Return all the import tasks associated with the AWS account making the request | List | 
| <a name="logs-DescribeIndexPolicies"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeIndexPolicies.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeIndexPolicies.html) | Return all the index policies that are attached with the log groups | List | 
| <a name="logs-DescribeLogGroups"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeLogGroups.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeLogGroups.html) | Return all the log groups that are associated with the AWS account making the request | List | 
| <a name="logs-DescribeLogStreams"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeLogStreams.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeLogStreams.html) | Return all the log streams that are associated with the specified log group | List | 
| <a name="logs-DescribeLookupTables"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeLookupTables.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeLookupTables.html) | Return all lookup tables | List | 
| <a name="logs-DescribeMetricFilters"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeMetricFilters.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeMetricFilters.html) | Return all the metrics filters associated with the specified log group | List | 
| <a name="logs-DescribeQueries"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeQueries.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeQueries.html) | Return a list of CloudWatch Logs Insights queries that are scheduled, executing, or have been executed recently in this account | List | 
| <a name="logs-DescribeQueryDefinitions"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeQueryDefinitions.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeQueryDefinitions.html) | Return a paginated list of your saved CloudWatch Logs Insights query definitions | List | 
| <a name="logs-DescribeResourcePolicies"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeResourcePolicies.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeResourcePolicies.html) | Return all the resource policies in this account | List | 
| <a name="logs-DescribeSubscriptionFilters"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeSubscriptionFilters.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeSubscriptionFilters.html) | Return all the subscription filters associated with the specified log group | List | 
| <a name="logs-FilterLogEvents"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_FilterLogEvents.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_FilterLogEvents.html) | Retrieve log events, optionally filtered by a filter pattern from the specified log group | Read | 
| <a name="logs-GetDataProtectionPolicy"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetDataProtectionPolicy.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetDataProtectionPolicy.html) | Retrieve a data protection policy attached to a log group | Read | 
| <a name="logs-GetDelivery"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetDelivery.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetDelivery.html) | Retrieve a single delivery | Read | 
| <a name="logs-GetDeliveryDestination"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetDeliveryDestination.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetDeliveryDestination.html) | Retrieve a single delivery destination | Read | 
| <a name="logs-GetDeliveryDestinationPolicy"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetDeliveryDestinationPolicy.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetDeliveryDestinationPolicy.html) | Retrieve a delivery destination policy attached to a delivery destination | Read | 
| <a name="logs-GetDeliverySource"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetDeliverySource.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetDeliverySource.html) | Retrieve a single delivery source | Read | 
| <a name="logs-GetIntegration"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetIntegration.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetIntegration.html) | Retrieve a single integration | Read | 
| <a name="logs-GetLogAnomalyDetector"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogAnomalyDetector.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogAnomalyDetector.html) | Get a log anomaly detector | Read | 
| <a name="logs-GetLogDelivery"></a>[https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html) | Get the log delivery information for specified log delivery | Read | 
| <a name="logs-GetLogEvents"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogEvents.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogEvents.html) | Retrieve log events from the specified log stream | Read | 
| <a name="logs-GetLogFields"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogFields.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogFields.html) | Retrieve a list of log fields for a data source | Read | 
| <a name="logs-GetLogGroupFields"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogGroupFields.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogGroupFields.html) | Return a list of the fields that are included in log events in the specified log group, along with the percentage of log events that contain each field | Read | 
| <a name="logs-GetLogRecord"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogRecord.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogRecord.html) | Retrieve all the fields and values of a single log event | Read | 
| <a name="logs-GetLookupTable"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLookupTable.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLookupTable.html) | Retrieve a lookup table | Read | 
| <a name="logs-GetQueryResults"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetQueryResults.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetQueryResults.html) | Return the results from the specified query | Read | 
| <a name="logs-GetScheduledQuery"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetScheduledQuery.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetScheduledQuery.html) | Retrieve information about a specified scheduled query | Read | 
| <a name="logs-GetScheduledQueryHistory"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetScheduledQueryHistory.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetScheduledQueryHistory.html) | Return the execution history for a specified scheduled query | Read | 
| <a name="logs-GetTransformer"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetTransformer.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetTransformer.html) | Return transformer associated with the specified log group | Read | 
| <a name="logs-ListAggregateLogGroupSummaries"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListAggregateLogGroupSummaries.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListAggregateLogGroupSummaries.html) | Return an aggregate summary of all log groups in the region grouped by specified data-source characteristics | List | 
| <a name="logs-ListAnomalies"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListAnomalies.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListAnomalies.html) | List all anomalies detected in the AWS account making the request | List | 
| <a name="logs-ListEntitiesForLogGroup"></a>[https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/permissions-reference-cwl.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/permissions-reference-cwl.html) | Retrieve all the entities that are associated with log group | List | 
| <a name="logs-ListIntegrations"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListIntegrations.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListIntegrations.html) | List all integrations associated with the AWS account making the request | List | 
| <a name="logs-ListLogAnomalyDetectors"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListLogAnomalyDetectors.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListLogAnomalyDetectors.html) | Return all the anomaly detectors that are associated with the AWS account making the request | List | 
| <a name="logs-ListLogDeliveries"></a>[https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html) | List all the log deliveries for specified account and/or log source | List | 
| <a name="logs-ListLogGroups"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListLogGroups.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListLogGroups.html) | Return all the log groups that are associated with the AWS account making the request | List | 
| <a name="logs-ListLogGroupsForEntity"></a>[https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/permissions-reference-cwl.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/permissions-reference-cwl.html) | Retrieve all the log groups that are associated with entity | List | 
| <a name="logs-ListLogGroupsForQuery"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListLogGroupsForQuery.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListLogGroupsForQuery.html) | Return all the log groups that are associated with the specified query | List | 
| <a name="logs-ListScheduledQueries"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListScheduledQueries.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListScheduledQueries.html) | Return all scheduled queries that are associated with the AWS account making the request | List | 
| <a name="logs-ListSourcesForS3TableIntegration"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListSourcesForS3TableIntegration.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListSourcesForS3TableIntegration.html) | Return all log sources associated with an S3 Tables integration | List | 
| <a name="logs-ListTagsForResource"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListTagsForResource.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListTagsForResource.html) | List the tags for the specified resource | List | 
| <a name="logs-ListTagsLogGroup"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListTagsLogGroup.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListTagsLogGroup.html) | List the tags for the specified log group | List | 
| <a name="logs-StartLiveTail"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_StartLiveTail.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_StartLiveTail.html) | Start a Live Tail session in CloudWatch Logs | Read | 
| <a name="logs-StartQuery"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_StartQuery.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_StartQuery.html) | Schedule a query of a log group using CloudWatch Logs Insights | Read | 
| <a name="logs-StopLiveTail"></a>[https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogs_LiveTail.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogs_LiveTail.html) | Stop a Live Tail session that is in progress | Read | 
| <a name="logs-StopQuery"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_StopQuery.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_StopQuery.html) | Stop a CloudWatch Logs Insights query that is in progress | Read | 
| <a name="logs-TestMetricFilter"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_TestMetricFilter.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_TestMetricFilter.html) | Test the filter pattern of a metric filter against a sample of log event messages | Read | 
| <a name="logs-TestTransformer"></a>[https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_TestTransformer.html](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_TestTransformer.html) | Test the transformer against a sample of log event messages | Read | 
| <a name="logs-Unmask"></a>[https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/mask-sensitive-log-data.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/mask-sensitive-log-data.html) | Fetch unmasked log events that have been redacted with a data protection policy | Read |