Definições gerais da configuração - SDKs e ferramentas da AWS

Definições gerais da configuração

nota

Para obter ajuda em compreender o layout das páginas de configurações ou interpretar a tabela Compatibilidade com SDKs e ferramentas da AWS a seguir, consulte Entender as páginas de configurações deste guia.

Os SDKs oferecem suporte a algumas configurações gerais que definem seus comportamentos.

Configure essa funcionalidade usando o seguinte:

api_versions: configuração de arquivo config da AWS compartilhado

Alguns serviços da AWS mantêm várias versões de API para oferecer suporte à compatibilidade com versões anteriores. Por padrão, as operações do SDK e da AWS CLI usam a versão de API mais recente disponível. Para exigir que uma versão específica da API seja usada em suas solicitações, inclua a configuração api_versions em seu perfil.

Valor padrão: nenhum. (A versão mais recente da API é usada pelo SDK.)

Valores válidos: esta é uma configuração “aninhada” que é seguida por uma ou mais linhas recuadas, cada uma identificando um serviço da AWS e a versão de API a ser usada. Consulte a documentação para o serviço da AWS para saber quais versões de API estão disponíveis.

O exemplo define uma versão específica da API para dois serviços da AWS no arquivo config. Essas versões de API são usadas apenas para comandos que são executados sob o perfil que contém essas configurações. Os comandos para qualquer outro serviço usam a versão mais recente da API desse serviço.

api_versions = ec2 = 2015-03-01 cloudfront = 2015-09-017
ca_bundle: configuração de arquivo config da AWS compartilhado
AWS_CA_BUNDLE: variável de ambiente

O caminho especifica o caminho para um pacote de certificado personalizado (um arquivo com extensão .pem) a ser usado ao estabelecer conexões SSL/TLS.

Valor padrão: nenhum

Valores válidos: especifique o caminho completo ou o nome do arquivo base. Se houver um nome de arquivo base, o sistema tentará encontrar o programa nas pastas especificadas pela variável de ambiente PATH.

Exemplo de configuração desse valor no arquivo config:

[default] ca_bundle = dev/apps/ca-certs/cabundle-2019mar05.pem

Devido a diferenças na forma como os sistemas operacionais lidam com caminhos e escape de caracteres de caminho, o seguinte é um exemplo de configuração desse valor no arquivo config do Windows:

[default] ca_bundle = C:\\Users\\username\\.aws\\aws-custom-bundle.pem

Exemplo de configuração de variáveis de ambiente para Linux/macOS por meio da linha de comando:

export AWS_CA_BUNDLE=/dev/apps/ca-certs/cabundle-2019mar05.pem

Exemplo do Windows de configuração de variáveis de ambiente por meio da linha de comando:

setx AWS_CA_BUNDLE C:\dev\apps\ca-certs\cabundle-2019mar05.pem
output: configuração de arquivo config da AWS compartilhado

Especifica como os resultados são formatados na AWS CLI e em outros AWS SDKs e ferramentas.

Valor padrão: json

Valores válidos:

  • json: a saída é formatada como uma string JSON.

  • yaml: a saída é formatada como uma string YAML.

  • yaml-stream: a saída é transmitida e formatada como uma string YAML. A transmissão possibilita um manuseio mais rápido de tipos de dados grandes.

  • text – a saída é formatada como várias linhas de valores de string separados por tabulação. Isso pode ser útil para passar a saída para um processador de texto, como grep, sed ou awk.

  • table – a saída é formatada como uma tabela usando os caracteres +|- para formar as bordas da célula. Geralmente, a informação é apresentada em um formato "amigável", que é muito mais fácil de ler do que outros, mas não tão útil programaticamente.

parameter_validation: configuração de arquivo config da AWS compartilhado

Especifica se o SDK ou a ferramenta tentará validar os parâmetros da linha de comando antes de enviá-los para o endpoint de serviço da AWS.

Valor padrão: true

Valores válidos:

  • true – O padrão. O SDK ou a ferramenta executa validação de parâmetros da linha de comando no lado do cliente. Isso ajuda o SDK ou a ferramenta a confirmar se os parâmetros são válidos e a detectar alguns erros. O SDK ou a ferramenta podem rejeitar solicitações que não sejam válidas antes de enviar solicitações para o endpoint do serviço da AWS.

  • false: o SDK ou a ferramenta não valida parâmetros da linha de comando antes de enviá-los para o endpoint de serviço da AWS. O endpoint do serviço da AWS é responsável por validar todas as solicitações e rejeitar solicitações que não sejam válidas.

Compatibilidade com SDKs e ferramentas da AWS

Os SDKs a seguir são compatíveis com os recursos e configurações descritos neste tópico. Quaisquer exceções parciais estão anotadas. As configurações de propriedade do sistema de JVM são compatíveis apenas como o AWS SDK para Java e o AWS SDK para Kotlin.

SDK Compatível Notas ou mais informações
AWS CLI v2 da2 Parcial api_versions incompatível.
SDK para C++ Sim
SDK para Go V2 (1.x) Parcial api_versions e parameter_validation não são compatíveis.
SDK para Go 1.x (V1) Parcial api_versions e parameter_validation não são compatíveis. Para usar as configurações config do arquivo compartilhado, você deve ativar o carregamento do arquivo de configuração; consulte Sessões.
SDK para Java 2.x Não
SDK para Java 1.x Não
SDK para JavaScript 3.x Sim
SDK para JavaScript 2.x Sim
SDK para Kotlin Não
SDK para .NET 4.x Não
SDK para .NET 3.x Não
SDK para PHP 3.x Sim
SDK para Python (Boto3) Sim
SDK para Ruby 3.x Sim
SDK para Rust Não
SDK para Swift Não
Ferramentas para PowerShell V5 Não
Ferramentas para PowerShell V4 Não