Esta documentação é para a AWS CLI única versão 1. Para obter a documentação relacionada à versão 2 do AWS CLI, consulte o Guia do usuário da versão 2.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Tipos de parâmetros comuns no AWS CLI

Esta seção descreve alguns dos tipos de parâmetros comuns e o formato típico necessário.

Caso haja problemas com a formatação de um parâmetro para um comando específico, verifique a ajuda inserindo help após o nome do comando. A ajuda de cada subcomando inclui o nome e a descrição de uma opção. O tipo de parâmetro da opção está listado entre parênteses. Para obter mais informações sobre a exibição da ajuda, consulte Acessando ajuda e recursos para o AWS CLI.

String

Os parâmetros de string podem conter caracteres alfanuméricos, símbolos e espaços em branco do conjunto de ASCIIcaracteres. Strings com espaço em branco devem ser incluídas entre aspas. Recomendamos que você não use símbolos nem espaços em branco diferentes do caractere de espaço padrão e observe as regras de aspas para evitar resultados inesperados.

Alguns parâmetros de sequência de caracteres pode aceitar dados binários a partir de um arquivo. Consulte Arquivos binários para ver um exemplo.

Timestamp

Os carimbos de data e hora são formatados de acordo com o padrão 8601. ISO São geralmente chamados de parâmetros “DateTime” ou “Date”.

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

Os formatos aceitos incluem:

Você pode definir o formato do carimbo de data/hora usando a configuração do arquivo cli_timestamp_format.

Listar

Uma ou mais strings separadas por espaços. Se qualquer um dos itens de string contiver espaços, você deverá colocar esse item entre aspas. Observe as regras de aspas de seu terminal para evitar resultados inesperados

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

Booleano

Sinalizador binário que ativa ou desativa uma opção. Por exemplo, ec2 describe-spot-price-history tem um parâmetro booleano --dry-run que, quando especificado, valida a consulta com o serviço sem realmente executá-la.

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

A saída indica se o comando foi bem formado. Esse comando também inclui uma versão --no-dry-run do parâmetro que você pode usar para indicar explicitamente que o comando deve ser executado normalmente. A inclusão não é necessária, pois esse é o comportamento padrão.

Inteiro

Um número inteiro não assinado.

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

Binário/blob (objeto grande binário) e blob de streaming

No AWS CLI, você pode passar um valor binário como uma string diretamente na linha de comando. Há dois tipos de blobs:

Blob

Para transmitir um valor para um parâmetro com o tipo blob, é necessário especificar um caminho para um arquivo local que contenha os dados binários usando o prefixo fileb://. Arquivos referenciados usando o prefixo fileb:// são sempre tratados como um binário bruto não codificado. O caminho especificado é interpretado como sendo relativo ao diretório de trabalho atual. Por exemplo, o parâmetro --plaintext para aws kms encrypt é um blob.

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

Blob de streaming

Blobs de streaming como aws cloudsearchdomain upload-documents não usam prefixos. Em vez disso, os parâmetros de blob de streaming são formatados usando o caminho direto do arquivo. O seguinte exemplo usa o caminho direto do arquivo document-batch.json para o 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

Mapa

Um conjunto de pares de valores-chave especificados em JSON ou usando a CLI sintaxe abreviada s. O JSON exemplo a seguir lê um item de uma tabela do Amazon DynamoDB chamada my-table com um parâmetro de mapa,. --key O parâmetro especifica a chave primária chamada id com um valor numérico de 1 em uma estrutura aninhadaJSON.

Para um JSON uso mais avançado em uma linha de comando, considere usar um JSON processador de linha de comando, por exemplojq, para criar JSON cadeias de caracteres. Para obter mais informações sobrejq, consulte o repositório jq em. GitHub

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

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

Documento

Os tipos de documentos são usados para enviar dados sem a necessidade de incorporá-los em cadeias de caracteresJSON. O tipo de documento permite que os serviços forneçam esquemas arbitrários para você usar tipos de dados mais flexíveis.

Isso permite o envio de JSON dados sem a necessidade de escapar dos valores. Por exemplo, em vez de usar a seguinte JSON entrada de escape:

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

Você pode usar o seguinte tipo de documento:

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

Valores válidos para tipos de documento

Devido à natureza flexível dos tipos de documento, existem vários tipos de valor válidos. Entre os valores válidos estão os seguintes: