Métodos auxiliares para las propiedades de CloudFront SaaS Manager
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.
Grupos de conexiones
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).
Inquilinos de distribución
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.
Campo distributionTenant.id
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
.
Error handling (Control 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.
Método de distributionTenant.parameters.get()
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
.
Error handling (Control 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 tipodistributionTenant 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.