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á.
Definições gerais da configuração
nota
Para obter ajuda na compreensão do layout das páginas de configurações ou na interpretação da tabela Support by AWS SDKs and tools a seguir, consulteEntendendo as páginas de configurações deste guia.
SDKs oferecem suporte a algumas configurações gerais que definem os comportamentos gerais do SDK.
Configure essa funcionalidade usando o seguinte:
api_versions
- configuração de AWSconfig
arquivo compartilhado-
Alguns AWS serviços 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: essa é uma configuração aninhada seguida por uma ou mais linhas recuadas, cada uma identificando um AWS serviço e a versão da API a ser usada. Consulte a documentação do AWS serviço para entender quais versões de API estão disponíveis.
O exemplo define uma versão específica da API para dois AWS serviços no
config
arquivo. 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 AWSconfig
arquivo 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.pem
Devido às diferenças na forma como os sistemas operacionais manipulam caminhos e escapam de caracteres de caminho, o seguinte é um exemplo de configuração desse 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
- configuração de AWSconfig
arquivo compartilhado-
Especifica como os resultados são formatados nas ferramentas AWS CLI e em outras AWS SDKs .
Valor padrão:
json
Valores 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
,sed
ouawk
. -
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 AWSconfig
arquivo 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 são válidas antes de enviar solicitações para o endpoint do AWS serviço. -
false
— O SDK ou a ferramenta não valida os parâmetros da linha de comando antes de enviá-los ao endpoint do AWS serviço. O endpoint do AWS serviço é responsável por validar todas as solicitações e rejeitar solicitações que não são válidas.
-
Support by AWS SDKs and tools
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 sistema JVM são suportadas pelo AWS SDK para Java e pelo AWS SDK para Kotlin único.
SDK | Compatível | Notas ou mais informações |
---|---|---|
AWS CLI v2 | 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 3.x JavaScript | Sim | |
SDK para 2.x JavaScript | Sim | |
SDK para Kotlin | 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 | Não |