Hilfsmethoden für CloudFront SaaS Manager-Eigenschaften - Amazon CloudFront

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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 JavaScript Runtime 2.0-Funktionen für CloudFront Funktionen.

Verbindungsgruppen

Die Verbindungsgruppe, die Ihren Verteilungsmandanten zugeordnet ist, hat einen Domänennamen.

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

Anforderung

const value = event.context.endpoint;

Antwort

Die Antwort ist einestring, die den Domänennamen der Verbindungsgruppe enthält, z. B. d111111abcdef8.cloudfront.net. Das endpoint Feld wird nur angezeigt, wenn Ihre Funktion für eine Mehrmandantenverteilung mit einer zugehörigen Verbindungsgruppe aufgerufen wird. Weitere Informationen finden Sie unter Context-Objekt.

Mandanten für die Verteilung

CloudFront Functions verfügt über ein Modul, das den Zugriff auf bestimmte Werte für 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 beliebige Funktion mit verschachtelten Aufrufen.

distributionTenant.id field

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

Anforderung

const value = cf.distributionTenant.id;

Antwort

Die Antwort ist einestring, die die Verteilungsmandanten-ID enthält, z. dt_1a2b3c4d5e6f7 B.

Fehlerbehandlung

Wenn Ihre Funktion für eine Standardverteilung aufgerufen wird, wird bei Angabe des distributionTenant.id Felds der distributionTenant module is not available Typfehler zurückgegeben. Um diesen Anwendungsfall zu behandeln, können Sie Ihrem Code einen try catch UND-Block hinzufügen.

distributionTenant.parameters.get()-Methode

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

distributionTenant.parameters.get("key");

key: Der Name des Parameters des Verteilungsmandanten, für den Sie den Wert abrufen möchten.

Anfrage

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

Antwort

Die Antwort ist einestring, die den Wert für den Verteilungsmandantenparameter enthält. Wenn Ihr Schlüsselname beispielsweise lautetTenantPath, könnte der Wert für diesen Parameter lautentenant1.

Fehlerbehandlung

Möglicherweise erhalten Sie die folgenden Fehler:

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

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

Um diese Anwendungsfälle zu verwalten, können Sie Ihrem Code einen catch Block try und einen Block hinzufügen.