Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Metodi di supporto per le proprietà di CloudFront SaaS Manager
<a name="saas-specific-logic-function-code"></a>

Utilizza le seguenti funzioni di supporto per CloudFront SaaS Manager per recuperare i valori per le distribuzioni multi-tenant nella funzione che crei. Per utilizzare gli esempi in questa pagina, è necessario innanzitutto creare una CloudFront funzione utilizzando runtime 2.0. JavaScript Per ulteriori informazioni, consulta, [JavaScript funzionalità di runtime 2.0 per CloudFront Functions](functions-javascript-runtime-20.md).

**Topics**
+ [Gruppi di connessioni](#connection-groups-helper-function)
+ [Tenant di distribuzione](#distribution-tenants-helper-functions)

## Gruppi di connessioni
<a name="connection-groups-helper-function"></a>

Il gruppo di connessioni associato ai tenant di distribuzione dispone di un nome di dominio.

Per ottenere questo valore, utilizza il campo `endpoint` dell’oggetto secondario `context` dell’oggetto evento. 

**Richiesta**

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

**Risposta**

La risposta è una `string` che contiene il nome di dominio del gruppo di connessioni, ad esempio d111111abcdef8.cloudfront.net. Il campo `endpoint` viene visualizzato solo quando la funzione viene invocata per una distribuzione multi-tenant con un gruppo di connessioni associato. Per ulteriori informazioni, consulta [Oggetto Context](functions-event-structure.md#functions-event-structure-context).

## Tenant di distribuzione
<a name="distribution-tenants-helper-functions"></a>

CloudFront Functions dispone di un modulo che fornisce l'accesso a valori specifici del tenant di distribuzione.

Per utilizzare questo modulo, includi la seguente istruzione nella prima riga del codice funzione:

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

Puoi utilizzare i seguenti esempi solo nella funzione `handler`, direttamente o tramite qualsiasi funzione di chiamata nidificata.

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

Utilizza questo campo per ottenere il valore dell’ID del tenant di distribuzione.

**Richiesta**

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

**Risposta**

La risposta è una `string` che contiene l’ID del tenant di distribuzione, ad esempio `dt_1a2b3c4d5e6f7`.

**Gestione errori**

Se la funzione viene invocata per una distribuzione standard, specificando il campo `distributionTenant.id` verrà restituito l’errore di tipo `distributionTenant module is not available`. Per gestire questo caso d’uso, puoi aggiungere un blocco `catch` e `try` al codice.

### Metodo `distributionTenant.parameters.get()`
<a name="distribution-tenant-parameters-get-method"></a>

Utilizza questo metodo per restituire il valore dei nomi dei parametri tenant di distribuzione specificati.

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

`key`: il nome del parametro tenant di distribuzione di cui desideri recuperare il valore.

**Richiesta**

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

**Risposta**

La risposta è una `string` che contiene il valore per il parametro tenant di distribuzione. Ad esempio, se il nome della chiave è `TenantPath`, il valore di questo parametro potrebbe essere `tenant1`.

**Gestione errori**

Potrebbero verificarsi i seguenti errori:
+ Se la funzione viene invocata per una distribuzione standard, il metodo `distributionTenant.parameters.get()` restituirà l’errore di tipo `distributionTenant module is not available`. 
+ L’errore `DistributionTenantParameterKeyNotFound` viene restituito quando il parametro tenant di distribuzione specificato non esiste. 

Per gestire questi casi d’uso, puoi aggiungere un blocco `try` e `catch` al codice.