Esta página explica como criar, editar, visualizar, listar e excluir armazenamentos de imagens e comunicações digitais em medicina (DICOM, na sigla em inglês).
Os armazenamentos DICOM contêm instâncias DICOM. É possível adicionar e gerenciar instâncias DICOM em um armazenamento DICOM usando a implementação DICOMweb na API Cloud Healthcare ou importar e exportar instâncias DICOM usando os serviços do Google Cloud.
Para mais informações sobre como a API Cloud Healthcare está em conformidade com o padrão DICOM, consulte a Declaração de conformidade DICOM.
Como criar um armazenamento DICOM
Antes de criar um armazenamento DICOM, você precisa criar um conjunto de dados.
Os exemplos a seguir mostram como criar um armazenamento DICOM:
Console
Para criar um armazenamento DICOM:
- No console do Google Cloud, acesse a página "Conjuntos de dados".
- Abra o conjunto de dados em que você quer criar um armazenamento DICOM.
- Clique em Criar armazenamento de dados.
- Selecione DICOM como o tipo de armazenamento de dados.
- Insira um nome de sua escolha que seja exclusivo no conjunto de dados. Se o nome não for exclusivo, a criação do armazenamento de dados falhará.
- Clique em Próxima.
-
Se você quiser configurar um tópico do Pub/Sub para o armazenamento de dados, clique em Receber
notificações do Cloud Pub/Sub e selecione o nome do tópico.
Ao especificar um tópico do Pub/Sub, insira o URI qualificado para o tópico, conforme mostrado no exemplo a seguir:
projects/PROJECT_ID/topics/PUBSUB_TOPIC
- Clique em Próxima.
- Para adicionar um ou mais rótulos ao armazenamento, clique em Adicionar rótulos para organizar seus armazenamentos de dados e insira o rótulo de chave-valor. Saiba mais sobre rótulos de recursos em Como usar rótulos de recursos.
- Clique em Criar.
O novo armazenamento de dados é exibido na lista.
gcloud
Para criar um armazenamento DICOM, execute o comando gcloud healthcare dicom-stores create
.
Antes de usar os dados do comando abaixo, faça estas substituições:
LOCATION
: o local do conjunto de dados;DATASET_ID
: o conjunto de dados pai do armazenamento DICOMDICOM_STORE_ID
: um identificador para o armazenamento DICOM. O ID do armazenamento DICOM precisa ter o seguinte:- Um ID exclusivo no conjunto de dados.
- Uma string Unicode de 1 a 256 caracteres, que consiste no seguinte:
- Números
- Letras
- Sublinhados
- Traços
- Pontos
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
Você receberá uma resposta semelhante a esta:
Resposta
Created dicomStore [DICOM_STORE_ID].
REST
Para criar um armazenamento DICOM, use o método projects.locations.datasets.dicomStores.create
.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID
: o ID do seu projeto do Google Cloud;LOCATION
: o local do conjunto de dados;DATASET_ID
: o conjunto de dados pai do armazenamento DICOMDICOM_STORE_ID
: um identificador para o armazenamento DICOM. O ID do armazenamento DICOM precisa ter o seguinte:- Um ID exclusivo no conjunto de dados.
- Uma string Unicode de 1 a 256 caracteres, que consiste no seguinte:
- Números
- Letras
- Sublinhados
- Traços
- Pontos
Para enviar a solicitação, 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
APIs Explorer
Abra o página de referência do método. O painel "APIs Explorer" é aberto no lado direito da página. Interaja com essa ferramenta para enviar solicitações. Preencha todos os campos obrigatórios e clique em Executar.
Você receberá uma resposta JSON semelhante a esta:
Go
Java
Node.js
Python
Como editar um armazenamento DICOM
Os exemplos a seguir mostram como fazer as seguintes alterações em um armazenamento DICOM:
- Edite o tópico Pub/Sub para o qual a API Cloud Healthcare envia notificações de alterações no armazenamento DICOM.
- Edite os rótulos. Os rótulos são pares de chave-valor que ajudam você a organizar seus recursos do Google Cloud.
projects/PROJECT_ID/topics/PUBSUB_TOPIC
Console
Para editar um armazenamento DICOM, siga estas etapas:
- No console do Google Cloud, acesse a página Conjuntos de dados.
- Selecione o conjunto de dados que contém o armazenamento DICOM que você quer editar.
- Na lista Armazenamento de dados, clique no armazenamento de dados que você quer editar.
- Para configurar um tópico do Pub/Sub para o armazenamento de dados, selecione o nome do tópico em Selecionar um tópico do Cloud Pub/Sub.
- Para adicionar um ou mais rótulos ao armazenamento, clique em Como usar rótulos de recursos. Rótulos, clique em Adicionar rótulo e insira o rótulo de chave/valor. Saiba mais sobre rótulos de recursos em
- Clique em Salvar.
gcloud
Para editar um armazenamento DICOM, execute o comando gcloud healthcare dicom-stores update
.
A CLI gcloud não é compatível com a edição de rótulos.
Antes de usar os dados do comando abaixo, faça estas substituições:
LOCATION
: o local do conjunto de dados;DATASET_ID
: o conjunto de dados pai do armazenamento DICOMDICOM_STORE_ID
: o ID do armazenamento DICOMPUBSUB_TOPIC
: um tópico do Pub/Sub em que as mensagens são publicadas quando um evento ocorre em um 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
Você receberá uma resposta semelhante a esta:
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 armazenamento DICOM, use o método projects.locations.datasets.dicomStores.patch
.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID
: o ID do seu projeto do Google Cloud;LOCATION
: o local do conjunto de dados;DATASET_ID
: o conjunto de dados pai do armazenamento DICOMDICOM_STORE_ID
: o ID do armazenamento DICOMPUBSUB_TOPIC
: um tópico do Pub/Sub em que as mensagens são publicadas quando um evento ocorre em um repositório de dados.KEY_1
: a primeira chave de rótulo.VALUE_1
: o valor do primeiro rótulo.KEY_2
: a segunda chave do rótuloVALUE_2
: o segundo valor do rótulo
Corpo JSON da solicitação:
{ "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" }, "labels": { "KEY_1": "VALUE_1", "KEY_2": "VALUE_2" } }
Para enviar a solicitação, escolha uma destas opções:
curl
Salve o corpo da solicitação em um arquivo chamado request.json
.
Execute o comando a seguir no terminal para criar ou substituir
esse arquivo no diretório atual:
cat > request.json << 'EOF' { "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" }, "labels": { "KEY_1": "VALUE_1", "KEY_2": "VALUE_2" } } EOF
Depois execute o comando a seguir para enviar a solicitação 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=notificationConfig,labels"
PowerShell
Salve o corpo da solicitação em um arquivo chamado request.json
.
Execute o comando a seguir no terminal para criar ou substituir
esse arquivo no diretório atual:
@' { "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC" }, "labels": { "KEY_1": "VALUE_1", "KEY_2": "VALUE_2" } } '@ | Out-File -FilePath request.json -Encoding utf8
Depois execute o comando a seguir para enviar a solicitação 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=notificationConfig,labels" | Select-Object -Expand Content
APIs Explorer
Copie o corpo da solicitação e abra a página de referência do método. O painel "APIs Explorer" é aberto no lado direito da página. Interaja com essa ferramenta para enviar solicitações. Cole o corpo da solicitação nessa ferramenta, preencha todos os outros campos obrigatórios e clique em Executar.
Você vai receber uma resposta semelhante a esta.
Se você tiver configurado algum campo no recurso DicomStore
, ele também vai aparecer na resposta.
Go
Java
Node.js
Python
Como receber detalhes do armazenamento DICOM
Os exemplos a seguir mostram como conseguir detalhes sobre um armazenamento DICOM.
Console
Para ver os detalhes de um armazenamento DICOM:
- No console do Google Cloud, acesse a página Conjuntos de dados.
- Selecione o conjunto de dados que contém o armazenamento DICOM que você quer visualizar.
- Clique no nome do armazenamento DICOM.
A guia Visão geral mostra os detalhes do armazenamento DICOM selecionado. A guia Métricas mostra as métricas do armazenamento, do estudo e da série DICOM. Para mais informações, consulte Visualizar o repositório DICOM, o estudo DICOM e o DICOM métricas da série.
gcloud
Para acessar detalhes sobre um armazenamento DICOM, execute o comando gcloud healthcare dicom-stores describe
.
Antes de usar os dados do comando abaixo, faça estas substituições:
PROJECT_ID
: o ID do seu projeto do Google Cloud;LOCATION
: o local do conjunto de dados;DATASET_ID
: o conjunto de dados pai do armazenamento DICOMDICOM_STORE_ID
: o ID do armazenamento 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
Você vai receber uma resposta semelhante a esta.
Se você configurou campos no recurso DicomStore
, eles também vão aparecer na resposta.
Resposta
name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/dicomStores/DICOM_STORE_ID
REST
Para ver detalhes sobre um armazenamento DICOM, use o método projects.locations.datasets.dicomStores.get
.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID
: o ID do seu projeto do Google Cloud;LOCATION
: o local do conjunto de dados;DATASET_ID
: o conjunto de dados pai do armazenamento DICOMDICOM_STORE_ID
: o ID do repositório DICOM
Para enviar a solicitação, 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
APIs Explorer
Abra o página de referência do método. O painel "APIs Explorer" é aberto no lado direito da página. Interaja com essa ferramenta para enviar solicitações. Preencha todos os campos obrigatórios e clique em Executar.
Você vai receber uma resposta semelhante a esta.
Se você configurou campos no recurso DicomStore
, eles também vão aparecer na resposta.
Go
Java
Node.js
Python
Como listar os armazenamentos DICOM em um conjunto de dados
Os exemplos a seguir mostram como listar os armazenamentos DICOM em um conjunto de dados:
Console
Para visualizar os armazenamentos de dados em um conjunto de dados:
- No console do Google Cloud, acesse a página Conjuntos de dados.
- Selecione o conjunto de dados que contém o repositório de dados que você quer visualizar.
gcloud
Para listar os armazenamentos DICOM em um conjunto de dados, execute o comando gcloud healthcare dicom-stores list
.
Antes de usar os dados do comando abaixo, faça estas substituições:
PROJECT_ID
: o ID do seu projeto do Google Cloud;LOCATION
: o local do conjunto de dados;DATASET_ID
: o conjunto de dados pai do armazenamento 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
Você vai receber uma resposta semelhante a esta.
Se você configurou campos no recurso DicomStore
, eles também vão aparecer na resposta.
ID LOCATION TOPIC DICOM_STORE_ID LOCATION PUBSUB_TOPIC ...
REST
Para listar os armazenamentos DICOM em um conjunto de dados, use o método projects.locations.datasets.dicomStores.list
.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID
: o ID do seu projeto do Google Cloud;LOCATION
: o local do conjunto de dados;DATASET_ID
: o conjunto de dados pai do armazenamento DICOM
Para enviar a solicitação, 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
APIs Explorer
Abra o página de referência do método. O painel "APIs Explorer" é aberto no lado direito da página. Interaja com essa ferramenta para enviar solicitações. Preencha todos os campos obrigatórios e clique em Executar.
Você vai receber uma resposta semelhante a esta.
Se você configurou algum campo no recurso DicomStore
, ele também vai aparecer na resposta.
Go
Java
Node.js
Python
Como excluir um armazenamento DICOM
Os exemplos a seguir mostram como excluir um armazenamento DICOM:
Console
Para excluir um armazenamento de dados:
- No console do Google Cloud, acesse a página Conjuntos de dados.
- Selecione o conjunto de dados que contém o armazenamento de dados que você quer excluir.
- Escolha Excluir na lista suspensa Ações para o armazenamento de dados que você quer excluir.
- Para confirmar, digite o nome do armazenamento de dados e clique em Excluir.
gcloud
Para excluir um armazenamento DICOM, execute o comando gcloud healthcare dicom-stores delete
.
Antes de usar os dados do comando abaixo, faça estas substituições:
LOCATION
: o local do conjunto de dados;DATASET_ID
: o conjunto de dados pai do armazenamento DICOMDICOM_STORE_ID
: o ID do armazenamento 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 excluir um armazenamento DICOM, use o método projects.locations.datasets.dicomStores.delete
.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID
: o ID do seu projeto do Google Cloud;LOCATION
: o local do conjunto de dados;DATASET_ID
: o conjunto de dados pai do armazenamento DICOMDICOM_STORE_ID
: o ID do repositório DICOM
Para enviar a solicitação, 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
APIs Explorer
Abra o página de referência do método. O painel "APIs Explorer" é aberto no lado direito da página. Interaja com essa ferramenta para enviar solicitações. Preencha todos os campos obrigatórios e clique em Executar.
Você receberá uma resposta JSON semelhante a esta: