DAXejemplos que utilizan AWS CLI - AWS Command Line Interface
Acciones

Esta documentación es AWS CLI únicamente para la versión 1 de la versión. Para ver la documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

DAXejemplos que utilizan AWS CLI

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso del AWS Command Line Interface withDAX.

Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las funciones de servicio individuales, es posible ver las acciones en contexto en los escenarios relacionados.

Cada ejemplo incluye un enlace al código fuente completo, donde puede encontrar instrucciones sobre cómo configurar y ejecutar el código en su contexto.

Acciones

En el siguiente ejemplo de código se muestra cómo usarlocreate-cluster.

AWS CLI

Para crear un DAX clúster

En el siguiente create-cluster ejemplo, se crea un DAX clúster con la configuración especificada.

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

Salida:

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

Para obtener más información, consulte el paso 3: Creación de un DAX clúster en la Guía para desarrolladores de Amazon DynamoDB.

  • Para API obtener más información, consulte la Referencia CreateClusterde AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlocreate-parameter-group.

AWS CLI

Para crear un grupo de parámetros

El siguiente ejemplo de `` create-parameter-group`` crea un grupo de parámetros con los ajustes especificados.

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

Salida:

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

Para obtener más información, consulte Administración de DAX clústeres en la Guía para desarrolladores de Amazon DynamoDB.

  • Para API obtener más información, consulte la Referencia CreateParameterGroupde AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlocreate-subnet-group.

AWS CLI

Para crear un grupo de DAX subredes

En el siguiente create-subnet-group ejemplo, se crea un grupo de subredes con la configuración especificada.

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

Salida:

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

Para obtener más información, consulte el paso 2: Crear un grupo de subredes en la Guía para desarrolladores de Amazon DynamoDB.

  • Para API obtener más información, consulte la Referencia de CreateSubnetGroupcomandos AWS CLI .

El siguiente ejemplo de código muestra cómo usarlodecrease-replication-factor.

AWS CLI

Para eliminar uno o más nodos del clúster

En el siguiente decrease-replication-factor ejemplo, se reduce a uno el número de nodos del DAX clúster especificado.

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

Salida:

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

Para obtener más información, consulte Administración de DAX clústeres en la Guía para desarrolladores de Amazon DynamoDB.

El siguiente ejemplo de código muestra cómo usarlodelete-cluster.

AWS CLI

Para eliminar un DAX clúster

En el siguiente delete-cluster ejemplo, se elimina el DAX clúster especificado.

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

Salida:

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

Para obtener más información, consulte Administración de DAX clústeres en la Guía para desarrolladores de Amazon DynamoDB.

  • Para API obtener más información, consulte la Referencia DeleteClusterde AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodelete-parameter-group.

AWS CLI

Para eliminar un grupo de parámetros

En el siguiente delete-parameter-group ejemplo, se elimina el grupo de DAX parámetros especificado.

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

Salida:

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

Para obtener más información, consulte Administración de DAX clústeres en la Guía para desarrolladores de Amazon DynamoDB.

  • Para API obtener más información, consulte la Referencia DeleteParameterGroupde AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodelete-subnet-group.

AWS CLI

Para eliminar un grupo de subredes

En el siguiente delete-subnet-group ejemplo, se elimina el grupo de DAX subredes especificado.

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

Salida:

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

Para obtener más información, consulte Administración de DAX clústeres en la Guía para desarrolladores de Amazon DynamoDB.

  • Para API obtener más información, consulte la Referencia DeleteSubnetGroupde AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodescribe-clusters.

AWS CLI

Para devolver información sobre todos los clústeres aprovisionados DAX

En el siguiente describe-clusters ejemplo, se muestran detalles sobre todos los clústeres aprovisionadosDAX.

aws dax describe-clusters

Salida:

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

Para obtener más información, consulte Administración de DAX clústeres en la Guía para desarrolladores de Amazon DynamoDB.

  • Para API obtener más información, consulte la Referencia DescribeClustersde AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodescribe-default-parameters.

AWS CLI

