Regenerating amazonka-cloudwatch-logs from latest service definition

amazonka-cloudwatch-logs/gen/Network/AWS/CloudWatchLogs.hs

@@ -11,7 +11,7 @@
 -- Stability   : auto-generated
 -- Portability : non-portable (GHC extensions)
 --
--- You can use Amazon CloudWatch Logs to monitor, store, and access your log files from Amazon Elastic Compute Cloud (Amazon EC2) instances, Amazon CloudTrail, or other sources. You can then retrieve the associated log data from CloudWatch Logs using the Amazon CloudWatch console, the CloudWatch Logs commands in the AWS CLI, the CloudWatch Logs API, or the CloudWatch Logs SDK.
+-- You can use Amazon CloudWatch Logs to monitor, store, and access your log files from EC2 instances, Amazon CloudTrail, or other sources. You can then retrieve the associated log data from CloudWatch Logs using the Amazon CloudWatch console, the CloudWatch Logs commands in the AWS CLI, the CloudWatch Logs API, or the CloudWatch Logs SDK.
 --
 --
 -- You can use CloudWatch Logs to:
@@ -225,6 +225,7 @@ module Network.AWS.CloudWatchLogs
     , metricFilter
     , mfCreationTime
     , mfFilterName
+    , mfLogGroupName
     , mfFilterPattern
     , mfMetricTransformations
 

amazonka-cloudwatch-logs/gen/Network/AWS/CloudWatchLogs/CancelExportTask.hs

@@ -18,9 +18,11 @@
 -- Stability   : auto-generated
 -- Portability : non-portable (GHC extensions)
 --
--- Cancels an export task if it is in @PENDING@ or @RUNNING@ state.
+-- Cancels the specified export task.
 --
 --
+-- The task must be in the @PENDING@ or @RUNNING@ state.
+--
 module Network.AWS.CloudWatchLogs.CancelExportTask
     (
     -- * Creating a Request
@@ -50,7 +52,7 @@ newtype CancelExportTask = CancelExportTask'
 --
 -- Use one of the following lenses to modify other fields as desired:
 --
--- * 'cetTaskId' - Id of the export task to cancel.
+-- * 'cetTaskId' - The ID of the export task.
 cancelExportTask
     :: Text -- ^ 'cetTaskId'
     -> CancelExportTask
@@ -59,7 +61,7 @@ cancelExportTask pTaskId_ =
     { _cetTaskId = pTaskId_
     }
 
--- | Id of the export task to cancel.
+-- | The ID of the export task.
 cetTaskId :: Lens' CancelExportTask Text
 cetTaskId = lens _cetTaskId (\ s a -> s{_cetTaskId = a});
 

amazonka-cloudwatch-logs/gen/Network/AWS/CloudWatchLogs/CreateExportTask.hs

@@ -18,12 +18,12 @@
 -- Stability   : auto-generated
 -- Portability : non-portable (GHC extensions)
 --
--- Creates an @ExportTask@ which allows you to efficiently export data from a Log Group to your Amazon S3 bucket.
+-- Creates an export task, which allows you to efficiently export data from a log group to an Amazon S3 bucket.
 --
 --
--- This is an asynchronous call. If all the required information is provided, this API will initiate an export task and respond with the task Id. Once started, @DescribeExportTasks@ can be used to get the status of an export task. You can only have one active (@RUNNING@ or @PENDING@ ) export task at a time, per account.
+-- 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 Amazon S3 bucket. To separate out log data for each export task, you can specify a prefix that will be used as the Amazon S3 key prefix for all exported objects.
+-- You can export logs from multiple log groups or multiple time ranges to the same S3 bucket. To separate out log data for each export task, you can specify a prefix that will be used as the Amazon S3 key prefix for all exported objects.
 --
 module Network.AWS.CloudWatchLogs.CreateExportTask
     (
@@ -69,19 +69,19 @@ data CreateExportTask = CreateExportTask'
 --
 -- Use one of the following lenses to modify other fields as desired:
 --
--- * 'cetDestinationPrefix' - Prefix that will be used as the start of Amazon S3 key for every object exported. If not specified, this defaults to 'exportedlogs'.
+-- * 'cetDestinationPrefix' - The prefix used as the start of the key for every object exported. If you don't specify a value, the default is @exportedlogs@ .
 --
 -- * 'cetTaskName' - The name of the export task.
 --
--- * 'cetLogStreamNamePrefix' - Will only export log streams that match the provided logStreamNamePrefix. If you don't specify a value, no prefix filter is applied.
+-- * 'cetLogStreamNamePrefix' - Export only log streams that match the provided prefix. If you don't specify a value, no prefix filter is applied.
 --
--- * 'cetLogGroupName' - The name of the log group to export.
+-- * 'cetLogGroupName' - The name of the log group.
 --
--- * 'cetFrom' - A point in time expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. It indicates the start time of the range for the request. Events with a timestamp prior to this time will not be exported.
+-- * 'cetFrom' - The start time of the range for the request, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. Events with a timestamp earlier than this time are not exported.
 --
--- * 'cetTo' - A point in time expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. It indicates the end time of the range for the request. Events with a timestamp later than this time will not be exported.
+-- * 'cetTo' - The end time of the range for the request, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. Events with a timestamp later than this time are not exported.
 --
--- * 'cetDestination' - Name of Amazon S3 bucket to which the log data will be exported. __Note:__ Only buckets in the same AWS region are supported.
+-- * 'cetDestination' - The name of S3 bucket for the exported log data. The bucket must be in the same AWS region.
 createExportTask
     :: Text -- ^ 'cetLogGroupName'
     -> Natural -- ^ 'cetFrom'
@@ -99,31 +99,31 @@ createExportTask pLogGroupName_ pFrom_ pTo_ pDestination_ =
     , _cetDestination = pDestination_
     }
 
--- | Prefix that will be used as the start of Amazon S3 key for every object exported. If not specified, this defaults to 'exportedlogs'.
+-- | The prefix used as the start of the key for every object exported. If you don't specify a value, the default is @exportedlogs@ .
 cetDestinationPrefix :: Lens' CreateExportTask (Maybe Text)
 cetDestinationPrefix = lens _cetDestinationPrefix (\ s a -> s{_cetDestinationPrefix = a});
 
 -- | The name of the export task.
 cetTaskName :: Lens' CreateExportTask (Maybe Text)
 cetTaskName = lens _cetTaskName (\ s a -> s{_cetTaskName = a});
 
--- | Will only export log streams that match the provided logStreamNamePrefix. If you don't specify a value, no prefix filter is applied.
+-- | Export only log streams that match the provided prefix. If you don't specify a value, no prefix filter is applied.
 cetLogStreamNamePrefix :: Lens' CreateExportTask (Maybe Text)
 cetLogStreamNamePrefix = lens _cetLogStreamNamePrefix (\ s a -> s{_cetLogStreamNamePrefix = a});
 
--- | The name of the log group to export.
+-- | The name of the log group.
 cetLogGroupName :: Lens' CreateExportTask Text
 cetLogGroupName = lens _cetLogGroupName (\ s a -> s{_cetLogGroupName = a});
 
--- | A point in time expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. It indicates the start time of the range for the request. Events with a timestamp prior to this time will not be exported.
+-- | The start time of the range for the request, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. Events with a timestamp earlier than this time are not exported.
 cetFrom :: Lens' CreateExportTask Natural
 cetFrom = lens _cetFrom (\ s a -> s{_cetFrom = a}) . _Nat;
 
--- | A point in time expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. It indicates the end time of the range for the request. Events with a timestamp later than this time will not be exported.
+-- | The end time of the range for the request, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC. Events with a timestamp later than this time are not exported.
 cetTo :: Lens' CreateExportTask Natural
 cetTo = lens _cetTo (\ s a -> s{_cetTo = a}) . _Nat;
 
--- | Name of Amazon S3 bucket to which the log data will be exported. __Note:__ Only buckets in the same AWS region are supported.
+-- | The name of S3 bucket for the exported log data. The bucket must be in the same AWS region.
 cetDestination :: Lens' CreateExportTask Text
 cetDestination = lens _cetDestination (\ s a -> s{_cetDestination = a});
 
@@ -177,7 +177,7 @@ data CreateExportTaskResponse = CreateExportTaskResponse'
 --
 -- Use one of the following lenses to modify other fields as desired:
 --
--- * 'cetrsTaskId' - Id of the export task that got created.
+-- * 'cetrsTaskId' - The ID of the export task.
 --
 -- * 'cetrsResponseStatus' - -- | The response status code.
 createExportTaskResponse
@@ -189,7 +189,7 @@ createExportTaskResponse pResponseStatus_ =
     , _cetrsResponseStatus = pResponseStatus_
     }
 
--- | Id of the export task that got created.
+-- | The ID of the export task.
 cetrsTaskId :: Lens' CreateExportTaskResponse (Maybe Text)
 cetrsTaskId = lens _cetrsTaskId (\ s a -> s{_cetrsTaskId = a});
 

amazonka-cloudwatch-logs/gen/Network/AWS/CloudWatchLogs/CreateLogGroup.hs

@@ -18,14 +18,18 @@
 -- Stability   : auto-generated
 -- Portability : non-portable (GHC extensions)
 --
--- Creates a new log group with the specified name. The name of the log group must be unique within a region for an AWS account. You can create up to 500 log groups per account.
+-- Creates a log group with the specified name.
 --
 --
+-- You can create up to 5000 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 AWS account.
+--
 --     * Log group names can be between 1 and 512 characters long.
 --
---     * Allowed characters are a-z, A-Z, 0-9, '_' (underscore), '-' (hyphen), '/' (forward slash), and '.' (period).
+--     * Log group names consist of the following characters: a-z, A-Z, 0-9, '_' (underscore), '-' (hyphen), '/' (forward slash), and '.' (period).
 --
 --
 --
@@ -58,7 +62,7 @@ newtype CreateLogGroup = CreateLogGroup'
 --
 -- Use one of the following lenses to modify other fields as desired:
 --
--- * 'clgLogGroupName' - The name of the log group to create.
+-- * 'clgLogGroupName' - The name of the log group.
 createLogGroup
     :: Text -- ^ 'clgLogGroupName'
     -> CreateLogGroup
@@ -67,7 +71,7 @@ createLogGroup pLogGroupName_ =
     { _clgLogGroupName = pLogGroupName_
     }
 
--- | The name of the log group to create.
+-- | The name of the log group.
 clgLogGroupName :: Lens' CreateLogGroup Text
 clgLogGroupName = lens _clgLogGroupName (\ s a -> s{_clgLogGroupName = a});
 

amazonka-cloudwatch-logs/gen/Network/AWS/CloudWatchLogs/CreateLogStream.hs

@@ -18,14 +18,18 @@
 -- Stability   : auto-generated
 -- Portability : non-portable (GHC extensions)
 --
--- Creates a new log stream in the specified log group. The name of the log stream must be unique within the log group. There is no limit on the number of log streams that can exist in a log group.
+-- Creates a log stream for the specified log group.
 --
 --
+-- There is no limit on the number of log streams that you can create for a log group.
+--
 -- 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.
 --
---     * The ':' colon character is not allowed.
+--     * The ':' (colon) and '*' (asterisk) characters are not allowed.
 --
 --
 --
@@ -60,9 +64,9 @@ data CreateLogStream = CreateLogStream'
 --
 -- Use one of the following lenses to modify other fields as desired:
 --
--- * 'clsLogGroupName' - The name of the log group under which the log stream is to be created.
+-- * 'clsLogGroupName' - The name of the log group.
 --
--- * 'clsLogStreamName' - The name of the log stream to create.
+-- * 'clsLogStreamName' - The name of the log stream.
 createLogStream
     :: Text -- ^ 'clsLogGroupName'
     -> Text -- ^ 'clsLogStreamName'
@@ -73,11 +77,11 @@ createLogStream pLogGroupName_ pLogStreamName_ =
     , _clsLogStreamName = pLogStreamName_
     }
 
--- | The name of the log group under which the log stream is to be created.
+-- | The name of the log group.
 clsLogGroupName :: Lens' CreateLogStream Text
 clsLogGroupName = lens _clsLogGroupName (\ s a -> s{_clsLogGroupName = a});
 
--- | The name of the log stream to create.
+-- | The name of the log stream.
 clsLogStreamName :: Lens' CreateLogStream Text
 clsLogStreamName = lens _clsLogStreamName (\ s a -> s{_clsLogStreamName = a});
 

amazonka-cloudwatch-logs/gen/Network/AWS/CloudWatchLogs/DeleteDestination.hs

@@ -18,7 +18,7 @@
 -- Stability   : auto-generated
 -- Portability : non-portable (GHC extensions)
 --
--- Deletes the destination with the specified name and eventually disables all the subscription filters that publish to it. This will not delete the physical resource encapsulated by the destination.
+-- 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.
 --
 --
 module Network.AWS.CloudWatchLogs.DeleteDestination
@@ -50,7 +50,7 @@ newtype DeleteDestination = DeleteDestination'
 --
 -- Use one of the following lenses to modify other fields as desired:
 --
--- * 'ddDestinationName' - The name of destination to delete.
+-- * 'ddDestinationName' - The name of the destination.
 deleteDestination
     :: Text -- ^ 'ddDestinationName'
     -> DeleteDestination
@@ -59,7 +59,7 @@ deleteDestination pDestinationName_ =
     { _ddDestinationName = pDestinationName_
     }
 
--- | The name of destination to delete.
+-- | The name of the destination.
 ddDestinationName :: Lens' DeleteDestination Text
 ddDestinationName = lens _ddDestinationName (\ s a -> s{_ddDestinationName = a});
 

amazonka-cloudwatch-logs/gen/Network/AWS/CloudWatchLogs/DeleteLogGroup.hs

@@ -18,7 +18,7 @@
 -- Stability   : auto-generated
 -- Portability : non-portable (GHC extensions)
 --
--- Deletes the log group with the specified name and permanently deletes all the archived log events associated with it.
+-- Deletes the specified log group and permanently deletes all the archived log events associated with the log group.
 --
 --
 module Network.AWS.CloudWatchLogs.DeleteLogGroup
@@ -50,7 +50,7 @@ newtype DeleteLogGroup = DeleteLogGroup'
 --
 -- Use one of the following lenses to modify other fields as desired:
 --
--- * 'dlgLogGroupName' - The name of the log group to delete.
+-- * 'dlgLogGroupName' - The name of the log group.
 deleteLogGroup
     :: Text -- ^ 'dlgLogGroupName'
     -> DeleteLogGroup
@@ -59,7 +59,7 @@ deleteLogGroup pLogGroupName_ =
     { _dlgLogGroupName = pLogGroupName_
     }
 
--- | The name of the log group to delete.
+-- | The name of the log group.
 dlgLogGroupName :: Lens' DeleteLogGroup Text
 dlgLogGroupName = lens _dlgLogGroupName (\ s a -> s{_dlgLogGroupName = a});
 

amazonka-cloudwatch-logs/gen/Network/AWS/CloudWatchLogs/DeleteLogStream.hs

@@ -18,7 +18,7 @@
 -- Stability   : auto-generated
 -- Portability : non-portable (GHC extensions)
 --
--- Deletes a log stream and permanently deletes all the archived log events associated with it.
+-- Deletes the specified log stream and permanently deletes all the archived log events associated with the log stream.
 --
 --
 module Network.AWS.CloudWatchLogs.DeleteLogStream
@@ -52,9 +52,9 @@ data DeleteLogStream = DeleteLogStream'
 --
 -- Use one of the following lenses to modify other fields as desired:
 --
--- * 'dlsLogGroupName' - The name of the log group under which the log stream to delete belongs.
+-- * 'dlsLogGroupName' - The name of the log group.
 --
--- * 'dlsLogStreamName' - The name of the log stream to delete.
+-- * 'dlsLogStreamName' - The name of the log stream.
 deleteLogStream
     :: Text -- ^ 'dlsLogGroupName'
     -> Text -- ^ 'dlsLogStreamName'
@@ -65,11 +65,11 @@ deleteLogStream pLogGroupName_ pLogStreamName_ =
     , _dlsLogStreamName = pLogStreamName_
     }
 
--- | The name of the log group under which the log stream to delete belongs.
+-- | The name of the log group.
 dlsLogGroupName :: Lens' DeleteLogStream Text
 dlsLogGroupName = lens _dlsLogGroupName (\ s a -> s{_dlsLogGroupName = a});
 
--- | The name of the log stream to delete.
+-- | The name of the log stream.
 dlsLogStreamName :: Lens' DeleteLogStream Text
 dlsLogStreamName = lens _dlsLogStreamName (\ s a -> s{_dlsLogStreamName = a});
 

amazonka-cloudwatch-logs/gen/Network/AWS/CloudWatchLogs/DeleteMetricFilter.hs

@@ -18,7 +18,7 @@
 -- Stability   : auto-generated
 -- Portability : non-portable (GHC extensions)
 --
--- Deletes a metric filter associated with the specified log group.
+-- Deletes the specified metric filter.
 --
 --
 module Network.AWS.CloudWatchLogs.DeleteMetricFilter
@@ -52,9 +52,9 @@ data DeleteMetricFilter = DeleteMetricFilter'
 --
 -- Use one of the following lenses to modify other fields as desired:
 --
--- * 'delLogGroupName' - The name of the log group that is associated with the metric filter to delete.
+-- * 'delLogGroupName' - The name of the log group.
 --
--- * 'delFilterName' - The name of the metric filter to delete.
+-- * 'delFilterName' - The name of the metric filter.
 deleteMetricFilter
     :: Text -- ^ 'delLogGroupName'
     -> Text -- ^ 'delFilterName'
@@ -65,11 +65,11 @@ deleteMetricFilter pLogGroupName_ pFilterName_ =
     , _delFilterName = pFilterName_
     }
 
--- | The name of the log group that is associated with the metric filter to delete.
+-- | The name of the log group.
 delLogGroupName :: Lens' DeleteMetricFilter Text
 delLogGroupName = lens _delLogGroupName (\ s a -> s{_delLogGroupName = a});
 
--- | The name of the metric filter to delete.
+-- | The name of the metric filter.
 delFilterName :: Lens' DeleteMetricFilter Text
 delFilterName = lens _delFilterName (\ s a -> s{_delFilterName = a});
 

amazonka-cloudwatch-logs/gen/Network/AWS/CloudWatchLogs/DeleteRetentionPolicy.hs

@@ -18,9 +18,11 @@
 -- Stability   : auto-generated
 -- Portability : non-portable (GHC extensions)
 --
--- Deletes the retention policy of the specified log group. Log events would not expire if they belong to log groups without a retention policy.
+-- Deletes the specified retention policy.
 --
 --
+-- Log events do not expire if they belong to log groups without a retention policy.
+--
 module Network.AWS.CloudWatchLogs.DeleteRetentionPolicy
     (
     -- * Creating a Request
@@ -50,7 +52,7 @@ newtype DeleteRetentionPolicy = DeleteRetentionPolicy'
 --
 -- Use one of the following lenses to modify other fields as desired:
 --
--- * 'drpLogGroupName' - The name of the log group that is associated with the retention policy to delete.
+-- * 'drpLogGroupName' - The name of the log group.
 deleteRetentionPolicy
     :: Text -- ^ 'drpLogGroupName'
     -> DeleteRetentionPolicy
@@ -59,7 +61,7 @@ deleteRetentionPolicy pLogGroupName_ =
     { _drpLogGroupName = pLogGroupName_
     }
 
--- | The name of the log group that is associated with the retention policy to delete.
+-- | The name of the log group.
 drpLogGroupName :: Lens' DeleteRetentionPolicy Text
 drpLogGroupName = lens _drpLogGroupName (\ s a -> s{_drpLogGroupName = a});