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 présentés sur cette page, vous devez d’abord créer une fonction CloudFront à l’aide de l’environnement d’exécution JavaScript 2.0. Pour plus d’informations, consultez, Fonctionnalités d’exécution JavaScript 2.0 pour les fonctions CloudFront.

Groupes de connexions

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

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

Demande

const value = event.context.endpoint;

Réponse

La réponse est une string contenant le nom de domaine du groupe de connexion, par exemple : d111111abcdef8.cloudfront.net. Le champ endpoint n’apparaît que lorsque votre fonction est invoquée pour les distributions multi-locataires avec un groupe de connexions associé. Pour plus d’informations, consultez Objet Contexte.

Locataires de distribution

Les fonctions CloudFront proposent un module qui permet d’accéder à certaines valeurs propres au locataire de distribution.

Pour utiliser ce module, ajoutez l’instruction suivante à la première ligne de votre code de fonction :

import cf from 'cloudfront';

Vous pouvez utiliser les exemples suivants uniquement dans la fonction handler, soit directement, soit par le biais d’une fonction appelée de manière imbriquée.

distributionTenant.id field

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

Demande

const value = cf.distributionTenant.id;

Réponse

La réponse est une string contenant l’ID du locataire de distribution, par exemple : dt_1a2b3c4d5e6f7.

Gestion des erreurs

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

distributionTenant.parameters.get()Méthode

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

distributionTenant.parameters.get("key");

key : le nom du paramètre du locataire de distribution pour lequel vous souhaitez récupérer la valeur.

Requête

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

Réponse

La réponse est une string contenant la valeur du paramètre du locataire de distribution. Par exemple, si le nom de votre clé est TenantPath, la valeur de ce paramètre peut être tenant1.

Gestion des erreurs

Vous pourriez recevoir les erreurs suivantes :

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