

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Suche nach FHIR-Ressourcen in AWS HealthLake
<a name="searching-fhir-resources"></a>

Verwenden Sie die [https://hl7.org/fhir/R4/http.html#search](https://hl7.org/fhir/R4/http.html#search)FHIR-Interaktion, um anhand einiger Filterkriterien nach einer Reihe von FHIR-Ressourcen in einem HealthLake Datenspeicher zu suchen. Die `search` Interaktion kann entweder mit einer `GET` Oder-Anfrage durchgeführt werden. `POST` Für Suchanfragen, die personenbezogene Daten (PII) oder geschützte Gesundheitsinformationen (PHI) beinhalten, wird empfohlen, `POST` Anfragen zu verwenden, da PII und PHI als Teil des Anfragetextes hinzugefügt und bei der Übertragung verschlüsselt werden.

**Anmerkung**  
Die in diesem Kapitel beschriebene `search` FHIR-Interaktion entspricht dem HL7 FHIR R4-Standard für den Austausch von Gesundheitsdaten. Da es sich um eine Repräsentation eines HL7 FHIR-Dienstes handelt, wird er nicht über und angeboten. AWS CLI AWS SDKs Weitere Informationen finden Sie [https://hl7.org/fhir/R4/http.html#search](https://hl7.org/fhir/R4/http.html#search)in der **FHIR RESTful R4-API-Dokumentation**.

HealthLake unterstützt eine Teilmenge der FHIR R4-Suchparameter. Weitere Informationen finden Sie unter [FHIR R4-Suchparameter für HealthLake](reference-fhir-search-parameters.md).

**Topics**
+ [Mit GET suchen](searching-fhir-resources-get.md)
+ [Mit POST suchen](searching-fhir-resources-post.md)
+ [Konsistenzstufen für die Suche](searching-fhir-consistency-levels.md)

# FHIR-Ressourcen mit GET durchsuchen
<a name="searching-fhir-resources-get"></a>

Sie können `GET` Anfragen verwenden, um einen HealthLake Datenspeicher zu durchsuchen. HealthLake Unterstützt bei der Verwendung `GET` die Angabe von Suchparametern als Teil der URL, jedoch nicht als Teil eines Anforderungstexts. Weitere Informationen finden Sie unter [FHIR R4-Suchparameter für HealthLake](reference-fhir-search-parameters.md).

**Wichtig**  
Bei Suchanfragen, die personenbezogene Daten (PII) oder geschützte Gesundheitsinformationen (PHI) beinhalten, empfehlen bewährte Sicherheitsverfahren die Verwendung von `POST` Anfragen, da PII und PHI als Teil des Anfragetexts hinzugefügt und bei der Übertragung verschlüsselt werden. Weitere Informationen finden Sie unter [FHIR-Ressourcen mit POST durchsuchen](searching-fhir-resources-post.md).

Auf das folgende Verfahren folgen Beispiele, die `GET` zum Durchsuchen eines HealthLake Datenspeichers verwendet werden.

**Um einen HealthLake Datenspeicher zu durchsuchen mit `GET`**  


1. Sammeln HealthLake `region` und `datastoreId` Werte. Weitere Informationen finden Sie unter [Eigenschaften des Datenspeichers abrufen](managing-data-stores-describe.md).

1. Ermitteln Sie den Typ der FHIR-Ressource, nach der gesucht werden soll, und erfassen Sie den zugehörigen `id` Wert. Weitere Informationen finden Sie unter [Ressourcentypen](reference-fhir-resource-types.md). 

1. Konstruieren Sie mithilfe der gesammelten Werte für HealthLake `region` und `datastoreId` eine URL für die Anfrage. Geben Sie auch den `Resource` FHIR-Typ und die unterstützten [Suchparameter](reference-fhir-search-parameters.md) an. Scrollen Sie über die Schaltfläche **Kopieren**, um den gesamten URL-Pfad im folgenden Beispiel anzuzeigen.

   ```
   GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource{?[parameters]{&_format=[mime-type]}}
   ```

1. Senden Sie die `GET` Anfrage entweder mit [AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) oder SMART bei FHIR-Autorisierung. Das folgende `curl` Beispiel gibt die Gesamtzahl der `Patient` Ressourcen in einem HealthLake Datenspeicher zurück. Scrollen Sie über die Schaltfläche **Kopieren**, um das gesamte Beispiel anzuzeigen.

------
#### [ SigV4 ]

   SigV4-Autorisierung

   ```
   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 on FHIR-Autorisierungsbeispiel für den [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html)Datentyp.

   ```
   {
       "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\"]}"
   }
   ```

   Der Anrufer kann im Autorisierungs-Lambda Berechtigungen zuweisen. Weitere Informationen finden Sie unter [OAuth 2.0-Bereiche](reference-smart-on-fhir-oauth-scopes.md).

------
#### [ AWS Console ]

**Anmerkung**  
Die HealthLake Konsole unterstützt nur die SigV4-Autorisierung. Die SMART-on-FHIR-Autorisierung wird über AWS CLI und unterstützt. AWS SDKs

   1. Melden Sie sich auf der Seite „[Abfrage ausführen](https://console.aws.amazon.com/healthlake/home#/crud)“ in der HealthLake Konsole an.

   2. Treffen Sie im Abschnitt **Abfrageeinstellungen** die folgenden Optionen.
   + **Datenspeicher-ID** — Wählen Sie eine Datenspeicher-ID aus, um eine Abfragezeichenfolge zu generieren.
   + **Abfragetyp** — wählen Sie`Search with GET`.
   + **Ressourcentyp** — Wählen Sie den [FHIR-Ressourcentyp](reference-fhir-resource-types.md) aus, nach dem gesucht werden soll.
   + **Suchparameter** — Wählen Sie einen [Suchparameter](reference-fhir-search-parameters.md) oder eine Kombination von Suchparametern aus, um Ihre Anfrage auf bestimmte Datensätze zu konzentrieren.

   3. Wählen Sie **Abfrage ausführen**.

------

## Beispiele: Suche mit GET
<a name="searching-fhir-resources-get-examples"></a>

Die folgenden Registerkarten enthalten Beispiele für die Suche nach bestimmten FHIR-Ressourcentypen mit. `GET` Die Beispiele zeigen, wie Suchparameter in der Anfrage URLs angegeben werden.

**Anmerkung**  
Die HealthLake Konsole unterstützt nur die SigV4-Autorisierung. Die SMART-on-FHIR-Autorisierung wird über AWS CLI und unterstützt. AWS SDKs  
HealthLake unterstützt eine Teilmenge der FHIR R4-Suchparameter. Weitere Informationen finden Sie unter [Suchparameter](reference-fhir-search-parameters.md).

------
#### [ Patient (age) ]

Obwohl das Alter in FHIR kein definierter Ressourcentyp ist, wird es als Element im Ressourcentyp erfasst. [https://hl7.org/fhir/R4/patient.html](https://hl7.org/fhir/R4/patient.html) Verwenden Sie das folgende Beispiel, um eine auf [https://hl7.org/fhir/R4/patient.html](https://hl7.org/fhir/R4/patient.html)Ressourcentypen `GET` basierende Suchanfrage zu stellen, indem Sie das Element [BirthDate](https://hl7.org/fhir/R4/patient-definitions.html#Patient.birthDate) und den `eq` [Suchkomparator](reference-fhir-search-parameters.md#search-comparators) verwenden, um nach Personen zu suchen, die im Jahr 1997 geboren wurden.

```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Patient?birthdate=eq1997
```

------
#### [ Condition ]

Verwenden Sie das folgende Beispiel, um eine `GET` Anfrage für den [https://hl7.org/fhir/R4/condition.html](https://hl7.org/fhir/R4/condition.html)Ressourcentyp zu stellen. Bei der Suche werden Bedingungen in Ihrem HealthLake Datenspeicher gefunden, die den medizinischen Code von SNOMED enthalten`72892002`, was übersetzt bedeutet. `Normal pregnancy`

```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Condition?code=72892002
```

------
#### [ DocumentationReference ]

Das folgende Beispiel zeigt, wie eine `GET` Anfrage für den [https://hl7.org/fhir/R4/documentreference.html](https://hl7.org/fhir/R4/documentreference.html)Ressourcentyp für `Patient` (s) erstellt wird, bei denen eine Streptokokken-Diagnose gestellt wurde und denen auch Amoxicillin verschrieben wurde.

```
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 ]

Verwenden Sie das folgende Beispiel, um eine `GET` Anfrage für den Ressourcentyp zu stellen. [https://hl7.org/fhir/R4/location.html](https://hl7.org/fhir/R4/location.html) Mit der folgenden Suche werden Standorte in Ihrem HealthLake Datenspeicher gefunden, die den Stadtnamen Boston als Teil der Adresse enthalten.

```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Location?address=boston
```

------
#### [ Observation ]

Verwenden Sie das folgende Beispiel, um eine `GET` basierte Suchanfrage für den [https://hl7.org/fhir/R4/observation.html](https://hl7.org/fhir/R4/observation.html)Ressourcentyp zu stellen. Diese Suche verwendet den `value-concept` [Suchparameter](reference-fhir-search-parameters.md), um nach medizinischem Code zu suchen`266919005`, was übersetzt bedeutet. `Never smoker`

```
GET https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Observation?value-concept=266919005
```

------

# FHIR-Ressourcen mit POST durchsuchen
<a name="searching-fhir-resources-post"></a>

Sie können die [https://hl7.org/fhir/R4/search.html](https://hl7.org/fhir/R4/search.html)FHIR-Interaktion mit `POST` Anfragen verwenden, um einen HealthLake Datenspeicher zu durchsuchen. Bei der Verwendung `POST` werden Suchparameter entweder in der URL oder in einem Anfragetext HealthLake unterstützt, Sie können jedoch nicht beide in einer einzigen Anfrage verwenden.

**Wichtig**  
Bei Suchanfragen, die personenbezogene Daten (PII) oder geschützte Gesundheitsinformationen (PHI) beinhalten, empfehlen bewährte Sicherheitsverfahren die Verwendung von `POST` Anfragen, da PII und PHI als Teil des Anfragetextes hinzugefügt und bei der Übertragung verschlüsselt werden.

Auf das folgende Verfahren folgen Beispiele, bei denen die `search` Interaktion mit FHIR R4 `POST` zum Durchsuchen eines Datenspeichers verwendet wird. HealthLake Die Beispiele zeigen, wie Suchparameter im JSON-Anforderungstext angegeben werden.

**Um einen HealthLake Datenspeicher zu durchsuchen mit `POST`**  


1. Sammeln HealthLake `region` und `datastoreId` Werte. Weitere Informationen finden Sie unter [Eigenschaften des Datenspeichers abrufen](managing-data-stores-describe.md).

1. Ermitteln Sie den Typ der FHIR-Ressource, nach der gesucht werden soll, und erfassen Sie den zugehörigen `id` Wert. Weitere Informationen finden Sie unter [Ressourcentypen](reference-fhir-resource-types.md). 

1. Konstruieren Sie mithilfe der gesammelten Werte für HealthLake `region` und `datastoreId` eine URL für die Anfrage. Geben Sie auch den `Resource` FHIR-Typ und die `_search` Interaktion an. Scrollen Sie über die Schaltfläche **Kopieren**, um den gesamten URL-Pfad im folgenden Beispiel anzuzeigen.

   ```
   POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Resource/_search
   ```

1. Konstruieren Sie einen JSON-Hauptteil für die Anfrage und geben Sie die FHIR-Daten an, nach denen gesucht werden soll. Für dieses Verfahren suchen Sie nach `Observation` Ressourcen, um Patienten zu finden, die noch nie geraucht haben. Um den Status des medizinischen Codes anzugeben`Never smoker`, legen Sie ihn `value-concept=266919005` im JSON-Anforderungstext fest. Speichern Sie die Datei als `search-observation.json`.

   ```
   value-concept=266919005
   ```

1. Senden Sie die Anforderung . Die `search` FHIR-Interaktion verwendet die `GET` Anfrage entweder mit [AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) oder SMART bei der FHIR-Autorisierung.
**Anmerkung**  
Wenn `POST` Sie eine Anfrage mit Suchparametern im Anfragetext stellen, verwenden Sie diese Option `Content-Type: application/x-www-form-urlencoded` als Teil des Headers.

   Im folgenden `curl` Beispiel wird eine POST-basierte Suchanfrage für den `Observation` Ressourcentyp gestellt. Die Anfrage verwendet den [https://hl7.org/fhir/R4/observation.html#search](https://hl7.org/fhir/R4/observation.html#search)Suchparameter, um nach medizinischem Code zu suchen, der einen Wert `266919005` `Never smoker` angibt. Scrollen Sie über die Schaltfläche **Kopieren**, um das gesamte Beispiel anzuzeigen.

------
#### [ SigV4 ]

   SigV4-Autorisierung

   ```
   curl --request POST \
     'https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Observation/_search' \						
     --aws-sigv4 'aws:amz:region:healthlake' \
     --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
     --header "x-amz-security-token:$AWS_SESSION_TOKEN" \
     --header "Content-Type: application/x-www-form-urlencoded"							
     --header "Accept: application/json"
     --data @search-observation.json
   ```

------
#### [ SMART on FHIR ]

   Beispiel für die SMART-on-FHIR-Autorisierung für den [https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html](https://docs.aws.amazon.com/healthlake/latest/APIReference/API_IdentityProviderConfiguration.html)Datentyp.

   ```
   {
       "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\"]}"
   }
   ```

   Der Anrufer kann im Autorisierungs-Lambda Berechtigungen zuweisen. Weitere Informationen finden Sie unter [OAuth 2.0-Bereiche](reference-smart-on-fhir-oauth-scopes.md).

------

## Beispiele: Suche mit POST
<a name="searching-fhir-resources-post-examples"></a>

Die folgenden Registerkarten enthalten Beispiele für die Suche nach bestimmten FHIR-Ressourcentypen mit. `POST` Die Beispiele zeigen, wie Sie eine Anfrage in der URLs spezifizieren.

**Anmerkung**  
Die HealthLake Konsole unterstützt nur die SigV4-Autorisierung. Die SMART-on-FHIR-Autorisierung wird über AWS CLI und unterstützt. AWS SDKs  
HealthLake unterstützt eine Teilmenge der FHIR R4-Suchparameter. Weitere Informationen finden Sie unter [Suchparameter](reference-fhir-search-parameters.md).

------
#### [ Patient (age) ]

Obwohl das Alter in FHIR kein definierter Ressourcentyp ist, wird es als Element im Ressourcentyp erfasst. [https://hl7.org/fhir/R4/patient.html](https://hl7.org/fhir/R4/patient.html) Verwenden Sie das folgende Beispiel, um eine `POST` basierte Suchanfrage für den `Patient` Ressourcentyp zu stellen. Im folgenden Suchbeispiel wird der `eq` [Suchkomparator](reference-fhir-search-parameters.md#search-comparators) verwendet, um nach Personen zu suchen, die 1997 geboren wurden.

```
POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Patient/_search
```

Um das Jahr 1997 in der Suche anzugeben, fügen Sie dem Anfragetext das folgende Element hinzu.

```
birthdate=eq1997
```

------
#### [ Condition ]

Verwenden Sie Folgendes, um eine `POST` Anfrage für den `Condition` Ressourcentyp zu stellen. Bei dieser Suche werden Stellen in Ihrem HealthLake Datenspeicher gefunden, die den medizinischen Code enthalten`72892002`.

Sie müssen eine Anfrage-URL und einen Anfragetext angeben. Hier ist ein Beispiel für eine Anfrage-URL.

```
POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Condition/_search
```

Um den medizinischen Code anzugeben, den Sie durchsuchen möchten, fügen Sie dem Anfragetext das folgende JSON-Element hinzu.

```
code=72892002
```

------
#### [ DocumentReference ]

Um die Ergebnisse der HealthLake integrierten Verarbeitung natürlicher Sprache (NLP) zu sehen, wenn Sie eine `POST` Anfrage für den `DocumentReference` Ressourcentyp stellen, formatieren Sie eine Anfrage wie folgt.

```
POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/DocumentReference/_search
```

Informationen zur Angabe der `DocumentReference` Suchparameter, auf die verwiesen werden soll, finden Sie unter[Suchparametertypen](reference-fhir-search-parameters.md#search-parameter-types). Die folgende Abfragezeichenfolge verwendet mehrere Suchparameter für die Suche nach Amazon Comprehend Medical API-Operationen, die zur Generierung der integrierten NLP-Ergebnisse verwendet werden.

```
_lastUpdated=le2021-12-19&infer-icd10cm-entity-text-concept-score;=streptococcal|0.6&infer-rxnorm-entity-text-concept-score=Amoxicillin|0.8
```

------
#### [ Location ]

Verwenden Sie das folgende Beispiel, um eine `POST` Anfrage für den Ressourcentyp zu stellen. `Location` Bei der Suche werden Standorte in Ihrem HealthLake Datenspeicher gefunden, die den Stadtnamen Boston als Teil der Adresse enthalten.

Sie müssen eine Anfrage-URL und einen Anfragetext angeben. Hier ist ein Beispiel für eine Anfrage-URL.

```
POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Location/_search
```

Um dies `Boston` in der Suche zu spezifizieren, fügen Sie dem Anfragetext das folgende Element hinzu:

```
address=Boston
```

------
#### [ Observation ]

Verwenden Sie das folgende Beispiel, um eine `POST` basierte Suchanfrage für den `Observation` Ressourcentyp zu stellen. Die Suche verwendet den `value-concept` Suchparameter, um nach medizinischem Code zu suchen, der `266919005` darauf hinweist`Never smoker`.

```
POST https://healthlake.region.amazonaws.com/datastore/datastoreId/r4/Observation/_search
```

Um den Status anzugeben`Never smoker`, der `value-concept=266919005` im Hauptteil der JSON-Datei festgelegt wird.

```
value-concept=266919005
```

------

# Konsistenzstufen für die FHIR-Suche
<a name="searching-fhir-consistency-levels"></a>

 HealthLakeDer Suchindex von AWS basiert auf einem Eventual Consistency Model für `GET` und `POST` mit SEARCH-Vorgängen. Bei eventueller Konsistenz schließen die Suchergebnisse Version N-1 der Ressource aus, wenn ein Suchindex-Update für eine Ressource aussteht, bis die Indexaktualisierung abgeschlossen ist.

 AWS bietet HealthLake jetzt die Möglichkeit, auszuwählen, wie sich das Konsistenzmodell für aktualisierte Ressourcen verhalten soll. Entwickler können entweder „Eventual Consistency“, das oben beschriebene Standardverhalten, oder „Strong Consistency“ angeben. Strong Consistency ermöglicht es, die N-1-Version der Ressource für Ressourcen mit ausstehenden Aktualisierungen des Suchindexes in die Suchergebnisse aufzunehmen. Dies kann für Anwendungsszenarien verwendet werden, in denen alle Ressourcen für das Ergebnis benötigt werden, auch wenn die Aktualisierung des Suchindex noch nicht abgeschlossen ist. Kunden können dieses Verhalten mithilfe des `x-amz-fhir-history-consistency-level` Anforderungsheaders steuern. 

## Konsistenzstufen
<a name="fhir-search-consistency-levels"></a>

Starke Konsistenz  
Legt fest`x-amz-fhir-history-consistency-level: strong`, dass alle übereinstimmenden Datensätze zurückgegeben werden, auch solche mit ausstehenden Aktualisierungen des Suchindexes. Verwenden Sie diese Option, wenn Sie unmittelbar nach Aktualisierungen nach Ressourcen suchen müssen.

Letztendliche Datenkonsistenz  
Legt fest`x-amz-fhir-history-consistency-level: eventual`, dass nur Datensätze zurückgegeben werden, für die die Aktualisierung des Suchindex abgeschlossen wurde. Dies ist das Standardverhalten, wenn keine Konsistenzstufe angegeben ist.

## Verwendungsbeispiel
<a name="fhir-search-usage"></a>

1. Gehen Sie beim Aktualisieren einer Ressource wie folgt vor:

   ```
   POST <baseURL>/Patient
   Content-Type: application/fhir+json
   x-amz-fhir-history-consistency-level: strong
   
   {
     "resourceType": "Patient",
     "id": "123",
     "meta": {
       "profile": ["http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient"]
     },
     "identifier": [
       {
         "system": "http://example.org/identifiers",
         "value": "123"
       }
     ],
     "active": true,
     "name": [
       {
         "family": "Smith",
         "given": ["John"]
       }
     ],
     "gender": "male",
     "birthDate": "1970-01-01"
   }
   ```

1. Nachfolgende Suche:

   ```
   GET <baseURL>/Patient?_id=123
   ```

## Best Practices
<a name="fhir-search-best-practices"></a>
+ Verwenden Sie starke Konsistenz, wenn Sie sofort nach kürzlich aktualisierten Ressourcen suchen müssen
+ Verwenden Sie Eventual-Konsistenz für allgemeine Abfragen, bei denen sofortige Sichtbarkeit nicht entscheidend ist
+ Berücksichtigen Sie den Kompromiss zwischen sofortiger Sichtbarkeit und potenziellen Auswirkungen auf die Leistung

**Anmerkung**  
Die Einstellung der Konsistenzstufe wirkt sich darauf aus, wie schnell aktualisierte Ressourcen in den Suchergebnissen angezeigt werden, hat jedoch keinen Einfluss auf die tatsächliche Speicherung der Ressourcen.  
Wenn der optionale `x-amz-fhir-history-consistency-level` Header auf „strong“ gesetzt wird, verdoppelt sich der Schreibkapazitätsverbrauch pro Ressource.  
Diese Funktion ist nur für Datenspeicher verfügbar, bei denen der Versionsverlauf aktiviert ist (bei allen Datenspeichern, die nach dem 25. Oktober 2024 erstellt wurden, ist sie standardmäßig aktiviert).