Contoh DAX menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan menerapkan skenario umum dengan menggunakan AWS Command Line Interface dengan DAX.

Tindakan merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

Tindakan

create-cluster

Contoh kode berikut menunjukkan cara menggunakancreate-cluster.

AWS CLI

Untuk membuat cluster DAX

create-clusterContoh berikut membuat cluster DAX dengan pengaturan yang ditentukan.

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

Output:

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

Untuk informasi selengkapnya, lihat Langkah 3: Membuat Cluster DAX di Panduan Pengembang Amazon DynamoDB.

• Untuk detail API, lihat CreateCluster di Refer AWS CLI ensi Perintah.

buat-parameter-grup

Contoh kode berikut menunjukkan cara menggunakancreate-parameter-group.

AWS CLI

Untuk membuat grup parameter

Contoh ``create-parameter-group`` berikut membuat grup parameter dengan pengaturan yang ditentukan.

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

Output:

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

Untuk informasi selengkapnya, lihat M engelola klaster DAX di Panduan Peng embang Amazon DynamoDB.

• Untuk detail API, lihat CreateParameterGroup di Refer AWS CLI ensi Perintah.

buat-subnet-grup

Contoh kode berikut menunjukkan cara menggunakancreate-subnet-group.

AWS CLI

Untuk membuat grup subnet DAX

create-subnet-groupContoh berikut membuat grup subnet dengan pengaturan yang ditentukan.

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

Output:

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

Untuk informasi selengkapnya, lihat Langkah 2: Membuat Grup Subnet di Panduan Pengembang Amazon DynamoDB.

• Untuk detail API, lihat CreateSubnetGroup di Refer AWS CLI ensi Perintah.

faktor penurunan-replikasi

Contoh kode berikut menunjukkan cara menggunakandecrease-replication-factor.

AWS CLI

Untuk menghapus satu atau lebih node dari cluster

decrease-replication-factorContoh berikut mengurangi jumlah node dalam cluster DAX yang ditentukan menjadi satu.

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

Output:

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

Untuk informasi selengkapnya, lihat M engelola klaster DAX di Panduan Peng embang Amazon DynamoDB.

• Untuk detail API, lihat DecreaseReplicationFactor di Refer AWS CLI ensi Perintah.

hapus-kluster

Contoh kode berikut menunjukkan cara menggunakandelete-cluster.

AWS CLI

Untuk menghapus cluster DAX

delete-clusterContoh berikut menghapus cluster DAX yang ditentukan.

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

Output:

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

Untuk informasi selengkapnya, lihat M engelola klaster DAX di Panduan Peng embang Amazon DynamoDB.

• Untuk detail API, lihat DeleteCluster di Refer AWS CLI ensi Perintah.

hapus-parameter-grup

Contoh kode berikut menunjukkan cara menggunakandelete-parameter-group.

AWS CLI

Untuk menghapus grup parameter

delete-parameter-groupContoh berikut menghapus grup parameter DAX yang ditentukan.

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

Output:

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

Untuk informasi selengkapnya, lihat M engelola klaster DAX di Panduan Peng embang Amazon DynamoDB.

• Untuk detail API, lihat DeleteParameterGroup di Refer AWS CLI ensi Perintah.

hapus subnet-grup

Contoh kode berikut menunjukkan cara menggunakandelete-subnet-group.

AWS CLI

Untuk menghapus grup subnet

delete-subnet-groupContoh berikut menghapus grup subnet DAX yang ditentukan.

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

Output:

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

Untuk informasi selengkapnya, lihat M engelola klaster DAX di Panduan Peng embang Amazon DynamoDB.

• Untuk detail API, lihat DeleteSubnetGroup di Refer AWS CLI ensi Perintah.

deskripsi-cluster

Contoh kode berikut menunjukkan cara menggunakandescribe-clusters.

AWS CLI

Untuk mengembalikan informasi tentang semua cluster DAX yang disediakan

describe-clustersContoh berikut menampilkan detail tentang semua cluster DAX yang disediakan.

aws dax describe-clusters

Output:

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

Untuk informasi selengkapnya, lihat M engelola klaster DAX di Panduan Peng embang Amazon DynamoDB.

• Untuk detail API, lihat DescribeClusters di Refer AWS CLI ensi Perintah.

deskripsi-default-parameter

Contoh kode berikut menunjukkan cara menggunakandescribe-default-parameters.

AWS CLI

Untuk mengembalikan informasi parameter sistem default untuk DAX

describe-default-parametersContoh berikut menampilkan informasi parameter sistem default untuk DAX.

aws dax describe-default-parameters

Output:

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

Untuk informasi selengkapnya, lihat M engelola klaster DAX di Panduan Peng embang Amazon DynamoDB.

