

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用公共端点创建 Valkey 无服务器缓存
<a name="serverless-public-endpoints-chapter"></a>

使用公共终端节点，您无需使用 VPC 即可直接通过互联网连接到 ElastiCache 无服务器缓存。Valkey 9.0 或更高版本的 ElastiCache Serverless 上提供公共端点。

## 先决条件
<a name="create-serverless-cache-public-endpoint-prerequisites"></a>
+ 具有创建 ElastiCache 资源权限的 Amazon 账户。
+ 要么是`AdministratorAccess`，要么是 IAM 权限，其中包括`elasticache:CreateServerlessCache`。如果您计划创建自定义用户组而不是使用默认用户组，则还需要`elasticache:CreateUser`和`elasticache:CreateUserGroup`。
+ 您的 IAM 身份必须有权使用公有终端节点创建缓存。可以使用`elasticache:ConnectionType`条件键限制此权限。有关更多信息，请参阅 [策略示例：使用条件 Fine-Grained 参数控制](IAM.ConditionKeys.md#IAM.ExamplePolicies)。
+ 已安装并配置 Amazon CLI 版本 2，用于 CLI 步骤。

使用 ElastiCache，您可以使用系统管理的 IAM 用户 (`default.iam-user`) 和用户组 (`default.iam-user-group`) 开始使用，而无需创建自定义用户。要使用自定义用户组，请先创建一个所有用户都使用 IAM 身份验证的用户组，然后创建缓存。

------
#### [ Amazon Web Services 管理控制台 ]

1. 打开 ElastiCache 控制台，网址为[https://console.aws.amazon.com/elasticache/](https://console.amazonaws.cn/elasticache/)。如果出现提示，请登录。

1. 选择 “**开始**” 以打开 “创建缓存” 页面。  
![带有 “入门” 按钮的主 ElastiCache 机主页。](https://docs.amazonaws.cn/AmazonElastiCache/latest/dg/images/create-pe-console-step2-get-started.png)

1. 在 “**引擎**” 下，选择 **Valkey**。  
![选择了 Valkey 的 “创建缓存” 页面的 “引擎” 部分。](https://docs.amazonaws.cn/AmazonElastiCache/latest/dg/images/create-pe-console-step3-engine-valkey.png)

1. 在 “**部署” 选项**下，选择**无服务器**。  
![选择无服务器的 “部署” 选项部分。](https://docs.amazonaws.cn/AmazonElastiCache/latest/dg/images/create-pe-console-step4-deployment-serverless.png)

1. 在 **“设置”** 下，输入缓存的**名称**。（可选）输入**描述**。  
![“设置” 部分显示了 “名称” 和 “描述” 字段。](https://docs.amazonaws.cn/AmazonElastiCache/latest/dg/images/create-pe-console-step5-settings-name.png)

1. 在 “**引擎版本**” 下，保持选中默认值或选择 **9** 或更高版本。  
![选择版本 9 的引擎版本控制。](https://docs.amazonaws.cn/AmazonElastiCache/latest/dg/images/create-pe-console-step6-engine-version.png)

1. 对于 “**连接类型**”，选择 “**公**用”。  
![已选择 “公用” 的 “连接类型” 部分。](https://docs.amazonaws.cn/AmazonElastiCache/latest/dg/images/create-pe-console-step7-connection-type-public.png)

1. 默认情况下， ElastiCache 使用适用于大多数工作负载的推荐设置。如果您需要更改网络类型、调整缓存使用限制或选择其他用户组，请选择**自定义默认设置**。默认用户组是`default.iam-user-group`。群组中的所有用户都必须使用 IAM 身份验证。  
![“自定义默认设置” 区域显示网络类型、安全设置和用户组。](https://docs.amazonaws.cn/AmazonElastiCache/latest/dg/images/create-pe-console-step8-customize-settings.png)

1. （可选）在 “**标签**” 下，选择 “**添加新标签**并添加标签”，以搜索和筛选您的缓存，或者跟踪您的 Amazon 成本。  
![带有 “添加新标签” 按钮的 “标签” 部分。](https://docs.amazonaws.cn/AmazonElastiCache/latest/dg/images/create-pe-console-step9-tags.png)

1. 选择**创建**。提交后，您将被重定向到缓存详细信息页面，其中缓存状态显示为正在**创建**。  
![缓存详细信息页面将缓存状态显示为 “正在创建”。](https://docs.amazonaws.cn/AmazonElastiCache/latest/dg/images/create-pe-console-step10-create.png)

1. 等待 “缓存” 详细信息页面上的**状态**从 “**正在创建**” 变为 “**可用**”，然后再连接到缓存。缓存准备就绪后，页面会自动刷新。  
![显示缓存状态的缓存详细信息页面已更改为 “可用”。](https://docs.amazonaws.cn/AmazonElastiCache/latest/dg/images/create-pe-console-step11-status-available.png)

------
#### [ 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());
}
```

------

缓存可用后，请参阅[使用公共端点连接到缓存](connecting-public-endpoint.md)。