Actualizar ubicación
Cree, reemplace o restaure un recurso de ubicación 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/r6-ballot4/Location/{rid}
URL base: https://<ddfs-instance-id>.ddfs.<region>.oci.oraclecloud.com/api/fhir/r6-ballot4
Ejemplo de solicitud: PUT /api/fhir/r6-ballot4/Location/00000000-0000-4000-8000-000000000003
URL de ejemplo: https://<ddfs-instance-id>.ddfs.<region>.oci.oraclecloud.com/api/fhir/r6-ballot4/Location/00000000-0000-4000-8000-000000000003
Los ejemplos utilizan identificadores y valores ilustrativos.
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 ubicación. 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/Location.u para una actualización activa; system/Location.cu para la creación o restauración. |
| Solicitud de otorgamiento/token de cliente | ddfssystem/Location.u para una actualización activa; ddfssystem/Location.cu para la creación o restauración. |
Reclamación scope del token emitido |
system/Location.u para una actualización activa; system/Location.cu para la creación o restauración. |
Ejemplo de solicitud
{"resourceType":"Location","identifier":[{"system":"https://example.com/fhir/identifier/Location","value":"example-resource"}],"status":"active","name":"Example clinic","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"}]},"address":{"city":"Austin","state":"TX","postalCode":"78701","line":["100 Example Way"]},"form":{"coding":[{"system":"http://terminology.hl7.org/CodeSystem/location-physical-type","code":"ro","display":"Room"}]},"id":"00000000-0000-4000-8000-000000000003"}
Ejemplo de respuesta
{
"resourceType": "Location",
"id": "00000000-0000-4000-8000-000000000003",
"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/Location",
"value": "example-resource"
}
],
"status": "active",
"code": [],
"name": "Example clinic",
"alias": [],
"type": [],
"contact": [],
"address": {
"line": [
"100 Example Way"
],
"city": "Austin",
"state": "TX",
"postalCode": "78701"
},
"form": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/location-physical-type",
"code": "ro",
"display": "Room"
}
]
},
"characteristic": [],
"virtualService": [],
"endpoint": []
}
Comportamiento
Crea una ubicación 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/r6-ballot4/Location/00000000-0000-4000-8000-000000000003 `
-H 'Accept: application/fhir+json' `
-H 'Authorization: Bearer [REDACTED]' `
-H 'Content-Type: application/fhir+json' `
--data '{"resourceType":"Location","identifier":[{"system":"https://example.com/fhir/identifier/Location","value":"example-resource"}],"status":"active","name":"Example clinic","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"}]},"address":{"city":"Austin","state":"TX","postalCode":"78701","line":["100 Example Way"]},"form":{"coding":[{"system":"http://terminology.hl7.org/CodeSystem/location-physical-type","code":"ro","display":"Room"}]},"id":"00000000-0000-4000-8000-000000000003"}'
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/6.0.0-ballot4/location.html