# Actualizar una ubicación registrada
<a name="access-grants-location-edit"></a>

Puede actualizar el rol de AWS Identity and Access Management (IAM) de una ubicación que está registrada en su instancia de Amazon S3 Access Grants. Para cada nuevo rol de IAM que utilice para registrar una ubicación en S3 Access Grants, asegúrese de conceder acceso a la entidad de servicio de S3 Access Grants (`access-grants.s3.amazonaws.com`) a este rol. Para ello, añada una entrada para el nuevo rol de IAM en el mismo archivo JSON de política de confianza que utilizó al [registrar la ubicación](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-grants-location.html) por primera vez. 

Puede actualizar 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.

## Uso de la consola de S3
<a name="access-grants-location-edit-console"></a>

**Para actualizar el rol de IAM de una ubicación registrada en su instancia de S3 Access Grants**

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

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

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

1. Seleccione **Ver detalles** de la instancia.

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

1. Encuentre la ubicación que desea actualizar. Para filtrar la lista de ubicaciones, utilice el cuadro de búsqueda.

1. Elija el botón de opciones situado al lado de la ubicación registrada que desea actualizar.

1. Actualice el rol de IAM y, a continuación, seleccione **Guardar cambios**.

## Uso de AWS CLI
<a name="access-grants-location-edit-cli"></a>

Para instalar AWS CLI, consulte [Instalación de AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) 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.

**Example – Actualizar el rol de IAM de una ubicación registrada**  

```
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
```
Respuesta:  

```
{
    "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://amzn-s3-demo-bucket/prefixB*",
    "IAMRoleArn": "arn:aws:iam::777788889999:role/accessGrantsTestRole"
}
```

## Uso de la API de REST
<a name="access-grants-location-edit-rest-api"></a>

Para obtener información sobre la compatibilidad con la API de REST de Amazon S3 para actualizar una ubicación en una instancia de S3 Access Grants, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UpdateAccessGrantsLocation.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UpdateAccessGrantsLocation.html) en la *Referencia de la API de Amazon Simple Storage Service*.

## Uso de los AWS SDK
<a name="access-grants-location-edit-using-sdk"></a>

En esta sección se proporcionan ejemplos de cómo actualizar el rol de IAM de una ubicación registrada con los SDK de AWS.

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

------
#### [ Java ]

**Example – Actualizar el rol de IAM de una ubicación registrada**  

```
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);
}
```
Respuesta:  

```
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://amzn-s3-demo-bucket/prefixB*,
IAMRoleArn=arn:aws:iam::777788889999:role/accessGrantsTestRole
)
```

------