を使用したDAXの例 AWS CLI - AWS SDKコードの例
アクション

Doc AWS SDK ExamplesWord リポジトリには、さらに多くの GitHub の例があります。 AWS SDK

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

を使用したDAXの例 AWS CLI

次のコード例は、DAX AWS Command Line Interface で を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。

アクションはより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。

各例には、完全なソースコードへのリンクが含まれています。ここでは、コンテキストでコードを設定および実行する方法の手順を確認できます。

トピック

アクション

次の例は、create-cluster を使用する方法を説明しています。

AWS 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"
        }
    }
}

詳細については、「Amazon DynamoDB デベロッパーガイド」の「ステップ 3: DAXクラスターを作成する」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のCreateCluster」を参照してください。

次の例は、create-parameter-group を使用する方法を説明しています。

AWS 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"
    }
}

詳細については、Amazon DynamoDB デベロッパーガイドのDAXクラスターの管理」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のCreateParameterGroup」を参照してください。

次のコード例は、create-subnet-group を使用する方法を示しています。

AWS 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 DynamoDB デベロッパーガイド」の「ステップ 2: サブネットグループを作成する」を参照してください。

  • API の詳細については、 AWS CLI コマンドリファレンスのCreateSubnetGroup」を参照してください。

次のコード例は、decrease-replication-factor を使用する方法を示しています。

AWS CLI

クラスターから 1 つ以上のノードを削除するには

次のdecrease-replication-factor例では、指定された DAX クラスター内のノードの数を 1 つに減らします。

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"
        }
    }
}

詳細については、Amazon DynamoDB デベロッパーガイドのDAXクラスターの管理」を参照してください。

  • API の詳細については、 AWS CLI コマンドリファレンスのDecreaseReplicationFactor」を参照してください。

次の例は、delete-cluster を使用する方法を説明しています。

AWS 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"
        }
    }
}

詳細については、Amazon DynamoDB デベロッパーガイドのDAXクラスターの管理」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のDeleteCluster」を参照してください。

次の例は、delete-parameter-group を使用する方法を説明しています。

AWS CLI

パラメータグループを削除するには

次のdelete-parameter-group例では、指定された DAX パラメータグループを削除します。

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

出力:

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

詳細については、Amazon DynamoDB デベロッパーガイドのDAXクラスターの管理」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のDeleteParameterGroup」を参照してください。

次の例は、delete-subnet-group を使用する方法を説明しています。

AWS CLI

サブネットグループを削除するには

次のdelete-subnet-group例では、指定された DAX サブネットグループを削除します。

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

出力:

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

詳細については、Amazon DynamoDB デベロッパーガイドのDAXクラスターの管理」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のDeleteSubnetGroup」を参照してください。

次のコード例は、describe-clusters を使用する方法を示しています。

AWS 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"
            }
        }
    ]
}

詳細については、Amazon DynamoDB デベロッパーガイドのDAXクラスターの管理」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のDescribeClusters」を参照してください。

次の例は、describe-default-parameters を使用する方法を説明しています。

AWS 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"
        }
    ]
}

詳細については、Amazon DynamoDB デベロッパーガイドのDAXクラスターの管理」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のDescribeDefaultParameters」を参照してください。

次の例は、describe-events を使用する方法を説明しています。

AWS 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
        }
    ]
}

詳細については、「Amazon DynamoDB デベロッパーガイド」のDAXクラスターの管理」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のDescribeEvents」を参照してください。

次の例は、describe-parameter-groups を使用する方法を説明しています。

AWS CLI

DAX で定義されたパラメータグループを記述するには

次のdescribe-parameter-groups例では、DAX で定義されているパラメータグループの詳細を取得します。

aws dax describe-parameter-groups

出力:

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

詳細については、Amazon DynamoDB デベロッパーガイドのDAXクラスターの管理」を参照してください。

  • API の詳細については、 AWS CLI コマンドリファレンスの DescribeParameterGroups を参照してください。

次のコード例は、describe-parameters を使用する方法を示しています。

AWS 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"
        }
    ]
}

詳細については、Amazon DynamoDB デベロッパーガイドのDAXクラスターの管理」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のDescribeParameters」を参照してください。

次の例は、describe-subnet-groups を使用する方法を説明しています。

AWS 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"
                }
            ]
        }
    ]
}

詳細については、Amazon DynamoDB デベロッパーガイドのDAXクラスターの管理」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のDescribeSubnetGroups」を参照してください。

次の例は、increase-replication-factor を使用する方法を説明しています。

AWS 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"
        }
    }
}

詳細については、Amazon DynamoDB デベロッパーガイドのDAXクラスターの管理」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のIncreaseReplicationFactor」を参照してください。

次の例は、list-tags を使用する方法を説明しています。

AWS 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"
        }
    ]
}

詳細については、Amazon DynamoDB デベロッパーガイドのDAXクラスターの管理」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のListTags」を参照してください。

次のコード例は、tag-resource を使用する方法を示しています。

AWS 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"
        }
    ]
}

詳細については、Amazon DynamoDB デベロッパーガイドのDAXクラスターの管理」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のTagResource」を参照してください。

次の例は、untag-resource を使用する方法を説明しています。

AWS CLI

DAX リソースからタグを削除するには

次のuntag-resource例では、Word DAXクラスターから指定されたキー名のタグを削除します。

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

出力:

{
    "Tags": []
}

詳細については、Amazon DynamoDB デベロッパーガイドのDAXクラスターの管理」を参照してください。

  • API の詳細については、AWS CLI 「 コマンドリファレンス」のUntagResource」を参照してください。