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-cluster
exemple suivant crée un DAX cluster avec les paramètres spécifiés.aws dax create-cluster \ --cluster-name
daxcluster
\ --node-typedax.r4.large
\ --replication-factor3
\ --iam-role-arnroleARN
\ --sse-specificationEnabled=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 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 DAX clusters dans le guide du développeur Amazon DynamoDB.
-
Pour API plus de détails, voir 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 DAX sous-réseaux
L'
create-subnet-group
exemple 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-idssubnet-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 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-factor
exemple suivant réduit à un le nombre de nœuds du DAX cluster spécifié.aws dax decrease-replication-factor \ --cluster-name
daxcluster
\ --new-replication-factor1
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.
-
Pour API plus de détails, voir DecreaseReplicationFactor
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserdelete-cluster
.
- AWS CLI
-
Pour supprimer un DAX cluster
L'
delete-cluster
exemple 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 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-group
exemple 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.
-
Pour API plus de détails, voir 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-group
exemple 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 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 provisionnés DAX
L'
describe-clusters
exemple 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 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 sur les paramètres système par défaut pour DAX
L'
describe-default-parameters
exemple 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.
-
Pour API plus de détails, voir DescribeDefaultParameters
la section Référence des AWS CLI commandes.
-
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-events
exemple 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 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-groups
exemple 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.
-
Pour API plus de détails, voir 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 DAX paramètres
L'
describe-parameters
exemple 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 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-groups
exemple suivant récupère les détails des groupes de sous-réseaux définis dans. DAXaws 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.
-
Pour API plus de détails, voir 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 DAX cluster
L'
increase-replication-factor
exemple suivant augmente le facteur de réplication du DAX cluster spécifié à 3.aws dax increase-replication-factor \ --cluster-name
daxcluster
\ --new-replication-factor3
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.
-
Pour API plus de détails, voir IncreaseReplicationFactor
la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserlist-tags
.
- AWS CLI
-
Pour répertorier les balises d'une DAX ressource
L'
list-tags
exemple 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 ListTags
la 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-resource
exemple 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 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 DAX ressource
L'
untag-resource
exemple 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 UntagResource
la section Référence des AWS CLI commandes.
-