使用的 DAX 示例 Amazon CLI - Amazon Command Line Interface
操作
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

使用的 DAX 示例 Amazon CLI

以下代码示例向您展示了如何使用 Amazon Command Line Interface 与 DAX 配合使用来执行操作和实现常见场景。

操作是大型程序的代码摘录，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景和跨服务示例的上下文查看操作。

场景是展示如何通过在同一服务中调用多个函数来完成特定任务任务的代码示例。

每个示例都包含一个指向的链接 GitHub，您可以在其中找到有关如何在上下文中设置和运行代码的说明。

主题

操作

以下代码示例演示如何使用 create-cluster。

Amazon CLI

创建 DAX 集群

以下create-cluster示例使用指定设置创建一个 DAX 集群。

aws dax create-cluster \
    --cluster-name daxcluster \
    --node-type dax.r4.large \
    --replication-factor 3 \
    --iam-role-arn roleARN  \
    --sse-specification Enabled=true

输出：

{
    "Cluster": {
        "ClusterName": "daxcluster",
        "ClusterArn": "arn:aws:dax:us-west-2:123456789012:cache/daxcluster",
        "TotalNodes": 3,
        "ActiveNodes": 0,
        "NodeType": "dax.r4.large",
        "Status": "creating",
        "ClusterDiscoveryEndpoint": {
            "Port": 8111
        },
        "PreferredMaintenanceWindow": "thu:13:00-thu:14:00",
        "SubnetGroup": "default",
        "SecurityGroups": [
            {
                "SecurityGroupIdentifier": "sg-1af6e36e",
                "Status": "active"
            }
        ],
        "IamRoleArn": "arn:aws:iam::123456789012:role/DAXServiceRoleForDynamoDBAccess",
        "ParameterGroup": {
            "ParameterGroupName": "default.dax1.0",
            "ParameterApplyStatus": "in-sync",
            "NodeIdsToReboot": []
        },
        "SSEDescription": {
            "Status": "ENABLED"
        }
    }
}

有关更多信息，请参阅 A mazon DynamoDB 开发者指南中的步骤 3：创建 DA X 集群。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考CreateCluster中的。

以下代码示例演示如何使用 create-parameter-group。

Amazon CLI

创建参数组

以下 ` create-parameter-group` ``示例使用指定设置创建参数组。

aws dax create-parameter-group \
    --parameter-group-name daxparametergroup \
    --description "A new parameter group"

输出：

{
    "ParameterGroup": {
        "ParameterGroupName": "daxparametergroup",
        "Description": "A new parameter group"
    }
}

有关更多信息，请参阅亚马逊 DynamoDB 开发者指南中的管理 DA X 集群。

以下代码示例演示如何使用 create-subnet-group。

Amazon CLI

创建 DAX 子网组

以下create-subnet-group示例使用指定设置创建子网组。

aws dax create-subnet-group \
    --subnet-group-name daxSubnetGroup \
    --subnet-ids subnet-11111111 subnet-22222222

输出：

{
    "SubnetGroup": {
        "SubnetGroupName": "daxSubnetGroup",
        "VpcId": "vpc-05a1fa8e00c325226",
        "Subnets": [
            {
                "SubnetIdentifier": "subnet-11111111",
                "SubnetAvailabilityZone": "us-west-2b"
            },
            {
                "SubnetIdentifier": "subnet-22222222",
                "SubnetAvailabilityZone": "us-west-2c"
            }
        ]
    }
}

有关更多信息，请参阅 Amazon DynamoD B 开发者指南中的步骤 2：创建子网组。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考CreateSubnetGroup中的。

以下代码示例演示如何使用 decrease-replication-factor。

Amazon CLI

从集群中移除一个或多个节点

以下decrease-replication-factor示例将指定 DAX 集群中的节点数减少到一个。

aws dax decrease-replication-factor \
    --cluster-name daxcluster \
    --new-replication-factor 1

输出：

{
    "Cluster": {
        "ClusterName": "daxcluster",
        "ClusterArn": "arn:aws:dax:us-west-2:123456789012:cache/daxcluster",
        "TotalNodes": 3,
        "ActiveNodes": 3,
        "NodeType": "dax.r4.large",
        "Status": "modifying",
        "ClusterDiscoveryEndpoint": {
            "Address": "daxcluster.ey3o9d.clustercfg.dax.usw2.cache.amazonaws.com",
            "Port": 8111
        },
        "Nodes": [
            {
                "NodeId": "daxcluster-a",
                "Endpoint": {
                    "Address": "daxcluster-a.ey3o9d.0001.dax.usw2.cache.amazonaws.com",
                    "Port": 8111
                },
                "NodeCreateTime": 1576625059.509,
                "AvailabilityZone": "us-west-2c",
                "NodeStatus": "available",
                "ParameterGroupStatus": "in-sync"
            },
            {
                "NodeId": "daxcluster-b",
                "Endpoint": {
                    "Address": "daxcluster-b.ey3o9d.0001.dax.usw2.cache.amazonaws.com",
                    "Port": 8111
                },
                "NodeCreateTime": 1576625059.509,
                "AvailabilityZone": "us-west-2a",
                "NodeStatus": "available",
                "ParameterGroupStatus": "in-sync"
            },
            {
                "NodeId": "daxcluster-c",
                "Endpoint": {
                    "Address": "daxcluster-c.ey3o9d.0001.dax.usw2.cache.amazonaws.com",
                    "Port": 8111
                },
                "NodeCreateTime": 1576625059.509,
                "AvailabilityZone": "us-west-2b",
                "NodeStatus": "available",
                "ParameterGroupStatus": "in-sync"
            }
        ],
        "PreferredMaintenanceWindow": "thu:13:00-thu:14:00",
        "SubnetGroup": "default",
        "SecurityGroups": [
            {
                "SecurityGroupIdentifier": "sg-1af6e36e",
                "Status": "active"
            }
        ],
        "IamRoleArn": "arn:aws:iam::123456789012:role/DAXServiceRoleForDynamoDBAccess",
        "ParameterGroup": {
            "ParameterGroupName": "default.dax1.0",
            "ParameterApplyStatus": "in-sync",
            "NodeIdsToReboot": []
        },
        "SSEDescription": {
            "Status": "ENABLED"
        }
    }
}

有关更多信息，请参阅亚马逊 DynamoDB 开发者指南中的管理 DA X 集群。

以下代码示例演示如何使用 delete-cluster。

Amazon CLI

删除 DAX 集群

以下delete-cluster示例删除指定的 DAX 集群。

aws dax delete-cluster \
    --cluster-name daxcluster

输出：

{
    "Cluster": {
        "ClusterName": "daxcluster",
        "ClusterArn": "arn:aws:dax:us-west-2:123456789012:cache/daxcluster",
        "TotalNodes": 3,
        "ActiveNodes": 0,
        "NodeType": "dax.r4.large",
        "Status": "deleting",
        "ClusterDiscoveryEndpoint": {
            "Address": "dd.ey3o9d.clustercfg.dax.usw2.cache.amazonaws.com",
            "Port": 8111
        },
        "PreferredMaintenanceWindow": "fri:06:00-fri:07:00",
        "SubnetGroup": "default",
        "SecurityGroups": [
            {
                "SecurityGroupIdentifier": "sg-1af6e36e",
                "Status": "active"
            }
        ],
        "IamRoleArn": "arn:aws:iam::123456789012:role/DAXServiceRoleForDynamoDBAccess",
        "ParameterGroup": {
            "ParameterGroupName": "default.dax1.0",
            "ParameterApplyStatus": "in-sync",
            "NodeIdsToReboot": []
        },
        "SSEDescription": {
            "Status": "ENABLED"
        }
    }
}

有关更多信息，请参阅亚马逊 DynamoDB 开发者指南中的管理 DA X 集群。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考DeleteCluster中的。

以下代码示例演示如何使用 delete-parameter-group。

Amazon CLI

删除参数组

以下delete-parameter-group示例删除指定的 DAX 参数组。

aws dax  delete-parameter-group \
    --parameter-group-name daxparametergroup

输出：

{
    "DeletionMessage": "Parameter group daxparametergroup has been deleted."
}

有关更多信息，请参阅亚马逊 DynamoDB 开发者指南中的管理 DA X 集群。

以下代码示例演示如何使用 delete-subnet-group。

Amazon CLI

删除子网组

以下delete-subnet-group示例删除指定的 DAX 子网组。

aws dax delete-subnet-group \
    --subnet-group-name daxSubnetGroup

输出：

{
    "DeletionMessage": "Subnet group daxSubnetGroup has been deleted."
}

有关更多信息，请参阅亚马逊 DynamoDB 开发者指南中的管理 DA X 集群。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考DeleteSubnetGroup中的。

以下代码示例演示如何使用 describe-clusters。

Amazon CLI

返回有关所有已预配置的 DAX 集群的信息

以下describe-clusters示例显示有关所有已配置的 DAX 集群的详细信息。

aws dax describe-clusters

输出：

{
    "Clusters": [
        {
            "ClusterName": "daxcluster",
            "ClusterArn": "arn:aws:dax:us-west-2:123456789012:cache/daxcluster",
            "TotalNodes": 1,
            "ActiveNodes": 1,
            "NodeType": "dax.r4.large",
            "Status": "available",
            "ClusterDiscoveryEndpoint": {
                "Address": "daxcluster.ey3o9d.clustercfg.dax.usw2.cache.amazonaws.com",
                "Port": 8111
            },
            "Nodes": [
                {
                    "NodeId": "daxcluster-a",
                    "Endpoint": {
                        "Address": "daxcluster-a.ey3o9d.0001.dax.usw2.cache.amazonaws.com",
                        "Port": 8111
                    },
                    "NodeCreateTime": 1576625059.509,
                    "AvailabilityZone": "us-west-2c",
                    "NodeStatus": "available",
                    "ParameterGroupStatus": "in-sync"
                }
            ],
            "PreferredMaintenanceWindow": "thu:13:00-thu:14:00",
            "SubnetGroup": "default",
            "SecurityGroups": [
                {
                    "SecurityGroupIdentifier": "sg-1af6e36e",
                    "Status": "active"
                }
            ],
            "IamRoleArn": "arn:aws:iam::123456789012:role/DAXServiceRoleForDynamoDBAccess",
            "ParameterGroup": {
                "ParameterGroupName": "default.dax1.0",
                "ParameterApplyStatus": "in-sync",
                "NodeIdsToReboot": []
            },
            "SSEDescription": {
                "Status": "ENABLED"
            }
        }
    ]
}

有关更多信息，请参阅亚马逊 DynamoDB 开发者指南中的管理 DA X 集群。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考DescribeClusters中的。

以下代码示例演示如何使用 describe-default-parameters。

Amazon CLI

返回 DAX 的默认系统参数信息

以下describe-default-parameters示例显示了 DAX 的默认系统参数信息。

aws dax describe-default-parameters

输出：

{
    "Parameters": [
        {
            "ParameterName": "query-ttl-millis",
            "ParameterType": "DEFAULT",
            "ParameterValue": "300000",
            "NodeTypeSpecificValues": [],
            "Description": "Duration in milliseconds for queries to remain cached",
            "Source": "user",
            "DataType": "integer",
            "AllowedValues": "0-",
            "IsModifiable": "TRUE",
            "ChangeType": "IMMEDIATE"
        },
        {
            "ParameterName": "record-ttl-millis",
            "ParameterType": "DEFAULT",
            "ParameterValue": "300000",
            "NodeTypeSpecificValues": [],
            "Description": "Duration in milliseconds for records to remain valid in cache (Default: 0 = infinite)",
            "Source": "user",
            "DataType": "integer",
            "AllowedValues": "0-",
            "IsModifiable": "TRUE",
            "ChangeType": "IMMEDIATE"
        }
    ]
}

有关更多信息，请参阅亚马逊 DynamoDB 开发者指南中的管理 DA X 集群。

以下代码示例演示如何使用 describe-events。

Amazon CLI

返回与 DAX 集群和参数组相关的所有事件

