En esta página, se explica cómo crear, editar, ver y borrar tiendas de Imágenes digitales y comunicación en medicina (DICOM). Para obtener más información sobre cómo la API de Cloud Healthcare se ajusta al estándar DICOM, consulta la Declaración de conformidad de DICOM.
Crea un almacén de DICOM
Antes de crear un almacén de DICOM, debes crear un conjunto de datos.
En los siguientes ejemplos, se muestra cómo crear un almacén DICOM.
Console
Para crear una tienda de DICOM, haz lo siguiente:
- En Cloud Console, ve a la página Conjuntos de datos.
- Abre el conjunto de datos en el que deseas crear una tienda de DICOM.
- Haz clic en Crear almacén de datos.
- Ingresa un nombre de tu elección que sea único en tu conjunto de datos. Si el nombre no es único, la creación del almacén de datos fallará.
- Selecciona DICOM como el tipo de almacén de datos.
-
Si deseas configurar un tema de Pub/Sub para el almacén de datos, escribe 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
- Haga clic en Crear.
El nuevo almacén de datos aparece en la lista.
gcloud
Para crear un almacén de DICOM en el conjunto de datos, ejecuta el comando gcloud healthcare dicom-stores create
.
- El ID del almacén de DICOM debe ser único en el conjunto de datos. Puede ser cualquier string Unicode de 1 a 256 caracteres que conste de números, letras, guiones bajos, guiones y puntos.
- Para notificar un tema de Pub/Sub de los cambios del almacén de DICOM, especifica un nombre de tema de Pub/Sub existente con el argumento
--pubsub-topic
. 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
En el siguiente ejemplo, se muestra cómo crear un almacén de DICOM
gcloud healthcare dicom-stores create DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ [--pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC]
Si la solicitud se realiza correctamente, el símbolo del sistema muestra lo siguiente:
Created dicomStore [DICOM_STORE_ID].
API
Para crear un almacén de DICOM, usa el método projects.locations.datasets.dicomStores.create
.
curl
Para crear un almacén de DICOM, realiza una solicitud POST
y especifica la siguiente información:
- El nombre y la ubicación del conjunto de datos superior
- Un nombre para el almacén de DICOM. El ID del almacén de DICOM debe ser único en su conjunto de datos superior. Puede ser cualquier string Unicode de 1 a 256 caracteres que conste de números, letras, guiones bajos, guiones y puntos.
- Un token de acceso
- De manera opcional, un tema existente de Pub/Sub al que la API de Cloud Healthcare envía notificaciones de los cambios del almacén de DICOM. Consulta Edita un almacén de DICOM para obtener información sobre cómo configurar el tema de Pub/Sub.
En el siguiente ejemplo, se muestra una solicitud POST
mediante curl
:
curl -X POST \ --data "" \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores?dicomStoreId=DICOM_STORE_ID"
Si la solicitud tiene éxito, se mostrará la siguiente respuesta en formato JSON en el servidor:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID" }
PowerShell
Para crear un almacén de DICOM, realiza una solicitud POST
y especifica la siguiente información:
- El nombre y la ubicación del conjunto de datos superior
- Un nombre para el almacén de DICOM. El ID del almacén de DICOM debe ser único en su conjunto de datos superior. Puede ser cualquier string Unicode de 1 a 256 caracteres que conste de números, letras, guiones bajos, guiones y puntos.
- Un token de acceso
- De manera opcional, un tema existente de Pub/Sub al que la API de Cloud Healthcare envía notificaciones de los cambios del almacén de DICOM. Consulta Edita un almacén de DICOM para obtener información sobre cómo configurar el tema de Pub/Sub.
En el siguiente ejemplo, se muestra una solicitud POST
mediante Windows PowerShell.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Post ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores?dicomStoreId=DICOM_STORE_ID" | Select-Object -Expand Content
Si la solicitud tiene éxito, en el servidor se mostrará una respuesta similar a la siguiente muestra en formato JSON:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID" }
Comienza a usarlo
Java
Node.js
Python
Edita un almacén de DICOM
En los siguientes ejemplos, se muestra cómo realizar los siguientes cambios en un almacén de DICOM:
- Edita el tema de Pub/Sub al que la API de Cloud Healthcare envía las notificaciones de los cambios del almacén de DICOM.
- Edita las etiquetas. Las etiquetas son pares clave-valor que te ayudan a organizar tus recursos de Google Cloud.
projects/PROJECT_ID/topics/PUBSUB_TOPICPara que las notificaciones funcionen, debes otorgar permisos adicionales a la cuenta de servicio del Agente de servicios de Cloud Healthcare. Para obtener más información, consulta Permisos de Pub/Sub de DICOM, FHIR y HL7v2.
Console
Cloud Console no admite la edición del tema o las etiquetas de Pub/Sub. En su lugar, usa curl
, Windows PowerShell o tu lenguaje preferido.
gcloud
Para actualizar la tienda de DICOM, ejecuta el comando gcloud healthcare dicom-stores update
.
En la siguiente muestra, se muestra cómo actualizar el tema de Pub/Sub del almacén de DICOM. La herramienta de gcloud
no admite la edición de etiquetas.
gcloud healthcare dicom-stores update DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC
Si la solicitud es exitosa, el símbolo del sistema muestra los detalles del almacén de DICOM, incluido el nuevo nombre del tema:
Updated dicomStore [DICOM_STORE_ID]. name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicom-stores/DICOM_STORE_ID notificationConfig: pubsubTopic: projects/PROJECT_ID/topics/PUBSUB_TOPIC
API
Para editar un almacén de DICOM, usa el método projects.locations.datasets.dicomStores.patch
.
curl
Para editar un almacén DICOM, realiza una solicitud PATCH
y especifica la siguiente información:
- El nombre y la ubicación del conjunto de datos superior
- El nombre del almacén de DICOM
- Los metadatos que deseas actualizar En este ejemplo, el URI calificado para el tema de Pub/Sub y las etiquetas que se actualizarán como una lista delimitada por comas de pares clave-valor.
- Una máscara de actualización
- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud PATCH
mediante curl
:
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data "{ 'notificationConfig': { 'pubsubTopic':'projects/PROJECT_ID/topics/PUBSUB_TOPIC' }, 'labels': { 'KEY1':'VALUE1','KEY2':'VALUE2' } }" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID?updateMask=notificationConfig,labels"
Si la solicitud tiene éxito, en el servidor se mostrará una respuesta similar a la siguiente muestra en formato JSON:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID", "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" }, 'labels': { 'KEY1':'VALUE1','KEY2':'VALUE2' } }
PowerShell
Para editar un almacén DICOM, realiza una solicitud PATCH
y especifica la siguiente información:
- El nombre y la ubicación del conjunto de datos superior
- El nombre del almacén de DICOM
- Los metadatos que deseas actualizar En este ejemplo, el URI calificado para el tema de Pub/Sub y las etiquetas que se actualizarán como una lista delimitada por comas de pares clave-valor.
- Una máscara de actualización
- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud PATCH
mediante Windows PowerShell.
$cred = gcloud auth application-default print-access-token $headers = @{ Authorization = "Bearer $cred" } Invoke-WebRequest ` -Method Patch ` -Headers $headers ` -ContentType: "application/json; charset=utf-8" ` -Body "{ 'notificationConfig': { 'pubsubTopic': 'projects/PROJECT_ID/topics/PUBSUB_TOPIC' }, 'labels': { 'KEY1':'VALUE1','KEY2':'VALUE2' } }" ` -Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID?updateMask=notificationConfig,labels" | Select-Object -Expand Content
Si la solicitud tiene éxito, en el servidor se mostrará una respuesta similar a la siguiente muestra en formato JSON:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID", "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" }, 'labels': { 'KEY1':'VALUE1','KEY2':'VALUE2' } }
Comienza a usarlo
Java
Node.js
Python
Obtén detalles de un almacén de DICOM
En los siguientes ejemplos, se muestra cómo obtener los detalles sobre un almacén de DICOM.
Console
Para ver los detalles de un almacén de DICOM, debes hacer lo siguiente:
- En Cloud Console, ve a la página Conjuntos de datos.
- Haz clic en el ID del conjunto de datos que contiene la tienda de DICOM.
- Haga clic en el nombre del almacén de DICOM.
gcloud
Para obtener más detalles sobre un almacén de DICOM, ejecuta el comando de gcloud healthcare dicom-stores describe
.
En el siguiente ejemplo, se muestra cómo obtener detalles sobre un almacén de DICOM.
gcloud healthcare dicom-stores describe DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Si la solicitud se realiza correctamente, el símbolo del sistema muestra los detalles del almacén de DICOM:
name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicom-stores/DICOM_STORE_ID
API
Para obtener más detalles sobre un almacén de DICOM, usa el método projects.locations.datasets.dicomStores.get
.
curl
Para obtener detalles sobre un almacén de DICOM, realiza una solicitud GET
y especifica la siguiente información:
- El nombre y la ubicación del conjunto de datos superior
- El nombre del almacén de DICOM
- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud GET
mediante curl
:
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID"
Si la solicitud tiene éxito, en el servidor se mostrará una respuesta similar a la siguiente muestra en formato JSON:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID" }
Si configuraste algún campo en el recurso DicomStore
, también aparecerá en la respuesta.
PowerShell
Para obtener detalles sobre un almacén de DICOM, realiza una solicitud GET
y especifica la siguiente información:
- El nombre y la ubicación del conjunto de datos superior
- El nombre del almacén de DICOM
- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud GET
mediante Windows PowerShell.
$cred = gcloud auth application-default 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
Si la solicitud tiene éxito, en el servidor se mostrará una respuesta similar a la siguiente muestra en formato JSON:
{ "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID" }
Si configuraste algún campo en el recurso DicomStore
, también aparecerá en la respuesta.
Comienza a usarlo
Java
Node.js
Python
Enumera las tiendas de DICOM en un conjunto de datos
En los siguientes ejemplos, se muestra cómo enumerar los almacenes DICOM en un conjunto de datos.
Console
Para ver los almacenes de datos en un conjunto de datos, haz lo siguiente:
- En Cloud Console, ve a la página Conjuntos de datos.
- Haz clic en el ID del conjunto de datos cuyos datos deseas ver.
gcloud
Para mostrar una lista de los almacenes de DICOM en un conjunto de datos, ejecuta el comando de gcloud healthcare dicom-stores list
.
gcloud healthcare dicom-stores list --dataset=DATASET_ID
Si la solicitud se realiza de forma correcta, el símbolo del sistema muestra una lista de los almacenes de DICOM:
ID LOCATION TOPIC DICOM_STORE_ID LOCATION projects/PROJECT_ID/topics/PUBSUB_TOPIC
API
Para mostrar una lista de los almacenes DICOM en un conjunto de datos, usa el método projects.locations.datasets.dicomStores.list
.
curl
Para mostrar una lista de los almacenes de DICOM en un conjunto de datos, realiza una solicitud GET
y especifica la siguiente información:
- El nombre y la ubicación del conjunto de datos superior
- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud GET
mediante curl
:
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores"
Si la solicitud tiene éxito, en el servidor se mostrará una respuesta similar a la siguiente muestra en formato JSON:
{ "dicomStores": [ { "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID" }, { ... } ] }
Si configuraste algún campo en el recurso DicomStore
, también aparecerá en la respuesta.
PowerShell
Para mostrar una lista de los almacenes de DICOM en un conjunto de datos, realiza una solicitud GET
y especifica la siguiente información:
- El nombre del conjunto de datos superior
- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud GET
mediante Windows PowerShell.
$cred = gcloud auth application-default 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
Si la solicitud tiene éxito, en el servidor se mostrará una respuesta similar a la siguiente muestra en formato JSON:
{ "dicomStores": [ { "name": "projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID" }, { ... } ] }
Si configuraste algún campo en el recurso DicomStore
, también aparecerá en la respuesta.
Comienza a usarlo
Java
Node.js
Python
Borra un almacén de DICOM
En los siguientes ejemplos, se muestra cómo borrar un almacén de DICOM.
Console
Para borrar un almacén de datos, realiza las siguientes acciones:
- En Cloud Console, ve a la página Conjuntos de datos.
- Haz clic en el ID del conjunto de datos para abrirlo.
- Selecciona el almacén de datos que deseas borrar y, luego, haz clic en Borrar.
- Para confirmar, escribe el nombre del almacén de datos y, luego, haz clic en Borrar.
gcloud
Para borrar un almacén de DICOM, ejecuta el comando de gcloud healthcare dicom-stores delete
:
- Ejecuta el comando
delete
.
gcloud healthcare dicom-stores delete DICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
- Para confirmar, escribe Y.
Si la solicitud se realiza correctamente, el símbolo del sistema muestra la siguiente respuesta:
Deleted dicomStore [DICOM_STORE_ID].
API
Para borrar un almacén de DICOM, usa el método projects.locations.datasets.dicomStores.delete
.
curl
Para borrar un almacén de DICOM, realiza una solicitud DELETE
y especifica la siguiente información:
- El nombre y la ubicación del conjunto de datos superior
- El nombre del almacén de DICOM que se borrará
- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud DELETE
mediante curl
:
curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID"
Si la solicitud se realiza con éxito, el servidor muestra el cuerpo de la respuesta vacío en formato JSON:
{}
PowerShell
Para borrar un almacén de DICOM, realiza una solicitud DELETE
y especifica la siguiente información:
- El nombre y la ubicación del conjunto de datos superior
- El nombre del almacén de DICOM que se borrará
- Un token de acceso
En el siguiente ejemplo, se muestra una solicitud DELETE
mediante Windows PowerShell.
$cred = gcloud auth application-default 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
Si la solicitud se realiza con éxito, el servidor muestra el cuerpo de la respuesta vacío en formato JSON:
{}