Creazione di un archivio di valori delle chiavi - Amazon CloudFront

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Creazione di un archivio di valori delle chiavi

Puoi creare contemporaneamente un archivio di valori delle chiavi e le rispettive coppie chiave-valore. Ora, puoi anche creare un archivio di valori delle chiavi vuoto e aggiungere le coppie chiave-valore in un secondo momento.

Nota

Se specifichi l’origine dati da un bucket Amazon S3, devi disporre delle autorizzazioni s3:GetObject e s3:GetBucketLocation per tale bucket. Se non disponi di queste autorizzazioni, non CloudFront puoi creare correttamente il tuo archivio di valori chiave.

Scegli se desideri aggiungere coppie chiave-valore contemporaneamente alla creazione dell’archivio di valori delle chiavi. Puoi importare le coppie chiave-valore utilizzando la CloudFront console, l' CloudFrontAPI o. AWS SDKs Tuttavia, puoi importare il file di coppie chiave-valore solo quando crei inizialmente l’archivio di valori delle chiavi.

Per creare un file di coppie chiave-valore, consulta Formato file per coppie chiave-valore.

Console
Come creare un archivio di valori delle chiavi
  1. Accedi Console di gestione AWS e apri la pagina Funzioni nella CloudFront console all'indirizzo. https://console.aws.amazon.com/cloudfront/v4/home#/functions

  2. Scegli la KeyValueStoresscheda, quindi scegli Crea KeyValueStore.

  3. Immetti un nome e una descrizione facoltativa per l'archivio di valori delle chiavi.

  4. Completa URI S3:

    • Se disponi di un file di coppie chiave-valore, inserisci il percorso del bucket Amazon S3 in cui hai archiviato il file.

    • Lascia vuoto questo campo se intendi inserire manualmente le coppie chiave-valore.

  5. Scegli Create (Crea). L’archivio di valori delle chiavi ora esiste.

    Viene visualizzata la pagina dei dettagli relativa al nuovo archivio di valori delle chiavi. Le informazioni sulla pagina includono l'ID e l'ARN dell'archivio di valori delle chiavi.

    • L'ID è una stringa casuale di caratteri che è unica nel tuo Account AWS.

    • La sintassi dell'ARN è la seguente:

      Account AWS:key-value-store/the key value stores ID

  6. Osserva la sezione Coppie chiave-valore. Se hai importato un file, in questa sezione vengono visualizzate alcune coppie chiave-valore. Puoi fare quanto segue:

    • Se hai importato un file, puoi anche aggiungere altri valori manualmente.

    • Se non hai importato un file da un bucket Amazon S3 e vuoi aggiungere subito coppie chiave-valore, puoi completare la fase successiva.

    • Puoi ignorare questa fase e aggiungere le coppie chiave-valore in un secondo momento.

  7. Per aggiungere subito le coppie:

    1. Scegli Aggiungi coppie chiave-valore.

    2. Scegli Aggiungi coppia e inserisci un nome e un valore. Ripeti questa fase per aggiungere altre coppie.

    3. Al termine, scegli Salva modifiche per salvare tutte le coppie chiave-valore nell’archivio di valori delle chiavi. Nella finestra di dialogo visualizzata, scegli Fatto.

  8. Per associare subito l’archivio di valori delle chiavi a una funzione, completa la sezione Funzioni associate. Per ulteriori informazioni, consulta Creazione di funzioni o Aggiornamento delle funzioni.

    Puoi associare la funzione in un secondo momento, dalla pagina dei dettagli di questo archivio di valori delle chiavi o dalla pagina dei dettagli della funzione.

AWS CLI
Come creare un archivio di valori delle chiavi
  • Esegui il comando seguente per creare un archivio di valori delle chiavi e importare le coppie chiave-valore da un bucket Amazon S3.

    aws cloudfront create-key-value-store \ --name=keyvaluestore1 \ --comment="This is my key value store file" \ --import-source=SourceType=S3,SourceARN=arn:aws:s3:::amzn-s3-demo-bucket1/kvs-input.json

    Risposta

    { "ETag": "ETVABCEXAMPLE", "Location": "https://cloudfront.amazonaws.com/2020-05-31/key-value-store/arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example", "KeyValueStore": { "Name": "keyvaluestore1", "Id": "8aa76c93-3198-462c-aaf6-example", "Comment": "This is my key value store file", "ARN": "arn:aws:cloudfront::123456789012:key-value-store/8aa76c93-3198-462c-aaf6-example", "Status": "PROVISIONING", "LastModifiedTime": "2024-08-06T22:19:10.813000+00:00" } }
API
Come creare un archivio di valori delle chiavi
  1. Usa l'CloudFrontCreateKeyValueStoreoperazione. L'operazione richiede diversi parametri:

    • un name dell’archivio di valori delle chiavi;

    • un parametro comment che includa un commento;

    • un parametro import-source che consenta di importare coppie chiave-valore da un file archiviato in un bucket Amazon S3. Puoi importare da un file solo la prima volta che crei l’archivio di valori delle chiavi. Per informazioni sulla struttura dei file, consulta Formato file per coppie chiave-valore.

La risposta dell'operazione include le informazioni seguenti:

  • i valori trasmessi nella richiesta, incluso il nome assegnato;

  • dati come l'ora di creazione;

  • un ETag (ad esempio, ETVABCEXAMPLE), l’ARN che include il nome dell’archivio di valori delle chiavi (ad esempio, arn:aws:cloudfront::123456789012:key-value-store/keyvaluestore1).

    Per utilizzare l’archivio di valori delle chiavi a livello di codice, utilizzerai una combinazione di ETag, ARN e nome.

Stati dell’archivio di valori delle chiavi

Quando crei un archivio di valori delle chiavi, i valori di stato del datastore possono essere i seguenti.

Valore Description

Approvvigionamento

L'archivio di valori chiave è stato creato e CloudFront sta elaborando l'origine dati specificata.

Pronto

L'archivio di valori chiave è stato creato ed ha elaborato CloudFront correttamente l'origine dati specificata.

Importazione non riuscita

CloudFront non è stato in grado di elaborare l'origine dati specificata. Questo stato può essere visualizzato se il formato file non è valido o se supera il limite di dimensioni. Per ulteriori informazioni, consulta Formato file per coppie chiave-valore.