# Métodos auxiliares para las propiedades de CloudFront SaaS Manager
<a name="saas-specific-logic-function-code"></a>

Utilice las siguientes funciones auxiliares de CloudFront SaaS Manager para recuperar los valores de las distribuciones de varios inquilinos en la función que cree. Para utilizar los ejemplos de esta página, primero debe crear una función de CloudFront utilizando el tiempo de ejecución 2.0 de JavaScript. Para obtener más información, [Características del tiempo de ejecución 2.0 de JavaScript para CloudFront Functions](functions-javascript-runtime-20.md).

**Topics**
+ [

## Grupos de conexiones
](#connection-groups-helper-function)
+ [

## Inquilinos de distribución
](#distribution-tenants-helper-functions)

## Grupos de conexiones
<a name="connection-groups-helper-function"></a>

El grupo de conexiones que está asociado a los inquilinos de distribución tiene un nombre de dominio.

Para obtener este valor, utilice el campo `endpoint` del subobjeto `context` del objeto de evento. 

**Solicitud**

```
const value = event.context.endpoint;
```

**Respuesta**

La respuesta es una `string` que contiene el nombre de dominio del grupo de conexiones, como d111111abcdef8.cloudfront.net. El campo `endpoint` solo aparece cuando se invoca la función para una distribución de varios inquilinos con un grupo de conexiones asociado. Para obtener más información, consulte [Objeto Context (Contexto)](functions-event-structure.md#functions-event-structure-context).

## Inquilinos de distribución
<a name="distribution-tenants-helper-functions"></a>

CloudFront Functions tiene un módulo que proporciona acceso a valores específicos de inquilinos de distribución.

Para usar este módulo, incluya la siguiente instrucción en la primera línea del código de la función:

```
import cf from 'cloudfront';
```

Puede usar los siguientes ejemplos solo en la función `handler`, ya sea directamente o mediante cualquier función de llamada anidada.

### `distributionTenant.id`Campo de
<a name="distribution-tenants-field"></a>

Utilice este campo para obtener el valor del ID del inquilino de distribución.

**Solicitud**

```
const value = cf.distributionTenant.id;
```

**Respuesta**

La respuesta es una `string` que contiene el ID del inquilino de distribución, por ejemplo, `dt_1a2b3c4d5e6f7`.

**Gestión de errores**

Si se invoca la función para una distribución estándar, al especificar el campo `distributionTenant.id` se devolverá el error de tipo `distributionTenant module is not available`. Para gestionar este caso de uso, puede agregar un bloque `try` y `catch` al código.

### `distributionTenant.parameters.get()`Método de
<a name="distribution-tenant-parameters-get-method"></a>

Utilice este método para devolver el valor de los nombres de parámetro de inquilino de distribución que especifique.

```
distributionTenant.parameters.get("key");
```

`key`: el nombre del parámetro del inquilino de distribución cuyo valor desea obtener.

**Solicitud **

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

**Respuesta**

La respuesta es una `string` que contiene el valor del parámetro del inquilino de distribución. Por ejemplo, si el nombre de la clave es `TenantPath`, entonces el valor de este parámetro podría ser `tenant1`.

**Gestión de errores**

Es posible que reciba los errores siguientes:
+ Si se invoca la función para una distribución estándar, el método `distributionTenant.parameters.get()` devolverá el error de tipo `distributionTenant module is not available`. 
+ El error `DistributionTenantParameterKeyNotFound` se devuelve cuando el parámetro de inquilino de distribución que especificó no existe. 

Para administrar estos casos de uso, puede agregar un bloque `try` y `catch` al código.