Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Búsqueda de recursos del FHIR con GET
Puede utilizar `GET` las solicitudes para buscar en un banco HealthLake de datos. Cuando se usa`GET`, HealthLake permite proporcionar parámetros de búsqueda como parte de la URL, pero no como parte del cuerpo de la solicitud. Para obtener más información, consulte [Parámetros de búsqueda FHIR R4 para HealthLake](reference-fhir-search-parameters.md).
**Importante**
Para las búsquedas que incluyen información de identificación personal (PII) o información de salud protegida (PHI), las mejores prácticas de seguridad recomiendan utilizar `POST` solicitudes, ya que la PII y la PHI se añaden como parte del cuerpo de la solicitud y se cifran en tránsito. Para obtener más información, consulte [Búsqueda de recursos del FHIR con POST](searching-fhir-resources-post.md).
El siguiente procedimiento va seguido de ejemplos que se utilizan `GET` para buscar en un almacén de HealthLake datos.
**Para buscar en un HealthLake banco de datos con `GET`**
1. Recopilar HealthLake `region` y `datastoreId` valorar. Para obtener más información, consulte [Obtención de propiedades de los almacenes de datos](managing-data-stores-describe.md).
1. Determine el tipo de recurso del FHIR para buscar y recopilar el `id` valor asociado. Para obtener más información, consulte [Tipos de recurso](reference-fhir-resource-types.md).
1. Cree una URL para la solicitud utilizando los valores recopilados para HealthLake `region` y`datastoreId`. Incluya también el `Resource` tipo de FHIR y los [parámetros de búsqueda](reference-fhir-search-parameters.md) compatibles. Para ver la ruta URL completa en el siguiente ejemplo, desplázate sobre el botón **Copiar**.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource{?[parameters]{&_format=[mime-type]}}
```
1. Envíe la `GET` solicitud con la [versión 4 de AWS Signature](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) o SMART con la autorización del FHIR. El siguiente `curl` ejemplo devuelve el número total de `Patient` recursos de un almacén de HealthLake datos. Para ver el ejemplo completo, desplácese sobre el botón **Copiar**.
------
#### [ SigV4 ]
Autorización 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 ]
Ejemplo de autorización SMART on FHIR para el tipo de [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html)datos.
```
{
"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\"]}"
}
```
La persona que llama puede asignar permisos en la lambda de autorización. Para obtener más información, consulte [OAuth osciloscopios 2.0](reference-smart-on-fhir-oauth-scopes.md).
------
#### [ AWS Console ]
**nota**
La HealthLake consola solo admite la autorización SiGv4. La autorización SMART on FHIR se admite mediante AWS CLI y. AWS SDKs
1. Inicie sesión en la página [Ejecutar consultas](https://console.aws.amazon.com/healthlake/home#/crud) de la HealthLake consola.
2. En la sección de **configuración de consultas**, realice las siguientes selecciones.
+ **ID de almacén de datos**: elija un ID de almacén de datos para generar una cadena de consulta.
+ **Tipo de consulta**: elija`Search with GET`.
+ **Tipo de recurso**: elija el [tipo de recurso](reference-fhir-resource-types.md) del FHIR en el que desea buscar.
+ **Parámetros de búsqueda**: seleccione un [parámetro de búsqueda](reference-fhir-search-parameters.md) o una combinación de parámetros de búsqueda para centrar la consulta en registros específicos.
3. Elija **Ejecutar consulta**.
------
## Ejemplos: busque con GET
Las siguientes pestañas proporcionan ejemplos para buscar tipos de recursos específicos del FHIR con. `GET` Los ejemplos muestran cómo especificar los parámetros de búsqueda en la solicitud URLs.
**nota**
La HealthLake consola solo admite la autorización SiGv4. La autorización SMART on FHIR se admite mediante AWS CLI y. AWS SDKs
HealthLake admite un subconjunto de parámetros de búsqueda del FHIR R4. Para obtener más información, consulte [Parámetros de búsqueda](reference-fhir-search-parameters.md).
------
#### [ Patient (age) ]
Si bien la edad no es un tipo de recurso definido en el FHIR, se captura como un elemento del tipo de recurso. [https://hl7.org/fhir/R4/patient.html](https://hl7.org/fhir/R4/patient.html) Utilice el siguiente ejemplo para realizar una solicitud de búsqueda `GET` basada en tipos de [https://hl7.org/fhir/R4/patient.html](https://hl7.org/fhir/R4/patient.html)recursos mediante el elemento [BirthDate](https://hl7.org/fhir/R4/patient-definitions.html#Patient.birthDate) y el [comparador de `eq` búsquedas](reference-fhir-search-parameters.md#search-comparators) para buscar personas nacidas en el año 1997.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Patient?birthdate=eq1997
```
------
#### [ Condition ]
Utilice el siguiente ejemplo para realizar una `GET` solicitud sobre el tipo de [https://hl7.org/fhir/R4/condition.html](https://hl7.org/fhir/R4/condition.html)recurso. La búsqueda busca condiciones en el almacén de HealthLake datos que contienen el código médico de SNOMED`72892002`, que se traduce como. `Normal pregnancy`
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Condition?code=72892002
```
------
#### [ DocumentationReference ]
En el siguiente ejemplo, se muestra cómo crear una `GET` solicitud sobre el tipo de [https://hl7.org/fhir/R4/documentreference.html](https://hl7.org/fhir/R4/documentreference.html)recurso para `Patient` personas con diagnóstico de estreptococos y a quienes también se les ha recetado 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 ]
Utilice el siguiente ejemplo para realizar una solicitud sobre el tipo de recurso`GET`. [https://hl7.org/fhir/R4/location.html](https://hl7.org/fhir/R4/location.html) La siguiente búsqueda busca ubicaciones en el banco de HealthLake datos que contienen el nombre de la ciudad Boston como parte de la dirección.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Location?address=boston
```
------
#### [ Observation ]
Utilice el siguiente ejemplo para realizar una solicitud de búsqueda `GET` basada en el tipo [https://hl7.org/fhir/R4/observation.html](https://hl7.org/fhir/R4/observation.html)de recurso. Esta búsqueda utiliza el [parámetro `value-concept` de búsqueda](reference-fhir-search-parameters.md) para buscar el código médico`266919005`, que se traduce como`Never smoker`.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Observation?value-concept=266919005
```
------