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
<a name="settings-reference"></a>

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
<a name="creatingServiceClients"></a>

 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
<a name="precedenceOfSettings"></a>

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
<a name="settingsPages"></a>

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`
<a name="ConfigFileSettings"></a>

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\$1id\$1endpoint\$1mode  | [Endpoints baseados em contas](feature-account-endpoints.md)  | 
|  api\$1versions  | [Definições gerais de configuração](feature-gen-config.md)  | 
|  auth\$1scheme\$1preference  | [Esquema de autenticação](feature-auth-scheme.md)  | 
|  aws\$1access\$1key\$1id  | [AWS teclas de acesso](feature-static-credentials.md)  | 
|  aws\$1account\$1id  | [Endpoints baseados em contas](feature-account-endpoints.md)  | 
|  aws\$1secret\$1access\$1key  | [AWS teclas de acesso](feature-static-credentials.md)  | 
|  aws\$1session\$1token  | [AWS teclas de acesso](feature-static-credentials.md)  | 
|  ca\$1bundle  | [Definições gerais de configuração](feature-gen-config.md)  | 
|  credential\$1process  | [Provedor de credenciais de processo](feature-process-credentials.md)  | 
|  credential\$1source  | [Assuma a função de provedor de credenciais](feature-assume-role-credentials.md)  | 
|  defaults\$1mode  | [Padrões de configuração inteligente](feature-smart-config-defaults.md)  | 
|  disable\$1host\$1prefix\$1injection  | [Injeção de prefixo de host](feature-host-prefix.md)  | 
|  disable\$1request\$1compression  | [Compactação de solicitações](feature-compression.md)  | 
|  duration\$1seconds  | [Assuma a função de provedor de credenciais](feature-assume-role-credentials.md)  | 
|  ec2\$1metadata\$1service\$1endpoint  | [Provedor de credenciais IMDS](feature-imds-credentials.md)  | 
|  ec2\$1metadata\$1service\$1endpoint\$1mode  | [Provedor de credenciais IMDS](feature-imds-credentials.md)  | 
|  ec2\$1metadata\$1v1\$1disabled  | [Provedor de credenciais IMDS](feature-imds-credentials.md)  | 
|  endpoint\$1discovery\$1enabled  | [Descoberta de endpoint](feature-endpoint-discovery.md)  | 
|  endpoint\$1url  | [Endpoints específicos de serviço](feature-ss-endpoints.md)  | 
|  external\$1id  | [Assuma a função de provedor de credenciais](feature-assume-role-credentials.md)  | 
|  ignore\$1configured\$1endpoint\$1urls  | [Endpoints específicos de serviço](feature-ss-endpoints.md)  | 
|  max\$1attempts  | [Comportamento de repetição](feature-retry-behavior.md)  | 
|  metadata\$1service\$1num\$1attempts  | [Metadados da EC2 instância Amazon](feature-ec2-instance-metadata.md)  | 
|  metadata\$1service\$1timeout  | [Metadados da EC2 instância Amazon](feature-ec2-instance-metadata.md)  | 
|  mfa\$1serial  | [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\$1validation  | [Definições gerais de configuração](feature-gen-config.md)  | 
|  region  | [Região da AWS](feature-region.md)  | 
|  request\$1checksum\$1calculation  | [Proteções de integridade de dados para o Amazon S3](feature-dataintegrity.md)  | 
|  request\$1min\$1compression\$1size\$1bytes  | [Compactação de solicitações](feature-compression.md)  | 
|  response\$1checksum\$1validation  | [Proteções de integridade de dados para o Amazon S3](feature-dataintegrity.md)  | 
|  retry\$1mode  | [Comportamento de repetição](feature-retry-behavior.md)  | 
|  role\$1arn  | [Assuma a função de provedor de credenciais](feature-assume-role-credentials.md)  | 
|  role\$1session\$1name  | [Assuma a função de provedor de credenciais](feature-assume-role-credentials.md)  | 
|  s3\$1disable\$1express\$1session\$1auth  | [Autenticação de sessão da S3 Express One Zone](feature-s3-express.md)  | 
|  s3\$1disable\$1multiregion\$1access\$1points  | [Pontos de acesso de várias regiões do Amazon S3](feature-s3-mrap.md)  | 
|  s3\$1use\$1arn\$1region  | [Pontos de acesso Amazon S3](feature-s3-access-point.md)  | 
|  sdk\$1ua\$1app\$1id  | [ID do aplicativo](feature-appid.md)  | 
|  sigv4a\$1signing\$1region\$1set  | [Esquema de autenticação](feature-auth-scheme.md)  | 
|  source\$1profile  | [Assuma a função de provedor de credenciais](feature-assume-role-credentials.md)  | 
|  sso\$1account\$1id  | [Provedor de credenciais do IAM Identity Center](feature-sso-credentials.md)  | 
|  sso\$1region  | [Provedor de credenciais do IAM Identity Center](feature-sso-credentials.md)  | 
|  sso\$1registration\$1scopes  | [Provedor de credenciais do IAM Identity Center](feature-sso-credentials.md)  | 
|  sso\$1role\$1name  | [Provedor de credenciais do IAM Identity Center](feature-sso-credentials.md)  | 
|  sso\$1start\$1url  | [Provedor de credenciais do IAM Identity Center](feature-sso-credentials.md)  | 
|  sts\$1regional\$1endpoints  | [AWS STS Endpoints regionais](feature-sts-regionalized-endpoints.md)  | 
|  use\$1dualstack\$1endpoint  | [Endpoints de pilha dupla e FIPS](feature-endpoints.md)  | 
|  use\$1fips\$1endpoint  | [Endpoints de pilha dupla e FIPS](feature-endpoints.md)  | 
|  web\$1identity\$1token\$1file  | [Assuma a função de provedor de credenciais](feature-assume-role-credentials.md)  | 

## Lista de configurações de arquivo `Credentials`
<a name="CredFileSettings"></a>

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\$1access\$1key\$1id  | [AWS teclas de acesso](feature-static-credentials.md)  | 
|  aws\$1secret\$1access\$1key  | [AWS teclas de acesso](feature-static-credentials.md)  | 
|  aws\$1session\$1token  | [AWS teclas de acesso](feature-static-credentials.md)  | 

## Lista de variáveis de ambiente
<a name="EVarSettings"></a>

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\$1ACCESS\$1KEY\$1ID  | [AWS teclas de acesso](feature-static-credentials.md)  | 
|  AWS\$1ACCOUNT\$1ID  | [Endpoints baseados em contas](feature-account-endpoints.md)  | 
|  AWS\$1ACCOUNT\$1ID\$1ENDPOINT\$1MODE  | [Endpoints baseados em contas](feature-account-endpoints.md)  | 
|  AWS\$1AUTH\$1SCHEME\$1PREFERENCE  | [Esquema de autenticação](feature-auth-scheme.md)  | 
|  AWS\$1CA\$1BUNDLE  | [Definições gerais de configuração](feature-gen-config.md)  | 
|  AWS\$1CONFIG\$1FILE  | [Localizando e alterando a localização dos arquivos compartilhados, dos `credentials` arquivos `config`AWS SDKs e das ferramentas](file-location.md)  | 
|  AWS\$1CONTAINER\$1AUTHORIZATION\$1TOKEN  | [Provedor de credenciais de contêiner](feature-container-credentials.md)  | 
|  AWS\$1CONTAINER\$1AUTHORIZATION\$1TOKEN\$1FILE  | [Provedor de credenciais de contêiner](feature-container-credentials.md)  | 
|  AWS\$1CONTAINER\$1CREDENTIALS\$1FULL\$1URI  | [Provedor de credenciais de contêiner](feature-container-credentials.md)  | 
|  AWS\$1CONTAINER\$1CREDENTIALS\$1RELATIVE\$1URI  | [Provedor de credenciais de contêiner](feature-container-credentials.md)  | 
|  AWS\$1DEFAULTS\$1MODE  | [Padrões de configuração inteligente](feature-smart-config-defaults.md)  | 
|  AWS\$1DISABLE\$1HOST\$1PREFIX\$1INJECTION  | [Injeção de prefixo de host](feature-host-prefix.md)  | 
|  AWS\$1DISABLE\$1REQUEST\$1COMPRESSION  | [Compactação de solicitações](feature-compression.md)  | 
|  AWS\$1EC2\$1METADATA\$1DISABLED  | [Provedor de credenciais IMDS](feature-imds-credentials.md)  | 
|  AWS\$1EC2\$1METADATA\$1SERVICE\$1ENDPOINT  | [Provedor de credenciais IMDS](feature-imds-credentials.md)  | 
|  AWS\$1EC2\$1METADATA\$1SERVICE\$1ENDPOINT\$1MODE  | [Provedor de credenciais IMDS](feature-imds-credentials.md)  | 
|  AWS\$1EC2\$1METADATA\$1V1\$1DISABLED  | [Provedor de credenciais IMDS](feature-imds-credentials.md)  | 
|  AWS\$1ENABLE\$1ENDPOINT\$1DISCOVERY  | [Descoberta de endpoint](feature-endpoint-discovery.md)  | 
|  AWS\$1ENDPOINT\$1URL  | [Endpoints específicos de serviço](feature-ss-endpoints.md)  | 
|  AWS\$1ENDPOINT\$1URL\$1<SERVICE>  | [Endpoints específicos de serviço](feature-ss-endpoints.md)  | 
|  AWS\$1IGNORE\$1CONFIGURED\$1ENDPOINT\$1URLS  | [Endpoints específicos de serviço](feature-ss-endpoints.md)  | 
|  AWS\$1MAX\$1ATTEMPTS  | [Comportamento de repetição](feature-retry-behavior.md)  | 
|  AWS\$1METADATA\$1SERVICE\$1NUM\$1ATTEMPTS  | [Metadados da EC2 instância Amazon](feature-ec2-instance-metadata.md)  | 
|  AWS\$1METADATA\$1SERVICE\$1TIMEOUT  | [Metadados da EC2 instância Amazon](feature-ec2-instance-metadata.md)  | 
|  AWS\$1PROFILE  | [Usando `credentials` arquivos `config` e arquivos compartilhados para configurar AWS SDKs e ferramentas globalmente](file-format.md)  | 
|  AWS\$1REGION  | [Região da AWS](feature-region.md)  | 
|  AWS\$1REQUEST\$1CHECKSUM\$1CALCULATION  | [Proteções de integridade de dados para o Amazon S3](feature-dataintegrity.md)  | 
|  AWS\$1REQUEST\$1MIN\$1COMPRESSION\$1SIZE\$1BYTES  | [Compactação de solicitações](feature-compression.md)  | 
|  AWS\$1RESPONSE\$1CHECKSUM\$1VALIDATION  | [Proteções de integridade de dados para o Amazon S3](feature-dataintegrity.md)  | 
|  AWS\$1RETRY\$1MODE  | [Comportamento de repetição](feature-retry-behavior.md)  | 
|  AWS\$1ROLE\$1ARN  | [Assuma a função de provedor de credenciais](feature-assume-role-credentials.md)  | 
|  AWS\$1ROLE\$1SESSION\$1NAME  | [Assuma a função de provedor de credenciais](feature-assume-role-credentials.md)  | 
|  AWS\$1S3\$1DISABLE\$1EXPRESS\$1SESSION\$1AUTH  | [Autenticação de sessão da S3 Express One Zone](feature-s3-express.md)  | 
|  AWS\$1S3\$1DISABLE\$1MULTIREGION\$1ACCESS\$1POINTS  | [Pontos de acesso de várias regiões do Amazon S3](feature-s3-mrap.md)  | 
|  AWS\$1S3\$1USE\$1ARN\$1REGION  | [Pontos de acesso Amazon S3](feature-s3-access-point.md)  | 
|  AWS\$1SDK\$1UA\$1APP\$1ID  | [ID do aplicativo](feature-appid.md)  | 
|  AWS\$1SECRET\$1ACCESS\$1KEY  | [AWS teclas de acesso](feature-static-credentials.md)  | 
|  AWS\$1SESSION\$1TOKEN  | [AWS teclas de acesso](feature-static-credentials.md)  | 
|  AWS\$1SHARED\$1CREDENTIALS\$1FILE  | [Localizando e alterando a localização dos arquivos compartilhados, dos `credentials` arquivos `config`AWS SDKs e das ferramentas](file-location.md)  | 
|  AWS\$1SIGV4A\$1SIGNING\$1REGION\$1SET  | [Esquema de autenticação](feature-auth-scheme.md)  | 
|  AWS\$1STS\$1REGIONAL\$1ENDPOINTS  | [AWS STS Endpoints regionais](feature-sts-regionalized-endpoints.md)  | 
|  AWS\$1USE\$1DUALSTACK\$1ENDPOINT  | [Endpoints de pilha dupla e FIPS](feature-endpoints.md)  | 
|  AWS\$1USE\$1FIPS\$1ENDPOINT  | [Endpoints de pilha dupla e FIPS](feature-endpoints.md)  | 
|  AWS\$1WEB\$1IDENTITY\$1TOKEN\$1FILE  | [Assuma a função de provedor de credenciais](feature-assume-role-credentials.md)  | 

## Lista de propriedades de sistema de JVM
<a name="JVMSettings"></a>

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<ServiceName>  | [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)  | 

# AWS SDKs e ferramentas: provedores de credenciais padronizados
<a name="standardized-credentials"></a>

Muitos provedores de credenciais foram padronizados para padrões consistentes e para funcionar da mesma forma em muitos. SDKs Essa consistência aumenta a produtividade e a clareza ao codificar em vários SDKs. Todas as configurações podem ser substituídas no código. Para obter detalhes, consulte a API específica de seu SDK.

**Importante**  
Nem todos SDKs oferecem suporte a todos os fornecedores, ou mesmo a todos os aspectos de um provedor.

**Topics**
+ [

## Entender a cadeia de provedores de credenciais
](#credentialProviderChain)
+ [

## Cadeias de provedores de credenciais específicas do SDK e da ferramenta
](#sdk-chains)
+ [AWS teclas de acesso](feature-static-credentials.md)
+ [Provedor de login](feature-login-credentials.md)
+ [Assuma o provedor de perfil](feature-assume-role-credentials.md)
+ [Provedor de contêiner](feature-container-credentials.md)
+ [Provedor do IAM Identity Center](feature-sso-credentials.md)
+ [Provedor de IMDS](feature-imds-credentials.md)
+ [Provedor de processo](feature-process-credentials.md)

## Entender a cadeia de provedores de credenciais
<a name="credentialProviderChain"></a>

Todos SDKs têm uma série de locais (ou fontes) que eles verificam para encontrar credenciais válidas para usar para fazer uma solicitação a um AWS service (Serviço da AWS). Depois que as credenciais válidas são encontradas, a pesquisa é interrompida. Essa busca sistemática é denominada cadeia de provedores de credenciais. 

Ao usar um dos provedores de credenciais padronizados, eles AWS SDKs sempre tentam renovar as credenciais automaticamente quando elas expiram. A cadeia de provedores de credenciais integrada fornece à aplicação a capacidade de atualizar suas credenciais, independentemente do provedor que você está usando na cadeia. Nenhum código adicional é necessário para que o SDK faça isso.

Embora a cadeia distinta usada por cada SDK varie, elas geralmente incluem fontes como as seguintes:


| Provedor de credencial | Description | 
| --- | --- | 
| [AWS teclas de acesso](feature-static-credentials.md) | AWS chaves de acesso para um usuário do IAM (como AWS\$1ACCESS\$1KEY\$1ID eAWS\$1SECRET\$1ACCESS\$1KEY).  | 
| [Federar com identidade da Web ou OpenID Connect](access-assume-role-web.md#webidentity): assumir a função de provedor de credenciais | Fazer login usando um provedor de identidades (IdP) externo conhecido, como Login with Amazon, Facebook, Google ou qualquer outro IdP compatível com OpenID Connect (OIDC). Assuma as permissões de uma função do IAM usando um JSON Web Token (JWT) de AWS Security Token Service (AWS STS). | 
| [Provedor de credenciais de login](feature-login-credentials.md)  | Obtenha credenciais para uma sessão de console nova ou existente na qual você está conectado. | 
| [Provedor de credencial do IAM Identity Center](feature-sso-credentials.md) | Obtenha credenciais de Centro de Identidade do AWS IAM. | 
| [Assuma o perfil de provedor de credenciais](feature-assume-role-credentials.md) | Tenha acesso a outros recursos assumindo as permissões de um perfil do IAM. (Recupere e use credenciais temporárias para uma função). | 
| [Provedor de credenciais de contêiner](feature-container-credentials.md) | Credenciais do Amazon Elastic Container Service (Amazon ECS) e do Amazon Elastic Kubernetes Service (Amazon EKS). O provedor de credenciais de contêiner busca credenciais para a aplicação conteinerizada do cliente.  | 
| [Provedor de credenciais de processo](feature-process-credentials.md) | Provedores de credenciais personalizados. Obtenha suas credenciais de uma fonte ou processo externo, incluindo o IAM Roles Anywhere. | 
| [Provedor de credenciais IMDS](feature-imds-credentials.md) | Credenciais do perfil de instância do Amazon Elastic Compute Cloud (Amazon EC2). Associe um perfil do IAM a cada uma das suas instâncias do EC2. As credenciais temporárias para essa função estão disponíveis para o código em execução na instância. As credenciais são fornecidas por meio do serviço de metadados do Amazon EC2.  | 

 Para cada etapa da cadeia, há várias maneiras de atribuir valores de configuração. Os valores de configuração especificados no código sempre têm precedência. No entanto, também existem [Variáveis de ambiente](environment-variables.md) e [Usando `credentials` arquivos compartilhados `config` para configurar AWS SDKs e ferramentas globalmente](file-format.md). Para obter mais informações, consulte [Precedência de configurações](settings-reference.md#precedenceOfSettings).

## Cadeias de provedores de credenciais específicas do SDK e da ferramenta
<a name="sdk-chains"></a>

Para acessar diretamente os detalhes **específicos** da cadeia de fornecedores de credenciais do SDK ou da ferramenta, escolha o SDK ou a ferramenta entre as seguintes opções:
+ [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) 
+ [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/credproviders.html)
+ [SDK para Go](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/configure-gosdk.html) 
+ [SDK para Java](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/credentials-chain.html) 
+ [SDK para JavaScript](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/setting-credentials-node.html#credchain) 
+ [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/credential-providers.html) 
+ [SDK para .NET](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/creds-assign.html)
+ [SDK para PHP](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/guide_credentials.html)
+ [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html)
+ [SDK para Ruby](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/setup-config.html)
+ [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/credproviders.html)
+ [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/using-configuration.html)
+ [Ferramentas para PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/creds-assign.html)

# AWS teclas de acesso
<a name="feature-static-credentials"></a>

**Atenção**  
Para evitar riscos de segurança, não use usuários do IAM para autenticação ao desenvolver software com propósito específico ou trabalhar com dados reais. Em vez disso, use federação com um provedor de identidade, como [Centro de Identidade do AWS IAM](https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html).

 AWS as chaves de acesso de um usuário do IAM podem ser usadas como suas AWS credenciais. O AWS SDK usa automaticamente essas AWS credenciais para assinar solicitações de API AWS, para que suas cargas de trabalho possam acessar seus AWS recursos e dados de forma segura e conveniente. É recomendável sempre usar o `aws_session_token` para que as credenciais sejam temporárias e não sejam mais válidas após expirarem. O uso de credenciais de longo prazo não é recomendado.

**nota**  
Se AWS não conseguir atualizar essas credenciais temporárias, AWS poderá estender a validade das credenciais para que suas cargas de trabalho não sejam afetadas.

 O AWS `credentials` arquivo compartilhado é o local recomendado para armazenar informações de credenciais porque está fora dos diretórios de origem do aplicativo e separado das configurações específicas do SDK do arquivo compartilhado. `config`

Para saber mais sobre AWS credenciais e o uso de chaves de acesso, consulte [Credenciais AWS de segurança](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html) e [Gerenciamento de chaves de acesso para usuários do IAM no Guia](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) do *usuário do IAM*. 

Configure essa funcionalidade usando o seguinte:

**`aws_access_key_id`- configuração de AWS `config` arquivo compartilhado`aws_access_key_id`- configuração de AWS `credentials` arquivo compartilhado *(método recomendado)*`AWS_ACCESS_KEY_ID`: variável de ambiente`aws.accessKeyId`- Propriedade do sistema JVM: somente Java/Kotlin **  
Especifica a chave de AWS acesso usada como parte das credenciais para autenticar o usuário.

**`aws_secret_access_key`- configuração de AWS `config` arquivo compartilhado`aws_secret_access_key`- configuração de AWS `credentials` arquivo compartilhado *(método recomendado)*`AWS_SECRET_ACCESS_KEY`: variável de ambiente`aws.secretAccessKey`- Propriedade do sistema JVM: somente Java/Kotlin **  
Especifica a chave AWS secreta usada como parte das credenciais para autenticar o usuário.

**`aws_session_token`- configuração de AWS `config` arquivo compartilhado`aws_session_token`- configuração de AWS `credentials` arquivo compartilhado *(método recomendado)*`AWS_SESSION_TOKEN`: variável de ambiente`aws.sessionToken`- Propriedade do sistema JVM: somente Java/Kotlin **  
Especifica um token de AWS sessão usado como parte das credenciais para autenticar o usuário. Você recebe esse valor como parte das credenciais temporárias retornadas por solicitações bem-sucedidas para assumir uma função. Um token de sessão só será necessário se você especificar manualmente credenciais de segurança temporárias. No entanto, recomendamos que você use sempre credenciais de segurança temporárias em vez de credenciais de longo prazo. Para obter recomendações de segurança, consulte [Melhores práticas de segurança no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html).

Para obter instruções sobre como obter esses valores, consulte [Usando credenciais de curto prazo para autenticação e ferramentas AWS SDKsCredenciais de curto prazo](access-temp-idc.md). 

Exemplo de configuração desses valores necessários no arquivo `config` ou `credentials`:

```
[default]
aws_access_key_id = AKIAIOSFODNN7EXAMPLE
aws_secret_access_key = wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
aws_session_token = AQoEXAMPLEH4aoAH0gNCAPy...truncated...zrkuWJOgQs8IZZaIv2BXIa2R4Olgk
```

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

```
export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
export AWS_SESSION_TOKEN=AQoEXAMPLEH4aoAH0gNCAPy...truncated...zrkuWJOgQs8IZZaIv2BXIa2R4Olgk
```

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

```
setx AWS_ACCESS_KEY_ID AKIAIOSFODNN7EXAMPLE
setx AWS_SECRET_ACCESS_KEY wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
setx AWS_SESSION_TOKEN AQoEXAMPLEH4aoAH0gNCAPy...truncated...zrkuWJOgQs8IZZaIv2BXIa2R4Olgk
```

## Support by AWS SDKs and tools
<a name="feature-static-credentials-sdk-compat"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/) | Sim |  | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Sim | arquivo compartilhado config não suportado. | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Sim |  | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Sim | Para usar as configurações do arquivo config compartilhado, você deve ativar o carregamento do arquivo de configuração; consulte [Sessões](https://docs.aws.amazon.com/sdk-for-go/api/aws/session/). | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Sim |  | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Sim |  | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Sim |  | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Sim |  | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Sim |  | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim |  | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim |  | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sim |  | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Sim |  | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Sim |  | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Sim |  | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Sim | As variáveis de ambiente não são compatíveis. | 

# Provedor de credenciais de login
<a name="feature-login-credentials"></a>

Você pode [usar suas credenciais de login existentes do AWS Management Console para adquirir credenciais](https://docs.amazon.aws.com/sdkref/latest/guide/access-login.html) de curto prazo que podem ser usadas para acesso programático. Depois de concluir o fluxo de autenticação baseado em navegador, AWS gera credenciais temporárias que funcionam em ferramentas de desenvolvimento locais, como AWS CLI, Tools for e. AWS PowerShell AWS SDKs

Para gerar essas credenciais, execute o `aws login` comando na AWS CLI ou o cmdlet AWS em `Invoke-AWSLogin` Tools for. PowerShell As credenciais de curto prazo resultantes serão armazenadas em cache localmente, onde poderão ser reutilizadas pelo. AWS SDKs As credenciais de curto prazo expiram em 15 minutos, mas a CLI as SDKs atualizará automaticamente conforme necessário em até 12 horas. Quando o token de atualização expirar, você será solicitado a fazer login novamente por meio da CLI ou. PowerShell

O comando de login atualizará o perfil especificado com a `login_session` configuração, que armazena a identidade da sessão do console de gerenciamento que você selecionou durante o fluxo de trabalho de login.

```
[profile console]
login_session = arn:aws:iam::0123456789012:user/username
region = us-west-2
```

Por padrão, as credenciais de curto prazo e o token de atualização são armazenados em um arquivo JSON no `~/.aws/login/cache` diretório no Linux e no macOS ou no Windows. `%USERPROFILE%\.aws\login\cache` O nome do arquivo é baseado no nome da sessão de login. Você pode substituir o diretório definindo a variável de `AWS_LOGIN_CACHE_DIRECTORY` ambiente.

## Configurações do provedor de login
<a name="feature-login-credentials-settings"></a>

Configure essa funcionalidade usando o seguinte:

**`AWS_LOGIN_CACHE_DIRECTORY`: variável de ambiente**  
Diretório alternativo em que a CLI SDKs armazenará as credenciais em cache que são mapeadas para um perfil de sessão de login.  
Valor padrão: `~/.aws/login/cache` no Linux e no macOS ou `%USERPROFILE%\.aws\login\cache` no Windows.

## Support by AWS SDKs and tools
<a name="feature-login-credentials-sdk-compat"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/) | Sim |  | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Sim |  | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Não |  | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Sim |  | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Sim |  | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Não |  | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Sim |  | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Não |  | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Sim |  | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim |  | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim | Requer CRT | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sim |  | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Sim |  | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Sim |  | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Não |  | 

# Assuma o perfil de provedor de credenciais
<a name="feature-assume-role-credentials"></a>

**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, consulte[Entender as páginas de configurações deste guia](settings-reference.md#settingsPages).

Assumir um perfil envolve o uso de um conjunto de credenciais temporárias de segurança para acessar recursos da AWS aos quais você talvez não tenha acesso de outra forma. Essas credenciais de segurança temporárias consistem em um ID de chave de acesso, uma chave de acesso secreta e um token de segurança. 

Para configurar seu SDK ou ferramenta para assumir um perfil, você deve primeiro criar ou identificar um *perfil* específico a ser assumido. Os perfis do IAM são identificados exclusivamente por um perfil do nome do recurso da Amazon ([ARN](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html)). Os perfis estabelecem as relações de confiança com uma outra entidade. A entidade confiável que usa a função pode ser uma AWS service (Serviço da AWS), outra Conta da AWS, um provedor de identidade da web ou uma federação OIDC ou SAML. 

Depois que perfil do IAM for identificado, se você tiver a confiança desse perfil, poderá configurar seu SDK ou ferramenta para usar as permissões concedidas pelo perfil. Para fazer isso, execute as configurações a seguir. 

Para obter orientação sobre como começar a usar essas configurações, consulte este guia [Assumindo uma função com AWS credenciais para autenticação AWS SDKs e ferramentas](access-assume-role.md).

## Assuma as configurações do provedor de credenciais do perfil
<a name="feature-assume-role-credentials-settings"></a>

Configure essa funcionalidade usando o seguinte:

**`credential_source`- configuração de AWS `config` arquivo compartilhado**  
Usado em instâncias ou contêineres do Amazon EC2 ou Amazon Elastic Container Service para especificar onde o SDK ou ferramenta pode encontrar credenciais que tem permissão para assumir o perfil que você especificar com o parâmetro `role_arn`.  
**Valor padrão**: nenhum  
**Valores válidos:**  
+ **Ambiente**: especifica que o SDK ou a ferramenta deve recuperar credenciais de origem de variáveis de ambiente [`AWS_ACCESS_KEY_ID` e `AWS_SECRET_ACCESS_KEY`](feature-static-credentials.md).
+ **Ec2 InstanceMetadata** — Especifica que o SDK ou a ferramenta deve usar a [função do IAM anexada ao perfil da instância do EC2 para obter as](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2_instance-profiles.html) credenciais de origem.
+ **EcsContainer**— Especifica que o SDK ou a ferramenta deve usar a [função do IAM anexada ao contêiner do Amazon ECS ou a função do IAM anexada ao contêiner](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/instance_IAM_role.html) [do Amazon EKS para obter as credenciais](https://docs.aws.amazon.com/eks/latest/userguide/security-iam-service-with-iam.html) de origem.
Não é possível especificar `credential_source` e `source_profile` no mesmo perfil.  
Exemplo de configuração em um arquivo `config` para indicar que as credenciais devem ser provenientes do Amazon EC2:  

```
credential_source = Ec2InstanceMetadata
role_arn = arn:aws:iam::123456789012:role/my-role-name
```

**`duration_seconds`- configuração de AWS `config` arquivo compartilhado**  
Especifica a duração máxima da sessão da função, em segundos.  
Esta configuração se aplica somente quando o perfil especifica assumir uma função.   
**Valor padrão:** 3.600 segundos (uma hora)  
**Valores válidos:** o valor pode variar de 900 segundos (15 minutos) até o valor configurado de duração máxima da sessão para o perfil (que pode ser até 43200, ou 12 horas). Para obter mais informações, consulte [Exibir a configuração de duração máxima da sessão para um perfil](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use.html#id_roles_use_view-role-max-session) no *Guia do usuário do IAM*.  
Exemplo de configuração em um arquivo `config`:  

```
duration_seconds = 43200
```

**`external_id`- configuração de AWS `config` arquivo compartilhado**  
Especifica um identificador exclusivo que é usado por terceiros para assumir uma função em suas contas de clientes.  
Esta configuração se aplica somente quando o perfil especifica assumir uma função e a política de confiança do perfil exige um valor para `ExternalId`. O valor é mapeado para o parâmetro `ExternalId` que é passado para a operação `AssumeRole` quando o perfil especifica uma função.   
**Valor padrão:** nenhum.   
**Valores válidos:** consulte [Como usar uma ID externa ao conceder acesso aos seus AWS recursos a terceiros](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user_externalid.html) no *Guia do usuário do IAM*.  
Exemplo de configuração em um arquivo `config`:  

```
external_id = unique_value_assigned_by_3rd_party
```

**`mfa_serial`- configuração de AWS `config` arquivo compartilhado**  
Especifica a identificação ou o número de série de um dispositivo de autenticação multifator (MFA) que o usuário deve usar ao assumir um perfil.  
Obrigatório ao assumir um perfil em que a política de confiança para o perfil inclui uma condição que exige autenticação de MFA. Para obter mais informações sobre MFA, consulte [Código da autenticação multifator no IAM da AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa.html) no *Guia do usuário do IAM*.   
**Valor padrão:** nenhum.   
**Valores válidos:** o valor pode ser um número de série de um dispositivo de hardware (como `GAHT12345678`) ou um nome do recurso da Amazon (ARN) de um dispositivo MFA virtual. O formato do ARN é: `arn:aws:iam::account-id:mfa/mfa-device-name`  
Exemplo de configuração em um arquivo `config`:  
Este exemplo pressupõe um dispositivo virtual de MFA, denominado `MyMFADevice`, que foi criado para a conta e habilitado para um usuário.  

```
mfa_serial = arn:aws:iam::123456789012:mfa/MyMFADevice
```

**`role_arn`- configuração de AWS `config` arquivo compartilhado`AWS_ROLE_ARN`: variável de ambiente`aws.roleArn`- Propriedade do sistema JVM: somente Java/Kotlin **  
Especifica o nome do recurso da Amazon (ARN) de um perfil do IAM que você deseja usar para realizar operações solicitadas usando esse perfil.  
**Valor padrão:** nenhum.   
**Valores válidos:** o valor deve ser o ARN de um perfil do IAM, formatado da seguinte forma: `arn:aws:iam::account-id:role/role-name`  
 Além disso, você também deve especificar **uma** das seguintes configurações:  
+ `source_profile`: identificar outro perfil a ser usado para encontrar credenciais que tenham permissão para assumir a função nesse perfil.
+ `credential_source`: usar credenciais identificadas pelas variáveis de ambiente atuais ou credenciais anexadas a um perfil de instância do Amazon EC2 ou a uma instância de contêiner do Amazon ECS.
+ `web_identity_token_file`: usar provedores de identidades públicas ou qualquer provedor de identidades compatível com OpenID Connect (OIDC) para usuários que foram autenticados em um aplicativo móvel ou aplicativo web.

**`role_session_name`- configuração de AWS `config` arquivo compartilhado`AWS_ROLE_SESSION_NAME`: variável de ambiente`aws.roleSessionName`- Propriedade do sistema JVM: somente Java/Kotlin **  
Especifica o nome a ser associado à sessão da função. Este nome aparece nos logs do AWS CloudTrail para entradas associadas a esta sessão, que pode ser útil em uma auditoria. Para obter detalhes, consulte o [elemento CloudTrail userIdentity](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html) no Guia do *AWS CloudTrail usuário*.  
**Valor padrão:** um parâmetro opcional. Se você não fornecer este valor, um nome de sessão será gerado automaticamente se o perfil assumir uma função.  
**Valores válidos:** fornecidos ao `RoleSessionName` parâmetro quando a AWS API AWS CLI ou chama a `AssumeRole` operação (ou operações como a `AssumeRoleWithWebIdentity` operação) em seu nome. O valor se torna parte da função assumida do usuário Amazon Resource Name (ARN) que você pode consultar e aparece como parte das entradas de CloudTrail registro das operações invocadas por esse perfil.  
 `arn:aws:sts::123456789012:assumed-role/my-role-name/my-role_session_name`.  
Exemplo de configuração em um arquivo `config`:  

```
role_session_name = my-role-session-name
```

**`source_profile`- configuração de AWS `config` arquivo compartilhado**  
Especifica outro perfil cujas credenciais são usadas para assumir o perfil especificado pela configuração `role_arn` no perfil original. Para entender como os perfis são usados no compartilhamento AWS `config` e nos `credentials` arquivos, consulte[Arquivos `config` e `credentials` compartilhados](file-format.md).  
Se você especificar um perfil que também seja um perfil de assumir função, cada perfil será assumido em ordem sequencial para resolver totalmente as credenciais. Essa cadeia é interrompida quando o SDK encontra um perfil com credenciais. O encadeamento de funções limita sua sessão de função AWS CLI ou de AWS API a no máximo uma hora e não pode ser aumentado. Para obter mais informações, consulte [Termos e conceitos de funções](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html) no *Guia do usuário do IAM*.  
**Valor padrão:** nenhum.  
**Valores válidos:** um string de texto que consiste no nome de um perfil definido nos arquivos `config` e `credentials`. Você também deve especificar um valor para `role_arn` no perfil atual.  
Não é possível especificar `credential_source` e `source_profile` no mesmo perfil.  
Exemplo de definição em um arquivo de configuração:  

```
[profile A]
source_profile = B
role_arn =  arn:aws:iam::123456789012:role/RoleA
role_session_name = ProfileARoleSession
                
