DAXexemples utilisant AWS CLI - AWS Command Line Interface
Actions

Cette documentation concerne AWS CLI uniquement la version 1. Pour la documentation relative à la version 2 du AWS CLI, consultez le guide de l'utilisateur de la version 2.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

DAXexemples utilisant AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du AWS Command Line Interface withDAX.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Les actions vous indiquent comment appeler des fonctions de service individuelles, mais vous pouvez les visualiser dans leur contexte dans les scénarios correspondants.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la façon de configurer et d'exécuter le code en contexte.

Rubriques

Actions

L'exemple de code suivant montre comment utilisercreate-cluster.

AWS CLI

Pour créer un DAX cluster

L'create-clusterexemple suivant crée un DAX cluster avec les paramètres spécifiés.

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

Sortie :

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

Pour plus d'informations, consultez Étape 3 : Création d'un DAX cluster dans le manuel Amazon DynamoDB Developer Guide.

  • Pour API plus de détails, voir CreateClusterla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-parameter-group.

AWS CLI

Pour créer un groupe de paramètres

L'exemple `` create-parameter-group`` suivant crée un groupe de paramètres avec les paramètres spécifiés.

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

Sortie :

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

Pour plus d'informations, consultez la section Gestion des DAX clusters dans le guide du développeur Amazon DynamoDB.

L'exemple de code suivant montre comment utilisercreate-subnet-group.

AWS CLI

Pour créer un groupe de DAX sous-réseaux

L'create-subnet-groupexemple suivant crée un groupe de sous-réseaux avec les paramètres spécifiés.

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

Sortie :

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

Pour plus d'informations, consultez Étape 2 : Création d'un groupe de sous-réseaux dans le guide du développeur Amazon DynamoDB.

  • Pour API plus de détails, voir CreateSubnetGroupla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdecrease-replication-factor.

AWS CLI

Pour supprimer un ou plusieurs nœuds du cluster

L'decrease-replication-factorexemple suivant réduit à un le nombre de nœuds du DAX cluster spécifié.

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

Sortie :

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

Pour plus d'informations, consultez la section Gestion des DAX clusters dans le guide du développeur Amazon DynamoDB.

L'exemple de code suivant montre comment utiliserdelete-cluster.

AWS CLI

Pour supprimer un DAX cluster

L'delete-clusterexemple suivant supprime le DAX cluster spécifié.

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

Sortie :

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

Pour plus d'informations, consultez la section Gestion des DAX clusters dans le guide du développeur Amazon DynamoDB.

  • Pour API plus de détails, voir DeleteClusterla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-parameter-group.

AWS CLI

Pour supprimer un groupe de paramètres

L'delete-parameter-groupexemple suivant supprime le groupe de DAX paramètres spécifié.

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

Sortie :

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

Pour plus d'informations, consultez la section Gestion des DAX clusters dans le guide du développeur Amazon DynamoDB.

L'exemple de code suivant montre comment utiliserdelete-subnet-group.

AWS CLI

Pour supprimer un groupe de sous-réseaux

L'delete-subnet-groupexemple suivant supprime le groupe de DAX sous-réseaux spécifié.

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

Sortie :

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

Pour plus d'informations, consultez la section Gestion des DAX clusters dans le guide du développeur Amazon DynamoDB.

  • Pour API plus de détails, voir DeleteSubnetGroupla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-clusters.

AWS CLI

Pour renvoyer des informations sur tous les clusters provisionnés DAX

L'describe-clustersexemple suivant affiche les détails de tous les DAX clusters provisionnés.

aws dax describe-clusters

Sortie :

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

Pour plus d'informations, consultez la section Gestion des DAX clusters dans le guide du développeur Amazon DynamoDB.

  • Pour API plus de détails, voir DescribeClustersla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-default-parameters.

AWS CLI

Pour renvoyer les informations sur les paramètres système par défaut pour DAX

L'describe-default-parametersexemple suivant affiche les informations des paramètres système par défaut pourDAX.

aws dax describe-default-parameters

Sortie :

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

Pour plus d'informations, consultez la section Gestion des DAX clusters dans le guide du développeur Amazon DynamoDB.

L'exemple de code suivant montre comment utiliserdescribe-events.

AWS CLI

Pour renvoyer tous les événements liés aux DAX clusters et aux groupes de paramètres

L'describe-eventsexemple suivant affiche les détails des événements liés aux DAX clusters et aux groupes de paramètres.

aws dax describe-events

Sortie :

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

Pour plus d'informations, consultez la section Gestion des DAX clusters dans le guide du développeur Amazon DynamoDB.

  • Pour API plus de détails, voir DescribeEventsla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-parameter-groups.

AWS CLI

Pour décrire les groupes de paramètres définis dans DAX

L'describe-parameter-groupsexemple suivant permet de récupérer des informations sur les groupes de paramètres définis dansDAX.

aws dax describe-parameter-groups

Sortie :

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

Pour plus d'informations, consultez la section Gestion des DAX clusters dans le guide du développeur Amazon DynamoDB.

L'exemple de code suivant montre comment utiliserdescribe-parameters.

AWS CLI

Pour décrire les paramètres définis dans un groupe de DAX paramètres

L'describe-parametersexemple suivant permet de récupérer des informations sur les paramètres définis dans le groupe de DAX paramètres spécifié.

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

Sortie :

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

Pour plus d'informations, consultez la section Gestion des DAX clusters dans le guide du développeur Amazon DynamoDB.

  • Pour API plus de détails, voir DescribeParametersla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdescribe-subnet-groups.

AWS CLI

Pour décrire les groupes de sous-réseaux définis dans DAX

L'describe-subnet-groupsexemple suivant récupère les détails des groupes de sous-réseaux définis dans. DAX

aws dax describe-subnet-groups

Sortie :

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

Pour plus d'informations, consultez la section Gestion des DAX clusters dans le guide du développeur Amazon DynamoDB.

L'exemple de code suivant montre comment utiliserincrease-replication-factor.

AWS CLI

Pour augmenter le facteur de réplication d'un DAX cluster

L'increase-replication-factorexemple suivant augmente le facteur de réplication du DAX cluster spécifié à 3.

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

Sortie :

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

Pour plus d'informations, consultez la section Gestion des DAX clusters dans le guide du développeur Amazon DynamoDB.

L'exemple de code suivant montre comment utiliserlist-tags.

AWS CLI

Pour répertorier les balises d'une DAX ressource

L'list-tagsexemple suivant répertorie les clés de balise et les valeurs associées au DAX cluster spécifié.

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

Sortie :

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

Pour plus d'informations, consultez la section Gestion des DAX clusters dans le guide du développeur Amazon DynamoDB.

  • Pour API plus de détails, voir ListTagsla section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisertag-resource.

AWS CLI

Pour étiqueter une DAX ressource

L'tag-resourceexemple suivant attache le nom de clé de balise spécifié et la valeur associée au DAX cluster spécifié pour décrire l'utilisation du cluster.

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

Sortie :

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

Pour plus d'informations, consultez la section Gestion des DAX clusters dans le guide du développeur Amazon DynamoDB.

  • Pour API plus de détails, voir TagResourcela section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliseruntag-resource.

AWS CLI

Pour supprimer des balises d'une DAX ressource

L'untag-resourceexemple suivant supprime la balise portant le nom de clé spécifié d'un DAX cluster.

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

Sortie :

{
    "Tags": []
}

Pour plus d'informations, consultez la section Gestion des DAX clusters dans le guide du développeur Amazon DynamoDB.

  • Pour API plus de détails, voir UntagResourcela section Référence des AWS CLI commandes.