Métodos auxiliares para las propiedades de CloudFront SaaS Manager - Amazon CloudFront

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 tipo distributionTenant 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.