Uso de puntos de acceso de Amazon S3 Object Lambda
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 Usar puntos de acceso. 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.
Para encontrar el ARN para su punto de acceso de Object Lambda mediante la consola
Inicie sesión AWS Management Console Management Console y abra la consola de Amazon S3 en https://console.aws.amazon.com/s3/
. -
En el panel de navegación del lado izquierdo de la consola, elija Object Lambda Access Points (Puntos de acceso de Object Lambda).
-
Seleccione el botón de opción situado junto al punto de acceso de Object Lambda cuyo ARN desea copiar.
-
Seleccionar Copy ARN (Copiar ARN).
Para encontrar el ARN para su punto de acceso de Object Lambda mediante la AWS CLI
-
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
con el ID de su Cuenta de AWS.111122223333
aws s3control list-access-points-for-object-lambda --account-id
111122223333
-
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 del punto de acceso con servicios de AWS.
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.
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
Para encontrar el alias para su punto de acceso de Object Lambda mediante la consola
Inicie sesión AWS Management Console Management Console y abra la consola de Amazon S3 en https://console.aws.amazon.com/s3/
. -
En el panel de navegación del lado izquierdo de la consola, elija Object Lambda Access Points (Puntos de acceso de Object Lambda).
-
Para el punto de acceso de Object Lambda que desea utilizar, copie el valor de Alias del punto de acceso del objeto Lambda.
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
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.user input
placeholders
aws s3control create-access-point-for-object-lambda --account-id
111122223333
--namemy-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 esPROVISIONING
, 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 esREADY
, 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 CreateAccessPointForObjectLambda y ObjectLambdaAccessPointAlias 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 del punto de acceso con servicios de AWS.
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
con su propia información.user input
placeholders
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 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.