Azure Health Data Services
An Azure offering that provides a suite of purpose-built technologies for protected health information in the cloud.
Azure FHIR Service Error - Transaction failed error
![](data:image/svg+xml, %3Csvg xmlns='http://www.w3.org/2000/svg' height='64' class='font-weight-bold' style='font: 600 30.11764705882353px "SegoeUI", Arial' width='64'%3E%3Ccircle fill='hsl(115.19999999999999, 54%, 21%)' cx='32' cy='32' r='32' /%3E%3Ctext x='50%25' y='55%25' dominant-baseline='middle' text-anchor='middle' fill='%23FFF' %3ERB%3C/text%3E%3C/svg%3E)
R, Bharathkumar
0
Reputation points
I'm getting this error for a specific resource, with no exact reason as to why the operation is failing. Is there any way to find why exactly its failing.
An error occurred: {"resourceType":"OperationOutcome","id":"15797acb-cfc9-4ac1-b7ec-f753563faf91","meta":{"lastUpdated":"2025-11-03T12:57:53.837389+00:00"},"issue":[{"severity":"error","code":"processing","diagnostics":"Transaction failed on 'PUT' for the requested url '/Encounter/abc'."},{"severity":"error","code":"exception","diagnostics":"An internal error has occurred. If this problem persists, please contact Customer Support."}]}
Azure Health Data Services
{count} votes
-
![](data:image/svg+xml, %3Csvg xmlns='http://www.w3.org/2000/svg' height='64' class='font-weight-bold' style='font: 600 30.11764705882353px "SegoeUI", Arial' width='64'%3E%3Ccircle fill='hsl(236.8, 56.00000000000001%, 32%)' cx='32' cy='32' r='32' /%3E%3Ctext x='50%25' y='55%25' dominant-baseline='middle' text-anchor='middle' fill='%23FFF' %3EPK%3C/text%3E%3C/svg%3E)
Pashikanti Kumar 1,725 Reputation points Microsoft External Staff Moderator2025-11-03T17:08:52.6433333+00:00 Hi R, Bharathkumar,
Thank you for posting your question in the Microsoft Q&A forum
The "Transaction failed" error in Azure FHIR Service typically occurs due to issues with the resource being processed or the operation itself. The error message indicates that the PUT operation for the resource /Encounter/abc failed.
1: Validate the Resource Structure
a. Check the Resource Format:
Ensure the Encounter resource conforms to the FHIR standard.
Validate the JSON structure using a FHIR validator tool (e.g., FHIR Validator).
b. Verify Required Fields:
Ensure all mandatory fields for the Encounter resource are present, such as:
status
class
subject (reference to the patient)
Missing or invalid fields can cause processing errors.
Check for Resource Conflicts
Verify Resource ID
Ensure the resource ID (abc) is unique and not conflicting with an existing resource in the FHIR store.
If you're trying to update an existing resource, confirm that the resource exists in the store.
- Check for Version Conflicts:
If the resource already exists, ensure you are using the correct version (meta.versionId) for the update.
Azure FHIR Service uses optimistic concurrency, so mismatched versions can result in errors.
Inspect Permissions and Authentication
Check Access Permissions:
Ensure the Azure FHIR Service has the correct RBAC roles assigned to your user or application.
- Roles like FHIR Data Contributor or FHIR Data Reader are required for resource operations.
Analyze Logs and Diagnostics
- Enable Diagnostic Logs:
Go to the Azure Portal > FHIR Service > Diagnostic Settings.
Enable logging for Audit Logs and Metrics.
Check the logs for detailed error messages or additional context about the failed transaction.
I hope the provided answer is helpful,
Please "Up Vote" if the information helped you. This will help us and others in the community as well.
Thank you.
-
![](data:image/svg+xml, %3Csvg xmlns='http://www.w3.org/2000/svg' height='64' class='font-weight-bold' style='font: 600 30.11764705882353px "SegoeUI", Arial' width='64'%3E%3Ccircle fill='hsl(73.60000000000001, 77%, 17%)' cx='32' cy='32' r='32' /%3E%3Ctext x='50%25' y='55%25' dominant-baseline='middle' text-anchor='middle' fill='%23FFF' %3ERM%3C/text%3E%3C/svg%3E)
Rakesh Mishra 4,030 Reputation points Microsoft External Staff Moderator2025-11-04T12:48:38.99+00:00 Hi @R, Bharathkumar , following up to see if you had a chance to check previous response and if it was helpful. Please do let me know if you're still facing the issue and need any further assistance on this.
-
R, Bharathkumar 0 Reputation points
2025-11-05T12:54:53.9933333+00:00 - Resource does not exist
- Access is valid as operations work for other data
- Enabled diagnostic logs but not getting any details on it. Just resource id and status 500
-
Pashikanti Kumar 1,725 Reputation points Microsoft External Staff Moderator
2025-11-05T20:04:21.31+00:00 Hi R, Bharathkumar,
Double-check that the resource ID and URL match exactly an existing resource in your Azure FHIR service.
Confirm that you are querying within the correct FHIR store, subscription, and resource group context.
Ensure the resource has not been deleted or is not in an inconsistent state.
The generic "resource does not exist" error with limited logging on an otherwise accessible Azure FHIR service likely points to resource reference mismatches, API versioning conflicts, or hidden backend issues. Enable detailed diagnostics and escalate to Microsoft Support if needed, providing as much context as possible to facilitate root cause investigation
Reference
Deploy the FHIR service in Azure Health Data Services | Microsoft Learn
Resource not found errors - Azure Resource Manager | Microsoft Learn
Sign in to comment
Sign in to answer