Nesta página, explicamos como criar, editar, visualizar, listar e excluir armazenamentos de recursos rápidos de interoperabilidade de saúde (FHIR, na sigla em inglês). Os armazenamentos de FHIR contêm recursos de FHIR, como recursos "Declaração", "Pacientes", "Medicação" e muito mais.
A API Cloud Healthcare suporta as seguintes versões de FHIR:
Como criar um armazenamento FHIR
Antes de criar um armazenamento FHIR, você precisa criar um conjunto de dados.
Os exemplos a seguir mostram como criar um armazenamento FHIR usando o
método
projects.locations.datasets.fhirStores.create
.
Console
Para criar um repositório FHIR, siga estas etapas:
- No console do Google Cloud, acesse a página Conjuntos de dados.
- Selecione o conjunto de dados em que você quer criar um armazenamento de FHIR.
- Clique em Criar armazenamento de dados.
- Selecione FHIR como o tipo de repositório de dados.
- Insira um nome exclusivo no conjunto de dados. Se o nome não for exclusivo, a criação do repositório FHIR falhará.
- Clique em Próxima.
- Para configurar o armazenamento FHIR, faça o seguinte:
- Escolha a versão de FHIR para o armazenamento de FHIR, DSTU2, STU3 ou R4.
- Selecione as configurações avançadas aplicáveis:
- Permitir criação de atualização: selecione para permitir a criação de um novo recurso usando uma operação de atualização com um ID especificado pelo usuário.
- Verificações de integridade referencial: selecione para ativar a integridade referencial neste armazenamento. Não será possível mudar isso depois de criar a loja.
- Controle de versões de recursos: selecione para registrar automaticamente as versões históricas dos recursos. Não será possível mudar isso depois de criar a loja.
- Selecione as configurações de validação do perfil aplicáveis nos campos a seguir. Para mais informações,
consulte ValidationConfig:
- Ativar validação do perfil: selecione essa opção para ativar a validação do perfil. Para aplicar um guia de implementação ativado no armazenamento FHIR, ative a validação do perfil.
- Ativar validação de campo obrigatória: selecione essa opção para ativar a validação do campo de recursos em relação às definições de estrutura no perfil FHIR.
- Ativar validação do tipo de referência: selecione essa opção para ativar a validação do tipo de referência.
- Ativar validação FHIRPath: selecione essa opção para ativar a verificação de compatibilidade do FHIRPath.
- Clique em Próxima.
- Opcional: para ativar guias de implementação no armazenamento FHIR, faça o seguinte:
- Clique em Ativar guias de implementação.
- Clique e expanda a lista Guias de implementação.
- Selecione os guias de implementação aplicáveis na lista.
Cada guia de implementação é compatível com uma versão específica do FHIR. A lista mostra apenas os guias de implementação compatíveis com a versão do armazenamento FHIR selecionada.
- Clique em Importar IG personalizado do Cloud Storage para importar qualquer pacote de validação de perfil personalizado de um local do Cloud Storage.
- No painel Selecionar objeto, selecione um recurso de pacote de validação de perfil de um local do Cloud Storage. Para mais informações, acesse Usar o console do Google Cloud para ativar os guias de implementação.
- Clique em Selecionar.
- Os guias de implementação selecionados são listados em uma tabela com a versão, URL e status deles.
- Se você ativou os guias de implementação, mas não ativou a validação de perfil, o guia de implementação não vai entrar em vigor.
- Clique em Próxima.
- Opcional: para exportar alterações de recursos para o BigQuery sempre que os recursos FHIR no seu armazenamento
forem criados, atualizados, corrigidos ou excluídos, faça o seguinte:
- Clique em Fazer streaming das alterações de recursos para o BigQuery.
- Clique em Adicionar uma configuração de streaming. Para mais informações sobre streaming do BigQuery, consulte Como fazer streaming de alterações de recursos FHIR para o BigQuery.
- Selecione o nível de profundidade no controle deslizante Profundidade da estrutura recursiva para definir a profundidade de todas as estruturas recursivas no esquema de saída. Por padrão, o valor de profundidade recursiva é 2.
- Clique em Concluído para salvar a configuração de streaming.
- Clique em Próxima.
- Opcional: para configurar um tópico do Pub/Sub para o armazenamento FHIR, faça o seguinte:
- Clique em Receber notificações do Cloud Pub/Sub.
- Clique em Adicionar um tópico 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.
- Opcional: para adicionar rótulos à loja, faça o seguinte:
- Clique em Adicionar rótulos para organizar seus repositórios de dados.
- Digite a chave e o valor do rótulo. Para mais informações sobre rótulos de recursos, consulte Como usar rótulos de recursos.
- Clique em Criar.
O novo armazenamento de FHIR aparece na lista.
gcloud
Para criar um armazenamento de FHIR no conjunto de dados, execute o comando gcloud healthcare fhir-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 de FHIR
- FHIR_STORE_ID: um identificador para o armazenamento de FHIR. O ID do repositório de FHIR precisa ter o seguinte:
- Um ID exclusivo no conjunto de dados.
- Uma string Unicode de um a 256 caracteres, que consiste no seguinte:
- Números
- Letras
- Sublinhados
- Traços
- Pontos
- FHIR_STORE_VERSION: a versão FHIR do armazenamento FHIR. As opções disponíveis são DSTU2, STU3 ou R4.
Execute o comando a seguir:
Linux, macOS ou Cloud Shell
gcloud healthcare fhir-stores create FHIR_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --version=FHIR_STORE_VERSION
Windows (PowerShell)
gcloud healthcare fhir-stores create FHIR_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION ` --version=FHIR_STORE_VERSION
Windows (cmd.exe)
gcloud healthcare fhir-stores create FHIR_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION ^ --version=FHIR_STORE_VERSION
Você receberá uma resposta semelhante a esta:
Resposta
Created fhirStore [FHIR_STORE_ID].
REST
Antes de usar os dados da solicitação, 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 de FHIR
- FHIR_STORE_ID: um identificador para o armazenamento de FHIR. O ID do repositório de FHIR precisa ter o seguinte:
- Um ID exclusivo no conjunto de dados.
- Uma string Unicode de um a 256 caracteres, que consiste no seguinte:
- Números
- Letras
- Sublinhados
- Traços
- Pontos
- FHIR_STORE_VERSION: a versão FHIR do armazenamento FHIR. As opções disponíveis são DSTU2, STU3 ou R4.
Solicitar corpo JSON:
{ "version": "FHIR_STORE_VERSION" }
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' { "version": "FHIR_STORE_VERSION" } EOF
Depois execute o comando a seguir para enviar a solicitação REST:
curl -X POST \
-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/fhirStores?fhirStoreId=FHIR_STORE_ID"
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:
@' { "version": "FHIR_STORE_VERSION" } '@ | 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 POST `
-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/fhirStores?fhirStoreId=FHIR_STORE_ID" | 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ê receberá uma resposta JSON semelhante a esta:
Go
Java
Node.js
Python
Como editar um armazenamento FHIR
Os exemplos a seguir mostram como editar um armazenamento de FHIR. É possível editar um repositório FHIR para modificar propriedades como estas:
- O tópico Pub/Sub para onde a API Cloud Healthcare envia notificações de alterações no armazenamento de FHIR.
- Os rótulos do repositório FHIR. Os rótulos são pares de chave-valor que ajudam você a organizar seus recursos do Google Cloud.
projects/PROJECT_ID/topics/PUBSUB_TOPICPara que as notificações funcionem, você precisa conceder outras permissões à conta de serviço do Agente de serviço do Cloud Healthcare. Para mais informações, consulte Permissões do Pub/Sub de armazenamento DICOM, FHIR e HL7v2.
Console
Para editar um armazenamento de FHIR, siga estas etapas:
No console do Google Cloud, acesse a página Conjuntos de dados.
Acessar Conjuntos de dadosSelecione o conjunto de dados que contém o armazenamento FHIR que você quer editar.
Na lista Armazenamento de dados, selecione o armazenamento de FHIR que você quer editar.
Para editar a configuração do armazenamento, clique em
Configuração do repositório FHIR.Para mais informações sobre as opções de configuração do armazenamento FHIR, consulte Como criar um armazenamento FHIR.
Para editar os guias de implementação da loja, clique em Usar o console do Google Cloud para ativar os guias de implementação.
Guias de implementação e selecione os guias de implementação aplicáveis ou importe um guia de implementação personalizado do Cloud Storage. Para mais informações, consultePara editar os guias de implementação ou aplicar os ativados, ative a validação do perfil na seção Configuração do repositório FHIR.
Para exportar alterações de recursos para o BigQuery sempre que os recursos de FHIR no seu armazenamento forem criados, atualizados, corrigidos ou excluídos, clique em Adicionar nova configuração de streaming no campo Conjunto de dados.
Selecione um conjunto de dados do BigQuery em que as alterações de recursos serão transmitidas. Para mais informações sobre streaming do BigQuery, consulte Como fazer streaming de alterações de recursos FHIR para o BigQuery.
Para definir a profundidade de todas as estruturas recursivas no esquema de saída, clique na profundidade relevante no controle deslizante Profundidade da estrutura recursiva. Por padrão, a profundidade recursiva é 2.
Para exportar alterações de recursos apenas para tipos de recursos específicos, selecione os tipos de recursos na lista Selecionar tipos de recursos FHIR.
Para configurar um tópico do Pub/Sub para o repositório de dados, selecione um nome de tópico na seção Notificações do Cloud Pub/Sub. 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
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. Para mais informações sobre rótulos de recursos, consulteClique em Salvar.
gcloud
Para editar um repositório FHIR, execute o comando gcloud healthcare fhir-stores update
.
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 de FHIR
- FHIR_STORE_ID: o ID de armazenamento de FHIR
- PUBSUB_TOPIC_ID: 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 comando a seguir:
Linux, macOS ou Cloud Shell
gcloud healthcare fhir-stores update FHIR_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION \ --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID
Windows (PowerShell)
gcloud healthcare fhir-stores update FHIR_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION ` --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID
Windows (cmd.exe)
gcloud healthcare fhir-stores update FHIR_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION ^ --pubsub-topic=projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID
Você receberá uma resposta semelhante a esta:
Resposta
Updated fhirStore [FHIR_STORE_ID]. name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID notificationConfig: pubsubTopic: projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID version: FHIR_STORE_VERSION
REST
Para editar um repositório FHIR, use o método projects.locations.datasets.fhirStores.patch
.
Antes de usar os dados da solicitação, 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 de FHIR
- FHIR_STORE_ID: o ID de armazenamento de FHIR
- PUBSUB_TOPIC_ID: o ID do tópico do Pub/Sub. Para determinar quais dados incluir nas notificações do Pub/Sub, consulte Notificações do Pub/Sub FHIR.
- KEY1: a primeira chave de rótulo.
- VALUE1: o valor do primeiro rótulo.
- KEY2: a segunda chave de rótulo.
- VALUE2: o valor do segundo rótulo.
Solicitar corpo JSON:
{ "notificationConfig": { "pubsubTopic": "projects/PROJECT_ID/topics/PUBSUB_TOPIC_ID" }, "labels": { "KEY1": "VALUE1", "KEY2": "VALUE2" } }
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_ID" }, "labels": { "KEY1": "VALUE1", "KEY2": "VALUE2" } } 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/fhirStores/FHIR_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_ID" }, "labels": { "KEY1": "VALUE1", "KEY2": "VALUE2" } } '@ | 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/fhirStores/FHIR_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ê receberá uma resposta JSON semelhante a esta:
Go
Java
Node.js
Python
Como ver detalhes do armazenamento FHIR
Os exemplos a seguir mostram como conseguir detalhes sobre um armazenamento de FHIR.
Console
Para ver os detalhes de um armazenamento FHIR, siga estas etapas:
- No console do Google Cloud, acesse a página "Conjuntos de dados".
- Selecione o conjunto de dados que contém o repositório FHIR.
- Clique no nome do armazenamento FHIR.
gcloud
Para acessar detalhes sobre um armazenamento de FHIR, execute o comando gcloud healthcare fhir-stores describe
.
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 de FHIR
- FHIR_STORE_ID: o ID de armazenamento de FHIR
Execute o comando a seguir:
Linux, macOS ou Cloud Shell
gcloud healthcare fhir-stores describe FHIR_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare fhir-stores describe FHIR_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare fhir-stores describe FHIR_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Você vai receber uma resposta semelhante a esta.
Se você configurou campos no recurso FhirStore
, eles também vão aparecer na resposta.
Resposta
... name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID ... version: FHIR_STORE_VERSION
REST
Para acessar detalhes sobre um armazenamento de FHIR, use o método projects.locations.datasets.fhirStores.get
.
Antes de usar os dados da solicitação, 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 de FHIR
- FHIR_STORE_ID: o ID de armazenamento de FHIR
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/fhirStores/FHIR_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/fhirStores/FHIR_STORE_ID" | Select-Object -Expand Content
APIs Explorer
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ê configurou campos no recurso FhirStore
, eles também vão aparecer na resposta.
Go
Java
Node.js
Python
Como listar os armazenamentos FHIR em um conjunto de dados
Os exemplos a seguir mostram como listar os armazenamentos de FHIR em um conjunto de dados.
Console
Para ver os repositórios 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 visualizar detalhes sobre um armazenamento de FHIR, execute o comando gcloud healthcare fhir-stores list
.
Antes de usar os dados do comando abaixo, faça estas substituições:
- DATASET_ID: o conjunto de dados pai do armazenamento de FHIR
- LOCATION: o local do conjunto de dados;
Execute o comando a seguir:
Linux, macOS ou Cloud Shell
gcloud healthcare fhir-stores list --dataset=DATASET_ID --location=LOCATION
Windows (PowerShell)
gcloud healthcare fhir-stores list --dataset=DATASET_ID --location=LOCATION
Windows (cmd.exe)
gcloud healthcare fhir-stores list --dataset=DATASET_ID --location=LOCATION
Você vai receber uma resposta semelhante a esta.
Se você configurou campos no recurso FhirStore
, eles também vão aparecer na resposta.
ID LOCATION REF_INT RES_VER UPDATE_CREATE TOPIC FHIR_STORE_ID LOCATION PUBSUB_TOPIC ...
REST
Para listar os armazenamentos de FHIR em um conjunto de dados, use o método projects.locations.datasets.fhirStores.list
.
Antes de usar os dados da solicitação, faça as substituições a seguir:
- PROJECT_ID: o ID do seu projeto do Google Cloud;
- DATASET_ID: o conjunto de dados pai do armazenamento de FHIR
- LOCATION: o local do conjunto de dados;
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/fhirStores"
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/fhirStores" | Select-Object -Expand Content
APIs Explorer
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ê configurou campos no recurso FhirStore
, eles também vão aparecer na resposta.
Go
Java
Node.js
Python
Como conseguir os recursos ou a declaração de conformidade de um armazenamento FHIR
Os exemplos a seguir mostram como conseguir os recursos (STU3 ou R4) ou a instrução de conformidade (DSTU2) para um armazenamento de FHIR.
As informações nos recursos ou na declaração de conformidade refletem as configurações no armazenamento FHIR. Por exemplo, se FhirStore.enableUpdateCreate
estiver definido como true
, isso será refletido no campo CapabilityStatement.rest.resource.updateCreate
da instrução de recursos.
A tabela a seguir mostra o método da API Cloud Healthcare para receber os recursos ou a declaração de conformidade de um armazenamento FHIR e a interação de especificação FHIR equivalente:
Método da API Cloud Healthcare | Interação de especificação FHIR |
---|---|
projects.locations.datasets.fhirStores.fhir.capabilities |
Recursos (STU3 ou R4) ou conformance (DSTU2) |
Console
O console do Google Cloud e a CLI gcloud não são compatíveis com essa ação. Em vez disso, use curl
, PowerShell ou sua linguagem preferida.
gcloud
O console do Google Cloud e a CLI gcloud não são compatíveis com essa ação. Em vez disso, use curl
, PowerShell ou sua linguagem preferida.
REST
Para conseguir os recursos ou a instrução de conformidade de um armazenamento FHIR, use o método projects.locations.datasets.fhirStores.fhir.capabilities
.
Antes de usar os dados da solicitação, 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 de FHIR
- FHIR_STORE_ID: o ID de armazenamento de FHIR
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/fhirStores/FHIR_STORE_ID/fhir/metadata"
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/fhirStores/FHIR_STORE_ID/fhir/metadata" | Select-Object -Expand Content
APIs Explorer
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:
Go
Java
Node.js
Python
Como definir o nível de validação do recurso base
Por padrão, todos os recursos no armazenamento de FHIR têm validação de recurso base aplicada. Essa validação garante que o seguinte seja verdadeiro quando o recurso é criado:
- Todos os campos obrigatórios estão definidos.
- Todos os tipos de recursos indicados são válidos.
- O recurso atende a todas as restrições de FHIRPath.
É possível tornar sua validação de recursos base menos rigorosa ao desativar um ou mais desses tipos de validação de recursos básicos para o armazenamento de FHIR.
Console
O console do Google Cloud e a CLI gcloud não são compatíveis com essa ação. Em vez disso, use curl
, PowerShell ou sua linguagem preferida.
gcloud
O console do Google Cloud e a CLI gcloud não são compatíveis com essa ação. Em vez disso, use curl
, PowerShell ou sua linguagem preferida.
REST
Para desativar a validação de recursos base em um armazenamento FHIR atual, use o método projects.locations.datasets.fhirStores.patch
.
Antes de usar os dados da solicitação, faça as substituições a seguir:
- PROJECT_ID: o ID do seu projeto do Google Cloud;
- DATASET_ID: o conjunto de dados pai do armazenamento de FHIR
- LOCATION: o local do conjunto de dados;
- BASE_RESOURCE_VALIDATION_TYPE: o tipo de validação de recurso base que você quer desativar. Para desativar a validação, defina qualquer um dos seguintes campos como
true
:disableRequiredFieldValidation
disableReferenceTypeValidation
disableFhirpathValidation
Solicitar corpo JSON:
{ "validationConfig": { "BASE_RESOURCE_VALIDATION_TYPE": true } }
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' { "validationConfig": { "BASE_RESOURCE_VALIDATION_TYPE": true } } 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/fhirStores/FHIR_STORE_ID?updateMask=validationConfig"
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:
@' { "validationConfig": { "BASE_RESOURCE_VALIDATION_TYPE": true } } '@ | 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/fhirStores/FHIR_STORE_ID?updateMask=validationConfig" | 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ê configurou campos no recurso FhirStore
, eles também vão aparecer na resposta.
Como excluir um armazenamento FHIR
Os exemplos a seguir mostram como excluir um armazenamento de FHIR.
Console
Para excluir um repositório 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 repositório de dados e clique em Excluir.
gcloud
Para excluir um repositório FHIR, execute o comando gcloud healthcare fhir-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 de FHIR
- FHIR_STORE_ID: o ID de armazenamento de FHIR
Execute o comando a seguir:
Linux, macOS ou Cloud Shell
gcloud healthcare fhir-stores delete FHIR_STORE_ID \ --dataset=DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare fhir-stores delete FHIR_STORE_ID ` --dataset=DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare fhir-stores delete FHIR_STORE_ID ^ --dataset=DATASET_ID ^ --location=LOCATION
Você receberá uma resposta semelhante a esta
Deleted fhirStore [FHIR_STORE_ID].
REST
Para excluir um armazenamento FHIR, use o método projects.locations.datasets.fhirStores.delete
.
Antes de usar os dados da solicitação, 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 de FHIR
- FHIR_STORE_ID: o ID de armazenamento de FHIR
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/fhirStores/FHIR_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/fhirStores/FHIR_STORE_ID" | Select-Object -Expand Content
APIs Explorer
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:
Go
Java
Node.js
Python
A seguir
Saiba como criar e trabalhar com recursos FHIR.