• Untuk detail API, lihat DescribeDefaultParameters di Refer AWS CLI ensi Perintah.

describe-events

Contoh kode berikut menunjukkan cara menggunakandescribe-events.

AWS CLI

Untuk mengembalikan semua peristiwa yang terkait dengan cluster DAX dan grup parameter

describe-eventsContoh berikut menampilkan rincian peristiwa yang terkait dengan klaster DAX dan grup parameter.

aws dax describe-events

Output:

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

Untuk informasi selengkapnya, lihat M engelola klaster DAX di Panduan Peng embang Amazon DynamoDB.

• Untuk detail API, lihat DescribeEvents di Refer AWS CLI ensi Perintah.

deskripsi-parameter-group

Contoh kode berikut menunjukkan cara menggunakandescribe-parameter-groups.

AWS CLI

Untuk menggambarkan kelompok parameter yang didefinisikan dalam DAX

describe-parameter-groupsContoh berikut mengambil detail tentang grup parameter yang didefinisikan dalam DAX.

aws dax describe-parameter-groups

Output:

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

Untuk informasi selengkapnya, lihat M engelola klaster DAX di Panduan Peng embang Amazon DynamoDB.

• Untuk detail API, lihat DescribeParameterGroups di Refer AWS CLI ensi Perintah.

deskripsi-parameter

Contoh kode berikut menunjukkan cara menggunakandescribe-parameters.

AWS CLI

Untuk menjelaskan parameter yang didefinisikan dalam grup parameter DAX

describe-parametersContoh berikut mengambil rincian tentang parameter yang didefinisikan dalam grup parameter DAX yang ditentukan.

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

Output:

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

Untuk informasi selengkapnya, lihat M engelola klaster DAX di Panduan Peng embang Amazon DynamoDB.

• Untuk detail API, lihat DescribeParameters di Refer AWS CLI ensi Perintah.

deskripsi-subnet-group

Contoh kode berikut menunjukkan cara menggunakandescribe-subnet-groups.

AWS CLI

Untuk mendeskripsikan grup subnet yang didefinisikan dalam DAX

describe-subnet-groupsContoh berikut mengambil detail untuk grup subnet yang ditentukan dalam DAX.

aws dax describe-subnet-groups

Output:

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

Untuk informasi selengkapnya, lihat M engelola klaster DAX di Panduan Peng embang Amazon DynamoDB.

• Untuk detail API, lihat DescribeSubnetGroups di Refer AWS CLI ensi Perintah.

meningkat-replikasi-faktor

Contoh kode berikut menunjukkan cara menggunakanincrease-replication-factor.

AWS CLI

Untuk meningkatkan faktor replikasi untuk cluster DAX

increase-replication-factorContoh berikut meningkatkan faktor replikasi cluster DAX yang ditentukan menjadi 3.

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

Output:

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

Untuk informasi selengkapnya, lihat M engelola klaster DAX di Panduan Peng embang Amazon DynamoDB.

• Untuk detail API, lihat IncreaseReplicationFactor di Refer AWS CLI ensi Perintah.

tag-daftar

Contoh kode berikut menunjukkan cara menggunakanlist-tags.

AWS CLI

Untuk mencantumkan tag pada sumber daya DAX

list-tagsContoh berikut mencantumkan kunci tag dan nilai yang dilampirkan ke cluster DAX yang ditentukan.

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

Output:

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

Untuk informasi selengkapnya, lihat M engelola klaster DAX di Panduan Peng embang Amazon DynamoDB.

• Untuk detail API, lihat ListTags di Refer AWS CLI ensi Perintah.

tag-resource

Contoh kode berikut menunjukkan cara menggunakantag-resource.

AWS CLI

Untuk menandai sumber daya DAX

tag-resourceContoh berikut melampirkan nama kunci tag yang ditentukan dan nilai terkait ke cluster DAX yang ditentukan untuk menggambarkan penggunaan cluster.

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

Output:

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

Untuk informasi selengkapnya, lihat M engelola klaster DAX di Panduan Peng embang Amazon DynamoDB.

• Untuk detail API, lihat TagResource di Refer AWS CLI ensi Perintah.

untag-resource

Contoh kode berikut menunjukkan cara menggunakanuntag-resource.

AWS CLI

Untuk menghapus tag dari sumber daya DAX

untag-resourceContoh berikut menghapus tag dengan nama kunci yang ditentukan dari cluster DAX.

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

Output:

{
    "Tags": []
}

Untuk informasi selengkapnya, lihat M engelola klaster DAX di Panduan Peng embang Amazon DynamoDB.

• Untuk detail API, lihat UntagResource di Refer AWS CLI ensi Perintah.