[{
"type": "thumb-down",
"id": "hardToUnderstand",
"label":"Hard to understand"
},{
"type": "thumb-down",
"id": "incorrectInformationOrSampleCode",
"label":"Incorrect information or sample code"
},{
"type": "thumb-down",
"id": "missingTheInformationSamplesINeed",
"label":"Missing the information/samples I need"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Translation issue"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]
Guia de início rápido sobre curl ou Windows PowerShell
Nesta página, mostramos como criar um conjunto de dados e um armazenamento DICOM, FHIR ou HL7v2
usando a API Cloud Healthcare com curl e Windows PowerShell.
Na lista Conta de serviço, selecione Nova conta de serviço.
No campo Nome da conta de serviço, insira um nome.
Na lista Papel, selecione
Projeto > Proprietário.
Clique em Criar. O download de um arquivo JSON que contém
sua chave é feito no seu computador.
Defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS
como o caminho do arquivo JSON que contém a chave da conta de serviço.
Essa variável só se aplica à sessão de shell atual. Dessa maneira, se você abrir
uma nova sessão, defina a variável novamente.
Exemplo: Linux ou macOS
Substitua [PATH] pelo caminho do arquivo JSON que
contém a chave da conta de serviço.
Dica: precisa de um prompt de comando? Use o
Google Cloud
Shell. O Google Cloud Shell é um ambiente de linha de comando que
já inclui o SDK do Google Cloud. Dessa maneira, você não
precisa instalá-lo.
O SDK do Google Cloud também vem pré-instalado em máquinas virtuais do
Google Compute Engine.
Crie um conjunto de dados
Os conjuntos de dados são os contêineres básicos que armazenam dados de saúde no Google Cloud.
curl
Para criar um conjunto de dados, faça uma solicitação POST, fornecendo o nome do
conjunto de dados e um token de acesso. O exemplo a seguir mostra uma solicitação POST
usando curl.
Ao definir a variável LOCATION, use
us-central1, us-west2, europe-west2,
europe-west4, europe-west6, northamerica-northeast1,
southamerica-east1, asia-east2, asia-northeast1,
asia-southeast1, australia-southeast1 ou us.
Se a solicitação for bem-sucedida, o servidor retornará a resposta no formato JSON. A resposta contém um identificador para uma
operação de longa duração.
Operações de longa duração são retornadas quando as chamadas de método podem demorar um tempo
significativo para serem concluídas.
Se a solicitação for bem-sucedida, o servidor retornará uma resposta com o status da operação no formato JSON. Observe que
a operação foi concluída quando a resposta contém "done": true.
Para criar um conjunto de dados, faça uma solicitação POST, fornecendo o nome do conjunto de dados
e um token de acesso. O exemplo a seguir mostra uma solicitação POST
usando o Windows PowerShell.
Ao definir a variável LOCATION, use
us-central1, us-west2, europe-west2,
europe-west4, europe-west6, northamerica-northeast1,
southamerica-east1, asia-east2, asia-northeast1,
asia-southeast1, australia-southeast1 ou us.
Se a solicitação for bem-sucedida, o servidor retornará a resposta no formato JSON. A resposta contém um identificador para uma
operação de longa duração.
Operações de longa duração são retornadas quando as chamadas de método podem demorar um tempo
significativo para serem concluídas.
Se a solicitação for bem-sucedida, o servidor retornará uma resposta com o status da
operação no formato JSON. Observe que
a operação foi concluída quando a resposta contém "done": true.
Você pode ver detalhes sobre o conjunto de dados e verificar se ele foi criado.
curl
Para ver detalhes sobre um conjunto de dados, faça uma solicitação GET e forneça o nome do
conjunto de dados e um token de acesso. O exemplo a seguir mostra uma solicitação GET
usando curl.
Para ver detalhes sobre um conjunto de dados, faça uma solicitação GET e forneça o nome do
conjunto de dados e um token de acesso. O exemplo a seguir mostra uma solicitação GET
usando curl.
Criar e gerenciar armazenamentos DICOM, FHIR e HL7v2
Para concluir este guia de início rápido, expanda a seção relevante:
Como criar e gerenciar lojas DICOM
Criar um armazenamento DICOM
Os armazenamentos DICOM existem dentro de conjuntos de dados e armazenam
instâncias DICOM. Você pode criar um armazenamento DICOM usando o
método
projects.locations.datasets.dicomStores.create.
curl
Para criar um armazenamento DICOM, faça uma solicitação POST. Forneça as seguintes informações
na solicitação:
O nome do conjunto de dados pai
Um nome para o armazenamento DICOM
Um token de acesso
O nome do armazenamento DICOM precisa ser exclusivo no conjunto de dados pai
do armazenamento DICOM. O nome pode ser qualquer string Unicode de 1 a 256 caracteres que contenha
números, letras, sublinhados, traços e pontos.
Opcionalmente, é possível configurar um tópico existente do Pub/Sub para o qual a
API Cloud Healthcare envia notificações de alterações no armazenamento DICOM.
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
O exemplo a seguir mostra uma solicitação POST usando curl.
Para criar um armazenamento DICOM, faça uma solicitação POST. Forneça as seguintes informações
na solicitação:
O nome do conjunto de dados pai
O nome do armazenamento DICOM
Um token de acesso
O nome do armazenamento DICOM precisa ser exclusivo no conjunto de dados pai
do armazenamento DICOM. O nome pode ser qualquer string Unicode de 1 a 256 caracteres que contenha
números, letras, sublinhados, traços e pontos.
Opcionalmente, é possível configurar um tópico existente do Pub/Sub para o qual a
API Cloud Healthcare envia notificações de alterações no armazenamento DICOM.
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
O exemplo a seguir mostra uma solicitação POST usando o Windows PowerShell.
Os exemplos a seguir mostram como atualizar o tópico e os rótulos do Pub/Sub para o
armazenamento DICOM.
curl
Para editar um armazenamento DICOM, faça uma solicitação PATCH. Forneça as seguintes
informações na solicitação:
O nome do conjunto de dados pai
O nome do armazenamento DICOM
Os metadados a serem atualizados. Nesta amostra, o URI qualificado para o tópico do Pub/Sub e
os rótulos que serão atualizados como uma lista delimitada por vírgulas de pares de chave-valor.
Uma máscara de atualização
Um token de acesso
O exemplo a seguir mostra uma solicitação PATCH usando curl.
Para editar um armazenamento DICOM, faça uma solicitação PATCH. Forneça as seguintes
informações na solicitação:
O nome do conjunto de dados pai
O nome do armazenamento DICOM
Os metadados a serem atualizados. Neste exemplo, o URI qualificado para o tópico do Pub/Sub e
os rótulos a serem atualizados como uma lista delimitada por vírgulas de pares de chave-valor.
Uma máscara de atualização
Um token de acesso
O exemplo a seguir mostra uma solicitação PATCH usando o Windows PowerShell.
Os armazenamentos de FHIR existem dentro de conjuntos de dados e armazenam dados
FHIR. Para criar um armazenamento de FHIR, use o
método
projects.locations.datasets.fhirStores.create.
curl
Para criar um armazenamento FHIR, faça uma solicitação POST. Forneça as seguintes informações
na solicitação:
O nome do conjunto de dados pai
Um nome para o armazenamento FHIR
A versão do armazenamento FHIR: DSTU2, STU3 ou R4
Um token de acesso
O nome do armazenamento FHIR precisa ser exclusivo no conjunto de dados pai
do armazenamento FHIR. O nome pode ser qualquer string Unicode de 1 a 256 caracteres que contenha
números, letras, sublinhados, traços e pontos.
Como opção, é possível configurar um tópico existente do Pub/Sub que receberá notificações da
API Cloud Healthcare referentes a alterações no armazenamento FHIR.
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
O exemplo a seguir mostra uma solicitação POST usando curl.
Para criar um armazenamento FHIR, faça uma solicitação POST. Forneça as seguintes informações
na solicitação:
O nome do conjunto de dados pai
Um nome para o armazenamento FHIR
A versão do armazenamento FHIR: DSTU2, STU3 ou R4
Um token de acesso
O nome do armazenamento FHIR precisa ser exclusivo no conjunto de dados pai
do armazenamento FHIR. O nome pode ser qualquer string Unicode de 1 a 256 caracteres que contenha
números, letras, sublinhados, traços e pontos.
Como opção, é possível configurar um tópico existente do Pub/Sub que receberá notificações da
API Cloud Healthcare referentes a alterações no armazenamento FHIR.
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
O exemplo a seguir mostra uma solicitação POST usando o Windows PowerShell.
As amostras a seguir mostram como atualizar o tópico do Pub/Sub e os rótulos para o
armazenamento FHIR.
curl
Para editar um armazenamento FHIR, faça uma solicitação PATCH. Forneça as seguintes
informações na solicitação:
O nome do conjunto de dados pai
O nome do armazenamento FHIR
Os metadados a serem atualizados. Nesta amostra, o URI qualificado para o tópico do Pub/Sub e
os rótulos que serão atualizados como uma lista delimitada por vírgulas de pares de chave-valor.
Uma máscara de atualização
Um token de acesso
O exemplo a seguir mostra uma solicitação PATCH usando curl.
Para editar um armazenamento FHIR, faça uma solicitação PATCH. Forneça as seguintes
informações na solicitação:
O nome do conjunto de dados pai
O nome do armazenamento FHIR
Os metadados a serem atualizados. Neste exemplo, o URI qualificado para o tópico do Pub/Sub e
os rótulos a serem atualizados como uma lista delimitada por vírgulas de pares de chave-valor.
Uma máscara de atualização
Um token de acesso
O exemplo a seguir mostra uma solicitação PATCH usando o Windows PowerShell.
Os armazenamentos HL7v2 existem dentro de conjuntos de dados e armazenam dados
HL7v2. Você pode criar um armazenamento HL7v2 usando o
método
projects.locations.datasets.hl7V2Stores.create.
curl
Para criar um armazenamento HL7v2, faça uma solicitação POST. Forneça as seguintes informações
na solicitação:
O nome do conjunto de dados pai
Um nome para o armazenamento HL7v2
Um token de acesso
O nome do armazenamento HL7v2 precisa ser exclusivo no conjunto de dados pai
do armazenamento HL7v2. O nome pode ser qualquer string Unicode de 1 a 256 caracteres que contenha
números, letras, sublinhados, traços e pontos.
Como opção, você pode configurar um ou mais tópicos existentes do Pub/Sub
e um filtro para o tópico para o qual a
API Cloud Healthcare envia notificações de alterações do armazenamento HL7v2.
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
O exemplo a seguir mostra uma solicitação POST usando curl.
Para criar um armazenamento HL7v2, faça uma solicitação POST. Forneça as seguintes informações
na solicitação:
O nome do conjunto de dados pai
Um nome para o armazenamento HL7v2
Um token de acesso
O nome do armazenamento HL7v2 precisa ser exclusivo no conjunto de dados pai
do armazenamento HL7v2. O nome pode ser qualquer string Unicode de 1 a 256 caracteres que contenha
números, letras, sublinhados, traços e pontos.
Opcionalmente, é possível configurar um ou mais tópicos existentes do Pub/Sub e
um filtro para o tópico ao qual a
API Cloud Healthcare envia notificações de alterações do armazenamento HL7v2.
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
O exemplo a seguir mostra uma solicitação POST usando o Windows PowerShell.
Os exemplos a seguir mostram como atualizar o tópico, o filtro e os rótulos do Pub/Sub para o
armazenamento HL7v2.
curl
Para editar um armazenamento HL7v2, faça uma solicitação PATCH. Forneça as seguintes
informações na solicitação:
O nome do conjunto de dados pai
O nome do armazenamento HL7v2
Os metadados a serem atualizados. Nesta amostra, o URI qualificado para o tópico Pub/Sub, o
filtro de tópico e
os rótulos a serem atualizados como uma lista delimitada por vírgulas de pares de chave-valor.
Uma máscara de atualização
Um token de acesso
O exemplo a seguir mostra uma solicitação PATCH usando curl.
Para editar um armazenamento HL7v2, faça uma solicitação PATCH. Forneça as seguintes
informações na solicitação:
O nome do conjunto de dados pai
O nome do armazenamento HL7v2
Os metadados a serem atualizados. Neste exemplo, o URI qualificado para o tópico do Pub/Sub, o
filtro de tópico e
os rótulos que serão atualizados como uma lista delimitada por vírgulas de pares de chave-valor.
Uma máscara de atualização
Um token de acesso
O exemplo a seguir mostra uma solicitação PATCH usando o Windows PowerShell.
É possível limpar os recursos que foram criados no Google Cloud para evitar cobranças na conta do Google Cloud pelos recursos usados neste tutorial.
Se você criou um novo projeto para este tutorial, siga as etapas em Excluir o projeto. Caso contrário, siga as
etapas em Excluir o conjunto de dados.
Exclua o projeto
No Console do Cloud, acesse a página Gerenciar recursos:
Na lista de projetos, selecione o projeto que você
quer excluir e clique em Excluir .
Na caixa de diálogo, digite o ID do projeto e clique em Encerrar para excluí-lo.
Excluir o conjunto de dados
Se você não precisar mais do conjunto de dados criado neste guia de início rápido, poderá excluí-lo. Excluir um conjunto de dados exclui permanentemente o conjunto de dados e todos os armazenamentos
FHIR, HL7v2 ou DICOM que ele contém.
curl
Para excluir um conjunto de dados, faça uma solicitação DELETE, fornecendo o nome do conjunto de dados
e um token de acesso. Na amostra a seguir, você verá uma solicitação DELETE usando curl.
Se a solicitação for bem-sucedida, o servidor retornará a resposta no formato JSON:
{}
PowerShell
Para excluir um conjunto de dados, faça uma solicitação DELETE, fornecendo o nome do conjunto de dados
e um token de acesso. Na amostra a seguir, você verá uma solicitação DELETE usando o Windows PowerShell.