Exemples DAX utilisant AWS CLI - AWS Exemples de code SDK
Actions

D'autres exemples de AWS SDK sont disponibles dans le référentiel AWS Doc SDK Examples GitHub .

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.

Exemples DAX utilisant AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le AWS Command Line Interface avec DAX.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

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 cluster DAX

L'create-clusterexemple suivant crée un cluster DAX 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 cluster DAX dans le guide du développeur Amazon DynamoDB.

  • Pour plus de détails sur l'API, reportez-vous CreateClusterà la 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 clusters DAX dans le guide du développeur Amazon DynamoDB.

  • Pour plus de détails sur l'API, reportez-vous CreateParameterGroupà la section Référence des AWS CLI commandes.

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

AWS CLI

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

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 manuel Amazon DynamoDB Developer Guide.

  • Pour plus de détails sur l'API, reportez-vous CreateSubnetGroupà la 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 cluster DAX 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 clusters DAX dans le guide du développeur Amazon DynamoDB.

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

AWS CLI

Pour supprimer un cluster DAX

L'delete-clusterexemple suivant supprime le cluster DAX 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 clusters DAX dans le guide du développeur Amazon DynamoDB.

  • Pour plus de détails sur l'API, reportez-vous DeleteClusterà la 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 paramètres DAX 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 clusters DAX dans le guide du développeur Amazon DynamoDB.

  • Pour plus de détails sur l'API, reportez-vous DeleteParameterGroupà la section Référence des AWS CLI commandes.

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 sous-réseaux DAX 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 clusters DAX dans le guide du développeur Amazon DynamoDB.

  • Pour plus de détails sur l'API, reportez-vous DeleteSubnetGroupà la 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 DAX provisionnés

L'describe-clustersexemple suivant affiche les détails de tous les clusters DAX 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 clusters DAX dans le guide du développeur Amazon DynamoDB.

  • Pour plus de détails sur l'API, reportez-vous DescribeClustersà la section Référence des AWS CLI commandes.

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

AWS CLI

Pour renvoyer les informations de 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 pour DAX.

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 clusters DAX 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 clusters DAX et aux groupes de paramètres

L'describe-eventsexemple suivant affiche les détails des événements liés aux clusters DAX 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 clusters DAX dans le guide du développeur Amazon DynamoDB.

  • Pour plus de détails sur l'API, reportez-vous DescribeEventsà la 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 dans DAX.

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 clusters DAX dans le guide du développeur Amazon DynamoDB.

  • Pour plus de détails sur l'API, reportez-vous DescribeParameterGroupsà la section Référence des AWS CLI commandes.

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

AWS CLI

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

L'describe-parametersexemple suivant permet de récupérer des informations sur les paramètres définis dans le groupe de paramètres DAX 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 clusters DAX dans le guide du développeur Amazon DynamoDB.

  • Pour plus de détails sur l'API, reportez-vous DescribeParametersà la 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 clusters DAX dans le guide du développeur Amazon DynamoDB.

  • Pour plus de détails sur l'API, reportez-vous DescribeSubnetGroupsà la section Référence des AWS CLI commandes.

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

AWS CLI

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

L'increase-replication-factorexemple suivant augmente le facteur de réplication du cluster DAX 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 clusters DAX 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 ressource DAX

L'list-tagsexemple suivant répertorie les clés de balise et les valeurs associées au cluster DAX 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 clusters DAX dans le guide du développeur Amazon DynamoDB.

  • Pour plus de détails sur l'API, reportez-vous ListTagsà la section Référence des AWS CLI commandes.

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

AWS CLI

Pour baliser une ressource DAX

L'tag-resourceexemple suivant attache le nom de clé de balise spécifié et la valeur associée au cluster DAX 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 clusters DAX dans le guide du développeur Amazon DynamoDB.

  • Pour plus de détails sur l'API, reportez-vous TagResourceà la 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 ressource DAX

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

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 clusters DAX dans le guide du développeur Amazon DynamoDB.

  • Pour plus de détails sur l'API, reportez-vous UntagResourceà la section Référence des AWS CLI commandes.