翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
接続エンドポイントの検索
エンドポイントを使用してアプリケーションがクラスターに接続します。エンドポイントはノードまたはクラスターの一意のアドレスです。
自動検出を使用しない場合は、読み取りと書き込みに個々のノードのエンドポイントを使用するようにクライアントを設定する必要があります。また、ノードの追加や削除時にはそれらのエンドポイントを更新する必要があります。
使用するエンドポイント
-
Redis OSS スタンドアロンノード では、読み取りオペレーションと書き込みオペレーションの両方にノードのエンドポイントを使用します。
-
Redis OSS (クラスターモードが無効) クラスター では、すべての書き込みオペレーションにプライマリエンドポイントを使用します。読み込みエンドポイントを使用して、すべてのリードレプリカ間でエンドポイントへの着信接続を均等に分割します。個々のノードエンドポイント (API/CLI ではリードエンドポイント) を読み取りオペレーションに使用します。
-
Redis OSS (クラスターモードが有効) クラスター では、クラスターモードが有効なコマンドをサポートするすべてのオペレーションで、クラスターの設定エンドポイントを使用します。Redis OSS クラスター (Redis OSS 3.2) をサポートするクライアントを使用する必要があります。個々のノードエンドポイント (API/CLI ではリードエンドポイント) から読み取ることもできます。
以下のセクションで、実行するエンジンに必要なエンドポイントの検索について説明します。
Redis OSS (クラスターモードが無効) クラスターに 1 つのノードしかない場合、ノードのエンドポイントは読み取りと書き込みの両方に使用されます。Redis OSS (クラスターモードが無効) クラスターに複数のノードがある場合、プライマリエンドポイント 、リーダーエンドポイント 、ノードエンドポイント の 3 種類のエンドポイントがあります。
プライマリエンドポイントは、常にクラスターのプライマリノードに解決される DNS 名です。プライマリエンドポイントは、リードレプリカのプライマリロールへの昇格など、クラスターに対する変更の影響を受けません。書き込みアクティビティの場合、アプリケーションをプライマリエンドポイントに接続することをお勧めします。
リーダーエンドポイントは、 ElastiCache (Redis OSS) クラスター内のすべてのリードレプリカ間でエンドポイントへの受信接続を均等に分割します。アプリケーションがいつ接続を作成するか、アプリケーションが接続をどのように (再) 利用するかなどの追加要因によって、トラフィックの分散が決定されます。レプリカが追加または削除されても、読み込みエンドポイントはリアルタイムでクラスターの変更に対応します。 ElastiCache (Redis OSS) クラスターの複数のリードレプリカを異なるアベイラ AWS ビリティーゾーン (AZ) に配置して、リーダーエンドポイントの高可用性を確保できます。
注記
リーダーエンドポイントはロードバランサーではありません。これは、ラウンドロビン方式でレプリカノードの 1 つの IP アドレスに解決される DNS レコードです。
読み取りアクティビティの場合、アプリケーションはクラスター内のいずれのノードにも接続できます。プライマリエンドポイントとは異なり、ノードエンドポイントは特定のエンドポイントに解決されます。レプリカの追加または削除など、クラスターに変更を加えた場合は、アプリケーションでノードエンドポイントを更新する必要があります。
Redis OSS (クラスターモードが無効) クラスターのエンドポイントを検索するには
-
にサインイン AWS Management Console し、https://console.aws.amazon.com/elasticache/
で ElastiCache コンソールを開きます。 -
ナビゲーションペインから、Redis OSS クラスター を選択します。
クラスター画面には、Redis OSS (クラスターモードが無効) および Redis OSS (クラスターモードが有効) クラスターのリストが表示されます。
-
クラスターのプライマリエンドポイントや読み込みエンドポイントを検索するには、クラスターの名前 (左にあるボタンではない) を選択します。
Redis OSS (クラスターモードが無効) クラスターのプライマリエンドポイントとリーダーエンドポイント
クラスターに 1 つのみのノードがある場合、プライマリエンドポイントはないため、次のステップに進むことができます。
-
Redis OSS (クラスターモードが無効) クラスターにレプリカノードがある場合は、クラスターの名前を選択し、Nodes タブを選択することで、クラスターのレプリカノードエンドポイントを見つけることができます。
ノードの画面では、クラスター内のプライマリとレプリカの各ノードがそのエンドポイントと共に表示されます。
Redis OSS (クラスターモードが無効) クラスターのノードエンドポイント
-
エンドポイントをクリップボードにコピーするには:
-
一度に 1 つのみ、コピーするエンドポイントを見つけます。
-
エンドポイントアドレスのすぐ前にあるコピーアイコンを選択します。
エンドポイントがクリップボードにコピーされます。エンドポイントを使用してノードに接続する方法については、「ノードに接続する」を参照してください。
-
Redis OSS (クラスターモードが無効) のプライマリエンドポイントは次のようになります。転送時の暗号化が有効かどうかによって違いがあります。
転送時の暗号化が無効
clusterName.xxxxxx
.nodeId
.regionAndAz
.cache.amazonaws.com:port
redis-01.7abc2d.0001.usw2.cache.amazonaws.com:6379
転送時の暗号化が有効
master.clusterName
.xxxxxx
.regionAndAz
.cache.amazonaws.com:port
master.ncit.ameaqx.use1.cache.amazonaws.com:6379
Redis OSS (クラスターモードが有効) クラスターには、単一の設定エンドポイントがあります。設定エンドポイントに接続することで、アプリケーションはクラスター内のシャードごとにプライマリおよびリードエンドポイントを検出できます。
Redis OSS (クラスターモードが有効) クラスターのエンドポイントを検索するには
-
にサインイン AWS Management Console し、https://console.aws.amazon.com/elasticache/
で ElastiCache コンソールを開きます。 -
ナビゲーションペインから、Redis OSS クラスター を選択します。
クラスター画面には、Redis OSS (クラスターモードが無効) および Redis OSS (クラスターモードが有効) クラスターのリストが表示されます。接続する Redis OSS (クラスターモードが有効) クラスターを選択します。
-
クラスターの設定エンドポイントを検索するには、ラジオボタンではなくクラスターの名前を選択します。
-
[Configuration endpoint] (設定エンドポイント) は [Cluster details] (クラスターの詳細) の下に表示されます。コピーするには、エンドポイントの左側にある [copy] (コピー) アイコンを選択します。
Amazon AWS CLI の を使用して ElastiCache 、ノード、クラスター、レプリケーショングループのエンドポイントを検出できます。
ノードとクラスターのエンドポイントの検索(AWS CLI)
を使用して AWS CLI 、 describe-cache-clusters
コマンドを使用してクラスターとそのノードのエンドポイントを検出できます。Redis クラスターでは、そのコマンドがクラスターエンドポイントを返します。オプションのパラメータ --show-cache-node-info
を含めた場合、コマンドはクラスター内の個々のノードにエンドポイントを返します。
次のコマンドは、単一ノード Redis OSS (クラスターモードが無効) クラスター mycluster のクラスター情報を取得します。
重要
パラメータは、Redis レプリケーショングループの単一ノード Redis OSS (クラスターモードが無効) クラスター ID または特定のノード ID で--cache-cluster-id
使用できます。Redis レプリケーショングループの --cache-cluster-id
は、0001
のような 4 桁の値です。--cache-cluster-id
が Redis レプリケーショングループ内のクラスター (ノード) の ID である場合は、replication-group-id
が出力に含まれます。
Linux、macOS、Unix の場合:
aws elasticache describe-cache-clusters \ --cache-cluster-id
redis-cluster
\ --show-cache-node-info
Windows の場合:
aws elasticache describe-cache-clusters ^ --cache-cluster-id
redis-cluster
^ --show-cache-node-info
上記のオペレーションからの出力は以下のような JSON 形式になります。
{
"CacheClusters": [
{
"CacheClusterStatus": "available",
"SecurityGroups": [
{
"SecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"CacheNodes": [
{
"CustomerAvailabilityZone": "us-east-1b",
"CacheNodeCreateTime": "2018-04-25T18:19:28.241Z",
"CacheNodeStatus": "available",
"CacheNodeId": "0001",
"Endpoint": {
"Address": "redis-cluster.amazonaws.com",
"Port": 6379
},
"ParameterGroupStatus": "in-sync"
}
],
"AtRestEncryptionEnabled": false,
"CacheClusterId": "redis-cluster",
"TransitEncryptionEnabled": false,
"CacheParameterGroup": {
"ParameterApplyStatus": "in-sync",
"CacheNodeIdsToReboot": [],
"CacheParameterGroupName": "default.redis3.2"
},
"NumCacheNodes": 1,
"PreferredAvailabilityZone": "us-east-1b",
"AutoMinorVersionUpgrade": true,
"Engine": "redis",
"AuthTokenEnabled": false,
"PendingModifiedValues": {},
"PreferredMaintenanceWindow": "tue:08:30-tue:09:30",
"CacheSecurityGroups": [],
"CacheSubnetGroupName": "default",
"CacheNodeType": "cache.t2.small",
"DataTiering": "disabled"
"EngineVersion": "3.2.10",
"ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:",
"CacheClusterCreateTime": "2018-04-25T18:19:28.241Z"
}
]
}
詳細については、「」トピックを参照してくださいdescribe-cache-clusters。
レプリケーショングループのエンドポイントの検索 (AWS CLI)
を使用して AWS CLI 、 describe-replication-groups
コマンドを使用してレプリケーショングループとそのクラスターのエンドポイントを検出できます。このコマンドでは、読み込みエンドポイントと合わせて、レプリケーショングループのプライマリエンドポイント、レプリケーショングループ内のすべてのクラスター (ノード)、およびそのエンドポイントのリストが返ります。
次のオペレーションでは、レプリケーショングループ myreplgroup
のプライマリエンドポイントと読み込みエンドポイントが取得されます。すべての書き込みオペレーションにプライマリエンドポイントを使用します。
aws elasticache describe-replication-groups \ --replication-group-id
myreplgroup
Windows の場合:
aws elasticache describe-replication-groups ^ --replication-group-id
myreplgroup
このオペレーションからの出力は以下のような JSON 形式になります。
{
"ReplicationGroups": [
{
"Status": "available",
"Description": "test",
"NodeGroups": [
{
"Status": "available",
"NodeGroupMembers": [
{
"CurrentRole": "primary",
"PreferredAvailabilityZone": "us-west-2a",
"CacheNodeId": "0001",
"ReadEndpoint": {
"Port": 6379,
"Address": "myreplgroup-001.amazonaws.com"
},
"CacheClusterId": "myreplgroup-001"
},
{
"CurrentRole": "replica",
"PreferredAvailabilityZone": "us-west-2b",
"CacheNodeId": "0001",
"ReadEndpoint": {
"Port": 6379,
"Address": "myreplgroup-002.amazonaws.com"
},
"CacheClusterId": "myreplgroup-002"
},
{
"CurrentRole": "replica",
"PreferredAvailabilityZone": "us-west-2c",
"CacheNodeId": "0001",
"ReadEndpoint": {
"Port": 6379,
"Address": "myreplgroup-003.amazonaws.com"
},
"CacheClusterId": "myreplgroup-003"
}
],
"NodeGroupId": "0001",
"PrimaryEndpoint": {
"Port": 6379,
"Address": "myreplgroup.amazonaws.com"
},
"ReaderEndpoint": {
"Port": 6379,
"Address": "myreplgroup-ro.amazonaws.com"
}
}
],
"ReplicationGroupId": "myreplgroup",
"AutomaticFailover": "enabled",
"SnapshottingClusterId": "myreplgroup-002",
"MemberClusters": [
"myreplgroup-001",
"myreplgroup-002",
"myreplgroup-003"
],
"PendingModifiedValues": {}
}
]
}
詳細については、 コマンドリファレンスdescribe-replication-groupsの「」を参照してください。 AWS CLI
Amazon ElastiCache API を使用して、ノード、クラスター、レプリケーショングループのエンドポイントを検出できます。
ノードとクラスターのエンドポイントの検索 (ElastiCache API)
ElastiCache API を使用して、 DescribeCacheClusters
アクションでクラスターとそのノードのエンドポイントを検出できます。Redis クラスターでは、そのコマンドがクラスターエンドポイントを返します。オプションのパラメータ ShowCacheNodeInfo
を含めた場合、アクションはクラスター内の個々のノードのエンドポイントも返します。
https://elasticache.us-west-2.amazonaws.com/ ?Action=DescribeCacheClusters &CacheClusterId=mycluster &ShowCacheNodeInfo=true &SignatureVersion=4 &SignatureMethod=HmacSHA256 &Timestamp=20150202T192317Z &Version=2015-02-02 &X-Amz-Credential=<credential>
レプリケーショングループのエンドポイントの検索 (ElastiCache API)
ElastiCache API を使用して、 DescribeReplicationGroups
アクションでレプリケーショングループとそのクラスターのエンドポイントを検出できます。このアクションでは、読み込みエンドポイントに合わせて、レプリケーショングループのプライマリエンドポイント、レプリケーショングループのすべてのクラスター、およびそのエンドポイントのリストが返ります。
次のオペレーションは、レプリケーショングループ のプライマリエンドポイント (PrimaryEndpoint)、リーダーエンドポイント (ReaderEndpoint)、および個々のノードエンドポイント (ReadEndpoint) を取得しますmyreplgroup
。すべての書き込みオペレーションにプライマリエンドポイントを使用します。
https://elasticache.us-west-2.amazonaws.com/ ?Action=DescribeReplicationGroups &ReplicationGroupId=myreplgroup &SignatureVersion=4 &SignatureMethod=HmacSHA256 &Timestamp=20150202T192317Z &Version=2015-02-02 &X-Amz-Credential=<credential>
詳細については、「」を参照してくださいDescribeReplicationGroups。