Definições gerais da configuração

SDKssuportam algumas configurações gerais que definem SDK comportamentos gerais.

Configure essa funcionalidade usando o seguinte:

api_versions- compartilhado AWS configconfiguração de arquivo

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

Valor padrão: Nenhum. (A API versão mais recente é usada peloSDK.)

Valores válidos: essa é uma configuração aninhada seguida por uma ou mais linhas recuadas, cada uma identificando uma AWS serviço e a API versão a ser usada. Veja a documentação do AWS serviço para entender quais API versões estão disponíveis.

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

api_versions =
    ec2 = 2015-03-01
    cloudfront = 2015-09-017

ca_bundle- compartilhado AWS configconfiguração de arquivo

AWS_CA_BUNDLE: variável de ambiente

Especifica o caminho para um pacote de certificados personalizado (um arquivo com uma .pem extensão) 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 às diferenças na forma como os sistemas operacionais manipulam caminhos e escapam de caracteres de caminho, o seguinte é um exemplo de como definir esse valor no config arquivo no 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- compartilhado AWS configconfiguração de arquivo

Especifica como os resultados são formatados no AWS CLI e outros AWS SDKse ferramentas.

Valor padrão: json

Valores válidos:

• json— A saída é formatada como uma JSONstring.

• yaml— A saída é formatada como uma YAMLstring.

• yaml-stream— A saída é transmitida e formatada como uma YAMLstring. 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- compartilhado AWS configconfiguração de arquivo

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

Valor padrão: true

Valores válidos:

• true – O padrão. A ferramenta SDK or executa a validação dos parâmetros da linha de comando no lado do cliente. Isso ajuda a ferramenta SDK or a confirmar que os parâmetros são válidos e detecta alguns erros. A ferramenta SDK or pode rejeitar solicitações que não são válidas antes de enviar solicitações para o AWS ponto final do serviço.

• false— A ferramenta SDK or não valida os parâmetros da linha de comando antes de enviá-los para o AWS ponto final do serviço. A ferramenta AWS o endpoint de serviço é responsável por validar todas as solicitações e rejeitar solicitações que não são válidas.

Compatibilidade com AWS SDKs

Os itens a seguir SDKs oferecem suporte aos recursos e configurações descritos neste tópico. Quaisquer exceções parciais estão anotadas. Todas as configurações de propriedade do JVM sistema são suportadas pelo AWS SDK for Java e o AWS SDK para Kotlin somente.

SDK	Compatível	Notas ou mais informações
AWS CLI v2	Parcial	api_versions incompatível.
SDKpara C++	Sim
SDKpara Go V2 (1.x)	Parcial	api_versions e parameter_validation não são compatíveis.
SDKpara 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.
SDKpara Java 2.x	Não
SDKpara Java 1.x	Não
SDKpara JavaScript 3.x	Sim
SDKpara JavaScript 2.x	Sim
SDKpara Kotlin	Não
SDKpara. NET3.x	Não
SDKpara PHP 3.x	Sim
SDKpara Python (Boto3)	Sim
SDKpara Ruby 3.x	Sim
SDKpara Rust	Não
SDKpara Swift	Não
Ferramentas para PowerShell	Não