以下describe-events示例显示了与 DAX 集群和参数组相关的事件的详细信息。

aws dax describe-events

输出：

{
    "Events": [
        {
            "SourceName": "daxcluster",
            "SourceType": "CLUSTER",
            "Message": "Cluster deleted.",
            "Date": 1576702736.706
        },
        {
            "SourceName": "daxcluster",
            "SourceType": "CLUSTER",
            "Message": "Removed node daxcluster-b.",
            "Date": 1576702691.738
        },
        {
            "SourceName": "daxcluster",
            "SourceType": "CLUSTER",
            "Message": "Removed node daxcluster-a.",
            "Date": 1576702633.498
        },
        {
            "SourceName": "daxcluster",
            "SourceType": "CLUSTER",
            "Message": "Removed node daxcluster-c.",
            "Date": 1576702631.329
        },
        {
            "SourceName": "daxcluster",
            "SourceType": "CLUSTER",
            "Message": "Cluster created.",
            "Date": 1576626560.057
        }
    ]
}

有关更多信息，请参阅亚马逊 DynamoDB 开发者指南中的管理 DA X 集群。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考DescribeEvents中的。

以下代码示例演示如何使用 describe-parameter-groups。

Amazon CLI

描述 DAX 中定义的参数组

以下describe-parameter-groups示例检索有关在 DAX 中定义的参数组的详细信息。

aws dax describe-parameter-groups

输出：

{
    "ParameterGroups": [
        {
            "ParameterGroupName": "default.dax1.0",
            "Description": "Default parameter group for dax1.0"
        }
    ]
}

有关更多信息，请参阅亚马逊 DynamoDB 开发者指南中的管理 DA X 集群。

以下代码示例演示如何使用 describe-parameters。

Amazon CLI

描述在 DAX 参数组中定义的参数

以下describe-parameters示例检索有关在指定 DAX 参数组中定义的参数的详细信息。

aws dax describe-parameters \
    --parameter-group-name default.dax1.0

输出：

{
    "Parameters": [
        {
            "ParameterName": "query-ttl-millis",
            "ParameterType": "DEFAULT",
            "ParameterValue": "300000",
            "NodeTypeSpecificValues": [],
            "Description": "Duration in milliseconds for queries to remain cached",
            "Source": "user",
            "DataType": "integer",
            "AllowedValues": "0-",
            "IsModifiable": "TRUE",
            "ChangeType": "IMMEDIATE"
        },
        {
            "ParameterName": "record-ttl-millis",
            "ParameterType": "DEFAULT",
            "ParameterValue": "300000",
            "NodeTypeSpecificValues": [],
            "Description": "Duration in milliseconds for records to remain valid in cache (Default: 0 = infinite)",
            "Source": "user",
            "DataType": "integer",
            "AllowedValues": "0-",
            "IsModifiable": "TRUE",
            "ChangeType": "IMMEDIATE"
        }
    ]
}

有关更多信息，请参阅亚马逊 DynamoDB 开发者指南中的管理 DA X 集群。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考DescribeParameters中的。

以下代码示例演示如何使用 describe-subnet-groups。

Amazon CLI

描述 DAX 中定义的子网组

以下describe-subnet-groups示例检索 DAX 中定义的子网组的详细信息。

aws dax describe-subnet-groups

输出：

{
    "SubnetGroups": [
        {
            "SubnetGroupName": "default",
            "Description": "Default CacheSubnetGroup",
            "VpcId": "vpc-ee70a196",
            "Subnets": [
                {
                    "SubnetIdentifier": "subnet-874953af",
                    "SubnetAvailabilityZone": "us-west-2d"
                },
                {
                    "SubnetIdentifier": "subnet-bd3d1fc4",
                    "SubnetAvailabilityZone": "us-west-2a"
                },
                {
                    "SubnetIdentifier": "subnet-72c2ff28",
                    "SubnetAvailabilityZone": "us-west-2c"
                },
                {
                    "SubnetIdentifier": "subnet-09e6aa42",
                    "SubnetAvailabilityZone": "us-west-2b"
                }
            ]
        }
    ]
}

