Mise à jour d’un emplacement enregistré

Vous pouvez mettre à jour le rôle AWS Identity and Access Management (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 octrois d’accès S3, veillez à accorder au principal du service d’octrois d’accès S3 (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 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 AWS des SDK.

Utilisation de la console S3

Pour mettre à jour le rôle IAM d’un emplacement enregistré auprès de votre instance d’octrois d’accès S3

1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/s3/.

2. Dans le volet de navigation de gauche, choisissez Access Grants.

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

4. Choisissez Afficher les détails pour cette instance.

5. Sur la page de détails de l’instance, choisissez l’onglet Succursales.

6. Recherchez l’emplacement que vous souhaitez mettre à jour. Pour filtrer la liste des emplacements, utilisez la zone de recherche.

7. Choisissez le bouton d’options en regard de l’emplacement enregistré que vous voulez mettre à jour.

8. Mettez à jour le rôle IAM, puis choisissez Enregistrer les modifications.

En utilisant le AWS CLI

Pour l'installer AWS CLI, reportez-vous à la section Installation du AWS CLI dans le guide de AWS Command Line Interface l'utilisateur.

Pour utiliser l'exemple de commande suivant, remplacez user input placeholders par vos propres informations.

Exemple : 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://DOC-EXAMPLE-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 d’octrois d’accès S3, consultez UpdateAccessGrantsLocation dans la Référence d’API Amazon Simple Storage Service.

Utilisation des AWS SDK

Cette section fournit des exemples de mise à jour du rôle IAM d'un emplacement enregistré à l'aide des AWS SDK.

Pour utiliser l'exemple suivant, remplacez user input placeholders par vos propres informations.

Java

Exemple : 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://DOC-EXAMPLE-BUCKET/prefixB*,
IAMRoleArn=arn:aws:iam::777788889999:role/accessGrantsTestRole
)