Metodi di supporto per le proprietà di CloudFront SaaS Manager

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, Funzionalità di runtime JavaScript 2.0 per Funzioni CloudFront.

Gruppi di connessioni

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.

Tenant di distribuzione

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

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()

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.