# Uso de puntos de acceso de Amazon S3 Object Lambda
**nota**
A partir del 7 de noviembre de 2025, S3 Object Lambda solo estará disponible para los clientes actuales que utilizan el servicio actualmente, así como para socios seleccionados de la red de socios de AWS (APN). Para obtener más información sobre capacidades similares a las de S3 Object Lambda, haga clic aquí: [Cambio de disponibilidad de Amazon S3 Object Lambda](https://docs.aws.amazon.com/AmazonS3/latest/userguide/amazons3-ol-change.html).
La realización de solicitudes a través de puntos de acceso de Amazon S3 Object Lambda funciona de igual modo que las solicitudes a través de otros puntos de acceso. Para obtener más información acerca de cómo realizar solicitudes a través de un punto de acceso, consulte [Uso de los puntos de acceso de Amazon S3 para buckets de propósito general](using-access-points.md). Puede realizar solicitudes a través de los puntos de acceso de Object Lambda mediante la consola, la AWS Command Line Interface (AWS CLI), los SDK de AWS o la API de REST de Amazon S3.
**importante**
Los nombres de recurso de Amazon (ARN) para los puntos de acceso de Object Lambda utilizan un nombre de servicio `s3-object-lambda`. Por lo tanto, los ARN del punto de acceso de Object Lambda comienzan con `arn:aws::s3-object-lambda` en lugar de con `arn:aws::s3`, que se utiliza con otros puntos de acceso.
## Cómo encontrar el ARN para su punto de acceso de Object Lambda
Para utilizar un punto de acceso de Object Lambda con la AWS CLI o los SDK de AWS debe conocer el nombre de recurso de Amazon (ARN) del punto de acceso de Object Lambda. En los siguientes ejemplos, se muestra cómo encontrar el ARN para un punto de acceso de Object Lambda mediante la consola de Amazon S3 o la AWS CLI.
### Uso de la consola de S3
**Para encontrar el ARN para su punto de acceso de Object Lambda mediante la consola**
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 del lado izquierdo de la consola, elija **Object Lambda Access Points** (Puntos de acceso de Object Lambda).
1. Seleccione el botón de opción situado junto al punto de acceso de Object Lambda cuyo ARN desea copiar.
1. Seleccionar **Copy ARN** (Copiar ARN).
### Uso de AWS CLI
**Para encontrar el ARN para su punto de acceso de Object Lambda mediante la AWS CLI**
1. Para recuperar una lista de los puntos de acceso de Object Lambda asociados a su Cuenta de AWS, ejecute el siguiente comando. Antes de ejecutar el comando, reemplace el ID de cuenta *`111122223333`* con el ID de su Cuenta de AWS.
```
aws s3control list-access-points-for-object-lambda --account-id 111122223333
```
1. Revise el resultado del comando para encontrar el ARN del punto de acceso de Object Lambda que desea utilizar. El resultado del comando anterior tendrá un aspecto semejante al del siguiente ejemplo.
```
{
"ObjectLambdaAccessPointList": [
{
"Name": "my-object-lambda-ap",
"ObjectLambdaAccessPointArn": "arn:aws:s3-object-lambda:us-east-1:111122223333:accesspoint/my-object-lambda-ap"
},
...
]
}
```
## Cómo usar un alias de estilo de bucket para su punto de acceso de Object Lambda de bucket de S3
Al crear un punto de acceso de Object Lambda, Amazon S3 genera automáticamente un alias único para el punto de acceso de Object Lambda. Puede utilizar este alias en lugar de un nombre de bucket de Amazon S3 o el nombre de recurso de Amazon (ARN) del punto de acceso de Object Lambda en las operaciones de plano de datos de punto de acceso. Para obtener una lista de las operaciones, consulte [Compatibilidad con puntos de acceso](access-points-service-api-support.md).
Se crea un nombre de alias de punto de acceso de Object Lambda en el mismo espacio de nombres que un bucket de Amazon S3. Este nombre de alias se genera de forma automática y no se puede cambiar. Para un punto de acceso de Object Lambda existente, se asigna le automáticamente un alias. Un nombre de alias de punto de acceso de Object Lambda cumple con todos los requisitos de un nombre de bucket válido de Amazon S3 y consta de las siguientes partes:
`Object Lambda Access Point name prefix-metadata--ol-s3`
**nota**
El sufijo `--ol-s3` está reservado para los nombres de alias de punto de acceso de Object Lambda y no se puede utilizar para los nombres de punto de acceso de Object Lambda o de bucket. Para obtener más información acerca de las reglas de nomenclatura del bucket de Amazon S3, consulte [Reglas de nomenclatura de buckets de uso general](bucketnamingrules.md).
Los siguientes ejemplos muestran un ARN y un alias de punto de acceso de Object Lambda para un punto de acceso de Object Lambda llamado `my-object-lambda-access-point`:
+ **ARN** – `arn:aws:s3-object-lambda:region:account-id:accesspoint/my-object-lambda-access-point`
+ **Alias de punto de acceso de Object Lambda** – `my-object-lambda-acc-1a4n8yjrb3kda96f67zwrwiiuse1a--ol-s3`
Al utilizar un punto de acceso de Object Lambda, puede utilizar el nombre del alias del punto de acceso de Object Lambda sin que tenga que realizar cambios importantes en el código.
Al eliminar un punto de acceso de Object Lambda, el nombre del alias del punto de acceso de Object Lambda queda inactivo y desaprovisionado.
### Cómo encontrar el alias para su punto de acceso de Object Lambda
#### Uso de la consola de S3
**Para encontrar el alias para su punto de acceso de Object Lambda mediante la consola**
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 del lado izquierdo de la consola, elija **Object Lambda Access Points** (Puntos de acceso de Object Lambda).
1. Para el punto de acceso de Object Lambda que desea utilizar, copie el valor de **Alias del punto de acceso del objeto Lambda**.
#### Uso de AWS CLI
Al crear un punto de acceso de Object Lambda, Amazon S3 genera de forma automática un nombre de alias de punto de acceso de Object Lambda, tal como se muestra en el siguiente ejemplo. Para ejecutar este comando, sustituya los `user input placeholders` con su propia información. Para obtener información acerca de cómo crear un punto de acceso de Object Lambda mediante la AWS CLI, consulte [Para crear un punto de acceso de Object Lambda mediante la AWS CLI](olap-create.md#olap-create-cli-specific).
```
aws s3control create-access-point-for-object-lambda --account-id 111122223333 --name my-object-lambda-access-point --configuration file://my-olap-configuration.json
{
"ObjectLambdaAccessPointArn": "arn:aws:s3:region:111122223333:accesspoint/my-access-point",
"Alias": {
"Value": "my-object-lambda-acc-1a4n8yjrb3kda96f67zwrwiiuse1a--ol-s3",
"Status": "READY"
}
}
```
El nombre del alias del punto de acceso de Object Lambda generado tiene dos campos:
+ El campo `Value` es el valor del alias del punto de acceso de Object Lambda.
+ El campo `Status` es el estado del alias del punto de acceso de Object Lambda. Si el estado es `PROVISIONING`, Amazon S3 está aprovisionando el alias del punto de acceso de Object Lambda y el alias aún no se puede usar. Si el estado es `READY`, el alias del punto de acceso de Object Lambda se habrá aprovisionado correctamente y ya se podrá usar.
Para obtener más información sobre el tipo de dato `ObjectLambdaAccessPointAlias` en la API de REST, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateAccessPointForObjectLambda.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateAccessPointForObjectLambda.html) y [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ObjectLambdaAccessPointAlias.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ObjectLambdaAccessPointAlias.html) en la *Referencia de la API de Amazon Simple Storage Service*.
### Cómo usar el alias del punto de acceso de Object Lambda
Puede utilizar un alias de punto de acceso de Object Lambda en lugar de un nombre de bucket de Amazon S3 para las operaciones que se enumeran en [Compatibilidad con puntos de acceso](access-points-service-api-support.md).
En el siguiente ejemplo de la AWS CLI para el comando `get-bucket-location` se usa el alias del punto de acceso del bucket para devolver la Región de AWS en la que está el bucket. Para ejecutar este comando, sustituya los `user input placeholders` con su propia información.
```
aws s3api get-bucket-location --bucket my-object-lambda-acc-w7i37nq6xuzgax3jw3oqtifiusw2a--ol-s3
{
"LocationConstraint": "us-west-2"
}
```
Si el alias del punto de acceso de Object Lambda de una solicitud no es válido, se devuelve el código de error `InvalidAccessPointAliasError`. Para obtener más información sobre `InvalidAccessPointAliasError`, consulte [Lista de códigos de error](https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList) en la *Referencia de la API de Amazon Simple Storage Service*.
Las limitaciones de un alias de punto de acceso de Object Lambda son las mismas que las de un alias de punto de acceso. Para obtener más información acerca de las limitaciones de un alias de punto de acceso, consulte [Limitaciones de alias de punto de acceso](access-points-naming.md#use-ap-alias-limitations).