Ver los detalles de una ubicación registrada - Amazon Simple Storage Service

Ver los detalles de una ubicación registrada

Puede obtener los detalles de una ubicación en su instancia de S3 Access Grants mediante la consola de Amazon S3, la AWS Command Line Interface (AWS CLI), la API de REST de Amazon S3 y los SDK de AWS.

Para ver las ubicaciones registradas en su instancia de S3 Access Grants

  1. Inicie sesión AWS Management Console Management Console y abra la consola de Amazon S3 en https://console.aws.amazon.com/s3/.

  2. En el panel de navegación izquierdo, seleccione Concesiones de acceso.

  3. En la página S3 Access Grants, seleccione la región que contiene la instancia de S3 Access Grants con la que quiere trabajar.

  4. Seleccione Ver detalles de la instancia.

  5. En la página de detalles de la instancia, elija Ubicaciones.

  6. Busque la ubicación registrada que desea ver. Utilice el cuadro de búsqueda para filtrar la lista de ubicaciones registradas.

Para instalar AWS CLI, consulte Instalación de AWS CLI en la Guía del usuario de AWS Command Line Interface.

Para utilizar el comando de ejemplo siguiente, sustituya user input placeholders con su información.

ejemplo – Obtener los detalles de una ubicación registrada
aws s3control get-access-grants-location \
--account-id 111122223333 \
--access-grants-location-id default

Respuesta:

{
    "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"
}
ejemplo – Enumerar todas las ubicaciones que están registradas en una instancia de S3 Access Grants

Para restringir los resultados a un prefijo o bucket de S3, puede utilizar el parámetro --location-scope s3://bucket-and-or-prefix si lo desea. 

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

Respuesta:

{"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://DOC-EXAMPLE-BUCKET/prefixA*",
    "IAMRoleArn": "arn:aws:iam::111122223333:role/accessGrantsTestRole"
     }
   ]
  }

Para obtener información sobre la compatibilidad de la API de REST de Amazon S3 a fin de obtener los detalles de una ubicación registrada o enumerar todas las ubicaciones que están registradas en una instancia de S3 Access Grants, consulte las siguientes secciones de la Referencia de la API de Amazon Simple Storage Service:

En esta sección se proporcionan ejemplos de cómo obtener los detalles de una ubicación registrada o enumerar todas las ubicaciones registradas en una instancia de S3 Access Grants mediante los SDK de AWS.

Para utilizar los siguientes ejemplos, reemplace los user input placeholders con su propia información.

Java
ejemplo – Obtener los detalles de una ubicación registrada
public void getAccessGrantsLocation() {
GetAccessGrantsLocationRequest getAccessGrantsLocationRequest = GetAccessGrantsLocationRequest.builder()
.accountId("111122223333")
.accessGrantsLocationId("default")
.build();
GetAccessGrantsLocationResponse getAccessGrantsLocationResponse = s3Control.getAccessGrantsLocation(getAccessGrantsLocationRequest);
LOGGER.info("GetAccessGrantsLocationResponse: " + getAccessGrantsLocationResponse);
}

Respuesta:

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
)
ejemplo – Enumerar todas las ubicaciones registradas en una instancia de S3 Access Grants

Para restringir los resultados a un prefijo o bucket de S3, si lo desea, puede pasar un URI de S3, por ejemplo s3://bucket-and-or-prefix, en el parámetro LocationScope. 

public void listAccessGrantsLocations() {

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

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

Respuesta:

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://DOC-EXAMPLE-BUCKET/prefixA*,
IAMRoleArn=arn:aws:iam::111122223333:role/accessGrantsTestRole
)
]
)