

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à.

# Creazione di una risorsa FHIR
<a name="managing-fhir-resources-create"></a>

L'`create`interazione FHIR crea una nuova risorsa FHIR in un HealthLake archivio dati. Per ulteriori informazioni, consulta la documentazione dell'[https://hl7.org/fhir/R4/http.html#create](https://hl7.org/fhir/R4/http.html#create)API **FHIR RESTful R4**.

**Per creare una risorsa FHIR**  


1. Colleziona 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 FHIR `Resource` da creare. 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 da creare. Per visualizzare l'intero percorso dell'URL nell'esempio seguente, scorri il pulsante **Copia**.

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

1. Costruisci un corpo JSON per la richiesta, specificando i dati FHIR per la nuova risorsa. Ai fini di questa procedura, stiamo usando una `Patient` risorsa FHIR, quindi salva il file con nome. `create-patient.json`

   ```
   {
       "resourceType": "Patient",
       "identifier": [
           {
               "system": "urn:oid:1.2.36.146.595.217.0.1",
               "value": "12345"
           }
       ],
       "name": [
           {
               "family": "Silva",
               "given": [
                   "Ana",
                   "Carolina"
               ]
           }
       ],
       "gender": "female",
       "birthDate": "1992-02-10"
   }
   ```

1. Inviare la richiesta . L'`create`interazione FHIR utilizza una `POST` richiesta con autorizzazione [AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) o SMART on FHIR. Gli esempi seguenti creano una `Patient` risorsa FHIR HealthLake utilizzando curl o la Console. HealthLake Per visualizzare un intero esempio, scorri il pulsante **Copia**.

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

   Autorizzazione SIGv4

   ```
   curl --request POST \
     'https://healthlake.region.amazonaws.com/datastore/datastore-id/r4/Patient' \
     --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' \
     --data @create-patient.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.AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html)

   1. Accedi alla pagina [Esegui interrogazione](https://console.aws.amazon.com/healthlake/home#/crud) sulla Console. HealthLake 

   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`Create`.
   + **Tipo di risorsa**: scegli il [tipo di risorsa](reference-fhir-resource-types.md) FHIR da creare.
   + **Corpo della richiesta**: crea un corpo JSON per la richiesta, specificando i dati FHIR per la nuova risorsa.

   3. Scegli **Esegui query**.

------

**Configurazione del livello di convalida per la creazione di risorse**  


Quando si crea una risorsa FHIR, è possibile specificare facoltativamente un'intestazione `x-amzn-healthlake-fhir-validation-level` HTTP per configurare un livello di convalida per la risorsa. AWS HealthLake attualmente supporta i seguenti livelli di convalida:
+ `strict`: Le risorse vengono convalidate in base all'elemento del profilo della risorsa o alla specifica R4 se non è presente alcun profilo. Questo è il livello di convalida predefinito per. AWS HealthLake
+ `structure-only`: Le risorse vengono convalidate rispetto a R4, ignorando i profili di riferimento.
+ `minimal`: Le risorse vengono convalidate minimamente, ignorando alcune regole R4. Le risorse che non superano i controlli di struttura richiesti search/analytics verranno aggiornate per includere un avviso per l'audit.

Le risorse create con il livello di convalida minimo possono essere inserite in un Datastore nonostante la mancata convalida richiesta per l'indicizzazione della ricerca. In questo caso, le risorse verranno aggiornate per includere un'estensione specifica di Healthlake per documentare tali errori:

```
{
    "url": "http://healthlake.amazonaws.com/fhir/StructureDefinition/validation-issue",
    "valueString": "{\"resourceType\":\"OperationOutcome\",\"issue\":[{\"severity\":\"error\",\"code\":\"processing\",\"details\":{\"text\":\"FHIR resource in payload failed FHIR validation rules.\"},\"diagnostics\":\"FHIR resource in payload failed FHIR validation rules.\"}]}"
}
```

Inoltre, la seguente intestazione di risposta HTTP verrà inclusa con il valore «true»:

```
x-amzn-healthlake-validation-issues : true
```

**Nota**  
I dati inseriti che presentano un formato errato secondo la specifica R4 potrebbero non essere ricercabili come previsto se sono presenti questi errori.