CloudWatchLogs / Paginator / DescribeLogGroups
DescribeLogGroups#
- class CloudWatchLogs.Paginator.DescribeLogGroups#
paginator = client.get_paginator('describe_log_groups')
- paginate(**kwargs)#
Creates an iterator that will paginate through responses from
CloudWatchLogs.Client.describe_log_groups()
.See also: AWS API Documentation
Request Syntax
response_iterator = paginator.paginate( accountIdentifiers=[ 'string', ], logGroupNamePrefix='string', logGroupNamePattern='string', includeLinkedAccounts=True|False, logGroupClass='STANDARD'|'INFREQUENT_ACCESS', PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } )
- Parameters:
accountIdentifiers (list) –
When
includeLinkedAccounts
is set toTrue
, use this parameter to specify the list of accounts to search. You can specify as many as 20 account IDs in the array.(string) –
logGroupNamePrefix (string) –
The prefix to match.
Note
logGroupNamePrefix
andlogGroupNamePattern
are mutually exclusive. Only one of these parameters can be passed.logGroupNamePattern (string) –
If you specify a string for this parameter, the operation returns only log groups that have names that match the string based on a case-sensitive substring search. For example, if you specify
Foo
, log groups namedFooBar
,aws/Foo
, andGroupFoo
would match, butfoo
,F/o/o
andFroo
would not match.If you specify
logGroupNamePattern
in your request, then onlyarn
,creationTime
, andlogGroupName
are included in the response.Note
logGroupNamePattern
andlogGroupNamePrefix
are mutually exclusive. Only one of these parameters can be passed.includeLinkedAccounts (boolean) –
If you are using a monitoring account, set this to
True
to have the operation return log groups in the accounts listed inaccountIdentifiers
.If this parameter is set to
true
andaccountIdentifiers
contains a null value, the operation returns all log groups in the monitoring account and all log groups in all source accounts that are linked to the monitoring account.logGroupClass (string) –
Specifies the log group class for this log group. There are two classes:
The
Standard
log class supports all CloudWatch Logs features.The
Infrequent Access
log class supports a subset of CloudWatch Logs features and incurs lower costs.
For details about the features supported by each class, see Log classes
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
MaxItems (integer) –
The total number of items to return. If the total number of items available is more than the value specified in max-items then a
NextToken
will be provided in the output that you can use to resume pagination.PageSize (integer) –
The size of each page.
StartingToken (string) –
A token to specify where to start paginating. This is the
NextToken
from a previous response.
- Return type:
dict
- Returns:
Response Syntax
{ 'logGroups': [ { 'logGroupName': 'string', 'creationTime': 123, 'retentionInDays': 123, 'metricFilterCount': 123, 'arn': 'string', 'storedBytes': 123, 'kmsKeyId': 'string', 'dataProtectionStatus': 'ACTIVATED'|'DELETED'|'ARCHIVED'|'DISABLED', 'inheritedProperties': [ 'ACCOUNT_DATA_PROTECTION', ], 'logGroupClass': 'STANDARD'|'INFREQUENT_ACCESS', 'logGroupArn': 'string' }, ], 'NextToken': 'string' }
Response Structure
(dict) –
logGroups (list) –
The log groups.
If the
retentionInDays
value is not included for a log group, then that log group’s events do not expire.(dict) –
Represents a log group.
logGroupName (string) –
The name of the log group.
creationTime (integer) –
The creation time of the log group, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.
retentionInDays (integer) –
The number of days to retain the log events in the specified log group. Possible values are: 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731, 1096, 1827, 2192, 2557, 2922, 3288, and 3653.
To set a log group so that its log events do not expire, use DeleteRetentionPolicy.
metricFilterCount (integer) –
The number of metric filters.
arn (string) –
The Amazon Resource Name (ARN) of the log group. This version of the ARN includes a trailing
:*
after the log group name.Use this version to refer to the ARN in IAM policies when specifying permissions for most API actions. The exception is when specifying permissions for TagResource, UntagResource, and ListTagsForResource. The permissions for those three actions require the ARN version that doesn’t include a trailing
:*
.storedBytes (integer) –
The number of bytes stored.
kmsKeyId (string) –
The Amazon Resource Name (ARN) of the KMS key to use when encrypting log data.
dataProtectionStatus (string) –
Displays whether this log group has a protection policy, or whether it had one in the past. For more information, see PutDataProtectionPolicy.
inheritedProperties (list) –
Displays all the properties that this log group has inherited from account-level settings.
(string) –
logGroupClass (string) –
This specifies the log group class for this log group. There are two classes:
The
Standard
log class supports all CloudWatch Logs features.The
Infrequent Access
log class supports a subset of CloudWatch Logs features and incurs lower costs.
For details about the features supported by each class, see Log classes
logGroupArn (string) –
The Amazon Resource Name (ARN) of the log group. This version of the ARN doesn’t include a trailing
:*
after the log group name.Use this version to refer to the ARN in the following situations:
In the
logGroupIdentifier
input field in many CloudWatch Logs APIs.In the
resourceArn
field in tagging APIsIn IAM policies, when specifying permissions for TagResource, UntagResource, and ListTagsForResource.
NextToken (string) –
A token to resume pagination.