You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
title: Support for url customization for the DICOM service in Azure Health Data Services
3
-
description: Learn how to customize the url of the image location that is in response object.
2
+
title: Support for URL customization for the DICOM service in Azure Health Data Services
3
+
description: Learn how to customize the URL of the image location that is in response object.
4
4
author: varunbms
5
5
ms.service: azure-health-data-services
6
6
ms.subservice: fhir
@@ -10,28 +10,28 @@ ms.author: buchvarun
10
10
---
11
11
12
12
# What is URL manipulation
13
-
URl manipulation allows customizing url of the image location that is in response object.
13
+
URL manipulation allows customizing URL of the image location that is in response object.
14
14
15
-
Dicom service returns the fully qualified url of the image location in response object under dicom tag (UR) in the response object of following api operations:
15
+
DICOM service returns the fully qualified URL of the image location in response object under DICOM tag (UR) in the response object of following API operations:
16
16
1. Retrieve Instance
17
17
2. Retrieve WorkItems
18
18
3. Retrieve OperationStatus
19
19
4. Resolve QueryTag
20
20
5. Resolve QueryTagError
21
21
22
-
An example of fully qualified image location of url in the standard response for a stow operation for a dicom service that has data partition enabled with partition name "foo" is as below:
22
+
An example of fully qualified image location of URL in the standard response for a STOW operation for a DICOM service that has data partition enabled with partition name "foo" is as below:
To breakdown the structure of the above url, it consists of following three parts:
27
-
1. hostname -> `https://localhost:63838` (the hostname of dicom service)
28
-
2. path -> `v2/partitions/foo` (path that represents the version of dicom service being used and the datapartition name if it enabled)
29
-
3.Dicom web standard path -> `studies/1.2.826.0.1.3680043.8.498.13230779778012324449356534479549187420/series/1.2.826.0.1.3680043.8.498.77033797676425927098669402985243398207/instances/1.2.826.0.1.3680043.8.498.13273713909719068980354078852867170114`
26
+
To breakdown the structure of the above URL, it consists of following three parts:
27
+
1. hostname -> `https://localhost:63838` (the hostname of DICOM service)
28
+
2. path -> `v2/partitions/foo` (path that represents the version of DICOM service being used and the datapartition name if it enabled)
29
+
3.DICOM web standard path -> `studies/1.2.826.0.1.3680043.8.498.13230779778012324449356534479549187420/series/1.2.826.0.1.3680043.8.498.77033797676425927098669402985243398207/instances/1.2.826.0.1.3680043.8.498.13273713909719068980354078852867170114`
30
30
31
-
This feature will allow to customize the path of the image url, if directed by client based on the request headers they have provided.
31
+
This feature will allow to customize the path of the image URL, if directed by client based on the request headers they have provided.
32
32
33
33
# How it works
34
-
The modified url will be based on following two headers:
34
+
The modified URL will be based on following two headers:
35
35
1. X-Forwarded-Host: This represents the domain name of the original host (the one the client requested before the proxy or load balancer handled the request). Example: `X-Forwarded-Host: www.example.com`
36
36
37
37
2. X-Forwarded-Prefix: This represents the original URL path or prefix that was part of the client’s request before the proxy forwarded or changed the request.
@@ -45,49 +45,49 @@ If x-forwarded-host header is present in the request object, it would replace th
45
45
46
46
if x-forwarded-prefix header is present in the request object, it would replace the path with the value provided.
47
47
48
-
# List of API that can use forwarded headers for url manipulation
48
+
# List of API that can use forwarded headers for URL manipulation
49
49
50
50
### STOW, WADO, worklist, operation status, querytag and querytagerror APIs
51
51
52
-
Details of a request header for a stow operation with the forwarded headers:
52
+
Details of a request header for a STOW operation with the forwarded headers:
1. Forwarded headers donot have to be used together. If there is a need to just replace hostname and not path, only forwarded host header can be used. Similarly, if there is a need to just replace path, only forwared prefix header can be used.
89
+
1. Forwarded headers do not have to be used together. If there is a need to just replace hostname and not path, only forwarded host header can be used. Similarly, if there is a need to just replace path, only forwared prefix header can be used.
90
90
91
-
2. Client is responsible for mapping the hostname and path provided in forwarded headers with correct dicom service hostname and pathbase.
91
+
2. Client is responsible for mapping the hostname and path provided in forwarded headers with correct DICOM service hostname and pathbase.
0 commit comments