1. Packages
  2. AWS Classic
  3. API Docs
  4. elasticache
  5. ServerlessCache

Try AWS Native preview for resources not in the classic version.

AWS Classic v6.32.0 published on Friday, Apr 19, 2024 by Pulumi

aws.elasticache.ServerlessCache

Explore with Pulumi AI

aws logo

Try AWS Native preview for resources not in the classic version.

AWS Classic v6.32.0 published on Friday, Apr 19, 2024 by Pulumi

    Provides an ElastiCache Serverless Cache resource which manages memcached or redis.

    Example Usage

    Memcached Serverless

    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    const example = new aws.elasticache.ServerlessCache("example", {
        engine: "memcached",
        name: "example",
        cacheUsageLimits: {
            dataStorage: {
                maximum: 10,
                unit: "GB",
            },
            ecpuPerSeconds: [{
                maximum: 5000,
            }],
        },
        description: "Test Server",
        kmsKeyId: test.arn,
        majorEngineVersion: "1.6",
        securityGroupIds: [testAwsSecurityGroup.id],
        subnetIds: testAwsSubnet.map(__item => __item.id),
    });
    
    import pulumi
    import pulumi_aws as aws
    
    example = aws.elasticache.ServerlessCache("example",
        engine="memcached",
        name="example",
        cache_usage_limits=aws.elasticache.ServerlessCacheCacheUsageLimitsArgs(
            data_storage=aws.elasticache.ServerlessCacheCacheUsageLimitsDataStorageArgs(
                maximum=10,
                unit="GB",
            ),
            ecpu_per_seconds=[aws.elasticache.ServerlessCacheCacheUsageLimitsEcpuPerSecondArgs(
                maximum=5000,
            )],
        ),
        description="Test Server",
        kms_key_id=test["arn"],
        major_engine_version="1.6",
        security_group_ids=[test_aws_security_group["id"]],
        subnet_ids=[__item["id"] for __item in test_aws_subnet])
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/elasticache"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    func main() {
    pulumi.Run(func(ctx *pulumi.Context) error {
    var splat0 []interface{}
    for _, val0 := range testAwsSubnet {
    splat0 = append(splat0, val0.Id)
    }
    _, err := elasticache.NewServerlessCache(ctx, "example", &elasticache.ServerlessCacheArgs{
    Engine: pulumi.String("memcached"),
    Name: pulumi.String("example"),
    CacheUsageLimits: &elasticache.ServerlessCacheCacheUsageLimitsArgs{
    DataStorage: &elasticache.ServerlessCacheCacheUsageLimitsDataStorageArgs{
    Maximum: pulumi.Int(10),
    Unit: pulumi.String("GB"),
    },
    EcpuPerSeconds: elasticache.ServerlessCacheCacheUsageLimitsEcpuPerSecondArray{
    &elasticache.ServerlessCacheCacheUsageLimitsEcpuPerSecondArgs{
    Maximum: pulumi.Int(5000),
    },
    },
    },
    Description: pulumi.String("Test Server"),
    KmsKeyId: pulumi.Any(test.Arn),
    MajorEngineVersion: pulumi.String("1.6"),
    SecurityGroupIds: pulumi.StringArray{
    testAwsSecurityGroup.Id,
    },
    SubnetIds: toPulumiArray(splat0),
    })
    if err != nil {
    return err
    }
    return nil
    })
    }
    func toPulumiArray(arr []) pulumi.Array {
    var pulumiArr pulumi.Array
    for _, v := range arr {
    pulumiArr = append(pulumiArr, pulumi.(v))
    }
    return pulumiArr
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Aws = Pulumi.Aws;
    
    return await Deployment.RunAsync(() => 
    {
        var example = new Aws.ElastiCache.ServerlessCache("example", new()
        {
            Engine = "memcached",
            Name = "example",
            CacheUsageLimits = new Aws.ElastiCache.Inputs.ServerlessCacheCacheUsageLimitsArgs
            {
                DataStorage = new Aws.ElastiCache.Inputs.ServerlessCacheCacheUsageLimitsDataStorageArgs
                {
                    Maximum = 10,
                    Unit = "GB",
                },
                EcpuPerSeconds = new[]
                {
                    new Aws.ElastiCache.Inputs.ServerlessCacheCacheUsageLimitsEcpuPerSecondArgs
                    {
                        Maximum = 5000,
                    },
                },
            },
            Description = "Test Server",
            KmsKeyId = test.Arn,
            MajorEngineVersion = "1.6",
            SecurityGroupIds = new[]
            {
                testAwsSecurityGroup.Id,
            },
            SubnetIds = testAwsSubnet.Select(__item => __item.Id).ToList(),
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.elasticache.ServerlessCache;
    import com.pulumi.aws.elasticache.ServerlessCacheArgs;
    import com.pulumi.aws.elasticache.inputs.ServerlessCacheCacheUsageLimitsArgs;
    import com.pulumi.aws.elasticache.inputs.ServerlessCacheCacheUsageLimitsDataStorageArgs;
    import java.util.List;
    import java.util.ArrayList;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            var example = new ServerlessCache("example", ServerlessCacheArgs.builder()        
                .engine("memcached")
                .name("example")
                .cacheUsageLimits(ServerlessCacheCacheUsageLimitsArgs.builder()
                    .dataStorage(ServerlessCacheCacheUsageLimitsDataStorageArgs.builder()
                        .maximum(10)
                        .unit("GB")
                        .build())
                    .ecpuPerSeconds(ServerlessCacheCacheUsageLimitsEcpuPerSecondArgs.builder()
                        .maximum(5000)
                        .build())
                    .build())
                .description("Test Server")
                .kmsKeyId(test.arn())
                .majorEngineVersion("1.6")
                .securityGroupIds(testAwsSecurityGroup.id())
                .subnetIds(testAwsSubnet.stream().map(element -> element.id()).collect(toList()))
                .build());
    
        }
    }
    
    Coming soon!
    

    Redis Serverless

    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    const example = new aws.elasticache.ServerlessCache("example", {
        engine: "redis",
        name: "example",
        cacheUsageLimits: {
            dataStorage: {
                maximum: 10,
                unit: "GB",
            },
            ecpuPerSeconds: [{
                maximum: 5000,
            }],
        },
        dailySnapshotTime: "09:00",
        description: "Test Server",
        kmsKeyId: test.arn,
        majorEngineVersion: "7",
        snapshotRetentionLimit: 1,
        securityGroupIds: [testAwsSecurityGroup.id],
        subnetIds: testAwsSubnet.map(__item => __item.id),
    });
    
    import pulumi
    import pulumi_aws as aws
    
    example = aws.elasticache.ServerlessCache("example",
        engine="redis",
        name="example",
        cache_usage_limits=aws.elasticache.ServerlessCacheCacheUsageLimitsArgs(
            data_storage=aws.elasticache.ServerlessCacheCacheUsageLimitsDataStorageArgs(
                maximum=10,
                unit="GB",
            ),
            ecpu_per_seconds=[aws.elasticache.ServerlessCacheCacheUsageLimitsEcpuPerSecondArgs(
                maximum=5000,
            )],
        ),
        daily_snapshot_time="09:00",
        description="Test Server",
        kms_key_id=test["arn"],
        major_engine_version="7",
        snapshot_retention_limit=1,
        security_group_ids=[test_aws_security_group["id"]],
        subnet_ids=[__item["id"] for __item in test_aws_subnet])
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/elasticache"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    func main() {
    pulumi.Run(func(ctx *pulumi.Context) error {
    var splat0 []interface{}
    for _, val0 := range testAwsSubnet {
    splat0 = append(splat0, val0.Id)
    }
    _, err := elasticache.NewServerlessCache(ctx, "example", &elasticache.ServerlessCacheArgs{
    Engine: pulumi.String("redis"),
    Name: pulumi.String("example"),
    CacheUsageLimits: &elasticache.ServerlessCacheCacheUsageLimitsArgs{
    DataStorage: &elasticache.ServerlessCacheCacheUsageLimitsDataStorageArgs{
    Maximum: pulumi.Int(10),
    Unit: pulumi.String("GB"),
    },
    EcpuPerSeconds: elasticache.ServerlessCacheCacheUsageLimitsEcpuPerSecondArray{
    &elasticache.ServerlessCacheCacheUsageLimitsEcpuPerSecondArgs{
    Maximum: pulumi.Int(5000),
    },
    },
    },
    DailySnapshotTime: pulumi.String("09:00"),
    Description: pulumi.String("Test Server"),
    KmsKeyId: pulumi.Any(test.Arn),
    MajorEngineVersion: pulumi.String("7"),
    SnapshotRetentionLimit: pulumi.Int(1),
    SecurityGroupIds: pulumi.StringArray{
    testAwsSecurityGroup.Id,
    },
    SubnetIds: toPulumiArray(splat0),
    })
    if err != nil {
    return err
    }
    return nil
    })
    }
    func toPulumiArray(arr []) pulumi.Array {
    var pulumiArr pulumi.Array
    for _, v := range arr {
    pulumiArr = append(pulumiArr, pulumi.(v))
    }
    return pulumiArr
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Aws = Pulumi.Aws;
    
    return await Deployment.RunAsync(() => 
    {
        var example = new Aws.ElastiCache.ServerlessCache("example", new()
        {
            Engine = "redis",
            Name = "example",
            CacheUsageLimits = new Aws.ElastiCache.Inputs.ServerlessCacheCacheUsageLimitsArgs
            {
                DataStorage = new Aws.ElastiCache.Inputs.ServerlessCacheCacheUsageLimitsDataStorageArgs
                {
                    Maximum = 10,
                    Unit = "GB",
                },
                EcpuPerSeconds = new[]
                {
                    new Aws.ElastiCache.Inputs.ServerlessCacheCacheUsageLimitsEcpuPerSecondArgs
                    {
                        Maximum = 5000,
                    },
                },
            },
            DailySnapshotTime = "09:00",
            Description = "Test Server",
            KmsKeyId = test.Arn,
            MajorEngineVersion = "7",
            SnapshotRetentionLimit = 1,
            SecurityGroupIds = new[]
            {
                testAwsSecurityGroup.Id,
            },
            SubnetIds = testAwsSubnet.Select(__item => __item.Id).ToList(),
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.elasticache.ServerlessCache;
    import com.pulumi.aws.elasticache.ServerlessCacheArgs;
    import com.pulumi.aws.elasticache.inputs.ServerlessCacheCacheUsageLimitsArgs;
    import com.pulumi.aws.elasticache.inputs.ServerlessCacheCacheUsageLimitsDataStorageArgs;
    import java.util.List;
    import java.util.ArrayList;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            var example = new ServerlessCache("example", ServerlessCacheArgs.builder()        
                .engine("redis")
                .name("example")
                .cacheUsageLimits(ServerlessCacheCacheUsageLimitsArgs.builder()
                    .dataStorage(ServerlessCacheCacheUsageLimitsDataStorageArgs.builder()
                        .maximum(10)
                        .unit("GB")
                        .build())
                    .ecpuPerSeconds(ServerlessCacheCacheUsageLimitsEcpuPerSecondArgs.builder()
                        .maximum(5000)
                        .build())
                    .build())
                .dailySnapshotTime("09:00")
                .description("Test Server")
                .kmsKeyId(test.arn())
                .majorEngineVersion("7")
                .snapshotRetentionLimit(1)
                .securityGroupIds(testAwsSecurityGroup.id())
                .subnetIds(testAwsSubnet.stream().map(element -> element.id()).collect(toList()))
                .build());
    
        }
    }
    
    Coming soon!
    

    Create ServerlessCache Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new ServerlessCache(name: string, args: ServerlessCacheArgs, opts?: CustomResourceOptions);
    @overload
    def ServerlessCache(resource_name: str,
                        args: ServerlessCacheArgs,
                        opts: Optional[ResourceOptions] = None)
    
    @overload
    def ServerlessCache(resource_name: str,
                        opts: Optional[ResourceOptions] = None,
                        engine: Optional[str] = None,
                        name: Optional[str] = None,
                        description: Optional[str] = None,
                        daily_snapshot_time: Optional[str] = None,
                        kms_key_id: Optional[str] = None,
                        major_engine_version: Optional[str] = None,
                        cache_usage_limits: Optional[ServerlessCacheCacheUsageLimitsArgs] = None,
                        security_group_ids: Optional[Sequence[str]] = None,
                        snapshot_arns_to_restores: Optional[Sequence[str]] = None,
                        snapshot_retention_limit: Optional[int] = None,
                        subnet_ids: Optional[Sequence[str]] = None,
                        tags: Optional[Mapping[str, str]] = None,
                        timeouts: Optional[ServerlessCacheTimeoutsArgs] = None,
                        user_group_id: Optional[str] = None)
    func NewServerlessCache(ctx *Context, name string, args ServerlessCacheArgs, opts ...ResourceOption) (*ServerlessCache, error)
    public ServerlessCache(string name, ServerlessCacheArgs args, CustomResourceOptions? opts = null)
    public ServerlessCache(String name, ServerlessCacheArgs args)
    public ServerlessCache(String name, ServerlessCacheArgs args, CustomResourceOptions options)
    
    type: aws:elasticache:ServerlessCache
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args ServerlessCacheArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args ServerlessCacheArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args ServerlessCacheArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ServerlessCacheArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ServerlessCacheArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Example

    The following reference example uses placeholder values for all input properties.

    var serverlessCacheResource = new Aws.ElastiCache.ServerlessCache("serverlessCacheResource", new()
    {
        Engine = "string",
        Name = "string",
        Description = "string",
        DailySnapshotTime = "string",
        KmsKeyId = "string",
        MajorEngineVersion = "string",
        CacheUsageLimits = new Aws.ElastiCache.Inputs.ServerlessCacheCacheUsageLimitsArgs
        {
            DataStorage = new Aws.ElastiCache.Inputs.ServerlessCacheCacheUsageLimitsDataStorageArgs
            {
                Unit = "string",
                Maximum = 0,
                Minimum = 0,
            },
            EcpuPerSeconds = new[]
            {
                new Aws.ElastiCache.Inputs.ServerlessCacheCacheUsageLimitsEcpuPerSecondArgs
                {
                    Maximum = 0,
                    Minimum = 0,
                },
            },
        },
        SecurityGroupIds = new[]
        {
            "string",
        },
        SnapshotArnsToRestores = new[]
        {
            "string",
        },
        SnapshotRetentionLimit = 0,
        SubnetIds = new[]
        {
            "string",
        },
        Tags = 
        {
            { "string", "string" },
        },
        Timeouts = new Aws.ElastiCache.Inputs.ServerlessCacheTimeoutsArgs
        {
            Create = "string",
            Delete = "string",
            Update = "string",
        },
        UserGroupId = "string",
    });
    
    example, err := elasticache.NewServerlessCache(ctx, "serverlessCacheResource", &elasticache.ServerlessCacheArgs{
    	Engine:             pulumi.String("string"),
    	Name:               pulumi.String("string"),
    	Description:        pulumi.String("string"),
    	DailySnapshotTime:  pulumi.String("string"),
    	KmsKeyId:           pulumi.String("string"),
    	MajorEngineVersion: pulumi.String("string"),
    	CacheUsageLimits: &elasticache.ServerlessCacheCacheUsageLimitsArgs{
    		DataStorage: &elasticache.ServerlessCacheCacheUsageLimitsDataStorageArgs{
    			Unit:    pulumi.String("string"),
    			Maximum: pulumi.Int(0),
    			Minimum: pulumi.Int(0),
    		},
    		EcpuPerSeconds: elasticache.ServerlessCacheCacheUsageLimitsEcpuPerSecondArray{
    			&elasticache.ServerlessCacheCacheUsageLimitsEcpuPerSecondArgs{
    				Maximum: pulumi.Int(0),
    				Minimum: pulumi.Int(0),
    			},
    		},
    	},
    	SecurityGroupIds: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	SnapshotArnsToRestores: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	SnapshotRetentionLimit: pulumi.Int(0),
    	SubnetIds: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	Tags: pulumi.StringMap{
    		"string": pulumi.String("string"),
    	},
    	Timeouts: &elasticache.ServerlessCacheTimeoutsArgs{
    		Create: pulumi.String("string"),
    		Delete: pulumi.String("string"),
    		Update: pulumi.String("string"),
    	},
    	UserGroupId: pulumi.String("string"),
    })
    
    var serverlessCacheResource = new ServerlessCache("serverlessCacheResource", ServerlessCacheArgs.builder()        
        .engine("string")
        .name("string")
        .description("string")
        .dailySnapshotTime("string")
        .kmsKeyId("string")
        .majorEngineVersion("string")
        .cacheUsageLimits(ServerlessCacheCacheUsageLimitsArgs.builder()
            .dataStorage(ServerlessCacheCacheUsageLimitsDataStorageArgs.builder()
                .unit("string")
                .maximum(0)
                .minimum(0)
                .build())
            .ecpuPerSeconds(ServerlessCacheCacheUsageLimitsEcpuPerSecondArgs.builder()
                .maximum(0)
                .minimum(0)
                .build())
            .build())
        .securityGroupIds("string")
        .snapshotArnsToRestores("string")
        .snapshotRetentionLimit(0)
        .subnetIds("string")
        .tags(Map.of("string", "string"))
        .timeouts(ServerlessCacheTimeoutsArgs.builder()
            .create("string")
            .delete("string")
            .update("string")
            .build())
        .userGroupId("string")
        .build());
    
    serverless_cache_resource = aws.elasticache.ServerlessCache("serverlessCacheResource",
        engine="string",
        name="string",
        description="string",
        daily_snapshot_time="string",
        kms_key_id="string",
        major_engine_version="string",
        cache_usage_limits=aws.elasticache.ServerlessCacheCacheUsageLimitsArgs(
            data_storage=aws.elasticache.ServerlessCacheCacheUsageLimitsDataStorageArgs(
                unit="string",
                maximum=0,
                minimum=0,
            ),
            ecpu_per_seconds=[aws.elasticache.ServerlessCacheCacheUsageLimitsEcpuPerSecondArgs(
                maximum=0,
                minimum=0,
            )],
        ),
        security_group_ids=["string"],
        snapshot_arns_to_restores=["string"],
        snapshot_retention_limit=0,
        subnet_ids=["string"],
        tags={
            "string": "string",
        },
        timeouts=aws.elasticache.ServerlessCacheTimeoutsArgs(
            create="string",
            delete="string",
            update="string",
        ),
        user_group_id="string")
    
    const serverlessCacheResource = new aws.elasticache.ServerlessCache("serverlessCacheResource", {
        engine: "string",
        name: "string",
        description: "string",
        dailySnapshotTime: "string",
        kmsKeyId: "string",
        majorEngineVersion: "string",
        cacheUsageLimits: {
            dataStorage: {
                unit: "string",
                maximum: 0,
                minimum: 0,
            },
            ecpuPerSeconds: [{
                maximum: 0,
                minimum: 0,
            }],
        },
        securityGroupIds: ["string"],
        snapshotArnsToRestores: ["string"],
        snapshotRetentionLimit: 0,
        subnetIds: ["string"],
        tags: {
            string: "string",
        },
        timeouts: {
            create: "string",
            "delete": "string",
            update: "string",
        },
        userGroupId: "string",
    });
    
    type: aws:elasticache:ServerlessCache
    properties:
        cacheUsageLimits:
            dataStorage:
                maximum: 0
                minimum: 0
                unit: string
            ecpuPerSeconds:
                - maximum: 0
                  minimum: 0
        dailySnapshotTime: string
        description: string
        engine: string
        kmsKeyId: string
        majorEngineVersion: string
        name: string
        securityGroupIds:
            - string
        snapshotArnsToRestores:
            - string
        snapshotRetentionLimit: 0
        subnetIds:
            - string
        tags:
            string: string
        timeouts:
            create: string
            delete: string
            update: string
        userGroupId: string
    

    ServerlessCache Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    The ServerlessCache resource accepts the following input properties:

    Engine string
    Name of the cache engine to be used for this cache cluster. Valid values are memcached or redis.
    CacheUsageLimits ServerlessCacheCacheUsageLimits
    Sets the cache usage limits for storage and ElastiCache Processing Units for the cache. See configuration below.
    DailySnapshotTime string
    The daily time that snapshots will be created from the new serverless cache. Only supported for engine type "redis". Defaults to 0.
    Description string
    User-provided description for the serverless cache. The default is NULL.
    KmsKeyId string
    ARN of the customer managed key for encrypting the data at rest. If no KMS key is provided, a default service key is used.
    MajorEngineVersion string
    The version of the cache engine that will be used to create the serverless cache. See Describe Cache Engine Versions in the AWS Documentation for supported versions.
    Name string

    The Cluster name which serves as a unique identifier to the serverless cache

    The following arguments are optional:

    SecurityGroupIds List<string>
    A list of the one or more VPC security groups to be associated with the serverless cache. The security group will authorize traffic access for the VPC end-point (private-link). If no other information is given this will be the VPC’s Default Security Group that is associated with the cluster VPC end-point.
    SnapshotArnsToRestores List<string>
    The list of ARN(s) of the snapshot that the new serverless cache will be created from. Available for Redis only.
    SnapshotRetentionLimit int
    The number of snapshots that will be retained for the serverless cache that is being created. As new snapshots beyond this limit are added, the oldest snapshots will be deleted on a rolling basis. Available for Redis only.
    SubnetIds List<string>
    A list of the identifiers of the subnets where the VPC endpoint for the serverless cache will be deployed. All the subnetIds must belong to the same VPC.
    Tags Dictionary<string, string>
    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    Timeouts ServerlessCacheTimeouts
    UserGroupId string
    The identifier of the UserGroup to be associated with the serverless cache. Available for Redis only. Default is NULL.
    Engine string
    Name of the cache engine to be used for this cache cluster. Valid values are memcached or redis.
    CacheUsageLimits ServerlessCacheCacheUsageLimitsArgs
    Sets the cache usage limits for storage and ElastiCache Processing Units for the cache. See configuration below.
    DailySnapshotTime string
    The daily time that snapshots will be created from the new serverless cache. Only supported for engine type "redis". Defaults to 0.
    Description string
    User-provided description for the serverless cache. The default is NULL.
    KmsKeyId string
    ARN of the customer managed key for encrypting the data at rest. If no KMS key is provided, a default service key is used.
    MajorEngineVersion string
    The version of the cache engine that will be used to create the serverless cache. See Describe Cache Engine Versions in the AWS Documentation for supported versions.
    Name string

    The Cluster name which serves as a unique identifier to the serverless cache

    The following arguments are optional:

    SecurityGroupIds []string
    A list of the one or more VPC security groups to be associated with the serverless cache. The security group will authorize traffic access for the VPC end-point (private-link). If no other information is given this will be the VPC’s Default Security Group that is associated with the cluster VPC end-point.
    SnapshotArnsToRestores []string
    The list of ARN(s) of the snapshot that the new serverless cache will be created from. Available for Redis only.
    SnapshotRetentionLimit int
    The number of snapshots that will be retained for the serverless cache that is being created. As new snapshots beyond this limit are added, the oldest snapshots will be deleted on a rolling basis. Available for Redis only.
    SubnetIds []string
    A list of the identifiers of the subnets where the VPC endpoint for the serverless cache will be deployed. All the subnetIds must belong to the same VPC.
    Tags map[string]string
    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    Timeouts ServerlessCacheTimeoutsArgs
    UserGroupId string
    The identifier of the UserGroup to be associated with the serverless cache. Available for Redis only. Default is NULL.
    engine String
    Name of the cache engine to be used for this cache cluster. Valid values are memcached or redis.
    cacheUsageLimits ServerlessCacheCacheUsageLimits
    Sets the cache usage limits for storage and ElastiCache Processing Units for the cache. See configuration below.
    dailySnapshotTime String
    The daily time that snapshots will be created from the new serverless cache. Only supported for engine type "redis". Defaults to 0.
    description String
    User-provided description for the serverless cache. The default is NULL.
    kmsKeyId String
    ARN of the customer managed key for encrypting the data at rest. If no KMS key is provided, a default service key is used.
    majorEngineVersion String
    The version of the cache engine that will be used to create the serverless cache. See Describe Cache Engine Versions in the AWS Documentation for supported versions.
    name String

    The Cluster name which serves as a unique identifier to the serverless cache

    The following arguments are optional:

    securityGroupIds List<String>
    A list of the one or more VPC security groups to be associated with the serverless cache. The security group will authorize traffic access for the VPC end-point (private-link). If no other information is given this will be the VPC’s Default Security Group that is associated with the cluster VPC end-point.
    snapshotArnsToRestores List<String>
    The list of ARN(s) of the snapshot that the new serverless cache will be created from. Available for Redis only.
    snapshotRetentionLimit Integer
    The number of snapshots that will be retained for the serverless cache that is being created. As new snapshots beyond this limit are added, the oldest snapshots will be deleted on a rolling basis. Available for Redis only.
    subnetIds List<String>
    A list of the identifiers of the subnets where the VPC endpoint for the serverless cache will be deployed. All the subnetIds must belong to the same VPC.
    tags Map<String,String>
    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    timeouts ServerlessCacheTimeouts
    userGroupId String
    The identifier of the UserGroup to be associated with the serverless cache. Available for Redis only. Default is NULL.
    engine string
    Name of the cache engine to be used for this cache cluster. Valid values are memcached or redis.
    cacheUsageLimits ServerlessCacheCacheUsageLimits
    Sets the cache usage limits for storage and ElastiCache Processing Units for the cache. See configuration below.
    dailySnapshotTime string
    The daily time that snapshots will be created from the new serverless cache. Only supported for engine type "redis". Defaults to 0.
    description string
    User-provided description for the serverless cache. The default is NULL.
    kmsKeyId string
    ARN of the customer managed key for encrypting the data at rest. If no KMS key is provided, a default service key is used.
    majorEngineVersion string
    The version of the cache engine that will be used to create the serverless cache. See Describe Cache Engine Versions in the AWS Documentation for supported versions.
    name string

    The Cluster name which serves as a unique identifier to the serverless cache

    The following arguments are optional:

    securityGroupIds string[]
    A list of the one or more VPC security groups to be associated with the serverless cache. The security group will authorize traffic access for the VPC end-point (private-link). If no other information is given this will be the VPC’s Default Security Group that is associated with the cluster VPC end-point.
    snapshotArnsToRestores string[]
    The list of ARN(s) of the snapshot that the new serverless cache will be created from. Available for Redis only.
    snapshotRetentionLimit number
    The number of snapshots that will be retained for the serverless cache that is being created. As new snapshots beyond this limit are added, the oldest snapshots will be deleted on a rolling basis. Available for Redis only.
    subnetIds string[]
    A list of the identifiers of the subnets where the VPC endpoint for the serverless cache will be deployed. All the subnetIds must belong to the same VPC.
    tags {[key: string]: string}
    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    timeouts ServerlessCacheTimeouts
    userGroupId string
    The identifier of the UserGroup to be associated with the serverless cache. Available for Redis only. Default is NULL.
    engine str
    Name of the cache engine to be used for this cache cluster. Valid values are memcached or redis.
    cache_usage_limits ServerlessCacheCacheUsageLimitsArgs
    Sets the cache usage limits for storage and ElastiCache Processing Units for the cache. See configuration below.
    daily_snapshot_time str
    The daily time that snapshots will be created from the new serverless cache. Only supported for engine type "redis". Defaults to 0.
    description str
    User-provided description for the serverless cache. The default is NULL.
    kms_key_id str
    ARN of the customer managed key for encrypting the data at rest. If no KMS key is provided, a default service key is used.
    major_engine_version str
    The version of the cache engine that will be used to create the serverless cache. See Describe Cache Engine Versions in the AWS Documentation for supported versions.
    name str

    The Cluster name which serves as a unique identifier to the serverless cache

    The following arguments are optional:

    security_group_ids Sequence[str]
    A list of the one or more VPC security groups to be associated with the serverless cache. The security group will authorize traffic access for the VPC end-point (private-link). If no other information is given this will be the VPC’s Default Security Group that is associated with the cluster VPC end-point.
    snapshot_arns_to_restores Sequence[str]
    The list of ARN(s) of the snapshot that the new serverless cache will be created from. Available for Redis only.
    snapshot_retention_limit int
    The number of snapshots that will be retained for the serverless cache that is being created. As new snapshots beyond this limit are added, the oldest snapshots will be deleted on a rolling basis. Available for Redis only.
    subnet_ids Sequence[str]
    A list of the identifiers of the subnets where the VPC endpoint for the serverless cache will be deployed. All the subnetIds must belong to the same VPC.
    tags Mapping[str, str]
    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    timeouts ServerlessCacheTimeoutsArgs
    user_group_id str
    The identifier of the UserGroup to be associated with the serverless cache. Available for Redis only. Default is NULL.
    engine String
    Name of the cache engine to be used for this cache cluster. Valid values are memcached or redis.
    cacheUsageLimits Property Map
    Sets the cache usage limits for storage and ElastiCache Processing Units for the cache. See configuration below.
    dailySnapshotTime String
    The daily time that snapshots will be created from the new serverless cache. Only supported for engine type "redis". Defaults to 0.
    description String
    User-provided description for the serverless cache. The default is NULL.
    kmsKeyId String
    ARN of the customer managed key for encrypting the data at rest. If no KMS key is provided, a default service key is used.
    majorEngineVersion String
    The version of the cache engine that will be used to create the serverless cache. See Describe Cache Engine Versions in the AWS Documentation for supported versions.
    name String

    The Cluster name which serves as a unique identifier to the serverless cache

    The following arguments are optional:

    securityGroupIds List<String>
    A list of the one or more VPC security groups to be associated with the serverless cache. The security group will authorize traffic access for the VPC end-point (private-link). If no other information is given this will be the VPC’s Default Security Group that is associated with the cluster VPC end-point.
    snapshotArnsToRestores List<String>
    The list of ARN(s) of the snapshot that the new serverless cache will be created from. Available for Redis only.
    snapshotRetentionLimit Number
    The number of snapshots that will be retained for the serverless cache that is being created. As new snapshots beyond this limit are added, the oldest snapshots will be deleted on a rolling basis. Available for Redis only.
    subnetIds List<String>
    A list of the identifiers of the subnets where the VPC endpoint for the serverless cache will be deployed. All the subnetIds must belong to the same VPC.
    tags Map<String>
    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    timeouts Property Map
    userGroupId String
    The identifier of the UserGroup to be associated with the serverless cache. Available for Redis only. Default is NULL.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the ServerlessCache resource produces the following output properties:

    Arn string
    The Amazon Resource Name (ARN) of the serverless cache.
    CreateTime string
    Timestamp of when the serverless cache was created.
    Endpoints List<ServerlessCacheEndpoint>
    Represents the information required for client programs to connect to a cache node. See config below for details.
    FullEngineVersion string
    The name and version number of the engine the serverless cache is compatible with.
    Id string
    The provider-assigned unique ID for this managed resource.
    ReaderEndpoints List<ServerlessCacheReaderEndpoint>
    Represents the information required for client programs to connect to a cache node. See config below for details.
    Status string
    The current status of the serverless cache. The allowed values are CREATING, AVAILABLE, DELETING, CREATE-FAILED and MODIFYING.
    TagsAll Dictionary<string, string>

    Deprecated: Please use tags instead.

    Arn string
    The Amazon Resource Name (ARN) of the serverless cache.
    CreateTime string
    Timestamp of when the serverless cache was created.
    Endpoints []ServerlessCacheEndpoint
    Represents the information required for client programs to connect to a cache node. See config below for details.
    FullEngineVersion string
    The name and version number of the engine the serverless cache is compatible with.
    Id string
    The provider-assigned unique ID for this managed resource.
    ReaderEndpoints []ServerlessCacheReaderEndpoint
    Represents the information required for client programs to connect to a cache node. See config below for details.
    Status string
    The current status of the serverless cache. The allowed values are CREATING, AVAILABLE, DELETING, CREATE-FAILED and MODIFYING.
    TagsAll map[string]string

    Deprecated: Please use tags instead.

    arn String
    The Amazon Resource Name (ARN) of the serverless cache.
    createTime String
    Timestamp of when the serverless cache was created.
    endpoints List<ServerlessCacheEndpoint>
    Represents the information required for client programs to connect to a cache node. See config below for details.
    fullEngineVersion String
    The name and version number of the engine the serverless cache is compatible with.
    id String
    The provider-assigned unique ID for this managed resource.
    readerEndpoints List<ServerlessCacheReaderEndpoint>
    Represents the information required for client programs to connect to a cache node. See config below for details.
    status String
    The current status of the serverless cache. The allowed values are CREATING, AVAILABLE, DELETING, CREATE-FAILED and MODIFYING.
    tagsAll Map<String,String>

    Deprecated: Please use tags instead.

    arn string
    The Amazon Resource Name (ARN) of the serverless cache.
    createTime string
    Timestamp of when the serverless cache was created.
    endpoints ServerlessCacheEndpoint[]
    Represents the information required for client programs to connect to a cache node. See config below for details.
    fullEngineVersion string
    The name and version number of the engine the serverless cache is compatible with.
    id string
    The provider-assigned unique ID for this managed resource.
    readerEndpoints ServerlessCacheReaderEndpoint[]
    Represents the information required for client programs to connect to a cache node. See config below for details.
    status string
    The current status of the serverless cache. The allowed values are CREATING, AVAILABLE, DELETING, CREATE-FAILED and MODIFYING.
    tagsAll {[key: string]: string}

    Deprecated: Please use tags instead.

    arn str
    The Amazon Resource Name (ARN) of the serverless cache.
    create_time str
    Timestamp of when the serverless cache was created.
    endpoints Sequence[ServerlessCacheEndpoint]
    Represents the information required for client programs to connect to a cache node. See config below for details.
    full_engine_version str
    The name and version number of the engine the serverless cache is compatible with.
    id str
    The provider-assigned unique ID for this managed resource.
    reader_endpoints Sequence[ServerlessCacheReaderEndpoint]
    Represents the information required for client programs to connect to a cache node. See config below for details.
    status str
    The current status of the serverless cache. The allowed values are CREATING, AVAILABLE, DELETING, CREATE-FAILED and MODIFYING.
    tags_all Mapping[str, str]

    Deprecated: Please use tags instead.

    arn String
    The Amazon Resource Name (ARN) of the serverless cache.
    createTime String
    Timestamp of when the serverless cache was created.
    endpoints List<Property Map>
    Represents the information required for client programs to connect to a cache node. See config below for details.
    fullEngineVersion String
    The name and version number of the engine the serverless cache is compatible with.
    id String
    The provider-assigned unique ID for this managed resource.
    readerEndpoints List<Property Map>
    Represents the information required for client programs to connect to a cache node. See config below for details.
    status String
    The current status of the serverless cache. The allowed values are CREATING, AVAILABLE, DELETING, CREATE-FAILED and MODIFYING.
    tagsAll Map<String>

    Deprecated: Please use tags instead.

    Look up Existing ServerlessCache Resource

    Get an existing ServerlessCache resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: ServerlessCacheState, opts?: CustomResourceOptions): ServerlessCache
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            arn: Optional[str] = None,
            cache_usage_limits: Optional[ServerlessCacheCacheUsageLimitsArgs] = None,
            create_time: Optional[str] = None,
            daily_snapshot_time: Optional[str] = None,
            description: Optional[str] = None,
            endpoints: Optional[Sequence[ServerlessCacheEndpointArgs]] = None,
            engine: Optional[str] = None,
            full_engine_version: Optional[str] = None,
            kms_key_id: Optional[str] = None,
            major_engine_version: Optional[str] = None,
            name: Optional[str] = None,
            reader_endpoints: Optional[Sequence[ServerlessCacheReaderEndpointArgs]] = None,
            security_group_ids: Optional[Sequence[str]] = None,
            snapshot_arns_to_restores: Optional[Sequence[str]] = None,
            snapshot_retention_limit: Optional[int] = None,
            status: Optional[str] = None,
            subnet_ids: Optional[Sequence[str]] = None,
            tags: Optional[Mapping[str, str]] = None,
            tags_all: Optional[Mapping[str, str]] = None,
            timeouts: Optional[ServerlessCacheTimeoutsArgs] = None,
            user_group_id: Optional[str] = None) -> ServerlessCache
    func GetServerlessCache(ctx *Context, name string, id IDInput, state *ServerlessCacheState, opts ...ResourceOption) (*ServerlessCache, error)
    public static ServerlessCache Get(string name, Input<string> id, ServerlessCacheState? state, CustomResourceOptions? opts = null)
    public static ServerlessCache get(String name, Output<String> id, ServerlessCacheState state, CustomResourceOptions options)
    Resource lookup is not supported in YAML
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    Arn string
    The Amazon Resource Name (ARN) of the serverless cache.
    CacheUsageLimits ServerlessCacheCacheUsageLimits
    Sets the cache usage limits for storage and ElastiCache Processing Units for the cache. See configuration below.
    CreateTime string
    Timestamp of when the serverless cache was created.
    DailySnapshotTime string
    The daily time that snapshots will be created from the new serverless cache. Only supported for engine type "redis". Defaults to 0.
    Description string
    User-provided description for the serverless cache. The default is NULL.
    Endpoints List<ServerlessCacheEndpoint>
    Represents the information required for client programs to connect to a cache node. See config below for details.
    Engine string
    Name of the cache engine to be used for this cache cluster. Valid values are memcached or redis.
    FullEngineVersion string
    The name and version number of the engine the serverless cache is compatible with.
    KmsKeyId string
    ARN of the customer managed key for encrypting the data at rest. If no KMS key is provided, a default service key is used.
    MajorEngineVersion string
    The version of the cache engine that will be used to create the serverless cache. See Describe Cache Engine Versions in the AWS Documentation for supported versions.
    Name string

    The Cluster name which serves as a unique identifier to the serverless cache

    The following arguments are optional:

    ReaderEndpoints List<ServerlessCacheReaderEndpoint>
    Represents the information required for client programs to connect to a cache node. See config below for details.
    SecurityGroupIds List<string>
    A list of the one or more VPC security groups to be associated with the serverless cache. The security group will authorize traffic access for the VPC end-point (private-link). If no other information is given this will be the VPC’s Default Security Group that is associated with the cluster VPC end-point.
    SnapshotArnsToRestores List<string>
    The list of ARN(s) of the snapshot that the new serverless cache will be created from. Available for Redis only.
    SnapshotRetentionLimit int
    The number of snapshots that will be retained for the serverless cache that is being created. As new snapshots beyond this limit are added, the oldest snapshots will be deleted on a rolling basis. Available for Redis only.
    Status string
    The current status of the serverless cache. The allowed values are CREATING, AVAILABLE, DELETING, CREATE-FAILED and MODIFYING.
    SubnetIds List<string>
    A list of the identifiers of the subnets where the VPC endpoint for the serverless cache will be deployed. All the subnetIds must belong to the same VPC.
    Tags Dictionary<string, string>
    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    TagsAll Dictionary<string, string>

    Deprecated: Please use tags instead.

    Timeouts ServerlessCacheTimeouts
    UserGroupId string
    The identifier of the UserGroup to be associated with the serverless cache. Available for Redis only. Default is NULL.
    Arn string
    The Amazon Resource Name (ARN) of the serverless cache.
    CacheUsageLimits ServerlessCacheCacheUsageLimitsArgs
    Sets the cache usage limits for storage and ElastiCache Processing Units for the cache. See configuration below.
    CreateTime string
    Timestamp of when the serverless cache was created.
    DailySnapshotTime string
    The daily time that snapshots will be created from the new serverless cache. Only supported for engine type "redis". Defaults to 0.
    Description string
    User-provided description for the serverless cache. The default is NULL.
    Endpoints []ServerlessCacheEndpointArgs
    Represents the information required for client programs to connect to a cache node. See config below for details.
    Engine string
    Name of the cache engine to be used for this cache cluster. Valid values are memcached or redis.
    FullEngineVersion string
    The name and version number of the engine the serverless cache is compatible with.
    KmsKeyId string
    ARN of the customer managed key for encrypting the data at rest. If no KMS key is provided, a default service key is used.
    MajorEngineVersion string
    The version of the cache engine that will be used to create the serverless cache. See Describe Cache Engine Versions in the AWS Documentation for supported versions.
    Name string

    The Cluster name which serves as a unique identifier to the serverless cache

    The following arguments are optional:

    ReaderEndpoints []ServerlessCacheReaderEndpointArgs
    Represents the information required for client programs to connect to a cache node. See config below for details.
    SecurityGroupIds []string
    A list of the one or more VPC security groups to be associated with the serverless cache. The security group will authorize traffic access for the VPC end-point (private-link). If no other information is given this will be the VPC’s Default Security Group that is associated with the cluster VPC end-point.
    SnapshotArnsToRestores []string
    The list of ARN(s) of the snapshot that the new serverless cache will be created from. Available for Redis only.
    SnapshotRetentionLimit int
    The number of snapshots that will be retained for the serverless cache that is being created. As new snapshots beyond this limit are added, the oldest snapshots will be deleted on a rolling basis. Available for Redis only.
    Status string
    The current status of the serverless cache. The allowed values are CREATING, AVAILABLE, DELETING, CREATE-FAILED and MODIFYING.
    SubnetIds []string
    A list of the identifiers of the subnets where the VPC endpoint for the serverless cache will be deployed. All the subnetIds must belong to the same VPC.
    Tags map[string]string
    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    TagsAll map[string]string

    Deprecated: Please use tags instead.

    Timeouts ServerlessCacheTimeoutsArgs
    UserGroupId string
    The identifier of the UserGroup to be associated with the serverless cache. Available for Redis only. Default is NULL.
    arn String
    The Amazon Resource Name (ARN) of the serverless cache.
    cacheUsageLimits ServerlessCacheCacheUsageLimits
    Sets the cache usage limits for storage and ElastiCache Processing Units for the cache. See configuration below.
    createTime String
    Timestamp of when the serverless cache was created.
    dailySnapshotTime String
    The daily time that snapshots will be created from the new serverless cache. Only supported for engine type "redis". Defaults to 0.
    description String
    User-provided description for the serverless cache. The default is NULL.
    endpoints List<ServerlessCacheEndpoint>
    Represents the information required for client programs to connect to a cache node. See config below for details.
    engine String
    Name of the cache engine to be used for this cache cluster. Valid values are memcached or redis.
    fullEngineVersion String
    The name and version number of the engine the serverless cache is compatible with.
    kmsKeyId String
    ARN of the customer managed key for encrypting the data at rest. If no KMS key is provided, a default service key is used.
    majorEngineVersion String
    The version of the cache engine that will be used to create the serverless cache. See Describe Cache Engine Versions in the AWS Documentation for supported versions.
    name String

    The Cluster name which serves as a unique identifier to the serverless cache

    The following arguments are optional:

    readerEndpoints List<ServerlessCacheReaderEndpoint>
    Represents the information required for client programs to connect to a cache node. See config below for details.
    securityGroupIds List<String>
    A list of the one or more VPC security groups to be associated with the serverless cache. The security group will authorize traffic access for the VPC end-point (private-link). If no other information is given this will be the VPC’s Default Security Group that is associated with the cluster VPC end-point.
    snapshotArnsToRestores List<String>
    The list of ARN(s) of the snapshot that the new serverless cache will be created from. Available for Redis only.
    snapshotRetentionLimit Integer
    The number of snapshots that will be retained for the serverless cache that is being created. As new snapshots beyond this limit are added, the oldest snapshots will be deleted on a rolling basis. Available for Redis only.
    status String
    The current status of the serverless cache. The allowed values are CREATING, AVAILABLE, DELETING, CREATE-FAILED and MODIFYING.
    subnetIds List<String>
    A list of the identifiers of the subnets where the VPC endpoint for the serverless cache will be deployed. All the subnetIds must belong to the same VPC.
    tags Map<String,String>
    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tagsAll Map<String,String>

    Deprecated: Please use tags instead.

    timeouts ServerlessCacheTimeouts
    userGroupId String
    The identifier of the UserGroup to be associated with the serverless cache. Available for Redis only. Default is NULL.
    arn string
    The Amazon Resource Name (ARN) of the serverless cache.
    cacheUsageLimits ServerlessCacheCacheUsageLimits
    Sets the cache usage limits for storage and ElastiCache Processing Units for the cache. See configuration below.
    createTime string
    Timestamp of when the serverless cache was created.
    dailySnapshotTime string
    The daily time that snapshots will be created from the new serverless cache. Only supported for engine type "redis". Defaults to 0.
    description string
    User-provided description for the serverless cache. The default is NULL.
    endpoints ServerlessCacheEndpoint[]
    Represents the information required for client programs to connect to a cache node. See config below for details.
    engine string
    Name of the cache engine to be used for this cache cluster. Valid values are memcached or redis.
    fullEngineVersion string
    The name and version number of the engine the serverless cache is compatible with.
    kmsKeyId string
    ARN of the customer managed key for encrypting the data at rest. If no KMS key is provided, a default service key is used.
    majorEngineVersion string
    The version of the cache engine that will be used to create the serverless cache. See Describe Cache Engine Versions in the AWS Documentation for supported versions.
    name string

    The Cluster name which serves as a unique identifier to the serverless cache

    The following arguments are optional:

    readerEndpoints ServerlessCacheReaderEndpoint[]
    Represents the information required for client programs to connect to a cache node. See config below for details.
    securityGroupIds string[]
    A list of the one or more VPC security groups to be associated with the serverless cache. The security group will authorize traffic access for the VPC end-point (private-link). If no other information is given this will be the VPC’s Default Security Group that is associated with the cluster VPC end-point.
    snapshotArnsToRestores string[]
    The list of ARN(s) of the snapshot that the new serverless cache will be created from. Available for Redis only.
    snapshotRetentionLimit number
    The number of snapshots that will be retained for the serverless cache that is being created. As new snapshots beyond this limit are added, the oldest snapshots will be deleted on a rolling basis. Available for Redis only.
    status string
    The current status of the serverless cache. The allowed values are CREATING, AVAILABLE, DELETING, CREATE-FAILED and MODIFYING.
    subnetIds string[]
    A list of the identifiers of the subnets where the VPC endpoint for the serverless cache will be deployed. All the subnetIds must belong to the same VPC.
    tags {[key: string]: string}
    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tagsAll {[key: string]: string}

    Deprecated: Please use tags instead.

    timeouts ServerlessCacheTimeouts
    userGroupId string
    The identifier of the UserGroup to be associated with the serverless cache. Available for Redis only. Default is NULL.
    arn str
    The Amazon Resource Name (ARN) of the serverless cache.
    cache_usage_limits ServerlessCacheCacheUsageLimitsArgs
    Sets the cache usage limits for storage and ElastiCache Processing Units for the cache. See configuration below.
    create_time str
    Timestamp of when the serverless cache was created.
    daily_snapshot_time str
    The daily time that snapshots will be created from the new serverless cache. Only supported for engine type "redis". Defaults to 0.
    description str
    User-provided description for the serverless cache. The default is NULL.
    endpoints Sequence[ServerlessCacheEndpointArgs]
    Represents the information required for client programs to connect to a cache node. See config below for details.
    engine str
    Name of the cache engine to be used for this cache cluster. Valid values are memcached or redis.
    full_engine_version str
    The name and version number of the engine the serverless cache is compatible with.
    kms_key_id str
    ARN of the customer managed key for encrypting the data at rest. If no KMS key is provided, a default service key is used.
    major_engine_version str
    The version of the cache engine that will be used to create the serverless cache. See Describe Cache Engine Versions in the AWS Documentation for supported versions.
    name str

    The Cluster name which serves as a unique identifier to the serverless cache

    The following arguments are optional:

    reader_endpoints Sequence[ServerlessCacheReaderEndpointArgs]
    Represents the information required for client programs to connect to a cache node. See config below for details.
    security_group_ids Sequence[str]
    A list of the one or more VPC security groups to be associated with the serverless cache. The security group will authorize traffic access for the VPC end-point (private-link). If no other information is given this will be the VPC’s Default Security Group that is associated with the cluster VPC end-point.
    snapshot_arns_to_restores Sequence[str]
    The list of ARN(s) of the snapshot that the new serverless cache will be created from. Available for Redis only.
    snapshot_retention_limit int
    The number of snapshots that will be retained for the serverless cache that is being created. As new snapshots beyond this limit are added, the oldest snapshots will be deleted on a rolling basis. Available for Redis only.
    status str
    The current status of the serverless cache. The allowed values are CREATING, AVAILABLE, DELETING, CREATE-FAILED and MODIFYING.
    subnet_ids Sequence[str]
    A list of the identifiers of the subnets where the VPC endpoint for the serverless cache will be deployed. All the subnetIds must belong to the same VPC.
    tags Mapping[str, str]
    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tags_all Mapping[str, str]

    Deprecated: Please use tags instead.

    timeouts ServerlessCacheTimeoutsArgs
    user_group_id str
    The identifier of the UserGroup to be associated with the serverless cache. Available for Redis only. Default is NULL.
    arn String
    The Amazon Resource Name (ARN) of the serverless cache.
    cacheUsageLimits Property Map
    Sets the cache usage limits for storage and ElastiCache Processing Units for the cache. See configuration below.
    createTime String
    Timestamp of when the serverless cache was created.
    dailySnapshotTime String
    The daily time that snapshots will be created from the new serverless cache. Only supported for engine type "redis". Defaults to 0.
    description String
    User-provided description for the serverless cache. The default is NULL.
    endpoints List<Property Map>
    Represents the information required for client programs to connect to a cache node. See config below for details.
    engine String
    Name of the cache engine to be used for this cache cluster. Valid values are memcached or redis.
    fullEngineVersion String
    The name and version number of the engine the serverless cache is compatible with.
    kmsKeyId String
    ARN of the customer managed key for encrypting the data at rest. If no KMS key is provided, a default service key is used.
    majorEngineVersion String
    The version of the cache engine that will be used to create the serverless cache. See Describe Cache Engine Versions in the AWS Documentation for supported versions.
    name String

    The Cluster name which serves as a unique identifier to the serverless cache

    The following arguments are optional:

    readerEndpoints List<Property Map>
    Represents the information required for client programs to connect to a cache node. See config below for details.
    securityGroupIds List<String>
    A list of the one or more VPC security groups to be associated with the serverless cache. The security group will authorize traffic access for the VPC end-point (private-link). If no other information is given this will be the VPC’s Default Security Group that is associated with the cluster VPC end-point.
    snapshotArnsToRestores List<String>
    The list of ARN(s) of the snapshot that the new serverless cache will be created from. Available for Redis only.
    snapshotRetentionLimit Number
    The number of snapshots that will be retained for the serverless cache that is being created. As new snapshots beyond this limit are added, the oldest snapshots will be deleted on a rolling basis. Available for Redis only.
    status String
    The current status of the serverless cache. The allowed values are CREATING, AVAILABLE, DELETING, CREATE-FAILED and MODIFYING.
    subnetIds List<String>
    A list of the identifiers of the subnets where the VPC endpoint for the serverless cache will be deployed. All the subnetIds must belong to the same VPC.
    tags Map<String>
    Map of tags to assign to the resource. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tagsAll Map<String>

    Deprecated: Please use tags instead.

    timeouts Property Map
    userGroupId String
    The identifier of the UserGroup to be associated with the serverless cache. Available for Redis only. Default is NULL.

    Supporting Types

    ServerlessCacheCacheUsageLimits, ServerlessCacheCacheUsageLimitsArgs

    DataStorage ServerlessCacheCacheUsageLimitsDataStorage
    The maximum data storage limit in the cache, expressed in Gigabytes. See Data Storage config for more details.
    EcpuPerSeconds List<ServerlessCacheCacheUsageLimitsEcpuPerSecond>
    The configuration for the number of ElastiCache Processing Units (ECPU) the cache can consume per second.See config block for more details.
    DataStorage ServerlessCacheCacheUsageLimitsDataStorage
    The maximum data storage limit in the cache, expressed in Gigabytes. See Data Storage config for more details.
    EcpuPerSeconds []ServerlessCacheCacheUsageLimitsEcpuPerSecond
    The configuration for the number of ElastiCache Processing Units (ECPU) the cache can consume per second.See config block for more details.
    dataStorage ServerlessCacheCacheUsageLimitsDataStorage
    The maximum data storage limit in the cache, expressed in Gigabytes. See Data Storage config for more details.
    ecpuPerSeconds List<ServerlessCacheCacheUsageLimitsEcpuPerSecond>
    The configuration for the number of ElastiCache Processing Units (ECPU) the cache can consume per second.See config block for more details.
    dataStorage ServerlessCacheCacheUsageLimitsDataStorage
    The maximum data storage limit in the cache, expressed in Gigabytes. See Data Storage config for more details.
    ecpuPerSeconds ServerlessCacheCacheUsageLimitsEcpuPerSecond[]
    The configuration for the number of ElastiCache Processing Units (ECPU) the cache can consume per second.See config block for more details.
    data_storage ServerlessCacheCacheUsageLimitsDataStorage
    The maximum data storage limit in the cache, expressed in Gigabytes. See Data Storage config for more details.
    ecpu_per_seconds Sequence[ServerlessCacheCacheUsageLimitsEcpuPerSecond]
    The configuration for the number of ElastiCache Processing Units (ECPU) the cache can consume per second.See config block for more details.
    dataStorage Property Map
    The maximum data storage limit in the cache, expressed in Gigabytes. See Data Storage config for more details.
    ecpuPerSeconds List<Property Map>
    The configuration for the number of ElastiCache Processing Units (ECPU) the cache can consume per second.See config block for more details.

    ServerlessCacheCacheUsageLimitsDataStorage, ServerlessCacheCacheUsageLimitsDataStorageArgs

    Unit string
    The unit that the storage is measured in, in GB.
    Maximum int
    The upper limit for data storage the cache is set to use. Must be between 1 and 5,000.
    Minimum int
    The lower limit for data storage the cache is set to use. Must be between 1 and 5,000.
    Unit string
    The unit that the storage is measured in, in GB.
    Maximum int
    The upper limit for data storage the cache is set to use. Must be between 1 and 5,000.
    Minimum int
    The lower limit for data storage the cache is set to use. Must be between 1 and 5,000.
    unit String
    The unit that the storage is measured in, in GB.
    maximum Integer
    The upper limit for data storage the cache is set to use. Must be between 1 and 5,000.
    minimum Integer
    The lower limit for data storage the cache is set to use. Must be between 1 and 5,000.
    unit string
    The unit that the storage is measured in, in GB.
    maximum number
    The upper limit for data storage the cache is set to use. Must be between 1 and 5,000.
    minimum number
    The lower limit for data storage the cache is set to use. Must be between 1 and 5,000.
    unit str
    The unit that the storage is measured in, in GB.
    maximum int
    The upper limit for data storage the cache is set to use. Must be between 1 and 5,000.
    minimum int
    The lower limit for data storage the cache is set to use. Must be between 1 and 5,000.
    unit String
    The unit that the storage is measured in, in GB.
    maximum Number
    The upper limit for data storage the cache is set to use. Must be between 1 and 5,000.
    minimum Number
    The lower limit for data storage the cache is set to use. Must be between 1 and 5,000.

    ServerlessCacheCacheUsageLimitsEcpuPerSecond, ServerlessCacheCacheUsageLimitsEcpuPerSecondArgs

    Maximum int
    The upper limit for data storage the cache is set to use. Must be between 1 and 5,000.
    Minimum int
    The lower limit for data storage the cache is set to use. Must be between 1 and 5,000.
    Maximum int
    The upper limit for data storage the cache is set to use. Must be between 1 and 5,000.
    Minimum int
    The lower limit for data storage the cache is set to use. Must be between 1 and 5,000.
    maximum Integer
    The upper limit for data storage the cache is set to use. Must be between 1 and 5,000.
    minimum Integer
    The lower limit for data storage the cache is set to use. Must be between 1 and 5,000.
    maximum number
    The upper limit for data storage the cache is set to use. Must be between 1 and 5,000.
    minimum number
    The lower limit for data storage the cache is set to use. Must be between 1 and 5,000.
    maximum int
    The upper limit for data storage the cache is set to use. Must be between 1 and 5,000.
    minimum int
    The lower limit for data storage the cache is set to use. Must be between 1 and 5,000.
    maximum Number
    The upper limit for data storage the cache is set to use. Must be between 1 and 5,000.
    minimum Number
    The lower limit for data storage the cache is set to use. Must be between 1 and 5,000.

    ServerlessCacheEndpoint, ServerlessCacheEndpointArgs

    Address string
    The DNS hostname of the cache node.
    Port int
    The port number that the cache engine is listening on. Set as integer.
    Address string
    The DNS hostname of the cache node.
    Port int
    The port number that the cache engine is listening on. Set as integer.
    address String
    The DNS hostname of the cache node.
    port Integer
    The port number that the cache engine is listening on. Set as integer.
    address string
    The DNS hostname of the cache node.
    port number
    The port number that the cache engine is listening on. Set as integer.
    address str
    The DNS hostname of the cache node.
    port int
    The port number that the cache engine is listening on. Set as integer.
    address String
    The DNS hostname of the cache node.
    port Number
    The port number that the cache engine is listening on. Set as integer.

    ServerlessCacheReaderEndpoint, ServerlessCacheReaderEndpointArgs

    Address string
    The DNS hostname of the cache node.
    Port int
    The port number that the cache engine is listening on. Set as integer.
    Address string
    The DNS hostname of the cache node.
    Port int
    The port number that the cache engine is listening on. Set as integer.
    address String
    The DNS hostname of the cache node.
    port Integer
    The port number that the cache engine is listening on. Set as integer.
    address string
    The DNS hostname of the cache node.
    port number
    The port number that the cache engine is listening on. Set as integer.
    address str
    The DNS hostname of the cache node.
    port int
    The port number that the cache engine is listening on. Set as integer.
    address String
    The DNS hostname of the cache node.
    port Number
    The port number that the cache engine is listening on. Set as integer.

    ServerlessCacheTimeouts, ServerlessCacheTimeoutsArgs

    Create string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    Delete string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    Update string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    Create string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    Delete string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    Update string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    create String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    delete String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    update String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    create string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    delete string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    update string
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    create str
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    delete str
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    update str
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    create String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
    delete String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
    update String
    A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).

    Import

    Using pulumi import, import ElastiCache Serverless Cache using the name. For example:

    $ pulumi import aws:elasticache/serverlessCache:ServerlessCache my_cluster my_cluster
    

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo

    Try AWS Native preview for resources not in the classic version.

    AWS Classic v6.32.0 published on Friday, Apr 19, 2024 by Pulumi