software.amazon.awssdk.services.appsync.model

Class ApiKey

java.lang.Object

software.amazon.awssdk.services.appsync.model.ApiKey

All Implemented Interfaces:

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

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

Describes an API key.

Customers invoke AWS AppSync GraphQL API operations with API keys as an identity mechanism. There are two key versions:

da1: This version was introduced at launch in November 2017. These keys always expire after 7 days. Key expiration is managed by Amazon DynamoDB TTL. The keys ceased to be valid after February 21, 2018 and should not be used after that date.

• ListApiKeys returns the expiration time in milliseconds.

• CreateApiKey returns the expiration time in milliseconds.

• UpdateApiKey is not available for this key version.

• DeleteApiKey deletes the item from the table.

• Expiration is stored in Amazon DynamoDB as milliseconds. This results in a bug where keys are not automatically deleted because DynamoDB expects the TTL to be stored in seconds. As a one-time action, we will delete these keys from the table after February 21, 2018.

da2: This version was introduced in February 2018 when AppSync added support to extend key expiration.

• ListApiKeys returns the expiration time in seconds.

• CreateApiKey returns the expiration time in seconds and accepts a user-provided expiration time in seconds.

• UpdateApiKey returns the expiration time in seconds and accepts a user-provided expiration time in seconds. Key expiration can only be updated while the key has not expired.

• DeleteApiKey deletes the item from the table.

• Expiration is stored in Amazon DynamoDB as seconds.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ApiKey.Builder

Method Summary

Modifier and Type	Method and Description
static ApiKey.Builder	builder()
String	description() A description of the purpose of the API key.
boolean	equals(Object obj)
Long	expires() The time after which the API key expires.
<T> Optional<T>	getValueForField(String fieldName, Class<T> clazz)
int	hashCode()
String	id() The API key ID.
List<SdkField<?>>	sdkFields()
static Class<? extends ApiKey.Builder>	serializableBuilderClass()
ApiKey.Builder	toBuilder() Take this object and create a builder that contains all of the current property values of this object.
String	toString()

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder

copy

Method Detail

id

public String id()

The API key ID.

Returns:

The API key ID.

description

public String description()

A description of the purpose of the API key.

Returns:

A description of the purpose of the API key.

expires

public Long expires()

The time after which the API key expires. The date is represented as seconds since the epoch, rounded down to the nearest hour.

Returns:

The time after which the API key expires. The date is represented as seconds since the epoch, rounded down to the nearest hour.

toBuilder

public ApiKey.Builder toBuilder()

Description copied from interface: ToCopyableBuilder

Take this object and create a builder that contains all of the current property values of this object.

Specified by:

toBuilder in interface ToCopyableBuilder<ApiKey.Builder,ApiKey>

Returns:

a builder for type T

builder

public static ApiKey.Builder builder()

serializableBuilderClass

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

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object

getValueForField

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

sdkFields

public List<SdkField<?>> sdkFields()

Specified by:

sdkFields in interface SdkPojo

Returns:

List of SdkField in this POJO. May be empty list but should never be null.