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 do DICOMweb na API Cloud Healthcare ou importar e exportar instâncias DICOM usando Google Cloud services.
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:
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.
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:
: o local do conjunto de dados;LOCATION
: o conjunto de dados pai do armazenamento DICOMDATASET_ID
: um identificador para o armazenamento DICOM. O ID do armazenamento DICOM precisa ter o seguinte:DICOM_STORE_ID - 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 createDICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare dicom-stores createDICOM_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare dicom-stores createDICOM_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Você receberá uma resposta semelhante a esta:
Resposta
Created dicomStore [DICOM_STORE_ID ].
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:
: o ID do projeto Google CloudPROJECT_ID
: o local do conjunto de dados;LOCATION
: o conjunto de dados pai do armazenamento DICOMDATASET_ID
: um identificador para o armazenamento DICOM. O ID do armazenamento DICOM precisa ter o seguinte:DICOM_STORE_ID - 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:
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 "
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
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. Preencha todos os campos obrigatórios e clique em Executar.
Você receberá uma resposta JSON semelhante a esta:
Resposta
{ "name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /dicomStores/DICOM_STORE_ID " }
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 a organizar seus Google Cloud recursos.
projects/PROJECT_ID /topics/PUBSUB_TOPIC
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.
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:
: o local do conjunto de dados;LOCATION
: o conjunto de dados pai do armazenamento DICOMDATASET_ID
: o ID do armazenamento DICOMDICOM_STORE_ID
: um tópico do Pub/Sub em que as mensagens são publicadas quando um evento ocorre em um repositório de dadosPUBSUB_TOPIC
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud healthcare dicom-stores updateDICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --pubsub-topic=projects/PROJECT_ID /topics/PUBSUB_TOPIC
Windows (PowerShell)
gcloud healthcare dicom-stores updateDICOM_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION ` --pubsub-topic=projects/PROJECT_ID /topics/PUBSUB_TOPIC
Windows (cmd.exe)
gcloud healthcare dicom-stores updateDICOM_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
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:
: o ID do projeto Google CloudPROJECT_ID
: o local do conjunto de dados;LOCATION
: o conjunto de dados pai do armazenamento DICOMDATASET_ID
: o ID do armazenamento DICOMDICOM_STORE_ID
: um tópico do Pub/Sub em que as mensagens são publicadas quando um evento ocorre em um repositório de dadosPUBSUB_TOPIC
: a primeira chave de identificadorKEY_1
: o primeiro valor do rótuloVALUE_1
: a segunda chave do rótuloKEY_2
: o segundo valor do rótuloVALUE_2
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:
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"
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
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.
Resposta
{ "name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /dicomStores/DICOM_STORE_ID ", "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID /topics/PUBSUB_TOPIC " }, "labels": { "KEY_1 ": "VALUE_1 ", "KEY_2 ": "VALUE_2 " } }
Como receber detalhes do armazenamento DICOM
Os exemplos a seguir mostram como conseguir detalhes sobre um armazenamento DICOM.
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 Acessar métricas de armazenamento, estudo e série DICOM.
Para conferir 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:
: o ID do projeto Google CloudPROJECT_ID
: o local do conjunto de dados;LOCATION
: o conjunto de dados pai do armazenamento DICOMDATASET_ID
: o ID do armazenamento DICOMDICOM_STORE_ID
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud healthcare dicom-stores describeDICOM_STORE_ID \ --project=PROJECT_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare dicom-stores describeDICOM_STORE_ID ` --project=PROJECT_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare dicom-stores describeDICOM_STORE_ID ^ --project=PROJECT_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Você vai receber uma resposta semelhante a esta.
Se você tiver configurado algum campo no recurso DicomStore
, ele também vai aparecer na resposta.
Resposta
name: projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /dicomStores/DICOM_STORE_ID
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:
: o ID do projeto Google CloudPROJECT_ID
: o local do conjunto de dados;LOCATION
: o conjunto de dados pai do armazenamento DICOMDATASET_ID
: o ID do armazenamento DICOMDICOM_STORE_ID
Para enviar a solicitação, escolha uma destas opções:
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 "
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
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. Preencha todos os 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.
Resposta
{ "name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /dicomStores/DICOM_STORE_ID " }
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:
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.
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:
: o ID do projeto Google CloudPROJECT_ID
: o local do conjunto de dados;LOCATION
: o conjunto de dados pai do armazenamento DICOMDATASET_ID
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ê tiver configurado algum campo no recurso DicomStore
, ele também vai aparecer na resposta.
ID LOCATION TOPICDICOM_STORE_ID LOCATION PUBSUB_TOPIC ...
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:
: o ID do projeto Google CloudPROJECT_ID
: o local do conjunto de dados;LOCATION
: o conjunto de dados pai do armazenamento DICOMDATASET_ID
Para enviar a solicitação, escolha uma destas opções:
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"
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
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. Preencha todos os 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.
Resposta
{ "dicomStores": [ { "name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /dicomStores/DICOM_STORE_ID " }, { ... } ] }
Como excluir um armazenamento DICOM
Os exemplos a seguir mostram como excluir um armazenamento DICOM:
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.
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:
: o local do conjunto de dados;LOCATION
: o conjunto de dados pai do armazenamento DICOMDATASET_ID
: o ID do armazenamento DICOMDICOM_STORE_ID
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud healthcare dicom-stores deleteDICOM_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare dicom-stores deleteDICOM_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare dicom-stores deleteDICOM_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Deleted dicomStore [DICOM_STORE_ID ].
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:
: o ID do projeto Google CloudPROJECT_ID
: o local do conjunto de dados;LOCATION
: o conjunto de dados pai do armazenamento DICOMDATASET_ID
: o ID do armazenamento DICOMDICOM_STORE_ID
Para enviar a solicitação, escolha uma destas opções:
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 "
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
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. Preencha todos os campos obrigatórios e clique em Executar.
Você receberá uma resposta JSON semelhante a esta:
Resposta
{}