Utilisation des points d’accès 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. Vous pouvez effectuer des demandes via les points d'accès Object Lambda à l'aide de la console Amazon S3, AWS Command Line Interface (AWS CLI) ou de l' AWS SDKsAPI REST Amazon S3.

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

Pour utiliser un point d'accès Object Lambda avec le AWS CLI ou AWS SDKs, vous devez connaître le nom de ressource Amazon (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.

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é avec les 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

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 :

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

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

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

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é avec les points d'accès.

L' AWS CLI exemple de get-bucket-location commande suivant utilise l'alias du point d'accès du compartiment pour renvoyer le nom dans Région AWS lequel se trouve le compartiment. Pour exécuter cette commande, remplacez 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 d’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 relatives aux alias des points d'accès.