Pontos de acesso Amazon S3 - AWS SDKs e ferramentas

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á.

Pontos de acesso Amazon S3

nota

Para obter ajuda em compreender o layout das páginas de configurações ou interpretar a tabela Compatibilidade com SDKs e ferramentas da AWS a seguir, consulte Entender as páginas de configurações deste guia.

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 os AWS SDKs, você pode usar o ponto de acesso Nomes do recurso da Amazon (ARNs) no campo de 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 GetObject para buscar um objeto de um bucket ou usar um ponto de acesso ARN com o PutObject para adicionar um objeto a um bucket.

Para saber mais sobre os pontos de acesso Amazon S3 e ARNs, consulte Usar pontos de acesso no Guia do usuário do Amazon S3.

Configure essa funcionalidade usando o seguinte:

s3_use_arn_region: configuração de arquivo config da AWS compartilhado
AWS_S3_USE_ARN_REGION: variável de ambiente
aws.s3UseArnRegion: propriedade do sistema de JVM: apenas 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 ARN das Região da AWS do ponto de acesso para construir o endpoint regional para a solicitação. O SDK valida que o ARN da Região da AWS é servido pela mesma partição da AWS que a Região da AWS configurada pelo cliente 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 a Região da AWS da ARN ao construir o endpoint em vez da Região da AWS configurada pelo cliente. Exceção: se a Região da AWS configurada pelo cliente for FIPS Região da AWS, ela deverá corresponder à Região da AWS do ARN. Caso contrário, ocorrerá um erro.

  • false: o SDK usa a Região da AWS configurada pelo cliente ao construir o endpoint.

Compatibilidade com SDKs e ferramentas da AWS

Os SDKs a seguir são compatíveis com os recursos e configurações descritos neste tópico. Quaisquer exceções parciais estão anotadas. As configurações de propriedade do sistema de JVM são compatíveis apenas como o AWS SDK para Java e o AWS SDK para Kotlin.

SDK Compatível Notas ou mais informações
AWS CLI v2 da2 Sim
SDK para C++ Sim
SDK para Go V2 (1.x) Sim
SDK para Go 1.x (V1) Sim Para usar as configurações do arquivo config compartilhado, você deve ativar o carregamento do arquivo de configuração; consulte Sessões.
SDK para Java 2.x Sim
SDK para Java 1.x Sim Propriedade do sistema de JVM não compatível.
SDK para JavaScript 3.x Sim
SDK para JavaScript 2.x Sim
SDK para Kotlin Sim
SDK para .NET 4.x Sim
SDK para .NET 3.x 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 Sim
SDK para Python (Boto3) Sim
SDK para Ruby 3.x Sim
SDK para Rust Não
SDK para Swift Não
Ferramentas para PowerShell V5 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 Sim Não segue a precedência padrão, o valor do arquivo compartilhado config tem precedência sobre a variável de ambiente.