Points d'accès Amazon S3

Le service Amazon S3 fournit des points d'accès comme autre moyen d'interagir avec les compartiments Amazon S3. Les points d'accès ont des politiques et des configurations uniques qui peuvent leur être appliquées plutôt que directement au bucket. Avec AWS les SDK, vous pouvez utiliser les Amazon Resource Names (ARN) du point d'accès dans le champ du bucket pour les opérations d'API au lieu de spécifier explicitement le nom du bucket. Ils sont utilisés pour des opérations spécifiques telles que l'utilisation d'un point d'accès ARN GetObjectpour récupérer un objet dans un bucket, ou l'utilisation d'un ARN de point d'accès avec PutObjectpour ajouter un objet à un bucket.

Pour en savoir plus sur les points d'accès et les ARN Amazon S3, consultez la section Utilisation des points d'accès dans le guide de l'utilisateur Amazon S3.

Configurez cette fonctionnalité à l'aide des méthodes suivantes :

s3_use_arn_region- réglage AWS config du fichier partagé

AWS_S3_USE_ARN_REGION- variable d'environnement

aws.s3UseArnRegion- Propriété du système JVM : Java/Kotlin uniquement

Pour configurer la valeur directement dans le code, consultez directement votre SDK spécifique.

Ce paramètre contrôle si le SDK utilise l'ARN du point d'accès Région AWS pour créer le point de terminaison régional pour la demande. Le SDK confirme que l'ARN Région AWS est servi par la même AWS partition que celle configurée par le client afin Région AWS d'empêcher les appels entre partitions susceptibles d'échouer. Si le paramètre multiplicateur est défini, le paramètre configuré par le code est prioritaire, suivi du paramètre de variable d'environnement.

Valeur par défaut : false

Valeurs valides:

• true— Le SDK utilise les ARN Région AWS lors de la construction du point de terminaison plutôt que celui configuré Région AWS par le client. Exception : si la configuration du client Région AWS est une norme FIPS Région AWS, elle doit correspondre à l' Région AWS ARN. Si vous ne le faites pas, une erreur se produit.

• false— Le SDK utilise la configuration du client Région AWS lors de la construction du point de terminaison.

Compatibilité avec les AWS SDK

Les SDK suivants prennent en charge les fonctionnalités et les paramètres décrits dans cette rubrique. Toute exception partielle est notée. Tous les paramètres de propriété du système JVM sont pris en charge par le AWS SDK for Java et le Kit AWS SDK pour Kotlin seul.

SDK	Pris en charge	Remarques ou informations supplémentaires
AWS CLI v2	Oui
SDK pour C++	Oui
SDK pour Go V2 (1.x)	Oui
SDK pour Go 1.x (V1)	Oui	Pour utiliser les paramètres des config fichiers partagés, vous devez activer le chargement à partir du fichier de configuration ; voir Sessions.
SDK pour Java 2.x	Oui
SDK pour Java 1.x	Oui	La propriété du système JVM n'est pas prise en charge.
SDK pour 3.x JavaScript	Oui
SDK pour 2.x JavaScript	Oui
SDK pour Kotlin	Oui
SDK pour .NET 3.x	Oui	Ne suit pas la priorité standard ; la valeur config du fichier partagé a priorité sur la variable d'environnement.
SDK pour PHP 3.x	Oui
SDK pour Python (Boto3)	Oui
SDK pour Ruby 3.x	Oui
SDK pour Rust	Non
Outils pour PowerShell	Oui	Ne suit pas la priorité standard ; la valeur config du fichier partagé a priorité sur la variable d'environnement.