Creazione di funzioni

La creazione di una funzione avviene in due fasi:

1. Crea il codice della funzione come JavaScript. Puoi usare l'esempio predefinito dalla CloudFront console o scriverne uno tuo. Per ulteriori informazioni, consulta i seguenti argomenti:

   • Scrivi il codice della funzione

   • CloudFront Funzioni, struttura degli eventi

   • CloudFront Esempi di funzioni da utilizzare CloudFront AWS SDKs

2. CloudFront Utilizzatelo 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 CloudFront console all'indirizzo https://console.aws.amazon.com/cloudfront/v4/home#/functions e scegli la pagina Funzioni.

2. Scegli Crea funzione.

3. Inserisci un nome di funzione univoco all'interno di Account AWS, scegli la JavaScript versione, quindi scegli 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, scegliete la scheda Build e immettete il codice della 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 della funzione utilizza coppie chiave-valore, è necessario associare un archivio chiave-valore.

   È possibile associare l'archivio di valori chiave quando si crea la funzione per la prima volta. In alternativa, è possibile associarlo in un secondo momento, aggiornando la funzione.

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

   • Vai alla KeyValueStore sezione Associa e scegli Associa esistente KeyValueStore.

   • Seleziona l'archivio chiave-valore che contiene le coppie chiave-valore nella funzione, quindi scegli Associa. 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 fileb:// notazione 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, è possibile associare l'archivio chiave-valore quando si crea la funzione per la prima volta. In alternativa, è possibile associarla 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 ogni volta che si modifica l'archivio di valori chiave. Utilizzate questo valore e il nome della funzione per fare riferimento alla funzione in futuro. Assicuratevi di utilizzare sempre la correnteETag.

   • FunctionARN— L'ARN per la tua CloudFront funzione.

   • 111122223333 — Il. Account AWS

   • Stage— Lo stadio della funzione (LIVEoDEVELOPMENT).

   • Status— Lo stato della funzione (PUBLISHEDoUNPUBLISHED).

Dopo aver creato la funzione, questa viene aggiunta allo DEVELOPMENT stage. Ti consigliamo di testare la tua funzione prima di pubblicarla. Dopo aver pubblicato la funzione, la funzione passa allo LIVE stage.