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](functions-javascript-runtime-20.md).
**Topics**
+ [Groupes de connexions](#connection-groups-helper-function)
+ [Locataires de distribution](#distribution-tenants-helper-functions)
## 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 de plus amples informations, veuillez consulter [Objet Contexte](functions-event-structure.md#functions-event-structure-context).
## 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, 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.
### Méthode `distributionTenant.parameters.get()`
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.
**Demande**
```
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 :
+ Si votre fonction est invoquée pour une distribution standard, la méthode `distributionTenant.parameters.get()` renverra une erreur de type `distributionTenant module is not available`.
+ L’erreur `DistributionTenantParameterKeyNotFound` est renvoyée lorsque le paramètre de locataire de distribution que vous avez spécifié n’existe pas.
Pour gérer ces cas d’utilisation, vous pouvez ajouter un bloc `try` et `catch` à votre code.