Esempi di DAX per AWS CLI - AWS Command Line Interface
Operazioni

Esempi di DAX per AWS CLI

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

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

Ogni esempio include un link al codice sorgente completo, dove è possibile trovare le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Operazioni

L’esempio di codice seguente mostra come utilizzare create-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: Creazione di un cluster DAX nella Guida per sviluppatori di Amazon DynamoDB.

  • Per informazioni dettagliate sull’API, consulta CreateCluster in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare create-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 sviluppatori di Amazon DynamoDB.

  • Per informazioni dettagliate sull’API, consulta CreateParameterGroup in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare create-subnet-group.

AWS CLI

Come creare un gruppo di sottoreti DAX

Nell’esempio seguente create-subnet-group 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: crea un gruppo di sottoreti nella Guida per sviluppatori di Amazon DynamoDB.

  • Per informazioni dettagliate sull’API, consulta CreateSubnetGroup in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare decrease-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 sviluppatori di Amazon DynamoDB.

L’esempio di codice seguente mostra come utilizzare delete-cluster.

AWS CLI

Come eliminare un cluster DAX

Nell’esempio seguente delete-cluster 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 sviluppatori di Amazon DynamoDB.

  • Per informazioni dettagliate sull’API, consulta DeleteCluster in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-parameter-group.

AWS CLI

Come eliminare un gruppo di parametri

Nell’esempio seguente delete-parameter-group 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 sviluppatori di Amazon DynamoDB.

  • Per informazioni dettagliate sull’API, consulta DeleteParameterGroup in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-subnet-group.

AWS CLI

Come eliminare un gruppo di sottoreti

Nell’esempio seguente delete-subnet-group 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 sviluppatori di Amazon DynamoDB.

  • Per informazioni dettagliate sull’API, consulta DeleteSubnetGroup in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare describe-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 sviluppatori di Amazon DynamoDB.

  • Per informazioni dettagliate sull’API, consulta DescribeClusters in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare describe-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 sviluppatori di Amazon DynamoDB.

L’esempio di codice seguente mostra come utilizzare describe-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 sviluppatori di Amazon DynamoDB.

  • Per informazioni dettagliate sull’API, consulta DescribeEvents in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare describe-parameter-groups.

AWS CLI

Come descrivere i gruppi di parametri definiti in DAX

Nell’esempio seguente describe-parameter-groups recupera i dettagli di tutti i gruppi di parametri del database definiti nel 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 sviluppatori di Amazon DynamoDB.

L’esempio di codice seguente mostra come utilizzare describe-parameters.

AWS CLI

Come descrivere i parametri definiti in un gruppo di parametri DAX

Nell’esempio seguente describe-parameters recupera i dettagli sui parametri definiti nel gruppo di parametri DAX specificati.

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 sviluppatori di Amazon DynamoDB.

  • Per informazioni dettagliate sulla API, consulta DescribeParameters nella Documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare describe-subnet-groups.

AWS CLI

Come descrivere i gruppi di sottoreti definiti in DAX

Nell’esempio seguente describe-subnet-groups recupera i dettagli di tutti i gruppi di sottoreti definiti nel 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 sviluppatori di Amazon DynamoDB.

  • Per informazioni dettagliate sull’API, consulta DescribeSubnetGroups in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare increase-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 sviluppatori di Amazon DynamoDB.

L’esempio di codice seguente mostra come utilizzare list-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 sviluppatori di Amazon DynamoDB.

  • Per i dettagli dell'API, consulta ListTags in Riferimento ai comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare tag-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 sviluppatori di Amazon DynamoDB.

  • Per informazioni dettagliate sulle API, consulta TagResource nel Riferimento ai comandi AWS CLI.

L’esempio di codice seguente mostra come utilizzare untag-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 sviluppatori di Amazon DynamoDB.

  • Per i dettagli dell'API, consulta UntagResource in Riferimento ai comandi della AWS CLI.