Class: AWS.ElastiCache
- Inherits:
-
AWS.Service
- Object
- AWS.Service
- AWS.ElastiCache
- Identifier:
- elasticache
- API Version:
- 2015-02-02
- Defined in:
- (unknown)
Overview
Constructs a service interface object. Each API operation is exposed as a function on service.
Service Description
Amazon ElastiCache is a web service that makes it easier to set up, operate, and scale a distributed cache in the cloud.
With ElastiCache, customers get all of the benefits of a high-performance, in-memory cache with less of the administrative burden involved in launching and managing a distributed cache. The service makes setup, scaling, and cluster failure handling much simpler than in a self-managed cache deployment.
In addition, through integration with Amazon CloudWatch, customers get enhanced visibility into the key performance statistics associated with their cache and can receive alarms if a part of their cache runs hot.
Sending a Request Using ElastiCache
var elasticache = new AWS.ElastiCache();
elasticache.addTagsToResource(params, function (err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Locking the API Version
In order to ensure that the ElastiCache object uses this specific API, you can
construct the object by passing the apiVersion option to the constructor:
var elasticache = new AWS.ElastiCache({apiVersion: '2015-02-02'});
You can also set the API version globally in AWS.config.apiVersions using
the elasticache service identifier:
AWS.config.apiVersions = {
elasticache: '2015-02-02',
// other service API versions
};
var elasticache = new AWS.ElastiCache();
Waiter Resource States
This service supports a list of resource states that can be polled using the waitFor() method. The resource states are:
cacheClusterAvailable, cacheClusterDeleted, replicationGroupAvailable, replicationGroupDeleted
Constructor Summary collapse
-
new AWS.ElastiCache(options = {}) ⇒ Object
constructor
Constructs a service object.
Property Summary collapse
-
endpoint ⇒ AWS.Endpoint
readwrite
An Endpoint object representing the endpoint URL for service requests.
Properties inherited from AWS.Service
Method Summary collapse
-
addTagsToResource(params = {}, callback) ⇒ AWS.Request
A tag is a key-value pair where the key and value are case-sensitive.
-
authorizeCacheSecurityGroupIngress(params = {}, callback) ⇒ AWS.Request
Allows network ingress to a cache security group.
-
batchApplyUpdateAction(params = {}, callback) ⇒ AWS.Request
Apply the service update.
-
batchStopUpdateAction(params = {}, callback) ⇒ AWS.Request
Stop the service update.
-
completeMigration(params = {}, callback) ⇒ AWS.Request
Complete the migration of data.
.
-
copyServerlessCacheSnapshot(params = {}, callback) ⇒ AWS.Request
Creates a copy of an existing serverless cache’s snapshot.
-
copySnapshot(params = {}, callback) ⇒ AWS.Request
Makes a copy of an existing snapshot.
Note: This operation is valid for Redis OSS only.- createCacheCluster(params = {}, callback) ⇒ AWS.Request
Creates a cluster.
- createCacheParameterGroup(params = {}, callback) ⇒ AWS.Request
Creates a new Amazon ElastiCache cache parameter group.
- createCacheSecurityGroup(params = {}, callback) ⇒ AWS.Request
Creates a new cache security group.
- createCacheSubnetGroup(params = {}, callback) ⇒ AWS.Request
Creates a new cache subnet group.
Use this parameter only when you are creating a cluster in an Amazon Virtual Private Cloud (Amazon VPC).
.- createGlobalReplicationGroup(params = {}, callback) ⇒ AWS.Request
Global Datastore for Redis OSS offers fully managed, fast, reliable and secure cross-region replication.
- createReplicationGroup(params = {}, callback) ⇒ AWS.Request
Creates a Redis OSS (cluster mode disabled) or a Redis OSS (cluster mode enabled) replication group.
This API can be used to create a standalone regional replication group or a secondary replication group associated with a Global datastore.
A Redis OSS (cluster mode disabled) replication group is a collection of nodes, where one of the nodes is a read/write primary and the others are read-only replicas.
- createServerlessCache(params = {}, callback) ⇒ AWS.Request
Creates a serverless cache.
.
- createServerlessCacheSnapshot(params = {}, callback) ⇒ AWS.Request
This API creates a copy of an entire ServerlessCache at a specific moment in time.
- createSnapshot(params = {}, callback) ⇒ AWS.Request
Creates a copy of an entire cluster or replication group at a specific moment in time.
Note: This operation is valid for Redis OSS only.- createUser(params = {}, callback) ⇒ AWS.Request
For Redis OSS engine version 6.0 onwards: Creates a Redis OSS user.
- createUserGroup(params = {}, callback) ⇒ AWS.Request
For Redis OSS engine version 6.0 onwards: Creates a Redis OSS user group.
- decreaseNodeGroupsInGlobalReplicationGroup(params = {}, callback) ⇒ AWS.Request
Decreases the number of node groups in a Global datastore
.
- decreaseReplicaCount(params = {}, callback) ⇒ AWS.Request
Dynamically decreases the number of replicas in a Redis OSS (cluster mode disabled) replication group or the number of replica nodes in one or more node groups (shards) of a Redis OSS (cluster mode enabled) replication group.
- deleteCacheCluster(params = {}, callback) ⇒ AWS.Request
Deletes a previously provisioned cluster.
- deleteCacheParameterGroup(params = {}, callback) ⇒ AWS.Request
Deletes the specified cache parameter group.
- deleteCacheSecurityGroup(params = {}, callback) ⇒ AWS.Request
Deletes a cache security group.
Note: You cannot delete a cache security group if it is associated with any clusters.- deleteCacheSubnetGroup(params = {}, callback) ⇒ AWS.Request
Deletes a cache subnet group.
Note: You cannot delete a default cache subnet group or one that is associated with any clusters.- deleteGlobalReplicationGroup(params = {}, callback) ⇒ AWS.Request
Deleting a Global datastore is a two-step process:
-
First, you must DisassociateGlobalReplicationGroup to remove the secondary clusters in the Global datastore.
-
Once the Global datastore contains only the primary cluster, you can use the
DeleteGlobalReplicationGroupAPI to delete the Global datastore while retainining the primary cluster usingRetainPrimaryReplicationGroup=true.
Since the Global Datastore has only a primary cluster, you can delete the Global Datastore while retaining the primary by setting
RetainPrimaryReplicationGroup=true.- deleteReplicationGroup(params = {}, callback) ⇒ AWS.Request
Deletes an existing replication group.
- deleteServerlessCache(params = {}, callback) ⇒ AWS.Request
Deletes a specified existing serverless cache.
Note:CreateServerlessCacheSnapshotpermission is required to create a final snapshot.- deleteServerlessCacheSnapshot(params = {}, callback) ⇒ AWS.Request
Deletes an existing serverless cache snapshot.
- deleteSnapshot(params = {}, callback) ⇒ AWS.Request
Deletes an existing snapshot.
- deleteUser(params = {}, callback) ⇒ AWS.Request
For Redis OSS engine version 6.0 onwards: Deletes a user.
- deleteUserGroup(params = {}, callback) ⇒ AWS.Request
For Redis OSS engine version 6.0 onwards: Deletes a user group.
- describeCacheClusters(params = {}, callback) ⇒ AWS.Request
Returns information about all provisioned clusters if no cluster identifier is specified, or about a specific cache cluster if a cluster identifier is supplied.
By default, abbreviated information about the clusters is returned.
- describeCacheEngineVersions(params = {}, callback) ⇒ AWS.Request
Returns a list of the available cache engines and their versions.
.
- describeCacheParameterGroups(params = {}, callback) ⇒ AWS.Request
Returns a list of cache parameter group descriptions.
- describeCacheParameters(params = {}, callback) ⇒ AWS.Request
Returns the detailed parameter list for a particular cache parameter group.
.
- describeCacheSecurityGroups(params = {}, callback) ⇒ AWS.Request
Returns a list of cache security group descriptions.
- describeCacheSubnetGroups(params = {}, callback) ⇒ AWS.Request
Returns a list of cache subnet group descriptions.
- describeEngineDefaultParameters(params = {}, callback) ⇒ AWS.Request
Returns the default engine and system parameter information for the specified cache engine.
.
- describeEvents(params = {}, callback) ⇒ AWS.Request
Returns events related to clusters, cache security groups, and cache parameter groups.
- describeGlobalReplicationGroups(params = {}, callback) ⇒ AWS.Request
Returns information about a particular global replication group.
- describeReplicationGroups(params = {}, callback) ⇒ AWS.Request
Returns information about a particular replication group.
- describeReservedCacheNodes(params = {}, callback) ⇒ AWS.Request
Returns information about reserved cache nodes for this account, or about a specified reserved cache node.
.
- describeReservedCacheNodesOfferings(params = {}, callback) ⇒ AWS.Request
Lists available reserved cache node offerings.
.
- describeServerlessCaches(params = {}, callback) ⇒ AWS.Request
Returns information about a specific serverless cache.
- describeServerlessCacheSnapshots(params = {}, callback) ⇒ AWS.Request
Returns information about serverless cache snapshots.
- describeServiceUpdates(params = {}, callback) ⇒ AWS.Request
Returns details of the service updates
.
- describeSnapshots(params = {}, callback) ⇒ AWS.Request
Returns information about cluster or replication group snapshots.
- describeUpdateActions(params = {}, callback) ⇒ AWS.Request
Returns details of the update actions
.
- createCacheCluster(params = {}, callback) ⇒ AWS.Request