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.
# Mise à jour d’un emplacement enregistré
Vous pouvez mettre à jour le rôle Gestion des identités et des accès AWS (IAM) d'un emplacement enregistré dans votre instance Amazon S3 Access Grants. Pour chaque nouveau rôle IAM que vous utilisez pour enregistrer un emplacement dans les autorisations d’accès S3, veillez à accorder au principal du service S3 Access Grants (`access-grants.s3.amazonaws.com`) l’accès à ce rôle. Pour ce faire, ajoutez une entrée pour le nouveau rôle IAM dans le même fichier JSON de politique d’approbation que celui que vous avez utilisé quand vous avez [enregistré l’emplacement](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-grants-location.html) pour la première fois.
Vous pouvez mettre à jour un emplacement dans votre instance S3 Access Grants à l'aide de la console Amazon S3, du AWS Command Line Interface (AWS CLI), de l'API REST Amazon S3 et du AWS SDKs.
## Utilisation de la console S3
**Pour mettre à jour le rôle IAM d’un emplacement enregistré auprès de votre instance S3 Access Grants**
1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Dans le volet de navigation de gauche, choisissez **Access Grants**.
1. Sur la page **Octrois d’accès S3**, choisissez la région qui contient l’instance d’octrois d’accès S3 qui vous intéresse.
1. Choisissez **Afficher les détails** pour cette instance.
1. Sur la page de détails de l’instance, choisissez l’onglet **Succursales**.
1. Recherchez l’emplacement que vous souhaitez mettre à jour. Pour filtrer la liste des emplacements, utilisez la zone de recherche.
1. Choisissez le bouton d’options en regard de l’emplacement enregistré que vous voulez mettre à jour.
1. Mettez à jour le rôle IAM, puis choisissez **Enregistrer les modifications**.
## À l'aide du AWS CLI
Pour l'installer AWS CLI, reportez-vous à la section [Installation du AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) dans le *guide de AWS Command Line Interface l'utilisateur*.
Pour utiliser l’exemple de commande suivant, remplacez les `user input placeholders` par vos propres informations.
**Example : Mettre à jour le rôle IAM d’un emplacement enregistré**
```
aws s3control update-access-grants-location \
--account-id 111122223333 \
--access-grants-location-id 635f1139-1af2-4e43-8131-a4de006eb999 \
--iam-role-arn arn:aws:iam::777788889999:role/accessGrantsTestRole
```
Réponse :
```
{
"CreatedAt": "2023-05-31T18:23:48.107000+00:00",
"AccessGrantsLocationId": "635f1139-1af2-4e43-8131-a4de006eb999",
"AccessGrantsLocationArn": "arn:aws:s3:us-east-2:777788889999:access-grants/default/location/635f1139-1af2-4e43-8131-a4de006eb888",
"LocationScope": "s3://amzn-s3-demo-bucket/prefixB*",
"IAMRoleArn": "arn:aws:iam::777788889999:role/accessGrantsTestRole"
}
```
## Utilisation de l'API REST
Pour en savoir plus sur la prise en charge de l’API REST Amazon S3 pour la mise à jour d’un emplacement dans une instance S3 Access Grants, consultez [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UpdateAccessGrantsLocation.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UpdateAccessGrantsLocation.html) dans la *Référence d’API Amazon Simple Storage Service*.
## En utilisant le AWS SDKs
Cette section fournit des exemples de mise à jour du rôle IAM d'un établissement enregistré à l'aide du AWS SDKs.
Pour utiliser l’exemple suivant, remplacez les `user input placeholders` par vos propres informations.
------
#### [ Java ]
**Example : Mettre à jour le rôle IAM d’un emplacement enregistré**
```
public void updateAccessGrantsLocation() {
UpdateAccessGrantsLocationRequest updateRequest = UpdateAccessGrantsLocationRequest.builder()
.accountId("111122223333")
.accessGrantsLocationId("635f1139-1af2-4e43-8131-a4de006eb999")
.iamRoleArn("arn:aws:iam::777788889999:role/accessGrantsTestRole")
.build();
UpdateAccessGrantsLocationResponse updateResponse = s3Control.updateAccessGrantsLocation(updateRequest);
LOGGER.info("UpdateAccessGrantsLocationResponse: " + updateResponse);
}
```
Réponse :
```
UpdateAccessGrantsLocationResponse(
CreatedAt=2023-06-07T04:35:10.027Z,
AccessGrantsLocationId=635f1139-1af2-4e43-8131-a4de006eb999,
AccessGrantsLocationArn=arn:aws:s3:us-east-2:777788889999:access-grants/default/location/635f1139-1af2-4e43-8131-a4de006eb888,
LocationScope=s3://amzn-s3-demo-bucket/prefixB*,
IAMRoleArn=arn:aws:iam::777788889999:role/accessGrantsTestRole
)
```
------