Para usar uma função com uma distribuição, associe a função a um ou mais comportamentos de cache na distribuição. Você pode associar uma função a vários comportamentos de cache em várias distribuições.
É possível associar uma função a qualquer um dos seguintes itens:
-
Um comportamento de cache existente.
-
Um novo comportamento de cache em uma distribuição existente.
-
Um novo comportamento de cache em uma nova distribuição.
Quando você associa uma função a um comportamento de cache, você deve selecionar um tipo de evento. O tipo de evento determina quando o CloudFront executa a função.
É possível escolher entre os seguintes tipos de evento:
-
Solicitação do visualizador: a função é executada quando o CloudFront recebe uma solicitação de um visualizador.
-
Resposta do visualizador: a função é executada antes que o CloudFront retorne uma resposta ao visualizador.
Não é possível usar tipos de evento voltados para a origem (solicitação de origem e resposta de origem) com o CloudFront Functions. Em vez disso, você pode usar o Lambda@Edge. Para ter mais informações, consulte Eventos do CloudFront que podem acionar uma função do Lambda@Edge.
nota
Antes de associar uma função, você deve publicá-la na fase LIVE.
É possível associar uma função a uma distribuição no console do CloudFront ou à AWS Command Line Interface (AWS CLI). O procedimento a seguir mostra como associar uma função a um comportamento de cache existente.
Como associar uma função a um comportamento de cache existente
-
Faça login no console do CloudFront em https://console.aws.amazon.com/cloudfront/v4/home#/functions
e selecione a página Funções. -
Escolha a função que você deseja associar.
-
Na página Função, selecione a guia Publicar.
-
Selecione a função Publish (Publicar).
-
Escolha Add association. Na caixa de diálogo exibida, selecione uma distribuição, um tipo de evento e/ou um comportamento de cache.
Para o tipo de evento, selecione quando deseja que essa função seja executada:
-
Solicitação do visualizador: execute a função sempre que o CloudFront receber uma solicitação.
-
Resposta do visualizador: execute a função sempre que o CloudFront exibir uma resposta.
-
-
Para salvar a configuração, selecione Adicionar associação.
O CloudFront associa a distribuição à função. Aguarde alguns minutos para que a distribuição associada termine a implantação. É selecionar Visualizar distribuição na página de detalhes da função para conferir o andamento.
O Status da distribuição muda para InProgress enquanto a distribuição é reimplantada. Quando a nova configuração de distribuição atingir um local da borda do CloudFront, esse local começará a usar a função associada. Quando a distribuição estiver totalmente implantada, o Status mudará de volta para Deployed. Isso indica que a função do CloudFront associada está ativa em todos os locais da borda do CloudFront no mundo todo. Normalmente, isso demora alguns minutos.