有关更多信息，请参阅亚马逊 DynamoDB 开发者指南中的管理 DA X 集群。

以下代码示例演示如何使用 increase-replication-factor。

Amazon CLI

提高 DAX 集群的重复因子

以下increase-replication-factor示例将指定 DAX 集群的重复因子增加到 3。

aws dax increase-replication-factor \
    --cluster-name daxcluster \
    --new-replication-factor 3

输出：

{
    "Cluster": {
        "ClusterName": "daxcluster",
        "ClusterArn": "arn:aws:dax:us-west-2:123456789012:cache/daxcluster",
        "TotalNodes": 3,
        "ActiveNodes": 1,
        "NodeType": "dax.r4.large",
        "Status": "modifying",
        "ClusterDiscoveryEndpoint": {
            "Address": "daxcluster.ey3o9d.clustercfg.dax.usw2.cache.amazonaws.com",
            "Port": 8111
        },
        "Nodes": [
            {
                "NodeId": "daxcluster-a",
                "Endpoint": {
                    "Address": "daxcluster-a.ey3o9d.0001.dax.usw2.cache.amazonaws.com",
                    "Port": 8111
                },
                "NodeCreateTime": 1576625059.509,
                "AvailabilityZone": "us-west-2c",
                "NodeStatus": "available",
                "ParameterGroupStatus": "in-sync"
            },
            {
                "NodeId": "daxcluster-b",
                "NodeStatus": "creating"
            },
            {
                "NodeId": "daxcluster-c",
                "NodeStatus": "creating"
            }
        ],
        "PreferredMaintenanceWindow": "thu:13:00-thu:14:00",
        "SubnetGroup": "default",
        "SecurityGroups": [
            {
                "SecurityGroupIdentifier": "sg-1af6e36e",
                "Status": "active"
            }
        ],
        "IamRoleArn": "arn:aws:iam::123456789012:role/DAXServiceRoleForDynamoDBAccess",
        "ParameterGroup": {
            "ParameterGroupName": "default.dax1.0",
            "ParameterApplyStatus": "in-sync",
            "NodeIdsToReboot": []
        },
        "SSEDescription": {
            "Status": "ENABLED"
        }
    }
}

有关更多信息，请参阅亚马逊 DynamoDB 开发者指南中的管理 DA X 集群。

以下代码示例演示如何使用 list-tags。

Amazon CLI

在 DAX 资源上列出标签

以下list-tags示例列出了附加到指定 DAX 集群的标签密钥和值。

aws dax list-tags \
    --resource-name arn:aws:dax:us-west-2:123456789012:cache/daxcluster

输出：

{
    "Tags": [
        {
            "Key": "ClusterUsage",
            "Value": "prod"
        }
    ]
}

有关更多信息，请参阅亚马逊 DynamoDB 开发者指南中的管理 DA X 集群。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考ListTags中的。

以下代码示例演示如何使用 tag-resource。

Amazon CLI

为 DAX 资源添加标签

以下tag-resource示例将指定的标签键名称和关联值附加到指定的 DAX 集群，以描述集群使用情况。

aws dax tag-resource \
    --resource-name arn:aws:dax:us-west-2:123456789012:cache/daxcluster \
    --tags="Key=ClusterUsage,Value=prod"

输出：

{
    "Tags": [
        {
            "Key": "ClusterUsage",
            "Value": "prod"
        }
    ]
}

有关更多信息，请参阅亚马逊 DynamoDB 开发者指南中的管理 DA X 集群。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考TagResource中的。

以下代码示例演示如何使用 untag-resource。

Amazon CLI

从 DAX 资源中移除标签

以下untag-resource示例从 DAX 集群中移除具有指定密钥名称的标签。

aws dax untag-resource  \
    --resource-name arn:aws:dax:us-west-2:123456789012:cache/daxcluster \
    --tag-keys="ClusterUsage"

输出：

{
    "Tags": []
}

有关更多信息，请参阅亚马逊 DynamoDB 开发者指南中的管理 DA X 集群。

  • 有关 API 的详细信息，请参阅Amazon CLI 命令参考UntagResource中的。