Affichage des détails d’un emplacement enregistré - Amazon Simple Storage Service

Affichage des détails d’un emplacement enregistré

Vous pouvez obtenir les détails d’un emplacement enregistré dans votre instance S3 Access Grants à l’aide de la console Amazon S3, de l’AWS Command Line Interface (AWS CLI), de l’API REST Amazon S3 et des kits AWS SDK.

Pour afficher les emplacements enregistrés dans votre instance S3 Access Grants

  1. Connectez-vous à la AWS Management Console et ouvrez la console Amazon S3 à 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 enregistré que vous souhaitez afficher. Pour filtrer la liste des emplacements enregistrés, utilisez la zone de recherche.

Pour installer la AWS CLI, consultez Installation de la AWS CLI dans le Guide de l’utilisateur AWS Command Line Interface.

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

Exemple : Obtenir les détails d’un emplacement enregistré
aws s3control get-access-grants-location \
--account-id 111122223333 \
--access-grants-location-id default

Réponse :

{
    "CreatedAt": "2023-05-31T18:23:48.107000+00:00",
    "AccessGrantsLocationId": "default",
    "AccessGrantsLocationArn": "arn:aws:s3:us-east-2:111122223333:access-grants/default/location/default",
    "IAMRoleArn": "arn:aws:iam::111122223333:role/accessGrantsTestRole"
}
Exemple : Répertorier tous les emplacements enregistrés dans une instance S3 Access Grants

Pour limiter les résultats à un préfixe ou à un compartiment S3, vous pouvez éventuellement utiliser le paramètre --location-scope s3://bucket-and-or-prefix. 

aws s3control list-access-grants-locations \
--account-id 111122223333 \
--region us-east-2

Réponse :

{"AccessGrantsLocationsList": [
  {
    "CreatedAt": "2023-05-31T18:23:48.107000+00:00",
    "AccessGrantsLocationId": "default",
    "AccessGrantsLocationArn": "arn:aws:s3:us-east-2:111122223333:access-grants/default/location/default",
    "LocationScope": "s3://" 
    "IAMRoleArn": "arn:aws:iam::111122223333:role/accessGrantsTestRole"
     },
  {
    "CreatedAt": "2023-05-31T18:23:48.107000+00:00",
    "AccessGrantsLocationId": "635f1139-1af2-4e43-8131-a4de006eb456",
    "AccessGrantsLocationArn": "arn:aws:s3:us-east-2:111122223333:access-grants/default/location/635f1139-1af2-4e43-8131-a4de006eb888",
    "LocationScope": "s3://amzn-s3-demo-bucket/prefixA*",
    "IAMRoleArn": "arn:aws:iam::111122223333:role/accessGrantsTestRole"
     }
   ]
  }

Pour en savoir plus sur la prise en charge de l’API REST Amazon S3 pour obtenir les détails d’un emplacement enregistré ou répertorier tous les emplacements enregistrés auprès d’une instance S3 Access Grants, consultez les sections suivantes de la Référence des API Amazon Simple Storage Service :

Cette section fournit des exemples de la manière d’obtenir les détails d’un emplacement enregistré ou de répertorier tous les emplacements enregistrés dans une instance S3 Access Grants à l’aide des kits AWS SDK.

Pour utiliser les exemples suivants, remplacez user input placeholders par vos propres informations.

Java
Exemple : Obtenir les détails d’un emplacement enregistré
public void getAccessGrantsLocation() {
GetAccessGrantsLocationRequest getAccessGrantsLocationRequest = GetAccessGrantsLocationRequest.builder()
.accountId("111122223333")
.accessGrantsLocationId("default")
.build();
GetAccessGrantsLocationResponse getAccessGrantsLocationResponse = s3Control.getAccessGrantsLocation(getAccessGrantsLocationRequest);
LOGGER.info("GetAccessGrantsLocationResponse: " + getAccessGrantsLocationResponse);
}

Réponse :

GetAccessGrantsLocationResponse(
CreatedAt=2023-06-07T04:35:10.027Z,
AccessGrantsLocationId=default,
AccessGrantsLocationArn=arn:aws:s3:us-east-2:111122223333:access-grants/default/location/default,
LocationScope= s3://,
IAMRoleArn=arn:aws:iam::111122223333:role/accessGrantsTestRole
)
Exemple : Répertorier tous les emplacements enregistrés dans une instance S3 Access Grants

Pour limiter les résultats à un préfixe ou à un compartiment S3, vous pouvez éventuellement transmettre un URI S3, tel que s3://bucket-and-or-prefix, dans le paramètre LocationScope. 

public void listAccessGrantsLocations() {

ListAccessGrantsLocationsRequest listRequest =   ListAccessGrantsLocationsRequest.builder()
.accountId("111122223333")
.build();

ListAccessGrantsLocationsResponse listResponse = s3Control.listAccessGrantsLocations(listRequest);
LOGGER.info("ListAccessGrantsLocationsResponse: " + listResponse);
}

Réponse :

ListAccessGrantsLocationsResponse(
AccessGrantsLocationsList=[
ListAccessGrantsLocationsEntry(
CreatedAt=2023-06-07T04:35:11.027Z,
AccessGrantsLocationId=default,
AccessGrantsLocationArn=arn:aws:s3:us-east-2:111122223333:access-grants/default/location/default,
LocationScope=s3://,
IAMRoleArn=arn:aws:iam::111122223333:role/accessGrantsTestRole
),
ListAccessGrantsLocationsEntry(
CreatedAt=2023-06-07T04:35:10.027Z,
AccessGrantsLocationId=635f1139-1af2-4e43-8131-a4de006eb456,
AccessGrantsLocationArn=arn:aws:s3:us-east-2:111122223333:access-grants/default/location/635f1139-1af2-4e43-8131-a4de006eb888,
LocationScope=s3://amzn-s3-demo-bucket/prefixA*,
IAMRoleArn=arn:aws:iam::111122223333:role/accessGrantsTestRole
)
]
)