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 d’autorisations 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 enregistré que vous souhaitez afficher. Pour filtrer la liste des emplacements enregistrés, utilisez la zone de recherche.

Utilisation de la console S3

Pour afficher les emplacements enregistrés dans votre instance d’autorisations 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 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 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.

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 d’autorisations d’accès S3

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"
     }
   ]
  }

À l'aide du 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 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 d’autorisations d’accès S3

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 d’autorisations d’accès S3, consultez les sections suivantes de la Référence d’API Amazon Simple Storage Service :

• GetAccessGrantsLocation

• ListAccessGrantsLocations

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 d’autorisations d’accès S3, consultez les sections suivantes de la Référence d’API Amazon Simple Storage Service :

• GetAccessGrantsLocation

• ListAccessGrantsLocations

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

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 d’autorisations d’accès S3

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
)
]
)

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

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 d’autorisations d’accès S3

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
)
]
)