[profile B]
credential_process = ./aws_signing_helper credential-process --certificate /path/to/certificate --private-key /path/to/private-key --trust-anchor-arn arn:aws:rolesanywhere:region:account:trust-anchor/TA_ID --profile-arn arn:aws:rolesanywhere:region:account:profile/PROFILE_ID --role-arn arn:aws:iam::account:role/ROLE_ID
```
No exemplo anterior, o perfil `A` instrui o SDK ou a ferramenta a pesquisar automaticamente as credenciais do perfil `B` vinculado. Nesse caso, o perfil `B` usa a ferramenta assistente de credenciais fornecida por [Usando o IAM Roles Anywhere para autenticação AWS SDKs e ferramentas](access-rolesanywhere.md) para obter credenciais para o SDK da AWS . Essas credenciais temporárias são então usadas pelo código para acessar recursos da AWS . O papel especificado deve ter políticas de permissões do IAM anexadas que permitam a execução do código solicitado, como o comando ou o método da API. AWS service (Serviço da AWS) Cada ação realizada pelo perfil `A` tem o nome da sessão da função incluído nos CloudTrail registros.   
Como um segundo exemplo de encadeamento de perfis, a configuração a seguir poderá ser usada se você tiver uma aplicação em uma instância do Amazon Elastic Compute Cloud e quiser que ela assuma outro perfil.   

```
[profile A]
source_profile = B
role_arn =  arn:aws:iam::123456789012:role/RoleA
role_session_name = ProfileARoleSession
                
[profile B]
credential_source=Ec2InstanceMetadata
```
O perfil `A` usará as credenciais de instância do Amazon EC2 para assumir o perfil especificado e renovará as credenciais automaticamente.  


**`web_identity_token_file`- configuração de AWS `config` arquivo compartilhado`AWS_WEB_IDENTITY_TOKEN_FILE`: variável de ambiente`aws.webIdentityTokenFile`- Propriedade do sistema JVM: somente Java/Kotlin **  
Especifica o caminho para um arquivo que contém um token de acesso de um [provedor OAuth 2.0 compatível ou provedor](https://wikipedia.org/wiki/List_of_OAuth_providers) de [identidade OpenID Connect ID](https://openid.net/developers/certified/).  
Esta configuração permite a autenticação usando provedores de federação de identidade da web, como [Google](https://developers.google.com/identity/protocols/OAuth2), [Facebook](https://developers.facebook.com/docs/facebook-login/overview) e [Amazon](https://login.amazon.com/), entre muitos outros. O SDK ou a ferramenta do desenvolvedor carrega o conteúdo deste arquivo e o transmite como argumento `WebIdentityToken` quando chama a operação `AssumeRoleWithWebIdentity` em seu nome.  
**Valor padrão:** nenhum.   
**Valores válidos:** este valor deve ser um nome de caminho e de arquivo. O arquivo deve conter um token de acesso OAuth 2.0 ou um token OpenID Connect fornecido a você por um provedor de identidade. Os caminhos relativos são tratados como relativos ao diretório de trabalho do processo.

## Support by AWS SDKs and tools
<a name="assume-role-sdk-compat"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/) | Sim |  | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Parcial | credential\$1source não suportado. duration\$1seconds não suportado. mfa\$1serial não suportado. | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Sim |  | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Sim | Para usar as configurações do arquivo config compartilhado, você deve ativar o carregamento do arquivo de configuração; consulte [Sessões](https://docs.aws.amazon.com/sdk-for-go/api/aws/session/). | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Parcial | mfa\$1serial não compatível. duration\$1seconds não compatível. | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Parcial | credential\$1source não compatível. mfa\$1serial não compatível. Propriedades do sistema JVM não compatíveis.  | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Sim |  | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Parcial | credential\$1source incompatível. | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Sim |  | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim |  | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim |  | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sim |  | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Sim |  | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Sim |  | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Sim |  | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Sim |  | 

# Provedor de credenciais de contêiner
<a name="feature-container-credentials"></a>

**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, consulte[Entender as páginas de configurações deste guia](settings-reference.md#settingsPages).

O provedor de credenciais de contêiner busca credenciais para a aplicação conteinerizada do cliente. Esse provedor de credenciais é útil para clientes do Amazon Elastic Container Service (Amazon ECS) e do Amazon Elastic Kubernetes Service (Amazon EKS). SDKs tente carregar credenciais do endpoint HTTP especificado por meio de uma solicitação GET. 

Se você usa o Amazon ECS, recomendamos que você use um perfil do IAM de tarefa para melhorar o isolamento, a autorização e a auditabilidade das credenciais. Quando configurado, o Amazon ECS define a variável de `AWS_CONTAINER_CREDENTIALS_RELATIVE_URI` ambiente que as ferramentas SDKs e ferramentas usam para obter credenciais. Para configurar o Amazon ECS para essa funcionalidade, consulte a [Função do IAM de tarefa](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html) no *Amazon Elastic Container Service Developer Guide*.

Se você usa o Amazon EKS, recomendamos usar o Amazon EKS Pod Identity para melhorar o isolamento de credenciais, privilégios mínimos, auditabilidade, operação independente, reutilização e escalabilidade. Tanto seu Pod quanto um perfil do IAM estão associados a uma conta de serviço do Kubernetes para gerenciar as credenciais dos seus aplicativos. Para saber mais sobre o Amazon EKS Pod Identity, consulte [Amazon EKS Pod Identities](https://docs.aws.amazon.com/eks/latest/userguide/pod-identities.html) no **Guia do usuário do Amazon EKS**. Quando configurado, o Amazon EKS define as variáveis de `AWS_CONTAINER_AUTHORIZATION_TOKEN_FILE` ambiente `AWS_CONTAINER_CREDENTIALS_FULL_URI` e as variáveis de ambiente que as ferramentas SDKs e as ferramentas usam para obter credenciais. Para obter informações de configuração, consulte [Configurar o Amazon EKS Pod Identity Agent](https://docs.aws.amazon.com/eks/latest/userguide/pod-id-agent-setup.html) no **Guia do usuário do Amazon EKS** ou o [Amazon EKS Pod Identity simplifica as permissões do IAM para aplicativos em clusters do Amazon EKS](https://aws.amazon.com/blogs/aws/amazon-eks-pod-identity-simplifies-iam-permissions-for-applications-on-amazon-eks-clusters/) no site do AWS blog.

Configure essa funcionalidade usando o seguinte:

**`AWS_CONTAINER_CREDENTIALS_FULL_URI`: variável de ambiente**  
Contém o endpoint de URL HTTP relativo para o SDK usar ao fazer uma solicitação de credenciais. Isso inclui o esquema e o host.  
**Valor padrão:** nenhum.   
**Valores válidos:** URL válido.   
*Nota: essa configuração é uma alternativa para `AWS_CONTAINER_CREDENTIALS_RELATIVE_URI` e só será usada se `AWS_CONTAINER_CREDENTIALS_RELATIVE_URI` não estiver definido. *  
Exemplo de configuração de variáveis de ambiente para Linux/macOS por meio da linha de comando:  

```
export AWS_CONTAINER_CREDENTIALS_FULL_URI=http://localhost/get-credentials
```
ou  

```
export AWS_CONTAINER_CREDENTIALS_FULL_URI=http://localhost:8080/get-credentials
```

**`AWS_CONTAINER_CREDENTIALS_RELATIVE_URI`: variável de ambiente**  
Contém o endpoint de URL HTTP completo para o SDK usar ao fazer uma solicitação de credenciais. O valor é anexado ao nome de host padrão do Amazon ECS de `169.254.170.2`.  
**Valor padrão**: Nenhum.  
**Valores válidos:** URL relativo válido.  
Exemplo de configuração de variáveis de ambiente para Linux/macOS por meio da linha de comando:  

```
export AWS_CONTAINER_CREDENTIALS_RELATIVE_URI=/get-credentials?a=1
```

**`AWS_CONTAINER_AUTHORIZATION_TOKEN`: variável de ambiente**  
Especifica o token de autorização em texto sem formatação. Se essa variável for definida, o SDK definirá o cabeçalho de autorização na solicitação HTTP com o valor da variável de ambiente.  
**Valor padrão:** nenhum.   
**Valores válidos:** string.   
*Nota: essa configuração é uma alternativa para `AWS_CONTAINER_AUTHORIZATION_TOKEN_FILE` e só será usada se `AWS_CONTAINER_AUTHORIZATION_TOKEN_FILE` não estiver definido. *  
Exemplo de configuração de variáveis de ambiente para Linux/macOS por meio da linha de comando:  

```
export AWS_CONTAINER_CREDENTIALS_FULL_URI=http://localhost/get-credential
export AWS_CONTAINER_AUTHORIZATION_TOKEN=Basic abcd
```

**`AWS_CONTAINER_AUTHORIZATION_TOKEN_FILE`: variável de ambiente**  
Especifica um caminho de arquivo absoluto para um arquivo que contém o token de autorização em texto simples.  
**Valor padrão**: Nenhum.   
**Valores válidos:** string.   
Exemplo de configuração de variáveis de ambiente para Linux/macOS por meio da linha de comando:  

```
export AWS_CONTAINER_CREDENTIALS_FULL_URI=http://localhost/get-credential
export AWS_CONTAINER_AUTHORIZATION_TOKEN_FILE=/path/to/token
```

## Support by AWS SDKs and tools
<a name="feature-container-credentials-sdk-compat"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/) | Sim |  | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Sim |  | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Sim |  | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Sim |  | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Sim | Quando o [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html#snapstart-runtimes) é ativado AWS\$1CONTAINER\$1CREDENTIALS\$1FULL\$1URI e AWS\$1CONTAINER\$1AUTHORIZATION\$1TOKEN é usado automaticamente para autenticação. | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Sim | Quando o [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html#snapstart-runtimes) é ativado AWS\$1CONTAINER\$1CREDENTIALS\$1FULL\$1URI e AWS\$1CONTAINER\$1AUTHORIZATION\$1TOKEN é usado automaticamente para autenticação. | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Sim |  | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Sim |  | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Sim | Quando o [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html#snapstart-runtimes) é ativado AWS\$1CONTAINER\$1CREDENTIALS\$1FULL\$1URI e AWS\$1CONTAINER\$1AUTHORIZATION\$1TOKEN é usado automaticamente para autenticação. | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Sim | Quando o [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html#snapstart-runtimes) é ativado AWS\$1CONTAINER\$1CREDENTIALS\$1FULL\$1URI e AWS\$1CONTAINER\$1AUTHORIZATION\$1TOKEN é usado automaticamente para autenticação. | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim |  | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim | Quando o [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html#snapstart-runtimes) é ativado AWS\$1CONTAINER\$1CREDENTIALS\$1FULL\$1URI e AWS\$1CONTAINER\$1AUTHORIZATION\$1TOKEN é usado automaticamente para autenticação. | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sim |  | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Sim |  | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Sim |  | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Sim |  | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Sim |  | 

# Provedor de credencial do IAM Identity Center
<a name="feature-sso-credentials"></a>

**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, consulte[Entender as páginas de configurações deste guia](settings-reference.md#settingsPages).

Esse mecanismo de autenticação é usado Centro de Identidade do AWS IAM para obter acesso de login único (SSO) ao seu código Serviços da AWS .

**nota**  
Na documentação da API do AWS SDK, o provedor de credenciais do IAM Identity Center é chamado de provedor de credenciais SSO.

Depois de habilitar o IAM Identity Center, você define um perfil para suas configurações no AWS `config` arquivo compartilhado. Este perfil é usado para se conectar ao portal de acesso do IAM Identity Center. Quando um usuário se autentica com sucesso no IAM Identity Center, o portal retorna credenciais de curto prazo para o perfil do IAM associado a esse usuário. Para saber como o SDK obtém credenciais temporárias da configuração e as usa para AWS service (Serviço da AWS) solicitações, consulte. [Como a autenticação do IAM Identity Center é resolvida AWS SDKs e as ferramentas](understanding-sso.md)

Há duas maneiras de configurar o IAM Identity Center por meio do arquivo `config`:
+ **(Recomendado) Configuração do provedor de token SSO**: durações de sessão estendidas. Inclui compatibilidade com durações de sessão personalizadas.
+ **Configuração legada não atualizável**: usa uma sessão fixa de oito horas.

Em ambas as configurações, você precisa entrar novamente quando sua sessão expirar.

Os dois guias a seguir contêm informações adicionais sobre o IAM Identity Center:
+ [Centro de Identidade do AWS IAM Guia do usuário](https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html)
+ [Centro de Identidade do AWS IAM Referência da API do portal](https://docs.aws.amazon.com/singlesignon/latest/PortalAPIReference/Welcome.html)

Para saber mais sobre como as ferramentas SDKs e usam e atualizam as credenciais usando essa configuração, consulte. [Como a autenticação do IAM Identity Center é resolvida AWS SDKs e as ferramentas](understanding-sso.md)

## Pré-requisitos
<a name="feature-sso-credentials-prereq"></a>

É necessário primeiro habilitar o IAM Identity Center. Para obter detalhes sobre como habilitar a autenticação do IAM Identity Center, consulte [Enabling Centro de Identidade do AWS IAM](https://docs.aws.amazon.com/singlesignon/latest/userguide/get-set-up-for-idc.html) no *Centro de Identidade do AWS IAM User Guide*.

**nota**  
Como alternativa, para obter os pré-requisitos completos **e** a configuração do arquivo `config` compartilhado necessário que são detalhados nesta página, consulte as instruções guiadas para a configuração do [Usando o IAM Identity Center para autenticar o AWS SDK e as ferramentas](access-sso.md).

## Configuração do provedor de token do SSO
<a name="sso-token-config"></a>

Quando você usa a configuração do provedor de token SSO, seu AWS SDK ou ferramenta atualiza automaticamente sua sessão até o período estendido da sessão. Para obter mais informações sobre a duração e a duração máxima da sessão, consulte [Configurar a duração da sessão do portal de AWS acesso e dos aplicativos integrados do IAM Identity Center](https://docs.aws.amazon.com/singlesignon/latest/userguide/configure-user-session.html) no *Guia Centro de Identidade do AWS IAM do usuário*.

A `sso-session` seção do `config` arquivo é usada para agrupar variáveis de configuração para adquirir tokens de acesso SSO, que podem então ser usados para adquirir AWS credenciais. Para obter mais detalhes sobre essa seção em um arquivo `config`, consulte [Formato do arquivo de configuração](file-format.md#file-format-config). 

O exemplo de arquivo compartilhado `config` a seguir configura o SDK ou a ferramenta usando um perfil `dev` para solicitar credenciais do IAM Identity Center.

```
[profile dev]
sso_session = my-sso
sso_account_id = 111122223333
sso_role_name = SampleRole

[sso-session my-sso]
sso_region = us-east-1
sso_start_url = https://my-sso-portal.awsapps.com/start
sso_registration_scopes = sso:account:access
```

Os exemplos anteriores mostram que você define uma sessão do `sso-session` e a associa a um perfil. Normalmente, `sso_account_id` e `sso_role_name` deve ser definido na `profile` seção para que o SDK possa solicitar AWS credenciais. `sso_region`,`sso_start_url`, e `sso_registration_scopes` deve ser definido dentro da `sso-session` seção. 

No entanto, `sso_account_id` e `sso_role_name` não são necessários para todos os cenários de configuração do token do SSO. Se seu aplicativo usa apenas Serviços da AWS essa autenticação de portador de suporte, AWS as credenciais tradicionais não são necessárias. A autenticação do portador é um esquema de autenticação HTTP que usa tokens de segurança chamados tokens de portador. Nesse cenário, `sso_account_id` e `sso_role_name` não são obrigatórios. Consulte o AWS service (Serviço da AWS) guia individual para determinar se o serviço oferece suporte à autorização do token do portador.

Os escopos de registro são configurados como parte de um `sso-session`. O escopo é um mecanismo no OAuth 2.0 para limitar o acesso de um aplicativo à conta de um usuário. O exemplo anterior define `sso_registration_scopes` para fornecer o acesso necessário para listar contas e perfis. 

O exemplo a seguir mostra como é possível reutilizar a mesma configuração `sso-session` em vários perfis.

```
[profile dev]
sso_session = my-sso
sso_account_id = 111122223333
sso_role_name = SampleRole

[profile prod]
sso_session = my-sso
sso_account_id = 111122223333
sso_role_name = SampleRole2

