AWS CloudFormation
User Guide (API Version 2010-05-15)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

AWS::DAX::Cluster

使用 AWS::DAX::Cluster 资源创建用于 Amazon DynamoDB 的 DAX 群集。

有关创建 DAX 群集的信息,请参阅 Amazon DynamoDB 开发人员指南 中的创建 DAX 群集Amazon DynamoDB 开发人员指南 中的 CreateCluster

语法

JSON

{ "Type": "AWS::DAX::Cluster", "Properties": { "AvailabilityZones": [ String, ... ], "ClusterName": String, "Description": String, "IAMRoleARN": String, "NodeType": String, "NotificationTopicARN": String, "ParameterGroupName": String, "PreferredMaintenanceWindow": String, "ReplicationFactor": Integer, "SecurityGroupIds": [ String, ... ], "SubnetGroupName": String, "Tags": { 字符串字符串, ... } } }

YAML

Type: "AWS::DAX::Cluster" Properties: AvailabilityZones: [ String, ... ] ClusterName: String Description: String IAMRoleARN: String NodeType: String NotificationTopicARN: String ParameterGroupName: String PreferredMaintenanceWindow: String ReplicationFactor: Integer SecurityGroupIds: [ String, ... ] SubnetGroupName: String Tags: { 字符串字符串, ... }

属性

AvailabilityZones

将在其中创建群集节点的可用区 (AZ)。属于群集的所有节点都放置在这些可用区中。如果要跨多个可用区分配这些节点,请使用此参数。

您必须为群集中的每个 DAX 节点指定一个可用区。

Required: No

Type: List of String values

更新要求时而中断

ClusterName

群集标识符。该参数作为一个小写字符串存储。

Required: No

Type: String

更新要求:不支持更新。

Description

群集的说明。

Required: No

Type: String

更新要求无需中断

IAMRoleARN

标识 IAM 角色的有效 Amazon 资源名称 (ARN)。在运行时,DAX 将承担此角色,并使用该角色的权限代表您访问 DynamoDB。

Required: Yes

Type: String

更新要求:不支持更新。

NodeType

群集中节点的计算和内存容量。

Required: Yes

Type: String

更新要求:不支持更新。

NotificationTopicARN

将向其发送通知的 Amazon SNS 主题的 Amazon 资源名称 (ARN)。

注意

Amazon SNS 主题所有者与 DAX 群集所有者必须是同一人。

Required: No

Type: String

更新要求无需中断

ParameterGroupName

要与 DAX 群集关联的参数组。

Required: No

Type: String

更新要求时而中断

PreferredMaintenanceWindow

指定每周执行 DAX 群集维护的时间范围。它被指定为 ddd:hh24:mi-ddd:hh24:mi 格式 (24 小时制 UTC) 的范围。最短维护时段是 60 分钟。ddd 的有效值为:

  • sun

  • mon

  • tue

  • wed

  • thu

  • fri

  • sat

示例:sun:05:00-sun:09:00

注意

如果在创建或修改缓存群集时未指定首选维护时段,则 DAX 将在该星期中随机选择的某一天中分配 60 分钟的维护时段。

Required: No

Type: String

更新要求无需中断

ReplicationFactor

DAX 群集中节点的数量。复制因子 1 将创建一个单节点群集,没有任何只读副本。要实现更大的容错能力,您可以创建具有一个或多个只读副本的多节点群集。为此,请将 ReplicationFactor 设置为 2 或更大值。

注意

AWS 建议您每个群集至少拥有两个只读副本。

Required: Yes

Type: Integer

更新要求时而中断

SecurityGroupIds

要分配给 DAX 群集中每个节点的安全组 ID 的列表。(每个安全组 ID 都是系统生成的。)

如果未指定此参数,DAX 将向每个节点分配默认 VPC 安全组。

Required: No

Type: List of String values

更新要求无需中断

SubnetGroupName

要用于复制组的子网组的名称。

重要

DAX 群集只能在 Amazon VPC 环境中运行。您在子网组中指定的所有子网必须位于同一 VPC 中。

Required: Yes

Type: String

更新要求:不支持更新。

Tags

