métodos auxiliares gerais

Esta página apresenta outros métodos auxiliares dentro do CloudFront Functions. Para usar esses métodos, crie uma função do CloudFront usando o Runtime 2.0 do JavaScript.

import cf from 'cloudfront';

Para obter mais informações, consulte Recursos de runtime 2.0 do JavaScript para CloudFront Functions.

edgeLocationMetadados do

Esse método requer o uso do módulo cloudfront.

Use esse objeto JavaScript para obter o código do aeroporto do local da borda, a região do cache de borda regional que deve ser usada ou o endereço IP do servidor do CloudFront usado para processar a solicitação. Esses metadados estão disponíveis somente no acionador de eventos de solicitação de visualizador.

cf.edgeLocation = {
    name: SEA
    serverIp: 1.2.3.4
    region: us-west-2
}

O objeto cf.edgeLocation contém os seguintes campos:

Método rawQueryString()

Esse método não requer o módulo cloudFront.

Use o método rawQueryString() para recuperar a string de consulta não analisada e não alterada como uma string.

Solicitação

function handler(event) {
    var request = event.request;
    const qs = request.rawQueryString();
}

Resposta

Exibe a string de consulta completa da solicitação de entrada como um valor de string sem o ? inicial.

logCustomData()Método

Para usar esse método, importe o módulo cloudfront.

Use o método logCustomData() para enviar dados personalizados da função do Amazon CloudFront aos logs de acesso do CloudFront. Os dados são gravados no campo de log viewer-request-log-data ou viewer-response-log-data, dependendo de a função estar associada a um evento de solicitação ou de resposta do visualizador.

O método aceita um único argumento de string. Para registrar um objeto em log, use JSON.stringify() para convertê-lo primeiro em uma string. Por exemplo:

const resp_obj = JSON.stringify(some_obj);
cf.logCustomData(resp_obj);

Cada campo é compatível com até 800 bytes de dados. O CloudFront codifica automaticamente os dados para URL antes de gravá-los no campo de log. O CloudFront trunca todos os dados que excederem 800 bytes após a codificação para URL. Se a função chamar logCustomData() várias vezes durante uma única execução, o CloudFront usará somente o último valor.

O método usa a seguinte sintaxe:

cf.logCustomData(String);

import cf from 'cloudfront';

function handler(event) {
    var request = event.request;

    // Check if the debug header exists, if so log it
    if (request.headers['x-debug-header']) {
        // Log the debug header value
        cf.logCustomData("debug header found: " + request.headers['x-debug-header'].value);
    }

    return request;
}