Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Méthodes d'assistance pour les propriétés de CloudFront SaaS Manager

Utilisez les fonctions d'assistance suivantes pour CloudFront SaaS Manager afin de récupérer les valeurs de vos distributions multi-locataires dans la fonction que vous créez. Pour utiliser les exemples de cette page, vous devez d'abord créer une CloudFront fonction à l'aide de JavaScript Runtime 2.0. Pour plus d’informations, consultez JavaScript fonctionnalités d'exécution 2.0 pour CloudFront Functions.

Groupes de connexions

Le groupe de connexion associé à vos locataires de distribution possède un nom de domaine.

Pour obtenir cette valeur, utilisez le endpoint champ du context sous-objet de l'objet d'événement.

Demande

const value = event.context.endpoint;

Réponse

La réponse est un string qui contient le nom de domaine du groupe de connexion, tel que d111111abcdef8.cloudfront.net. Le endpoint champ n'apparaît que lorsque votre fonction est appelée pour une distribution multi-locataires avec un groupe de connexion associé. Pour de plus amples informations, veuillez consulter Objet Contexte.

Locataires de distribution

CloudFront Functions possède un module qui permet d'accéder à des valeurs spécifiques des locataires de distribution.

Pour utiliser ce module, incluez l'instruction suivante dans la première ligne de votre code de fonction :

import cf from 'cloudfront';

Vous pouvez utiliser les exemples suivants uniquement dans la handler fonction, soit directement, soit par le biais d'une fonction d'appel imbriqué.

distributionTenant.id field

Utilisez ce champ pour obtenir la valeur de l'ID du locataire de distribution.

Demande

const value = cf.distributionTenant.id;

Réponse

La réponse est un string qui contient l'ID du locataire de distribution, tel quedt_1a2b3c4d5e6f7.

Gestion des erreurs

Si votre fonction est invoquée pour une distribution standard, la spécification du distributionTenant.id champ renverra l'erreur distributionTenant module is not available de type. Pour gérer ce cas d'utilisation, vous pouvez ajouter un catch bloc try et à votre code.

Méthode distributionTenant.parameters.get()

Utilisez cette méthode pour renvoyer la valeur des noms de paramètres du tenant de distribution que vous avez spécifiés.

distributionTenant.parameters.get("key");

key: nom du paramètre du tenant de distribution dont vous souhaitez récupérer la valeur.

Demande

const value = distributionTenant.parameters.get("key");

Réponse

La réponse est un string qui contient la valeur du paramètre du locataire de distribution. Par exemple, si le nom de votre clé estTenantPath, la valeur de ce paramètre peut êtretenant1.

Gestion des erreurs

Les messages d'erreur suivants peuvent s'afficher :

Pour gérer ces cas d'utilisation, vous pouvez ajouter un catch bloc try et à votre code.