Utilisation des points d’accès Amazon S3 Object Lambda - Amazon Simple Storage Service
Comment trouver l’ARN de votre point d’accès Object LambdaComment utiliser un alias de type compartiment pour votre point d’accès Object Lambda

Utilisation des points d’accès Amazon S3 Object Lambda

Note

À compter du 7 novembre 2025, S3 Object Lambda sera réservé aux clients existants qui utilisent actuellement le service, ainsi qu’à certains partenaires AWS Partner Network (APN). Si vous souhaitez utiliser le service, veuillez vous y inscrire avant le 7 novembre 2025. Pour des fonctionnalités semblables à celles de S3 Object Lambda, cliquez ici : Modification de la disponibilité d’Amazon S3 Object Lambda.

Les demandes via des points d’accès Amazon S3 Object Lambda fonctionnent de la même manière que les demandes via d’autres points d’accès. Pour plus d’informations sur les demandes via un point d’accès, consultez Utilisation des points d’accès Amazon S3 de compartiments à usage général. Vous pouvez effectuer des demandes via les points d’accès Object Lambda à l’aide de la console Amazon S3, de l’AWS Command Line Interface (AWS CLI), des kits AWS SDK ou de l’API REST Amazon S3.

Important

Les Amazon Resource Names (ARN) des points d’accès Object Lambda utilisent le nom de service s3-object-lambda. Les ARN des points d’accès Object Lambda commencent donc par arn:aws::s3-object-lambda, et non par arn:aws::s3, qui est utilisé pour d’autres points d’accès.

Comment trouver l’ARN de votre point d’accès Object Lambda

Pour utiliser un point d’accès Object Lambda avec l’AWS CLI ou les kits AWS SDK, vous devez connaître l’Amazon Resource Name (ARN) du point d’accès Object Lambda. Les exemples suivants montrent comment trouver l’ARN d’un point d’accès Object Lambda à l’aide de la console Amazon S3 ou de l’AWS CLI.

Pour trouver l’ARN de votre point d’accès Object Lambda avec la console

  1. Connectez-vous à la AWS Management Console et ouvrez la console Amazon S3 à l’adresse https://console.aws.amazon.com/s3/.

  2. Dans le volet de navigation de gauche, choisissez Points d’accès Object Lambda.

  3. Sélectionnez le bouton d’option en regard du point d’accès Object Lambda dont vous souhaitez copier l’ARN.

  4. Choisissez Copier l’ARN.

Pour trouver l’ARN de votre point d’accès Object Lambda avec l’AWS CLI

  1. Pour récupérer la liste des points d’accès Object Lambda associés à votre Compte AWS, exécutez la commande suivante. Avant d’exécuter la commande, remplacez l’ID de compte 111122223333 par l’ID de votre Compte AWS.

    aws s3control list-access-points-for-object-lambda --account-id 111122223333

  2. Lisez la sortie de la commande pour trouver l’ARN du point d’accès Object Lambda que vous souhaitez utiliser. La sortie de la commande précédente doit ressembler à celle de l’exemple suivant.

    {
    "ObjectLambdaAccessPointList": [
        {
            "Name": "my-object-lambda-ap",
            "ObjectLambdaAccessPointArn": "arn:aws:s3-object-lambda:us-east-1:111122223333:accesspoint/my-object-lambda-ap"
        },
        ...
    ]
}

Comment utiliser un alias de type compartiment pour votre point d’accès Object Lambda de compartiment S3

Quand vous créez un point d’accès Object Lambda, Amazon S3 génère automatiquement un alias unique pour votre point d’accès Object Lambda. Vous pouvez utiliser cet alias à la place d’un nom de compartiment Amazon S3 ou de l’Amazon Resource Name (ARN) du point d’accès Object Lambda dans une demande pour les opérations de plan de données de point d’accès. Pour obtenir la liste de ces opérations, consultez la page Compatibilité des points d’accès.

Un nom d’alias de point d’accès Object Lambda est créé dans le même espace de noms qu’un compartiment Amazon S3. Ce nom d’alias est généré automatiquement et ne peut pas être modifié. Pour un point d’accès Object Lambda existant, un alias est automatiquement attribué. Un nom d’alias de point d’accès Object Lambda répond à toutes les exigences d’un nom de compartiment Amazon S3 valide et comprend les parties suivantes :

Object Lambda Access Point name prefix-metadata--ol-s3

Note

Le suffixe --ol-s3 est réservé aux noms d’alias de point d’accès Object Lambda et ne peut pas être utilisé pour les noms de compartiment ou de point d’accès Object Lambda. Pour plus d’informations sur les règles d’attribution de noms des compartiments Amazon S3, consultez Règles de dénomination des compartiments à usage général.

Voici des exemples d’ARN et d’alias de point d’accès Object Lambda pour un point d’accès Object Lambda nommé my-object-lambda-access-point :

  • ARN – arn:aws:s3-object-lambda:region:account-id:accesspoint/my-object-lambda-access-point

  • Alias de point d’accès Object Lambda – my-object-lambda-acc-1a4n8yjrb3kda96f67zwrwiiuse1a--ol-s3

Lorsque vous utilisez un point d’accès Object Lambda, vous pouvez utiliser le nom d’alias du point d’accès Object Lambda sans d’importantes modifications de code.

Lorsque vous supprimez un point d’accès Object Lambda, le nom d’alias du point d’accès Object Lambda devient inactif et n’est plus provisionné.

Comment trouver l’alias de votre point d’accès Object Lambda

Pour trouver l’alias de votre point d’accès Object Lambda avec la console

  1. Connectez-vous à la AWS Management Console et ouvrez la console Amazon S3 à l’adresse https://console.aws.amazon.com/s3/.

  2. Dans le volet de navigation de gauche, choisissez Points d’accès Object Lambda.

  3. Pour le point d’accès Object Lambda que vous souhaitez utiliser, copiez la valeur de l’alias du point d’accès Object Lambda.

Lorsque vous créez un point d’accès Object Lambda, Amazon S3 génère automatiquement un nom d’alias de point d’accès Object Lambda, comme illustré dans l’exemple de commande suivant. Pour exécuter cette commande, remplacez les user input placeholders par vos propres informations. Pour plus d’informations sur la création d’un point d’accès Object Lambda avec l’AWS CLI, consultez Pour créer un point d’accès Object Lambda à l’aide de l’AWS CLI.

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

Le nom d’alias du point d’accès Object Lambda généré comporte deux champs :

  • Le champ Value est la valeur d’alias du point d’accès Object Lambda.

  • Le champ Status est le statut de l’alias du point d’accès Object Lambda. Si le statut est PROVISIONING, Amazon S3 fournit l’alias du point d’accès Object Lambda, qui n’est pas encore prêt à être utilisé. Si le statut est READY, l’alias du point d’accès Object Lambda a été correctement provisionné et est prêt à être utilisé.

Pour plus d’informations sur le type de données ObjectLambdaAccessPointAlias dans l’API REST, consultez CreateAccessPointForObjectLambda et ObjectLambdaAccessPointAlias dans la Référence des API Amazon Simple Storage Service.

Comment utiliser l’alias du point d’accès Object Lambda

Vous pouvez utiliser un alias de point d’accès Object Lambda plutôt qu’un nom de compartiment Amazon S3 pour les opérations répertoriées dans Compatibilité des points d’accès.

L’exemple suivant de l’AWS CLI pour la commande get-bucket-location utilise l’alias de point d’accès du compartiment pour renvoyer la Région AWS dans laquelle se trouve le compartiment. Pour exécuter cette commande, remplacez les user input placeholders par vos propres informations.

aws s3api get-bucket-location --bucket my-object-lambda-acc-w7i37nq6xuzgax3jw3oqtifiusw2a--ol-s3
            
{
    "LocationConstraint": "us-west-2"
}

Si l’alias du point d’accès Object Lambda indiqué dans une demande n’est pas valide, le code d’erreur InvalidAccessPointAliasError est renvoyé. Pour plus d’informations sur InvalidAccessPointAliasError, consultez List of Error Codes dans la Référence des API Amazon Simple Storage Service.

Les limites d’un alias de point d’accès Object Lambda sont les mêmes que celles d’un alias de point d’accès. Pour plus d’informations sur les limites d’un alias de point d’accès, consultez Limitations des alias de point d’accès.