Para devolver la información de parámetros del sistema predeterminada para DAX

En el siguiente describe-default-parameters ejemplo, se muestra la información de los parámetros del sistema por defecto deDAX.

aws dax describe-default-parameters

Salida:

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

Para obtener más información, consulte Administración de DAX clústeres en la Guía para desarrolladores de Amazon DynamoDB.

El siguiente ejemplo de código muestra cómo usarlodescribe-events.

AWS CLI

Para devolver todos los eventos relacionados con los DAX clústeres y los grupos de parámetros

En el siguiente describe-events ejemplo, se muestran los detalles de los eventos relacionados con DAX los clústeres y los grupos de parámetros.

aws dax describe-events

Salida:

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

Para obtener más información, consulte Administración de DAX clústeres en la Guía para desarrolladores de Amazon DynamoDB.

  • Para API obtener más información, consulte la Referencia DescribeEventsde AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodescribe-parameter-groups.

AWS CLI

Para describir los grupos de parámetros definidos en DAX

El siguiente describe-parameter-groups ejemplo recupera detalles sobre los grupos de parámetros que se definen enDAX.

aws dax describe-parameter-groups

Salida:

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

Para obtener más información, consulte Administración de DAX clústeres en la Guía para desarrolladores de Amazon DynamoDB.

El siguiente ejemplo de código muestra cómo usarlodescribe-parameters.

AWS CLI

Para describir los parámetros definidos en un grupo de DAX parámetros

El siguiente describe-parameters ejemplo recupera detalles sobre los parámetros que se definen en el grupo de DAX parámetros especificado.

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

Salida:

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

Para obtener más información, consulte Administración de DAX clústeres en la Guía para desarrolladores de Amazon DynamoDB.

  • Para API obtener más información, consulte la Referencia DescribeParametersde AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodescribe-subnet-groups.

AWS CLI

Para describir los grupos de subredes definidos en DAX

En el siguiente describe-subnet-groups ejemplo, se recuperan los detalles de los grupos de subredes definidos en. DAX

aws dax describe-subnet-groups

Salida:

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

Para obtener más información, consulte Administración de DAX clústeres en la Guía para desarrolladores de Amazon DynamoDB.

  • Para API obtener más información, consulte la Referencia DescribeSubnetGroupsde AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarloincrease-replication-factor.

AWS CLI

Para aumentar el factor de replicación de un DAX clúster

El siguiente increase-replication-factor ejemplo aumenta el factor de replicación del DAX clúster especificado a 3.

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

Salida:

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

Para obtener más información, consulte Administración de DAX clústeres en la Guía para desarrolladores de Amazon DynamoDB.

El siguiente ejemplo de código muestra cómo usarlolist-tags.

AWS CLI

Para enumerar las etiquetas de un DAX recurso

En el siguiente list-tags ejemplo, se enumeran las claves y los valores de las etiquetas adjuntos al DAX clúster especificado.

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

Salida:

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

Para obtener más información, consulte Administración de DAX clústeres en la Guía para desarrolladores de Amazon DynamoDB.

  • Para API obtener más información, consulte la Referencia ListTagsde AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlotag-resource.

AWS CLI

Para etiquetar un DAX recurso

En el siguiente tag-resource ejemplo, se adjunta el nombre de la clave de etiqueta especificada y el valor asociado al DAX clúster especificado para describir el uso del clúster.

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

Salida:

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

Para obtener más información, consulte Administración de DAX clústeres en la Guía para desarrolladores de Amazon DynamoDB.

  • Para API obtener más información, consulte la Referencia TagResourcede AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlountag-resource.

AWS CLI

Para eliminar etiquetas de un DAX recurso

En el siguiente untag-resource ejemplo, se quita la etiqueta con el nombre de clave especificado de un DAX clúster.

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

Salida:

{
    "Tags": []
}

Para obtener más información, consulte Administración de DAX clústeres en la Guía para desarrolladores de Amazon DynamoDB.

  • Para API obtener más información, consulte la Referencia UntagResourcede AWS CLI comandos.