Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Recherche de ressources FHIR avec GET
Vous pouvez utiliser des `GET` requêtes pour effectuer une recherche dans un magasin de HealthLake données. Lors de l'utilisation`GET`, HealthLake prend en charge la fourniture de paramètres de recherche dans le cadre de l'URL, mais pas dans le corps d'une requête. Pour de plus amples informations, veuillez consulter [Paramètres de recherche FHIR R4 pour HealthLake](reference-fhir-search-parameters.md).
**Important**
Pour les recherches impliquant des informations personnelles identifiables (PII) ou des informations de santé protégées (PHI), les meilleures pratiques en matière de sécurité nécessitent l'utilisation de `POST` demandes, car les informations personnelles et les PHI sont ajoutées dans le corps de la demande et sont cryptées pendant le transfert. Pour de plus amples informations, veuillez consulter [Recherche de ressources FHIR avec POST](searching-fhir-resources-post.md).
La procédure suivante est suivie d'exemples utilisés `GET` pour effectuer des recherches dans un magasin de HealthLake données.
**Pour effectuer une recherche dans un magasin de HealthLake données avec `GET`**
1. Collectez HealthLake `region` et `datastoreId` valorisez. Pour de plus amples informations, veuillez consulter [Obtenir les propriétés du magasin de données](managing-data-stores-describe.md).
1. Déterminez le type de ressource FHIR à rechercher et collectez la `id` valeur associée. Pour de plus amples informations, veuillez consulter [Types de ressources](reference-fhir-resource-types.md).
1. Construisez une URL pour la demande en utilisant les valeurs collectées pour HealthLake `region` et`datastoreId`. Incluez également le `Resource` type FHIR et les [paramètres de recherche](reference-fhir-search-parameters.md) pris en charge. Pour afficher le chemin complet de l'URL dans l'exemple suivant, faites défiler le curseur sur le bouton **Copier**.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource{?[parameters]{&_format=[mime-type]}}
```
1. Envoyez la `GET` demande avec [AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) ou SMART sur autorisation FHIR. L'`curl`exemple suivant renvoie le nombre total de `Patient` ressources dans un magasin de HealthLake données. Pour afficher l'exemple dans son intégralité, faites défiler la souris sur le bouton **Copier**.
------
#### [ SigV4 ]
Autorisation 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 ]
Exemple d'autorisation SMART sur FHIR pour le type de [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html)données.
```
{
"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\"]}"
}
```
L'appelant peut attribuer des autorisations dans le lambda d'autorisation. Pour de plus amples informations, veuillez consulter [OAuth Éscopes 2.0](reference-smart-on-fhir-oauth-scopes.md).
------
#### [ AWS Console ]
**Note**
La HealthLake console prend uniquement en charge l'autorisation SigV4. L'autorisation SMART on FHIR est prise en charge via AWS CLI et AWS SDKs.
1. Connectez-vous à la page [Exécuter une requête](https://console.aws.amazon.com/healthlake/home#/crud) sur la HealthLake console.
2. Dans la section **Paramètres de requête**, effectuez les sélections suivantes.
+ **ID du magasin de données** : choisissez un identifiant de magasin de données pour générer une chaîne de requête.
+ **Type de requête** : choisissez`Search with GET`.
+ **Type de ressource** : choisissez le type de [ressource FHIR sur lequel](reference-fhir-resource-types.md) effectuer la recherche.
+ **Paramètres de recherche** : sélectionnez un [paramètre de recherche](reference-fhir-search-parameters.md) ou une combinaison de paramètres de recherche pour concentrer votre recherche sur des enregistrements spécifiques.
3. Choisissez **Exécuter la requête**.
------
## Exemples : recherche avec GET
Les onglets suivants fournissent des exemples de recherche sur des types de ressources FHIR spécifiques avec`GET`. Les exemples montrent comment spécifier les paramètres de recherche dans la demande URLs.
**Note**
La HealthLake console prend uniquement en charge l'autorisation SigV4. L'autorisation SMART on FHIR est prise en charge via AWS CLI et AWS SDKs.
HealthLake prend en charge un sous-ensemble de paramètres de recherche FHIR R4. Pour de plus amples informations, veuillez consulter [Paramètres de recherche](reference-fhir-search-parameters.md).
------
#### [ Patient (age) ]
Bien que l'âge ne soit pas un type de ressource défini dans le FHIR, il est capturé en tant qu'élément du type de [https://hl7.org/fhir/R4/patient.html](https://hl7.org/fhir/R4/patient.html)ressource. Utilisez l'exemple suivant pour effectuer une demande de recherche `GET` basée sur les types de [https://hl7.org/fhir/R4/patient.html](https://hl7.org/fhir/R4/patient.html)ressources à l'aide de l'élément [BirthDate](https://hl7.org/fhir/R4/patient-definitions.html#Patient.birthDate) et du `eq` [comparateur](reference-fhir-search-parameters.md#search-comparators) de recherche pour rechercher des personnes nées en 1997.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Patient?birthdate=eq1997
```
------
#### [ Condition ]
Utilisez l'exemple suivant pour effectuer une `GET` demande sur le type de [https://hl7.org/fhir/R4/condition.html](https://hl7.org/fhir/R4/condition.html)ressource. La recherche permet de trouver dans votre banque de HealthLake données les conditions qui contiennent le code médical SNOMED`72892002`, qui se traduit par. `Normal pregnancy`
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Condition?code=72892002
```
------
#### [ DocumentationReference ]
L'exemple suivant montre comment créer une `GET` demande sur le type de [https://hl7.org/fhir/R4/documentreference.html](https://hl7.org/fhir/R4/documentreference.html)ressource pour `Patient` les personnes ayant reçu un diagnostic de streptocoque et à qui l'amoxicilline a également été prescrite.
```
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 ]
Utilisez l'exemple suivant pour effectuer une `GET` demande sur le type de [https://hl7.org/fhir/R4/location.html](https://hl7.org/fhir/R4/location.html)ressource. La recherche suivante permet de trouver les emplacements de votre banque de HealthLake données dont l'adresse contient le nom de ville Boston.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Location?address=boston
```
------
#### [ Observation ]
Utilisez l'exemple suivant pour effectuer une demande de recherche `GET` basée sur le type de [https://hl7.org/fhir/R4/observation.html](https://hl7.org/fhir/R4/observation.html)ressource. Cette recherche utilise le [paramètre `value-concept` de recherche](reference-fhir-search-parameters.md) pour rechercher le code médical`266919005`, qui se traduit par`Never smoker`.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Observation?value-concept=266919005
```
------