[sso-session my-sso]
sso_region = us-east-1
sso_start_url = https://my-sso-portal.awsapps.com/start
sso_registration_scopes = sso:account:access
```

O token de autenticação é armazenado em cache no disco sob o diretório `~/.aws/sso/cache` com um nome de arquivo baseado no nome da sessão. 

## Configuração herdada não atualizável
<a name="sso-legacy"></a>

A atualização automática de tokens não é compatível usando a configuração herdada não atualizável. Em vez disso, recomendamos usar [Configuração do provedor de token do SSO](#sso-token-config).

Para usar a configuração legada não atualizável, você deve especificar as seguintes configurações no seu perfil:
+ `sso_start_url`
+ `sso_region`
+ `sso_account_id`
+ `sso_role_name`

Você especifica o portal do usuário para um perfil com as configurações `sso_start_url` e `sso_region`. Você especifica as permissões com as configurações `sso_account_id` e `sso_role_name`.

O exemplo a seguir define os quatro valores necessários no arquivo `config`.

```
[profile my-sso-profile]
sso_start_url = https://my-sso-portal.awsapps.com/start
sso_region = us-west-2
sso_account_id = 111122223333
sso_role_name = SSOReadOnlyRole
```

O token de autenticação é armazenado em cache no disco sob o diretório `~/.aws/sso/cache` com um nome de arquivo baseado no `sso_start_url`. 

## Configurações do provedor de credenciais do IAM Identity Center
<a name="feature-sso-credentials-profile"></a>

Configure essa funcionalidade usando o seguinte:

**`sso_start_url`- configuração de AWS `config` arquivo compartilhado**  
A URL que aponta para a URL do emissor do IAM Identity Center ou para a URL do portal de acesso da sua organização. Para obter informações consulte [Sign in to the AWS access portal](https://docs.aws.amazon.com/singlesignon/latest/userguide/using-the-portal.html) no *Centro de Identidade do AWS IAM User Guide*.  
 Para encontrar esse valor, abra o [console do IAM Identity Center](https://console.aws.amazon.com/singlesignon), visualize o **painel** e encontre a **URL do portal de acesso da AWS **.  
+ Como alternativa, a partir da versão **2.22.0** do AWS CLI, você pode usar o valor para URL do **AWS emissor**.

**`sso_region`- configuração de AWS `config` arquivo compartilhado**  
O Região da AWS que contém o host do portal do IAM Identity Center; ou seja, a região que você selecionou antes de ativar o IAM Identity Center. Isso é independente da sua AWS região padrão e pode ser diferente.  
Para obter uma lista completa dos Regiões da AWS e de seus códigos, consulte [Endpoints regionais](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints) no *Referência geral da Amazon Web Services*. Para encontrar esse valor, abra o [console do IAM Identity Center](https://console.aws.amazon.com/singlesignon), visualize o **painel** e encontre a **região**.

**`sso_account_id`- configuração de AWS `config` arquivo compartilhado**  
O ID numérico do Conta da AWS que foi adicionado por meio do AWS Organizations serviço para uso na autenticação.   
Para ver a lista de contas disponíveis, acesse o [console do IAM Identity Center](https://console.aws.amazon.com/singlesignon) e abra a página de **Contas da AWS**. Você também pode ver a lista de contas disponíveis usando o método [ListAccounts](https://docs.aws.amazon.com/singlesignon/latest/PortalAPIReference/API_ListAccounts.html)API na *Referência da API do Centro de Identidade do AWS IAM Portal*. Por exemplo, você pode chamar o AWS CLI método [list-accounts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sso/list-accounts.html). 

**`sso_role_name`- configuração de AWS `config` arquivo compartilhado**  
O nome de um conjunto de permissões provisionado como um perfil do IAM que define as permissões resultantes do usuário. A função deve existir no Conta da AWS especificado por`sso_account_id`. Use o nome do perfil, não o nome do recurso da Amazon (ARN) do perfil.  
Os conjuntos de permissões têm políticas do IAM e políticas de permissões personalizadas anexadas a eles e definem o nível de acesso que os usuários têm às suas Contas da AWS atribuídas.  
Para ver a lista de conjuntos de permissões disponíveis por Conta da AWS, acesse o [console do IAM Identity Center](https://console.aws.amazon.com/singlesignon) e abra a **Contas da AWS**página. Escolha o nome correto do conjunto de permissões listado na Contas da AWS tabela. Você também pode ver a lista de conjuntos de permissões disponíveis usando o método [ListAccountRoles](https://docs.aws.amazon.com/singlesignon/latest/PortalAPIReference/API_ListAccountRoles.html)API na *Referência da API do Centro de Identidade do AWS IAM Portal*. Por exemplo, você pode chamar o AWS CLI método [list-account-roles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sso/list-account-roles.html). 

**`sso_registration_scopes`- configuração de AWS `config` arquivo compartilhado**  
Uma lista delimitada por vírgulas de escopos a serem autorizados para `sso-session`. Um aplicativo pode solicitar um ou mais escopos, e o token de acesso emitido para o aplicativo está limitado aos escopos concedidos. Um escopo mínimo de `sso:account:access` deve ser concedido para recuperar um token de atualização do serviço IAM Identity Center. Para obter a lista de opções de escopo de acesso disponíveis, consulte [Access scopes](https://docs.aws.amazon.com/singlesignon/latest/userguide/customermanagedapps-saml2-oauth2.html#oidc-concept) no *Centro de Identidade do AWS IAM User Guide*.   
Esses escopos definem as permissões solicitadas para serem autorizadas para o cliente OIDC registrado e os tokens de acesso recuperados pelo cliente. Os escopos autorizam o acesso aos endpoints autorizados portadores do token do IAM Identity Center.   
Esta configuração não é aplicável à configuração legada não atualizável. Os tokens emitidos usando a configuração legada estão limitados ao escopo `sso:account:access` implícito.

## Support by AWS SDKs and tools
<a name="feature-sso-credentials-sdk-compat"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/) | Sim |  | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Sim |  | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Sim |  | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Sim | Para usar as configurações do arquivo config compartilhado, você deve ativar o carregamento do arquivo de configuração; consulte [Sessões](https://docs.aws.amazon.com/sdk-for-go/api/aws/session/). | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Sim | Valores de configuração também compatíveis no arquivo credentials. | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Não |  | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Sim |  | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Sim |  | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Sim |  | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim |  | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim |  | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sim |  | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Parcial | Somente configuração herdada não atualizável. | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Sim |  | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Sim |  | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Sim |  | 

# Provedor de credenciais IMDS
<a name="feature-imds-credentials"></a>

**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, consulte[Entender as páginas de configurações deste guia](settings-reference.md#settingsPages).

O serviço de metadados de instância (IMDS) fornece dados sobre sua instância que é possível usar para configurar ou gerenciar a instância em execução. Para obter mais informações, consulte [Trabalhar com metadados de instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html) no *Guia do usuário do Amazon EC2*. O Amazon EC2 fornece um endpoint local disponível para instâncias que podem fornecer várias informações para a instância. Se a instância tiver uma função anexada, ela poderá fornecer um conjunto de credenciais válidas para essa função. Eles SDKs podem usar esse endpoint para resolver credenciais como parte de sua cadeia de fornecedores de [credenciais padrão](standardized-credentials.md#credentialProviderChain). O Instance Metadata Service Version 2 (IMDSv2), uma versão mais segura do IMDS que usa um token de sessão, é usado por padrão. Se isso falhar devido a uma condição que não pode ser repetida (códigos de erro HTTP 403, 404, 405), IMDSv1 é usado como alternativa. 

Configure essa funcionalidade usando o seguinte:

**`AWS_EC2_METADATA_DISABLED`: variável de ambiente**  
Se o serviço de metadados de instância (IMDS) do Amazon EC2 (IMDS) deve ou não ser usado para obter credenciais.  
**Valor padrão:** `false`.  
**Valores válidos:**  
+ **`true`** – Não use o IMDS para obter credenciais.
+ **`false`** – Use o IMDS para obter credenciais.

**`ec2_metadata_v1_disabled`- configuração de AWS `config` arquivo compartilhado`AWS_EC2_METADATA_V1_DISABLED`: variável de ambiente`aws.disableEc2MetadataV1`- Propriedade do sistema JVM: somente Java/Kotlin **  
Se deve ou não usar o Instance Metadata Service Version 1 (IMDSv1) como alternativa em caso IMDSv2 de falha.  
Os novos SDKs não oferecem suporte IMDSv1 e, portanto, não oferecem suporte a essa configuração. Para obter detalhes, consulte a tabela [Support by AWS SDKs and tools](#feature-imds-credentials-sdk-compat).
**Valor padrão:** `false`.  
**Valores válidos:**  
+ **`true`**— Não use IMDSv1 como substituto.
+ **`false`**— Use IMDSv1 como substituto.

**`ec2_metadata_service_endpoint`- configuração de AWS `config` arquivo compartilhado`AWS_EC2_METADATA_SERVICE_ENDPOINT`: variável de ambiente`aws.ec2MetadataServiceEndpoint`- Propriedade do sistema JVM: somente Java/Kotlin **  
O endpoint de IMDS. Esse valor substitui o local padrão em que os AWS SDKs e as ferramentas pesquisarão os metadados da instância do Amazon EC2.  
**Valor padrão:** se `ec2_metadata_service_endpoint_mode` for igual a `IPv4`, o endpoint padrão será `http://169.254.169.254`. Se `ec2_metadata_service_endpoint_mode` for igual a `IPv6`, o endpoint padrão será `http://[fd00:ec2::254]`.  
**Valores válidos:** URL válido.

**`ec2_metadata_service_endpoint_mode`- configuração de AWS `config` arquivo compartilhado`AWS_EC2_METADATA_SERVICE_ENDPOINT_MODE`: variável de ambiente`aws.ec2MetadataServiceEndpointMode`- Propriedade do sistema JVM: somente Java/Kotlin **  
O modo de endpoint do IMDS.  
**Valor padrão:**`IPv4`.  
**Valores válidos:** `IPv4`, `IPv6`.

