Crear o actualizar artefactos

Versión 4.0.23.2

Crear o actualizar uno o más artefactos

Solo se requieren key y value para crear un artefacto. Para actualizar un artefacto, se debe proporcionar su valor version actual.

En la siguiente carga útil body de ejemplo, one y two son artefactos existentes, y three es nuevo:

[
  { "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" },
]

Notas para este cuerpo:

  • value para key uno es una carga útil de JSON, por lo que se necesita una anulación de content_type. Esta anulación se debe realizar cada vez que se establece un valor JSON.
  • Los valores de version para one y two significan que se guardaron 10 y 20 veces, respectivamente.
  • Si no se proporciona version para un artefacto existente, se rechazará la solicitud completa y se enviará una respuesta Bad Request.
  • Si se proporciona version para un artefacto, solo se usa con el fin de evitar reemplazos involuntarios de datos. No se puede usar para configurar la versión de un artefacto. El servidor de Looker controla version.
  • Se sugiere codificar valores binarios como base64. Debido a que el tipo de contenido de MIME para base64 se detecta como texto sin formato, también proporciona content_type a fin de indicar correctamente el tipo de valor para la recuperación y el procesamiento del cliente.

Debido a que los artefactos se almacenan encriptados, se puede escribir el mismo valor varias veces (siempre que se use el número version correcto). Looker no examina ningún valor almacenado en el almacén de artefactos y solo los desencripta cuando envía artefactos en una respuesta de la API.

Nota: Solo la API de Looker puede usar la API de Artifact Storage.

Solicitud

PUT /artifacts/{namespace}
Tipo de datos
Descripción
Solicitud
HTTPRequest
ruta
Ruta de HTTP
Expandir la definición HTTPPath...
espacio de nombres
string
Espacio de nombres del almacenamiento de artefactos
body
Cuerpo HTTP
Expandir la definición HTTPBody...
Expandir la definición de UpdateArtifact...
clave
string
Clave de valor para almacenar. El espacio de nombres y la clave deben ser únicos.
valor
string
Valor para almacenar.
content_type
string
Tipo de contenido de MIME Solo se puede usar para anular contenido que se detecta como texto o sin formato. Se requiere para establecer los tipos de contenido aplicación/json, que se analizan como texto sin formato.
version
integer
Número de versión del valor almacenado. Se debe proporcionar la versión para cualquier actualización de un artefacto existente.
verá la consulta cuando se guarde
HTTPQuery
Expandir definición de HTTPQuery...
campos
string
Nombres de campos delimitados por comas que se muestran en las respuestas. Omitir en todos los campos

Respuesta

200: artefactos creados o actualizados

Tipo de datos
Descripción
(array)
clave
string
Clave de valor para almacenar. El espacio de nombres y la clave deben ser únicos.
valor
string
Valor para almacenar.
content_type
string
Tipo de contenido de MIME Solo se puede usar para anular contenido que se detecta como texto o sin formato. Se requiere para establecer los tipos de contenido aplicación/json, que se analizan como texto sin formato.
version
integer
Número de versión del valor almacenado. Se debe proporcionar la versión para cualquier actualización de un artefacto existente.
espacio de nombres
string
Espacio de nombres de almacenamiento de artefactos.
creado_en
string
Marca de tiempo de la creación de este artefacto.
actualizado_a
string
Marca de tiempo de la actualización de este artefacto.
value_size
integer
Tamaño (en bytes) del valor almacenado.
creado_por_usuario
string
ID de usuario del creador del artefacto.
actualizado_por_usuario_ID
string
ID de usuario del actualizador de artefactos

400: Bad Request

Tipo de datos
Descripción
(objeto)
mensaje,
string
Detalles del error
url_documentación
string
Vínculo a la documentación

404: No encontrado

Tipo de datos
Descripción
(objeto)
mensaje,
string
Detalles del error
url_documentación
string
Vínculo a la documentación

422: Error de validación

Tipo de datos
Descripción
(objeto)
mensaje,
string
Detalles del error
Expandir la definición de ValidationErrorDetail...
campo
string
Campo con error
código
string
Código de error
mensaje,
string
Mensaje de información de error
url_documentación
string
Vínculo a la documentación
url_documentación
string
Vínculo a la documentación

429: Demasiadas solicitudes

Tipo de datos
Descripción
(objeto)
mensaje,
string
Detalles del error
url_documentación
string
Vínculo a la documentación