Copyright | (c) 2013-2016 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay <brendan.g.hay@gmail.com> |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | None |
Language | Haskell2010 |
Creates an ExportTask
which allows you to efficiently export data from
a Log Group to your 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.
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.
- createExportTask :: Text -> Natural -> Natural -> Text -> CreateExportTask
- data CreateExportTask
- cetDestinationPrefix :: Lens' CreateExportTask (Maybe Text)
- cetTaskName :: Lens' CreateExportTask (Maybe Text)
- cetLogStreamNamePrefix :: Lens' CreateExportTask (Maybe Text)
- cetLogGroupName :: Lens' CreateExportTask Text
- cetFrom :: Lens' CreateExportTask Natural
- cetTo :: Lens' CreateExportTask Natural
- cetDestination :: Lens' CreateExportTask Text
- createExportTaskResponse :: Int -> CreateExportTaskResponse
- data CreateExportTaskResponse
- cetrsTaskId :: Lens' CreateExportTaskResponse (Maybe Text)
- cetrsResponseStatus :: Lens' CreateExportTaskResponse Int
Creating a Request
Creates a value of CreateExportTask
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
data CreateExportTask Source #
See: createExportTask
smart constructor.
Request Lenses
cetDestinationPrefix :: Lens' CreateExportTask (Maybe Text) Source #
Prefix that will be used as the start of Amazon S3 key for every object exported. If not specified, this defaults to 'exportedlogs'.
cetTaskName :: Lens' CreateExportTask (Maybe Text) Source #
The name of the export task.
cetLogStreamNamePrefix :: Lens' CreateExportTask (Maybe Text) Source #
Will only export log streams that match the provided logStreamNamePrefix. If you don't specify a value, no prefix filter is applied.
cetLogGroupName :: Lens' CreateExportTask Text Source #
The name of the log group to export.
cetFrom :: Lens' CreateExportTask Natural Source #
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.
cetTo :: Lens' CreateExportTask Natural Source #
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.
cetDestination :: Lens' CreateExportTask Text Source #
Name of Amazon S3 bucket to which the log data will be exported.
Note: Only buckets in the same AWS region are supported.
Destructuring the Response
createExportTaskResponse Source #
Creates a value of CreateExportTaskResponse
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
data CreateExportTaskResponse Source #
See: createExportTaskResponse
smart constructor.
Response Lenses
cetrsTaskId :: Lens' CreateExportTaskResponse (Maybe Text) Source #
Id of the export task that got created.
cetrsResponseStatus :: Lens' CreateExportTaskResponse Int Source #
The response status code.