[ aws . appsync ]

create-api-cache

Description

Creates a cache for the GraphQL API.

See also: AWS API Documentation

See ‘aws help’ for descriptions of global parameters.

Synopsis

  create-api-cache
--api-id <value>
--ttl <value>
[--transit-encryption-enabled | --no-transit-encryption-enabled]
[--at-rest-encryption-enabled | --no-at-rest-encryption-enabled]
--api-caching-behavior <value>
--type <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]

Options

--api-id (string)

The GraphQL API Id.

--ttl (long)

TTL in seconds for cache entries.

Valid values are between 1 and 3600 seconds.

--transit-encryption-enabled | --no-transit-encryption-enabled (boolean)

Transit encryption flag when connecting to cache. This setting cannot be updated after creation.

--at-rest-encryption-enabled | --no-at-rest-encryption-enabled (boolean)

At rest encryption flag for cache. This setting cannot be updated after creation.

--api-caching-behavior (string)

Caching behavior.

  • FULL_REQUEST_CACHING : All requests are fully cached.

  • PER_RESOLVER_CACHING : Individual resolvers that you specify are cached.

Possible values:

  • FULL_REQUEST_CACHING

  • PER_RESOLVER_CACHING

--type (string)

The cache instance type. Valid values are

  • SMALL

  • MEDIUM

  • LARGE

  • XLARGE

  • LARGE_2X

  • LARGE_4X

  • LARGE_8X (not available in all regions)

  • LARGE_12X

Historically, instance types were identified by an EC2-style value. As of July 2020, this is deprecated, and the generic identifiers above should be used.

The following legacy instance types are available, but their use is discouraged:

  • T2_SMALL : A t2.small instance type.

  • T2_MEDIUM : A t2.medium instance type.

  • R4_LARGE : A r4.large instance type.

  • R4_XLARGE : A r4.xlarge instance type.

  • R4_2XLARGE : A r4.2xlarge instance type.

  • R4_4XLARGE : A r4.4xlarge instance type.

  • R4_8XLARGE : A r4.8xlarge instance type.

Possible values:

  • T2_SMALL

  • T2_MEDIUM

  • R4_LARGE

  • R4_XLARGE

  • R4_2XLARGE

  • R4_4XLARGE

  • R4_8XLARGE

  • SMALL

  • MEDIUM

  • LARGE

  • XLARGE

  • LARGE_2X

  • LARGE_4X

  • LARGE_8X

  • LARGE_12X

--cli-input-json | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See ‘aws help’ for descriptions of global parameters.

Output

apiCache -> (structure)

The ApiCache object.

ttl -> (long)

TTL in seconds for cache entries.

Valid values are between 1 and 3600 seconds.

apiCachingBehavior -> (string)

Caching behavior.

  • FULL_REQUEST_CACHING : All requests are fully cached.

  • PER_RESOLVER_CACHING : Individual resolvers that you specify are cached.

transitEncryptionEnabled -> (boolean)

Transit encryption flag when connecting to cache. This setting cannot be updated after creation.

atRestEncryptionEnabled -> (boolean)

At rest encryption flag for cache. This setting cannot be updated after creation.

type -> (string)

The cache instance type. Valid values are

  • SMALL

  • MEDIUM

  • LARGE

  • XLARGE

  • LARGE_2X

  • LARGE_4X

  • LARGE_8X (not available in all regions)

  • LARGE_12X

Historically, instance types were identified by an EC2-style value. As of July 2020, this is deprecated, and the generic identifiers above should be used.

The following legacy instance types are available, but their use is discouraged:

  • T2_SMALL : A t2.small instance type.

  • T2_MEDIUM : A t2.medium instance type.

  • R4_LARGE : A r4.large instance type.

  • R4_XLARGE : A r4.xlarge instance type.

  • R4_2XLARGE : A r4.2xlarge instance type.

  • R4_4XLARGE : A r4.4xlarge instance type.

  • R4_8XLARGE : A r4.8xlarge instance type.

status -> (string)

The cache instance status.

  • AVAILABLE : The instance is available for use.

  • CREATING : The instance is currently creating.

  • DELETING : The instance is currently deleting.

  • MODIFYING : The instance is currently modifying.

  • FAILED : The instance has failed creation.