Class AbstractAWSLogsAsync
- All Implemented Interfaces:
AWSLogs
,AWSLogsAsync
AWSLogsAsync
. Convenient method forms pass
through to the corresponding overload that takes a request object and an
AsyncHandler
, which throws an UnsupportedOperationException
.-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionCancels an export task if it is inPENDING
orRUNNING
state.cancelExportTaskAsync
(CancelExportTaskRequest request, AsyncHandler<CancelExportTaskRequest, CancelExportTaskResult> asyncHandler) Cancels an export task if it is inPENDING
orRUNNING
state.Creates anExportTask
which allows you to efficiently export data from a Log Group to your Amazon S3 bucket.createExportTaskAsync
(CreateExportTaskRequest request, AsyncHandler<CreateExportTaskRequest, CreateExportTaskResult> asyncHandler) Creates anExportTask
which allows you to efficiently export data from a Log Group to your Amazon S3 bucket.createLogGroupAsync
(CreateLogGroupRequest request) Creates a new log group with the specified name.createLogGroupAsync
(CreateLogGroupRequest request, AsyncHandler<CreateLogGroupRequest, CreateLogGroupResult> asyncHandler) Creates a new log group with the specified name.Creates a new log stream in the specified log group.createLogStreamAsync
(CreateLogStreamRequest request, AsyncHandler<CreateLogStreamRequest, CreateLogStreamResult> asyncHandler) Creates a new log stream in the specified log group.Deletes the destination with the specified name and eventually disables all the subscription filters that publish to it.deleteDestinationAsync
(DeleteDestinationRequest request, AsyncHandler<DeleteDestinationRequest, DeleteDestinationResult> asyncHandler) Deletes the destination with the specified name and eventually disables all the subscription filters that publish to it.deleteLogGroupAsync
(DeleteLogGroupRequest request) Deletes the log group with the specified name and permanently deletes all the archived log events associated with it.deleteLogGroupAsync
(DeleteLogGroupRequest request, AsyncHandler<DeleteLogGroupRequest, DeleteLogGroupResult> asyncHandler) Deletes the log group with the specified name and permanently deletes all the archived log events associated with it.Deletes a log stream and permanently deletes all the archived log events associated with it.deleteLogStreamAsync
(DeleteLogStreamRequest request, AsyncHandler<DeleteLogStreamRequest, DeleteLogStreamResult> asyncHandler) Deletes a log stream and permanently deletes all the archived log events associated with it.Deletes a metric filter associated with the specified log group.deleteMetricFilterAsync
(DeleteMetricFilterRequest request, AsyncHandler<DeleteMetricFilterRequest, DeleteMetricFilterResult> asyncHandler) Deletes a metric filter associated with the specified log group.Deletes the retention policy of the specified log group.deleteRetentionPolicyAsync
(DeleteRetentionPolicyRequest request, AsyncHandler<DeleteRetentionPolicyRequest, DeleteRetentionPolicyResult> asyncHandler) Deletes the retention policy of the specified log group.Deletes a subscription filter associated with the specified log group.deleteSubscriptionFilterAsync
(DeleteSubscriptionFilterRequest request, AsyncHandler<DeleteSubscriptionFilterRequest, DeleteSubscriptionFilterResult> asyncHandler) Deletes a subscription filter associated with the specified log group.Simplified method form for invoking the DescribeDestinations operation.describeDestinationsAsync
(AsyncHandler<DescribeDestinationsRequest, DescribeDestinationsResult> asyncHandler) Simplified method form for invoking the DescribeDestinations operation with an AsyncHandler.Returns all the destinations that are associated with the AWS account making the request.describeDestinationsAsync
(DescribeDestinationsRequest request, AsyncHandler<DescribeDestinationsRequest, DescribeDestinationsResult> asyncHandler) Returns all the destinations that are associated with the AWS account making the request.Returns all the export tasks that are associated with the AWS account making the request.describeExportTasksAsync
(DescribeExportTasksRequest request, AsyncHandler<DescribeExportTasksRequest, DescribeExportTasksResult> asyncHandler) Returns all the export tasks that are associated with the AWS account making the request.Simplified method form for invoking the DescribeLogGroups operation.Simplified method form for invoking the DescribeLogGroups operation with an AsyncHandler.Returns all the log groups that are associated with the AWS account making the request.describeLogGroupsAsync
(DescribeLogGroupsRequest request, AsyncHandler<DescribeLogGroupsRequest, DescribeLogGroupsResult> asyncHandler) Returns all the log groups that are associated with the AWS account making the request.Returns all the log streams that are associated with the specified log group.describeLogStreamsAsync
(DescribeLogStreamsRequest request, AsyncHandler<DescribeLogStreamsRequest, DescribeLogStreamsResult> asyncHandler) Returns all the log streams that are associated with the specified log group.Returns all the metrics filters associated with the specified log group.describeMetricFiltersAsync
(DescribeMetricFiltersRequest request, AsyncHandler<DescribeMetricFiltersRequest, DescribeMetricFiltersResult> asyncHandler) Returns all the metrics filters associated with the specified log group.Returns all the subscription filters associated with the specified log group.describeSubscriptionFiltersAsync
(DescribeSubscriptionFiltersRequest request, AsyncHandler<DescribeSubscriptionFiltersRequest, DescribeSubscriptionFiltersResult> asyncHandler) Returns all the subscription filters associated with the specified log group.Retrieves log events, optionally filtered by a filter pattern from the specified log group.filterLogEventsAsync
(FilterLogEventsRequest request, AsyncHandler<FilterLogEventsRequest, FilterLogEventsResult> asyncHandler) Retrieves log events, optionally filtered by a filter pattern from the specified log group.getLogEventsAsync
(GetLogEventsRequest request) Retrieves log events from the specified log stream.getLogEventsAsync
(GetLogEventsRequest request, AsyncHandler<GetLogEventsRequest, GetLogEventsResult> asyncHandler) Retrieves log events from the specified log stream.putDestinationAsync
(PutDestinationRequest request) Creates or updates aDestination
.putDestinationAsync
(PutDestinationRequest request, AsyncHandler<PutDestinationRequest, PutDestinationResult> asyncHandler) Creates or updates aDestination
.Creates or updates an access policy associated with an existingDestination
.putDestinationPolicyAsync
(PutDestinationPolicyRequest request, AsyncHandler<PutDestinationPolicyRequest, PutDestinationPolicyResult> asyncHandler) Creates or updates an access policy associated with an existingDestination
.putLogEventsAsync
(PutLogEventsRequest request) Uploads a batch of log events to the specified log stream.putLogEventsAsync
(PutLogEventsRequest request, AsyncHandler<PutLogEventsRequest, PutLogEventsResult> asyncHandler) Uploads a batch of log events to the specified log stream.Creates or updates a metric filter and associates it with the specified log group.putMetricFilterAsync
(PutMetricFilterRequest request, AsyncHandler<PutMetricFilterRequest, PutMetricFilterResult> asyncHandler) Creates or updates a metric filter and associates it with the specified log group.Sets the retention of the specified log group.putRetentionPolicyAsync
(PutRetentionPolicyRequest request, AsyncHandler<PutRetentionPolicyRequest, PutRetentionPolicyResult> asyncHandler) Sets the retention of the specified log group.Creates or updates a subscription filter and associates it with the specified log group.putSubscriptionFilterAsync
(PutSubscriptionFilterRequest request, AsyncHandler<PutSubscriptionFilterRequest, PutSubscriptionFilterResult> asyncHandler) Creates or updates a subscription filter and associates it with the specified log group.Tests the filter pattern of a metric filter against a sample of log event messages.testMetricFilterAsync
(TestMetricFilterRequest request, AsyncHandler<TestMetricFilterRequest, TestMetricFilterResult> asyncHandler) Tests the filter pattern of a metric filter against a sample of log event messages.Methods inherited from class com.amazonaws.services.logs.AbstractAWSLogs
cancelExportTask, createExportTask, createLogGroup, createLogStream, deleteDestination, deleteLogGroup, deleteLogStream, deleteMetricFilter, deleteRetentionPolicy, deleteSubscriptionFilter, describeDestinations, describeDestinations, describeExportTasks, describeLogGroups, describeLogGroups, describeLogStreams, describeMetricFilters, describeSubscriptionFilters, filterLogEvents, getCachedResponseMetadata, getLogEvents, putDestination, putDestinationPolicy, putLogEvents, putMetricFilter, putRetentionPolicy, putSubscriptionFilter, setEndpoint, setRegion, shutdown, testMetricFilter
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface com.amazonaws.services.logs.AWSLogs
cancelExportTask, createExportTask, createLogGroup, createLogStream, deleteDestination, deleteLogGroup, deleteLogStream, deleteMetricFilter, deleteRetentionPolicy, deleteSubscriptionFilter, describeDestinations, describeDestinations, describeExportTasks, describeLogGroups, describeLogGroups, describeLogStreams, describeMetricFilters, describeSubscriptionFilters, filterLogEvents, getCachedResponseMetadata, getLogEvents, putDestination, putDestinationPolicy, putLogEvents, putMetricFilter, putRetentionPolicy, putSubscriptionFilter, setEndpoint, setRegion, shutdown, testMetricFilter
-
Constructor Details
-
AbstractAWSLogsAsync
protected AbstractAWSLogsAsync()
-
-
Method Details
-
cancelExportTaskAsync
Description copied from interface:AWSLogsAsync
Cancels an export task if it is in
PENDING
orRUNNING
state.- Specified by:
cancelExportTaskAsync
in interfaceAWSLogsAsync
- Parameters:
request
-- Returns:
- A Java Future containing the result of the CancelExportTask operation returned by the service.
-
cancelExportTaskAsync
public Future<CancelExportTaskResult> cancelExportTaskAsync(CancelExportTaskRequest request, AsyncHandler<CancelExportTaskRequest, CancelExportTaskResult> asyncHandler) Description copied from interface:AWSLogsAsync
Cancels an export task if it is in
PENDING
orRUNNING
state.- Specified by:
cancelExportTaskAsync
in interfaceAWSLogsAsync
- Parameters:
request
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the CancelExportTask operation returned by the service.
-
createExportTaskAsync
Description copied from interface:AWSLogsAsync
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
orPENDING
) 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.
- Specified by:
createExportTaskAsync
in interfaceAWSLogsAsync
- Parameters:
request
-- Returns:
- A Java Future containing the result of the CreateExportTask operation returned by the service.
-
createExportTaskAsync
public Future<CreateExportTaskResult> createExportTaskAsync(CreateExportTaskRequest request, AsyncHandler<CreateExportTaskRequest, CreateExportTaskResult> asyncHandler) Description copied from interface:AWSLogsAsync
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
orPENDING
) 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.
- Specified by:
createExportTaskAsync
in interfaceAWSLogsAsync
- Parameters:
request
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the CreateExportTask operation returned by the service.
-
createLogGroupAsync
Description copied from interface:AWSLogsAsync
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.
You must use the following guidelines when naming a log group:
- 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).
- Specified by:
createLogGroupAsync
in interfaceAWSLogsAsync
- Parameters:
request
-- Returns:
- A Java Future containing the result of the CreateLogGroup operation returned by the service.
-
createLogGroupAsync
public Future<CreateLogGroupResult> createLogGroupAsync(CreateLogGroupRequest request, AsyncHandler<CreateLogGroupRequest, CreateLogGroupResult> asyncHandler) Description copied from interface:AWSLogsAsync
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.
You must use the following guidelines when naming a log group:
- 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).
- Specified by:
createLogGroupAsync
in interfaceAWSLogsAsync
- Parameters:
request
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the CreateLogGroup operation returned by the service.
-
createLogStreamAsync
Description copied from interface:AWSLogsAsync
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.
You must use the following guidelines when naming a log stream:
- Log stream names can be between 1 and 512 characters long.
- The ':' colon character is not allowed.
- Specified by:
createLogStreamAsync
in interfaceAWSLogsAsync
- Parameters:
request
-- Returns:
- A Java Future containing the result of the CreateLogStream operation returned by the service.
-
createLogStreamAsync
public Future<CreateLogStreamResult> createLogStreamAsync(CreateLogStreamRequest request, AsyncHandler<CreateLogStreamRequest, CreateLogStreamResult> asyncHandler) Description copied from interface:AWSLogsAsync
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.
You must use the following guidelines when naming a log stream:
- Log stream names can be between 1 and 512 characters long.
- The ':' colon character is not allowed.
- Specified by:
createLogStreamAsync
in interfaceAWSLogsAsync
- Parameters:
request
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the CreateLogStream operation returned by the service.
-
deleteDestinationAsync
Description copied from interface:AWSLogsAsync
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.
- Specified by:
deleteDestinationAsync
in interfaceAWSLogsAsync
- Parameters:
request
-- Returns:
- A Java Future containing the result of the DeleteDestination operation returned by the service.
-
deleteDestinationAsync
public Future<DeleteDestinationResult> deleteDestinationAsync(DeleteDestinationRequest request, AsyncHandler<DeleteDestinationRequest, DeleteDestinationResult> asyncHandler) Description copied from interface:AWSLogsAsync
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.
- Specified by:
deleteDestinationAsync
in interfaceAWSLogsAsync
- Parameters:
request
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the DeleteDestination operation returned by the service.
-
deleteLogGroupAsync
Description copied from interface:AWSLogsAsync
Deletes the log group with the specified name and permanently deletes all the archived log events associated with it.
- Specified by:
deleteLogGroupAsync
in interfaceAWSLogsAsync
- Parameters:
request
-- Returns:
- A Java Future containing the result of the DeleteLogGroup operation returned by the service.
-
deleteLogGroupAsync
public Future<DeleteLogGroupResult> deleteLogGroupAsync(DeleteLogGroupRequest request, AsyncHandler<DeleteLogGroupRequest, DeleteLogGroupResult> asyncHandler) Description copied from interface:AWSLogsAsync
Deletes the log group with the specified name and permanently deletes all the archived log events associated with it.
- Specified by:
deleteLogGroupAsync
in interfaceAWSLogsAsync
- Parameters:
request
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the DeleteLogGroup operation returned by the service.
-
deleteLogStreamAsync
Description copied from interface:AWSLogsAsync
Deletes a log stream and permanently deletes all the archived log events associated with it.
- Specified by:
deleteLogStreamAsync
in interfaceAWSLogsAsync
- Parameters:
request
-- Returns:
- A Java Future containing the result of the DeleteLogStream operation returned by the service.
-
deleteLogStreamAsync
public Future<DeleteLogStreamResult> deleteLogStreamAsync(DeleteLogStreamRequest request, AsyncHandler<DeleteLogStreamRequest, DeleteLogStreamResult> asyncHandler) Description copied from interface:AWSLogsAsync
Deletes a log stream and permanently deletes all the archived log events associated with it.
- Specified by:
deleteLogStreamAsync
in interfaceAWSLogsAsync
- Parameters:
request
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the DeleteLogStream operation returned by the service.
-
deleteMetricFilterAsync
Description copied from interface:AWSLogsAsync
Deletes a metric filter associated with the specified log group.
- Specified by:
deleteMetricFilterAsync
in interfaceAWSLogsAsync
- Parameters:
request
-- Returns:
- A Java Future containing the result of the DeleteMetricFilter operation returned by the service.
-
deleteMetricFilterAsync
public Future<DeleteMetricFilterResult> deleteMetricFilterAsync(DeleteMetricFilterRequest request, AsyncHandler<DeleteMetricFilterRequest, DeleteMetricFilterResult> asyncHandler) Description copied from interface:AWSLogsAsync
Deletes a metric filter associated with the specified log group.
- Specified by:
deleteMetricFilterAsync
in interfaceAWSLogsAsync
- Parameters:
request
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the DeleteMetricFilter operation returned by the service.
-
deleteRetentionPolicyAsync
public Future<DeleteRetentionPolicyResult> deleteRetentionPolicyAsync(DeleteRetentionPolicyRequest request) Description copied from interface:AWSLogsAsync
Deletes the retention policy of the specified log group. Log events would not expire if they belong to log groups without a retention policy.
- Specified by:
deleteRetentionPolicyAsync
in interfaceAWSLogsAsync
- Parameters:
request
-- Returns:
- A Java Future containing the result of the DeleteRetentionPolicy operation returned by the service.
-
deleteRetentionPolicyAsync
public Future<DeleteRetentionPolicyResult> deleteRetentionPolicyAsync(DeleteRetentionPolicyRequest request, AsyncHandler<DeleteRetentionPolicyRequest, DeleteRetentionPolicyResult> asyncHandler) Description copied from interface:AWSLogsAsync
Deletes the retention policy of the specified log group. Log events would not expire if they belong to log groups without a retention policy.
- Specified by:
deleteRetentionPolicyAsync
in interfaceAWSLogsAsync
- Parameters:
request
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the DeleteRetentionPolicy operation returned by the service.
-
deleteSubscriptionFilterAsync
public Future<DeleteSubscriptionFilterResult> deleteSubscriptionFilterAsync(DeleteSubscriptionFilterRequest request) Description copied from interface:AWSLogsAsync
Deletes a subscription filter associated with the specified log group.
- Specified by:
deleteSubscriptionFilterAsync
in interfaceAWSLogsAsync
- Parameters:
request
-- Returns:
- A Java Future containing the result of the DeleteSubscriptionFilter operation returned by the service.
-
deleteSubscriptionFilterAsync
public Future<DeleteSubscriptionFilterResult> deleteSubscriptionFilterAsync(DeleteSubscriptionFilterRequest request, AsyncHandler<DeleteSubscriptionFilterRequest, DeleteSubscriptionFilterResult> asyncHandler) Description copied from interface:AWSLogsAsync
Deletes a subscription filter associated with the specified log group.
- Specified by:
deleteSubscriptionFilterAsync
in interfaceAWSLogsAsync
- Parameters:
request
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the DeleteSubscriptionFilter operation returned by the service.
-
describeDestinationsAsync
public Future<DescribeDestinationsResult> describeDestinationsAsync(DescribeDestinationsRequest request) Description copied from interface:AWSLogsAsync
Returns all the destinations that are associated with the AWS account making the request. The list returned in the response is ASCII-sorted by destination name.
By default, this operation returns up to 50 destinations. If there are more destinations to list, the response would contain a
nextToken
value in the response body. You can also limit the number of destinations returned in the response by specifying thelimit
parameter in the request.- Specified by:
describeDestinationsAsync
in interfaceAWSLogsAsync
- Parameters:
request
-- Returns:
- A Java Future containing the result of the DescribeDestinations operation returned by the service.
-
describeDestinationsAsync
public Future<DescribeDestinationsResult> describeDestinationsAsync(DescribeDestinationsRequest request, AsyncHandler<DescribeDestinationsRequest, DescribeDestinationsResult> asyncHandler) Description copied from interface:AWSLogsAsync
Returns all the destinations that are associated with the AWS account making the request. The list returned in the response is ASCII-sorted by destination name.
By default, this operation returns up to 50 destinations. If there are more destinations to list, the response would contain a
nextToken
value in the response body. You can also limit the number of destinations returned in the response by specifying thelimit
parameter in the request.- Specified by:
describeDestinationsAsync
in interfaceAWSLogsAsync
- Parameters:
request
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the DescribeDestinations operation returned by the service.
-
describeDestinationsAsync
Simplified method form for invoking the DescribeDestinations operation.- Specified by:
describeDestinationsAsync
in interfaceAWSLogsAsync
- See Also:
-
describeDestinationsAsync
public Future<DescribeDestinationsResult> describeDestinationsAsync(AsyncHandler<DescribeDestinationsRequest, DescribeDestinationsResult> asyncHandler) Simplified method form for invoking the DescribeDestinations operation with an AsyncHandler.- Specified by:
describeDestinationsAsync
in interfaceAWSLogsAsync
- See Also:
-
describeExportTasksAsync
public Future<DescribeExportTasksResult> describeExportTasksAsync(DescribeExportTasksRequest request) Description copied from interface:AWSLogsAsync
Returns all the export tasks that are associated with the AWS account making the request. The export tasks can be filtered based on
TaskId
orTaskStatus
.By default, this operation returns up to 50 export tasks that satisfy the specified filters. If there are more export tasks to list, the response would contain a
nextToken
value in the response body. You can also limit the number of export tasks returned in the response by specifying thelimit
parameter in the request.- Specified by:
describeExportTasksAsync
in interfaceAWSLogsAsync
- Parameters:
request
-- Returns:
- A Java Future containing the result of the DescribeExportTasks operation returned by the service.
-
describeExportTasksAsync
public Future<DescribeExportTasksResult> describeExportTasksAsync(DescribeExportTasksRequest request, AsyncHandler<DescribeExportTasksRequest, DescribeExportTasksResult> asyncHandler) Description copied from interface:AWSLogsAsync
Returns all the export tasks that are associated with the AWS account making the request. The export tasks can be filtered based on
TaskId
orTaskStatus
.By default, this operation returns up to 50 export tasks that satisfy the specified filters. If there are more export tasks to list, the response would contain a
nextToken
value in the response body. You can also limit the number of export tasks returned in the response by specifying thelimit
parameter in the request.- Specified by:
describeExportTasksAsync
in interfaceAWSLogsAsync
- Parameters:
request
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the DescribeExportTasks operation returned by the service.
-
describeLogGroupsAsync
Description copied from interface:AWSLogsAsync
Returns all the log groups that are associated with the AWS account making the request. The list returned in the response is ASCII-sorted by log group name.
By default, this operation returns up to 50 log groups. If there are more log groups to list, the response would contain a
nextToken
value in the response body. You can also limit the number of log groups returned in the response by specifying thelimit
parameter in the request.- Specified by:
describeLogGroupsAsync
in interfaceAWSLogsAsync
- Parameters:
request
-- Returns:
- A Java Future containing the result of the DescribeLogGroups operation returned by the service.
-
describeLogGroupsAsync
public Future<DescribeLogGroupsResult> describeLogGroupsAsync(DescribeLogGroupsRequest request, AsyncHandler<DescribeLogGroupsRequest, DescribeLogGroupsResult> asyncHandler) Description copied from interface:AWSLogsAsync
Returns all the log groups that are associated with the AWS account making the request. The list returned in the response is ASCII-sorted by log group name.
By default, this operation returns up to 50 log groups. If there are more log groups to list, the response would contain a
nextToken
value in the response body. You can also limit the number of log groups returned in the response by specifying thelimit
parameter in the request.- Specified by:
describeLogGroupsAsync
in interfaceAWSLogsAsync
- Parameters:
request
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the DescribeLogGroups operation returned by the service.
-
describeLogGroupsAsync
Simplified method form for invoking the DescribeLogGroups operation.- Specified by:
describeLogGroupsAsync
in interfaceAWSLogsAsync
- See Also:
-
describeLogGroupsAsync
public Future<DescribeLogGroupsResult> describeLogGroupsAsync(AsyncHandler<DescribeLogGroupsRequest, DescribeLogGroupsResult> asyncHandler) Simplified method form for invoking the DescribeLogGroups operation with an AsyncHandler.- Specified by:
describeLogGroupsAsync
in interfaceAWSLogsAsync
- See Also:
-
describeLogStreamsAsync
Description copied from interface:AWSLogsAsync
Returns all the log streams that are associated with the specified log group. The list returned in the response is ASCII-sorted by log stream name.
By default, this operation returns up to 50 log streams. If there are more log streams to list, the response would contain a
nextToken
value in the response body. You can also limit the number of log streams returned in the response by specifying thelimit
parameter in the request. This operation has a limit of five transactions per second, after which transactions are throttled.- Specified by:
describeLogStreamsAsync
in interfaceAWSLogsAsync
- Parameters:
request
-- Returns:
- A Java Future containing the result of the DescribeLogStreams operation returned by the service.
-
describeLogStreamsAsync
public Future<DescribeLogStreamsResult> describeLogStreamsAsync(DescribeLogStreamsRequest request, AsyncHandler<DescribeLogStreamsRequest, DescribeLogStreamsResult> asyncHandler) Description copied from interface:AWSLogsAsync
Returns all the log streams that are associated with the specified log group. The list returned in the response is ASCII-sorted by log stream name.
By default, this operation returns up to 50 log streams. If there are more log streams to list, the response would contain a
nextToken
value in the response body. You can also limit the number of log streams returned in the response by specifying thelimit
parameter in the request. This operation has a limit of five transactions per second, after which transactions are throttled.- Specified by:
describeLogStreamsAsync
in interfaceAWSLogsAsync
- Parameters:
request
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the DescribeLogStreams operation returned by the service.
-
describeMetricFiltersAsync
public Future<DescribeMetricFiltersResult> describeMetricFiltersAsync(DescribeMetricFiltersRequest request) Description copied from interface:AWSLogsAsync
Returns all the metrics filters associated with the specified log group. The list returned in the response is ASCII-sorted by filter name.
By default, this operation returns up to 50 metric filters. If there are more metric filters to list, the response would contain a
nextToken
value in the response body. You can also limit the number of metric filters returned in the response by specifying thelimit
parameter in the request.- Specified by:
describeMetricFiltersAsync
in interfaceAWSLogsAsync
- Parameters:
request
-- Returns:
- A Java Future containing the result of the DescribeMetricFilters operation returned by the service.
-
describeMetricFiltersAsync
public Future<DescribeMetricFiltersResult> describeMetricFiltersAsync(DescribeMetricFiltersRequest request, AsyncHandler<DescribeMetricFiltersRequest, DescribeMetricFiltersResult> asyncHandler) Description copied from interface:AWSLogsAsync
Returns all the metrics filters associated with the specified log group. The list returned in the response is ASCII-sorted by filter name.
By default, this operation returns up to 50 metric filters. If there are more metric filters to list, the response would contain a
nextToken
value in the response body. You can also limit the number of metric filters returned in the response by specifying thelimit
parameter in the request.- Specified by:
describeMetricFiltersAsync
in interfaceAWSLogsAsync
- Parameters:
request
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the DescribeMetricFilters operation returned by the service.
-
describeSubscriptionFiltersAsync
public Future<DescribeSubscriptionFiltersResult> describeSubscriptionFiltersAsync(DescribeSubscriptionFiltersRequest request) Description copied from interface:AWSLogsAsync
Returns all the subscription filters associated with the specified log group. The list returned in the response is ASCII-sorted by filter name.
By default, this operation returns up to 50 subscription filters. If there are more subscription filters to list, the response would contain a
nextToken
value in the response body. You can also limit the number of subscription filters returned in the response by specifying thelimit
parameter in the request.- Specified by:
describeSubscriptionFiltersAsync
in interfaceAWSLogsAsync
- Parameters:
request
-- Returns:
- A Java Future containing the result of the DescribeSubscriptionFilters operation returned by the service.
-
describeSubscriptionFiltersAsync
public Future<DescribeSubscriptionFiltersResult> describeSubscriptionFiltersAsync(DescribeSubscriptionFiltersRequest request, AsyncHandler<DescribeSubscriptionFiltersRequest, DescribeSubscriptionFiltersResult> asyncHandler) Description copied from interface:AWSLogsAsync
Returns all the subscription filters associated with the specified log group. The list returned in the response is ASCII-sorted by filter name.
By default, this operation returns up to 50 subscription filters. If there are more subscription filters to list, the response would contain a
nextToken
value in the response body. You can also limit the number of subscription filters returned in the response by specifying thelimit
parameter in the request.- Specified by:
describeSubscriptionFiltersAsync
in interfaceAWSLogsAsync
- Parameters:
request
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the DescribeSubscriptionFilters operation returned by the service.
-
filterLogEventsAsync
Description copied from interface:AWSLogsAsync
Retrieves log events, optionally filtered by a filter pattern from the specified log group. You can provide an optional time range to filter the results on the event
timestamp
. You can limit the streams searched to an explicit list oflogStreamNames
.By default, this operation returns as much matching log events as can fit in a response size of 1MB, up to 10,000 log events, or all the events found within a time-bounded scan window. If the response includes a
nextToken
, then there is more data to search, and the search can be resumed with a new request providing the nextToken. The response will contain a list ofsearchedLogStreams
that contains information about which streams were searched in the request and whether they have been searched completely or require further pagination. Thelimit
parameter in the request. can be used to specify the maximum number of events to return in a page.- Specified by:
filterLogEventsAsync
in interfaceAWSLogsAsync
- Parameters:
request
-- Returns:
- A Java Future containing the result of the FilterLogEvents operation returned by the service.
-
filterLogEventsAsync
public Future<FilterLogEventsResult> filterLogEventsAsync(FilterLogEventsRequest request, AsyncHandler<FilterLogEventsRequest, FilterLogEventsResult> asyncHandler) Description copied from interface:AWSLogsAsync
Retrieves log events, optionally filtered by a filter pattern from the specified log group. You can provide an optional time range to filter the results on the event
timestamp
. You can limit the streams searched to an explicit list oflogStreamNames
.By default, this operation returns as much matching log events as can fit in a response size of 1MB, up to 10,000 log events, or all the events found within a time-bounded scan window. If the response includes a
nextToken
, then there is more data to search, and the search can be resumed with a new request providing the nextToken. The response will contain a list ofsearchedLogStreams
that contains information about which streams were searched in the request and whether they have been searched completely or require further pagination. Thelimit
parameter in the request. can be used to specify the maximum number of events to return in a page.- Specified by:
filterLogEventsAsync
in interfaceAWSLogsAsync
- Parameters:
request
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the FilterLogEvents operation returned by the service.
-
getLogEventsAsync
Description copied from interface:AWSLogsAsync
Retrieves log events from the specified log stream. You can provide an optional time range to filter the results on the event
timestamp
.By default, this operation returns as much log events as can fit in a response size of 1MB, up to 10,000 log events. The response will always include a
nextForwardToken
and anextBackwardToken
in the response body. You can use any of these tokens in subsequentGetLogEvents
requests to paginate through events in either forward or backward direction. You can also limit the number of log events returned in the response by specifying thelimit
parameter in the request.- Specified by:
getLogEventsAsync
in interfaceAWSLogsAsync
- Parameters:
request
-- Returns:
- A Java Future containing the result of the GetLogEvents operation returned by the service.
-
getLogEventsAsync
public Future<GetLogEventsResult> getLogEventsAsync(GetLogEventsRequest request, AsyncHandler<GetLogEventsRequest, GetLogEventsResult> asyncHandler) Description copied from interface:AWSLogsAsync
Retrieves log events from the specified log stream. You can provide an optional time range to filter the results on the event
timestamp
.By default, this operation returns as much log events as can fit in a response size of 1MB, up to 10,000 log events. The response will always include a
nextForwardToken
and anextBackwardToken
in the response body. You can use any of these tokens in subsequentGetLogEvents
requests to paginate through events in either forward or backward direction. You can also limit the number of log events returned in the response by specifying thelimit
parameter in the request.- Specified by:
getLogEventsAsync
in interfaceAWSLogsAsync
- Parameters:
request
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the GetLogEvents operation returned by the service.
-
putDestinationAsync
Description copied from interface:AWSLogsAsync
Creates or updates a
Destination
. A destination encapsulates a physical resource (such as a Kinesis stream) and allows you to subscribe to a real-time stream of log events of a different account, ingested throughPutLogEvents
requests. Currently, the only supported physical resource is a Amazon Kinesis stream belonging to the same account as the destination.A destination controls what is written to its Amazon Kinesis stream through an access policy. By default, PutDestination does not set any access policy with the destination, which means a cross-account user will not be able to call
PutSubscriptionFilter
against this destination. To enable that, the destination owner must callPutDestinationPolicy
after PutDestination.- Specified by:
putDestinationAsync
in interfaceAWSLogsAsync
- Parameters:
request
-- Returns:
- A Java Future containing the result of the PutDestination operation returned by the service.
-
putDestinationAsync
public Future<PutDestinationResult> putDestinationAsync(PutDestinationRequest request, AsyncHandler<PutDestinationRequest, PutDestinationResult> asyncHandler) Description copied from interface:AWSLogsAsync
Creates or updates a
Destination
. A destination encapsulates a physical resource (such as a Kinesis stream) and allows you to subscribe to a real-time stream of log events of a different account, ingested throughPutLogEvents
requests. Currently, the only supported physical resource is a Amazon Kinesis stream belonging to the same account as the destination.A destination controls what is written to its Amazon Kinesis stream through an access policy. By default, PutDestination does not set any access policy with the destination, which means a cross-account user will not be able to call
PutSubscriptionFilter
against this destination. To enable that, the destination owner must callPutDestinationPolicy
after PutDestination.- Specified by:
putDestinationAsync
in interfaceAWSLogsAsync
- Parameters:
request
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the PutDestination operation returned by the service.
-
putDestinationPolicyAsync
public Future<PutDestinationPolicyResult> putDestinationPolicyAsync(PutDestinationPolicyRequest request) Description copied from interface:AWSLogsAsync
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.- Specified by:
putDestinationPolicyAsync
in interfaceAWSLogsAsync
- Parameters:
request
-- Returns:
- A Java Future containing the result of the PutDestinationPolicy operation returned by the service.
-
putDestinationPolicyAsync
public Future<PutDestinationPolicyResult> putDestinationPolicyAsync(PutDestinationPolicyRequest request, AsyncHandler<PutDestinationPolicyRequest, PutDestinationPolicyResult> asyncHandler) Description copied from interface:AWSLogsAsync
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.- Specified by:
putDestinationPolicyAsync
in interfaceAWSLogsAsync
- Parameters:
request
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the PutDestinationPolicy operation returned by the service.
-
putLogEventsAsync
Description copied from interface:AWSLogsAsync
Uploads a batch of log events to the specified log stream.
Every PutLogEvents request must include the
sequenceToken
obtained from the response of the previous request. An upload in a newly created log stream does not require asequenceToken
.The batch of events must satisfy the following constraints:
- The maximum batch size is 1,048,576 bytes, and 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 older than 14 days or the retention period of the log group.
- The log events in the batch must be in chronological ordered by their
timestamp
. - The maximum number of log events in a batch is 10,000.
- A batch of log events in a single PutLogEvents request cannot span more than 24 hours. Otherwise, the PutLogEvents operation will fail.
- Specified by:
putLogEventsAsync
in interfaceAWSLogsAsync
- Parameters:
request
-- Returns:
- A Java Future containing the result of the PutLogEvents operation returned by the service.
-
putLogEventsAsync
public Future<PutLogEventsResult> putLogEventsAsync(PutLogEventsRequest request, AsyncHandler<PutLogEventsRequest, PutLogEventsResult> asyncHandler) Description copied from interface:AWSLogsAsync
Uploads a batch of log events to the specified log stream.
Every PutLogEvents request must include the
sequenceToken
obtained from the response of the previous request. An upload in a newly created log stream does not require asequenceToken
.The batch of events must satisfy the following constraints:
- The maximum batch size is 1,048,576 bytes, and 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 older than 14 days or the retention period of the log group.
- The log events in the batch must be in chronological ordered by their
timestamp
. - The maximum number of log events in a batch is 10,000.
- A batch of log events in a single PutLogEvents request cannot span more than 24 hours. Otherwise, the PutLogEvents operation will fail.
- Specified by:
putLogEventsAsync
in interfaceAWSLogsAsync
- Parameters:
request
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the PutLogEvents operation returned by the service.
-
putMetricFilterAsync
Description copied from interface:AWSLogsAsync
Creates or updates a metric filter and associates it with the specified log group. Metric filters allow you to configure rules to extract metric data from log events ingested through
PutLogEvents
requests.The maximum number of metric filters that can be associated with a log group is 100.
- Specified by:
putMetricFilterAsync
in interfaceAWSLogsAsync
- Parameters:
request
-- Returns:
- A Java Future containing the result of the PutMetricFilter operation returned by the service.
-
putMetricFilterAsync
public Future<PutMetricFilterResult> putMetricFilterAsync(PutMetricFilterRequest request, AsyncHandler<PutMetricFilterRequest, PutMetricFilterResult> asyncHandler) Description copied from interface:AWSLogsAsync
Creates or updates a metric filter and associates it with the specified log group. Metric filters allow you to configure rules to extract metric data from log events ingested through
PutLogEvents
requests.The maximum number of metric filters that can be associated with a log group is 100.
- Specified by:
putMetricFilterAsync
in interfaceAWSLogsAsync
- Parameters:
request
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the PutMetricFilter operation returned by the service.
-
putRetentionPolicyAsync
Description copied from interface:AWSLogsAsync
Sets the retention of the specified log group. A retention policy allows you to configure the number of days you want to retain log events in the specified log group.
- Specified by:
putRetentionPolicyAsync
in interfaceAWSLogsAsync
- Parameters:
request
-- Returns:
- A Java Future containing the result of the PutRetentionPolicy operation returned by the service.
-
putRetentionPolicyAsync
public Future<PutRetentionPolicyResult> putRetentionPolicyAsync(PutRetentionPolicyRequest request, AsyncHandler<PutRetentionPolicyRequest, PutRetentionPolicyResult> asyncHandler) Description copied from interface:AWSLogsAsync
Sets the retention of the specified log group. A retention policy allows you to configure the number of days you want to retain log events in the specified log group.
- Specified by:
putRetentionPolicyAsync
in interfaceAWSLogsAsync
- Parameters:
request
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the PutRetentionPolicy operation returned by the service.
-
putSubscriptionFilterAsync
public Future<PutSubscriptionFilterResult> putSubscriptionFilterAsync(PutSubscriptionFilterRequest request) Description copied from interface:AWSLogsAsync
Creates or updates a subscription filter and associates it with the specified log group. Subscription filters allow you to subscribe to a real-time stream of log events ingested through
PutLogEvents
requests and have them delivered to a specific destination. Currently, the supported destinations are:- An Amazon Kinesis stream belonging to the same account as the subscription filter, for same-account delivery.
- A logical destination (used via an ARN of
Destination
) belonging to a different account, for cross-account delivery. - An Amazon Kinesis Firehose stream belonging to the same account as the subscription filter, for same-account delivery.
- An AWS Lambda function belonging to the same account as the subscription filter, for same-account delivery.
Currently there can only be one subscription filter associated with a log group.
- Specified by:
putSubscriptionFilterAsync
in interfaceAWSLogsAsync
- Parameters:
request
-- Returns:
- A Java Future containing the result of the PutSubscriptionFilter operation returned by the service.
-
putSubscriptionFilterAsync
public Future<PutSubscriptionFilterResult> putSubscriptionFilterAsync(PutSubscriptionFilterRequest request, AsyncHandler<PutSubscriptionFilterRequest, PutSubscriptionFilterResult> asyncHandler) Description copied from interface:AWSLogsAsync
Creates or updates a subscription filter and associates it with the specified log group. Subscription filters allow you to subscribe to a real-time stream of log events ingested through
PutLogEvents
requests and have them delivered to a specific destination. Currently, the supported destinations are:- An Amazon Kinesis stream belonging to the same account as the subscription filter, for same-account delivery.
- A logical destination (used via an ARN of
Destination
) belonging to a different account, for cross-account delivery. - An Amazon Kinesis Firehose stream belonging to the same account as the subscription filter, for same-account delivery.
- An AWS Lambda function belonging to the same account as the subscription filter, for same-account delivery.
Currently there can only be one subscription filter associated with a log group.
- Specified by:
putSubscriptionFilterAsync
in interfaceAWSLogsAsync
- Parameters:
request
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the PutSubscriptionFilter operation returned by the service.
-
testMetricFilterAsync
Description copied from interface:AWSLogsAsync
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.
- Specified by:
testMetricFilterAsync
in interfaceAWSLogsAsync
- Parameters:
request
-- Returns:
- A Java Future containing the result of the TestMetricFilter operation returned by the service.
-
testMetricFilterAsync
public Future<TestMetricFilterResult> testMetricFilterAsync(TestMetricFilterRequest request, AsyncHandler<TestMetricFilterRequest, TestMetricFilterResult> asyncHandler) Description copied from interface:AWSLogsAsync
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.
- Specified by:
testMetricFilterAsync
in interfaceAWSLogsAsync
- Parameters:
request
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the TestMetricFilter operation returned by the service.
-