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á.
# AWS SDKs referência de configurações e ferramentas
SDKs forneça um idioma específico para APIs . Serviços da AWS Eles cuidam de parte do trabalho pesado necessário para fazer chamadas de API com sucesso, incluindo autenticação, comportamento de repetição e muito mais. Para fazer isso, eles SDKs têm estratégias flexíveis para obter credenciais para usar em suas solicitações, manter as configurações a serem usadas com cada serviço e obter valores a serem usados nas configurações globais.
Você pode encontrar informações detalhadas sobre ajustes de configuração nas seguintes seções:
+ [AWS SDKs e ferramentas: provedores de credenciais padronizados](standardized-credentials.md)— Provedores de credenciais comuns padronizados em vários. SDKs
+ [AWS SDKs e ferramentas, recursos padronizados](standardized-features.md)— Recursos comuns padronizados em vários SDKs.
## Criar clientes de serviço
Para acessar programaticamente Serviços da AWS, SDKs use um cliente class/object para cada um. AWS service (Serviço da AWS) Por exemplo, se seu aplicativo precisa acessar a Amazon EC2, seu aplicativo cria um objeto EC2 cliente da Amazon para interagir com esse serviço. Em seguida, você usa o cliente de serviço para fazer solicitações para esse AWS service (Serviço da AWS). Na maioria das vezes SDKs, um objeto de cliente de serviço é imutável, então você deve criar um novo cliente para cada serviço para o qual você faz solicitações e para fazer solicitações ao mesmo serviço usando uma configuração diferente.
## Precedência de configurações
As configurações globais definem recursos, provedores de credenciais e outras funcionalidades que são suportadas pela maioria SDKs e têm um amplo impacto em todas Serviços da AWS as áreas. Todos SDKs têm uma série de lugares (ou fontes) que eles verificam para encontrar um valor para as configurações globais. A seguir está a configuração da precedência de pesquisa:
1. Qualquer configuração explícita definida no código ou no próprio cliente de serviço tem precedência sobre qualquer outra coisa.
+ Algumas configurações podem ser definidas por operação e podem ser alteradas conforme necessário para cada operação que você invocar. Para o AWS CLI ou Ferramentas da AWS para PowerShell, eles assumem a forma de parâmetros por operação que você insere na linha de comando. Para um SDK, as atribuições explícitas podem assumir a forma de um parâmetro que você define ao instanciar um AWS service (Serviço da AWS) cliente ou objeto de configuração ou, às vezes, ao chamar uma API individual.
1. Java/Kotlin apenas: a propriedade do sistema de JVM para a configuração é verificada. Se estiver definida esse valor será usado para configurar o cliente.
1. A variável de ambiente está marcada. Se estiver definida esse valor será usado para configurar o cliente.
1. O SDK verifica a configuração no arquivo compartilhado `credentials`. Se estiver definida, o cliente a usará.
1. O arquivo compartilhado `config` para a configuração. Se a configuração estiver presente, o SDK a usará.
+ A variável de ambiente `AWS_PROFILE` ou a propriedade do sistema de JVM `aws.profile` podem ser usadas para personalizar o perfil que o SDK carrega.
1. Qualquer valor padrão fornecido pelo próprio código-fonte do SDK é usado por último.
**nota**
Algumas ferramentas SDKs e ferramentas podem ser verificadas em uma ordem diferente. Além disso, algumas SDKs ferramentas oferecem suporte a outros métodos de armazenamento e recuperação de parâmetros. Por exemplo, o AWS SDK para .NET suporta uma fonte adicional chamada [SDK Store](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/sdk-store.html). Para obter mais informações sobre provedores exclusivos de um SDK ou ferramenta, consulte o guia específico do SDK ou da ferramenta que você está usando.
A ordem determina quais métodos têm precedência e substituem outros. Por exemplo, se você configurar um perfil no arquivo `config` compartilhado, ele só será encontrado e usado depois que o SDK ou a ferramenta verificarem primeiro os outros lugares. Isso significa que, se você colocar uma configuração no arquivo `credentials`, ela será usada em vez de uma encontrada no arquivo `config`. Se você configurar uma variável de ambiente com uma configuração e um valor, ela substituirá essa configuração nos arquivos `credentials` e `config`. E, finalmente, uma configuração na operação individual (parâmetro da API ou parâmetro da linha de comando da AWS CLI ) ou no código substituiria todos os outros valores desse comando.
## Entender as páginas de configurações deste guia
As páginas na seção **Referência de configurações** deste guia detalham as configurações disponíveis que podem ser definidas por vários mecanismos. As tabelas a seguir listam as configurações do arquivo de configuração e credencial, as variáveis de ambiente e (para Java e Kotlin SDKs) as configurações da JVM que podem ser usadas fora do seu código para configurar o recurso. Cada tópico vinculado em cada lista leva você à página de configurações correspondente.
+ [Lista de configurações de arquivo `Config`](#ConfigFileSettings)
+ [Lista de configurações de arquivo `Credentials`](#CredFileSettings)
+ [Lista de variáveis de ambiente](#EVarSettings)
+ [Lista de propriedades de sistema de JVM](#JVMSettings)
Cada provedor ou atributo de credenciais tem uma página na qual são listadas as configurações usadas para definir essa funcionalidade. Para cada configuração, geralmente você pode definir o valor adicionando a configuração a um arquivo de configuração ou definindo uma variável de ambiente ou (para Java e Kotlin apenas) definindo uma propriedade do sistema de JVM. Cada configuração lista todos os métodos compatíveis de definição do valor em um bloco acima dos detalhes da descrição. Embora a [precedência](#precedenceOfSettings) varie, a funcionalidade resultante é a mesma, independentemente de como é definida.
A descrição incluirá o valor padrão, se houver, que entrará em vigor se você não fizer nada. Ela também define o que é um valor válido para essa configuração.
Por exemplo, vejamos uma configuração da página do atributo [Compactação de solicitações](feature-compression.md).
As informações do exemplo de configuração `disable_request_compression` documentam o seguinte:
+ Há três maneiras equivalentes de controlar a compactação de solicitações fora da base de código. Você também pode:
+ Defini-la no arquivo de configuração usando `disable_request_compression`
+ Defini-la como uma variável de ambiente usando `AWS_DISABLE_REQUEST_COMPRESSION`
+ Ou, se você estiver usando o SDK do Java ou Kotlin, defina-a como uma propriedade do sistema de JVM usando `aws.disableRequestCompression`
**nota**
Pode haver também uma maneira de configurar a mesma funcionalidade diretamente no código, mas esta referência não trata disso, pois ela é específica para cada SDK. Se você quiser definir a configuração no código em si, consulte o guia específico do SDK ou a referência de API.
+ Se você não fizer nada, o valor padrão será `false`.
+ Os únicos valores válidos para essa configuração booleana são `true` e `false`.
Na parte inferior da página de cada recurso, há uma tabela de **ferramentas AWS SDKs e Support by**.
Essa tabela mostra se o SDK é compatível com as configurações listadas na página. A coluna `Supported` indica o nível de compatibilidade com os seguintes valores:
+ `Yes`: as configurações são totalmente compatíveis com o SDK conforme escrito.
+ `Partial`: algumas das configurações são compatíveis ou o comportamento se desvia da descrição. Para `Partial`, uma nota adicional indica o desvio.
+ `No`: nenhuma das configurações é compatível. Isso não significa que a mesma funcionalidade pode ser alcançada em código, indica apenas que as configurações externas listadas não são compatíveis.
## Lista de configurações de arquivo `Config`
As configurações listadas na tabela a seguir podem ser atribuídas no AWS `config` arquivo compartilhado. Eles são globais e afetam a todos Serviços da AWS. SDKs e as ferramentas também podem oferecer suporte a configurações e variáveis de ambiente exclusivas. Para ver as configurações e as variáveis de ambiente compatíveis apenas com um SDK ou uma ferramenta individual, consulte o guia específica do SDK ou da ferramenta.
| Nome da configuração | Detalhes |
| --- | --- |
| account\_id\_endpoint\_mode | [Endpoints baseados em contas](feature-account-endpoints.md) |
| api\_versions | [Definições gerais de configuração](feature-gen-config.md) |
| auth\_scheme\_preference | [Esquema de autenticação](feature-auth-scheme.md) |
| aws\_access\_key\_id | [AWS teclas de acesso](feature-static-credentials.md) |
| aws\_account\_id | [Endpoints baseados em contas](feature-account-endpoints.md) |
| aws\_secret\_access\_key | [AWS teclas de acesso](feature-static-credentials.md) |
| aws\_session\_token | [AWS teclas de acesso](feature-static-credentials.md) |
| ca\_bundle | [Definições gerais de configuração](feature-gen-config.md) |
| credential\_process | [Provedor de credenciais de processo](feature-process-credentials.md) |
| credential\_source | [Assuma a função de provedor de credenciais](feature-assume-role-credentials.md) |
| defaults\_mode | [Padrões de configuração inteligente](feature-smart-config-defaults.md) |
| disable\_host\_prefix\_injection | [Injeção de prefixo de host](feature-host-prefix.md) |
| disable\_request\_compression | [Compactação de solicitações](feature-compression.md) |
| duration\_seconds | [Assuma a função de provedor de credenciais](feature-assume-role-credentials.md) |
| ec2\_metadata\_service\_endpoint | [Provedor de credenciais IMDS](feature-imds-credentials.md) |
| ec2\_metadata\_service\_endpoint\_mode | [Provedor de credenciais IMDS](feature-imds-credentials.md) |
| ec2\_metadata\_v1\_disabled | [Provedor de credenciais IMDS](feature-imds-credentials.md) |
| endpoint\_discovery\_enabled | [Descoberta de endpoint](feature-endpoint-discovery.md) |
| endpoint\_url | [Endpoints específicos de serviço](feature-ss-endpoints.md) |
| external\_id | [Assuma a função de provedor de credenciais](feature-assume-role-credentials.md) |
| ignore\_configured\_endpoint\_urls | [Endpoints específicos de serviço](feature-ss-endpoints.md) |
| max\_attempts | [Comportamento de repetição](feature-retry-behavior.md) |
| metadata\_service\_num\_attempts | [Metadados da EC2 instância Amazon](feature-ec2-instance-metadata.md) |
| metadata\_service\_timeout | [Metadados da EC2 instância Amazon](feature-ec2-instance-metadata.md) |
| mfa\_serial | [Assuma a função de provedor de credenciais](feature-assume-role-credentials.md) |
| output | [Definições gerais de configuração](feature-gen-config.md) |
| parameter\_validation | [Definições gerais de configuração](feature-gen-config.md) |
| region | [Região da AWS](feature-region.md) |
| request\_checksum\_calculation | [Proteções de integridade de dados para o Amazon S3](feature-dataintegrity.md) |
| request\_min\_compression\_size\_bytes | [Compactação de solicitações](feature-compression.md) |
| response\_checksum\_validation | [Proteções de integridade de dados para o Amazon S3](feature-dataintegrity.md) |
| retry\_mode | [Comportamento de repetição](feature-retry-behavior.md) |
| role\_arn | [Assuma a função de provedor de credenciais](feature-assume-role-credentials.md) |
| role\_session\_name | [Assuma a função de provedor de credenciais](feature-assume-role-credentials.md) |
| s3\_disable\_express\_session\_auth | [Autenticação de sessão da S3 Express One Zone](feature-s3-express.md) |
| s3\_disable\_multiregion\_access\_points | [Pontos de acesso de várias regiões do Amazon S3](feature-s3-mrap.md) |
| s3\_use\_arn\_region | [Pontos de acesso Amazon S3](feature-s3-access-point.md) |
| sdk\_ua\_app\_id | [ID do aplicativo](feature-appid.md) |
| sigv4a\_signing\_region\_set | [Esquema de autenticação](feature-auth-scheme.md) |
| source\_profile | [Assuma a função de provedor de credenciais](feature-assume-role-credentials.md) |
| sso\_account\_id | [Provedor de credenciais do IAM Identity Center](feature-sso-credentials.md) |
| sso\_region | [Provedor de credenciais do IAM Identity Center](feature-sso-credentials.md) |
| sso\_registration\_scopes | [Provedor de credenciais do IAM Identity Center](feature-sso-credentials.md) |
| sso\_role\_name | [Provedor de credenciais do IAM Identity Center](feature-sso-credentials.md) |
| sso\_start\_url | [Provedor de credenciais do IAM Identity Center](feature-sso-credentials.md) |
| sts\_regional\_endpoints | [AWS STS Endpoints regionais](feature-sts-regionalized-endpoints.md) |
| use\_dualstack\_endpoint | [Endpoints de pilha dupla e FIPS](feature-endpoints.md) |
| use\_fips\_endpoint | [Endpoints de pilha dupla e FIPS](feature-endpoints.md) |
| web\_identity\_token\_file | [Assuma a função de provedor de credenciais](feature-assume-role-credentials.md) |
## Lista de configurações de arquivo `Credentials`
As configurações listadas na tabela a seguir podem ser atribuídas no AWS `credentials` arquivo compartilhado. Eles são globais e afetam a todos Serviços da AWS. SDKs e as ferramentas também podem oferecer suporte a configurações e variáveis de ambiente exclusivas. Para ver as configurações e as variáveis de ambiente compatíveis apenas com um SDK ou uma ferramenta individual, consulte o guia específica do SDK ou da ferramenta.
| Nome da configuração | Detalhes |
| --- | --- |
| aws\_access\_key\_id | [AWS teclas de acesso](feature-static-credentials.md) |
| aws\_secret\_access\_key | [AWS teclas de acesso](feature-static-credentials.md) |
| aws\_session\_token | [AWS teclas de acesso](feature-static-credentials.md) |
## Lista de variáveis de ambiente
As variáveis de ambiente suportadas pela maioria SDKs estão listadas na tabela a seguir. Eles são globais e afetam a todos Serviços da AWS. SDKs e as ferramentas também podem oferecer suporte a configurações e variáveis de ambiente exclusivas. Para ver as configurações e as variáveis de ambiente compatíveis apenas com um SDK ou uma ferramenta individual, consulte o guia específica do SDK ou da ferramenta.
| Nome da configuração | Detalhes |
| --- | --- |
| AWS\_ACCESS\_KEY\_ID | [AWS teclas de acesso](feature-static-credentials.md) |
| AWS\_ACCOUNT\_ID | [Endpoints baseados em contas](feature-account-endpoints.md) |
| AWS\_ACCOUNT\_ID\_ENDPOINT\_MODE | [Endpoints baseados em contas](feature-account-endpoints.md) |
| AWS\_AUTH\_SCHEME\_PREFERENCE | [Esquema de autenticação](feature-auth-scheme.md) |
| AWS\_CA\_BUNDLE | [Definições gerais de configuração](feature-gen-config.md) |
| AWS\_CONFIG\_FILE | [Localizando e alterando a localização dos arquivos compartilhados, dos `credentials` arquivos `config`AWS SDKs e das ferramentas](file-location.md) |
| AWS\_CONTAINER\_AUTHORIZATION\_TOKEN | [Provedor de credenciais de contêiner](feature-container-credentials.md) |
| AWS\_CONTAINER\_AUTHORIZATION\_TOKEN\_FILE | [Provedor de credenciais de contêiner](feature-container-credentials.md) |
| AWS\_CONTAINER\_CREDENTIALS\_FULL\_URI | [Provedor de credenciais de contêiner](feature-container-credentials.md) |
| AWS\_CONTAINER\_CREDENTIALS\_RELATIVE\_URI | [Provedor de credenciais de contêiner](feature-container-credentials.md) |
| AWS\_DEFAULTS\_MODE | [Padrões de configuração inteligente](feature-smart-config-defaults.md) |
| AWS\_DISABLE\_HOST\_PREFIX\_INJECTION | [Injeção de prefixo de host](feature-host-prefix.md) |
| AWS\_DISABLE\_REQUEST\_COMPRESSION | [Compactação de solicitações](feature-compression.md) |
| AWS\_EC2\_METADATA\_DISABLED | [Provedor de credenciais IMDS](feature-imds-credentials.md) |
| AWS\_EC2\_METADATA\_SERVICE\_ENDPOINT | [Provedor de credenciais IMDS](feature-imds-credentials.md) |
| AWS\_EC2\_METADATA\_SERVICE\_ENDPOINT\_MODE | [Provedor de credenciais IMDS](feature-imds-credentials.md) |
| AWS\_EC2\_METADATA\_V1\_DISABLED | [Provedor de credenciais IMDS](feature-imds-credentials.md) |
| AWS\_ENABLE\_ENDPOINT\_DISCOVERY | [Descoberta de endpoint](feature-endpoint-discovery.md) |
| AWS\_ENDPOINT\_URL | [Endpoints específicos de serviço](feature-ss-endpoints.md) |
| AWS\_ENDPOINT\_URL\_ | [Endpoints específicos de serviço](feature-ss-endpoints.md) |
| AWS\_IGNORE\_CONFIGURED\_ENDPOINT\_URLS | [Endpoints específicos de serviço](feature-ss-endpoints.md) |
| AWS\_MAX\_ATTEMPTS | [Comportamento de repetição](feature-retry-behavior.md) |
| AWS\_METADATA\_SERVICE\_NUM\_ATTEMPTS | [Metadados da EC2 instância Amazon](feature-ec2-instance-metadata.md) |
| AWS\_METADATA\_SERVICE\_TIMEOUT | [Metadados da EC2 instância Amazon](feature-ec2-instance-metadata.md) |
| AWS\_PROFILE | [Usando `credentials` arquivos `config` e arquivos compartilhados para configurar AWS SDKs e ferramentas globalmente](file-format.md) |
| AWS\_REGION | [Região da AWS](feature-region.md) |
| AWS\_REQUEST\_CHECKSUM\_CALCULATION | [Proteções de integridade de dados para o Amazon S3](feature-dataintegrity.md) |
| AWS\_REQUEST\_MIN\_COMPRESSION\_SIZE\_BYTES | [Compactação de solicitações](feature-compression.md) |
| AWS\_RESPONSE\_CHECKSUM\_VALIDATION | [Proteções de integridade de dados para o Amazon S3](feature-dataintegrity.md) |
| AWS\_RETRY\_MODE | [Comportamento de repetição](feature-retry-behavior.md) |
| AWS\_ROLE\_ARN | [Assuma a função de provedor de credenciais](feature-assume-role-credentials.md) |
| AWS\_ROLE\_SESSION\_NAME | [Assuma a função de provedor de credenciais](feature-assume-role-credentials.md) |
| AWS\_S3\_DISABLE\_EXPRESS\_SESSION\_AUTH | [Autenticação de sessão da S3 Express One Zone](feature-s3-express.md) |
| AWS\_S3\_DISABLE\_MULTIREGION\_ACCESS\_POINTS | [Pontos de acesso de várias regiões do Amazon S3](feature-s3-mrap.md) |
| AWS\_S3\_USE\_ARN\_REGION | [Pontos de acesso Amazon S3](feature-s3-access-point.md) |
| AWS\_SDK\_UA\_APP\_ID | [ID do aplicativo](feature-appid.md) |
| AWS\_SECRET\_ACCESS\_KEY | [AWS teclas de acesso](feature-static-credentials.md) |
| AWS\_SESSION\_TOKEN | [AWS teclas de acesso](feature-static-credentials.md) |
| AWS\_SHARED\_CREDENTIALS\_FILE | [Localizando e alterando a localização dos arquivos compartilhados, dos `credentials` arquivos `config`AWS SDKs e das ferramentas](file-location.md) |
| AWS\_SIGV4A\_SIGNING\_REGION\_SET | [Esquema de autenticação](feature-auth-scheme.md) |
| AWS\_STS\_REGIONAL\_ENDPOINTS | [AWS STS Endpoints regionais](feature-sts-regionalized-endpoints.md) |
| AWS\_USE\_DUALSTACK\_ENDPOINT | [Endpoints de pilha dupla e FIPS](feature-endpoints.md) |
| AWS\_USE\_FIPS\_ENDPOINT | [Endpoints de pilha dupla e FIPS](feature-endpoints.md) |
| AWS\_WEB\_IDENTITY\_TOKEN\_FILE | [Assuma a função de provedor de credenciais](feature-assume-role-credentials.md) |
## Lista de propriedades de sistema de JVM
Você pode usar as seguintes propriedades do sistema JVM para o AWS SDK para Java e o AWS SDK para Kotlin (visando a JVM). Consulte [Como definir as propriedades do sistema em JVM](jvm-system-properties.md#jvm-sys-props-set) para obter instruções sobre como definir as propriedades de sistema de JVM.
| Nome da configuração | Detalhes |
| --- | --- |
| aws.accessKeyId | [AWS teclas de acesso](feature-static-credentials.md) |
| aws.accountId | [Endpoints baseados em contas](feature-account-endpoints.md) |
| aws.accountIdEndpointMode | [Endpoints baseados em contas](feature-account-endpoints.md) |
| aws.authSchemePreference | [Esquema de autenticação](feature-auth-scheme.md) |
| aws.configFile | [Localizando e alterando a localização dos arquivos compartilhados, dos `credentials` arquivos `config`AWS SDKs e das ferramentas](file-location.md) |
| aws.defaultsMode | [Padrões de configuração inteligente](feature-smart-config-defaults.md) |
| aws.disableEc2MetadataV1 | [Provedor de credenciais IMDS](feature-imds-credentials.md) |
| aws.disableHostPrefixInjection | [Injeção de prefixo de host](feature-host-prefix.md) |
| aws.disableRequestCompression | [Compactação de solicitações](feature-compression.md) |
| aws.disableS3ExpressAuth | [Autenticação de sessão da S3 Express One Zone](feature-s3-express.md) |
| aws.ec2MetadataServiceEndpoint | [Provedor de credenciais IMDS](feature-imds-credentials.md) |
| aws.ec2MetadataServiceEndpointMode | [Provedor de credenciais IMDS](feature-imds-credentials.md) |
| aws.endpointDiscoveryEnabled | [Descoberta de endpoint](feature-endpoint-discovery.md) |
| aws.endpointUrl | [Endpoints específicos de serviço](feature-ss-endpoints.md) |
| aws.endpointUrl | [Endpoints específicos de serviço](feature-ss-endpoints.md) |
| aws.ignoreConfiguredEndpointUrls | [Endpoints específicos de serviço](feature-ss-endpoints.md) |
| aws.maxAttempts | [Comportamento de repetição](feature-retry-behavior.md) |
| aws.profile | [Usando `credentials` arquivos `config` e arquivos compartilhados para configurar AWS SDKs e ferramentas globalmente](file-format.md) |
| aws.region | [Região da AWS](feature-region.md) |
| aws.requestChecksumCalculation | [Proteções de integridade de dados para o Amazon S3](feature-dataintegrity.md) |
| aws.requestMinCompressionSizeBytes | [Compactação de solicitações](feature-compression.md) |
| aws.responseChecksumValidation | [Proteções de integridade de dados para o Amazon S3](feature-dataintegrity.md) |
| aws.retryMode | [Comportamento de repetição](feature-retry-behavior.md) |
| aws.roleArn | [Assuma a função de provedor de credenciais](feature-assume-role-credentials.md) |
| aws.roleSessionName | [Assuma a função de provedor de credenciais](feature-assume-role-credentials.md) |
| aws.s3DisableMultiRegionAccessPoints | [Pontos de acesso de várias regiões do Amazon S3](feature-s3-mrap.md) |
| aws.s3UseArnRegion | [Pontos de acesso Amazon S3](feature-s3-access-point.md) |
| aws.secretAccessKey | [AWS teclas de acesso](feature-static-credentials.md) |
| aws.sessionToken | [AWS teclas de acesso](feature-static-credentials.md) |
| aws.sharedCredentialsFile | [Localizando e alterando a localização dos arquivos compartilhados, dos `credentials` arquivos `config`AWS SDKs e das ferramentas](file-location.md) |
| aws.useDualstackEndpoint | [Endpoints de pilha dupla e FIPS](feature-endpoints.md) |
| aws.useFipsEndpoint | [Endpoints de pilha dupla e FIPS](feature-endpoints.md) |
| aws.webIdentityTokenFile | [Assuma a função de provedor de credenciais](feature-assume-role-credentials.md) |
| sdk.ua.appId | [ID do aplicativo](feature-appid.md) |