Esta página explica como criar, editar, ver, listar e eliminar armazenamentos de imagens digitais e comunicações na medicina (DICOM).
Os armazenamentos DICOM contêm instâncias DICOM. Pode adicionar e gerir instâncias DICOM numa loja DICOM através da implementação DICOMweb na API Cloud Healthcare ou pode importar e exportar instâncias DICOM através de Google Cloud serviços.
Para mais informações sobre a forma como a Cloud Healthcare API está em conformidade com a norma DICOM, consulte a declaração de conformidade com a norma DICOM.
Criar um arquivo DICOM
Antes de poder criar um arquivo DICOM, tem de criar um conjunto de dados.
Os exemplos seguintes mostram como criar um arquivo DICOM:
Consola
Para criar um arquivo DICOM:
- Na Google Cloud consola, aceda à página Conjuntos de dados.
- Selecione o conjunto de dados onde quer criar um arquivo DICOM.
- Clique em Criar arquivo de dados.
- Selecione DICOM como o tipo de armazenamento de dados.
- Introduza um nome à sua escolha que seja exclusivo no conjunto de dados. Se o nome não for exclusivo, a criação do repositório de dados falha.
- Clicar em Seguinte.
-
Se quiser configurar um tópico do Pub/Sub para o arquivo de dados, clique em Receber
notificações do Cloud Pub/Sub e selecione o nome do tópico.
Quando especificar um tópico do Pub/Sub, introduza o URI qualificado para o tópico, conforme mostrado no exemplo seguinte:
projects/PROJECT_ID/topics/PUBSUB_TOPIC
- Clicar em Seguinte.
- Para adicionar uma ou mais etiquetas à loja, clique em Adicionar etiquetas para organizar as suas lojas de dados e introduza a etiqueta de chave/valor. Para mais informações sobre etiquetas de recursos, consulte o artigo Usar etiquetas de recursos.
- Clique em Criar.
O novo arquivo de dados é apresentado na lista.
gcloud
Para criar um arquivo DICOM, execute o comando gcloud healthcare dicom-stores create
.
Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:
LOCATION
: a localização do conjunto de dadosDATASET_ID
: o conjunto de dados principal do arquivo DICOMDICOM_STORE_ID
: um identificador para o arquivo DICOM. O ID da loja DICOM tem de ter o seguinte:- Um ID exclusivo no respetivo conjunto de dados
- Uma string Unicode de 1 a 256 carateres que consiste no seguinte:
- Numbers
- Cartas
- Sublinhados
- Traços
- Períodos
Execute o seguinte comando:
Linux, macOS ou 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
Deve receber uma resposta semelhante à seguinte:
Resposta
Created dicomStore [DICOM_STORE_ID].
REST
Para criar um arquivo DICOM, use o método projects.locations.datasets.dicomStores.create
.
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
PROJECT_ID
: o ID do seu Google Cloud projetoLOCATION
: a localização do conjunto de dadosDATASET_ID
: o conjunto de dados principal do arquivo DICOMDICOM_STORE_ID
: um identificador para o arquivo DICOM. O ID da loja DICOM tem de ter o seguinte:- Um ID exclusivo no respetivo conjunto de dados
- Uma string Unicode de 1 a 256 carateres que consiste no seguinte:
- Numbers
- Cartas
- Sublinhados
- Traços
- Períodos
Para enviar o seu pedido, escolha uma destas opções:
curl
Execute o seguinte comando:
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
Execute o seguinte comando:
$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
Abra a página de referência do método. O painel APIs Explorer é aberto no lado direito da página. Pode interagir com esta ferramenta para enviar pedidos. Preencha todos os campos obrigatórios e clique em Executar.
Deve receber uma resposta JSON semelhante à seguinte:
Go
Java
Node.js
Python
Editar um arquivo DICOM
Os exemplos seguintes mostram como fazer as seguintes alterações a um arquivo DICOM:
- Edite o tópico do Pub/Sub para o qual a API Cloud Healthcare envia notificações de alterações da loja DICOM.
O armazenamento DICOM suporta o envio de notificações para vários subscritores. O exemplo seguinte mostra como adicionar um tópico do Pub/Sub ao DICOM Store. Podem ser adicionados tópicos adicionais ao
dicomStore.notificationConfigs
usando um estilo semelhante. - Edite as etiquetas. Os marcadores são pares de chave-valor que ajudam a organizar os seus Google Cloud recursos.
projects/PROJECT_ID/topics/PUBSUB_TOPIC
Consola
Para editar um arquivo DICOM, conclua os seguintes passos:
- Na Google Cloud consola, aceda à página Conjuntos de dados.
- Selecione o conjunto de dados que contém o arquivo DICOM que quer editar.
- Na lista Armazenamentos de dados, clique no armazenamento de dados que quer editar.
- Se quiser configurar um tópico do Pub/Sub para o arquivo de dados, selecione o nome do tópico em Selecionar um tópico do Cloud Pub/Sub.
- Para adicionar uma ou mais etiquetas à loja, clique em Usar etiquetas de recursos. Etiquetas, clique em Adicionar etiqueta e introduza a etiqueta de chave/valor. Para mais informações sobre etiquetas de recursos, consulte o artigo
- Clique em Guardar.
gcloud
Para editar um arquivo DICOM, execute o comando gcloud healthcare dicom-stores update
.
A CLI gcloud não suporta a edição de etiquetas.
Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:
LOCATION
: a localização do conjunto de dadosDATASET_ID
: o conjunto de dados principal do arquivo DICOMDICOM_STORE_ID
: o ID da loja DICOMPUBSUB_TOPIC
: um tópico do Pub/Sub para o qual as mensagens são publicadas quando ocorre um evento num repositório de dados
Execute o seguinte comando:
Linux, macOS ou 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
Deve receber uma resposta semelhante à seguinte:
Resposta
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 um arquivo DICOM, use o método projects.locations.datasets.dicomStores.patch
.
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
PROJECT_ID
: o ID do seu Google Cloud projetoLOCATION
: a localização do conjunto de dadosDATASET_ID
: o conjunto de dados principal do arquivo DICOMDICOM_STORE_ID
: o ID da loja DICOMPUBSUB_TOPIC
: um tópico do Pub/Sub para o qual as mensagens são publicadas quando ocorre um evento num repositório de dadosKEY_1
: a primeira chave de etiquetaVALUE_1
: o primeiro valor da etiquetaKEY_2
: a segunda chave da etiquetaVALUE_2
: o valor da segunda etiqueta
Corpo JSON do pedido:
{ "notificationConfigs": [ { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" } ], "labels": { "KEY_1": "VALUE_1", "KEY_2": "VALUE_2" } }
Para enviar o seu pedido, escolha uma destas opções:
curl
Guarde o corpo do pedido num ficheiro denominado request.json
.
Execute o seguinte comando no terminal para criar ou substituir
este ficheiro no diretório atual:
cat > request.json << 'EOF' { "notificationConfigs": [ { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" } ], "labels": { "KEY_1": "VALUE_1", "KEY_2": "VALUE_2" } } EOF
Em seguida, execute o seguinte comando para enviar o seu pedido 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
Guarde o corpo do pedido num ficheiro denominado request.json
.
Execute o seguinte comando no terminal para criar ou substituir
este ficheiro no diretório atual:
@' { "notificationConfigs": [ { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" } ], "labels": { "KEY_1": "VALUE_1", "KEY_2": "VALUE_2" } } '@ | Out-File -FilePath request.json -Encoding utf8
Em seguida, execute o seguinte comando para enviar o seu pedido 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
Copie o corpo do pedido e abra a página de referência do método. O painel APIs Explorer é aberto no lado direito da página. Pode interagir com esta ferramenta para enviar pedidos. Cole o corpo do pedido nesta ferramenta, preencha todos os outros campos obrigatórios e clique em Executar.
Deve receber uma resposta semelhante à seguinte.
Se configurou campos no recurso DicomStore
, estes também aparecem na resposta.
Go
Java
Node.js
Python
A obter detalhes da loja DICOM
Os exemplos seguintes mostram como obter detalhes sobre um arquivo DICOM.
Consola
Para ver os detalhes de um arquivo DICOM:
- Na Google Cloud consola, aceda à página Conjuntos de dados.
- Selecione o conjunto de dados que contém o arquivo DICOM que quer ver.
- Clique no nome do arquivo DICOM.
O separador Vista geral mostra os detalhes do arquivo DICOM selecionado. O separador Métricas mostra as métricas de armazenamento DICOM, estudo DICOM e série DICOM. Para mais informações, consulte o artigo Veja métricas de DICOM store, DICOM study e DICOM series.
gcloud
Para obter detalhes sobre um arquivo DICOM, execute o comando gcloud healthcare dicom-stores describe
.
Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:
PROJECT_ID
: o ID do seu Google Cloud projetoLOCATION
: a localização do conjunto de dadosDATASET_ID
: o conjunto de dados principal do arquivo DICOMDICOM_STORE_ID
: o ID da loja DICOM
Execute o seguinte comando:
Linux, macOS ou 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
Deve receber uma resposta semelhante à seguinte.
Se configurou campos no recurso DicomStore
, estes também aparecem na resposta.
Resposta
name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID
REST
Para obter detalhes sobre um arquivo DICOM, use o método projects.locations.datasets.dicomStores.get
.
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
PROJECT_ID
: o ID do seu Google Cloud projetoLOCATION
: a localização do conjunto de dadosDATASET_ID
: o conjunto de dados principal do arquivo DICOMDICOM_STORE_ID
: o ID da loja DICOM
Para enviar o seu pedido, escolha uma destas opções:
curl
Execute o seguinte 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/dicomStores/DICOM_STORE_ID"
PowerShell
Execute o seguinte 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/dicomStores/DICOM_STORE_ID" | Select-Object -Expand Content
Explorador de APIs
Abra a página de referência do método. O painel APIs Explorer é aberto no lado direito da página. Pode interagir com esta ferramenta para enviar pedidos. Preencha todos os campos obrigatórios e clique em Executar.
Deve receber uma resposta semelhante à seguinte.
Se configurou campos no recurso DicomStore
, estes também aparecem na resposta.
Go
Java
Node.js
Python
Apresentar em lista os armazenamentos DICOM num conjunto de dados
Os exemplos seguintes mostram como listar os armazenamentos DICOM num conjunto de dados:
Consola
Para ver os arquivos de dados num conjunto de dados:
- Na Google Cloud consola, aceda à página Conjuntos de dados.
- Selecione o conjunto de dados que contém o arquivo de dados que quer ver.
gcloud
Para listar os armazenamentos DICOM num conjunto de dados, execute o comando gcloud healthcare dicom-stores list
.
Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:
PROJECT_ID
: o ID do seu Google Cloud projetoLOCATION
: a localização do conjunto de dadosDATASET_ID
: o conjunto de dados principal do arquivo DICOM
Execute o seguinte comando:
Linux, macOS ou 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
Deve receber uma resposta semelhante à seguinte.
Se configurou campos no recurso DicomStore
, estes também aparecem na resposta.
ID LOCATION TOPIC DICOM_STORE_ID LOCATION PUBSUB_TOPIC ...
REST
Para apresentar uma lista dos armazenamentos DICOM num conjunto de dados, use o método projects.locations.datasets.dicomStores.list
.
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
PROJECT_ID
: o ID do seu Google Cloud projetoLOCATION
: a localização do conjunto de dadosDATASET_ID
: o conjunto de dados principal do arquivo DICOM
Para enviar o seu pedido, escolha uma destas opções:
curl
Execute o seguinte 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/dicomStores"
PowerShell
Execute o seguinte 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/dicomStores" | Select-Object -Expand Content
Explorador de APIs
Abra a página de referência do método. O painel APIs Explorer é aberto no lado direito da página. Pode interagir com esta ferramenta para enviar pedidos. Preencha todos os campos obrigatórios e clique em Executar.
Deve receber uma resposta semelhante à seguinte.
Se configurou campos no recurso DicomStore
, estes também aparecem na resposta.
Go
Java
Node.js
Python
Eliminar um arquivo DICOM
Os exemplos seguintes mostram como eliminar um arquivo DICOM:
Consola
Para eliminar um arquivo de dados:
- Na Google Cloud consola, aceda à página Conjuntos de dados.
- Selecione o conjunto de dados que contém o arquivo de dados que quer eliminar.
- Escolha Eliminar na lista pendente Ações para o arquivo de dados que quer eliminar.
- Para confirmar, escreva o nome do arquivo de dados e, de seguida, clique em Eliminar.
gcloud
Para eliminar um arquivo DICOM, execute o comando gcloud healthcare dicom-stores delete
.
Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:
LOCATION
: a localização do conjunto de dadosDATASET_ID
: o conjunto de dados principal do arquivo DICOMDICOM_STORE_ID
: o ID da loja DICOM
Execute o seguinte comando:
Linux, macOS ou 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 um arquivo DICOM, use o método projects.locations.datasets.dicomStores.delete
.
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
PROJECT_ID
: o ID do seu Google Cloud projetoLOCATION
: a localização do conjunto de dadosDATASET_ID
: o conjunto de dados principal do arquivo DICOMDICOM_STORE_ID
: o ID da loja DICOM
Para enviar o seu pedido, escolha uma destas opções:
curl
Execute o seguinte 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/dicomStores/DICOM_STORE_ID"
PowerShell
Execute o seguinte 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/dicomStores/DICOM_STORE_ID" | Select-Object -Expand Content
Explorador de APIs
Abra a página de referência do método. O painel APIs Explorer é aberto no lado direito da página. Pode interagir com esta ferramenta para enviar pedidos. Preencha todos os campos obrigatórios e clique em Executar.
Deve receber uma resposta JSON semelhante à seguinte: