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.

Tipos de parámetros comunes en AWS CLI

En esta sección, se describen algunos de los tipos de parámetros comunes y el formato requerido típico.

Si tiene problemas con el formato de un parámetro para un comando específico, compruebe la ayuda escribiendo help después del nombre del comando. La ayuda de cada subcomando incluye el nombre y la descripción de una opción. El tipo de parámetro de la opción se muestra entre paréntesis. Para obtener más información acerca de obtener ayuda, consulte Acceder a la ayuda y los recursos para AWS CLI.

Cadena

Los parámetros de cadena pueden contener caracteres alfanuméricos, símbolos y espacios en blanco del conjunto de ASCIIcaracteres. Las cadenas que contienen espacios en blanco se deben entrecomillar. Le recomendamos que no utilice símbolos ni espacios en blanco diferentes del carácter de espacio estándar, y que observe las reglas de entrecomillado del terminal para evitar resultados inesperados.

Algunos parámetros de cadena pueden aceptar datos binarios de un archivo. Consulte Archivos binarios para ver un ejemplo.

Timestamp

Las marcas de tiempo se formatean de acuerdo con el estándar 8601. ISO A menudo se conocen como parámetros "DateTime" o "Date".

$ aws ec2 describe-spot-price-history --start-time 2014-10-13T19:00:00Z

Los formatos aceptados son:

De forma predeterminada, la AWS CLI versión 2 traduce todos los DateTime valores de respuesta al formato ISO 8601.

Puede establecer el formato de la marca de tiempo con el ajuste de archivo cli_timestamp_format.

Enumeración

Una o varias cadenas separadas por espacios. Si cualquiera de los elementos de cadena contiene un espacio, debe escribir dicho elemento entre comillas. Observe las normas de entrecomillado del terminal para evitar resultados inesperados

$ aws ec2 describe-spot-price-history --instance-types m1.xlarge m1.medium

Booleano

Marcador binario que activa o desactiva una opción. Por ejemplo, ec2 describe-spot-price-history tiene con un parámetro --dry-run booleano que, cuando se especifica, valida la consulta con el servicio sin ejecutar realmente una consulta.

$ aws ec2 describe-spot-price-history --dry-run

El resultado indica si el comando tenía el formato correcto o no. Este comando también incluye una versión --no-dry-run del parámetro que puede utilizarse para indicar de forma explícita que el comando debe ejecutarse con normalidad, aunque no es necesario incluirlo, ya que este es el comportamiento predeterminado.

Entero

Un número entero sin firma.

$ aws ec2 describe-spot-price-history --max-items 5

Binario/blob (objeto binario grande) y blob en streaming

En el AWS CLI, puede pasar un valor binario como una cadena directamente en la línea de comandos. Existen dos tipos de blobs:

Blob

Para pasar un valor a un parámetro con el tipo blob, debe especificar una ruta a un archivo local que contenga los datos binarios mediante el prefijo fileb://. Los archivos a los que se hace referencia mediante el prefijo fileb:// siempre se tratan como binarios sin codificar. La ruta especificada se interpreta como una ruta relativa al directorio de trabajo actual. Por ejemplo, el parámetro --plaintext para aws kms encrypt es un blob.

$ aws kms encrypt \
    --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \
    --plaintext fileb://ExamplePlaintextFile \
    --output text \
    --query CiphertextBlob | base64 \
    --decode > ExampleEncryptedFile

Blob de streaming

Los blobs de streaming como aws cloudsearchdomain upload-documents no utilizan prefijos. En cambio, los parámetros de blob de streaming se formatean mediante la ruta de archivo directa. En el siguiente ejemplo se utiliza la ruta de archivo directa document-batch.json para el comando aws cloudsearchdomain upload-documents:

$ aws cloudsearchdomain upload-documents \
    --endpoint-url https://doc-my-domain.us-west-1.cloudsearch.amazonaws.com \
    --content-type application/json \
    --documents document-batch.json

Asignación

Conjunto de pares clave-valor especificados en JSON o mediante la sintaxis CLI abreviada. En el siguiente JSON ejemplo, se lee un elemento de una tabla de Amazon DynamoDB denominada my-table con un parámetro de mapa,. --key El parámetro especifica la clave principal denominada id con un valor numérico de 1 en una estructura anidada. JSON

Para un JSON uso más avanzado en una línea de comandos, considere la posibilidad de utilizar un JSON procesador de línea de comandos, por ejemplojq, para crear JSON cadenas. Para obtener más informaciónjq, consulte el repositorio jq en GitHub.

$ aws dynamodb get-item --table-name my-table --key '{"id": {"N":"1"}}'

{
    "Item": {
        "name": {
            "S": "John"
        },
        "id": {
            "N": "1"
        }
    }
}

Documento

Los tipos de documentos se utilizan para enviar datos sin necesidad de incrustarlos JSON dentro de cadenas. El tipo de documento permite a los servicios proporcionar esquemas arbitrarios para que utilice tipos de datos más flexibles.

Esto permite enviar JSON datos sin necesidad de escapar de los valores. Por ejemplo, en lugar de utilizar la siguiente JSON entrada de escape:

{"document": "{\"key\":true}"}

Puede utilizar el tipo de documento que se muestra a continuación:

{"document": {"key": true}}

Valores válidos para tipos de documentos

Debido a la naturaleza flexible de los tipos de documentos, existen varios tipos de valores válidos. Entre los valores válidos se incluyen los siguientes: