Crea un archivio di valori chiave - 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à.

Crea un archivio di valori chiave

È possibile creare contemporaneamente un archivio di valori chiave e le relative coppie chiave-valore. È inoltre possibile creare subito un archivio chiave-valore vuoto e aggiungere le coppie chiave-valore in un secondo momento.

Nota

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

Decidi se aggiungere coppie chiave-valore contemporaneamente alla creazione dell'archivio di valori chiave. È possibile importare le coppie chiave-valore utilizzando la CloudFront console, o. CloudFront API AWS SDKs Tuttavia, è possibile importare il file di coppie chiave-valore solo quando si crea inizialmente l'archivio chiave-valore.

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

Console
Per creare un archivio di valori chiave
  1. Accedi AWS Management Console e apri la pagina Funzioni nella CloudFront console all'indirizzohttps://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 S3: URI

    • 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 prevedi di inserire manualmente le coppie chiave-valore.

  5. Scegli Create (Crea) . L'archivio chiave-valore ora esiste.

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

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

    • ARNHa questa sintassi:

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

  6. Osserva la sezione Coppie chiave-valore. Se hai importato un file, questa sezione mostra alcune coppie chiave-valore. Puoi eseguire le operazioni indicate di seguito:

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

    • Se non hai importato un file da un bucket Amazon S3 e desideri aggiungere subito coppie chiave-valore, puoi completare il passaggio successivo.

    • Puoi saltare questo passaggio 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 questo passaggio per aggiungere altre coppie.

    3. Al termine, scegli Salva modifiche per salvare tutte le coppie chiave-valore nell'archivio chiave-valore. Nella finestra di dialogo che appare, scegli Fine.

  8. Per associare subito l'archivio di valori chiave a una funzione, completa la sezione Funzioni associate. Per ulteriori informazioni, consulta Creazione di funzioni o Funzioni di aggiornamento.

    È possibile associare la funzione anche in un secondo momento, da questa pagina dei dettagli dell'archivio di valori chiave o dalla pagina dei dettagli della funzione.

AWS CLI
Per creare un archivio di valori chiave
  • Esegui il comando seguente per creare un archivio di valori chiave 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
Per creare un archivio di valori chiave
  1. Usa l'CloudFrontCreateKeyValueStoreoperazione. L'operazione richiede diversi parametri:

    • A name del Key Value Store.

    • un parametro comment che includa un commento;

    • Un import-source parametro che consente di importare coppie chiave-valore da un file archiviato in un bucket Amazon S3. Puoi importare da un file solo quando crei per la prima volta l'archivio di valori chiave. Per informazioni sulla struttura dei file, vedereFormato di 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), ARN che include il nome dell'archivio di valori chiave (ad esempio,arn:aws:cloudfront::123456789012:key-value-store/keyvaluestore1).

    Utilizzerai una combinazione di ETagARN, the e nome per utilizzare l'archivio di valori chiave a livello di codice.

Stati del Key Value Store

Quando si crea un archivio di valori chiave, l'archivio dati può avere i seguenti valori di stato.

Valore Descrizione

Approvvigionamento

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

Pronto

L'archivio di valori chiave è stato creato e 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ò apparire se il formato del file non è valido o se supera il limite di dimensione. Per ulteriori informazioni, consulta Formato di file per coppie chiave-valore.