En esta página se explica cómo crear, editar, ver, listar y eliminar almacenes Digital Imaging and Communications in Medicine (DICOM).
Los almacenes DICOM contienen instancias DICOM. Puedes añadir y gestionar instancias DICOM en un almacén DICOM mediante la implementación de DICOMweb en la API Cloud Healthcare, o bien importar y exportar instancias DICOM mediante servicios de Google Cloud .
Para obtener más información sobre cómo se ajusta la API Cloud Healthcare al estándar DICOM, consulta la declaración de conformidad de DICOM.
Crear un almacén DICOM
Para poder crear un almacén DICOM, antes debes crear un conjunto de datos.
En los siguientes ejemplos se muestra cómo crear un almacén DICOM:
Consola
Para crear un almacén DICOM, sigue estos pasos:
- En la Google Cloud consola, ve a la página Conjuntos de datos.
- Selecciona el conjunto de datos en el que quieras crear un almacén DICOM.
- Haz clic en Crear almacén de datos.
- Selecciona DICOM como tipo de almacén de datos.
- Escribe el nombre que quieras, siempre que sea único en tu conjunto de datos. Si el nombre no es único, no se podrá crear el almacén de datos.
- Haz clic en Siguiente.
-
Si quieres configurar un tema de Pub/Sub para el almacén de datos, haz clic en Recibir notificaciones de Cloud Pub/Sub y selecciona el nombre del tema.
Cuando especifiques un tema de Pub/Sub, introduce el URI completo del tema, tal como se muestra en el siguiente ejemplo:
projects/PROJECT_ID/topics/PUBSUB_TOPIC
- Haz clic en Siguiente.
- Para añadir una o varias etiquetas a la tienda, haz clic en Añadir etiquetas para organizar los almacenes de datos e introduce la etiqueta clave/valor. Para obtener más información sobre las etiquetas de recursos, consulta el artículo Usar etiquetas de recursos.
- Haz clic en Crear.
El nuevo almacén de datos aparece en la lista.
gcloud
Para crear un almacén DICOM, ejecuta el comando gcloud healthcare dicom-stores create
.
Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:
LOCATION
: la ubicación del conjunto de datosDATASET_ID
: el conjunto de datos superior del almacén DICOMDICOM_STORE_ID
: identificador del almacén DICOM. El ID del almacén DICOM debe cumplir los siguientes requisitos:- Un ID único en su conjunto de datos
- Una cadena Unicode de entre 1 y 256 caracteres que incluya lo siguiente:
- Numbers
- Cartas
- Guiones bajos
- Guiones
- Periodos
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud healthcare dicom-stores create DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare dicom-stores create DICOM_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare dicom-stores create DICOM_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Deberías recibir una respuesta similar a la siguiente:
Respuesta
Created dicomStore [DICOM_STORE_ID].
REST
Para crear un almacén DICOM, usa el método projects.locations.datasets.dicomStores.create
.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
PROJECT_ID
: el ID de tu Google Cloud proyectoLOCATION
: la ubicación del conjunto de datosDATASET_ID
: el conjunto de datos superior del almacén DICOMDICOM_STORE_ID
: identificador del almacén DICOM. El ID del almacén DICOM debe cumplir los siguientes requisitos:- Un ID único en su conjunto de datos
- Una cadena Unicode de entre 1 y 256 caracteres que incluya lo siguiente:
- Numbers
- Cartas
- Guiones bajos
- Guiones
- Periodos
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el comando siguiente:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores?dicomStoreId=DICOM_STORE_ID"
PowerShell
Ejecuta el comando siguiente:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores?dicomStoreId=DICOM_STORE_ID" | Select-Object -Expand Content
Explorador de APIs
Abre la página de referencia del método. El panel Explorador de APIs se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Rellena los campos obligatorios y haz clic en Ejecutar.
Deberías recibir una respuesta JSON similar a la siguiente:
Go
Java
Node.js
Python
Editar un almacén DICOM
En los siguientes ejemplos se muestra cómo hacer los siguientes cambios en un almacén DICOM:
- Edita el tema de Pub/Sub al que la API Cloud Healthcare envía notificaciones de cambios en el almacén DICOM.
El almacén DICOM admite el envío de notificaciones a varios suscriptores. En el siguiente ejemplo se muestra cómo añadir un tema de Pub/Sub al almacén DICOM. Se pueden añadir más temas al
dicomStore.notificationConfigs
con un estilo similar. - Edita las etiquetas. Las etiquetas son pares clave-valor que te ayudan a organizar tus Google Cloud recursos.
projects/PROJECT_ID/topics/PUBSUB_TOPIC
Consola
Para editar un almacén DICOM, sigue estos pasos:
- En la Google Cloud consola, ve a la página Conjuntos de datos.
- Selecciona el conjunto de datos que contenga el almacén DICOM que quieras editar.
- En la lista Almacenes de datos, haga clic en el que quiera editar.
- Si quieres configurar un tema de Pub/Sub para el almacén de datos, selecciona el nombre del tema en Seleccionar un tema de Cloud Pub/Sub.
- Para añadir una o varias etiquetas a la tienda, haga clic en Usar etiquetas de recursos. Etiquetas, Añadir etiqueta e introduzca la etiqueta clave-valor. Para obtener más información sobre las etiquetas de recursos, consulta el artículo
- Haz clic en Guardar.
gcloud
Para editar un almacén DICOM, ejecuta el comando gcloud healthcare dicom-stores update
.
La CLI de gcloud no permite editar etiquetas.
Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:
LOCATION
: la ubicación del conjunto de datosDATASET_ID
: el conjunto de datos superior del almacén DICOMDICOM_STORE_ID
: el ID del almacén DICOMPUBSUB_TOPIC
: 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 dicom-stores update DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC
Windows (PowerShell)
gcloud healthcare dicom-stores update DICOM_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION ` --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC
Windows (cmd.exe)
gcloud healthcare dicom-stores update DICOM_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION ^ --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC
Deberías recibir una respuesta similar a la siguiente:
Respuesta
Updated dicomStore [DICOM_STORE_ID]. ... name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID notificationConfig: pubsubTopic: projects/PROJECT_ID/topics/PUBSUB_TOPIC
REST
Para editar un almacén DICOM, usa el método projects.locations.datasets.dicomStores.patch
.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
PROJECT_ID
: el ID de tu Google Cloud proyectoLOCATION
: la ubicación del conjunto de datosDATASET_ID
: el conjunto de datos superior del almacén DICOMDICOM_STORE_ID
: el ID del almacén DICOMPUBSUB_TOPIC
: un tema de Pub/Sub en el que se publican mensajes cuando se produce un evento en un almacén de datos.KEY_1
: la primera clave de etiquetaVALUE_1
: el primer valor de la etiquetaKEY_2
: la segunda clave de etiquetaVALUE_2
: el segundo valor de la etiqueta
Cuerpo JSON de la solicitud:
{ "notificationConfigs": [ { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" } ], "labels": { "KEY_1": "VALUE_1", "KEY_2": "VALUE_2" } }
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json
.
Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual:
cat > request.json << 'EOF' { "notificationConfigs": [ { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" } ], "labels": { "KEY_1": "VALUE_1", "KEY_2": "VALUE_2" } } EOF
A continuación, ejecuta el siguiente comando para enviar tu solicitud 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/dicomStores/DICOM_STORE_ID?updateMask=notificationConfigs,labels"
PowerShell
Guarda el cuerpo de la solicitud en un archivo llamado request.json
.
Ejecuta el siguiente comando en el terminal para crear o sobrescribir este archivo en el directorio actual:
@' { "notificationConfigs": [ { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" } ], "labels": { "KEY_1": "VALUE_1", "KEY_2": "VALUE_2" } } '@ | Out-File -FilePath request.json -Encoding utf8
A continuación, ejecuta el siguiente comando para enviar tu solicitud 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/dicomStores/DICOM_STORE_ID?updateMask=notificationConfigs,labels" | Select-Object -Expand Content
Explorador de APIs
Copia el cuerpo de la solicitud y abre la página de referencia del método. El panel Explorador de APIs 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, rellena los campos obligatorios y haz clic en Ejecutar.
Deberías recibir una respuesta similar a la siguiente.
Si has configurado algún campo del recurso DicomStore
, también aparecerá en la respuesta.
Go
Java
Node.js
Python
Obtener detalles del almacén DICOM
En los siguientes ejemplos se muestra cómo obtener detalles de un almacén DICOM.
Consola
Para ver los detalles de un almacén DICOM, sigue estos pasos:
- En la Google Cloud consola, ve a la página Conjuntos de datos.
- Seleccione el conjunto de datos que contiene el almacén DICOM que quiere ver.
- Haga clic en el nombre del almacén DICOM.
En la pestaña Información general se muestran los detalles del almacén DICOM seleccionado. La pestaña Métricas muestra las métricas de almacén, estudio y serie DICOM. Para obtener más información, consulta Ver métricas de almacén, estudio y serie DICOM.
gcloud
Para obtener detalles sobre un almacén DICOM, ejecuta el comando gcloud healthcare dicom-stores describe
.
Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:
PROJECT_ID
: el ID de tu Google Cloud proyectoLOCATION
: la ubicación del conjunto de datosDATASET_ID
: el conjunto de datos superior del almacén DICOMDICOM_STORE_ID
: el ID del almacén DICOM
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud healthcare dicom-stores describe DICOM_STORE_ID \ --project=PROJECT_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare dicom-stores describe DICOM_STORE_ID ` --project=PROJECT_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare dicom-stores describe DICOM_STORE_ID ^ --project=PROJECT_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Deberías recibir una respuesta similar a la siguiente.
Si has configurado algún campo del recurso DicomStore
, también aparecerá en la respuesta.
Respuesta
name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID
REST
Para obtener detalles sobre un almacén DICOM, usa el método projects.locations.datasets.dicomStores.get
.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
PROJECT_ID
: el ID de tu Google Cloud proyectoLOCATION
: la ubicación del conjunto de datosDATASET_ID
: el conjunto de datos superior del almacén DICOMDICOM_STORE_ID
: el ID del almacén DICOM
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el comando siguiente:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID"
PowerShell
Ejecuta el comando siguiente:
$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/dicomStores/DICOM_STORE_ID" | Select-Object -Expand Content
Explorador de APIs
Abre la página de referencia del método. El panel Explorador de APIs se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Rellena los campos obligatorios y haz clic en Ejecutar.
Deberías recibir una respuesta similar a la siguiente.
Si has configurado algún campo del recurso DicomStore
, también aparecerá en la respuesta.
Go
Java
Node.js
Python
Mostrar los almacenes DICOM de un conjunto de datos
En los siguientes ejemplos se muestra cómo enumerar los almacenes DICOM de un conjunto de datos:
Consola
Para ver los almacenes de datos de un conjunto de datos, sigue estos pasos:
- En la Google Cloud consola, ve a la página Conjuntos de datos.
- Selecciona el conjunto de datos que contiene el almacén de datos que quieres ver.
gcloud
Para enumerar los almacenes DICOM de un conjunto de datos, ejecuta el comando gcloud healthcare dicom-stores list
.
Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:
PROJECT_ID
: el ID de tu Google Cloud proyectoLOCATION
: la ubicación del conjunto de datosDATASET_ID
: el conjunto de datos superior del almacén DICOM
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud healthcare dicom-stores list \ --project=PROJECT_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare dicom-stores list ` --project=PROJECT_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare dicom-stores list ^ --project=PROJECT_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Deberías recibir una respuesta similar a la siguiente.
Si has configurado algún campo del recurso DicomStore
, también aparecerá en la respuesta.
ID LOCATION TOPIC DICOM_STORE_ID LOCATION PUBSUB_TOPIC ...
REST
Para hacer una lista de los almacenes DICOM de un conjunto de datos, usa el método projects.locations.datasets.dicomStores.list
.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
PROJECT_ID
: el ID de tu Google Cloud proyectoLOCATION
: la ubicación del conjunto de datosDATASET_ID
: el conjunto de datos superior del almacén DICOM
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el comando siguiente:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores"
PowerShell
Ejecuta el comando siguiente:
$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/dicomStores" | Select-Object -Expand Content
Explorador de APIs
Abre la página de referencia del método. El panel Explorador de APIs se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Rellena los campos obligatorios y haz clic en Ejecutar.
Deberías recibir una respuesta similar a la siguiente.
Si has configurado algún campo del recurso DicomStore
, también aparecerá en la respuesta.
Go
Java
Node.js
Python
Eliminar un almacén DICOM
En los siguientes ejemplos se muestra cómo eliminar un almacén DICOM:
Consola
Para eliminar un almacén de datos, sigue estos pasos:
- En la Google Cloud consola, ve a la página Conjuntos de datos.
- Selecciona el conjunto de datos que contiene el almacén de datos que quieres eliminar.
- En la lista desplegable Acciones del almacén de datos que quiere eliminar, seleccione Eliminar.
- Para confirmar la acción, escribe el nombre del almacén de datos y haz clic en Eliminar.
gcloud
Para eliminar un almacén DICOM, ejecuta el comando gcloud healthcare dicom-stores delete
.
Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:
LOCATION
: la ubicación del conjunto de datosDATASET_ID
: el conjunto de datos superior del almacén DICOMDICOM_STORE_ID
: el ID del almacén DICOM
Ejecuta el siguiente comando:
Linux, macOS o Cloud Shell
gcloud healthcare dicom-stores delete DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare dicom-stores delete DICOM_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare dicom-stores delete DICOM_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Deleted dicomStore [DICOM_STORE_ID].
REST
Para eliminar un almacén DICOM, utiliza el método projects.locations.datasets.dicomStores.delete
.
Antes de usar los datos de la solicitud, haz las siguientes sustituciones:
PROJECT_ID
: el ID de tu Google Cloud proyectoLOCATION
: la ubicación del conjunto de datosDATASET_ID
: el conjunto de datos superior del almacén DICOMDICOM_STORE_ID
: el ID del almacén DICOM
Para enviar tu solicitud, elige una de estas opciones:
curl
Ejecuta el comando siguiente:
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID"
PowerShell
Ejecuta el comando siguiente:
$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/dicomStores/DICOM_STORE_ID" | Select-Object -Expand Content
Explorador de APIs
Abre la página de referencia del método. El panel Explorador de APIs se abre en la parte derecha de la página. Puedes interactuar con esta herramienta para enviar solicitudes. Rellena los campos obligatorios y haz clic en Ejecutar.
Deberías recibir una respuesta JSON similar a la siguiente: