Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Utilisation de points d'accès multirégionaux avec des opérations prises en charge API
Amazon S3 fournit un ensemble d'opérations permettant de gérer les points d'accès multi-régions. Amazon S3 traite certaines de ces opérations de manière synchrone et d'autres de manière asynchrone. Lorsque vous appelez une opération asynchrone, Amazon S3 autorise d'abord l'opération demandée de manière synchrone. Si l'autorisation réussit, Amazon S3 renvoie un jeton que vous pourrez utiliser pour suivre la progression et les résultats de l'opération demandée.
Note
Les demandes effectuées via la console Amazon S3 sont toujours synchrones. La console attend que la demande soit terminée avant de vous autoriser à envoyer une autre demande.
Vous pouvez consulter l'état actuel et les résultats des opérations asynchrones à l'aide de la console, ou DescribeMultiRegionAccessPointOperation
dans le AWS CLI AWS SDKs, ou. REST API Amazon S3 fournit un jeton de suivi dans la réponse à une opération asynchrone. Vous devrez inclure ce jeton de suivi en tant qu'argument de DescribeMultiRegionAccessPointOperation
. Quand vous incluez le jeton de suivi, Amazon S3 renvoie ensuite le statut actuel et les résultats de l'opération spécifiée, notamment les éventuelles erreurs ou informations pertinentes sur les ressources. Amazon S3 effectue les opérations DescribeMultiRegionAccessPointOperation
de manière synchrone.
Toutes les demandes du plan de contrôle de création ou de gestion de points d'accès multirégions doivent être routées vers la région US West (Oregon)
. Pour les demandes de plan de données de points d'accès multirégions, il n'est pas nécessaire de spécifier les régions. Pour le plan de contrôle de basculement des points d'accès multirégions, la demande doit être routée vers l'une des cinq régions prises en charge. Pour plus d'informations sur les régions prises en charge par les points d'accès multirégionaux, consultezRestrictions et limitations des points d'accès multi-régions.
En outre, vous devez accorder l's3:ListAllMyBuckets
autorisation à l'utilisateur, au rôle ou à l'autre entité AWS Identity and Access Management (IAM) qui fait une demande de gestion d'un point d'accès multirégional.
Les exemples suivants montrent comment utiliser des points d'accès multi-régions avec des opérations compatibles dans Amazon S3.
Rubriques
- Compatibilité des points d'accès multirégionaux avec et AWS servicesAWS SDKs
- Compatibilité du point d'accès multi-régions avec les opérations S3
- Visualisez la configuration du routage de votre point d'accès multi-régions.
- Mettez à jour votre politique de compartiments Amazon S3 sous-jacente.
- Mise à jour de la configuration des itinéraires d'un point d'accès multi-régions
- Ajouter un objet à un compartiment dans votre point d'accès multirégion
- Récupération d'objets depuis votre point d'accès multirégion
- Liste des objets stockés dans un compartiment sous-jacent à votre point d'accès multirégion
- Utilisez un point d'accès multirégional présigné URL
- Utiliser un compartiment configuré avec Requester Pays avec des points d'accès multi-régions
Compatibilité des points d'accès multirégionaux avec et AWS servicesAWS SDKs
Pour utiliser un point d'accès multirégional avec des applications qui nécessitent un nom de compartiment Amazon S3, utilisez le nom de ressource Amazon (ARN) du point d'accès multirégional lorsque vous effectuez des demandes à l'aide d'un. AWS SDK Pour vérifier lesquels AWS SDKs sont compatibles avec les points d'accès multirégionaux, voir Compatibilité avec AWS SDKs.
Compatibilité du point d'accès multi-régions avec les opérations S3
Vous pouvez utiliser les API opérations suivantes sur le plan de données Amazon S3 pour effectuer des actions sur des objets dans des compartiments associés à votre point d'accès multirégional. Les opérations S3 suivantes peuvent accepter un point ARNs d'accès multirégional :
Note
Les points d'accès multirégionaux prennent en charge les opérations de copie utilisant des points d'accès multirégionaux uniquement comme destination lors de l'utilisation du point d'accès multirégional. ARN
Vous pouvez utiliser les opérations de plan de contrôle Amazon S3 suivantes pour créer et gérer vos points d'accès multirégions :
Visualisez la configuration du routage de votre point d'accès multi-régions.
Mettez à jour votre politique de compartiments Amazon S3 sous-jacente.
Pour accorder un accès approprié, vous devez également mettre à jour la politique sous-jacente du compartiment Amazon S3. Les exemples suivants délèguent le contrôle d'accès à la politique du point d'accès multi-régions. Une fois que vous avez délégué le contrôle d'accès à la politique de point d'accès multi-régions, la politique de compartiment n'est plus utilisée pour le contrôle d'accès lors de demandes effectuées via ce point d'accès.
Voici un exemple de politique de compartiment qui délègue le contrôle d'accès à la politique de point d'accès multi-régions. Pour utiliser cet exemple de politique de compartiment, remplacez
par vos propres informations. Pour appliquer cette politique par le biais de la AWS CLI user input
placeholders
put-bucket-policy
commande, comme indiqué dans l'exemple suivant, enregistrez la politique dans un fichier, par exemplepolicy.json
.
{ "Version": "2012-10-17", "Statement": { "Principal": { "AWS": "*" }, "Effect": "Allow", "Action": ["s3:*"], "Resource": ["arn:aws:s3:::
111122223333
/*", "arn:aws:s3:::amzn-s3-demo-bucket
"], "Condition": { "StringEquals": { "s3:DataAccessPointAccount": "444455556666
" } } } }
L'exemple de commande put-bucket-policy
suivant associe la politique de compartiment S3 mise à jour à votre compartiment S3 :
aws s3api put-bucket-policy --bucket
amzn-s3-demo-bucket
--policy file:///tmp/policy.json
Mise à jour de la configuration des itinéraires d'un point d'accès multi-régions
L'exemple de commande suivant met à jour la configuration des itinéraires du point d'accès multi-régions. Les commandes d'itinéraire des points d'accès multi-régions peuvent être exécutées dans les cinq régions suivantes :
-
ap-southeast-2
-
ap-northeast-1
-
us-east-1
-
us-west-2
-
eu-west-1
Dans une configuration de routage de point d'accès multi-régions, vous pouvez définir des compartiments avec un statut de routage actif ou passif. Les compartiments actifs reçoivent du trafic, tandis que les compartiments passifs n'en reçoivent pas. Vous pouvez définir le statut de routage d'un compartiment en définissant la valeur TrafficDialPercentage
de ce dernier sur 100
pour actif ou 0
pour passif.
Ajouter un objet à un compartiment dans votre point d'accès multirégion
Pour ajouter un objet au compartiment associé au point d'accès multirégion, vous pouvez utiliser l'opération PutObject. Pour maintenir synchronisés tous les compartiments dans le point d'accès multirégion, activez la réplication entre régions.
Note
Pour utiliser cette opération, vous devez disposer de l'autorisation s3:PutObject
pour le point d'accès multirégion. Pour plus d'informations sur les exigences relatives aux autorisations des points d'accès multirégions, consultez Autorisations.
Récupération d'objets depuis votre point d'accès multirégion
Pour récupérer des objets depuis le point d'accès multirégion, vous pouvez utiliser l'opération GetObject.
Note
Pour utiliser cette API opération, vous devez disposer de l's3:GetObject
autorisation pour le point d'accès multirégional. Pour plus d'informations sur les exigences relatives aux autorisations des points d'accès multirégions, consultez Autorisations.
Liste des objets stockés dans un compartiment sous-jacent à votre point d'accès multirégion
Pour renvoyer la liste des objets stockés dans un compartiment sous-jacent à votre point d'accès multirégion, utilisez l'opération ListObjectsV2. Dans l'exemple de commande suivant, tous les objets du point d'accès multirégional spécifié sont répertoriés à l'aide du point ARN d'accès multirégional. Dans ce cas, le point d'accès multirégional ARN est :
arn:aws:s3::
123456789012
:accesspoint/abcdef0123456
.mrap
Note
Pour utiliser cette API opération, vous devez disposer de l's3:ListBucket
autorisation pour le point d'accès multirégional et le bucket sous-jacent. Pour plus d'informations sur les exigences relatives aux autorisations des points d'accès multirégions, consultez Autorisations.
Utilisez un point d'accès multirégional présigné URL
Vous pouvez utiliser un présigné URL pour générer un URL qui permet à d'autres personnes d'accéder à vos compartiments Amazon S3 via un point d'accès multirégional Amazon S3. Lorsque vous créez un présignéURL, vous l'associez à une action d'objet spécifique, telle qu'un téléchargement S3 (PutObject
) ou un téléchargement S3 (GetObject
). Vous pouvez partager le document présignéURL, et toute personne y ayant accès peut effectuer l'action intégrée au document URL comme s'il s'agissait de l'utilisateur signataire d'origine.
Les documents présignés URLs ont une date d'expiration. Lorsque le délai d'expiration est atteint, URL il ne fonctionnera plus.
Avant d'utiliser des points d'accès multirégionaux S3 présignésURLs, vérifiez la AWS SDKcompatibilité avec l'algorithme SigV4A. Vérifiez que votre SDK version prend en charge SigV4a comme implémentation de signature utilisée pour signer les demandes globales Région AWS . Pour plus d'informations sur l'utilisation de Presigned URLs avec Amazon S3, consultez Partage d'objets à l'aide de URLs Presigned.
Les exemples suivants montrent comment utiliser des points d'accès multirégionaux URLs présignés. Pour utiliser ces exemples, remplacez
avec vos propres informations.espaces réservés à la saisie par l'utilisateur
Note
Pour utiliser SigV4A avec des informations d'identification de sécurité temporaires, par exemple, lorsque vous utilisez des IAM rôles, assurez-vous de demander les informations d'identification temporaires à un point de terminaison régional situé dans AWS Security Token Service ()AWS STS, plutôt qu'à un point de terminaison global. Si vous utilisez le point de terminaison global pour AWS STS (sts.amazonaws.com
), AWS STS cela générera des informations d'identification temporaires à partir d'un point de terminaison global, ce qui n'est pas pris en charge par Sig4A. Par conséquent, vous obtenez une erreur. Pour résoudre ce problème, utilisez l'un des points de terminaison régionaux répertoriés pour AWS STS.
Utiliser un compartiment configuré avec Requester Pays avec des points d'accès multi-régions
Si un compartiment S3 associé à vos points d'accès multirégions est configuré pour utiliser le paiement par le demandeur, le demandeur paiera à la fois la demande de compartiment, le téléchargement et tous les coûts liés aux points d'accès multirégions. Pour plus d’informations, consultez Tarification Amazon S3
Voici un exemple de demande de plan de données adressée à un point d'accès multirégion connecté à un compartiment de type Paiement par le demandeur.