As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Pesquisando recursos do FHIR com GET
Você pode usar `GET` solicitações para pesquisar um armazenamento HealthLake de dados. Ao usar`GET`, HealthLake suporta o fornecimento de parâmetros de pesquisa como parte do URL, mas não como parte do corpo de uma solicitação. Para obter mais informações, consulte [Parâmetros de pesquisa FHIR R4 para HealthLake](reference-fhir-search-parameters.md).
**Importante**
Para pesquisas que envolvem informações de identificação pessoal (PII) ou informações de saúde protegidas (PHI), as melhores práticas de segurança exigem o uso de `POST` solicitações, pois PII e PHI são adicionadas como parte do corpo da solicitação e criptografadas em trânsito. Para obter mais informações, consulte [Pesquisando recursos do FHIR com POST](searching-fhir-resources-post.md).
O procedimento a seguir é seguido por exemplos usados `GET` para pesquisar um armazenamento HealthLake de dados.
**Para pesquisar um armazenamento HealthLake de dados com `GET`**
1. Colecione HealthLake `region` e `datastoreId` valorize. Para obter mais informações, consulte [Obter propriedades do datastore](managing-data-stores-describe.md).
1. Determine o tipo de recurso FHIR para pesquisar e coletar o valor associado`id`. Para obter mais informações, consulte [Resource types](reference-fhir-resource-types.md).
1. Crie uma URL para a solicitação usando os valores coletados para HealthLake `region` `datastoreId` e. Inclua também o `Resource` tipo de FHIR e os parâmetros de [pesquisa](reference-fhir-search-parameters.md) compatíveis. Para ver todo o caminho do URL no exemplo a seguir, role até o botão **Copiar**.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource{?[parameters]{&_format=[mime-type]}}
```
1. Envie a `GET` solicitação com [AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) ou SMART na autorização FHIR. O `curl` exemplo a seguir retorna o número total de `Patient` recursos em um armazenamento HealthLake de dados. Para ver o exemplo inteiro, role até o botão **Copiar**.
------
#### [ SigV4 ]
Autorização SigV4
```
curl --request GET \
'https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Patient?_total=accurate' \
--aws-sigv4 'aws:amz:region:healthlake' \
--user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
--header "x-amz-security-token:$AWS_SESSION_TOKEN" \
--header 'Accept: application/json'
```
------
#### [ SMART on FHIR ]
SMART no exemplo de autorização FHIR para o tipo de [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html)dados.
```
{
"AuthorizationStrategy": "SMART_ON_FHIR",
"FineGrainedAuthorizationEnabled": true,
"IdpLambdaArn": "arn:aws:lambda:your-region:your-account-id:function:your-lambda-name",
"Metadata": "{\"issuer\":\"https://ehr.example.com\", \"jwks_uri\":\"https://ehr.example.com/.well-known/jwks.json\",\"authorization_endpoint\":\"https://ehr.example.com/auth/authorize\",\"token_endpoint\":\"https://ehr.token.com/auth/token\",\"token_endpoint_auth_methods_supported\":[\"client_secret_basic\",\"foo\"],\"grant_types_supported\":[\"client_credential\",\"foo\"],\"registration_endpoint\":\"https://ehr.example.com/auth/register\",\"scopes_supported\":[\"openId\",\"profile\",\"launch\"],\"response_types_supported\":[\"code\"],\"management_endpoint\":\"https://ehr.example.com/user/manage\",\"introspection_endpoint\":\"https://ehr.example.com/user/introspect\",\"revocation_endpoint\":\"https://ehr.example.com/user/revoke\",\"code_challenge_methods_supported\":[\"S256\"],\"capabilities\":[\"launch-ehr\",\"sso-openid-connect\",\"client-public\",\"permission-v2\"]}"
}
```
O chamador pode atribuir permissões na autorização lambda. Para obter mais informações, consulte [OAuth escopos 2.0](reference-smart-on-fhir-oauth-scopes.md).
------
#### [ AWS Console ]
**nota**
O HealthLake console suporta somente a autorização SigV4. A autorização SMART on FHIR é suportada por meio de e. AWS CLI AWS SDKs
1. Faça login na página [Executar consulta](https://console.aws.amazon.com/healthlake/home#/crud) no HealthLake console.
2. Na seção **Configurações da consulta**, faça as seguintes seleções.
+ **ID do armazenamento de dados** — escolha um ID do armazenamento de dados para gerar uma sequência de caracteres de consulta.
+ **Tipo de consulta** — escolha`Search with GET`.
+ **Tipo de recurso** — escolha o [tipo de recurso](reference-fhir-resource-types.md) FHIR para pesquisar.
+ **Parâmetros de pesquisa** — Selecione um [parâmetro de pesquisa](reference-fhir-search-parameters.md) ou uma combinação de parâmetros de pesquisa para focar sua consulta em registros específicos.
3. Selecione **Executar consulta**.
------
## Exemplos: pesquisar com GET
As guias a seguir fornecem exemplos para pesquisar tipos específicos de recursos do FHIR com. `GET` Os exemplos mostram como especificar parâmetros de pesquisa na solicitação URLs.
**nota**
O HealthLake console suporta somente a autorização SigV4. A autorização SMART on FHIR é suportada por meio de e. AWS CLI AWS SDKs
HealthLake suporta um subconjunto de parâmetros de pesquisa FHIR R4. Para obter mais informações, consulte [Parâmetros de pesquisa](reference-fhir-search-parameters.md).
------
#### [ Patient (age) ]
Embora a idade não seja um tipo de recurso definido no FHIR, ela é capturada como um elemento no tipo de [https://hl7.org/fhir/R4/patient.html](https://hl7.org/fhir/R4/patient.html)recurso. Use o exemplo a seguir para fazer uma solicitação de pesquisa `GET` baseada em tipos de [https://hl7.org/fhir/R4/patient.html](https://hl7.org/fhir/R4/patient.html)recursos usando o elemento [BirthDate](https://hl7.org/fhir/R4/patient-definitions.html#Patient.birthDate) e o `eq` [comparador](reference-fhir-search-parameters.md#search-comparators) de pesquisa para pesquisar indivíduos nascidos no ano de 1997.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Patient?birthdate=eq1997
```
------
#### [ Condition ]
Use o exemplo a seguir para fazer uma `GET` solicitação sobre o tipo de [https://hl7.org/fhir/R4/condition.html](https://hl7.org/fhir/R4/condition.html)recurso. A pesquisa encontra condições em seu armazenamento de HealthLake dados que contêm o código médico SNOMED`72892002`, que se traduz em. `Normal pregnancy`
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Condition?code=72892002
```
------
#### [ DocumentationReference ]
O exemplo a seguir mostra como criar uma `GET` solicitação sobre o tipo de [https://hl7.org/fhir/R4/documentreference.html](https://hl7.org/fhir/R4/documentreference.html)recurso para `Patient` (s) com diagnóstico de estreptococos e para quem também foi prescrita amoxicilina.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/DocumentReference?_lastUpdated=le2021-12-19&infer-icd10cm-entity-text-concept-score;=streptococcal|0.6&infer-rxnorm-entity-text-concept-score=Amoxicillin|0.8
```
------
#### [ Location ]
Use o exemplo a seguir para fazer uma `GET` solicitação sobre o tipo de [https://hl7.org/fhir/R4/location.html](https://hl7.org/fhir/R4/location.html)recurso. A pesquisa a seguir encontra locais em seu armazenamento de HealthLake dados que contêm o nome da cidade Boston como parte do endereço.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Location?address=boston
```
------
#### [ Observation ]
Use o exemplo a seguir para fazer uma solicitação de pesquisa `GET` baseada no tipo de [https://hl7.org/fhir/R4/observation.html](https://hl7.org/fhir/R4/observation.html)recurso. Essa pesquisa usa o [parâmetro de `value-concept` pesquisa](reference-fhir-search-parameters.md) para procurar o código médico`266919005`, que se traduz em. `Never smoker`
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Observation?value-concept=266919005
```
------