要与 DAX 群集关联的标签的映射。

Required: No

类型:字符串到字符串映射

更新要求无需中断

返回值

Ref

当向 Ref 内部函数提供此资源的逻辑 ID 时,Ref 将返回所创建 DAX 群集的 ARN。例如:

{ "Ref": "MyDAXCluster" }

返回与以下值类似的值:

MyDAXCluster

有关使用 Ref 功能的更多信息,请参阅参考

Fn::GetAtt

Fn::GetAtt 返回一个此类型指定属性的值。以下为可用属性和示例返回值。

Name

返回 DAX 群集的名称。例如:

{ "Fn::GetAtt": ["MyDAXCluster", "Arn"] }

返回与以下值类似的值:

arn:aws:dax:us-east-1:111122223333:cache/MyDAXCluster
ClusterDiscoveryEndpoint

返回 DAX 群集的配置终端节点。例如:

{ "Fn::GetAtt": ["MyDAXCluster", "ClusterDiscoveryEndpoint"] }

返回与以下值类似的值:

mydaxcluster.0h3d6x.clustercfg.dax.use1.cache.amazonaws.com:8111

有关使用 Fn::GetAtt 的更多信息,请参见 Fn::GetAtt

示例

以下示例创建一个 DAX 群集。

JSON

{ "AWSTemplateFormatVersion": "2010-09-09", "DDescription": "Create a DAX cluster", "Resources": { "daxCluster": { "Type": "AWS::DAX::Cluster", "Properties": { "ClusterName": "MyDAXCluster", "NodeType": "dax.r3.large", "ReplicationFactor": 1, "IAMRoleARN": "arn:aws:iam::111122223333:role/DaxAccess", "Description": "DAX cluster created with CloudFormation", "SubnetGroupName": "MySubnetGroup" } }, "subnetGroupClu": { "Type": "AWS::DAX::SubnetGroup", "Properties": { "SubnetGroupName": "MySubnetGroup", "Description": "Subnet group for DAX cluster", "SubnetIds": [ "subnet1", "subnet2" ] } }, "subnet1": { "Type": "AWS::EC2::Subnet", "Properties": { "VpcId": "daxVpc", "CidrBlock": "172.13.17.0/24", "AvailabilityZone": { "Fn::Select": [ 0, { "Fn::GetAZs": "" } ] } } }, "subnet2": { "Type": "AWS::EC2::Subnet", "Properties": { "VpcId": "daxVpc", "CidrBlock": "172.13.18.0/24", "AvailabilityZone": { "Fn::Select": [ 1, { "Fn::GetAZs": "" } ] } } }, "daxVpc": { "Type": "AWS::EC2::VPC", "Properties": { "CidrBlock": "172.13.0.0/16" } } }, "Outputs": { "Cluster": { "Value": "daxCluster" } } }

YAML

AWSTemplateFormatVersion: "2010-09-09" Description: "Create a DAX cluster" Resources: daxCluster: Type: AWS::DAX::Cluster Properties: ClusterName: "MyDAXCluster" NodeType: "dax.r3.large" ReplicationFactor: 1 IAMRoleARN: "arn:aws:iam::111122223333:role/DaxAccess" Description: "DAX cluster created with CloudFormation" SubnetGroupName: !Ref subnetGroupClu subnetGroupClu: Type: AWS::DAX::SubnetGroup Properties: SubnetGroupName: "CFNClusterSubnetGrp" Description: "Subnet group for DAX cluster" SubnetIds: - !Ref subnet1 - !Ref subnet2 subnet1: Type: AWS::EC2::Subnet Properties: VpcId: !Ref daxVpc CidrBlock: 172.13.17.0/24 AvailabilityZone: Fn::Select: - 0 - Fn::GetAZs: "" subnet2: Type: AWS::EC2::Subnet Properties: VpcId: !Ref daxVpc CidrBlock: 172.13.18.0/24 AvailabilityZone: Fn::Select: - 1 - Fn::GetAZs: "" daxVpc: Type: AWS::EC2::VPC Properties: CidrBlock: 172.13.0.0/16 Outputs: Cluster: Value: !Ref daxCluster

本页内容: