Crea o aggiorna artefatti

Versione 4.0.23.6 (più recente)

Crea o aggiorna uno o più artefatti

Solo key e value sono necessari per creare un artefatto. Per aggiornare un artefatto, è necessario fornire il valore version attuale.

Nell'esempio seguente il payload body, one e two sono artefatti esistenti e three è nuovo:

[
  { "key": "one", "value": "[ \"updating\", \"existing\", \"one\" ]", "version": 10, "content_type": "application/json" },
  { "key": "two", "value": "updating existing two", "version": 20 },
  { "key": "three", "value": "creating new three" },
]

Note per questo corpo:

  • value per key uno è un payload JSON, pertanto è necessario un override content_type. Questa sostituzione deve essere eseguita ogni volta in cui viene impostato un valore JSON.
  • I valori version per uno e due indicano che sono stati salvati rispettivamente 10 e 20 volte.
  • Se version non viene fornito per un artefatto esistente, l'intera richiesta verrà rifiutata e verrà inviata una risposta Bad Request.
  • Se version viene fornito per un artefatto, viene utilizzato solo per contribuire a prevenire la sovrascrittura accidentale dei dati. Non può essere utilizzato per impostare la versione di un artefatto. Il server Looker controlla version.
  • Consigliamo di codificare i valori binari come base64. Poiché il tipo di contenuto MIME per base64 viene rilevato come testo normale, fornisci anche content_type per indicare correttamente il tipo di valore per il recupero e l'elaborazione lato client.

Poiché gli artefatti sono criptati, lo stesso valore può essere scritto più volte (a condizione che venga utilizzato il numero di version corretto). Looker non esamina i valori archiviati nell'archivio di artefatti e decripta solo quando restituisce gli artefatti in una risposta API.

Nota: l'API artefatto di archiviazione può essere utilizzata solo dalle estensioni create da Looker.

Richiesta

PUT /artifacts/{nomespazio}
Tipo di dati
Descrizione
Richiesta
HTTPRequest
percorso
Percorso HTTP
Espandi definizione HTTPPath...
spazio dei nomi
string
Spazio dei nomi di archiviazione artefatti
body
HTTPBody
Espandi definizione HTTPBody...
Espandi definizione di UpdateArtifact...
chiave
string
Chiave del valore da archiviare. Lo spazio dei nomi + la chiave devono essere univoci.
valore
string
Valore da archiviare.
tipo_contenuti
string
Tipo MIME dei contenuti. Questa opzione può essere utilizzata solo per sostituire i contenuti rilevati come testo/normale. necessaria per impostare i tipi di contenuti dell'applicazione/json, che vengono analizzati come testo normale.
version
integer
Numero di versione del valore memorizzato. La versione deve essere fornita per eventuali aggiornamenti di un artefatto esistente.
della query
Query HTTP
Espandi definizione HTTPQuery in corso...
campi
string
Nomi dei campi delimitati da virgole da restituire nelle risposte. Ometti per tutti i campi

Risposta

200: artefatti creati o aggiornati

Tipo di dati
Descrizione
(array)
chiave
string
Chiave del valore da archiviare. Lo spazio dei nomi + la chiave devono essere univoci.
valore
string
Valore da archiviare.
tipo_contenuti
string
Tipo MIME dei contenuti. Questa opzione può essere utilizzata solo per sostituire i contenuti rilevati come testo/normale. necessaria per impostare i tipi di contenuti dell'applicazione/json, che vengono analizzati come testo normale.
version
integer
Numero di versione del valore memorizzato. La versione deve essere fornita per eventuali aggiornamenti di un artefatto esistente.
spazio dei nomi
string
Spazio dei nomi di archiviazione degli artefatti.
creata_alle
string
Timestamp relativo alla creazione di questo artefatto.
aggiornato_in
string
Timestamp quando è stato aggiornato questo artefatto.
dimensione_valore
integer
Dimensioni (in byte) del valore memorizzato.
create_by_userid [id_utente]
string
ID utente dell'autore dell'artefatto.
aggiornato_da_utente
string
ID utente dell'aggiornatore di elementi.

400: Richiesta errata

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione

404: Non trovata

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione

422: Errore di convalida

Tipo di dati
Descrizione
messaggio
string
Error details (Dettagli errore)
Espandi definizione ValidationErrorDetails...
campo
string
Campo con errore
codice
string
Codice di errore
messaggio
string
Messaggio informativo sull'errore
documentazione_url
string
Link alla documentazione
documentazione_url
string
Link alla documentazione

429: Troppe richieste

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione