Hilfsmethoden für CloudFront SaaS Manager-Eigenschaften

Verwenden Sie die folgenden Hilfsfunktionen für CloudFront SaaS Manager, um Werte für Ihre Multi-Tenant-Verteilungen in der von Ihnen erstellten Funktion abzurufen. Um die Beispiele auf dieser Seite verwenden zu können, müssen Sie zuerst eine CloudFront Funktion mithilfe von JavaScript Runtime 2.0 erstellen. Weitere Informationen finden Sie unter Features von JavaScript Runtime 2.0 für CloudFront-Funktionen.

Verbindungsgruppen

Die Verbindungsgruppe, die Ihren Distributionsmandanten zugeordnet ist, hat einen Domainnamen.

Verwenden Sie das Feld endpoint des Unterobjekts context des Ereignisobjekts, um diesen Wert abzurufen.

Anforderung

const value = event.context.endpoint;

Antwort

Die Antwort ist ein string, der den Domainnamen der Verbindungsgruppe wie z. B. d111111abcdef8.cloudfront.net enthält. Das Feld endpoint wird nur angezeigt, wenn Ihre Funktion für eine Multi-Tenant-Distribution mit einer zugeordneten Verbindungsgruppe aufgerufen wird. Weitere Informationen finden Sie unter Context-Objekt.

Distributionsmandanten

CloudFront Functions verfügt über ein Modul, das den Zugriff auf bestimmte Werte für den Distributionsmandanten ermöglicht.

Um dieses Modul zu verwenden, fügen Sie die folgende Anweisung in die erste Zeile Ihres Funktionscodes ein:

import cf from 'cloudfront';

Sie können die folgenden Beispiele nur in der handler-Funktion verwenden, entweder direkt oder über eine Funktion mit verschachtelten Aufrufen.

distributionTenant.id field

Verwenden Sie dieses Feld, um den Wert der Distributionsmandanten-ID abzurufen.

Anforderung

const value = cf.distributionTenant.id;

Antwort

Die Antwort ist ein string, der die Distributionsmandanten-ID wie z. B. dt_1a2b3c4d5e6f7 enthält.

Fehlerbehandlung

Wenn Ihre Funktion für eine Standarddistribution aufgerufen wird, wird bei einer Angabe im Feld distributionTenant.id der Typfehler distributionTenant module is not available zurückgegeben. Um dieses Problem zu beheben, können Sie Ihrem Code einen try- und catch-Block hinzufügen.

distributionTenant.parameters.get()-Methode

Verwenden Sie diese Methode, um den Wert für die von Ihnen angegebenen Parameternamen für den Distributionsmandanten zurückzugeben.

distributionTenant.parameters.get("key");

key: der Name des Parameters des Distributionsmandanten, für den Sie den Wert abrufen möchten

Anfrage

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

Antwort

Die Antwort ist ein string, der den Wert für den Parameter des Distributionsmandanten enthält. Wenn Ihr Schlüsselname beispielsweise TenantPath lautet, könnte der Wert für diesen Parameter tenant1 lauten.

Fehlerbehandlung

Sie können die folgenden Fehler erhalten:

• Wenn Ihre Funktion für eine Standarddistribution aufgerufen wird, gibt die Methode distributionTenant.parameters.get() den Typfehler distributionTenant module is not available zurück.

• Der Fehler DistributionTenantParameterKeyNotFound wird zurückgegeben, wenn der von Ihnen angegebene Parameter für den Distributionsmandanten nicht existiert.

Um diese Probleme zu beheben, können Sie Ihrem Code einen try- und catch-Block hinzufügen.