DAXesempi utilizzando 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à.

DAXesempi utilizzando AWS CLI

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

Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Mentre le azioni mostrano come richiamare le singole funzioni di servizio, è possibile visualizzare le azioni nel loro contesto negli scenari correlati.

Ogni esempio include un collegamento al codice sorgente completo, in cui è possibile trovare istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzarecreate-cluster.

AWS CLI

Per creare un DAX cluster

L'create-clusteresempio seguente crea un DAX cluster 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 la Fase 3: Creare un DAX cluster nella Amazon DynamoDB Developer Guide.

  • Per API i dettagli, consulta AWS CLI Command CreateClusterReference.

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

AWS CLI

Per 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 Managing DAX Clusters nella Amazon DynamoDB Developer Guide.

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

AWS CLI

Per creare un gruppo di DAX sottoreti

L'create-subnet-groupesempio 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 la Fase 2: Creare un gruppo di sottoreti nella Amazon DynamoDB Developer Guide.

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

AWS CLI

Per rimuovere uno o più nodi dal cluster

L'decrease-replication-factoresempio seguente riduce a uno il numero di nodi nel DAX cluster 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 Managing DAX Clusters nella Amazon DynamoDB Developer Guide.

Il seguente esempio di codice mostra come utilizzaredelete-cluster.

AWS CLI

Per eliminare un DAX cluster

L'delete-clusteresempio seguente elimina il DAX cluster 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 Managing DAX Clusters nella Amazon DynamoDB Developer Guide.

  • Per API i dettagli, consulta Command DeleteClusterReference AWS CLI .

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

AWS CLI

Per eliminare un gruppo di parametri

L'delete-parameter-groupesempio seguente elimina il gruppo di DAX parametri specificato.

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

Output:

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

Per ulteriori informazioni, consulta Managing DAX Clusters nella Amazon DynamoDB Developer Guide.

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

AWS CLI

Per eliminare un gruppo di sottoreti

L'delete-subnet-groupesempio seguente elimina il gruppo di DAX sottoreti specificato.

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

Output:

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

Per ulteriori informazioni, consulta Managing DAX Clusters nella Amazon DynamoDB Developer Guide.

Il seguente esempio di codice mostra come utilizzaredescribe-clusters.

AWS CLI

Per restituire informazioni su tutti i cluster assegnati DAX

L'describe-clustersesempio seguente visualizza i dettagli su tutti i cluster a cui è stato assegnato il provisioningDAX.

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 Managing DAX Clusters nella Amazon DynamoDB Developer Guide.

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

AWS CLI

Per restituire le informazioni sui parametri di sistema predefiniti per DAX

L'describe-default-parametersesempio seguente visualizza le informazioni sui parametri di sistema predefiniti perDAX.

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 Managing DAX Clusters nella Amazon DynamoDB Developer Guide.

Il seguente esempio di codice mostra come utilizzaredescribe-events.

AWS CLI

Per restituire tutti gli eventi relativi ai DAX cluster e ai gruppi di parametri

L'describe-eventsesempio seguente visualizza i dettagli degli eventi correlati ai DAX cluster 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 Managing DAX Clusters nella Amazon DynamoDB Developer Guide.

  • Per API i dettagli, consulta Command DescribeEventsReference AWS CLI .

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

AWS CLI

Per descrivere i gruppi di parametri definiti in DAX

L'describe-parameter-groupsesempio seguente recupera i dettagli sui gruppi di parametri definiti inDAX.

aws dax describe-parameter-groups

Output:

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

Per ulteriori informazioni, consulta Managing DAX Clusters nella Amazon DynamoDB Developer Guide.

Il seguente esempio di codice mostra come utilizzaredescribe-parameters.

AWS CLI

Per descrivere i parametri definiti in un gruppo di DAX parametri

L'describe-parametersesempio seguente recupera i dettagli sui parametri definiti nel gruppo di DAX parametri 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 Managing DAX Clusters nella Amazon DynamoDB Developer Guide.

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

AWS CLI

Per descrivere i gruppi di sottoreti definiti in DAX

L'describe-subnet-groupsesempio seguente recupera i dettagli per i 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 Managing DAX Clusters nella Amazon DynamoDB Developer Guide.

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

AWS CLI

Per aumentare il fattore di replica per un cluster DAX

L'increase-replication-factoresempio seguente aumenta il fattore di replica del DAX cluster 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 Managing DAX Clusters nella Amazon DynamoDB Developer Guide.

Il seguente esempio di codice mostra come utilizzarelist-tags.

AWS CLI

Per elencare i tag su una DAX risorsa

L'list-tagsesempio seguente elenca le chiavi e i valori dei tag associati al DAX cluster 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 Managing DAX Clusters nella Amazon DynamoDB Developer Guide.

  • Per API i dettagli, consulta Command ListTagsReference AWS CLI .

Il seguente esempio di codice mostra come utilizzaretag-resource.

AWS CLI

Per etichettare una DAX risorsa

L'tag-resourceesempio seguente allega il nome della chiave del tag specificato e il valore associato al DAX cluster 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 Managing DAX Clusters nella Amazon DynamoDB Developer Guide.

  • Per API i dettagli, consulta Command TagResourceReference AWS CLI .

Il seguente esempio di codice mostra come utilizzareuntag-resource.

AWS CLI

Per rimuovere i tag da una DAX risorsa

L'untag-resourceesempio seguente rimuove il tag con il nome di chiave specificato da un DAX cluster.

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

Output:

{
    "Tags": []
}

Per ulteriori informazioni, consulta Managing DAX Clusters nella Amazon DynamoDB Developer Guide.

  • Per API i dettagli, consulta Command UntagResourceReference AWS CLI .