Class DescribeLogGroupsRequest
- java.lang.Object
-
- software.amazon.awssdk.core.SdkRequest
-
- software.amazon.awssdk.awscore.AwsRequest
-
- software.amazon.awssdk.services.cloudwatchlogs.model.CloudWatchLogsRequest
-
- software.amazon.awssdk.services.cloudwatchlogs.model.DescribeLogGroupsRequest
-
- All Implemented Interfaces:
SdkPojo,ToCopyableBuilder<DescribeLogGroupsRequest.Builder,DescribeLogGroupsRequest>
@Generated("software.amazon.awssdk:codegen") public final class DescribeLogGroupsRequest extends CloudWatchLogsRequest implements ToCopyableBuilder<DescribeLogGroupsRequest.Builder,DescribeLogGroupsRequest>
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceDescribeLogGroupsRequest.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description List<String>accountIdentifiers()WhenincludeLinkedAccountsis set toTrue, use this parameter to specify the list of accounts to search.static DescribeLogGroupsRequest.Builderbuilder()booleanequals(Object obj)booleanequalsBySdkFields(Object obj)<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)booleanhasAccountIdentifiers()For responses, this returns true if the service returned a value for the AccountIdentifiers property.inthashCode()BooleanincludeLinkedAccounts()If you are using a monitoring account, set this toTrueto have the operation return log groups in the accounts listed inaccountIdentifiers.Integerlimit()The maximum number of items returned.LogGroupClasslogGroupClass()Specifies the log group class for this log group.StringlogGroupClassAsString()Specifies the log group class for this log group.StringlogGroupNamePattern()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.StringlogGroupNamePrefix()The prefix to match.StringnextToken()The token for the next set of items to return.List<SdkField<?>>sdkFields()static Class<? extends DescribeLogGroupsRequest.Builder>serializableBuilderClass()DescribeLogGroupsRequest.BuildertoBuilder()StringtoString()Returns a string representation of this object.-
Methods inherited from class software.amazon.awssdk.awscore.AwsRequest
overrideConfiguration
-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
hasAccountIdentifiers
public final boolean hasAccountIdentifiers()
For responses, this returns true if the service returned a value for the AccountIdentifiers property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
accountIdentifiers
public final List<String> accountIdentifiers()
When
includeLinkedAccountsis 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.Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasAccountIdentifiers()method.- Returns:
- When
includeLinkedAccountsis 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.
-
logGroupNamePrefix
public final String logGroupNamePrefix()
The prefix to match.
logGroupNamePrefixandlogGroupNamePatternare mutually exclusive. Only one of these parameters can be passed.- Returns:
- The prefix to match.
logGroupNamePrefixandlogGroupNamePatternare mutually exclusive. Only one of these parameters can be passed.
-
logGroupNamePattern
public final String logGroupNamePattern()
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, andGroupFoowould match, butfoo,F/o/oandFroowould not match.If you specify
logGroupNamePatternin your request, then onlyarn,creationTime, andlogGroupNameare included in the response.logGroupNamePatternandlogGroupNamePrefixare mutually exclusive. Only one of these parameters can be passed.- Returns:
- 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, andGroupFoowould match, butfoo,F/o/oandFroowould not match.If you specify
logGroupNamePatternin your request, then onlyarn,creationTime, andlogGroupNameare included in the response.logGroupNamePatternandlogGroupNamePrefixare mutually exclusive. Only one of these parameters can be passed.
-
nextToken
public final String nextToken()
The token for the next set of items to return. (You received this token from a previous call.)
- Returns:
- The token for the next set of items to return. (You received this token from a previous call.)
-
limit
public final Integer limit()
The maximum number of items returned. If you don't specify a value, the default is up to 50 items.
- Returns:
- The maximum number of items returned. If you don't specify a value, the default is up to 50 items.
-
includeLinkedAccounts
public final Boolean includeLinkedAccounts()
If you are using a monitoring account, set this to
Trueto have the operation return log groups in the accounts listed inaccountIdentifiers.If this parameter is set to
trueandaccountIdentifierscontains 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.- Returns:
- If you are using a monitoring account, set this to
Trueto have the operation return log groups in the accounts listed inaccountIdentifiers.If this parameter is set to
trueandaccountIdentifierscontains 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
public final LogGroupClass logGroupClass()
Specifies the log group class for this log group. There are two classes:
-
The
Standardlog class supports all CloudWatch Logs features. -
The
Infrequent Accesslog class supports a subset of CloudWatch Logs features and incurs lower costs.
For details about the features supported by each class, see Log classes
If the service returns an enum value that is not available in the current SDK version,
logGroupClasswill returnLogGroupClass.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromlogGroupClassAsString().- Returns:
- Specifies the log group class for this log group. There are two classes:
-
The
Standardlog class supports all CloudWatch Logs features. -
The
Infrequent Accesslog class supports a subset of CloudWatch Logs features and incurs lower costs.
For details about the features supported by each class, see Log classes
-
- See Also:
LogGroupClass
-
-
logGroupClassAsString
public final String logGroupClassAsString()
Specifies the log group class for this log group. There are two classes:
-
The
Standardlog class supports all CloudWatch Logs features. -
The
Infrequent Accesslog class supports a subset of CloudWatch Logs features and incurs lower costs.
For details about the features supported by each class, see Log classes
If the service returns an enum value that is not available in the current SDK version,
logGroupClasswill returnLogGroupClass.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromlogGroupClassAsString().- Returns:
- Specifies the log group class for this log group. There are two classes:
-
The
Standardlog class supports all CloudWatch Logs features. -
The
Infrequent Accesslog class supports a subset of CloudWatch Logs features and incurs lower costs.
For details about the features supported by each class, see Log classes
-
- See Also:
LogGroupClass
-
-
toBuilder
public DescribeLogGroupsRequest.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<DescribeLogGroupsRequest.Builder,DescribeLogGroupsRequest>- Specified by:
toBuilderin classCloudWatchLogsRequest
-
builder
public static DescribeLogGroupsRequest.Builder builder()
-
serializableBuilderClass
public static Class<? extends DescribeLogGroupsRequest.Builder> serializableBuilderClass()
-
hashCode
public final int hashCode()
- Overrides:
hashCodein classAwsRequest
-
equals
public final boolean equals(Object obj)
- Overrides:
equalsin classAwsRequest
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFieldsin interfaceSdkPojo
-
toString
public final String toString()
Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
-
getValueForField
public final <T> Optional<T> getValueForField(String fieldName, Class<T> clazz)
- Overrides:
getValueForFieldin classSdkRequest
-
-