Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mencari sumber daya FHIR dengan GET
Anda dapat menggunakan `GET` permintaan untuk mencari penyimpanan HealthLake data. Saat menggunakan`GET`, HealthLake mendukung penyediaan parameter pencarian sebagai bagian dari URL, tetapi bukan sebagai bagian dari badan permintaan. Untuk informasi selengkapnya, lihat [Parameter pencarian FHIR R4 untuk HealthLake](reference-fhir-search-parameters.md).
**Penting:**
Untuk pencarian yang melibatkan informasi identitas pribadi (PII) atau informasi kesehatan yang dilindungi (PHI), praktik terbaik keamanan memerlukan penggunaan `POST` permintaan, karena PII dan PHI ditambahkan sebagai bagian dari badan permintaan dan dienkripsi dalam perjalanan. Untuk informasi selengkapnya, lihat [Mencari sumber daya FHIR dengan POST](searching-fhir-resources-post.md).
Prosedur berikut diikuti oleh contoh yang digunakan `GET` untuk mencari penyimpanan HealthLake data.
**Untuk mencari penyimpanan HealthLake data dengan `GET`**
1. Kumpulkan HealthLake `region` dan `datastoreId` nilai. Untuk informasi selengkapnya, lihat [Mendapatkan properti penyimpanan data](managing-data-stores-describe.md).
1. Tentukan jenis sumber daya FHIR untuk mencari dan mengumpulkan `id` nilai terkait. Untuk informasi selengkapnya, lihat [Jenis sumber daya](reference-fhir-resource-types.md).
1. Buat URL untuk permintaan menggunakan nilai yang dikumpulkan untuk HealthLake `region` dan`datastoreId`. Juga termasuk `Resource` jenis FHIR dan [parameter pencarian](reference-fhir-search-parameters.md) yang didukung. Untuk melihat seluruh jalur URL dalam contoh berikut, gulir ke atas tombol **Salin**.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource{?[parameters]{&_format=[mime-type]}}
```
1. Kirim `GET` permintaan dengan [AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) atau SMART pada otorisasi FHIR. `curl`Contoh berikut mengembalikan jumlah total sumber `Patient` daya dalam penyimpanan HealthLake data. Untuk melihat seluruh contoh, gulir ke atas tombol **Salin**.
------
#### [ SigV4 ]
Otorisasi 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 pada contoh otorisasi FHIR untuk tipe [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html)data.
```
{
"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\"]}"
}
```
Penelepon dapat menetapkan izin di lambda otorisasi. Untuk informasi selengkapnya, lihat [OAuth 2.0 cakupan](reference-smart-on-fhir-oauth-scopes.md).
------
#### [ AWS Console ]
**catatan**
HealthLake Konsol hanya mendukung otorisasi SiGv4. SMART pada otorisasi FHIR didukung melalui AWS CLI dan. AWS SDKs
1. Masuk ke halaman [Jalankan kueri](https://console.aws.amazon.com/healthlake/home#/crud) di HealthLake Konsol.
2. Di bawah bagian **Pengaturan kueri**, buat pilihan berikut.
+ **ID Penyimpanan Data** — pilih ID penyimpanan data untuk menghasilkan string kueri.
+ **Jenis kueri** - pilih`Search with GET`.
+ **Jenis sumber daya** - pilih [jenis sumber daya](reference-fhir-resource-types.md) FHIR untuk dicari.
+ **Parameter pencarian** — Pilih [parameter pencarian](reference-fhir-search-parameters.md) atau kombinasi parameter pencarian untuk memfokuskan kueri Anda pada catatan tertentu.
3. Pilih **Run query** (Jalankan kueri).
------
## Contoh: cari dengan GET
Tab berikut memberikan contoh untuk mencari pada jenis sumber daya FHIR tertentu dengan. `GET` Contoh menunjukkan cara menentukan parameter pencarian dalam permintaan URLs.
**catatan**
HealthLake Konsol hanya mendukung otorisasi SiGv4. SMART pada otorisasi FHIR didukung melalui AWS CLI dan. AWS SDKs
HealthLake mendukung subset parameter pencarian FHIR R4. Untuk informasi selengkapnya, lihat [Parameter pencarian](reference-fhir-search-parameters.md).
------
#### [ Patient (age) ]
Meskipun usia bukan tipe sumber daya yang ditentukan di FHIR, ia ditangkap sebagai elemen dalam tipe [https://hl7.org/fhir/R4/patient.html](https://hl7.org/fhir/R4/patient.html)sumber daya. Gunakan contoh berikut untuk membuat permintaan pencarian `GET` berbasis pada jenis [https://hl7.org/fhir/R4/patient.html](https://hl7.org/fhir/R4/patient.html)sumber daya menggunakan elemen [BirthDate](https://hl7.org/fhir/R4/patient-definitions.html#Patient.birthDate) dan [pembanding `eq` pencarian](reference-fhir-search-parameters.md#search-comparators) untuk mencari individu yang lahir pada tahun 1997.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Patient?birthdate=eq1997
```
------
#### [ Condition ]
Gunakan contoh berikut untuk membuat `GET` permintaan pada jenis [https://hl7.org/fhir/R4/condition.html](https://hl7.org/fhir/R4/condition.html)sumber daya. Pencarian menemukan kondisi di penyimpanan HealthLake data Anda yang berisi kode medis SNOMED`72892002`, yang diterjemahkan menjadi. `Normal pregnancy`
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Condition?code=72892002
```
------
#### [ DocumentationReference ]
Contoh berikut menunjukkan cara membuat `GET` permintaan pada jenis [https://hl7.org/fhir/R4/documentreference.html](https://hl7.org/fhir/R4/documentreference.html)sumber daya untuk `Patient` (s) dengan diagnosis streptokokus dan yang juga telah diresepkan amoksisilin.
```
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 ]
Gunakan contoh berikut untuk membuat `GET` permintaan pada jenis [https://hl7.org/fhir/R4/location.html](https://hl7.org/fhir/R4/location.html)sumber daya. Pencarian berikut menemukan lokasi di toko HealthLake data Anda yang berisi nama kota Boston sebagai bagian dari alamat.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Location?address=boston
```
------
#### [ Observation ]
Gunakan contoh berikut untuk membuat permintaan pencarian `GET` berbasis pada jenis [https://hl7.org/fhir/R4/observation.html](https://hl7.org/fhir/R4/observation.html)sumber daya. Pencarian ini menggunakan [parameter `value-concept` pencarian](reference-fhir-search-parameters.md) untuk mencari kode medis`266919005`, yang diterjemahkan menjadi`Never smoker`.
```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Observation?value-concept=266919005
```
------