Creazione di funzioni

La creazione di una funzione avviene in due fasi:

1. Crea il codice della funzione come JavaScript. Puoi utilizzare l’esempio predefinito della console CloudFront o scriverne uno personalizzato. Per ulteriori informazioni, consulta i seguenti argomenti:

   • Scrittura del codice della funzione

   • CloudFront Funzioni, struttura degli eventi

   • CloudFront Esempi di funzioni per CloudFront

2. Utilizza CloudFront per creare la funzione e includere il codice. Il codice è presente all'interno della funzione (non come riferimento).

Console

Per creare una funzione

1. Accedi alla console CloudFront all’indirizzo https://console.aws.amazon.com/cloudfront/v4/home#/functions e scegli la pagina Funzioni.

2. Scegli Crea funzione.

3. Immetti un nome di funzione univoco all’interno dell’Account AWS, scegli la versione di JavaScript e infine seleziona Continua. Viene visualizzata la pagina dei dettagli relativa alla nuova funzione.

   Nota

   Per utilizzare coppie chiave-valore nella funzione, è necessario scegliere JavaScript runtime 2.0.

4. Nella sezione Codice funzione, scegli la scheda Compila e immetti il codice funzione. Il codice di esempio incluso nella scheda Compila illustra la sintassi di base del codice funzione.

5. Scegli Save changes (Salva modifiche).

6. Se il codice funzione utilizza coppie chiave-valore, è necessario associare un archivio di valori delle chiavi.

   Puoi associare l’archivio di valori delle chiavi al momento della creazione della funzione. In alternativa, puoi associarlo in un secondo momento aggiornando la funzione.

   Per associare subito un archivio di valori delle chiavi, procedi come segue:

   • Nella sezione Associa KeyValueStore, scegli Associa KeyValueStore esistente.

   • Seleziona l’archivio di valori delle chiavi contenente le coppie chiave-valore nella funzione, quindi scegli Associata KeyValueStore.

   CloudFront associa immediatamente l'archivio alla funzione. Non è necessario salvare la funzione.

CLI

Con la CLI, in genere si crea prima il codice funzione in un file e poi si crea la funzione con AWS CLI.

Per creare una funzione

1. Crea il codice funzione in un file e memorizzalo in una directory a cui il computer può connettersi.

2. Esegui il comando come mostrato nell'esempio. Questo esempio utilizza la notazione fileb:// per passare il file. Include anche interruzioni di riga per rendere il comando più leggibile.

   aws cloudfront create-function \
       --name MaxAge \
       --function-config '{"Comment":"Max Age 2 years","Runtime":"cloudfront-js-2.0","KeyValueStoreAssociations":{"Quantity":1,"Items":[{"KeyValueStoreARN":"arn:aws:cloudfront::111122223333:key-value-store/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"}]}}' \
       --function-code fileb://function-max-age-v1.js
   

   Note

   • Runtime: la versione di JavaScript. Per utilizzare coppie chiave-valore nella funzione, è necessario specificare la versione 2.0.

   • KeyValueStoreAssociations: se la funzione utilizza coppie chiave-valore, puoi associare l’archivio dei valori delle chiavi al momento della creazione della funzione. In alternativa, puoi associarlo in un secondo momento utilizzando update-function. Il valore Quantity è sempre 1 perché a ogni funzione può essere associato un solo archivio di valori delle chiavi.

   Se il comando viene eseguito correttamente, vedrai un output simile al seguente.

   ETag: ETVABCEXAMPLE
   FunctionSummary:
     FunctionConfig:
       Comment: Max Age 2 years
       Runtime: cloudfront-js-2.0
       KeyValueStoreAssociations= \
         {Quantity=1, \
         Items=[{KeyValueStoreARN='arn:aws:cloudfront::111122223333:key-value-store/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111'}]} \
     FunctionMetadata:
       CreatedTime: '2021-04-18T20:38:56.915000+00:00'
       FunctionARN: arn:aws:cloudfront::111122223333:function/MaxAge
       LastModifiedTime: '2023-11-19T20:38:56.915000+00:00'
       Stage: DEVELOPMENT
     Name: MaxAge
     Status: UNPUBLISHED
   Location: https://cloudfront.amazonaws.com/2020-05-31/function/arn:aws:cloudfront:::function/MaxAge

   La maggior parte delle informazioni viene ripetuta dalla richiesta. Altre informazioni vengono aggiunte da CloudFront.

   Note

   • ETag: questo valore cambia a ogni modifica dell’archivio di valori delle chiavi. Utilizza questo valore e il nome della funzione per fare riferimento alla funzione in futuro. Assicurati di utilizzare sempre l’ETag corrente.

   • FunctionARN: l’ARN per la funzione CloudFront.

   • 111122223333: l’Account AWS.

   • Stage: la fase della funzione (LIVE o DEVELOPMENT).

   • Status: lo stato della funzione (PUBLISHED o UNPUBLISHED).

Dopo aver creato la funzione, viene aggiunta alla fase DEVELOPMENT. Ti consigliamo di provare la funzione prima di pubblicarla. Dopo aver pubblicato la funzione, questa passa alla fase LIVE.