Trabalho com solicitações e respostas

Para usar as solicitações e as respostas do Lambda@Edge, consulte os seguintes tópicos:

Usar funções do Lambda@Edge com failover de origem

É possível usar as funções do Lambda@Edge com distribuições do CloudFront que você configurou com grupos de origens, por exemplo, para um failover de origem que você configura para ajudar a garantir a alta disponibilidade. Para usar uma função do Lambda com um grupo de origem, especifique a função em um trigger de resposta ou de solicitação de origem para um grupo de origens ao criar o comportamento de cache.

Para obter mais informações, consulte as informações a seguir.

Gerar respostas de HTTP em acionadores da solicitação

Quando o CloudFront recebe uma solicitação, você pode usar uma função do Lambda para gerar uma resposta HTTP que o CloudFront retornará diretamente ao visualizador sem encaminhar a resposta para a origem. Gerar respostas HTTP reduz a carga na origem e geralmente também reduz a latência para o visualizador.

Alguns cenários comuns para gerar respostas HTTP incluem o seguinte:

Uma função do Lambda@Edge pode gerar uma resposta HTTP quando ocorrerem os seguintes eventos do CloudFront:

Para ver códigos de exemplo para gerar respostas HTTP, consulte Funções de exemplo do Lambda@Edge. Você também pode substituir as respostas HTTP em triggers de resposta. Para ter mais informações, consulte Atualizar respostas de HTTP em acionadores de resposta da origem.

Modelo de programação

Esta seção descreve o modelo de programação para usar o Lambda@Edge para gerar respostas HTTP.

Objeto da resposta

A resposta que você retornar como o parâmetro result do método callback deverá ter a seguinte estrutura (observe que apenas o campo status é necessário).

const response = {
    body: 'content',
    bodyEncoding: 'text' | 'base64',
    headers: {
        'header name in lowercase': [{
            key: 'header name in standard case',
            value: 'header value'
         }],
         ...
    },
    status: 'HTTP status code (string)',
    statusDescription: 'status description'
};

O objeto de resposta pode incluir os seguintes valores:

Erros

Veja a seguir os erros possíveis das respostas HTTP geradas.

Campos obrigatórios

O campo status é obrigatório.

Todos os demais campos são opcionais.

Atualizar respostas de HTTP em acionadores de resposta da origem

Quando o CloudFront recebe uma resposta HTTP do servidor de origem, se houver um trigger de resposta de origem associado ao comportamento de cache, você poderá modificar a resposta HTTP para substituir o que foi retornado pela origem.

Alguns cenários comuns para atualizar respostas HTTP incluem o seguinte:

Você também pode substituir as respostas HTTP em eventos de solicitação do visualizador e da origem. Para ter mais informações, consulte Gerar respostas de HTTP em acionadores da solicitação.

Ao trabalhar com a resposta de HTTP, o Lambda@Edge não expõe o corpo retornado pelo servidor de origem ao acionador da resposta de origem. Você pode gerar um corpo de conteúdo estático definindo-o no valor desejado ou removendo o corpo de dentro da função ao definir o valor como vazio. Se você não atualizar o campo do corpo na função, o corpo original retornado pelo servidor de origem será reapresentado ao visualizador.

Acessar o corpo da solicitação escolhendo a opção de incluir o corpo

Você pode optar por fazer com que o Lambda@Edge exponha o corpo em uma solicitação para métodos HTTP graváveis (POST, PUT, DELETE e assim por diante), para que seja possível acessá-lo na função do Lambda. Você pode escolher acesso somente leitura ou especificar que substituirá o corpo.

Para ativar essa opção, escolha Include Body (Incluir corpo) ao criar um trigger do CloudFront para sua função que seja para um evento de solicitação de visualizador ou de origem. Para obter mais informações, consulte Adicionar acionadores para uma função do Lambda@Edge ou, para saber como usar a opção Include Body (Incluir corpo) com a função, consulte Estrutura de eventos do Lambda@Edge.

Os cenários em que você pode querer usar esse recurso incluem:

Para obter o código de exemplo, consulte Funções de exemplo do Lambda@Edge.