Menu
Amazon ElastiCache
User Guide (API Version 2015-02-02)

Finding Node Endpoints and Port Numbers

To connect to a cache node, your application needs to know the endpoint and port number for that node.

Finding Node Endpoints and Port Numbers (Console)

To determine node endpoints and port numbers

  1. Sign in to the Amazon ElastiCache Management Console and choose either Memcached or Redis.

    A list of all clusters running the chosen engine appears.

  2. Continue below for the engine and configuration you're running.

Memcached

  1. Choose the name of the cluster of interest.

  2. Locate the Port and Endpoint columns for the node you're interested in.

Redis: Non-cluster mode

  1. Choose the name of the cluster of interest.

  2. Locate the Port and Endpoint columns for the node you're interested in.

Redis: Cluster mode

  1. Choose the name of the cluster of interest.

    A list of all the shards in that cluster appears.

  2. Choose the name of the shard of interest.

    A list of all the nodes in that shard appears

  3. Locate the Port and Endpoint columns for the node you're interested in.

Finding Cache Node Endpoints and Port Numbers (AWS CLI)

To determine cache node endpoints and port numbers, use the command describe-cache-clusters with the --show-cache-node-info parameter.

Copy
aws elasticache describe-cache-clusters --show-cache-node-info

This command should produce output similar to the following:

Copy
CACHECLUSTER my-memcached https://console.aws.amazon.com/elasticache/home#client-download: 2013-07-09T22:12:42.151Z cache.t1.micro memcached available 1 us-west-2a 1.4.14 CACHESECURITYGROUP default active CACHEPARAMETERGROUP default.memcached1.4 in-sync CACHENODE 0001 available my-memcached.f310xz.cache.amazonaws.com 11211 in-sync CACHECLUSTER my-redis-primary https://console.aws.amazon.com/elasticache/home#client-download: 2013-07-10T22:47:16.586Z cache.m1.small redis available 1 us-west-2a 2.6.13 repgroup01 CACHESECURITYGROUP default active CACHEPARAMETERGROUP default redis2.6 in-sync CACHENODE 0001 available my-redis-primary.f310xz.0001.cache.amazonaws.com 6379 in-sync CACHECLUSTER my-redis-replica-01 https://console.aws.amazon.com/elasticache/home#client-download: 2013-07-10T23:11:07.704Z cache.m1.small redis available 1 us-west-2b 2.6.13 repgroup01 CACHESECURITYGROUP default active CACHEPARAMETERGROUP default redis2.6 in-sync CACHENODE 0001 available my-redis-replica-01.f310xz.0001.cache.amazonaws.com 6379 in-sync

The fully qualified DNS names and port numbers are in the CACHENODE lines in the output.

Finding Cache Node Endpoints and Port Numbers (ElastiCache API)

To determine cache node endpoints and port numbers, use the action DescribeCacheClusters with the ShowCacheNodeInfo=true parameter.

Example

Copy
https://elasticache.us-west-2.amazonaws.com / ?Action=DescribeCacheClusters &ShowCacheNodeInfo=true &SignatureVersion=4 &SignatureMethod=HmacSHA256 &Timestamp=20140421T220302Z &Version=2014-09-30 &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=<credential> &X-Amz-Date=20140421T220302Z &X-Amz-Expires=20140421T220302Z &X-Amz-Signature=<signature> &X-Amz-SignedHeaders=Host