En esta página, se explica cómo crear, editar, ver, enumerar y borrar almacenes de recursos de interoperabilidad para atención médica rápida (FHIR). Los almacenes de FHIR contienen recursos de FHIR, como recursos de solicitudes de reembolso de gastos médicos, recursos de pacientes, recursos de medicamentos y mucho más.
La API de Cloud Healthcare admite las siguientes versiones de FHIR:
Crea un almacén de FHIR
Antes de crear un almacén de FHIR, debes crear un conjunto de datos.
En los siguientes ejemplos, se muestra cómo crear un almacén de FHIR con el método projects.locations.datasets.fhirStores.create
.
Console
Para crear un almacén de FHIR, completa los siguientes pasos:
- En la consola de Google Cloud, ve a la página Conjuntos de datos.
- Abre el conjunto de datos en el que deseas crear un almacén de FHIR.
- Haz clic en Crear almacén de datos.
- Selecciona FHIR como el tipo de almacén de datos.
- Ingresa un nombre que sea único en tu conjunto de datos. Si el nombre no es único, la creación del almacén falla.
- Haz clic en Siguiente.
- Para configurar el almacén de FHIR, haz lo siguiente:
- Elige DSTU2 para el almacén de FHIR. STU3 o R4.
- Selecciona la configuración avanzada correspondiente entre las siguientes opciones:
- Permitir operaciones de actualización y creación: Selecciona esta opción para permitir la creación de un recurso nuevo con una operación de actualización con un ID especificado por el usuario.
- Verificaciones de integridad referencial: Selecciona esta opción para habilitar la integridad referencial en este almacén. Esto no se puede cambiar después de crear el almacén.
- Control de versiones de recursos: Selecciona esta opción para registrar automáticamente las versiones históricas de los recursos. No se puede cambiar después de crear la tienda.
- Selecciona la configuración de validación de perfiles correspondiente en los siguientes campos. Para obtener más información,
consulta ValidationConfig:
- Habilitar la validación de perfiles: Selecciona esta opción para habilitar la validación de perfiles. Para aplicar un de implementación que está habilitada en tu almacén de FHIR, debes habilitar validación.
- Habilitar la validación de campos obligatorios: Selecciona esta opción para habilitar la validación de campos de recursos con las definiciones de estructura de tu perfil de FHIR.
- Habilitar la validación del tipo de referencia: Selecciona esta opción para habilitar la validación del tipo de referencia.
- Habilitar la validación de FHIRPath: Selecciona esta opción para habilitar la verificación de compatibilidad de FHIRPath.
- Haz clic en Siguiente.
- Para habilitar las guías de implementación en el almacén de FHIR, haz lo siguiente (opcional):
- Haz clic en Habilitar guías de implementación.
- Haz clic y expande la lista Guías de implementación.
- Selecciona las guías de implementación correspondientes de la lista.
Cada guía de implementación admite una versión específica de FHIR. La lista muestra solo aquellos de implementación compatibles con la versión seleccionada del almacén de FHIR.
- Haz clic en Import custom IG from Cloud Storage (Importar IG personalizada desde Cloud Storage) para importar cualquier validación de perfil personalizado. un paquete desde una ubicación de Cloud Storage.
- En el panel Seleccionar objeto, selecciona un recurso de paquete de validación de perfiles de un Ubicación de Cloud Storage. Para obtener más información, consulta Usa la consola de Google Cloud para habilitar las guías de implementación.
- Haz clic en Seleccionar.
- Las guías de implementación seleccionadas se enumeran en una tabla con su versión, URL y estado.
- Si habilitaste las guías de implementación, pero no la validación de perfiles, la guía de implementación no entra en vigencia.
- Haz clic en Siguiente.
- Opcional: Para exportar los cambios de recursos a BigQuery cada vez que se creen, actualicen, borren o apliquen parches a los recursos de FHIR en tu almacén, haz lo siguiente:
- Haz clic en Transmitir cambios de recursos a BigQuery.
- Haz clic en Agregar una configuración de transmisión. Para obtener más información sobre BigQuery de transmisión, consulta Transmite cambios de recursos de FHIR a BigQuery.
- Selecciona el nivel de profundidad en el control deslizante de Profundidad de la estructura recurrente para establecer la profundidad. de todas las estructuras recursivas en el esquema de salida. De forma predeterminada, el valor de profundidad recursivo es 2.
- Haz clic en Listo para guardar la configuración de transmisión.
- Haz clic en Siguiente.
- Opcional: Para configurar un tema de Pub/Sub para el almacén de FHIR, haz lo siguiente:
- Haz clic en Recibir notificaciones de Cloud Pub/Sub.
- Haz clic en Agregar un tema de Cloud Pub/Sub y selecciona el nombre del tema.
Cuando especifiques un tema de Pub/Sub, ingresa el URI calificado para el tema, como se muestra en el siguiente ejemplo:
projects/PROJECT_ID/topics/PUBSUB_TOPIC
- Haz clic en Siguiente.
- Opcional: Para agregar etiquetas a la tienda, haz lo siguiente:
- Haz clic en Agregar etiquetas para organizar tus almacenes de datos.
- Ingresa la clave y el valor de la etiqueta. Para obtener más información sobre etiquetas de recursos, consulta Usa etiquetas de recursos.
- Haz clic en Crear.
El nuevo almacén de FHIR aparece en la lista.
gcloud
Para crear un almacén de FHIR en el conjunto de datos, ejecuta el comando gcloud healthcare fhir-stores create
.
Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:
- LOCATION: La ubicación del conjunto de datos
- DATASET_ID es el conjunto de datos superior del almacén de FHIR
- FHIR_STORE_ID:
un identificador para el almacén de FHIR. El ID del almacén de FHIR debe tener lo siguiente:
- Un ID único en su conjunto de datos
- Una string de Unicode de 1 a 256 caracteres que consiste en lo siguiente:
- Números
- Letras
- Guiones bajos
- Guiones:
- Puntos:
- FHIR_STORE_VERSION: La versión de FHIR del almacén de FHIR. Las opciones disponibles son DSTU2, STU3 o R4.
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud healthcare fhir-stores create FHIR_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --version=FHIR_STORE_VERSION
Windows (PowerShell)
gcloud healthcare fhir-stores create FHIR_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION ` --version=FHIR_STORE_VERSION
Windows (cmd.exe)
gcloud healthcare fhir-stores create FHIR_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION ^ --version=FHIR_STORE_VERSION
Deberías recibir una respuesta similar a la que figura a continuación:
Respuesta
Created fhirStore [FHIR_STORE_ID].
REST
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_IDEl ID de tu proyecto de Google Cloud.
- LOCATION: La ubicación del conjunto de datos
- DATASET_ID es el conjunto de datos superior del almacén de FHIR
- FHIR_STORE_ID:
un identificador para el almacén de FHIR. El ID del almacén de FHIR debe tener lo siguiente:
- Un ID único en su conjunto de datos
- Una string de Unicode de 1 a 256 caracteres que consiste en lo siguiente:
- Números
- Letras
- Guiones bajos
- Guiones:
- Puntos:
- FHIR_STORE_VERSION: La versión de FHIR del almacén de FHIR. Las opciones disponibles son DSTU2, STU3 o R4.
Cuerpo JSON de la solicitud:
{ "version": "FHIR_STORE_VERSION" }
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json
.
Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:
cat > request.json << 'EOF' { "version": "FHIR_STORE_VERSION" } EOF
Luego, ejecuta el siguiente comando para enviar tu solicitud de REST:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores?fhirStoreId=FHIR_STORE_ID"
PowerShell
Guarda el cuerpo de la solicitud en un archivo llamado request.json
.
Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:
@' { "version": "FHIR_STORE_VERSION" } '@ | Out-File -FilePath request.json -Encoding utf8
Luego, ejecuta el siguiente comando para enviar tu solicitud de REST:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores?fhirStoreId=FHIR_STORE_ID" | Select-Object -Expand Content
Explorador de API
Copia el cuerpo de la solicitud y abre la página de referencia del método. El panel del Explorador de API se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Pega el cuerpo de la solicitud en esta herramienta, completa cualquier otro campo obligatorio y haz clic en Ejecutar.
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Go
Java
Node.js
Python
Edita un almacén de FHIR
En los siguientes ejemplos, se muestra cómo editar un almacén de FHIR. Puedes editar un almacén de FHIR para modificar propiedades, como las que se muestran a continuación:
- El tema de Pub/Sub al que se aplica la API de Cloud Healthcare envía notificaciones de cambios del almacén de FHIR.
- Las etiquetas del almacén de FHIR. Las etiquetas son pares clave-valor que te ayudan a organizar tus recursos de Google Cloud.
projects/PROJECT_ID/topics/PUBSUB_TOPIC
Console
Para editar un almacén de FHIR, realiza los siguientes pasos:
En la consola de Google Cloud, ve a la página Conjuntos de datos.
Ir a Conjuntos de datosSelecciona el conjunto de datos que contenga el almacén de FHIR que deseas editar.
En la lista Almacenes de datos, selecciona el almacén de FHIR que deseas editar.
Para editar la configuración del almacén, haz clic en
Configuración del almacén de FHIR.Para obtener más información sobre las opciones de configuración del almacén de FHIR, consulta Crea un almacén de FHIR.
Para editar las guías de implementación de la tienda, haz clic en Usa la consola de Google Cloud para habilitar las guías de implementación.
Guías de implementación y selecciona las guías correspondientes o importar una guía de implementación personalizada desde Cloud Storage. Para ver más información, consultaPara editar las guías de implementación o aplicar de manera forzosa la implementación habilitada debes habilitar la validación de perfiles en la Configuración del almacén de FHIR.
Para exportar los cambios de recursos a BigQuery cada vez que se creen, actualicen, parchen o borren recursos de FHIR en tu almacén, haz clic en Agregar nueva configuración de transmisión en el campo Conjunto de datos.
Selecciona un conjunto de datos de BigQuery en el que se transmitirán los cambios de recursos. Para obtener más información sobre la transmisión de BigQuery, consulta Transmite cambios de los recursos de FHIR a BigQuery.
Para establecer la profundidad de todas las estructuras recurrentes en el esquema de salida, haz clic en la profundidad relevante en el control deslizante Profundidad de la estructura recurrente. De forma predeterminada, la profundidad recurrente es 2.
A fin de exportar cambios de recursos solo para tipos de recursos específicos, selecciona los tipos de recursos de la lista Selecciona los tipos de recursos de FHIR.
Si deseas configurar un tema de Pub/Sub para el almacén de datos, selecciona un nombre de tema en la sección Notificaciones de Cloud Pub/Sub. Cuando especifiques un tema de Pub/Sub, ingresa el URI calificado para el tema, como se muestra en el siguiente ejemplo:
projects/PROJECT_ID/topics/PUBSUB_TOPIC
Para agregar una o más etiquetas al almacén, haz clic en Usa etiquetas de recursos.
Etiquetas, luego, en Agregar etiqueta e ingresa la etiqueta de par clave-valor. Para obtener más información sobre las etiquetas de recursos, consultaHaz clic en Guardar.
gcloud
Para editar un almacén de FHIR, ejecuta el comando gcloud healthcare fhir-stores update
.
Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:
PROJECT_ID
El ID de tu proyecto de Google Cloud.LOCATION
: La ubicación del conjunto de datosDATASET_ID
es el conjunto de datos superior del almacén de FHIRFHIR_STORE_ID
es el ID del almacén de FHIRPUBSUB_TOPIC_ID
: Es un tema de Pub/Sub en el que se publican mensajes cuando se produce un evento en un almacén de datos.
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud healthcare fhir-stores update FHIR_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID
Windows (PowerShell)
gcloud healthcare fhir-stores update FHIR_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION ` --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID
Windows (cmd.exe)
gcloud healthcare fhir-stores update FHIR_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION ^ --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID
Deberías recibir una respuesta similar a la que figura a continuación:
Respuesta
Updated fhirStore [FHIR_STORE_ID]. name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID notificationConfig: pubsubTopic: projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID version: FHIR_STORE_VERSION
REST
Para editar un almacén de FHIR, usa el método projects.locations.datasets.fhirStores.patch
.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
PROJECT_ID
El ID de tu proyecto de Google Cloud.LOCATION
: La ubicación del conjunto de datosDATASET_ID
es el conjunto de datos superior del almacén de FHIRFHIR_STORE_ID
es el ID del almacén de FHIRPUBSUB_TOPIC_ID
: Es un tema de Pub/Sub en el que se publican mensajes cuando ocurre un evento en un almacén de datos. Para determinar qué datos incluir en las notificaciones de Pub/Sub, consulta Notificaciones de Pub/Sub de FHIR.KEY1
: La primera clave de etiquetaVALUE1
: El primer valor de etiquetaKEY2
: La segunda clave de etiquetaVALUE2
: El segundo valor de etiqueta
Cuerpo JSON de la solicitud:
{ "notificationConfigs": [ { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID" } ], "labels": { "KEY1": "VALUE1", "KEY2": "VALUE2" } }
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json
.
Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:
cat > request.json << 'EOF' { "notificationConfigs": [ { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID" } ], "labels": { "KEY1": "VALUE1", "KEY2": "VALUE2" } } EOF
Luego, ejecuta el siguiente comando para enviar tu solicitud de REST:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID?updateMask=notificationConfig,labels"
PowerShell
Guarda el cuerpo de la solicitud en un archivo llamado request.json
.
Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:
@' { "notificationConfigs": [ { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID" } ], "labels": { "KEY1": "VALUE1", "KEY2": "VALUE2" } } '@ | Out-File -FilePath request.json -Encoding utf8
Luego, ejecuta el siguiente comando para enviar tu solicitud de REST:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID?updateMask=notificationConfig,labels" | Select-Object -Expand Content
Explorador de API
Copia el cuerpo de la solicitud y abre la página de referencia del método. El panel del Explorador de API se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Pega el cuerpo de la solicitud en esta herramienta, completa cualquier otro campo obligatorio y haz clic en Ejecutar.
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Go
Java
Node.js
Python
Obtén detalles del almacén de FHIR
En los siguientes ejemplos, se muestra cómo obtener detalles sobre un almacén FHIR.
Console
Para ver los detalles de un almacén de FHIR, debes hacer lo siguiente:
- En la consola de Google Cloud, ve a la página Conjunto de datos.
- Selecciona el conjunto de datos que contiene el almacén de FHIR.
- Haz clic en el nombre del almacén de FHIR.
gcloud
Para obtener más detalles sobre un almacén de FHIR, ejecuta el comando gcloud healthcare fhir-stores describe
.
Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:
- LOCATION: La ubicación del conjunto de datos
- DATASET_ID es el conjunto de datos superior del almacén de FHIR
- FHIR_STORE_ID es el ID del almacén de FHIR
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud healthcare fhir-stores describe FHIR_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare fhir-stores describe FHIR_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare fhir-stores describe FHIR_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Deberías recibir una respuesta similar a la que figura a continuación.
Si configuraste algún campo en el recurso FhirStore
, también aparecerá en la respuesta.
Respuesta
... name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID ... version: FHIR_STORE_VERSION
REST
Para obtener más detalles sobre un almacén de FHIR, usa el método projects.locations.datasets.fhirStores.get
.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_IDEl ID de tu proyecto de Google Cloud.
- LOCATION: La ubicación del conjunto de datos
- DATASET_ID es el conjunto de datos superior del almacén de FHIR
- FHIR_STORE_ID es el ID del almacén de FHIR
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID"
PowerShell
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID" | Select-Object -Expand Content
Explorador de API
Abre el página de referencia del método. El panel del Explorador de API se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Completa los campos obligatorios y haz clic en Ejecutar.
Deberías recibir una respuesta similar a la que figura a continuación.
Si configuraste algún campo en el recurso FhirStore
, también aparecerá en la respuesta.
Go
Java
Node.js
Python
Enumera los almacenes de FHIR en un conjunto de datos
En los siguientes ejemplos, se muestra cómo enumerar los almacenes de FHIR en un conjunto de datos.
Console
Para ver los almacenes de datos en un conjunto de datos, haz lo siguiente:
- En la consola de Google Cloud, ve a la página Conjuntos de datos.
- Selecciona el conjunto de datos que contiene el almacén de datos que deseas ver.
gcloud
Para obtener más detalles sobre un almacén de FHIR, ejecuta el comando gcloud healthcare fhir-stores list
.
Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:
- DATASET_ID es el conjunto de datos superior del almacén de FHIR
- LOCATION: La ubicación del conjunto de datos
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud healthcare fhir-stores list --dataset=DATASET_ID --location=LOCATION
Windows (PowerShell)
gcloud healthcare fhir-stores list --dataset=DATASET_ID --location=LOCATION
Windows (cmd.exe)
gcloud healthcare fhir-stores list --dataset=DATASET_ID --location=LOCATION
Deberías recibir una respuesta similar a la que figura a continuación.
Si configuraste algún campo en el recurso FhirStore
, también aparecerá en la respuesta.
ID LOCATION REF_INT RES_VER UPDATE_CREATE TOPIC FHIR_STORE_ID LOCATION PUBSUB_TOPIC ...
REST
Para enumerar los almacenes de FHIR en un conjunto de datos, usa el método projects.locations.datasets.fhirStores.list
.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_IDEl ID de tu proyecto de Google Cloud.
- DATASET_ID es el conjunto de datos superior del almacén de FHIR
- LOCATION: La ubicación del conjunto de datos
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores"
PowerShell
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores" | Select-Object -Expand Content
Explorador de API
Abre el página de referencia del método. El panel del Explorador de API se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Completa los campos obligatorios y haz clic en Ejecutar.
Deberías recibir una respuesta similar a la que figura a continuación.
Si configuraste algún campo en el recurso FhirStore
, también aparecerá en la respuesta.
Go
Java
Node.js
Python
Obtén las capacidades o la declaración de conformidad para un almacén de FHIR
En los siguientes ejemplos, se muestra cómo obtener el capacidades (STU3 o R4) o conformidad (DSTU2) para un almacén de FHIR.
La información en las capacidades o la declaración de conformidad refleja la configuración en el almacén de FHIR. Por ejemplo, si FhirStore.enableUpdateCreate
se configura como true
, esto se refleja en el campo CapabilityStatement.rest.resource.updateCreate
de la declaración de capacidades.
En la siguiente tabla, se muestra el método de la API de Cloud Healthcare para obtener las capacidades o la declaración de conformidad de un almacén de FHIR y su interacción de especificación FHIR equivalente:
Método de la API de Cloud Healthcare | Interacción de especificación de FHIR |
---|---|
projects.locations.datasets.fhirStores.fhir.capabilities |
capacidades (STU3 o R4) o conformance (DSTU2) |
Consola
La consola de Google Cloud y la CLI de gcloud no admiten esta acción. En su lugar, usa curl
, PowerShell o tu lenguaje preferido.
gcloud
La consola de Google Cloud y la CLI de gcloud no admiten esta acción. En su lugar, usa curl
, PowerShell o tu lenguaje preferido.
REST
Para obtener las capacidades o la declaración de conformidad de un almacén de FHIR, usa el método projects.locations.datasets.fhirStores.fhir.capabilities
.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_IDEl ID de tu proyecto de Google Cloud.
- LOCATION: La ubicación del conjunto de datos
- DATASET_ID es el conjunto de datos superior del almacén de FHIR
- FHIR_STORE_ID es el ID del almacén de FHIR
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/metadata"
PowerShell
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/metadata" | Select-Object -Expand Content
Explorador de API
Abre el página de referencia del método. El panel del Explorador de API se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Completa los campos obligatorios y haz clic en Ejecutar.
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Go
Java
Node.js
Python
Establece el nivel de validación base de los recursos
De forma predeterminada, todos los recursos de tu almacén de FHIR tienen aplicada la validación base de recursos. Esta validación garantiza que se cumplan las siguientes condiciones cuando se cree el recurso:
- Se definieron todos los campos obligatorios.
- Todos los tipos de recursos referidos son válidos.
- El recurso cumple con todas las restricciones de FHIRPath.
Puedes hacer que la validación base de recursos sea menos estricta si inhabilitas uno o más de estos tipos de validación de recursos base para el almacén de FHIR.
Consola
La consola de Google Cloud y la CLI de gcloud no admiten esta acción. En su lugar, usa curl
, PowerShell o tu lenguaje preferido.
gcloud
La consola de Google Cloud y la CLI de gcloud no admiten esta acción. En su lugar, usa curl
, PowerShell o tu lenguaje preferido.
REST
Para inhabilitar la validación base de recursos en un almacén de FHIR existente, usa el método projects.locations.datasets.fhirStores.patch
.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_IDEl ID de tu proyecto de Google Cloud.
- DATASET_ID es el conjunto de datos superior del almacén de FHIR
- LOCATION: La ubicación del conjunto de datos
- BASE_RESOURCE_VALIDATION_TYPE: El tipo de validación base de recursos que deseas inhabilitar. Para inhabilitar la validación, configura cualquiera de los siguientes campos en
true
:disableRequiredFieldValidation
disableReferenceTypeValidation
disableFhirpathValidation
Cuerpo JSON de la solicitud:
{ "validationConfig": { "BASE_RESOURCE_VALIDATION_TYPE": true } }
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json
.
Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:
cat > request.json << 'EOF' { "validationConfig": { "BASE_RESOURCE_VALIDATION_TYPE": true } } EOF
Luego, ejecuta el siguiente comando para enviar tu solicitud de REST:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID?updateMask=validationConfig"
PowerShell
Guarda el cuerpo de la solicitud en un archivo llamado request.json
.
Ejecuta el comando siguiente en la terminal para crear o reemplazar este archivo en el directorio actual:
@' { "validationConfig": { "BASE_RESOURCE_VALIDATION_TYPE": true } } '@ | Out-File -FilePath request.json -Encoding utf8
Luego, ejecuta el siguiente comando para enviar tu solicitud de REST:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID?updateMask=validationConfig" | Select-Object -Expand Content
Explorador de API
Copia el cuerpo de la solicitud y abre la página de referencia del método. El panel del Explorador de API se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Pega el cuerpo de la solicitud en esta herramienta, completa cualquier otro campo obligatorio y haz clic en Ejecutar.
Deberías recibir una respuesta similar a la que figura a continuación.
Si configuraste algún campo en el recurso FhirStore
, también aparecerá en la respuesta.
Borra un almacén de FHIR
En los siguientes ejemplos, se muestra cómo borrar un almacén de FHIR.
Console
Para borrar un almacén de datos, realiza las siguientes acciones:
- En la consola de Google Cloud, ve a la página Conjuntos de datos.
- Selecciona el conjunto de datos que contiene el almacén de datos que deseas borrar.
- Elige Borrar en la lista desplegable Acciones para el almacén de datos que deseas borrar.
- Para confirmar, escribe el nombre del almacén de datos y, luego, haz clic en Borrar.
gcloud
Para borrar un almacén de FHIR, ejecuta el comando gcloud healthcare fhir-stores delete
.
Antes de usar cualquiera de los datos de comando a continuación, realiza los siguientes reemplazos:
- LOCATION: La ubicación del conjunto de datos
- DATASET_ID es el conjunto de datos superior del almacén de FHIR
- FHIR_STORE_ID es el ID del almacén de FHIR
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud healthcare fhir-stores delete FHIR_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare fhir-stores delete FHIR_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare fhir-stores delete FHIR_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Deberías recibir una respuesta similar a la que figura a continuación:
Deleted fhirStore [FHIR_STORE_ID].
REST
Para borrar un almacén de FHIR, usa el método projects.locations.datasets.fhirStores.delete
.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_IDEl ID de tu proyecto de Google Cloud.
- LOCATION: La ubicación del conjunto de datos
- DATASET_ID es el conjunto de datos superior del almacén de FHIR
- FHIR_STORE_ID es el ID del almacén de FHIR
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el siguiente comando:
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID"
PowerShell
Ejecuta el siguiente comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID" | Select-Object -Expand Content
Explorador de API
Abre el página de referencia del método. El panel del Explorador de API se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Completa los campos obligatorios y haz clic en Ejecutar.
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
Go
Java
Node.js
Python
¿Qué sigue?
Obtén más información sobre cómo crear y trabajar con recursos de FHIR.