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.
# Affichage des détails d’un emplacement enregistré
Vous pouvez obtenir les détails d'un emplacement enregistré dans votre instance S3 Access Grants en utilisant la console Amazon S3, le AWS Command Line Interface (AWS CLI), l'API REST Amazon S3 et le AWS SDKs.
## Utilisation de la console S3
**Pour afficher les emplacements enregistrés dans 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 enregistré que vous souhaitez afficher. Pour filtrer la liste des emplacements enregistrés, utilisez la zone de recherche.
## À 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 : 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"
}
```
**Example : 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"
}
]
}
```
## Utilisation de l'API REST
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* :
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessGrantsLocation.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_GetAccessGrantsLocation.html)
+ [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListAccessGrantsLocations.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListAccessGrantsLocations.html)
## En utilisant le AWS SDKs
Cette section fournit des exemples de la façon 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 du AWS SDKs.
Pour utiliser les exemples suivants, remplacez `user input placeholders` par vos propres informations.
------
#### [ Java ]
**Example : 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
)
```
**Example : 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
)
]
)
```
------