Actualizar dispositivo

Cree, reemplace o restaure un recurso de dispositivo FHIR mediante un ID lógico.

Creación y restauración de PUT

Una PUT a un ID no utilizado crea esa identidad; una PUT a un recurso suprimido lógicamente la restaura. Ambos devuelven 201 Created y necesitan permiso de creación y actualización. La actualización de un recurso activo devuelve 200 OK y necesita permiso de actualización. Para obtener información sobre la sintaxis, las cabeceras, las condiciones previas de la versión, el comportamiento del lote y la disponibilidad del ID, consulte Create, Update, and Restore Resources with PUT.

Punto final

PUT /api/fhir/r6-ballot4/Device/{rid}

URL base: https://<ddfs-instance-id>.ddfs.<region>.oci.oraclecloud.com/api/fhir/r6-ballot4

Ejemplo de solicitud: PUT /api/fhir/r6-ballot4/Device/00000000-0000-4000-8000-000000000004

URL de ejemplo: https://<ddfs-instance-id>.ddfs.<region>.oci.oraclecloud.com/api/fhir/r6-ballot4/Device/00000000-0000-4000-8000-000000000004

Los ejemplos utilizan identificadores y valores ilustrativos.

Cabeceras

{"Accept":"application/fhir+json","Authorization":"Bearer [REDACTED]","Content-Type":"application/fhir+json"}

Parámetros

ParámetroEntranteNecesarioTipoDescripción
rid ruta de acceso verdadero Cadena de ID lógico de FHIR ID lógico del recurso Device. Utilice el ID lógico del recurso.

Condiciones previas de la versión

También puede enviar ETag desde la última lectura como If-Match, por ejemplo If-Match: W/"4". Una condición que no coincide devuelve 412 Precondition Failed sin aplicar la PUT; las cabeceras con formato incorrecto devuelven 400. Omitir la cabecera no protege frente a cambios simultáneos. Una condición proporcionada no puede crear un ID no utilizado. Consulte Actualización con If-Match.

Autorización

El modelo de autorización soportado utiliza ámbitos de OAuth 2.0 emitidos por los dominios de identidad de OCI. Envíe el token de acceso como un token de portador. Las definiciones de servidor de recursos y las reclamaciones de token de acceso emitidas utilizan ámbitos canónicos system/.... Los permisos de cliente y las solicitudes de token utilizan el formulario ddfssystem/... correspondiente. Para ver ejemplos, consulte Reference: Authentication and Scopes.

Contexto Forma de ámbito
Definición de servidor de recursos system/Device.u para una actualización activa; system/Device.cu para la creación o restauración.
Solicitud de otorgamiento/token de cliente ddfssystem/Device.u para una actualización activa; ddfssystem/Device.cu para la creación o restauración.
Reclamación scope del token emitido system/Device.u para una actualización activa; system/Device.cu para la creación o restauración.

Ejemplo de solicitud

{"resourceType":"Device","identifier":[{"system":"https://example.com/fhir/identifier/Device","value":"example-resource"}],"meta":{"tag":[{"system":"https://example.com/fhir/tag","code":"example-resource","display":"Example resource"},{"system":"https://example.com/fhir/tag/phase","code":"updated","display":"Example update"}]},"manufacturer":"Example Medical Device Company","modelNumber":"ExampleModel","id":"00000000-0000-4000-8000-000000000004"}

Respuesta de ejemplo

{
  "resourceType": "Device",
  "id": "00000000-0000-4000-8000-000000000004",
  "meta": {
    "versionId": "2",
    "lastUpdated": "2025-01-01T00:00:00Z",
    "profile": [],
    "security": [],
    "tag": [
      {
        "system": "https://example.com/fhir/tag",
        "code": "example-resource",
        "display": "Example resource"
      },
      {
        "system": "https://example.com/fhir/tag/phase",
        "code": "updated",
        "display": "Example update"
      }
    ]
  },
  "identifier": [
    {
      "system": "https://example.com/fhir/identifier/Device",
      "value": "example-resource"
    }
  ],
  "manufacturer": "Example Medical Device Company",
  "modelNumber": "ExampleModel"
}

Comportamiento

Crea un dispositivo con un ID lógico no utilizado, sustituye un recurso activo existente o restaura un recurso suprimido lógicamente. El tipo de recurso de cuerpo y el ID deben coincidir con la ruta de solicitud. La creación y la restauración devuelven 201; la sustitución en directo devuelve 200. Consulte Creación y restauración de PUT para conocer las cabeceras de respuesta y el comportamiento del historial.

Ejemplo de cURL

curl.exe `
  -sS `
  -X PUT `
  https://<ddfs-instance-id>.ddfs.<region>.oci.oraclecloud.com/api/fhir/r6-ballot4/Device/00000000-0000-4000-8000-000000000004 `
  -H 'Accept: application/fhir+json' `
  -H 'Authorization: Bearer [REDACTED]' `
  -H 'Content-Type: application/fhir+json' `
  --data '{"resourceType":"Device","identifier":[{"system":"https://example.com/fhir/identifier/Device","value":"example-resource"}],"meta":{"tag":[{"system":"https://example.com/fhir/tag","code":"example-resource","display":"Example resource"},{"system":"https://example.com/fhir/tag/phase","code":"updated","display":"Example update"}]},"manufacturer":"Example Medical Device Company","modelNumber":"ExampleModel","id":"00000000-0000-4000-8000-000000000004"}'

Códigos de Estado

CódigoEstado
200Se actualizó el recurso activo.
201Se ha creado o restaurado el recurso.

Definición de FHIR

Canónico: https://hl7.org/fhir/6.0.0-ballot4/device.html

Operaciones relacionadas