Actualizar Punto Final
Crear, sustituir o restaurar un recurso de punto final de 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/r4/Endpoint/{rid}
URL base: https://<ddfs-instance-id>.ddfs.<region>.oci.oraclecloud.com/api/fhir/r4
Ejemplo de solicitud: PUT /api/fhir/r4/Endpoint/00000000-0000-4000-8000-000000000005
URL de ejemplo: https://<ddfs-instance-id>.ddfs.<region>.oci.oraclecloud.com/api/fhir/r4/Endpoint/00000000-0000-4000-8000-000000000005
Cabeceras
{"Accept":"application/fhir+json","Authorization":"Bearer [REDACTED]","Content-Type":"application/fhir+json"}
Parámetros
| Parámetro | Entrante | Necesario | Tipo | Descripción |
|---|---|---|---|---|
rid |
ruta de acceso | verdadero | Cadena de ID lógico de FHIR | ID lógico del recurso de punto final. 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/Endpoint.u para una actualización activa; system/Endpoint.cu para la creación o restauración. |
| Solicitud de otorgamiento/token de cliente | ddfssystem/Endpoint.u para una actualización activa; ddfssystem/Endpoint.cu para la creación o restauración. |
Reclamación scope del token emitido |
system/Endpoint.u para una actualización activa; system/Endpoint.cu para la creación o restauración. |
Ejemplo de solicitud
{"resourceType":"Endpoint","identifier":[{"system":"https://example.com/fhir/identifier/endpoint","value":"documentation-example"}],"status":"active","connectionType":{"system":"http://terminology.hl7.org/CodeSystem/endpoint-connection-type","code":"hl7-fhir-rest"},"payloadType":[{"coding":[{"system":"http://terminology.hl7.org/CodeSystem/data-absent-reason","code":"not-applicable","display":"Not applicable"}]}],"address":"https://example.com/fhir","managingOrganization":{"reference":"Organization/00000000-0000-4000-8000-000000000009"},"meta":{"tag":[{"system":"https://example.com/fhir/tag","code":"documentation-example","display":"Documentation example"},{"system":"https://example.com/fhir/tag/phase","code":"updated","display":"Updated example"}]},"name":"Example endpoint","id":"00000000-0000-4000-8000-000000000005"}
Respuesta de ejemplo
{
"resourceType": "Endpoint",
"connectionType": {
"system": "http://terminology.hl7.org/CodeSystem/endpoint-connection-type",
"code": "hl7-fhir-rest"
},
"payloadType": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/data-absent-reason",
"code": "not-applicable",
"display": "Not applicable"
}
]
}
],
"id": "00000000-0000-4000-8000-000000000005",
"meta": {
"versionId": "2",
"lastUpdated": "2020-01-01T00:00:00Z",
"profile": [],
"security": [],
"tag": [
{
"system": "https://example.com/fhir/tag",
"code": "documentation-example",
"display": "Documentation example"
},
{
"system": "https://example.com/fhir/tag/phase",
"code": "updated",
"display": "Updated example"
}
]
},
"identifier": [
{
"system": "https://example.com/fhir/identifier/endpoint",
"value": "documentation-example"
}
],
"status": "active",
"name": "Example endpoint",
"managingOrganization": {
"reference": "Organization/00000000-0000-4000-8000-000000000009"
},
"contact": [],
"address": "https://example.com/fhir",
"header": []
}
Comportamiento
Crea un punto final en 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/r4/Endpoint/00000000-0000-4000-8000-000000000005 `
-H 'Accept: application/fhir+json' `
-H 'Authorization: Bearer [REDACTED]' `
-H 'Content-Type: application/fhir+json' `
--data '{"resourceType":"Endpoint","identifier":[{"system":"https://example.com/fhir/identifier/endpoint","value":"documentation-example"}],"status":"active","connectionType":{"system":"http://terminology.hl7.org/CodeSystem/endpoint-connection-type","code":"hl7-fhir-rest"},"payloadType":[{"coding":[{"system":"http://terminology.hl7.org/CodeSystem/data-absent-reason","code":"not-applicable","display":"Not applicable"}]}],"address":"https://example.com/fhir","managingOrganization":{"reference":"Organization/00000000-0000-4000-8000-000000000009"},"meta":{"tag":[{"system":"https://example.com/fhir/tag","code":"documentation-example","display":"Documentation example"},{"system":"https://example.com/fhir/tag/phase","code":"updated","display":"Updated example"}]},"name":"Example endpoint","id":"00000000-0000-4000-8000-000000000005"}'
Códigos de Estado
| Código | Estado |
|---|---|
| 200 | Se actualizó el recurso activo. |
| 201 | Se ha creado o restaurado el recurso. |
Definición de FHIR
Canónico: https://hl7.org/fhir/R4/endpoint.html