**nota**  
O provedor de credenciais do IMDS faz parte do [Entender a cadeia de provedores de credenciais](standardized-credentials.md#credentialProviderChain). No entanto, o provedor de credenciais do IMDS só é verificado após vários outros provedores que estão nesta série. Portanto, se você quiser que seu programa use as credenciais desse provedor, você deve remover outros provedores de credenciais válidos da sua configuração ou usar um perfil diferente. Como alternativa, em vez de confiar na cadeia de provedores de credenciais para descobrir automaticamente qual provedor retorna credenciais válidas, especifique o uso do provedor de credenciais IMDS no código. Você pode especificar fontes de credenciais diretamente ao criar clientes de serviço.

## Segurança para credenciais do IMDS
<a name="feature-imds-credentials-sdk-security"></a>

Por padrão, quando o AWS SDK não está configurado com credenciais válidas, o SDK tentará usar o Amazon EC2 Instance Metadata Service (IMDS) para recuperar as credenciais de uma função. AWS Esse comportamento pode ser desativado definindo a variável de ambiente `AWS_EC2_METADATA_DISABLED` como `true`. Isso evita atividades de rede desnecessárias e aumenta a segurança em redes não confiáveis nas quais o serviço de metadados de instância do Amazon EC2 pode ser representado.

**nota**  
AWS Clientes SDK configurados com credenciais válidas nunca usarão o IMDS para recuperar credenciais, independentemente de qualquer uma dessas configurações.

### Desabilitando o uso das credenciais do Amazon EC2 IMDS
<a name="feature-imds-credentials-disabling"></a>

A forma como você define essa variável de ambiente depende do sistema operacional em uso, bem como se você deseja ou não que a alteração seja persistente.

#### Linux e macOS
<a name="feature-imds-credentials-disabling-unix"></a>

Os clientes que usam Linux ou macOS podem definir essa variável de ambiente com o comando a seguir:

```
$ export AWS_EC2_METADATA_DISABLED=true
```

Se você quiser que essa configuração seja persistente em várias sessões de shell e reinicializações do sistema, você pode adicionar o comando acima ao seu arquivo de perfil de shell, como `.bash_profile`, `.zsh_profile` ou `.profile`.

#### Windows
<a name="feature-imds-credentials-disabling-windows"></a>

Os clientes que usam Windows podem definir essa variável de ambiente com o comando a seguir:

```
$ set AWS_EC2_METADATA_DISABLED=true
```

Se você quiser que essa configuração seja persistente em várias sessões de shell e reinicializações do sistema, use o seguinte comando em vez disso:

```
$ setx AWS_EC2_METADATA_DISABLED=true
```

**nota**  
O comando **setx** não aplica o valor à sessão atual do shell, então você precisará recarregar ou reabrir o shell para que a alteração entre em vigor.

## Support by AWS SDKs and tools
<a name="feature-imds-credentials-sdk-compat"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/) | Sim |  | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Sim |  | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Sim |  | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Sim | Para usar as configurações do arquivo config compartilhado, você deve ativar o carregamento do arquivo de configuração; consulte [Sessões](https://docs.aws.amazon.com/sdk-for-go/api/aws/session/). | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Sim |  | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Parcial | Propriedades de sistema JVM: use com.amazonaws.sdk.disableEc2MetadataV1 em vez de aws.disableEc2MetadataV1; aws.ec2MetadataServiceEndpoint e aws.ec2MetadataServiceEndpointMode não compatíveis.  | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Sim |  | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Sim |  | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Sim | Não usa IMDSv1 fallback. | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Sim |  | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim |  | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim |  | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sim |  | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Sim | Não usa IMDSv1 fallback. | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Sim |  | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Sim | Você pode desativar o IMDSv1 fallback explicitamente no código usando. [Amazon.Util.EC2InstanceMetadata]::EC2MetadataV1Disabled = \$1true | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Sim | Você pode desativar o IMDSv1 fallback explicitamente no código usando. [Amazon.Util.EC2InstanceMetadata]::EC2MetadataV1Disabled = \$1true | 

# Provedor de credenciais de processo
<a name="feature-process-credentials"></a>

**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, consulte[Entender as páginas de configurações deste guia](settings-reference.md#settingsPages).

SDKs fornecem uma forma de estender a cadeia de fornecedores de credenciais para casos de uso personalizados. Esse provedor pode ser usado para fornecer implementações personalizadas, como recuperação de credenciais de um repositório de credenciais on-premises ou integração com o provedor de identificação on-premises.

 Por exemplo, o IAM Roles Anywhere usa o `credential_process` para obter credenciais temporárias para sua aplicação. Para configurar `credential_process` para esse uso, consulte [Usando o IAM Roles Anywhere para autenticação AWS SDKs e ferramentas](access-rolesanywhere.md).

**nota**  
A seguir, descrevemos um método de obtenção de credenciais de um processo externo que pode ser usado se você estiver executando software fora da AWS. Se você estiver criando um recurso AWS computacional, use outros provedores de credenciais. Se usar esta opção, certifique-se de que o arquivo config esteja o mais bloqueado possível usando as melhores práticas de segurança para seu sistema operacional. Confirme se sua ferramenta de credencial personalizada não grava nenhuma informação secreta`StdErr`, pois ela AWS CLI pode capturar SDKs e registrar essas informações, potencialmente expondo-as a usuários não autorizados.

Configure essa funcionalidade usando o seguinte:

**`credential_process`- configuração de AWS `config` arquivo compartilhado**  
Especifica um comando externo que o SDK ou uma ferramenta executa em seu nome para gerar ou recuperar credenciais de autenticação a serem usadas. A configuração especifica o nome de um program/command que o SDK invocará. Quando o SDK invoca o processo, ele espera que o processo grave dados JSON em `stdout`. O provedor personalizado deve retornar informações em um formato específico. Essas informações contêm as credenciais que o SDK ou a ferramenta podem usar para autenticar você. 

**nota**  
O provedor de credenciais do processo faz parte do [Entender a cadeia de provedores de credenciais](standardized-credentials.md#credentialProviderChain). No entanto, o provedor de credenciais do processo só é verificado após vários outros provedores que estão nesta série. Portanto, se você quiser que seu programa use as credenciais deste provedor, você deve remover outros provedores de credenciais válidos da sua configuração ou usar um perfil diferente. Como alternativa, em vez de confiar na cadeia de fornecedores de credenciais para descobrir automaticamente qual provedor retorna credenciais válidas, especifique o uso do provedor de credenciais do processo no código. Você pode especificar fontes de credenciais diretamente ao criar clientes de serviço.

## Especificando o caminho para o programa de credenciais
<a name="feature-process-credentials-detail-path"></a>

O valor da configuração é uma string que contém um caminho para um programa que o SDK ou a ferramenta de desenvolvimento executa em seu nome:
+ O caminho e o nome do arquivo podem consistir somente dos seguintes caracteres: A-Z, a-z, 0-9, hífen (-), sublinhado (\$1), barra (/), barra invertida (\$1) e espaço.
+ Se o caminho ou o nome do arquivo contiver um espaço, coloque o caminho completo e o nome do arquivo entre aspas duplas (“ ”). 
+ Se um nome de parâmetro ou um valor de parâmetro tiver um espaço, coloque esse elemento entre aspas duplas (“ ”). Coloque somente o nome ou o valor entre aspas, não o par.
+ Não inclua variáveis de ambiente nas strings. Por exemplo, não inclua `$HOME` ou `%USERPROFILE%`.
+ Não especifique a pasta base como `~`. \$1 Você deve especificar 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`. O caminho varia dependendo o sistema operacional:

  O exemplo a seguir mostra a configuração de credential\$1process no arquivo compartilhado `config` no Linux/macOS.

  ```
  credential_process = "/path/to/credentials.sh" parameterWithoutSpaces "parameter with spaces"
  ```

  O exemplo a seguir mostra a configuração de credential\$1process no arquivo compartilhado `config` no Windows.

  ```
  credential_process = "C:\Path\To\credentials.cmd" parameterWithoutSpaces "parameter with spaces"
  ```
+  Pode ser especificado em um perfil dedicado:

  ```
  [profile cred_process] 
  credential_process = /Users/username/process.sh 
  region = us-east-1
  ```

## Saída válida do programa de credenciais
<a name="feature-process-credentials-output"></a>

O SDK executa o comando conforme especificado no perfil e em seguida lê os dados do fluxo de saída padrão. O comando especificado, seja um script ou um programa binário, deverá gerar a saída JSON em `STDOUT` que corresponde à sintaxe a seguir. 

```
{
    "Version": 1,
    "AccessKeyId": "an AWS access key",
    "SecretAccessKey": "your AWS secret access key",
    "SessionToken": "the AWS session token for temporary credentials", 
    "Expiration": "RFC3339 timestamp for when the credentials expire"
}
```

**nota**  
No momento da elaboração deste documento, a chave `Version` deve ser definida como `1`. Isso pode aumentar ao longo do tempo conforme a estrutura evolui.

A `Expiration` chave é um carimbo de data/hora RFC3339 formatado. Se a chave `Expiration` não estiver presente na saída da ferramenta, o SDK vai supor que as credenciais são de longo prazo que não são atualizadas. Caso contrário, as credenciais serão consideradas temporárias e serão atualizadas automaticamente com a nova execução do comando `credential_process` antes de expirarem.

**nota**  
O SDK ***não*** armazena em cache as credenciais do processo externo como faz com credenciais assume-role. Se o armazenamento em cache for obrigatório, implemente-o no processo externo.

O processo externo pode retornar um código de retorno diferente de zero para indicar que ocorreu um erro ao recuperar as credenciais.

## Support by AWS SDKs and tools
<a name="feature-process-credentials-sdk-compat"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/) | Sim |  | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Sim |  | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Sim |  | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Sim | Para usar as configurações do arquivo config compartilhado, você deve ativar o carregamento do arquivo de configuração; consulte [Sessões](https://docs.aws.amazon.com/sdk-for-go/api/aws/session/). | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Sim |  | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Sim |  | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Sim |  | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Sim |  | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Sim |  | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim |  | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim |  | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sim |  | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Sim |  | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Sim |  | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Sim |  | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Sim |  | 

# AWS SDKs e ferramentas, recursos padronizados
<a name="standardized-features"></a>

Muitos recursos foram padronizados para padrões consistentes e para funcionar da mesma forma em muitos. SDKs Essa consistência aumenta a produtividade e a clareza ao codificar em vários SDKs. Todas as configurações podem ser substituídas no código. Consulte sua API específica do SDK para obter detalhes.

**Importante**  
Nem todos SDKs oferecem suporte a todos os recursos, ou mesmo a todos os aspectos de um recurso.

**Topics**
+ [Endpoints baseados em conta](feature-account-endpoints.md)
+ [ID da aplicação](feature-appid.md)
+ [Metadados da instância do Amazon EC2](feature-ec2-instance-metadata.md)
+ [Pontos de acesso Amazon S3](feature-s3-access-point.md)
+ [Pontos de acesso de várias regiões do Amazon S3](feature-s3-mrap.md)
+ [Autenticação de sessão da S3 Express One Zone](feature-s3-express.md)
+ [Esquema de autenticação](feature-auth-scheme.md)
+ [Região da AWS](feature-region.md)
+ [AWS STS Endpoints regionais](feature-sts-regionalized-endpoints.md)
+ [Proteções de integridade de dados](feature-dataintegrity.md)
+ [Endpoints de pilha dupla e FIPS](feature-endpoints.md)
+ [Descoberta de endpoint](feature-endpoint-discovery.md)
+ [Configuração geral](feature-gen-config.md)
+ [Injeção de prefixo de host](feature-host-prefix.md)
+ [Cliente de IMDS](feature-imds-client.md)
+ [Comportamento de repetição](feature-retry-behavior.md)
+ [Compactação de solicitações](feature-compression.md)
+ [Endpoints específicos de serviço](feature-ss-endpoints.md)
+ [Padrões de configuração inteligentes](feature-smart-config-defaults.md)

# Endpoints baseados em conta
<a name="feature-account-endpoints"></a>

**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, consulte[Entender as páginas de configurações deste guia](settings-reference.md#settingsPages).

Os endpoints baseados em conta ajudam a garantir alta performance e escalabilidade usando o seu ID da Conta da AWS para rotear solicitações para serviços compatíveis com esse atributo. Quando você usa um SDK da AWS e um serviço compatível com endpoints baseados em conta, o cliente do SDK cria e usa um endpoint baseado em conta em vez de um endpoint regional. Se o ID da conta não estiver visível para o cliente do SDK, ele usará o endpoint regional. Os endpoints baseados em conta assumem a forma de`https://<account-id>.ddb.<region>.amazonaws.com`, onde `<account-id>` e onde `<region>` está seu ID e. Conta da AWS Região da AWS

Configure essa funcionalidade usando o seguinte:

**`aws_account_id`- configuração de AWS `config` arquivo compartilhado`AWS_ACCOUNT_ID`: variável de ambiente`aws.accountId`- Propriedade do sistema JVM: somente Java/Kotlin **  
O Conta da AWS ID. Usado para roteamento de endpoints baseado em conta. Um ID da Conta da AWS tem um formato como 111122223333.   
 O roteamento de endpoints baseado em conta fornece melhor performance em solicitações para alguns serviços. 

**`account_id_endpoint_mode`- configuração de AWS `config` arquivo compartilhado`AWS_ACCOUNT_ID_ENDPOINT_MODE`: variável de ambiente`aws.accountIdEndpointMode`- Propriedade do sistema JVM: somente Java/Kotlin **  
Essa configuração é usada para desativar o roteamento de endpoint baseado em conta, se necessário, e ignorar as regras baseadas em conta.  
Valor padrão: `preferred`  
**Valores válidos:**  
+ **`preferred`**: o endpoint deve incluir o ID da conta, se disponível.
+ **`disabled`**: um endpoint resolvido não inclui o ID da conta.
+ **`required`**: o endpoint deve incluir o ID da conta. Se o ID da conta não estiver disponível, o SDK lançará um erro. 

## Support by AWS SDKs and tools
<a name="account-endpoints-sdk-compat"></a>

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 | Lançado na versão do SDK | Notas ou mais informações | 
| --- | --- | --- | --- | 
| [AWS CLI v2](https://docs.aws.amazon.com/cli/latest/userguide/) | Sim | 2.25.0 |  | 
| [AWS CLI v1](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-welcome.html) | Sim | 1.38,0 |  | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Não |  |  | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Sim | v1.35.0 |  | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Não |  |  | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Sim | v2.28.4 |  | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Sim | v1.12.771 |  | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Sim | v3.656.0 |  | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Não |  |  | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Sim | v1.3.37 |  | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Sim | 4.0.0 |  | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Não |  |  | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim | v3.318.0 |  | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim | 1.37.0 |  | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sim | v1.123.0 |  | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Sim | lançamento-2025-04-24 |  | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Sim | 1.2.0 |  | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Não |  |  | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Não |  |  | 

# ID da aplicação
<a name="feature-appid"></a>

**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, consulte[Entender as páginas de configurações deste guia](settings-reference.md#settingsPages).

Um único Conta da AWS pode ser usado por vários aplicativos de clientes para fazer chamadas para Serviços da AWS. O ID do aplicativo fornece uma maneira de os clientes identificarem qual aplicativo de origem fez um conjunto de chamadas usando um Conta da AWS. AWS SDKs e os serviços não usam nem interpretam esse valor a não ser para trazê-lo de volta às comunicações com o cliente. Por exemplo, esse valor pode ser incluído em e-mails operacionais ou no AWS Health Dashboard para identificar com exclusividade quais dos seus aplicativos estão associados à notificação. 

Configure essa funcionalidade usando o seguinte:

**`sdk_ua_app_id`- configuração de AWS `config` arquivo compartilhado`AWS_SDK_UA_APP_ID`: variável de ambiente`sdk.ua.appId`- Propriedade do sistema JVM: somente Java/Kotlin **  
Essa configuração é uma string exclusiva que você atribui ao seu aplicativo para identificar para quais aplicativos em um determinado aplicativo Conta da AWS fazem chamadas AWS.  
**Valor padrão**: `None`  
**Valores válidos:** string com comprimento máximo de 50. Letras, números e os seguintes caracteres especiais são permitidos: `!` `#``$`,`%`,`&`,`'`,`*`,`+`,`-`,`.`,`^`,`_`,```,`|`,`~`.

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

```
[default]
sdk_ua_app_id=ABCDEF
```

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

```
export AWS_SDK_UA_APP_ID=ABCDEF
export AWS_SDK_UA_APP_ID="ABC DEF"
```

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

```
setx AWS_SDK_UA_APP_ID ABCDEF
setx AWS_SDK_UA_APP_ID="ABC DEF"
```

Se você incluir símbolos que tenham um significado especial para o shell que está sendo usado, escape o valor conforme apropriado.

## Support by AWS SDKs and tools
<a name="appid-sdk-compat"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/) | Sim |  | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Sim | arquivo compartilhado config não suportado. | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Sim |  | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Não |  | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Parcial | Configuração de arquivo compartilhado config não compatível; variável de ambiente não compatível. | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Não |  | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Sim |  | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Não |  | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Sim | A propriedade do sistema de JVM é aws.userAgentAppId. | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Sim |  | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim |  | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim |  | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sim |  | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Sim |  | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Sim |  | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Sim |  | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Sim |  | 

# Metadados da instância do Amazon EC2
<a name="feature-ec2-instance-metadata"></a>

**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, consulte[Entender as páginas de configurações deste guia](settings-reference.md#settingsPages).

O Amazon EC2 fornece um serviço em instâncias chamado serviço de metadados de instância (IMDS). Para saber mais sobre esse serviço, consulte [Trabalhar com metadados de instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html) no *Guia do usuário do Amazon EC2*. Ao tentar recuperar credenciais em uma instância do Amazon EC2 que foi configurada com um perfil do IAM, uma conexão ao serviço de metadados da instância é ajustável. 

Configure essa funcionalidade usando o seguinte:

**`metadata_service_num_attempts`- configuração de AWS `config` arquivo compartilhado`AWS_METADATA_SERVICE_NUM_ATTEMPTS`: variável de ambiente**  
Esta configuração especifica o número de tentativas totais a serem feitas antes de desistir ao recuperar dados do serviço de metadados de instância.   
**Valor padrão:** 1  
**Valores válidos:** número maior ou igual a 1.

**`metadata_service_timeout`- configuração de AWS `config` arquivo compartilhado`AWS_METADATA_SERVICE_TIMEOUT`: variável de ambiente**  
Especifica o número de segundos antes de atingir o tempo limite ao recuperar dados do serviço de metadados da instância.   
**Valor padrão:** 1  
**Valores válidos:** número maior ou igual a 1.

Exemplo de configuração desses valores no arquivo `config`:

```
[default]
metadata_service_num_attempts=10
metadata_service_timeout=10
```

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

```
export AWS_METADATA_SERVICE_NUM_ATTEMPTS=10
export AWS_METADATA_SERVICE_TIMEOUT=10
```

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

```
setx AWS_METADATA_SERVICE_NUM_ATTEMPTS 10
setx AWS_METADATA_SERVICE_TIMEOUT 10
```

## Support by AWS SDKs and tools
<a name="feature-ec2-instance-metadata-sdk-compat"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/) | Sim |  | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Não |  | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Não |  | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Não |  | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Parcial | Somente AWS\$1METADATA\$1SERVICE\$1TIMEOUT é suportado. | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Parcial | Somente AWS\$1METADATA\$1SERVICE\$1TIMEOUT é suportado. | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Não |  | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Não |  | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Não |  | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Não |  | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Não |  | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim |  | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim |  | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Não |  | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Não |  | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Não |  | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Não |  | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Não |  | 

# Pontos de acesso Amazon S3
<a name="feature-s3-access-point"></a>

**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, consulte[Entender as páginas de configurações deste guia](settings-reference.md#settingsPages).

O serviço Amazon S3 fornece pontos de acesso como uma forma alternativa de interagir com os buckets do Amazon S3. Os pontos de acesso têm políticas e configurações exclusivas aplicadas a eles, em vez de diretamente ao bucket. Com AWS SDKs, você pode usar o ponto de acesso Amazon Resource Names (ARNs) no campo do bucket para operações de API em vez de especificar o nome do bucket explicitamente. Eles são usados para operações específicas, como usar um ponto de acesso ARN com o [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html) para buscar um objeto de um bucket ou usar um ponto de acesso ARN com o [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html) para adicionar um objeto a um bucket.

Para saber mais sobre os pontos de acesso do Amazon S3 e ARNs, consulte [Uso de pontos de acesso no Guia](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html) do usuário do *Amazon S3*. 

Configure essa funcionalidade usando o seguinte:

**`s3_use_arn_region`- configuração de AWS `config` arquivo compartilhado`AWS_S3_USE_ARN_REGION`: variável de ambiente`aws.s3UseArnRegion`- Propriedade do sistema JVM: somente Java/Kotlin Para configurar o valor diretamente no código, consulte diretamente seu SDK específico. **  
Essa configuração controla se o SDK usa o Região da AWS ARN do ponto de acesso para construir o endpoint regional para a solicitação. O SDK valida que o ARN Região da AWS é servido pela mesma AWS partição configurada pelo cliente Região da AWS para evitar chamadas entre partições que provavelmente falharão. Se definido por multiplicação, a configuração configurada pelo código terá precedência, seguida pela configuração da variável de ambiente.  
Valor padrão: `false`  
**Valores válidos:**  
+ **`true`**— O SDK usa os ARNs Região da AWS ao construir o endpoint em vez do configurado pelo cliente. Região da AWS Exceção: se a configuração do cliente Região da AWS for FIPS Região da AWS, ela deverá corresponder aos ARNs. Região da AWS Caso contrário, ocorrerá um erro.
+ **`false`**: o SDK usa a Região da AWS configurada pelo cliente ao construir o endpoint.

## Support by AWS SDKs and tools
<a name="access-point-sdk-compat"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/) | Sim |  | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Sim |  | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Sim |  | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Sim | Para usar as configurações do arquivo config compartilhado, você deve ativar o carregamento do arquivo de configuração; consulte [Sessões](https://docs.aws.amazon.com/sdk-for-go/api/aws/session/). | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Sim |  | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Sim | Propriedade do sistema de JVM não compatível. | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Sim |  | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Sim |  | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Sim | Não segue a precedência padrão, o valor do arquivo compartilhado config tem precedência sobre a variável de ambiente. | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim |  | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim |  | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sim |  | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Não |  | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Não |  | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Sim | Não segue a precedência padrão, o valor do arquivo compartilhado config tem precedência sobre a variável de ambiente. | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Sim | Não segue a precedência padrão, o valor do arquivo compartilhado config tem precedência sobre a variável de ambiente. | 

# Pontos de acesso de várias regiões do Amazon S3
<a name="feature-s3-mrap"></a>

**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, consulte[Entender as páginas de configurações deste guia](settings-reference.md#settingsPages).

Os pontos de acesso multirregionais do Amazon S3 fornecem um endpoint global que as aplicações podem usar para atender a solicitações de buckets do S3 localizados em várias Regiões da AWS. Você pode usar pontos de acesso multirregionais para criar aplicações de várias regiões com a mesma arquitetura usada em uma única região e, em seguida, executar essas aplicações em qualquer lugar do mundo. 

Para saber mais sobre pontos de acesso de várias regiões, consulte [Pontos de acesso de várias regiões no Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/MultiRegionAccessPoints.html), no *Guia do usuário do Amazon S3*. 

Para saber mais sobre o ponto de acesso multirregional Amazon Resource Names (ARNs), consulte [Fazer solicitações usando um ponto de acesso multirregional no Guia](https://docs.aws.amazon.com/AmazonS3/latest/userguide/MultiRegionAccessPointRequests.html) do usuário do *Amazon S3*.

Para saber mais sobre pontos de acesso de várias regiões, consulte [Gerenciar pontos de acesso de várias regiões](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ManagingMultiRegionAccessPoints.html) no *Guia do usuário do Amazon S3*.

O algoritmo SigV4a é a implementação de assinatura usada para assinar as solicitações globais da região. Este algoritmo é obtido pelo SDK por meio de uma dependência em [AWS Bibliotecas do Common Runtime (CRT)](common-runtime.md).

Configure essa funcionalidade usando o seguinte:

**`s3_disable_multiregion_access_points`- configuração de AWS `config` arquivo compartilhado`AWS_S3_DISABLE_MULTIREGION_ACCESS_POINTS`: variável de ambiente`aws.s3DisableMultiRegionAccessPoints`- Propriedade do sistema JVM: somente Java/Kotlin Para configurar o valor diretamente no código, consulte diretamente seu SDK específico. **  
Esta configuração controla se o SDK pode tentar solicitações entre regiões. Se definido por multiplicação, a configuração configurada pelo código terá precedência, seguida pela configuração da variável de ambiente.  
Valor padrão: `false`  
**Valores válidos:**  
+ **`true`**: interrompe o uso de solicitações entre regiões.
+ **`false`**: permite solicitações entre regiões usando pontos de acesso multirregionais.

## Support by AWS SDKs and tools
<a name="s3-mrap-sdk-compat"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/) | Sim |  | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Sim |  | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Sim |  | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Não |  | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Sim |  | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Não |  | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Sim |  | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Não |  | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Sim |  | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim |  | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim |  | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sim |  | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Sim |  | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Não |  | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Sim |  | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Sim |  | 

# Autenticação de sessão da S3 Express One Zone
<a name="feature-s3-express"></a>

**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, consulte[Entender as páginas de configurações deste guia](settings-reference.md#settingsPages).

O S3 Express One Zone é a classe de armazenamento de alta performance do Amazon S3 que fornece latência abaixo de dez milissegundos para dados acessados com frequência. Quando você usa buckets AWS SDKs e ferramentas do S3 Express One Zone, usa automaticamente a autenticação baseada em sessão, otimizada para autorização de baixa latência de solicitações de dados. Você usa tokens de sessão com operações zonais (nível de objeto) para distribuir a latência associada à autorização em várias solicitações em uma sessão, reduzindo a sobrecarga de autenticação e melhorando a performance geral de solicitação.

Os buckets do S3 Express One Zone usam um formato de nomenclatura específico que inclui o ID da zona de disponibilidade, como `bucket-name--usw2-az1--x-s3`. Quando o SDK detecta esse padrão de nomenclatura, encaminha automaticamente as solicitações para os endpoints apropriados do S3 Express One Zone e aplica o fluxo de autenticação otimizado. A autenticação da sessão cria credenciais temporárias específicas do bucket que fornecem acesso de baixa latência ao bucket e são armazenadas em cache e atualizadas automaticamente pelo SDK. Consulte [S3 Express One Zone](https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-high-performance.html#s3-express-one-zone) no *Guia do usuário do Amazon S3* para saber mais.

Por padrão, a autenticação de sessão está habilitada para buckets do S3 Express One Zone.

Configure essa funcionalidade usando o seguinte:

**`s3_disable_express_session_auth`- configuração de AWS `config` arquivo compartilhado`AWS_S3_DISABLE_EXPRESS_SESSION_AUTH`: variável de ambiente`aws.disableS3ExpressAuth`- Propriedade do sistema JVM: somente Java/Kotlin **  
Controla se a autenticação da sessão da S3 Express One Zone está desabilitada. Quando definido como `true`, o SDK usa a autenticação SigV4 padrão para buckets do S3 Express One Zone em vez da autenticação de sessão.  
Valor padrão: `false`  
**Valores válidos:**  
+ **`true`**: desabilitar a autenticação de sessão da S3 Express One Zone.
+ **`false`**: habilitar a autenticação de sessão da S3 Express One Zone.

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

```
[default]
s3_disable_express_session_auth=true
```

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

```
export AWS_S3_DISABLE_EXPRESS_SESSION_AUTH=true
```

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

```
setx AWS_S3_DISABLE_EXPRESS_SESSION_AUTH true
```

## Support by AWS SDKs and tools
<a name="s3-express-sdk-compat"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/) | Sim |  | 
| [AWS CLI v1](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-welcome.html) | Sim |  | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Sim |  | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Sim |  | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Não | Para usar as configurações do arquivo config compartilhado, você deve ativar o carregamento do arquivo de configuração; consulte [Sessões](https://docs.aws.amazon.com/sdk-for-go/api/aws/session/). | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Sim |  | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Não |  | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Sim |  | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Não |  | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Sim | A propriedade do sistema de JVM é aws.s3DisableExpressSessionAuth. | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Sim |  | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim |  | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim |  | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sim |  | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Sim |  | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Sim |  | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Sim |  | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Sim |  | 

# Esquema de autenticação
<a name="feature-auth-scheme"></a>

**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, consulte[Entender as páginas de configurações deste guia](settings-reference.md#settingsPages).

AWS os serviços oferecem suporte a vários esquemas de autenticação, como AWS Signature Version 4 (SigV4) e AWS Signature Version 4a (SigV4a). Por padrão, SDKs selecione esquemas de autenticação com base nas definições do modelo de serviço e priorize esquemas que ofereçam a melhor compatibilidade. Porém, você pode configurar seu esquema de autenticação preferido para otimizá-lo para requisitos específicos.

Ao contrário do SigV4, as solicitações assinadas com o SigV4a são válidas em várias Regiões da AWS. O SigV4a fornece maior disponibilidade por meio da assinatura de solicitação inter-regional, o que permite o failover automático para regiões de reserva durante interrupções regionais. Isso é particularmente benéfico para serviços globais como AWS Identity and Access Management a Amazon CloudFront. 

Para ter mais informações sobre esses dois esquemas de autenticação, consulte [AWS Signature Version 4 para solicitações de API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) no *Guia do usuário do IAM*.

Configure essa funcionalidade usando o seguinte:

**`auth_scheme_preference`- configuração de AWS `config` arquivo compartilhado`AWS_AUTH_SCHEME_PREFERENCE`: variável de ambiente`aws.authSchemePreference`- Propriedade do sistema JVM: somente Java/Kotlin **  
Especifica uma lista separada por vírgulas de esquemas de autenticação preferenciais em ordem de prioridade. Quando um serviço é compatível com vários esquemas de autenticação, o SDK tenta usar os esquemas dessa lista na ordem especificada, voltando ao comportamento padrão se nenhum dos esquemas preferenciais estiver disponível.  
**Valor padrão**: Nenhum.  
**Valores válidos:** uma lista separada por vírgulas de um ou mais dos seguintes itens:  
+ **`sigv4`**: Signature Version 4 (performance mais rápida, região única)
+ **`sigv4a`**: Signature Version 4a (disponibilidade aprimorada, compatibilidade inter-regional, tem uma performance de assinatura mais lenta que o SigV4)
+ **`httpBearerAuth`**: Autenticação com token de portador HTTP
Os caracteres espaço e tabulação entre nomes de esquemas são ignorados.   
Exemplo de configuração desse valor no arquivo `config` para preferir o SigV4a:  

```
[default]
auth_scheme_preference=sigv4a,sigv4
```

**`sigv4a_signing_region_set`- configuração de AWS `config` arquivo compartilhado`AWS_SIGV4A_SIGNING_REGION_SET`: variável de ambiente**  
Especifica uma lista separada por vírgulas Regiões da AWS para assinatura multirregional SigV4a. Isso é usado como a região padrão definida para a solicitação se o SigV4a for o esquema de autenticação selecionado.  
**Valor padrão:** determinado pela solicitação.  
**Valores válidos:** lista separada por vírgulas de Regiões da AWS. Os caracteres espaço e tabulação entre nomes de regiões são ignorados. 

## Support by AWS SDKs and tools
<a name="auth-scheme-sdk-compat"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/) | Sim |  | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Sim |  | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Sim |  | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Não |  | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Sim |  | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Não |  | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Sim |  | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Não |  | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Não |  | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim |  | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim |  | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sim |  | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Sim |  | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Sim |  | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Sim |  | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Não |  | 

# Região da AWS
<a name="feature-region"></a>

**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, consulte[Entender as páginas de configurações deste guia](settings-reference.md#settingsPages).

Regiões da AWS são um conceito importante a ser entendido ao trabalhar com Serviços da AWS. 

Com Regiões da AWS, você pode acessar aqueles Serviços da AWS que residem fisicamente em uma área geográfica específica. Isso pode ser útil para manter os seus dados e aplicativos em execução próximo ao lugar em que você e os seus usuários os acessarão. As regiões fornecem tolerância a falhas, estabilidade e resiliência e também podem reduzir a latência. Com Regiões, você pode criar recursos redundantes que permanecem disponíveis e não são afetados por uma interrupção regional.

A maioria das AWS service (Serviço da AWS) solicitações está associada a uma região geográfica específica. Os atributos que você cria em uma Região não existem em qualquer outra Região, a menos que você use explicitamente um atributo de replicação oferecido por AWS service (Serviço da AWS). Por exemplo, o Amazon S3 e o Amazon EC2 oferecem suporte à replicação entre Regiões. Alguns serviços, como o IAM, não têm Recursos regionais.

A *Referência geral da AWS* contém as seguintes informações:
+  Para entender a relação entre Regiões e endpoints e ver uma lista dos endpoints regionais existentes, consulte [Endpoints de serviço da AWS](https://docs.aws.amazon.com/general/latest/gr/rande.html).
+ Para exibir a lista atual de todas as Regiões e endpoints compatíveis para cada AWS service (Serviço da AWS), consulte [Endpoints e cotas de serviço](https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html).

**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) Se precisar acessar o Amazon EC2, por exemplo, seu aplicativo criará um objeto cliente do Amazon EC2 para interagir com esse serviço.

Se nenhuma região for especificada explicitamente para o cliente, ele usará por padrão a região definida por meio da configuração `region` a seguir. No entanto, a Região ativa de um cliente pode ser definida explicitamente para qualquer objeto de cliente individual. Definir a Região desta maneira tem precedência sobre qualquer configuração global para aquele cliente de serviço particular. A Região alternativa é definida durante a instanciação desse cliente, específica para seu SDK (consulte o Guia do seu SDK ou a base de código do seu SDK).

Configure essa funcionalidade usando o seguinte:

**`region`- configuração de AWS `config` arquivo compartilhado`AWS_REGION`: variável de ambiente`aws.region`- Propriedade do sistema JVM: somente Java/Kotlin **  
Especifica o padrão Região da AWS a ser usado para AWS solicitações. Essa região é usada para solicitações de serviço do SDK que não são fornecidas com uma Região específica para uso.  
**Valor padrão:** nenhum. Você deve especificar esse valor explicitamente.  
**Valores válidos:**   
+ Qualquer um dos códigos de Região disponíveis para o serviço escolhido, conforme listado em [Endpoints de serviço da AWS](https://docs.aws.amazon.com/general/latest/gr/rande.html) na *Referência geral da AWS *. Por exemplo, o valor `us-east-1` define o endpoint para a Região da AWS Leste dos EUA (Norte da Virgínia).
+ `aws-global`especifica o endpoint global para serviços que oferecem suporte a um endpoint global separado, além dos endpoints regionais, como AWS Security Token Service ()AWS STS e Amazon Simple Storage Service (Amazon S3).

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

```
[default]
region = us-west-2
```

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

```
export AWS_REGION=us-west-2
```

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

```
setx AWS_REGION us-west-2
```

A maioria SDKs tem um objeto de “configuração” que está disponível para definir a região padrão a partir do código do aplicativo. Para obter detalhes, consulte seu guia específico para desenvolvedores do AWS SDK.

## Support by AWS SDKs and tools
<a name="feature-region-sdk-compat"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/) | Sim | AWS CLI v2 usa qualquer valor em AWS\$1REGION antes de qualquer valor em AWS\$1DEFAULT\$1REGION (ambas as variáveis são verificadas). | 
| [AWS CLI v1](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-welcome.html) | Sim | AWS CLI v1 usa uma variável de ambiente nomeada AWS\$1DEFAULT\$1REGION para essa finalidade. | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Sim |  | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Sim |  | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Sim | Para usar as configurações do arquivo config compartilhado, você deve ativar o carregamento do arquivo de configuração; consulte [Sessões](https://docs.aws.amazon.com/sdk-for-go/api/aws/session/). | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Sim |  | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Sim |  | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Sim |  | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Sim |  | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Sim |  | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim |  | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim | Este SDK usa uma variável de ambiente nomeada AWS\$1DEFAULT\$1REGION para essa finalidade. | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sim |  | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Sim |  | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Sim |  | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Sim |  | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Sim |  | 

# AWS STS Endpoints regionais
<a name="feature-sts-regionalized-endpoints"></a>

**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, consulte[Entender as páginas de configurações deste guia](settings-reference.md#settingsPages).

 AWS Security Token Service (AWS STS) está disponível como um serviço global e regional. Alguns CLIs usam o endpoint de AWS SDKs serviço global (`https://sts.amazonaws.com`) por padrão, enquanto outros usam os endpoints de serviço regional ()`https://sts.{region_identifier}.{partition_domain}`. Nas regiões [habilitadas por padrão](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html), as solicitações para o endpoint AWS STS global são atendidas automaticamente na mesma região de origem da solicitação. Nas regiões opcionais, as solicitações para o endpoint AWS STS global são atendidas por um único Região da AWS Leste dos EUA (Norte da Virgínia). Para obter mais informações sobre AWS STS endpoints, consulte [Endpoints](https://docs.aws.amazon.com/STS/latest/APIReference/welcome.html#sts-endpoints) na *Referência da AWS Security Token Service API* ou [Gerenciar AWS STS em um Região da AWS no](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_enable-regions.html) Guia do *AWS Identity and Access Management usuário*.

É uma prática AWS recomendada usar endpoints regionais sempre que possível e configurar seus[Região da AWS](feature-region.md). Clientes em [partições](https://docs.aws.amazon.com/glossary/latest/reference/glos-chap.html?id=docs_gateway#partition) que não são comerciais devem usar endpoints regionais. Nem todas SDKs as ferramentas oferecem suporte a essa configuração, mas todas têm um comportamento definido em relação aos endpoints globais e regionais. Consulte a seção a seguir para ter mais informações.

**nota**  
AWS fez alterações no endpoint global AWS Security Token Service (AWS STS) (`https://sts.amazonaws.com`) em regiões [habilitadas por padrão](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html) para aprimorar sua resiliência e desempenho. AWS STS as solicitações para o endpoint global são atendidas automaticamente da Região da AWS mesma forma que suas cargas de trabalho. Essas alterações não serão implantadas em regiões opt-in. Recomendamos que você use os endpoints AWS STS regionais apropriados. Para obter mais informações, consulte [Alterações em endpoints globais do AWS STS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_region-endpoints.html#reference_sts_global_endpoint_changes) no *Guia do usuário do AWS Identity and Access Management *.

Para SDKs as ferramentas que oferecem suporte a essa configuração, os clientes podem configurar a funcionalidade usando o seguinte:

**`sts_regional_endpoints`- configuração de AWS `config` arquivo compartilhado`AWS_STS_REGIONAL_ENDPOINTS`: variável de ambiente**  
Essa configuração especifica como o SDK ou a ferramenta determina o AWS service (Serviço da AWS) endpoint que ele usa para se comunicar com o AWS Security Token Service ().AWS STS  
**Valor padrão:** `regional`, veja as exceções na tabela a seguir.   
Todas as novas versões principais do SDK lançadas após julho de 2022 terão como padrão `regional`. As novas versões principais do SDK podem remover essa configuração e usar o comportamento `regional`. Para reduzir o impacto futuro em relação a essa alteração, recomendamos que você comece a usar `regional` em seu aplicativo sempre que possível.
**Valores válidos:** *(Valor recomendado: `regional`)*   
+ **`legacy`**— Usa o AWS STS endpoint global,`sts.amazonaws.com`.
+ **`regional`**— O SDK ou a ferramenta sempre usa o AWS STS endpoint da região atualmente configurada. Por exemplo, se o cliente estiver configurado para usar`us-west-2`, todas as chamadas AWS STS serão feitas para o endpoint regional`sts.us-west-2.amazonaws.com`, em vez do `sts.amazonaws.com` endpoint global. Para enviar uma solicitação para o endpoint global enquanto a configuração é habilitada, você pode definir a Região como `aws-global`.
Exemplo de configuração desses valores no arquivo `config`:  

```
[default]
sts_regional_endpoints = regional
```
Exemplo de configuração de variáveis de ambiente para Linux/macOS por meio da linha de comando:  

```
export AWS_STS_REGIONAL_ENDPOINTS=regional
```
Exemplo do Windows de configuração de variáveis de ambiente por meio da linha de comando:  

```
setx AWS_STS_REGIONAL_ENDPOINTS regional
```

## Support by AWS SDKs and tools
<a name="feature-sts-regionalized-endpoints-sdk-compat"></a>

**nota**  
É uma prática AWS recomendada usar endpoints regionais sempre que possível e configurar seus[Região da AWS](feature-region.md). 

 A tabela a seguir resume, para o SDK ou a ferramenta:
+ **Compatível com a configuração**: se a variável do arquivo compartilhado `config` e a variável de ambiente para endpoints regionais do STS são compatíveis. 
+ **Valor da configuração padrão**: o valor padrão da configuração, se for compatível. 
+ **Endpoint do STS de destino do cliente de serviço padrão**: qual endpoint padrão é usado pelo cliente, mesmo que a configuração para alterá-lo não esteja disponível. 
+ **Comportamento de fallback do cliente de serviço**: o que o SDK faz quando deveria usar um endpoint regional, mas nenhuma região foi configurada. Esse é o comportamento, independentemente de ele estar usando um endpoint regional por causa de um padrão ou porque `regional` foi selecionado pela configuração. 

A tabela usa também os seguintes valores:
+ **Endpoint global**: `https://sts.amazonaws.com`.
+ **Endpoint regional**: com base na [Região da AWS](feature-region.md) configurada usada pela aplicação. 
+ **`us-east-1` (Regional)**: usa o endpoint da região `us-east-1`, mas com tokens de sessão mais longos que as solicitações globais comuns. 


| SDK |  Compatível com a configuração  |  Valor padrão da configuração  |  Endpoint do STS de destino de cliente de serviço padrão  |  Comportamento de fallback de cliente de serviço  | Notas ou mais informações | 
| --- | --- | --- | --- | --- | --- | 
| [AWS CLI v2](https://docs.aws.amazon.com/cli/latest/userguide/) | Não | N/D | Endpoint regional | Endpoint global |  | 
| [AWS CLI v1](https://docs.aws.amazon.com/cli/v1/userguide/cli-chap-welcome.html) | Sim | legacy | Endpoint global | Endpoint global |  | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Não | N/D | Endpoint regional | us-east-1 (Regional) |  | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Não | N/D | Endpoint regional | Falha na solicitação |  | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Sim | legacy | Endpoint global | Endpoint global | Para usar as configurações do arquivo config compartilhado, você deve ativar o carregamento do arquivo de configuração; consulte [Sessões](https://docs.aws.amazon.com/sdk-for-go/api/aws/session/). | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Não | N/D | Endpoint regional | Falha na solicitação |  Se nenhuma região estiver configurada, `AssumeRole` e `AssumeRoleWithWebIdentity` usarão o endpoint global do STS.  | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Sim | legacy | Endpoint global | Endpoint global |  | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Não | N/D | Endpoint regional | us-east-1 (Regional) |  | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Sim | legacy | Endpoint global | Endpoint global |  | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Não | N/D | Endpoint regional | Endpoint global |  | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Não | N/D | Endpoint regional | us-east-1 (Regional) |  | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Sim | regional | Endpoint global | Endpoint global |  | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim | regional | Endpoint global | Falha na solicitação |  | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim | regional | Endpoint global | Endpoint global |  | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sim | regional | Endpoint regional | Falha na solicitação |  | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Não | N/D | Endpoint regional | Falha na solicitação |  | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Não | N/D | Endpoint regional | Falha na solicitação |  | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Sim | regional | Endpoint global | Endpoint global |  | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Sim | regional | Endpoint global | Endpoint global |  | 

# Proteções de integridade de dados para o Amazon S3
<a name="feature-dataintegrity"></a>

**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, consulte[Entender as páginas de configurações deste guia](settings-reference.md#settingsPages).

Há algum tempo, AWS SDKs suportamos verificações de integridade de dados ao carregar ou baixar dados do Amazon Simple Storage Service. Antes, essas verificações eram opcionais. Agora, habilitamos essas verificações por padrão, usando algoritmos baseados em CRC, como CRC32 ou CRC64 NVME. Embora cada SDK ou ferramenta tenha um algoritmo padrão, você pode escolher um algoritmo diferente. Se desejar, você também pode continuar fornecendo manualmente uma soma de verificação pré-calculada para os uploads. O comportamento consistente entre uploads, uploads em várias partes, downloads e modos de criptografia simplifica as verificações de integridade do lado do cliente. 

 As versões mais recentes do nosso AWS SDKs calculam AWS CLI automaticamente uma [soma de verificação baseada em verificação de redundância cíclica (CRC)](https://en.wikipedia.org/wiki/Cyclic_redundancy_check) para cada upload e a enviam para o Amazon S3. Em seguida, o Amazon S3 calcula independentemente um valor de soma de verificação do objeto do lado do servidor e o valida com o valor fornecido antes de armazenar o objeto e o valor da soma de verificação nos metadados do objeto. Ao armazenar a soma de verificação nos metadados junto com o objeto, quando o objeto é baixado, a mesma soma de verificação também pode ser retornada automaticamente e usada para validar os downloads. Você também pode confirmar a soma de verificação armazenada nos metadados do objeto a qualquer momento. 

 Para saber mais sobre operações de soma de verificação, uploads com várias partes ou a lista de algoritmos de soma de verificação compatíveis, consulte [Verificar a integridade do objeto no Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html) *Guia do usuário do Amazon Simple Storage Service*. 

 **Uploads com várias partes:**

O Amazon S3 também fornece aos desenvolvedores somas de verificação completas e consistentes entre os objetos em uploads com uma única parte e com várias partes. 

Ao fazer upload de arquivos em várias partes, SDKs calcule as somas de verificação para cada parte. O Amazon S3 usa essas somas de verificação para verificar a integridade de cada parte por meio da API `UploadPart`. Além disso, o Amazon S3 valida o tamanho e a soma de verificação do arquivo inteiro quando você chama a API `CompleteMultipartUpload`. 

Se o SDK tiver um Amazon S3 Transfer Manager para auxiliar nos uploads de várias partes, as somas de verificação serão validadas para as partes usando o algoritmo padrão específico do SDK encontrado na tabela [Support by AWS SDKs and tools](#dataintegrity-sdk-compat). Você pode optar por uma soma de verificação completa do objeto definindo `checksum_type` a configuração `FULL_OBJECT` ou optando por usar o algoritmo CRC64 NVME.

** Se você estiver usando uma versão mais antiga de SDK ou AWS CLI:** 

Se seu aplicativo usa uma versão anterior a dezembro de 2024 do SDK ou da ferramenta, o Amazon S3 ainda computa CRC64 uma soma de verificação NVME em novos objetos e a armazena nos metadados do objeto para referência futura. Você pode comparar depois o CRC armazenado com um CRC calculado do seu lado e verificar se a transmissão da rede estava correta. Além disso, você ainda pode estender manualmente a proteção de integridade fornecendo suas próprias somas de verificação computadas previamente com suas solicitações de [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html) ou [https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html), que é a técnica padrão para lidar com isso nas versões mais antigas. 



Configure essa funcionalidade usando o seguinte:

**`request_checksum_calculation`- configuração de AWS `config` arquivo compartilhado`AWS_REQUEST_CHECKSUM_CALCULATION`: variável de ambiente`aws.requestChecksumCalculation`- Propriedade do sistema JVM: somente Java/Kotlin **  
Por padrão, os usuários optam por calcular a soma de verificação da solicitação ao enviar uma solicitação. O usuário pode escolher um dos [algoritmos de soma de verificação disponíveis](https://docs.aws.amazon.com/AmazonS3/latest/API/API_Checksum.html) como parte da criação da solicitação. Caso contrário, é usado um algoritmo padrão específico do SDK. Consulte a tabela [Support by AWS SDKs and tools](#dataintegrity-sdk-compat) para ver o algoritmo padrão para cada SDK ou ferramenta.  
Valor padrão: `WHEN_SUPPORTED`  
**Valores válidos:**  
+ **`WHEN_SUPPORTED`**: a validação da soma de verificação é realizada em todas as cargas úteis de solicitação quando compatível com a operação da API, como transferências de dados para o Amazon S3.
+ **`WHEN_REQUIRED`**: a validação da soma de verificação é realizada somente quando exigido pela operação da API.

**`response_checksum_validation`- configuração de AWS `config` arquivo compartilhado`AWS_RESPONSE_CHECKSUM_VALIDATION`: variável de ambiente`aws.responseChecksumValidation`- Propriedade do sistema JVM: somente Java/Kotlin **  
Por padrão, os usuários optam por uma validação da soma de verificação ao enviar uma solicitação. Uma soma de verificação para a carga útil da resposta é calculada e comparada com o cabeçalho da resposta da soma de verificação. Se houver falha na validação da soma de verificação, será gerado um erro para o usuário quando a carga útil for lida.  
 O cabeçalho da resposta da soma de verificação também indica o algoritmo para a soma de verificação. O cliente Amazon S3 tenta validar somas de verificação de resposta para todas as operações de API do Amazon S3 compatíveis com somas de verificação. Porém, se o SDK não tiver implementado o algoritmo de soma de verificação especificado, essa validação será ignorada.   
Valor padrão: `WHEN_SUPPORTED`  
**Valores válidos:**  
+ **`WHEN_SUPPORTED`**: a validação da soma de verificação é realizada em todas as cargas úteis de resposta quando compatível com a operação de API, como transferências de dados para o Amazon S3.
+ **`WHEN_REQUIRED`**: a validação da soma de verificação é realizada somente quando compatível com a operação de API e quando o chamador habilitou explicitamente a soma de verificação para a operação. Por exemplo, quando a API `GetObject` do Amazon S3 é chamada e o parâmetro `ChecksumMode` é definido como habilitado.

## Support by AWS SDKs and tools
<a name="dataintegrity-sdk-compat"></a>

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.

**nota**  
Na tabela a seguir, "CRT" se refere ao [AWS Bibliotecas do Common Runtime (CRT)](common-runtime.md) e pode exigir a adição de uma dependência adicional ao projeto.


| SDK | Compatível | Algoritmo da soma de verificação padrão | Algoritmos de soma de verificação compatíveis | Notas ou mais informações | 
| --- | --- | --- | --- | --- | 
| [AWS CLI v2](https://docs.aws.amazon.com/cli/latest/userguide/) | Sim | CRC64NVME | CRC64NVME, CRC32 C CRC32,, SHA1 SHA256 | Para a AWS CLI v1, o algoritmo padrão e os algoritmos suportados serão idênticos ao Python (Boto3). | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Sim | CRC64NVME | CRC64NVME, CRC32 C CRC32,, SHA1 SHA256 |  | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Sim | CRC32 | CRC64NVME, CRC32 C CRC32,, SHA1 SHA256 |  | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Não |  |  |  | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Sim | CRC32 | CRC64NVME (somente via CRT),, C, CRC32, CRC32 SHA1 SHA256 |  | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Não |  |  |  | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Sim | CRC32 | CRC32, CRC32 C, SHA1, SHA256 |  | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Não |  |  |  | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Sim | CRC32 | CRC32, CRC32 C, SHA1, SHA256 |  | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Sim | CRC32 | CRC32, CRC32 C, SHA1, SHA256 |  | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Sim | CRC32 | CRC32, CRC32 C, SHA1, SHA256 |  | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim | CRC32 | CRC32, CRC32 C (somente via CRT),, SHA1 SHA256 | awscrta extensão é necessária para usar CRC32 C. | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim | CRC32 | CRC64NVME (somente via CRT) CRC32, CRC32 C (somente via CRT),, SHA1 SHA256 |  | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sim | CRC32 | CRC64NVME (somente via CRT) CRC32, CRC32 C (somente via CRT),, SHA1 SHA256 |  | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Sim | CRC32 | CRC64NVME, CRC32 C CRC32,, SHA1 SHA256 |  | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Sim | CRC32 | CRC64NVME, CRC32 C CRC32,, SHA1 SHA256 | Dependência de CRT requerida para todos os algoritmos. | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Sim | CRC32 | CRC32, CRC32 C, SHA1, SHA256 |  | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Sim | CRC32 | CRC32, CRC32 C, SHA1, SHA256 |  | 

# Endpoints de pilha dupla e FIPS
<a name="feature-endpoints"></a>

**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, consulte[Entender as páginas de configurações deste guia](settings-reference.md#settingsPages).

Configure essa funcionalidade usando o seguinte:

**`use_dualstack_endpoint`- configuração de AWS `config` arquivo compartilhado`AWS_USE_DUALSTACK_ENDPOINT`: variável de ambiente`aws.useDualstackEndpoint`- Propriedade do sistema JVM: somente Java/Kotlin **  
Ativa ou desativa se o SDK enviará solicitações para endpoints de pilha dupla. *Para saber mais sobre endpoints de pilha dupla, que oferecem suporte tanto ao tráfego quanto ao IPv6 tráfego, consulte Como IPv4 usar endpoints de [pilha dupla do Amazon S3 no Guia do usuário do Amazon Simple Storage](https://docs.aws.amazon.com/AmazonS3/latest/userguide/dual-stack-endpoints.html) Service.* Endpoints de pilha dupla estão disponíveis para alguns serviços em algumas regiões.  
**Valor padrão:** `false`  
**Valores válidos:**  
+ **`true`**: o SDK ou a ferramenta tentará usar endpoints de pilha dupla para fazer solicitações de rede. Se não existir um endpoint de pilha dupla para o serviço e/ou Região da AWS, a solicitação falhará.
+ **`false`**: o SDK ou a ferramenta não usarão endpoints de pilha dupla para fazer solicitações de rede.

**`use_fips_endpoint`- configuração de AWS `config` arquivo compartilhado`AWS_USE_FIPS_ENDPOINT`: variável de ambiente`aws.useFipsEndpoint`- Propriedade do sistema JVM: somente Java/Kotlin **  
Ativa ou desativa se o SDK enviará solicitações para endpoints de pilha dupla. Os Padrões federais de processo de informação (FIPS) são um conjunto de requisitos de segurança do governo dos EUA para dados e sua criptografia. Agências governamentais, parceiros e aqueles que desejam fazer negócios com o governo federal devem seguir as diretrizes do FIPS. Diferentemente dos AWS endpoints padrão, os endpoints FIPS usam uma biblioteca de software TLS validada em relação ao FIPS 140. Se essa configuração estiver ativada e não existir um endpoint FIPS para o serviço em seu Região da AWS, a AWS chamada poderá falhar. [Endpoints específicos de serviço](feature-ss-endpoints.md)e a `--endpoint-url` opção de AWS Command Line Interface substituir essa configuração.  
Para saber mais sobre outras formas de especificar endpoints FIPS por Região da AWS, consulte [FIPS Endpoints](https://aws.amazon.com/compliance/fips/) por serviço. *Para obter mais informações sobre os endpoints do serviço Amazon Elastic Compute Cloud, consulte endpoints de [pilha dupla (IPv4 e IPv6) na](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Using_Endpoints.html#ipv6) Referência de API do Amazon EC2.*   
Valor padrão: `false`  
**Valores válidos:**  
+ **`true`**: o SDK ou a ferramenta enviará solicitações para endpoints compatíveis com FIPS.
+ **`false`**: o SDK ou a ferramenta não enviará solicitações para endpoints compatíveis com FIPS.

## Support by AWS SDKs and tools
<a name="endpoints-sdk-compat"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/) | Sim |  | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Sim |  | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Sim |  | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Sim | Para usar as configurações do arquivo config compartilhado, você deve ativar o carregamento do arquivo de configuração; consulte [Sessões](https://docs.aws.amazon.com/sdk-for-go/api/aws/session/). | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Sim |  | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Não |  | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Sim |  | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Sim |  | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Sim |  | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim |  | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim |  | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sim |  | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Sim |  | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Sim |  | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Sim |  | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Sim |  | 

# Descoberta de endpoint
<a name="feature-endpoint-discovery"></a>

**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, consulte[Entender as páginas de configurações deste guia](settings-reference.md#settingsPages).

SDKs use a descoberta de endpoints para acessar os endpoints de serviço (URLs para acessar vários recursos), mantendo a flexibilidade AWS para alterá-los URLs conforme necessário. Dessa forma, seu código pode detectar automaticamente novos endpoints. Não há endpoints fixos para alguns serviços. Em vez disso, você obtém os endpoints disponíveis durante o runtime fazendo uma solicitação para obter os endpoints primeiro. Depois de recuperar os endpoints disponíveis, o código usa o endpoint para acessar outras operações. Por exemplo, para o Amazon Timestream, o SDK faz uma solicitação `DescribeEndpoints` para recuperar os endpoints disponíveis e, em seguida, usa esses endpoints para concluir operações específicas, como `CreateDatabase` ou `CreateTable`.

Configure essa funcionalidade usando o seguinte:

**`endpoint_discovery_enabled`- configuração de AWS `config` arquivo compartilhado`AWS_ENABLE_ENDPOINT_DISCOVERY`: variável de ambiente`aws.endpointDiscoveryEnabled`- Propriedade do sistema JVM: somente Java/Kotlin Para configurar o valor diretamente no código, consulte diretamente seu SDK específico. **  
Ativa ou desativa a descoberta de endpoints para o DynamoDB.   
A descoberta de endpoint é obrigatória no Timestream e opcional no Amazon DynamoDB. O padrão para essa configuração é `true` ou `false`, dependendo de o serviço exigir ou não descoberta de endpoint. O padrão para solicitações do Timestream é `true` e para as solicitações do Amazon DynamoDB é `false`.   
**Valores válidos:**  
+ **`true`**: o SDK deve tentar descobrir automaticamente um endpoint para serviços em que a descoberta de endpoint é opcional.
+ **`false`**: o SDK deve tentar descobrir automaticamente um endpoint para serviços em que a descoberta de endpoint é opcional.

## Support by AWS SDKs and tools
<a name="endpoint-discovery-sdk-compat"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/) | Sim |  | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Sim |  | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Sim |  | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Sim | Para usar as configurações do arquivo config compartilhado, você deve ativar o carregamento do arquivo de configuração; consulte [Sessões](https://docs.aws.amazon.com/sdk-for-go/api/aws/session/). | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Sim | O SDK para Java 2.x usa AWS\$1ENDPOINT\$1DISCOVERY\$1ENABLED para o nome da variável de ambiente. | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Parcial | Propriedade do sistema de JVM não compatível. | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Sim |  | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Sim |  | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Sim |  | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim |  | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim |  | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sim |  | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Parcial | Compatível somente com Timestream. | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Não |  | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Sim |  | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Sim |  | 

# Definições gerais da configuração
<a name="feature-gen-config"></a>

**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, consulte[Entender as páginas de configurações deste guia](settings-reference.md#settingsPages).

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 AWS `config` 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 AWS `config` arquivo compartilhado`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 SSL/TLS conexões.  
**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 AWS `config` 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:**  
+ **[https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html#json-output](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html#json-output)**: a saída é formatada como uma string [JSON](https://json.org/).
+  **[https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html#yaml-output](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html#yaml-output)**: a saída é formatada como uma string [YAML](https://yaml.org/).
+ **[https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html#yaml-stream-output](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html#yaml-stream-output)**: a saída é transmitida e formatada como uma string [YAML](https://yaml.org/). A transmissão possibilita um manuseio mais rápido de tipos de dados grandes.
+ **[https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html#text-output](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html#text-output)**: 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`.
+ **[https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html#table-output](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output-format.html#table-output)**: a saída é formatada como uma tabela usando os caracteres \$1\$1- 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 AWS `config` 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
<a name="feature-gen-config-sdk-compat"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/) | Parcial | api\$1versions incompatível. | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Sim |  | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Parcial | api\$1versions e parameter\$1validation não são compatíveis. | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Parcial | api\$1versions e parameter\$1validation 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](https://docs.aws.amazon.com/sdk-for-go/api/aws/session/). | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Não |  | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Não |  | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Sim |  | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Sim |  | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Não |  | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Não |  | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Não |  | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim |  | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim |  | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sim |  | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Não |  | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Não |  | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Não |  | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Não |  | 

# Injeção de prefixo de host
<a name="feature-host-prefix"></a>

**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, consulte[Entender as páginas de configurações deste guia](settings-reference.md#settingsPages).

A injeção de prefixo de host é um recurso em que se AWS SDKs acrescenta automaticamente um prefixo ao nome do host dos endpoints de serviço para determinadas operações de API. Esse prefixo pode ser uma string estática ou um valor dinâmico que inclui dados dos parâmetros da solicitação.

Por exemplo, ao usar o Amazon Simple Storage Service para realizar ações em objetos ou buckets do Amazon S3, o SDK substitui o nome e o Conta da AWS ID do bucket no endpoint final da API. 

Embora esse comportamento seja necessário para endpoints de AWS serviço normais, ele pode causar problemas ao usar endpoints personalizados, como endpoints VPC ou ferramentas de teste locais. Nesses casos, pode ser necessário desabilitar a injeção de prefixo de host.

Configure essa funcionalidade usando o seguinte:

**`disable_host_prefix_injection`- configuração de AWS `config` arquivo compartilhado`AWS_DISABLE_HOST_PREFIX_INJECTION`: variável de ambiente`aws.disableHostPrefixInjection`- Propriedade do sistema JVM: somente Java/Kotlin **  
Essa configuração controla se o SDK ou a ferramenta modificará o nome do host do endpoint colocando um prefixo de host no início, conforme definido no objeto ou na variável de cliente do SDK.  
Valor padrão: `false`  
**Valores válidos:**  
+ **`true`**: desabilitar injeção de prefixo de host. O SDK não modificará o nome do host do endpoint.
+ **`false`**: habilitar injeção de prefixo de host. O SDK acrescentará o prefixo de host ao nome do host do endpoint.

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

```
[default]
disable_host_prefix_injection = true
```

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

```
export AWS_DISABLE_HOST_PREFIX_INJECTION=true
```

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

```
setx AWS_DISABLE_HOST_PREFIX_INJECTION true
```

## Exemplos de injeção de prefixo de host
<a name="hostprefix_examples"></a>

A tabela de exemplos a seguir mostra como SDKs modificar o endpoint final quando a injeção de prefixo do host está ativada e desativada.
+ **Prefixo de host**: o modelo da string de caracteres de propriedade de prefixo de host definida no objeto ou na variável de cliente do SDK no código.
+ **Entradas**: entradas adicionais definidas no objeto ou na variável de cliente do SDK no código.
+ **Endpoint do cliente**: o endpoint derivado do cliente.
+ **Valor da configuração**: valor resolvido para a configuração anterior.
+ **Endpoint resultante**: o endpoint resultante que o cliente do SDK usa para fazer a chamada de API.


| Prefixo do host | Entradas | Endpoint do cliente | Valor da configuração | Endpoint resultante | 
| --- |--- |--- |--- |--- |
| “dados”. | \$1\$1 | "https://service.us-west-2.amazonaws.com" | false | "https://data.service.us-west-2.amazonaws.com" | 
| “\$1Balde\$1 - \$1AccountId\$1.” | Caçamba: “amzn-s3-demo-bucket1",:" 123456789012" AccountId | "https://service.us-west-2.amazonaws.com" | false | "https://amzn-s3-demo-bucket1-123456789012.service.us-west-2.amazonaws.com" | 
| “dados”. | \$1\$1 | "https://override.us-west-2.amazonaws.com"(como um endpoint de substituição) | true | "https://override.us-west-2.amazonaws.com" | 

## Support by AWS SDKs and tools
<a name="host-prefix-sdk-compat"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/) | Sim |  | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Não | Configuração não compatível, mas pode ser configurada no código do cliente usando: [https://sdk.amazonaws.com/cpp/api/LATEST/aws-cpp-sdk-core/html/struct_aws_1_1_client_1_1_client_configuration.html](https://sdk.amazonaws.com/cpp/api/LATEST/aws-cpp-sdk-core/html/struct_aws_1_1_client_1_1_client_configuration.html). | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Não | Pode ser desabilitado [usando middleware](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/configure-endpoints.html). | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Não |  | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Não | Configuração não compatível, mas pode ser configurada no código do cliente usando: [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/core/client/config/SdkAdvancedClientOption.html#DISABLE_HOST_PREFIX_INJECTION](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/core/client/config/SdkAdvancedClientOption.html#DISABLE_HOST_PREFIX_INJECTION). | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Não | Configuração não compatível, mas pode ser configurada no código do cliente usando: [https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/ClientConfiguration.html](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/ClientConfiguration.html). | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Não | Configuração não compatível, mas pode ser configurada no código do cliente usando: [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/s3-control/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/s3-control/). | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Não | Configuração não compatível, mas pode ser configurada no código do cliente usando: [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Config.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Config.html). | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Não |  | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Não | Configuração não compatível, mas pode ser configurada no código do cliente usando: [https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Runtime/TClientConfig.html](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Runtime/TClientConfig.html). | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Não | Configuração não compatível, mas pode ser configurada no código do cliente usando: [https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/TClientConfig.html](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/TClientConfig.html). | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Não | Configuração não compatível, mas pode ser configurada no código do cliente usando: [https://docs.aws.amazon.com/aws-sdk-php/v3/api/class-Aws.AwsClient.html](https://docs.aws.amazon.com/aws-sdk-php/v3/api/class-Aws.AwsClient.html). | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim | Pode ser configurado em código no cliente usando: [https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html](https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html). | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Não | Configuração não compatível, mas pode ser configurada no código do cliente usando: [https://github.com/aws/aws-sdk-ruby/blob/version-3/gems/aws-sdk-core/lib/aws-sdk-core/plugins/endpoint_pattern.rb#L8](https://github.com/aws/aws-sdk-ruby/blob/version-3/gems/aws-sdk-core/lib/aws-sdk-core/plugins/endpoint_pattern.rb#L8). | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Não |  | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Não |  | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Não | A configuração não é compatível, mas pode ser incluída em cmdlets específicos usando o parâmetro -ClientConfig @\$1DisableHostPrefixInjection = \$1true\$1. | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Não | A configuração não é compatível, mas pode ser incluída em cmdlets específicos usando o parâmetro -ClientConfig @\$1DisableHostPrefixInjection = \$1true\$1. | 

# Cliente de IMDS
<a name="feature-imds-client"></a>

**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, consulte[Entender as páginas de configurações deste guia](settings-reference.md#settingsPages).

SDKs implemente um cliente do Instance Metadata Service versão 2 (IMDSv2) usando solicitações orientadas à sessão. Para obter mais informações sobre IMDSv2, consulte [Uso IMDSv2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-service.html) no Guia do *usuário do Amazon EC2*. O cliente IMDS é configurável por meio de um objeto de configuração do cliente disponível na base de código do SDK.

Configure essa funcionalidade usando o seguinte:

**`retries`: membro do objeto de configuração do cliente**  
O número de tentativas adicionais para qualquer solicitação com falha.   
**Valor padrão:** 3   
**Valores válidos:** número maior que zero. 

**`port`: membro do objeto de configuração do cliente**  
A porta para o endpoint.  
**Valor padrão:** 80   
**Valores válidos:** número. 

**`token_ttl`: membro do objeto de configuração do cliente**  
O TTL do token.  
**Valor padrão:** 21.600 segundos (6 horas, o tempo máximo alocado).   
**Valores válidos:** número. 

**`endpoint`: membro do objeto de configuração do cliente**  
O endpoint de IMDS.  
**Valor padrão:** se `endpoint_mode` for igual a `IPv4`, o endpoint padrão será `http://169.254.169.254`. Se `endpoint_mode` for igual a `IPv6`, o endpoint padrão será `http://[fd00:ec2::254]`.  
**Valores válidos:** URL válido.



As opções a seguir são suportadas pela maioria SDKs. Consulte sua base de código específica do SDK para obter detalhes.

**`endpoint_mode`: membro do objeto de configuração do cliente**  
O modo de endpoint do IMDS.  
**Valor padrão**: `IPv4`  
**Valores válidos**: `IPv4`, `IPv6`

**`http_open_timeout`: membro do objeto de configuração do cliente (o nome pode variar)**  
O número de segundos a aguardar até que a conexão seja aberta.  
**Valor padrão:** 1 segundo.   
**Valores válidos:** número maior que zero. 

**`http_read_timeout`: membro do objeto de configuração do cliente (o nome pode variar)**  
O número de segundos para que um bloco de dados seja lido.  
**Valor padrão:** 1 segundo.   
**Valores válidos:** número maior que zero. 

**`http_debug_output`: membro do objeto de configuração do cliente (o nome pode variar)**  
Define um fluxo de saída para depuração.  
**Valor padrão:** nenhum.   
**Valores válidos:** um I/O fluxo válido, como STDOUT. 

**`backoff`: membro do objeto de configuração do cliente (o nome pode variar)**  
O número de segundos para dormir entre as novas tentativas ou o cliente forneceu a função de desligamento para chamar. Isto substitui a estratégia padrão de recuo exponencial.  
**Valor padrão:** varia de acordo com o SDK.   
**Valores válidos:** variam de acordo com o SDK. Pode ser um valor numérico ou uma chamada para uma função personalizada. 

## Support by AWS SDKs and tools
<a name="feature-imds-client-sdk-compat"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/) | Sim |  | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Não |  | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Sim |  | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Sim |  | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Sim |  | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Sim |  | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Sim |  | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Sim |  | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Não |  | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Sim |  | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim |  | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim |  | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sim |  | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Sim |  | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Sim |  | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Sim |  | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Sim |  | 

# Comportamento de repetição
<a name="feature-retry-behavior"></a>

**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, consulte[Entender as páginas de configurações deste guia](settings-reference.md#settingsPages).

O comportamento de repetição inclui configurações sobre como a SDKs tentativa de se recuperar de falhas resultantes de solicitações feitas a. Serviços da AWS

Configure essa funcionalidade usando o seguinte:

**`retry_mode`- configuração de AWS `config` arquivo compartilhado`AWS_RETRY_MODE`: variável de ambiente`aws.retryMode`- Propriedade do sistema JVM: somente Java/Kotlin **  
Especifica como o SDK ou a ferramenta de desenvolvedor tenta novas tentativas.  
**Valor padrão:** esse valor é específico do SDK. Consulte o guia do SDK específico ou a base de código do SDK para obter o `retry_mode` padrão.  
**Valores válidos:**   
+ `standard`— (Recomendado) O conjunto recomendado de regras de repetição. AWS SDKs Esse modo inclui um conjunto padrão de erros que geram novas tentativas e ajusta automaticamente o número de tentativas para maximizar a disponibilidade e a estabilidade. Esse modo é seguro para uso em aplicações multilocatárias. O número máximo padrão de tentativas com esse modo é três, a menos que `max_attempts` esteja explicitamente configurado. 
+ `adaptive`: um modo de repetição de tentativas, apropriado somente para casos de uso especializados, que inclui a funcionalidade do modo padrão, bem como a limitação automática de taxa do lado do cliente. Esse modo de repetição de tentativas não é recomendado para aplicações multilocatárias, a menos que você tenha o cuidado de isolar os locatários da aplicação. Consulte [Escolher entre os modos de repetição de tentativas `standard` e `adaptive`](#standardvsadaptive) para obter mais informações. Esse modo é experimental e pode mudar de comportamento no futuro.
+ `legacy`: (Não Recomendado) específico para o SDK (consulte o guia específico do SDK ou a base de código do seu SDK).

**`max_attempts`- configuração de AWS `config` arquivo compartilhado`AWS_MAX_ATTEMPTS`: variável de ambiente`aws.maxAttempts`- Propriedade do sistema JVM: somente Java/Kotlin **  
Especifica o número máximo de tentativas a serem feitas em uma solicitação.  
**Valor padrão:** se esse valor não for especificado, seu padrão dependerá do valor da configuração `retry_mode`:   
+ Se `retry_mode` for `legacy`: usa um valor padrão específico para seu SDK (consulte o guia de seu SDK específico ou a base de código do seu SDK para ver o `max_attempts` padrão). 
+ Se `retry_mode` for `standard`: faz três tentativas.
+ Se `retry_mode` for `adaptive`: faz três tentativas.
**Valores válidos:** número maior que zero. 

## Escolher entre os modos de repetição de tentativas `standard` e `adaptive`
<a name="standardvsadaptive"></a>

Recomendamos que você use o modo de repetição de tentativas `standard`, a menos que tenha certeza de que seu uso é mais adequado para o modo `adaptive`. 

**nota**  
O modo `adaptive` pressupõe que você esteja agrupando clientes com base no escopo em que o serviço de backend pode controlar as solicitações. Se você não fizer isso, os controles de utilização em um recurso podem atrasar as solicitações de um recurso não relacionado se você estiver usando o mesmo cliente para os dois recursos. 


| Standard | Adaptativo | 
| --- | --- | 
| Casos de uso da aplicação: todos. | Casos de uso da aplicação: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/sdkref/latest/guide/feature-retry-behavior.html)  | 
| Compatível com interrupção de circuito para evitar que o SDK tente novamente durante uma interrupção no fornecimento. | Compatível com interrupção de circuito para evitar que o SDK tente novamente durante uma interrupção no fornecimento. | 
| Usa um recuo exponencial instável em caso de falhas. | Usa durações dinâmicas de recuo para tentar minimizar o número de solicitações com falha, em troca do potencial aumento de latência. | 
| Nunca atrasa a primeira tentativa de solicitação, apenas as novas tentativas. | Pode controlar a utilização ou atrasar a tentativa de solicitação inicial. | 

Se você escolher o modo `adaptive`, sua aplicação deverá construir clientes projetados com base em cada recurso cuja utilização possa estar sendo controlada. Um recurso, nesse caso, é mais refinado do que apenas pensar em cada um. AWS service (Serviço da AWS) Serviços da AWS podem ter dimensões adicionais que eles usam para acelerar as solicitações. Vamos usar o serviço Amazon DynamoDB como exemplo. O DynamoDB Região da AWS usa mais a tabela que está sendo acessada para acelerar as solicitações. Isso significa que uma tabela que o código está acessando pode sofrer mais controle de utilização que outras. Se o código tiver usado o mesmo cliente para acessar todas as tabelas e a utilização de solicitações para uma dessas tabelas for controlada, o modo adaptativo de repetição de tentativas reduzirá a taxa de solicitações de todas as tabelas. Seu código deve ser projetado para ter um cliente por Region-and-table par. Se você tiver uma latência inesperada ao usar o `adaptive` modo, consulte o guia de AWS documentação específico do serviço que você está usando.

## Detalhes da implementação do modo de repetição de tentativas
<a name="standardvsadaptiveimplementation"></a>

Eles AWS SDKs usam repositórios de [tokens para](https://en.wikipedia.org/wiki/Token_bucket) decidir se uma solicitação deve ser repetida e (no caso do modo de `adaptive` repetição) com que rapidez as solicitações devem ser enviadas. Dois buckets de tokens são usados pelo SDK: um bucket de tokens de repetição de tentativas e um bucket de tokens de taxa de solicitações. 
+ O bucket de tokens de repetição de tentativas é usado para determinar se o SDK deve desabilitar temporariamente as novas tentativas para proteger os serviços upstream e downstream durante interrupções de fornecimento. Os tokens são obtidos do bucket antes que sejam feitas novas tentativas, e os tokens são devolvidos ao bucket quando as solicitações são bem-sucedidas. Se o bucket estiver vazio quando for feita uma nova tentativa, o SDK não repetirá a solicitação. 
+ O bucket de tokens da taxa de solicitações é usado apenas no modo `adaptive` de repetição de tentativas para determinar a taxa de envio das solicitações. Os tokens são obtidos no bucket antes do envio de uma solicitação, e os tokens são devolvidos ao bucket a uma taxa determinada dinamicamente com base nas respostas de controle de utilização retornadas pelo serviço. 

A seguir está o pseudocódigo de alto nível para os modos de repetição de repetição `standard` e `adaptive`:

```
MakeSDKRequest() {
  attempts = 0
  loop {
    GetSendToken()
    response = SendHTTPRequest()
    RequestBookkeeping(response)
    if not Retryable(response)
      return response
    attempts += 1
    if attempts >= MAX_ATTEMPTS:
      return response
    if not HasRetryQuota(response)
      return response
    delay = ExponentialBackoff(attempts)
    sleep(delay)
  }
}
```

A seguir estão mais detalhes sobre os componentes usados no pseudocódigo:

**`GetSendToken`:**

Essa etapa é usada apenas no modo `adaptive` de repetição de tentativas. Essa etapa obtém um token do bucket de tokens de taxa de solicitações. Se um token não estiver disponível, aguardará até que um fique disponível. O SDK pode ter opções de configuração disponíveis para considerar que houve falha na solicitação em vez de esperar. Os tokens no bucket são recarregados a uma taxa determinada dinamicamente, com base no número de respostas de controle de utilização recebidas pelo cliente.

**`SendHTTPRequest`:**

Essa etapa envia a solicitação para AWS o. A maioria AWS SDKs usa uma biblioteca HTTP que usa grupos de conexões para reutilizar uma conexão existente ao fazer uma solicitação HTTP. Geralmente, as conexões são reutilizadas se houver falha em uma solicitação devido a erros de controle de utilização, mas não se a falha da solicitação ocorrer devido a um erro transitório. 

**`RequestBookkeeping`:**

Os tokens serão adicionados ao bucket de tokens se a solicitação for bem-sucedida. Somente para o modo `adaptive` de repetição de tentativas, a taxa de preenchimento do bucket de tokens de taxa de solicitações é atualizada com base no tipo de resposta recebida. 

**`Retryable`:**

 Essa etapa determina se uma resposta pode ser repetida com base no seguinte: 
+ Código de status do HTTP. 
+ O código de erro retornado do serviço.
+ Erros de conexão, definidos como qualquer erro recebido pelo SDK no qual uma resposta HTTP do serviço não é recebida. 

Erros transitórios (códigos de status HTTP 400, 408, 500, 502, 503 e 504) e erros de controle de utilização (códigos de status HTTP 400, 403, 429, 502, 503 e 509) podem potencialmente ser repetidos. O comportamento de repetição do SDK é determinado em combinação com códigos de erro ou outros dados do serviço.

**`MAX_ATTEMPTS`:**

 O número padrão de máximo de tentativas é definido pela configuração `retry_mode`, a menos que seja substituído pela configuração `max_attempts`.

**`HasRetryQuota`**

Essa etapa obtém um token do bucket de tokens de repetição de tentativas. Se o bucket de tokens de repetição de tentativas estiver vazio, a solicitação não será repetida.

**`ExponentialBackoff`**

 Para um erro que pode ser repetido, o atraso da nova tentativa é calculado usando o recuo exponencial truncado. O SDKs uso de recuo exponencial binário truncado com instabilidade. O algoritmo a seguir mostra como a quantidade de tempo de sono, em segundos, é definida para uma resposta à solicitação `i`: 

```
seconds_to_sleep_i = min(b*r^i, MAX_BACKOFF)
```

No algoritmo anterior, os seguintes valores se aplicam:

`b = random number within the range of: 0 <= b <= 1`

`r = 2`

`MAX_BACKOFF = 20 seconds`para a maioria SDKs. Consulte o guia específico do SDK ou o código-fonte para confirmação.

## Support by AWS SDKs and tools
<a name="feature-retry-behavior-sdk-compat"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/) | Sim |  | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Sim |  | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Sim |  | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Não |  | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Sim |  | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Sim | Propriedades de sistema JVM: use com.amazonaws.sdk.maxAttempts em vez de aws.maxAttempts; use com.amazonaws.sdk.retryMode em vez de aws.retryMode.  | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Sim |  | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Não | Suporta um número máximo de novas tentativas, recuo exponencial com instabilidade e a opção de um método personalizado para recuar novamente. | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Sim |  | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim |  | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim |  | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sim |  | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Sim |  | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Sim |  | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Sim |  | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Sim |  | 

# Compactação de solicitações
<a name="feature-compression"></a>

**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, consulte[Entender as páginas de configurações deste guia](settings-reference.md#settingsPages).

AWS SDKs e as ferramentas podem compactar cargas automaticamente ao enviar solicitações para Serviços da AWS que suportem o recebimento de cargas comprimidas. Compactar a carga útil do cliente antes de enviá-la para um serviço pode reduzir o número geral de solicitações e a largura de banda necessárias para enviar dados ao serviço, bem como reduzir as solicitações malsucedidas devido às limitações do serviço no tamanho da carga útil. Para compactação, o SDK ou a ferramenta seleciona um algoritmo de codificação compatível com o serviço e o SDK. No entanto, a lista atual de codificações possíveis consiste apenas em gzip, mas pode se expandir no futuro.

A compactação de solicitações pode ser especialmente útil se seu aplicativo estiver usando a [Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/). CloudWatch é um serviço de monitoramento e observabilidade que coleta dados operacionais e de monitoramento na forma de registros, métricas e eventos. Um exemplo de operação de serviço que oferece suporte à compactação CloudWatch é o método de [PutMetricDataAPI](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html). 

Configure essa funcionalidade usando o seguinte:

**`disable_request_compression`- configuração de AWS `config` arquivo compartilhado`AWS_DISABLE_REQUEST_COMPRESSION`: variável de ambiente`aws.disableRequestCompression`- Propriedade do sistema JVM: somente Java/Kotlin **  
Ativa ou desativa se o SDK ou a ferramenta compactarão uma carga antes de enviar uma solicitação.  
Valor padrão: `false`  
**Valores válidos:**  
+ **`true`** – Desative a compactação de solicitações.
+ **`false`** – Use a compactação de solicitações quando possível.

**`request_min_compression_size_bytes`- configuração de AWS `config` arquivo compartilhado`AWS_REQUEST_MIN_COMPRESSION_SIZE_BYTES`: variável de ambiente`aws.requestMinCompressionSizeBytes`- Propriedade do sistema JVM: somente Java/Kotlin **  
Define o tamanho mínimo em bytes do corpo da solicitação que o SDK ou a ferramenta devem compactar. Cargas pequenas podem ficar maiores quando compactadas, portanto, há um limite mínimo em que faz sentido realizar a compactação. Esse valor é inclusivo, um tamanho de solicitação maior que ou igual ao valor é compactado.  
**Valor padrão:** 10240 bytes  
**Valores válidos:** valor inteiro entre 0 e 10485760 bytes, inclusive.

## Support by AWS SDKs and tools
<a name="compression-sdk-compat"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/) | Sim |  | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Sim |  | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Sim |  | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Não |  | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Sim |  | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Não |  | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Sim |  | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Não |  | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Sim |  | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim |  | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim |  | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sim |  | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Sim |  | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Não |  | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Sim |  | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Sim |  | 

# Endpoints específicos de serviço
<a name="feature-ss-endpoints"></a>

**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, consulte[Entender as páginas de configurações deste guia](settings-reference.md#settingsPages).

A configuração de endpoint específico de serviço oferece a opção de usar um endpoint de sua escolha para solicitações de API e para ter a persistência dessa escolha. Essas configurações oferecem flexibilidade para permitir endpoints locais, endpoints da VPC e ambientes de desenvolvimento da AWS local de terceiros. Diferentes endpoints podem ser usados para ambientes de teste e produção. Você pode especificar um URL de endpoint para Serviços da AWS individuais. 

Configure essa funcionalidade usando o seguinte:

**`endpoint_url`- configuração de AWS `config` arquivo compartilhado`AWS_ENDPOINT_URL`: variável de ambiente`aws.endpointUrl`- Propriedade do sistema JVM: somente Java/Kotlin **  
Quando especificada diretamente em um perfil ou como uma variável de ambiente, esta configuração especifica o endpoint usado para todas as solicitações de serviço. Este endpoint é substituído por qualquer endpoint específico do serviço configurado.   
Você também pode usar essa configuração em uma `services` seção de um AWS `config` arquivo compartilhado para definir um endpoint personalizado para um serviço específico. Para obter uma lista de todas as chaves de identificação de serviço a serem usadas nas subseções dentro da seção `services`, consulte [Identificadores para endpoints específicos de serviço](ss-endpoints-table.md).  
**Valor padrão**: `none`  
**Valores válidos:** um URL incluindo o esquema e o host do endpoint. Opcionalmente, o URL pode conter um componente de caminho que contenha um ou mais segmentos de caminho.

**`AWS_ENDPOINT_URL_<SERVICE>`: variável de ambiente`aws.endpointUrl<ServiceName>`- Propriedade do sistema JVM: somente Java/Kotlin **  
`AWS_ENDPOINT_URL_<SERVICE>`, onde `<SERVICE>` está o AWS service (Serviço da AWS) identificador, define um endpoint personalizado para um serviço específico. Para obter uma lista de todas as variáveis de ambiente específicas do serviço, consulte [Identificadores para endpoints específicos de serviço](ss-endpoints-table.md).   
Este endpoint específico do serviço substitui qualquer endpoint global configurado em `AWS_ENDPOINT_URL`.   
**Valor padrão**: `none`  
**Valores válidos:** um URL incluindo o esquema e o host do endpoint. Opcionalmente, o URL pode conter um componente de caminho que contenha um ou mais segmentos de caminho.

**`ignore_configured_endpoint_urls`- configuração de AWS `config` arquivo compartilhado`AWS_IGNORE_CONFIGURED_ENDPOINT_URLS`: variável de ambiente`aws.ignoreConfiguredEndpointUrls`- Propriedade do sistema JVM: somente Java/Kotlin **  
Esta configuração é usada para ignorar todas as configurações personalizadas de endpoints.  
Observe que qualquer endpoint explícito definido no código ou no próprio cliente de serviço é usado independentemente desta configuração. Por exemplo, incluir o parâmetro da linha de `--endpoint-url` comando com um AWS CLI comando ou passar uma URL de endpoint para um construtor de cliente sempre terá efeito.  
Valor padrão: `false`  
**Valores válidos:**  
+ **`true`**: o SDK ou a ferramenta não lê nenhuma opção de configuração personalizada do arquivo `config` compartilhado ou das variáveis de ambiente para definir um URL de endpoint.
+ **`false`**: o SDK ou a ferramenta usa todos os endpoints disponíveis fornecidos pelo usuário a partir do arquivo `config` compartilhado ou de variáveis de ambiente.

## Configurar endpoints usando variáveis de ambiente
<a name="ss-endpoints-envar"></a>

Para rotear solicitações de todos os serviços para um URL de endpoint personalizado, defina a variável de ambiente global `AWS_ENDPOINT_URL`. 

```
export AWS_ENDPOINT_URL=http://localhost:4567
```

Para encaminhar solicitações de um URL específico AWS service (Serviço da AWS) para um endpoint personalizado, use a variável de `AWS_ENDPOINT_URL_<SERVICE>` ambiente. Amazon DynamoDB tem um `serviceId` de [https://github.com/boto/botocore/blob/bcaf618c4b93c067efa0b85d3e92f3985ff60906/botocore/data/dynamodb/2012-08-10/service-2.json#L10](https://github.com/boto/botocore/blob/bcaf618c4b93c067efa0b85d3e92f3985ff60906/botocore/data/dynamodb/2012-08-10/service-2.json#L10). Para esse serviço, a variável de ambiente do URL do endpoint é `AWS_ENDPOINT_URL_DYNAMODB`. Este endpoint tem precedência sobre o endpoint global definido em `AWS_ENDPOINT_URL` para este serviço. 

```
export AWS_ENDPOINT_URL_DYNAMODB=http://localhost:5678
```

 Como outro exemplo, AWS Elastic Beanstalk tem um `serviceId` de [https://github.com/boto/botocore/blob/bcaf618c4b93c067efa0b85d3e92f3985ff60906/botocore/data/elasticbeanstalk/2010-12-01/service-2.json#L9](https://github.com/boto/botocore/blob/bcaf618c4b93c067efa0b85d3e92f3985ff60906/botocore/data/elasticbeanstalk/2010-12-01/service-2.json#L9). O AWS service (Serviço da AWS) identificador é baseado no modelo de API, substituindo todos os espaços `serviceId` por sublinhados e colocando todas as letras em maiúsculas. Para configurar o endpoint para este serviço, a variável de ambiente correspondente é `AWS_ENDPOINT_URL_ELASTIC_BEANSTALK`. Para obter uma lista de todas as variáveis de ambiente específicas do serviço, consulte [Identificadores para endpoints específicos de serviço](ss-endpoints-table.md). 

```
export AWS_ENDPOINT_URL_ELASTIC_BEANSTALK=http://localhost:5567
```

## Configurar endpoints usando o arquivo compartilhado `config`
<a name="ss-endpoints-config"></a>

No arquivo compartilhado `config`, `endpoint_url` é usado em locais diferentes para diferentes funcionalidades.
+ `endpoint_url` especificado diretamente em um `profile` torna esse endpoint no endpoint global. 
+ `endpoint_url` aninhado sob uma chave identificadora de serviço em uma seção `services`, faz com que esse endpoint se aplique às solicitações feitas somente para esse serviço. Para obter detalhes sobre como definir uma seção `services` no arquivo compartilhado [Formato do arquivo de configuração](file-format.md#file-format-config), consulte `config`. 

 O exemplo a seguir usa uma definição `services` para configurar um URL de endpoint específico do serviço para o Amazon S3 e um endpoint global personalizado para ser usado para todos os demais serviços: 

```
[profile dev-s3-specific-and-global]
endpoint_url = http://localhost:1234
services = s3-specific

[services s3-specific]
s3 = 
  endpoint_url = https://play.min.io:9000
```

Um único perfil pode configurar endpoints para vários serviços. Este exemplo mostra como definir o endpoint específico do serviço para o Amazon URLs S3 e AWS Elastic Beanstalk no mesmo perfil. AWS Elastic Beanstalk tem um `serviceId` de [https://github.com/boto/botocore/blob/bcaf618c4b93c067efa0b85d3e92f3985ff60906/botocore/data/elasticbeanstalk/2010-12-01/service-2.json#L9](https://github.com/boto/botocore/blob/bcaf618c4b93c067efa0b85d3e92f3985ff60906/botocore/data/elasticbeanstalk/2010-12-01/service-2.json#L9). O AWS service (Serviço da AWS) identificador é baseado no modelo de API, substituindo todos os espaços `serviceId` por sublinhados e colocando todas as letras em minúsculas. Assim, a chave identificadora de serviço se torna `elastic_beanstalk` e as configurações deste serviço começam na linha `elastic_beanstalk = `. Para obter uma lista de todas as chaves de identificação de serviço a serem usadas na seção `services`, consulte [Identificadores para endpoints específicos de serviço](ss-endpoints-table.md). 

```
[services testing-s3-and-eb]
s3 = 
  endpoint_url = http://localhost:4567
elastic_beanstalk = 
  endpoint_url = http://localhost:8000

[profile dev]
services = testing-s3-and-eb
```

A seção de configuração de serviço pode ser usada a partir de vários perfis. Por exemplo, dois perfis podem usar a mesma definição `services` ao alterar outras propriedades do perfil: 

```
[services testing-s3]
s3 = 
  endpoint_url = https://localhost:4567

[profile testing-json]
output = json
services = testing-s3

[profile testing-text]
output = text
services = testing-s3
```

## Configure endpoints em perfis usando credenciais baseadas em funções
<a name="ss-endpoints-role"></a>

Se o seu perfil tiver credenciais baseadas em perfis configurados por meio de um parâmetro `source_profile` para a funcionalidade “assumir função” do IAM, o SDK usará somente configurações de serviço para o perfil especificado. Ele não usa perfis com funções vinculadas a ele. Por exemplo, usando o seguinte arquivo compartilhado `config`: 

```
[profile A]
credential_source = Ec2InstanceMetadata
endpoint_url = https://profile-a-endpoint.aws/

[profile B]
source_profile = A
role_arn = arn:aws:iam::123456789012:role/roleB
services = profileB

[services profileB]
ec2 = 
  endpoint_url = https://profile-b-ec2-endpoint.aws
```

 Se você usar o perfil `B` e fizer uma chamada em seu código para o Amazon EC2, o endpoint será resolvido como `https://profile-b-ec2-endpoint.aws`. Se o seu código fizer uma solicitação para qualquer outro serviço, a resolução do endpoint não seguirá nenhuma lógica personalizada. O endpoint não é resolvido para o endpoint global definido no perfil `A`. Para que um endpoint global tenha efeito para o perfil `B`, você precisaria configurar `endpoint_url` diretamente no perfil `B`. Para obter mais informações sobre a configuração `source_profile`, consulte [Assuma o perfil de provedor de credenciais](feature-assume-role-credentials.md). 

## Precedência de configurações
<a name="ss-endpoints-precedence"></a>

 As configurações deste atributo podem ser usadas ao mesmo tempo, mas somente um valor terá prioridade por serviço. Para chamadas de API feitas para um determinado AWS service (Serviço da AWS), a seguinte ordem é usada para selecionar um valor: 

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.
   + Para o AWS CLI, esse é o valor fornecido pelo parâmetro da linha de `--endpoint-url` 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.

1. O valor fornecido por uma variável de ambiente específica do serviço, como `AWS_ENDPOINT_URL_DYNAMODB`.

1. O valor fornecido pela variável de ambiente global do endpoint `AWS_ENDPOINT_URL`.

1. O valor fornecido pela configuração `endpoint_url` aninhada em uma chave identificadora de serviço em uma seção `services` do arquivo compartilhado `config`.

1. O valor fornecido pela configuração `endpoint_url` especificado diretamente em um `profile` do arquivo compartilhado `config`.

1. Qualquer URL de endpoint padrão para o respectivo AWS service (Serviço da AWS) é usada por último.

## Support by AWS SDKs and tools
<a name="ss-endpoints-sdk-compat"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/) | Sim |  | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) | Sim |  | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Sim |  | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Não |  | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Sim |  | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Não |  | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Sim |  | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Não |  | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Sim |  | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Sim |  | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim |  | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim |  | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sim |  | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Sim |  | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Sim |  | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Sim |  | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Sim |  | 

# Identificadores para endpoints específicos de serviço
<a name="ss-endpoints-table"></a>

Para obter informações sobre como e onde usar os identificadores na tabela a seguir, consulte [Endpoints específicos de serviço](feature-ss-endpoints.md).


| `serviceId` | Chave identificadora de serviço para AWS `config` arquivo compartilhado | `AWS_ENDPOINT_URL_<SERVICE>` variável de ambiente | 
| --- | --- | --- | 
|  AccessAnalyzer  |  accessanalyzer  |  AWS\$1ENDPOINT\$1URL\$1ACCESSANALYZER  | 
|  Account  |  account  |  AWS\$1ENDPOINT\$1URL\$1ACCOUNT  | 
|  ACM  |  acm  |  AWS\$1ENDPOINT\$1URL\$1ACM  | 
|  ACM PCA  |  acm\$1pca  |  AWS\$1ENDPOINT\$1URL\$1ACM\$1PCA  | 
|  Alexa For Business  |  alexa\$1for\$1business  |  AWS\$1ENDPOINT\$1URL\$1ALEXA\$1FOR\$1BUSINESS  | 
|  amp  |  amp  |  AWS\$1ENDPOINT\$1URL\$1AMP  | 
|  Amplify  |  amplify  |  AWS\$1ENDPOINT\$1URL\$1AMPLIFY  | 
|  AmplifyBackend  |  amplifybackend  |  AWS\$1ENDPOINT\$1URL\$1AMPLIFYBACKEND  | 
|  AmplifyUIBuilder  |  amplifyuibuilder  |  AWS\$1ENDPOINT\$1URL\$1AMPLIFYUIBUILDER  | 
|  API Gateway  |  api\$1gateway  |  AWS\$1ENDPOINT\$1URL\$1API\$1GATEWAY  | 
|  ApiGatewayManagementApi  |  apigatewaymanagementapi  |  AWS\$1ENDPOINT\$1URL\$1APIGATEWAYMANAGEMENTAPI  | 
|  ApiGatewayV2  |  apigatewayv2  |  AWS\$1ENDPOINT\$1URL\$1APIGATEWAYV2  | 
|  AppConfig  |  appconfig  |  AWS\$1ENDPOINT\$1URL\$1APPCONFIG  | 
|  AppConfigData  |  appconfigdata  |  AWS\$1ENDPOINT\$1URL\$1APPCONFIGDATA  | 
|  AppFabric  |  appfabric  |  AWS\$1ENDPOINT\$1URL\$1APPFABRIC  | 
|  Appflow  |  appflow  |  AWS\$1ENDPOINT\$1URL\$1APPFLOW  | 
|  AppIntegrations  |  appintegrations  |  AWS\$1ENDPOINT\$1URL\$1APPINTEGRATIONS  | 
|  Application Auto Scaling  |  application\$1auto\$1scaling  |  AWS\$1ENDPOINT\$1URL\$1APPLICATION\$1AUTO\$1SCALING  | 
|  Application Insights  |  application\$1insights  |  AWS\$1ENDPOINT\$1URL\$1APPLICATION\$1INSIGHTS  | 
|  ApplicationCostProfiler  |  applicationcostprofiler  |  AWS\$1ENDPOINT\$1URL\$1APPLICATIONCOSTPROFILER  | 
|  App Mesh  |  app\$1mesh  |  AWS\$1ENDPOINT\$1URL\$1APP\$1MESH  | 
|  AppRunner  |  apprunner  |  AWS\$1ENDPOINT\$1URL\$1APPRUNNER  | 
|  AppStream  |  appstream  |  AWS\$1ENDPOINT\$1URL\$1APPSTREAM  | 
|  AppSync  |  appsync  |  AWS\$1ENDPOINT\$1URL\$1APPSYNC  | 
|  ARC Zonal Shift  |  arc\$1zonal\$1shift  |  AWS\$1ENDPOINT\$1URL\$1ARC\$1ZONAL\$1SHIFT  | 
|  Artifact  |  artifact  |  AWS\$1ENDPOINT\$1URL\$1ARTIFACT  | 
|  Athena  |  athena  |  AWS\$1ENDPOINT\$1URL\$1ATHENA  | 
|  AuditManager  |  auditmanager  |  AWS\$1ENDPOINT\$1URL\$1AUDITMANAGER  | 
|  Auto Scaling  |  auto\$1scaling  |  AWS\$1ENDPOINT\$1URL\$1AUTO\$1SCALING  | 
|  Auto Scaling Plans  |  auto\$1scaling\$1plans  |  AWS\$1ENDPOINT\$1URL\$1AUTO\$1SCALING\$1PLANS  | 
|  b2bi  |  b2bi  |  AWS\$1ENDPOINT\$1URL\$1B2BI  | 
|  Backup  |  backup  |  AWS\$1ENDPOINT\$1URL\$1BACKUP  | 
|  Backup Gateway  |  backup\$1gateway  |  AWS\$1ENDPOINT\$1URL\$1BACKUP\$1GATEWAY  | 
|  BackupStorage  |  backupstorage  |  AWS\$1ENDPOINT\$1URL\$1BACKUPSTORAGE  | 
|  Batch  |  batch  |  AWS\$1ENDPOINT\$1URL\$1BATCH  | 
|  BCM Data Exports  |  bcm\$1data\$1exports  |  AWS\$1ENDPOINT\$1URL\$1BCM\$1DATA\$1EXPORTS  | 
|  Bedrock  |  bedrock  |  AWS\$1ENDPOINT\$1URL\$1BEDROCK  | 
|  Bedrock Agent  |  bedrock\$1agent  |  AWS\$1ENDPOINT\$1URL\$1BEDROCK\$1AGENT  | 
|  Bedrock Agent Runtime  |  bedrock\$1agent\$1runtime  |  AWS\$1ENDPOINT\$1URL\$1BEDROCK\$1AGENT\$1RUNTIME  | 
|  Bedrock Runtime  |  bedrock\$1runtime  |  AWS\$1ENDPOINT\$1URL\$1BEDROCK\$1RUNTIME  | 
|  billingconductor  |  billingconductor  |  AWS\$1ENDPOINT\$1URL\$1BILLINGCONDUCTOR  | 
|  Braket  |  braket  |  AWS\$1ENDPOINT\$1URL\$1BRAKET  | 
|  Budgets  |  budgets  |  AWS\$1ENDPOINT\$1URL\$1BUDGETS  | 
|  Cost Explorer  |  cost\$1explorer  |  AWS\$1ENDPOINT\$1URL\$1COST\$1EXPLORER  | 
|  chatbot  |  chatbot  |  AWS\$1ENDPOINT\$1URL\$1CHATBOT  | 
|  Chime  |  chime  |  AWS\$1ENDPOINT\$1URL\$1CHIME  | 
|  Chime SDK Identity  |  chime\$1sdk\$1identity  |  AWS\$1ENDPOINT\$1URL\$1CHIME\$1SDK\$1IDENTITY  | 
|  Chime SDK Media Pipelines  |  chime\$1sdk\$1media\$1pipelines  |  AWS\$1ENDPOINT\$1URL\$1CHIME\$1SDK\$1MEDIA\$1PIPELINES  | 
|  Chime SDK Meetings  |  chime\$1sdk\$1meetings  |  AWS\$1ENDPOINT\$1URL\$1CHIME\$1SDK\$1MEETINGS  | 
|  Chime SDK Messaging  |  chime\$1sdk\$1messaging  |  AWS\$1ENDPOINT\$1URL\$1CHIME\$1SDK\$1MESSAGING  | 
|  Chime SDK Voice  |  chime\$1sdk\$1voice  |  AWS\$1ENDPOINT\$1URL\$1CHIME\$1SDK\$1VOICE  | 
|  CleanRooms  |  cleanrooms  |  AWS\$1ENDPOINT\$1URL\$1CLEANROOMS  | 
|  CleanRoomsML  |  cleanroomsml  |  AWS\$1ENDPOINT\$1URL\$1CLEANROOMSML  | 
|  Cloud9  |  cloud9  |  AWS\$1ENDPOINT\$1URL\$1CLOUD9  | 
|  CloudControl  |  cloudcontrol  |  AWS\$1ENDPOINT\$1URL\$1CLOUDCONTROL  | 
|  CloudDirectory  |  clouddirectory  |  AWS\$1ENDPOINT\$1URL\$1CLOUDDIRECTORY  | 
|  CloudFormation  |  cloudformation  |  AWS\$1ENDPOINT\$1URL\$1CLOUDFORMATION  | 
|  CloudFront  |  cloudfront  |  AWS\$1ENDPOINT\$1URL\$1CLOUDFRONT  | 
|  CloudFront KeyValueStore  |  cloudfront\$1keyvaluestore  |  AWS\$1ENDPOINT\$1URL\$1CLOUDFRONT\$1KEYVALUESTORE  | 
|  CloudHSM  |  cloudhsm  |  AWS\$1ENDPOINT\$1URL\$1CLOUDHSM  | 
|  CloudHSM V2  |  cloudhsm\$1v2  |  AWS\$1ENDPOINT\$1URL\$1CLOUDHSM\$1V2  | 
|  CloudSearch  |  cloudsearch  |  AWS\$1ENDPOINT\$1URL\$1CLOUDSEARCH  | 
|  CloudSearch Domain  |  cloudsearch\$1domain  |  AWS\$1ENDPOINT\$1URL\$1CLOUDSEARCH\$1DOMAIN  | 
|  CloudTrail  |  cloudtrail  |  AWS\$1ENDPOINT\$1URL\$1CLOUDTRAIL  | 
|  CloudTrail Data  |  cloudtrail\$1data  |  AWS\$1ENDPOINT\$1URL\$1CLOUDTRAIL\$1DATA  | 
|  CloudWatch  |  cloudwatch  |  AWS\$1ENDPOINT\$1URL\$1CLOUDWATCH  | 
|  codeartifact  |  codeartifact  |  AWS\$1ENDPOINT\$1URL\$1CODEARTIFACT  | 
|  CodeBuild  |  codebuild  |  AWS\$1ENDPOINT\$1URL\$1CODEBUILD  | 
|  CodeCatalyst  |  codecatalyst  |  AWS\$1ENDPOINT\$1URL\$1CODECATALYST  | 
|  CodeCommit  |  codecommit  |  AWS\$1ENDPOINT\$1URL\$1CODECOMMIT  | 
|  CodeDeploy  |  codedeploy  |  AWS\$1ENDPOINT\$1URL\$1CODEDEPLOY  | 
|  CodeGuru Reviewer  |  codeguru\$1reviewer  |  AWS\$1ENDPOINT\$1URL\$1CODEGURU\$1REVIEWER  | 
|  CodeGuru Security  |  codeguru\$1security  |  AWS\$1ENDPOINT\$1URL\$1CODEGURU\$1SECURITY  | 
|  CodeGuruProfiler  |  codeguruprofiler  |  AWS\$1ENDPOINT\$1URL\$1CODEGURUPROFILER  | 
|  CodePipeline  |  codepipeline  |  AWS\$1ENDPOINT\$1URL\$1CODEPIPELINE  | 
|  CodeStar  |  codestar  |  AWS\$1ENDPOINT\$1URL\$1CODESTAR  | 
|  CodeStar connections  |  codestar\$1connections  |  AWS\$1ENDPOINT\$1URL\$1CODESTAR\$1CONNECTIONS  | 
|  codestar notifications  |  codestar\$1notifications  |  AWS\$1ENDPOINT\$1URL\$1CODESTAR\$1NOTIFICATIONS  | 
|  Cognito Identity  |  cognito\$1identity  |  AWS\$1ENDPOINT\$1URL\$1COGNITO\$1IDENTITY  | 
|  Cognito Identity Provider  |  cognito\$1identity\$1provider  |  AWS\$1ENDPOINT\$1URL\$1COGNITO\$1IDENTITY\$1PROVIDER  | 
|  Cognito Sync  |  cognito\$1sync  |  AWS\$1ENDPOINT\$1URL\$1COGNITO\$1SYNC  | 
|  Comprehend  |  comprehend  |  AWS\$1ENDPOINT\$1URL\$1COMPREHEND  | 
|  ComprehendMedical  |  comprehendmedical  |  AWS\$1ENDPOINT\$1URL\$1COMPREHENDMEDICAL  | 
|  Compute Optimizer  |  compute\$1optimizer  |  AWS\$1ENDPOINT\$1URL\$1COMPUTE\$1OPTIMIZER  | 
|  Config Service  |  config\$1service  |  AWS\$1ENDPOINT\$1URL\$1CONFIG\$1SERVICE  | 
|  Connect  |  connect  |  AWS\$1ENDPOINT\$1URL\$1CONNECT  | 
|  Connect Contact Lens  |  connect\$1contact\$1lens  |  AWS\$1ENDPOINT\$1URL\$1CONNECT\$1CONTACT\$1LENS  | 
|  ConnectCampaigns  |  connectcampaigns  |  AWS\$1ENDPOINT\$1URL\$1CONNECTCAMPAIGNS  | 
|  ConnectCases  |  connectcases  |  AWS\$1ENDPOINT\$1URL\$1CONNECTCASES  | 
|  ConnectParticipant  |  connectparticipant  |  AWS\$1ENDPOINT\$1URL\$1CONNECTPARTICIPANT  | 
|  ControlTower  |  controltower  |  AWS\$1ENDPOINT\$1URL\$1CONTROLTOWER  | 
|  Cost Optimization Hub  |  cost\$1optimization\$1hub  |  AWS\$1ENDPOINT\$1URL\$1COST\$1OPTIMIZATION\$1HUB  | 
|  Cost and Usage Report Service  |  cost\$1and\$1usage\$1report\$1service  |  AWS\$1ENDPOINT\$1URL\$1COST\$1AND\$1USAGE\$1REPORT\$1SERVICE  | 
|  Customer Profiles  |  customer\$1profiles  |  AWS\$1ENDPOINT\$1URL\$1CUSTOMER\$1PROFILES  | 
|  DataBrew  |  databrew  |  AWS\$1ENDPOINT\$1URL\$1DATABREW  | 
|  DataExchange  |  dataexchange  |  AWS\$1ENDPOINT\$1URL\$1DATAEXCHANGE  | 
|  Data Pipeline  |  data\$1pipeline  |  AWS\$1ENDPOINT\$1URL\$1DATA\$1PIPELINE  | 
|  DataSync  |  datasync  |  AWS\$1ENDPOINT\$1URL\$1DATASYNC  | 
|  DataZone  |  datazone  |  AWS\$1ENDPOINT\$1URL\$1DATAZONE  | 
|  DAX  |  dax  |  AWS\$1ENDPOINT\$1URL\$1DAX  | 
|  Detective  |  detective  |  AWS\$1ENDPOINT\$1URL\$1DETECTIVE  | 
|  Device Farm  |  device\$1farm  |  AWS\$1ENDPOINT\$1URL\$1DEVICE\$1FARM  | 
|  DevOps Guru  |  devops\$1guru  |  AWS\$1ENDPOINT\$1URL\$1DEVOPS\$1GURU  | 
|  Direct Connect  |  direct\$1connect  |  AWS\$1ENDPOINT\$1URL\$1DIRECT\$1CONNECT  | 
|  Application Discovery Service  |  application\$1discovery\$1service  |  AWS\$1ENDPOINT\$1URL\$1APPLICATION\$1DISCOVERY\$1SERVICE  | 
|  DLM  |  dlm  |  AWS\$1ENDPOINT\$1URL\$1DLM  | 
|  Database Migration Service  |  database\$1migration\$1service  |  AWS\$1ENDPOINT\$1URL\$1DATABASE\$1MIGRATION\$1SERVICE  | 
|  DocDB  |  docdb  |  AWS\$1ENDPOINT\$1URL\$1DOCDB  | 
|  DocDB Elastic  |  docdb\$1elastic  |  AWS\$1ENDPOINT\$1URL\$1DOCDB\$1ELASTIC  | 
|  drs  |  drs  |  AWS\$1ENDPOINT\$1URL\$1DRS  | 
|  Directory Service  |  directory\$1service  |  AWS\$1ENDPOINT\$1URL\$1DIRECTORY\$1SERVICE  | 
|  DynamoDB  |  dynamodb  |  AWS\$1ENDPOINT\$1URL\$1DYNAMODB  | 
|  DynamoDB Streams  |  dynamodb\$1streams  |  AWS\$1ENDPOINT\$1URL\$1DYNAMODB\$1STREAMS  | 
|  EBS  |  ebs  |  AWS\$1ENDPOINT\$1URL\$1EBS  | 
|  EC2  |  ec2  |  AWS\$1ENDPOINT\$1URL\$1EC2  | 
|  EC2 Instance Connect  |  ec2\$1instance\$1connect  |  AWS\$1ENDPOINT\$1URL\$1EC2\$1INSTANCE\$1CONNECT  | 
|  ECR  |  ecr  |  AWS\$1ENDPOINT\$1URL\$1ECR  | 
|  ECR PUBLIC  |  ecr\$1public  |  AWS\$1ENDPOINT\$1URL\$1ECR\$1PUBLIC  | 
|  ECS  |  ecs  |  AWS\$1ENDPOINT\$1URL\$1ECS  | 
|  EFS  |  efs  |  AWS\$1ENDPOINT\$1URL\$1EFS  | 
|  EKS  |  eks  |  AWS\$1ENDPOINT\$1URL\$1EKS  | 
|  EKS Auth  |  eks\$1auth  |  AWS\$1ENDPOINT\$1URL\$1EKS\$1AUTH  | 
|  Elastic Inference  |  elastic\$1inference  |  AWS\$1ENDPOINT\$1URL\$1ELASTIC\$1INFERENCE  | 
|  ElastiCache  |  elasticache  |  AWS\$1ENDPOINT\$1URL\$1ELASTICACHE  | 
|  Elastic Beanstalk  |  elastic\$1beanstalk  |  AWS\$1ENDPOINT\$1URL\$1ELASTIC\$1BEANSTALK  | 
|  Elastic Transcoder  |  elastic\$1transcoder  |  AWS\$1ENDPOINT\$1URL\$1ELASTIC\$1TRANSCODER  | 
|  Elastic Load Balancing  |  elastic\$1load\$1balancing  |  AWS\$1ENDPOINT\$1URL\$1ELASTIC\$1LOAD\$1BALANCING  | 
|  Elastic Load Balancing v2  |  elastic\$1load\$1balancing\$1v2  |  AWS\$1ENDPOINT\$1URL\$1ELASTIC\$1LOAD\$1BALANCING\$1V2  | 
|  EMR  |  emr  |  AWS\$1ENDPOINT\$1URL\$1EMR  | 
|  EMR containers  |  emr\$1containers  |  AWS\$1ENDPOINT\$1URL\$1EMR\$1CONTAINERS  | 
|  EMR Serverless  |  emr\$1serverless  |  AWS\$1ENDPOINT\$1URL\$1EMR\$1SERVERLESS  | 
|  EntityResolution  |  entityresolution  |  AWS\$1ENDPOINT\$1URL\$1ENTITYRESOLUTION  | 
|  Elasticsearch Service  |  elasticsearch\$1service  |  AWS\$1ENDPOINT\$1URL\$1ELASTICSEARCH\$1SERVICE  | 
|  EventBridge  |  eventbridge  |  AWS\$1ENDPOINT\$1URL\$1EVENTBRIDGE  | 
|  Evidently  |  evidently  |  AWS\$1ENDPOINT\$1URL\$1EVIDENTLY  | 
|  finspace  |  finspace  |  AWS\$1ENDPOINT\$1URL\$1FINSPACE  | 
|  finspace data  |  finspace\$1data  |  AWS\$1ENDPOINT\$1URL\$1FINSPACE\$1DATA  | 
|  Firehose  |  firehose  |  AWS\$1ENDPOINT\$1URL\$1FIREHOSE  | 
|  fis  |  fis  |  AWS\$1ENDPOINT\$1URL\$1FIS  | 
|  FMS  |  fms  |  AWS\$1ENDPOINT\$1URL\$1FMS  | 
|  forecast  |  forecast  |  AWS\$1ENDPOINT\$1URL\$1FORECAST  | 
|  forecastquery  |  forecastquery  |  AWS\$1ENDPOINT\$1URL\$1FORECASTQUERY  | 
|  FraudDetector  |  frauddetector  |  AWS\$1ENDPOINT\$1URL\$1FRAUDDETECTOR  | 
|  FreeTier  |  freetier  |  AWS\$1ENDPOINT\$1URL\$1FREETIER  | 
|  FSx  |  fsx  |  AWS\$1ENDPOINT\$1URL\$1FSX  | 
|  GameLift  |  gamelift  |  AWS\$1ENDPOINT\$1URL\$1GAMELIFT  | 
|  Glacier  |  glacier  |  AWS\$1ENDPOINT\$1URL\$1GLACIER  | 
|  Global Accelerator  |  global\$1accelerator  |  AWS\$1ENDPOINT\$1URL\$1GLOBAL\$1ACCELERATOR  | 
|  Glue  |  glue  |  AWS\$1ENDPOINT\$1URL\$1GLUE  | 
|  grafana  |  grafana  |  AWS\$1ENDPOINT\$1URL\$1GRAFANA  | 
|  Greengrass  |  greengrass  |  AWS\$1ENDPOINT\$1URL\$1GREENGRASS  | 
|  GreengrassV2  |  greengrassv2  |  AWS\$1ENDPOINT\$1URL\$1GREENGRASSV2  | 
|  GroundStation  |  groundstation  |  AWS\$1ENDPOINT\$1URL\$1GROUNDSTATION  | 
|  GuardDuty  |  guardduty  |  AWS\$1ENDPOINT\$1URL\$1GUARDDUTY  | 
|  Health  |  health  |  AWS\$1ENDPOINT\$1URL\$1HEALTH  | 
|  HealthLake  |  healthlake  |  AWS\$1ENDPOINT\$1URL\$1HEALTHLAKE  | 
|  Honeycode  |  honeycode  |  AWS\$1ENDPOINT\$1URL\$1HONEYCODE  | 
|  IAM  |  iam  |  AWS\$1ENDPOINT\$1URL\$1IAM  | 
|  identitystore  |  identitystore  |  AWS\$1ENDPOINT\$1URL\$1IDENTITYSTORE  | 
|  imagebuilder  |  imagebuilder  |  AWS\$1ENDPOINT\$1URL\$1IMAGEBUILDER  | 
|  ImportExport  |  importexport  |  AWS\$1ENDPOINT\$1URL\$1IMPORTEXPORT  | 
|  Inspector  |  inspector  |  AWS\$1ENDPOINT\$1URL\$1INSPECTOR  | 
|  Inspector Scan  |  inspector\$1scan  |  AWS\$1ENDPOINT\$1URL\$1INSPECTOR\$1SCAN  | 
|  Inspector2  |  inspector2  |  AWS\$1ENDPOINT\$1URL\$1INSPECTOR2  | 
|  InternetMonitor  |  internetmonitor  |  AWS\$1ENDPOINT\$1URL\$1INTERNETMONITOR  | 
|  IoT  |  iot  |  AWS\$1ENDPOINT\$1URL\$1IOT  | 
|  IoT Data Plane  |  iot\$1data\$1plane  |  AWS\$1ENDPOINT\$1URL\$1IOT\$1DATA\$1PLANE  | 
|  IoT Jobs Data Plane  |  iot\$1jobs\$1data\$1plane  |  AWS\$1ENDPOINT\$1URL\$1IOT\$1JOBS\$1DATA\$1PLANE  | 
|  IoT 1Click Devices Service  |  iot\$11click\$1devices\$1service  |  AWS\$1ENDPOINT\$1URL\$1IOT\$11CLICK\$1DEVICES\$1SERVICE  | 
|  IoT 1Click Projects  |  iot\$11click\$1projects  |  AWS\$1ENDPOINT\$1URL\$1IOT\$11CLICK\$1PROJECTS  | 
|  IoTAnalytics  |  iotanalytics  |  AWS\$1ENDPOINT\$1URL\$1IOTANALYTICS  | 
|  IotDeviceAdvisor  |  iotdeviceadvisor  |  AWS\$1ENDPOINT\$1URL\$1IOTDEVICEADVISOR  | 
|  IoT Events  |  iot\$1events  |  AWS\$1ENDPOINT\$1URL\$1IOT\$1EVENTS  | 
|  IoT Events Data  |  iot\$1events\$1data  |  AWS\$1ENDPOINT\$1URL\$1IOT\$1EVENTS\$1DATA  | 
|  IoTFleetHub  |  iotfleethub  |  AWS\$1ENDPOINT\$1URL\$1IOTFLEETHUB  | 
|  IoTFleetWise  |  iotfleetwise  |  AWS\$1ENDPOINT\$1URL\$1IOTFLEETWISE  | 
|  IoTSecureTunneling  |  iotsecuretunneling  |  AWS\$1ENDPOINT\$1URL\$1IOTSECURETUNNELING  | 
|  IoTSiteWise  |  iotsitewise  |  AWS\$1ENDPOINT\$1URL\$1IOTSITEWISE  | 
|  IoTThingsGraph  |  iotthingsgraph  |  AWS\$1ENDPOINT\$1URL\$1IOTTHINGSGRAPH  | 
|  IoTTwinMaker  |  iottwinmaker  |  AWS\$1ENDPOINT\$1URL\$1IOTTWINMAKER  | 
|  IoT Wireless  |  iot\$1wireless  |  AWS\$1ENDPOINT\$1URL\$1IOT\$1WIRELESS  | 
|  ivs  |  ivs  |  AWS\$1ENDPOINT\$1URL\$1IVS  | 
|  IVS RealTime  |  ivs\$1realtime  |  AWS\$1ENDPOINT\$1URL\$1IVS\$1REALTIME  | 
|  ivschat  |  ivschat  |  AWS\$1ENDPOINT\$1URL\$1IVSCHAT  | 
|  Kafka  |  kafka  |  AWS\$1ENDPOINT\$1URL\$1KAFKA  | 
|  KafkaConnect  |  kafkaconnect  |  AWS\$1ENDPOINT\$1URL\$1KAFKACONNECT  | 
|  kendra  |  kendra  |  AWS\$1ENDPOINT\$1URL\$1KENDRA  | 
|  Kendra Ranking  |  kendra\$1ranking  |  AWS\$1ENDPOINT\$1URL\$1KENDRA\$1RANKING  | 
|  Keyspaces  |  keyspaces  |  AWS\$1ENDPOINT\$1URL\$1KEYSPACES  | 
|  Kinesis  |  kinesis  |  AWS\$1ENDPOINT\$1URL\$1KINESIS  | 
|  Kinesis Video Archived Media  |  kinesis\$1video\$1archived\$1media  |  AWS\$1ENDPOINT\$1URL\$1KINESIS\$1VIDEO\$1ARCHIVED\$1MEDIA  | 
|  Kinesis Video Media  |  kinesis\$1video\$1media  |  AWS\$1ENDPOINT\$1URL\$1KINESIS\$1VIDEO\$1MEDIA  | 
|  Kinesis Video Signaling  |  kinesis\$1video\$1signaling  |  AWS\$1ENDPOINT\$1URL\$1KINESIS\$1VIDEO\$1SIGNALING  | 
|  Kinesis Video WebRTC Storage  |  kinesis\$1video\$1webrtc\$1storage  |  AWS\$1ENDPOINT\$1URL\$1KINESIS\$1VIDEO\$1WEBRTC\$1STORAGE  | 
|  Kinesis Analytics  |  kinesis\$1analytics  |  AWS\$1ENDPOINT\$1URL\$1KINESIS\$1ANALYTICS  | 
|  Kinesis Analytics V2  |  kinesis\$1analytics\$1v2  |  AWS\$1ENDPOINT\$1URL\$1KINESIS\$1ANALYTICS\$1V2  | 
|  Kinesis Video  |  kinesis\$1video  |  AWS\$1ENDPOINT\$1URL\$1KINESIS\$1VIDEO  | 
|  KMS  |  kms  |  AWS\$1ENDPOINT\$1URL\$1KMS  | 
|  LakeFormation  |  lakeformation  |  AWS\$1ENDPOINT\$1URL\$1LAKEFORMATION  | 
|  Lambda  |  lambda  |  AWS\$1ENDPOINT\$1URL\$1LAMBDA  | 
|  Launch Wizard  |  launch\$1wizard  |  AWS\$1ENDPOINT\$1URL\$1LAUNCH\$1WIZARD  | 
|  Lex Model Building Service  |  lex\$1model\$1building\$1service  |  AWS\$1ENDPOINT\$1URL\$1LEX\$1MODEL\$1BUILDING\$1SERVICE  | 
|  Lex Runtime Service  |  lex\$1runtime\$1service  |  AWS\$1ENDPOINT\$1URL\$1LEX\$1RUNTIME\$1SERVICE  | 
|  Lex Models V2  |  lex\$1models\$1v2  |  AWS\$1ENDPOINT\$1URL\$1LEX\$1MODELS\$1V2  | 
|  Lex Runtime V2  |  lex\$1runtime\$1v2  |  AWS\$1ENDPOINT\$1URL\$1LEX\$1RUNTIME\$1V2  | 
|  License Manager  |  license\$1manager  |  AWS\$1ENDPOINT\$1URL\$1LICENSE\$1MANAGER  | 
|  License Manager Linux Subscriptions  |  license\$1manager\$1linux\$1subscriptions  |  AWS\$1ENDPOINT\$1URL\$1LICENSE\$1MANAGER\$1LINUX\$1SUBSCRIPTIONS  | 
|  License Manager User Subscriptions  |  license\$1manager\$1user\$1subscriptions  |  AWS\$1ENDPOINT\$1URL\$1LICENSE\$1MANAGER\$1USER\$1SUBSCRIPTIONS  | 
|  Lightsail  |  lightsail  |  AWS\$1ENDPOINT\$1URL\$1LIGHTSAIL  | 
|  Location  |  location  |  AWS\$1ENDPOINT\$1URL\$1LOCATION  | 
|  CloudWatch Logs  |  cloudwatch\$1logs  |  AWS\$1ENDPOINT\$1URL\$1CLOUDWATCH\$1LOGS  | 
|  LookoutEquipment  |  lookoutequipment  |  AWS\$1ENDPOINT\$1URL\$1LOOKOUTEQUIPMENT  | 
|  LookoutMetrics  |  lookoutmetrics  |  AWS\$1ENDPOINT\$1URL\$1LOOKOUTMETRICS  | 
|  LookoutVision  |  lookoutvision  |  AWS\$1ENDPOINT\$1URL\$1LOOKOUTVISION  | 
|  m2  |  m2  |  AWS\$1ENDPOINT\$1URL\$1M2  | 
|  Machine Learning  |  machine\$1learning  |  AWS\$1ENDPOINT\$1URL\$1MACHINE\$1LEARNING  | 
|  Macie2  |  macie2  |  AWS\$1ENDPOINT\$1URL\$1MACIE2  | 
|  ManagedBlockchain  |  managedblockchain  |  AWS\$1ENDPOINT\$1URL\$1MANAGEDBLOCKCHAIN  | 
|  ManagedBlockchain Query  |  managedblockchain\$1query  |  AWS\$1ENDPOINT\$1URL\$1MANAGEDBLOCKCHAIN\$1QUERY  | 
|  Marketplace Agreement  |  marketplace\$1agreement  |  AWS\$1ENDPOINT\$1URL\$1MARKETPLACE\$1AGREEMENT  | 
|  Marketplace Catalog  |  marketplace\$1catalog  |  AWS\$1ENDPOINT\$1URL\$1MARKETPLACE\$1CATALOG  | 
|  Marketplace Deployment  |  marketplace\$1deployment  |  AWS\$1ENDPOINT\$1URL\$1MARKETPLACE\$1DEPLOYMENT  | 
|  Marketplace Entitlement Service  |  marketplace\$1entitlement\$1service  |  AWS\$1ENDPOINT\$1URL\$1MARKETPLACE\$1ENTITLEMENT\$1SERVICE  | 
|  Marketplace Commerce Analytics  |  marketplace\$1commerce\$1analytics  |  AWS\$1ENDPOINT\$1URL\$1MARKETPLACE\$1COMMERCE\$1ANALYTICS  | 
|  MediaConnect  |  mediaconnect  |  AWS\$1ENDPOINT\$1URL\$1MEDIACONNECT  | 
|  MediaConvert  |  mediaconvert  |  AWS\$1ENDPOINT\$1URL\$1MEDIACONVERT  | 
|  MediaLive  |  medialive  |  AWS\$1ENDPOINT\$1URL\$1MEDIALIVE  | 
|  MediaPackage  |  mediapackage  |  AWS\$1ENDPOINT\$1URL\$1MEDIAPACKAGE  | 
|  MediaPackage Vod  |  mediapackage\$1vod  |  AWS\$1ENDPOINT\$1URL\$1MEDIAPACKAGE\$1VOD  | 
|  MediaPackageV2  |  mediapackagev2  |  AWS\$1ENDPOINT\$1URL\$1MEDIAPACKAGEV2  | 
|  MediaStore  |  mediastore  |  AWS\$1ENDPOINT\$1URL\$1MEDIASTORE  | 
|  MediaStore Data  |  mediastore\$1data  |  AWS\$1ENDPOINT\$1URL\$1MEDIASTORE\$1DATA  | 
|  MediaTailor  |  mediatailor  |  AWS\$1ENDPOINT\$1URL\$1MEDIATAILOR  | 
|  Medical Imaging  |  medical\$1imaging  |  AWS\$1ENDPOINT\$1URL\$1MEDICAL\$1IMAGING  | 
|  MemoryDB  |  memorydb  |  AWS\$1ENDPOINT\$1URL\$1MEMORYDB  | 
|  Marketplace Metering  |  marketplace\$1metering  |  AWS\$1ENDPOINT\$1URL\$1MARKETPLACE\$1METERING  | 
|  Migration Hub  |  migration\$1hub  |  AWS\$1ENDPOINT\$1URL\$1MIGRATION\$1HUB  | 
|  mgn  |  mgn  |  AWS\$1ENDPOINT\$1URL\$1MGN  | 
|  Migration Hub Refactor Spaces  |  migration\$1hub\$1refactor\$1spaces  |  AWS\$1ENDPOINT\$1URL\$1MIGRATION\$1HUB\$1REFACTOR\$1SPACES  | 
|  MigrationHub Config  |  migrationhub\$1config  |  AWS\$1ENDPOINT\$1URL\$1MIGRATIONHUB\$1CONFIG  | 
|  MigrationHubOrchestrator  |  migrationhuborchestrator  |  AWS\$1ENDPOINT\$1URL\$1MIGRATIONHUBORCHESTRATOR  | 
|  MigrationHubStrategy  |  migrationhubstrategy  |  AWS\$1ENDPOINT\$1URL\$1MIGRATIONHUBSTRATEGY  | 
|  Mobile  |  mobile  |  AWS\$1ENDPOINT\$1URL\$1MOBILE  | 
|  mq  |  mq  |  AWS\$1ENDPOINT\$1URL\$1MQ  | 
|  MTurk  |  mturk  |  AWS\$1ENDPOINT\$1URL\$1MTURK  | 
|  MWAA  |  mwaa  |  AWS\$1ENDPOINT\$1URL\$1MWAA  | 
|  Neptune  |  neptune  |  AWS\$1ENDPOINT\$1URL\$1NEPTUNE  | 
|  Neptune Graph  |  neptune\$1graph  |  AWS\$1ENDPOINT\$1URL\$1NEPTUNE\$1GRAPH  | 
|  neptunedata  |  neptunedata  |  AWS\$1ENDPOINT\$1URL\$1NEPTUNEDATA  | 
|  Network Firewall  |  network\$1firewall  |  AWS\$1ENDPOINT\$1URL\$1NETWORK\$1FIREWALL  | 
|  NetworkManager  |  networkmanager  |  AWS\$1ENDPOINT\$1URL\$1NETWORKMANAGER  | 
|  NetworkMonitor  |  networkmonitor  |  AWS\$1ENDPOINT\$1URL\$1NETWORKMONITOR  | 
|  nimble  |  nimble  |  AWS\$1ENDPOINT\$1URL\$1NIMBLE  | 
|  OAM  |  oam  |  AWS\$1ENDPOINT\$1URL\$1OAM  | 
|  Omics  |  omics  |  AWS\$1ENDPOINT\$1URL\$1OMICS  | 
|  OpenSearch  |  opensearch  |  AWS\$1ENDPOINT\$1URL\$1OPENSEARCH  | 
|  OpenSearchServerless  |  opensearchserverless  |  AWS\$1ENDPOINT\$1URL\$1OPENSEARCHSERVERLESS  | 
|  OpsWorks  |  opsworks  |  AWS\$1ENDPOINT\$1URL\$1OPSWORKS  | 
|  OpsWorksCM  |  opsworkscm  |  AWS\$1ENDPOINT\$1URL\$1OPSWORKSCM  | 
|  Organizations  |  organizations  |  AWS\$1ENDPOINT\$1URL\$1ORGANIZATIONS  | 
|  OSIS  |  osis  |  AWS\$1ENDPOINT\$1URL\$1OSIS  | 
|  Outposts  |  outposts  |  AWS\$1ENDPOINT\$1URL\$1OUTPOSTS  | 
|  p8data  |  p8data  |  AWS\$1ENDPOINT\$1URL\$1P8DATA  | 
|  p8data  |  p8data  |  AWS\$1ENDPOINT\$1URL\$1P8DATA  | 
|  Panorama  |  panorama  |  AWS\$1ENDPOINT\$1URL\$1PANORAMA  | 
|  Payment Cryptography  |  payment\$1cryptography  |  AWS\$1ENDPOINT\$1URL\$1PAYMENT\$1CRYPTOGRAPHY  | 
|  Payment Cryptography Data  |  payment\$1cryptography\$1data  |  AWS\$1ENDPOINT\$1URL\$1PAYMENT\$1CRYPTOGRAPHY\$1DATA  | 
|  Pca Connector Ad  |  pca\$1connector\$1ad  |  AWS\$1ENDPOINT\$1URL\$1PCA\$1CONNECTOR\$1AD  | 
|  Personalize  |  personalize  |  AWS\$1ENDPOINT\$1URL\$1PERSONALIZE  | 
|  Personalize Events  |  personalize\$1events  |  AWS\$1ENDPOINT\$1URL\$1PERSONALIZE\$1EVENTS  | 
|  Personalize Runtime  |  personalize\$1runtime  |  AWS\$1ENDPOINT\$1URL\$1PERSONALIZE\$1RUNTIME  | 
|  PI  |  pi  |  AWS\$1ENDPOINT\$1URL\$1PI  | 
|  Pinpoint  |  pinpoint  |  AWS\$1ENDPOINT\$1URL\$1PINPOINT  | 
|  Pinpoint Email  |  pinpoint\$1email  |  AWS\$1ENDPOINT\$1URL\$1PINPOINT\$1EMAIL  | 
|  Pinpoint SMS Voice  |  pinpoint\$1sms\$1voice  |  AWS\$1ENDPOINT\$1URL\$1PINPOINT\$1SMS\$1VOICE  | 
|  Pinpoint SMS Voice V2  |  pinpoint\$1sms\$1voice\$1v2  |  AWS\$1ENDPOINT\$1URL\$1PINPOINT\$1SMS\$1VOICE\$1V2  | 
|  Pipes  |  pipes  |  AWS\$1ENDPOINT\$1URL\$1PIPES  | 
|  Polly  |  polly  |  AWS\$1ENDPOINT\$1URL\$1POLLY  | 
|  Pricing  |  pricing  |  AWS\$1ENDPOINT\$1URL\$1PRICING  | 
|  PrivateNetworks  |  privatenetworks  |  AWS\$1ENDPOINT\$1URL\$1PRIVATENETWORKS  | 
|  Proton  |  proton  |  AWS\$1ENDPOINT\$1URL\$1PROTON  | 
|  QBusiness  |  qbusiness  |  AWS\$1ENDPOINT\$1URL\$1QBUSINESS  | 
|  QConnect  |  qconnect  |  AWS\$1ENDPOINT\$1URL\$1QCONNECT  | 
|  QLDB  |  qldb  |  AWS\$1ENDPOINT\$1URL\$1QLDB  | 
|  QLDB Session  |  qldb\$1session  |  AWS\$1ENDPOINT\$1URL\$1QLDB\$1SESSION  | 
|  QuickSight  |  quicksight  |  AWS\$1ENDPOINT\$1URL\$1QUICKSIGHT  | 
|  RAM  |  ram  |  AWS\$1ENDPOINT\$1URL\$1RAM  | 
|  rbin  |  rbin  |  AWS\$1ENDPOINT\$1URL\$1RBIN  | 
|  RDS  |  rds  |  AWS\$1ENDPOINT\$1URL\$1RDS  | 
|  RDS Data  |  rds\$1data  |  AWS\$1ENDPOINT\$1URL\$1RDS\$1DATA  | 
|  Redshift  |  redshift  |  AWS\$1ENDPOINT\$1URL\$1REDSHIFT  | 
|  Redshift Data  |  redshift\$1data  |  AWS\$1ENDPOINT\$1URL\$1REDSHIFT\$1DATA  | 
|  Redshift Serverless  |  redshift\$1serverless  |  AWS\$1ENDPOINT\$1URL\$1REDSHIFT\$1SERVERLESS  | 
|  Rekognition  |  rekognition  |  AWS\$1ENDPOINT\$1URL\$1REKOGNITION  | 
|  repostspace  |  repostspace  |  AWS\$1ENDPOINT\$1URL\$1REPOSTSPACE  | 
|  resiliencehub  |  resiliencehub  |  AWS\$1ENDPOINT\$1URL\$1RESILIENCEHUB  | 
|  Resource Explorer 2  |  resource\$1explorer\$12  |  AWS\$1ENDPOINT\$1URL\$1RESOURCE\$1EXPLORER\$12  | 
|  Resource Groups  |  resource\$1groups  |  AWS\$1ENDPOINT\$1URL\$1RESOURCE\$1GROUPS  | 
|  Resource Groups Tagging API  |  resource\$1groups\$1tagging\$1api  |  AWS\$1ENDPOINT\$1URL\$1RESOURCE\$1GROUPS\$1TAGGING\$1API  | 
|  RoboMaker  |  robomaker  |  AWS\$1ENDPOINT\$1URL\$1ROBOMAKER  | 
|  RolesAnywhere  |  rolesanywhere  |  AWS\$1ENDPOINT\$1URL\$1ROLESANYWHERE  | 
|  Route 53  |  route\$153  |  AWS\$1ENDPOINT\$1URL\$1ROUTE\$153  | 
|  Route53 Recovery Cluster  |  route53\$1recovery\$1cluster  |  AWS\$1ENDPOINT\$1URL\$1ROUTE53\$1RECOVERY\$1CLUSTER  | 
|  Route53 Recovery Control Config  |  route53\$1recovery\$1control\$1config  |  AWS\$1ENDPOINT\$1URL\$1ROUTE53\$1RECOVERY\$1CONTROL\$1CONFIG  | 
|  Route53 Recovery Readiness  |  route53\$1recovery\$1readiness  |  AWS\$1ENDPOINT\$1URL\$1ROUTE53\$1RECOVERY\$1READINESS  | 
|  Route 53 Domains  |  route\$153\$1domains  |  AWS\$1ENDPOINT\$1URL\$1ROUTE\$153\$1DOMAINS  | 
|  Route53Resolver  |  route53resolver  |  AWS\$1ENDPOINT\$1URL\$1ROUTE53RESOLVER  | 
|  RUM  |  rum  |  AWS\$1ENDPOINT\$1URL\$1RUM  | 
|  S3  |  s3  |  AWS\$1ENDPOINT\$1URL\$1S3  | 
|  S3 Control  |  s3\$1control  |  AWS\$1ENDPOINT\$1URL\$1S3\$1CONTROL  | 
|  S3Outposts  |  s3outposts  |  AWS\$1ENDPOINT\$1URL\$1S3OUTPOSTS  | 
|  SageMaker  |  sagemaker  |  AWS\$1ENDPOINT\$1URL\$1SAGEMAKER  | 
|  SageMaker A2I Runtime  |  sagemaker\$1a2i\$1runtime  |  AWS\$1ENDPOINT\$1URL\$1SAGEMAKER\$1A2I\$1RUNTIME  | 
|  Sagemaker Edge  |  sagemaker\$1edge  |  AWS\$1ENDPOINT\$1URL\$1SAGEMAKER\$1EDGE  | 
|  SageMaker FeatureStore Runtime  |  sagemaker\$1featurestore\$1runtime  |  AWS\$1ENDPOINT\$1URL\$1SAGEMAKER\$1FEATURESTORE\$1RUNTIME  | 
|  SageMaker Geospatial  |  sagemaker\$1geospatial  |  AWS\$1ENDPOINT\$1URL\$1SAGEMAKER\$1GEOSPATIAL  | 
|  SageMaker Metrics  |  sagemaker\$1metrics  |  AWS\$1ENDPOINT\$1URL\$1SAGEMAKER\$1METRICS  | 
|  SageMaker Runtime  |  sagemaker\$1runtime  |  AWS\$1ENDPOINT\$1URL\$1SAGEMAKER\$1RUNTIME  | 
|  savingsplans  |  savingsplans  |  AWS\$1ENDPOINT\$1URL\$1SAVINGSPLANS  | 
|  Scheduler  |  scheduler  |  AWS\$1ENDPOINT\$1URL\$1SCHEDULER  | 
|  schemas  |  schemas  |  AWS\$1ENDPOINT\$1URL\$1SCHEMAS  | 
|  SimpleDB  |  simpledb  |  AWS\$1ENDPOINT\$1URL\$1SIMPLEDB  | 
|  Secrets Manager  |  secrets\$1manager  |  AWS\$1ENDPOINT\$1URL\$1SECRETS\$1MANAGER  | 
|  SecurityHub  |  securityhub  |  AWS\$1ENDPOINT\$1URL\$1SECURITYHUB  | 
|  SecurityLake  |  securitylake  |  AWS\$1ENDPOINT\$1URL\$1SECURITYLAKE  | 
|  ServerlessApplicationRepository  |  serverlessapplicationrepository  |  AWS\$1ENDPOINT\$1URL\$1SERVERLESSAPPLICATIONREPOSITORY  | 
|  Service Quotas  |  service\$1quotas  |  AWS\$1ENDPOINT\$1URL\$1SERVICE\$1QUOTAS  | 
|  Service Catalog  |  service\$1catalog  |  AWS\$1ENDPOINT\$1URL\$1SERVICE\$1CATALOG  | 
|  Service Catalog AppRegistry  |  service\$1catalog\$1appregistry  |  AWS\$1ENDPOINT\$1URL\$1SERVICE\$1CATALOG\$1APPREGISTRY  | 
|  ServiceDiscovery  |  servicediscovery  |  AWS\$1ENDPOINT\$1URL\$1SERVICEDISCOVERY  | 
|  SES  |  ses  |  AWS\$1ENDPOINT\$1URL\$1SES  | 
|  SESv2  |  sesv2  |  AWS\$1ENDPOINT\$1URL\$1SESV2  | 
|  Shield  |  shield  |  AWS\$1ENDPOINT\$1URL\$1SHIELD  | 
|  signer  |  signer  |  AWS\$1ENDPOINT\$1URL\$1SIGNER  | 
|  SimSpaceWeaver  |  simspaceweaver  |  AWS\$1ENDPOINT\$1URL\$1SIMSPACEWEAVER  | 
|  SMS  |  sms  |  AWS\$1ENDPOINT\$1URL\$1SMS  | 
|  Snow Device Management  |  snow\$1device\$1management  |  AWS\$1ENDPOINT\$1URL\$1SNOW\$1DEVICE\$1MANAGEMENT  | 
|  Snowball  |  snowball  |  AWS\$1ENDPOINT\$1URL\$1SNOWBALL  | 
|  SNS  |  sns  |  AWS\$1ENDPOINT\$1URL\$1SNS  | 
|  SQS  |  sqs  |  AWS\$1ENDPOINT\$1URL\$1SQS  | 
|  SSM  |  ssm  |  AWS\$1ENDPOINT\$1URL\$1SSM  | 
|  SSM Contacts  |  ssm\$1contacts  |  AWS\$1ENDPOINT\$1URL\$1SSM\$1CONTACTS  | 
|  SSM Incidents  |  ssm\$1incidents  |  AWS\$1ENDPOINT\$1URL\$1SSM\$1INCIDENTS  | 
|  Ssm Sap  |  ssm\$1sap  |  AWS\$1ENDPOINT\$1URL\$1SSM\$1SAP  | 
|  SSO  |  sso  |  AWS\$1ENDPOINT\$1URL\$1SSO  | 
|  SSO Admin  |  sso\$1admin  |  AWS\$1ENDPOINT\$1URL\$1SSO\$1ADMIN  | 
|  SSO OIDC  |  sso\$1oidc  |  AWS\$1ENDPOINT\$1URL\$1SSO\$1OIDC  | 
|  SFN  |  sfn  |  AWS\$1ENDPOINT\$1URL\$1SFN  | 
|  Storage Gateway  |  storage\$1gateway  |  AWS\$1ENDPOINT\$1URL\$1STORAGE\$1GATEWAY  | 
|  STS  |  sts  |  AWS\$1ENDPOINT\$1URL\$1STS  | 
|  SupplyChain  |  supplychain  |  AWS\$1ENDPOINT\$1URL\$1SUPPLYCHAIN  | 
|  Support  |  support  |  AWS\$1ENDPOINT\$1URL\$1SUPPORT  | 
|  Support App  |  support\$1app  |  AWS\$1ENDPOINT\$1URL\$1SUPPORT\$1APP  | 
|  SWF  |  swf  |  AWS\$1ENDPOINT\$1URL\$1SWF  | 
|  synthetics  |  synthetics  |  AWS\$1ENDPOINT\$1URL\$1SYNTHETICS  | 
|  Textract  |  textract  |  AWS\$1ENDPOINT\$1URL\$1TEXTRACT  | 
|  Timestream InfluxDB  |  timestream\$1influxdb  |  AWS\$1ENDPOINT\$1URL\$1TIMESTREAM\$1INFLUXDB  | 
|  Timestream Query  |  timestream\$1query  |  AWS\$1ENDPOINT\$1URL\$1TIMESTREAM\$1QUERY  | 
|  Timestream Write  |  timestream\$1write  |  AWS\$1ENDPOINT\$1URL\$1TIMESTREAM\$1WRITE  | 
|  tnb  |  tnb  |  AWS\$1ENDPOINT\$1URL\$1TNB  | 
|  Transcribe  |  transcribe  |  AWS\$1ENDPOINT\$1URL\$1TRANSCRIBE  | 
|  Transfer  |  transfer  |  AWS\$1ENDPOINT\$1URL\$1TRANSFER  | 
|  Translate  |  translate  |  AWS\$1ENDPOINT\$1URL\$1TRANSLATE  | 
|  TrustedAdvisor  |  trustedadvisor  |  AWS\$1ENDPOINT\$1URL\$1TRUSTEDADVISOR  | 
|  VerifiedPermissions  |  verifiedpermissions  |  AWS\$1ENDPOINT\$1URL\$1VERIFIEDPERMISSIONS  | 
|  Voice ID  |  voice\$1id  |  AWS\$1ENDPOINT\$1URL\$1VOICE\$1ID  | 
|  VPC Lattice  |  vpc\$1lattice  |  AWS\$1ENDPOINT\$1URL\$1VPC\$1LATTICE  | 
|  WAF  |  waf  |  AWS\$1ENDPOINT\$1URL\$1WAF  | 
|  WAF Regional  |  waf\$1regional  |  AWS\$1ENDPOINT\$1URL\$1WAF\$1REGIONAL  | 
|  WAFV2  |  wafv2  |  AWS\$1ENDPOINT\$1URL\$1WAFV2  | 
|  WellArchitected  |  wellarchitected  |  AWS\$1ENDPOINT\$1URL\$1WELLARCHITECTED  | 
|  Wisdom  |  wisdom  |  AWS\$1ENDPOINT\$1URL\$1WISDOM  | 
|  WorkDocs  |  workdocs  |  AWS\$1ENDPOINT\$1URL\$1WORKDOCS  | 
|  WorkLink  |  worklink  |  AWS\$1ENDPOINT\$1URL\$1WORKLINK  | 
|  WorkMail  |  workmail  |  AWS\$1ENDPOINT\$1URL\$1WORKMAIL  | 
|  WorkMailMessageFlow  |  workmailmessageflow  |  AWS\$1ENDPOINT\$1URL\$1WORKMAILMESSAGEFLOW  | 
|  WorkSpaces  |  workspaces  |  AWS\$1ENDPOINT\$1URL\$1WORKSPACES  | 
|  WorkSpaces Thin Client  |  workspaces\$1thin\$1client  |  AWS\$1ENDPOINT\$1URL\$1WORKSPACES\$1THIN\$1CLIENT  | 
|  WorkSpaces Web  |  workspaces\$1web  |  AWS\$1ENDPOINT\$1URL\$1WORKSPACES\$1WEB  | 
|  XRay  |  xray  |  AWS\$1ENDPOINT\$1URL\$1XRAY  | 

# Padrões de configuração inteligente
<a name="feature-smart-config-defaults"></a>

**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, consulte[Entender as páginas de configurações deste guia](settings-reference.md#settingsPages).

Com o recurso de padrões de configuração inteligente, AWS SDKs pode fornecer valores padrão predefinidos e otimizados para outras configurações. 

Configure essa funcionalidade usando o seguinte:

**`defaults_mode`- configuração de AWS `config` arquivo compartilhado`AWS_DEFAULTS_MODE`: variável de ambiente`aws.defaultsMode`- Propriedade do sistema JVM: somente Java/Kotlin **  
Com essa configuração, você pode escolher um modo que se alinhe à arquitetura do aplicativo e, em seguida, forneça valores padrão otimizados para o aplicativo. Se uma configuração do AWS SDK tiver um valor definido explicitamente, esse valor sempre terá precedência. Se uma configuração do AWS SDK não tiver um valor definido explicitamente e não `defaults_mode` for igual ao legado, esse recurso poderá fornecer valores padrão diferentes para várias configurações otimizadas para seu aplicativo. As configurações podem incluir o seguinte: configurações de comunicação HTTP, comportamento de repetição, configurações de endpoint regional do serviço e, potencialmente, qualquer configuração relacionada ao SDK. Os clientes que usam esse atributo podem obter novos padrões de configuração personalizados para cenários de uso comuns. Se seu `defaults_mode` não for igual a `legacy`, recomendamos realizar testes de seu aplicativo ao atualizar o SDK, pois os valores padrão fornecidos podem mudar à medida que as melhores práticas evoluem.  
**Valor padrão**: `legacy`  
Nota: As novas versões principais do SDKs terão como padrão`standard`.  
**Valores válidos:**  
+ `legacy`: fornece configurações padrão que variam de acordo com o SDK e existiam antes do estabelecimento do `defaults_mode`.
+ `standard`: fornece os valores padrão recomendados mais recentes que devem ser executados com segurança na maioria dos cenários. 
+ `in-region`— Baseia-se no modo padrão e inclui otimização personalizada para aplicativos que ligam Serviços da AWS de dentro do mesmo Região da AWS.
+ `cross-region`— Baseia-se no modo padrão e inclui otimização personalizada para aplicativos que fazem chamadas Serviços da AWS em uma região diferente.
+ `mobile`: baseia-se no modo padrão e inclui otimização personalizada para aplicativos móveis.
+ `auto`: baseia-se no modo padrão e inclui atributos experimentais. O SDK tenta descobrir o ambiente de runtime para determinar automaticamente as configurações apropriadas. A detecção automática é baseada em heurísticas e não fornece 100% de precisão. Se o ambiente de runtime não puder ser determinado, o modo `standard` será usado. A detecção automática pode consultar os [metadados da instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html), o que pode introduzir latência. Se a latência de inicialização for fundamental para seu aplicativo, recomendamos escolher um `defaults_mode` explícito.
 Exemplo de configuração desse valor no arquivo `config`:  

```
[default]
defaults_mode = standard
```
Os parâmetros a seguir podem ser otimizados com base na seleção de `defaults_mode`:  
+ `retryMode`: especifica como o SDK tenta novas tentativas. Consulte [Comportamento de repetição](feature-retry-behavior.md). 
+ `stsRegionalEndpoints`— Especifica como o SDK determina o AWS service (Serviço da AWS) endpoint que ele usa para se comunicar com o AWS Security Token Service ().AWS STS Consulte [AWS STS Endpoints regionais](feature-sts-regionalized-endpoints.md). 
+ `s3UsEast1RegionalEndpoints`— Especifica como o SDK determina o endpoint AWS de serviço que ele usa para se comunicar com o Amazon S3 da região. `us-east-1` 
+ `connectTimeoutInMillis`: depois de fazer uma tentativa inicial de conexão em um soquete, a quantidade de tempo antes do tempo limite. Se o cliente não receber a conclusão do handshake de conexão, ele desiste e falhará na operação. 
+ `tlsNegotiationTimeoutInMillis`: o tempo máximo que um handshake TLS pode levar desde o momento em que a mensagem CLIENT HELLO é enviada até o momento em que o cliente e o servidor negociaram totalmente as cifras e trocaram as chaves. 

O valor padrão para cada configuração muda dependendo da `defaults_mode` selecionada para seu aplicativo. Atualmente, esses valores são definidos da seguinte forma (sujeitos a alterações):


| Parâmetro | Modo `standard` | Modo `in-region` | Modo `cross-region` | Modo `mobile` | 
| --- | --- | --- | --- | --- | 
|  retryMode  | standard | standard | standard | standard | 
|  stsRegionalEndpoints  | regional | regional | regional | regional | 
|  s3UsEast1RegionalEndpoints  | regional | regional | regional | regional | 
|  connectTimeoutInMillis  | 3100 | 1100 | 3100 | 30000 | 
|  tlsNegotiationTimeoutInMillis  | 3100 | 1100 | 3100 | 30000 | 

Por exemplo, se o `defaults_mode` que você selecionou fosse `standard`, o valor de `standard` seria atribuído a `retry_mode` (das opções `retry_mode` válidas) e o valor de `regional` seria atribuído a `stsRegionalEndpoints` (das opções `stsRegionalEndpoints` válidas).

## Support by AWS SDKs and tools
<a name="feature-smart-config-defaults-sdk-compat"></a>

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](https://docs.aws.amazon.com/cli/latest/userguide/) | Não |  | 
| [SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp/latest/developer-guide/) |  Sim | Parâmetros não otimizados:stsRegionalEndpoints, s3UsEast1RegionalEndpoints, tlsNegotiationTimeoutInMillis. | 
| [SDK para Go V2 (1.x)](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/) | Sim | Parâmetros não otimizados:retryMode, stsRegionalEndpoints, s3UsEast1RegionalEndpoints. | 
| [SDK para Go 1.x (V1)](https://docs.aws.amazon.com/sdk-for-go/latest/developer-guide/) | Não |  | 
| [SDK para Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/) | Sim | Parâmetros não otimizados: stsRegionalEndpoints. | 
| [SDK para Java 1.x](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/) | Não |  | 
| [SDK para 3.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/) | Sim | Parâmetros não otimizados:stsRegionalEndpoints, s3UsEast1RegionalEndpoints, tlsNegotiationTimeoutInMillis. connectTimeoutInMillis é chamado connectionTimeout. | 
| [SDK para 2.x JavaScript ](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/) | Não |  | 
| [SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/) | Não |  | 
| [SDK para .NET 4.x](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/) | Sim | Parâmetros não otimizados: connectTimeoutInMillis, tlsNegotiationTimeoutInMillis. | 
| [SDK para .NET 3.x](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/) | Sim | Parâmetros não otimizados: connectTimeoutInMillis, tlsNegotiationTimeoutInMillis. | 
| [SDK para PHP 3.x](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/) | Sim | Parâmetros não otimizados: tlsNegotiationTimeoutInMillis. | 
| [SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) | Sim | Parâmetros não otimizados: tlsNegotiationTimeoutInMillis. | 
| [SDK para Ruby 3.x](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/) | Sim |   | 
| [SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/) | Não |  | 
| [SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift/latest/developer-guide/) | Não |  | 
| [Ferramentas para PowerShell V5](https://docs.aws.amazon.com/powershell/latest/userguide/) | Sim | Parâmetros não otimizados: connectTimeoutInMillis, tlsNegotiationTimeoutInMillis. | 
| [Ferramentas para PowerShell V4](https://docs.aws.amazon.com/powershell/v4/userguide/) | Sim | Parâmetros não otimizados: connectTimeoutInMillis, tlsNegotiationTimeoutInMillis. |