Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅
中国的 Amazon Web Services 服务入门
(PDF)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
使用公共端点创建 Valkey 无服务器缓存
使用公共终端节点,您无需使用 VPC 即可直接通过互联网连接到 ElastiCache 无服务器缓存。Valkey 9.0 或更高版本的 ElastiCache Serverless 上提供公共端点。
先决条件
-
具有创建 ElastiCache 资源权限的 Amazon 账户。
-
要么是AdministratorAccess,要么是 IAM 权限,其中包括elasticache:CreateServerlessCache。如果您计划创建自定义用户组而不是使用默认用户组,则还需要elasticache:CreateUser和elasticache:CreateUserGroup。
-
您的 IAM 身份必须有权使用公有终端节点创建缓存。可以使用elasticache:ConnectionType条件键限制此权限。有关更多信息,请参阅 策略示例:使用条件 Fine-Grained 参数控制。
-
已安装并配置 Amazon CLI 版本 2,用于 CLI 步骤。
使用 ElastiCache,您可以使用系统管理的 IAM 用户 (default.iam-user) 和用户组 (default.iam-user-group) 开始使用,而无需创建自定义用户。要使用自定义用户组,请先创建一个所有用户都使用 IAM 身份验证的用户组,然后创建缓存。
- Amazon Web Services 管理控制台
-
打开 ElastiCache 控制台,网址为https://console.aws.amazon.com/elasticache/。如果出现提示,请登录。
选择 “开始” 以打开 “创建缓存” 页面。
在 “引擎” 下,选择 Valkey。
在 “部署” 选项下,选择无服务器。
在 “设置” 下,输入缓存的名称。(可选)输入描述。
在 “引擎版本” 下,保持选中默认值或选择 9 或更高版本。
对于 “连接类型”,选择 “公用”。
默认情况下, ElastiCache 使用适用于大多数工作负载的推荐设置。如果您需要更改网络类型、调整缓存使用限制或选择其他用户组,请选择自定义默认设置。默认用户组是default.iam-user-group。群组中的所有用户都必须使用 IAM 身份验证。
(可选)在 “标签” 下,选择 “添加新标签并添加标签”,以搜索和筛选您的缓存,或者跟踪您的 Amazon 成本。
选择创建。提交后,您将被重定向到缓存详细信息页面,其中缓存状态显示为正在创建。
等待 “缓存” 详细信息页面上的状态从 “正在创建” 变为 “可用”,然后再连接到缓存。缓存准备就绪后,页面会自动刷新。
- Amazon CLI
-
运行以下命令,使用系统管理的默认 IAM 用户组创建带有公有终端节点的缓存:
aws elasticache create-serverless-cache \
--serverless-cache-name my-public-cache \
--engine valkey \
--major-engine-version 9 \
--connection-type public \
--user-group-id default.iam-user-group
该命令返回包含缓存端点的响应:
{
"ServerlessCache": {
"ServerlessCacheName": "my-public-cache",
"Status": "creating",
"Engine": "valkey",
"MajorEngineVersion": "9",
"ConnectionType": "public",
"Endpoint": {
"Address": "my-public-cache-x2e9hv.public.serverless.use1.cache.amazonaws.com",
"Port": 6379
},
"UserGroupId": "default.iam-user-group"
}
}
记下 Endpoint.Address 的值。您可以使用此值连接到缓存。
要使用自定义用户组而不是默认用户组,请default.iam-user-group替换为您的用户组 ID。用户组中的所有用户都必须使用 IAM 身份验证。
- Amazon SDK
-
以下示例使用公共端点创建缓存。
Python (boto3)
import boto3
client = boto3.client("elasticache", region_name="us-east-1")
response = client.create_serverless_cache(
ServerlessCacheName="my-public-cache",
Engine="valkey",
MajorEngineVersion="9",
ConnectionType="public",
UserGroupId="default.iam-user-group",
)
print(response["ServerlessCache"]["Endpoint"]["Address"])
JavaScript (Amazon SDK v3)
import {
ElastiCacheClient,
CreateServerlessCacheCommand
} from "@aws-sdk/client-elasticache";
const client = new ElastiCacheClient({ region: "us-east-1" });
const response = await client.send(new CreateServerlessCacheCommand({
ServerlessCacheName: "my-public-cache",
Engine: "valkey",
MajorEngineVersion: "9",
ConnectionType: "public",
UserGroupId: "default.iam-user-group",
}));
console.log(response.ServerlessCache?.Endpoint?.Address);
Java (Amazon SDK v2)
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.elasticache.ElastiCacheClient;
import software.amazon.awssdk.services.elasticache.model.CreateServerlessCacheRequest;
import software.amazon.awssdk.services.elasticache.model.CreateServerlessCacheResponse;
try (ElastiCacheClient client = ElastiCacheClient.builder()
.region(Region.US_EAST_1)
.build()) {
CreateServerlessCacheResponse response = client.createServerlessCache(
CreateServerlessCacheRequest.builder()
.serverlessCacheName("my-public-cache")
.engine("valkey")
.majorEngineVersion("9")
.connectionType("public")
.userGroupId("default.iam-user-group")
.build());
System.out.println(response.serverlessCache().endpoint().address());
}
缓存可用后,请参阅使用公共端点连接到缓存。