software.amazon.awssdk.services.iam.model

Class ServiceLastAccessed

java.lang.Object

software.amazon.awssdk.services.iam.model.ServiceLastAccessed

All Implemented Interfaces:

Serializable, SdkPojo, ToCopyableBuilder<ServiceLastAccessed.Builder,ServiceLastAccessed>

@Generated(value="software.amazon.awssdk:codegen")
public final class ServiceLastAccessed
extends Object
implements SdkPojo, Serializable, ToCopyableBuilder<ServiceLastAccessed.Builder,ServiceLastAccessed>

Contains details about the most recent attempt to access the service.

This data type is used as a response element in the GetServiceLastAccessedDetails operation.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ServiceLastAccessed.Builder

Method Summary

Modifier and Type	Method and Description
static ServiceLastAccessed.Builder	builder()
boolean	equals(Object obj)
boolean	equalsBySdkFields(Object obj)
<T> Optional<T>	getValueForField(String fieldName, Class<T> clazz)
int	hashCode()
boolean	hasTrackedActionsLastAccessed() For responses, this returns true if the service returned a value for the TrackedActionsLastAccessed property.
Instant	lastAuthenticated() The date and time, in ISO 8601 date-time format, when an authenticated entity most recently attempted to access the service.
String	lastAuthenticatedEntity() The ARN of the authenticated entity (user or role) that last attempted to access the service.
String	lastAuthenticatedRegion() The Region from which the authenticated entity (user or role) last attempted to access the service.
List<SdkField<?>>	sdkFields()
static Class<? extends ServiceLastAccessed.Builder>	serializableBuilderClass()
String	serviceName() The name of the service in which access was attempted.
String	serviceNamespace() The namespace of the service in which access was attempted.
ServiceLastAccessed.Builder	toBuilder()
String	toString() Returns a string representation of this object.
Integer	totalAuthenticatedEntities() The total number of authenticated principals (root user, IAM users, or IAM roles) that have attempted to access the service.
List<TrackedActionLastAccessed>	trackedActionsLastAccessed() An object that contains details about the most recent attempt to access a tracked action within the service.

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

serviceName

public final String serviceName()

The name of the service in which access was attempted.

Returns:

The name of the service in which access was attempted.

lastAuthenticated

public final Instant lastAuthenticated()

The date and time, in ISO 8601 date-time format, when an authenticated entity most recently attempted to access the service. Amazon Web Services does not report unauthenticated requests.

This field is null if no IAM entities attempted to access the service within the tracking period.

Returns:

The date and time, in ISO 8601 date-time format, when an authenticated entity most recently attempted to access the service. Amazon Web Services does not report unauthenticated requests.

This field is null if no IAM entities attempted to access the service within the tracking period.

serviceNamespace

public final String serviceNamespace()

The namespace of the service in which access was attempted.

To learn the service namespace of a service, see Actions, resources, and condition keys for Amazon Web Services services in the Service Authorization Reference. Choose the name of the service to view details for that service. In the first paragraph, find the service prefix. For example, (service prefix: a4b). For more information about service namespaces, see Amazon Web Services Service Namespaces in the Amazon Web Services General Reference.

Returns:

The namespace of the service in which access was attempted.

To learn the service namespace of a service, see Actions, resources, and condition keys for Amazon Web Services services in the Service Authorization Reference. Choose the name of the service to view details for that service. In the first paragraph, find the service prefix. For example, (service prefix: a4b). For more information about service namespaces, see Amazon Web Services Service Namespaces in the Amazon Web Services General Reference.

lastAuthenticatedEntity

public final String lastAuthenticatedEntity()

The ARN of the authenticated entity (user or role) that last attempted to access the service. Amazon Web Services does not report unauthenticated requests.

This field is null if no IAM entities attempted to access the service within the tracking period.

Returns:

The ARN of the authenticated entity (user or role) that last attempted to access the service. Amazon Web Services does not report unauthenticated requests.

This field is null if no IAM entities attempted to access the service within the tracking period.

lastAuthenticatedRegion

public final String lastAuthenticatedRegion()

The Region from which the authenticated entity (user or role) last attempted to access the service. Amazon Web Services does not report unauthenticated requests.

This field is null if no IAM entities attempted to access the service within the tracking period.

Returns:

The Region from which the authenticated entity (user or role) last attempted to access the service. Amazon Web Services does not report unauthenticated requests.

This field is null if no IAM entities attempted to access the service within the tracking period.

totalAuthenticatedEntities

public final Integer totalAuthenticatedEntities()

The total number of authenticated principals (root user, IAM users, or IAM roles) that have attempted to access the service.

This field is null if no principals attempted to access the service within the tracking period.

Returns:

The total number of authenticated principals (root user, IAM users, or IAM roles) that have attempted to access the service.

This field is null if no principals attempted to access the service within the tracking period.

hasTrackedActionsLastAccessed

public final boolean hasTrackedActionsLastAccessed()

For responses, this returns true if the service returned a value for the TrackedActionsLastAccessed property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() 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.

trackedActionsLastAccessed

public final List<TrackedActionLastAccessed> trackedActionsLastAccessed()

An object that contains details about the most recent attempt to access a tracked action within the service.

This field is null if there no tracked actions or if the principal did not use the tracked actions within the tracking period. This field is also null if the report was generated at the service level and not the action level. For more information, see the Granularity field in GenerateServiceLastAccessedDetails.

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 hasTrackedActionsLastAccessed() method.

Returns:

An object that contains details about the most recent attempt to access a tracked action within the service.

This field is null if there no tracked actions or if the principal did not use the tracked actions within the tracking period. This field is also null if the report was generated at the service level and not the action level. For more information, see the Granularity field in GenerateServiceLastAccessedDetails.

toBuilder

public ServiceLastAccessed.Builder toBuilder()

Specified by:

toBuilder in interface ToCopyableBuilder<ServiceLastAccessed.Builder,ServiceLastAccessed>

builder

public static ServiceLastAccessed.Builder builder()

serializableBuilderClass

public static Class<? extends ServiceLastAccessed.Builder> serializableBuilderClass()

hashCode

public final int hashCode()

Overrides:

hashCode in class Object

equals

public final boolean equals(Object obj)

Overrides:

equals in class Object

equalsBySdkFields

public final boolean equalsBySdkFields(Object obj)

Specified by:

equalsBySdkFields in interface SdkPojo

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.

Overrides:

toString in class Object

getValueForField

public final <T> Optional<T> getValueForField(String fieldName,
                                              Class<T> clazz)

sdkFields

public final List<SdkField<?>> sdkFields()

Specified by:

sdkFields in interface SdkPojo