As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Modificando recursos com a operação PATCH

AWS HealthLake suporta a operação PATCH para recursos do FHIR, permitindo que você modifique recursos direcionando elementos específicos para adicionar, substituir ou excluir sem atualizar o recurso inteiro. Essa operação é particularmente útil quando você precisa:

Formatos PATCH suportados

AWS HealthLake suporta dois formatos PATCH padrão:

Correção JSON (RFC 6902)

Usa a sintaxe JSON Pointer para direcionar elementos de acordo com sua posição na estrutura do recurso.

Tipo de conteúdo: application/json-patch+json

FHIRPath Patch (especificação FHIR R4)

Usa FHIRPath expressões para direcionar elementos de acordo com seu conteúdo e relacionamentos, fornecendo uma abordagem nativa do FHIR para a aplicação de patches.

Tipo de conteúdo: application/fhir+json

Usage

Operações diretas de PATCH

A operação PATCH pode ser invocada diretamente nos recursos do FHIR usando o método PATCH HTTP:

PATCH [base]/[resource-type]/[id]{?_format=[mime-type]}

PATCH em pacotes

As operações PATCH podem ser incluídas como entradas em pacotes FHIR do tipo batch outransaction, permitindo que você combine operações de patch com outras interações FHIR (criar, ler, atualizar, excluir) em uma única solicitação.

Formato de patch JSON

Operações com Suporte

Sintaxe do caminho

O JSON Patch usa a sintaxe JSON Pointer (RFC 6901):

Exemplos

Solicitação direta de patch JSON com várias operações

PATCH [base]/Patient/example
Content-Type: application/json-patch+json
If-Match: W/"1"

[
  {
    "op": "replace",
    "path": "/name/0/family",
    "value": "Smith"
  },
  {
    "op": "add",
    "path": "/telecom/-",
    "value": {
      "system": "phone",
      "value": "555-555-5555",
      "use": "home"
    }
  },
  {
    "op": "remove",
    "path": "/address/0"
  },
  {
    "op": "move",
    "from": "/name/0/family",
    "path": "/name/1/family"
  },
  {
    "op": "test",
    "path": "/gender",
    "value": "male"
  },
  {
    "op": "copy",
    "from": "/name/0",
    "path": "/name/1"
  }
]

Solicitação direta de patch JSON com operação única

PATCH [base]/Patient/example
Content-Type: application/json-patch+json

[
  {
    "op": "replace",
    "path": "/active",
    "value": false
  }
]

Patch JSON no pacote

Use um recurso binário contendo a carga útil do patch JSON codificada em base64:

{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [{
    "resource": {
      "resourceType": "Binary",
      "contentType": "application/json-patch+json",
      "data": "W3sib3AiOiJhZGQiLCJwYXRoIjoiL2JpcnRoRGF0ZSIsInZhbHVlIjoiMTk5MC0wMS0wMSJ9XQ=="
    },
    "request": {
      "method": "PATCH",
      "url": "Patient/123"
    }
  }]
}

FHIRPath Formato do patch

Operações com Suporte

Sintaxe do caminho

FHIRPath O patch usa FHIRPath expressões, oferecendo suporte a:

Exemplos

Solicitação direta FHIRPath de patch

PATCH [base]/Patient/123
Content-Type: application/fhir+json
Authorization: ...

{
  "resourceType": "Parameters",
  "parameter": [{
    "name": "operation",
    "part": [
      { "name": "type", "valueCode": "add" },
      { "name": "path", "valueString": "Patient" },
      { "name": "name", "valueString": "birthDate" },
      { "name": "value", "valueDate": "1990-01-01" }
    ]
  }]
}

FHIRPath Patch no pacote

Use um recurso de Parâmetros como recurso de entrada commethod: PATCH:

{
  "resourceType": "Bundle",
  "type": "transaction",
  "entry": [{
    "resource": {
      "resourceType": "Parameters",
      "parameter": [{
        "name": "operation",
        "part": [
          { "name": "type", "valueCode": "add" },
          { "name": "path", "valueString": "Patient" },
          { "name": "name", "valueString": "birthDate" },
          { "name": "value", "valueDate": "1990-01-01" }
        ]
      }]
    },
    "request": {
      "method": "PATCH",
      "url": "Patient/123"
    }
  }]
}

Cabeçalhos de solicitação

Resposta da amostra

A operação retorna o recurso atualizado com as informações da nova versão:

HTTP/1.1 200 OK
Content-Type: application/fhir+json
ETag: W/"2"
Last-Modified: Mon, 05 May 2025 10:10:10 GMT

{
  "resourceType": "Patient",
  "id": "example",
  "active": true,
  "name": [
    {
      "family": "Smith",
      "given": ["John"]
    }
  ],
  "telecom": [
    {
      "system": "phone",
      "value": "555-555-5555",
      "use": "home"
    }
  ],
  "meta": {
    "versionId": "2",
    "lastUpdated": "2025-05-05T10:10:10Z"
  }
}

Comportamento

A operação PATCH:

Tratamento de erros

A operação trata das seguintes condições de erro:

Resumo dos recursos

Limitações

Recursos adicionais

Para obter mais informações sobre as operações PATCH, consulte: