Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Ricerca di risorse FHIR con GET
È possibile utilizzare `GET` le richieste per effettuare ricerche in un archivio HealthLake dati. Durante l'utilizzo`GET`, HealthLake supporta la fornitura di parametri di ricerca come parte dell'URL, ma non come parte del corpo della richiesta. Per ulteriori informazioni, consulta [Parametri di ricerca FHIR R4 per HealthLake](reference-fhir-search-parameters.md).
**Importante**
Per le ricerche che coinvolgono informazioni di identificazione personale (PII) o informazioni sanitarie protette (PHI), le migliori pratiche di sicurezza richiedono l'utilizzo delle `POST` richieste, poiché PII e PHI vengono aggiunti come parte del corpo della richiesta e vengono crittografati durante il transito. Per ulteriori informazioni, consulta [Ricerca di risorse FHIR con POST](searching-fhir-resources-post.md).
La procedura seguente è seguita da esempi da utilizzare `GET` per effettuare ricerche in un archivio dati. HealthLake
**Per effettuare ricerche in un HealthLake data store con `GET`**
1. Raccogli HealthLake `region` e `datastoreId` valorizza. Per ulteriori informazioni, consulta [Ottenere le proprietà dell'archivio dati](managing-data-stores-describe.md).
1. Determina il tipo di risorsa FHIR da cercare e raccogliere il `id` valore associato. Per ulteriori informazioni, consulta [Tipi di risorse](reference-fhir-resource-types.md).
1. Costruisci un URL per la richiesta utilizzando i valori raccolti per HealthLake `region` e. `datastoreId` Includi anche il `Resource` tipo FHIR e i parametri di [ricerca](reference-fhir-search-parameters.md) supportati. Per visualizzare l'intero percorso dell'URL nell'esempio seguente, scorri il pulsante **Copia**.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource{?[parameters]{&_format=[mime-type]}}
```
1. Invia la `GET` richiesta con l'autorizzazione [AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) o SMART on FHIR. L'`curl`esempio seguente restituisce il numero totale di `Patient` risorse in un archivio HealthLake dati. Per visualizzare l'intero esempio, scorri il pulsante **Copia**.
------
#### [ SigV4 ]
Autorizzazione 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 ]
Esempio di autorizzazione SMART on FHIR per il tipo di dati [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html).
```
{
"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\"]}"
}
```
Il chiamante può assegnare le autorizzazioni nella lambda di autorizzazione. Per ulteriori informazioni, consulta [OAuth Cannocchiali 2.0](reference-smart-on-fhir-oauth-scopes.md).
------
#### [ AWS Console ]
**Nota**
La HealthLake console supporta solo l'autorizzazione SigV4. L'autorizzazione SMART on FHIR è supportata tramite e. AWS CLI AWS SDKs
1. Accedi alla pagina [Esegui interrogazione](https://console.aws.amazon.com/healthlake/home#/crud) sulla HealthLake console.
2. Nella sezione **Impostazioni della query**, effettua le seguenti selezioni.
+ **Data Store ID**: scegli un ID del data store per generare una stringa di query.
+ **Tipo di query**: scegli`Search with GET`.
+ **Tipo di risorsa**: scegli il [tipo di risorsa](reference-fhir-resource-types.md) FHIR su cui eseguire la ricerca.
+ **Parametri di ricerca**: seleziona un [parametro di ricerca](reference-fhir-search-parameters.md) o una combinazione di parametri di ricerca per concentrare la ricerca su record specifici.
3. Scegli **Esegui query**.
------
## Esempi: ricerca con GET
Le schede seguenti forniscono esempi per la ricerca su tipi di risorse FHIR specifici con. `GET` Gli esempi mostrano come specificare i parametri di ricerca nella richiesta. URLs
**Nota**
La HealthLake console supporta solo l'autorizzazione SigV4. L'autorizzazione SMART on FHIR è supportata tramite e. AWS CLI AWS SDKs
HealthLake supporta un sottoinsieme di parametri di ricerca FHIR R4. Per ulteriori informazioni, consulta [Parametri di ricerca](reference-fhir-search-parameters.md).
------
#### [ Patient (age) ]
Sebbene l'età non sia un tipo di risorsa definito in FHIR, viene acquisita come elemento del tipo di risorsa. [https://hl7.org/fhir/R4/patient.html](https://hl7.org/fhir/R4/patient.html) Utilizzate l'esempio seguente per effettuare una richiesta di ricerca `GET` basata sui tipi di [https://hl7.org/fhir/R4/patient.html](https://hl7.org/fhir/R4/patient.html)risorse utilizzando l'elemento [BirthDate](https://hl7.org/fhir/R4/patient-definitions.html#Patient.birthDate) e il `eq` [comparatore](reference-fhir-search-parameters.md#search-comparators) di ricerca per cercare individui nati nel 1997.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Patient?birthdate=eq1997
```
------
#### [ Condition ]
Utilizzate l'esempio seguente per effettuare una `GET` richiesta sul tipo di [https://hl7.org/fhir/R4/condition.html](https://hl7.org/fhir/R4/condition.html)risorsa. La ricerca trova le condizioni nell'archivio HealthLake dati che contengono il codice medico SNOMED`72892002`, che si traduce in. `Normal pregnancy`
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Condition?code=72892002
```
------
#### [ DocumentationReference ]
L'esempio seguente mostra come creare una `GET` richiesta sul tipo di [https://hl7.org/fhir/R4/documentreference.html](https://hl7.org/fhir/R4/documentreference.html)risorsa per `Patient` una o più persone con diagnosi di streptococco e a cui è stata prescritta anche amoxicillina.
```
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 ]
Utilizzate l'esempio seguente per effettuare una richiesta sul tipo di risorsa. `GET` [https://hl7.org/fhir/R4/location.html](https://hl7.org/fhir/R4/location.html) La ricerca seguente trova le posizioni nel tuo archivio HealthLake dati che contengono il nome della città Boston come parte dell'indirizzo.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Location?address=boston
```
------
#### [ Observation ]
Utilizza l'esempio seguente per effettuare una richiesta di ricerca `GET` basata sul tipo di [https://hl7.org/fhir/R4/observation.html](https://hl7.org/fhir/R4/observation.html)risorsa. Questa ricerca utilizza il [parametro `value-concept` di ricerca](reference-fhir-search-parameters.md) per cercare il codice medico`266919005`, che si traduce in`Never smoker`.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Observation?value-concept=266919005
```
------