Esempi di utilizzo di DAX AWS CLI - AWS Command Line Interface
Azioni

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Esempi di utilizzo di DAX AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando il AWS Command Line Interface con DAX.

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzarecreate-cluster.

AWS CLI

Come creare un cluster DAX

L’esempio create-cluster seguente crea un cluster DAX con le impostazioni specificate.

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

Per ulteriori informazioni, consulta Fase 3: creare un cluster DAX nella Guida per gli sviluppatori di Amazon DynamoDB.

Il seguente esempio di codice mostra come utilizzarecreate-parameter-group.

AWS CLI

Come creare un gruppo di parametri

Il seguente esempio `` create-parameter-group`` crea un gruppo di parametri con le impostazioni specificate.

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

Output:

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

Per ulteriori informazioni, consulta Gestione dei cluster DAX nella Guida per gli sviluppatori di Amazon DynamoDB.

Il seguente esempio di codice mostra come utilizzarecreate-subnet-group.

AWS CLI

Come creare un gruppo di sottoreti DAX

L’esempio create-subnet-group seguente crea un gruppo di sottoreti con le impostazioni specificate.

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

Per ulteriori informazioni, consulta Fase 2: creare un gruppo di sottoreti nella Guida per gli sviluppatori di Amazon DynamoDB.

Il seguente esempio di codice mostra come utilizzaredecrease-replication-factor.

AWS CLI

Come rimuovere uno o più nodi dal cluster

L’esempio decrease-replication-factor seguente riduce a uno il numero di nodi nel cluster DAX specificato.

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

Per ulteriori informazioni, consulta Gestione dei cluster DAX nella Guida per gli sviluppatori di Amazon DynamoDB.

Il seguente esempio di codice mostra come utilizzaredelete-cluster.

AWS CLI

Per eliminare un cluster DAX

L’esempio delete-cluster seguente elimina il cluster DAX specificato.

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

Per ulteriori informazioni, consulta Gestione dei cluster DAX nella Guida per gli sviluppatori di Amazon DynamoDB.

  • Per i dettagli sull'API, vedere DeleteClusterin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaredelete-parameter-group.

AWS CLI

Come eliminare un gruppo di parametri

L’esempio delete-parameter-group seguente elimina il gruppo di parametri DAX specificato.

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

Output:

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

Per ulteriori informazioni, consulta Gestione dei cluster DAX nella Guida per gli sviluppatori di Amazon DynamoDB.

Il seguente esempio di codice mostra come utilizzaredelete-subnet-group.

AWS CLI

Come eliminare un gruppo di sottoreti

L’esempio delete-subnet-group seguente elimina il gruppo di sottoreti DAX specificato.

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

Output:

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

Per ulteriori informazioni, consulta Gestione dei cluster DAX nella Guida per gli sviluppatori di Amazon DynamoDB.

Il seguente esempio di codice mostra come utilizzaredescribe-clusters.

AWS CLI

Come restituire informazioni su tutti i cluster DAX sottoposti a provisioning

L’esempio describe-clusters seguente visualizza i dettagli su tutti i cluster DAX di cui è stato effettuato il provisioning.

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

Per ulteriori informazioni, consulta Gestione dei cluster DAX nella Guida per gli sviluppatori di Amazon DynamoDB.

Il seguente esempio di codice mostra come utilizzaredescribe-default-parameters.

AWS CLI

Come restituire le informazioni del parametro di sistema predefinito per DAX

L’esempio describe-default-parameters seguente visualizza le informazioni sul parametro di sistema di default per 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"
        }
    ]
}

Per ulteriori informazioni, consulta Gestione dei cluster DAX nella Guida per gli sviluppatori di Amazon DynamoDB.

Il seguente esempio di codice mostra come utilizzaredescribe-events.

AWS CLI

Come restituire gli eventi correlati ai cluster DAX e ai gruppi di parametri

L’esempio describe-events seguente visualizza i dettagli degli eventi correlati ai cluster DAX e ai gruppi di parametri.

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

Per ulteriori informazioni, consulta Gestione dei cluster DAX nella Guida per gli sviluppatori di Amazon DynamoDB.

Il seguente esempio di codice mostra come utilizzaredescribe-parameter-groups.

AWS CLI

Come descrivere i gruppi di parametri definiti in DAX

L’esempio describe-parameter-groups seguente recupera i dettagli dei gruppi di parametri definiti in DAX.

aws dax describe-parameter-groups

Output:

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

Per ulteriori informazioni, consulta Gestione dei cluster DAX nella Guida per gli sviluppatori di Amazon DynamoDB.

Il seguente esempio di codice mostra come utilizzaredescribe-parameters.

AWS CLI

Come descrivere i parametri definiti in un gruppo di parametri DAX

L’esempio describe-parameters seguente recupera i dettagli dei parametri definiti nel gruppo di parametri DAX specificato.

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

Per ulteriori informazioni, consulta Gestione dei cluster DAX nella Guida per gli sviluppatori di Amazon DynamoDB.

Il seguente esempio di codice mostra come utilizzaredescribe-subnet-groups.

AWS CLI

Come descrivere i gruppi di sottoreti definiti in DAX

L’esempio describe-subnet-groups seguente recupera i dettagli dei gruppi di sottoreti definiti in 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"
                }
            ]
        }
    ]
}

Per ulteriori informazioni, consulta Gestione dei cluster DAX nella Guida per gli sviluppatori di Amazon DynamoDB.

Il seguente esempio di codice mostra come utilizzareincrease-replication-factor.

AWS CLI

Come aumentare il fattore di replica per un cluster DAX

L’esempio increase-replication-factor seguente aumenta il fattore di replica del cluster DAX specificato a 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"
        }
    }
}

Per ulteriori informazioni, consulta Gestione dei cluster DAX nella Guida per gli sviluppatori di Amazon DynamoDB.

Il seguente esempio di codice mostra come utilizzarelist-tags.

AWS CLI

Come elencare i tag per una risorsa DAX

L’esempio list-tags seguente elenca le chiavi e i valori dei tag associati al cluster DAX specificato.

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

Output:

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

Per ulteriori informazioni, consulta Gestione dei cluster DAX nella Guida per gli sviluppatori di Amazon DynamoDB.

Il seguente esempio di codice mostra come utilizzaretag-resource.

AWS CLI

Come taggare una risorsa DAX

L’esempio tag-resource seguente allega il nome della chiave del tag specificato e il valore associato al cluster DAX specificato per descrivere l’utilizzo del 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"
        }
    ]
}

Per ulteriori informazioni, consulta Gestione dei cluster DAX nella Guida per gli sviluppatori di Amazon DynamoDB.

Il seguente esempio di codice mostra come utilizzareuntag-resource.

AWS CLI

Come rimuovere i tag da una risorsa DAX

L’esempio untag-resource seguente rimuove il tag con il nome chiave specificato da un cluster DAX.

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

Output:

{
    "Tags": []
}

Per ulteriori informazioni, consulta Gestione dei cluster DAX nella Guida per gli sviluppatori di Amazon DynamoDB.