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 arquivoconfigda 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_versionsem 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-01cloudfront =2015-09-017 ca_bundle: configuração de arquivoconfigda AWS compartilhadoAWS_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.pemDevido 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
configdo Windows:[default] ca_bundle =C:\\Users\\username\\.aws\\aws-custom-bundle.pemExemplo 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.pemExemplo do Windows de configuração de variáveis de ambiente por meio da linha de comando:
setx AWS_CA_BUNDLEC:\dev\apps\ca-certs\cabundle-2019mar05.pem output: configuração de arquivoconfigda AWS compartilhado-
Especifica como os resultados são formatados na AWS CLI e em outros AWS SDKs e ferramentas.
Valor padrão:
jsonValores válidos:
-
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, comogrep,sedouawk. -
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 arquivoconfigda 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:
trueValores 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 |