Skip to content

Commit 503f404

Browse files
committed
markdown and editing updates
1 parent ef5d7da commit 503f404

File tree

4 files changed

+40
-40
lines changed

4 files changed

+40
-40
lines changed

articles/healthcare-apis/azure-api-for-fhir/configure-database.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -8,18 +8,19 @@ ms.topic: reference
88
ms.date: 09/27/2023
99
ms.author: kesheth
1010
---
11-
# Configure database settings
1211

13-
[!INCLUDE [retirement banner](../includes/healthcare-apis-azure-api-fhir-retirement.md)]
12+
# Configure database settings
1413

15-
Azure API for FHIR uses database to store its data. Performance of the underlying database depends on the number of Request Units (RU) selected during service provisioning or in database settings after the service has been provisioned.
14+
[!INCLUDE[retirement banner](../includes/healthcare-apis-azure-api-fhir-retirement.md)]
1615

17-
Azure API for FHIR borrows the concept of [Request Units (RUs) in Azure Cosmos DB](/azure/cosmos-db/request-units)) when setting the performance of underlying database.
16+
Azure API for FHIR® uses a database to store its data. Performance of the underlying database depends on the number of Request Units (RU) selected during service provisioning or in database settings after the service has been provisioned.
1817

19-
Throughput must be provisioned to ensure that sufficient system resources are available for your database at all times. How many RUs you need for your application depends on operations you perform. Operations can range from simple read and writes to more complex queries.
18+
Azure API for FHIR borrows the concept of [Request Units (RUs) in Azure Cosmos DB](/azure/cosmos-db/request-units) when setting the performance of underlying database.
19+
20+
Throughput must be provisioned to ensure that sufficient system resources are always available for your database. How many RUs you need for your application depends on operations you perform. Operations can range from simple read and writes to more complex queries.
2021

2122
> [!NOTE]
22-
> As different operations consume different number of RU, we return the actual number of RUs consumed in every API call in response header. This way you can profile the number of RUs consumed by your application.
23+
> As different operations consume a different number of RUs, we return the actual number of RUs consumed in every API call in the response header. This way you can profile the number of RUs consumed by your application.
2324
2425
## Update throughput
2526

@@ -28,7 +29,7 @@ To change this setting in the Azure portal, navigate to your Azure API for FHIR
2829
If the database throughput is greater than 10,000 RU/s or if the data stored in the database is more than 50 GB, your client application must be capable of handling continuation tokens. A new partition is created in the database for every throughput increase of 10,000 RU/s or if the amount of data stored is more than 50 GB. Multiple partitions create a multi-page response in which pagination is implemented by using continuation tokens.
2930

3031
> [!NOTE]
31-
> Higher value means higher Azure API for FHIR throughput and higher cost of the service.
32+
> A higher RU value means higher Azure API for FHIR throughput and higher cost of the service.
3233
3334
![Configure Azure Cosmos DB](media/database/database-settings.png)
3435

@@ -44,4 +45,4 @@ Or you can deploy a fully managed Azure API for FHIR:
4445
>[!div class="nextstepaction"]
4546
>[Deploy Azure API for FHIR](fhir-paas-portal-quickstart.md)
4647
47-
FHIR® is a registered trademark of [HL7](https://hl7.org/fhir/) and is used with the permission of HL7.
48+
[!INCLUDE[FHIR trademark statement](../includes/healthcare-apis-fhir-trademark.md)]

articles/healthcare-apis/azure-api-for-fhir/configure-export-data.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,9 @@ ms.author: kesheth
1111

1212
# Configure export settings in Azure API for FHIR
1313

14-
[!INCLUDE [retirement banner](../includes/healthcare-apis-azure-api-fhir-retirement.md)]
14+
[!INCLUDE[retirement banner](../includes/healthcare-apis-azure-api-fhir-retirement.md)]
1515

16-
Azure API for FHIR supports the $export command, which allows you to export the data out of an Azure API for FHIR instance to a storage account.
16+
Azure API for FHIR® supports the `$export` command, which allows you to export the data out of an Azure API for FHIR instance to a storage account.
1717

1818
The steps are:
1919

@@ -43,21 +43,21 @@ It's here that you add the role [Storage Blob Data Contributor](../../role-based
4343

4444
:::image type="content" source="~/reusable-content/ce-skilling/azure/media/role-based-access-control/add-role-assignment-page.png" alt-text="Screenshot showing RBAC assignment page." lightbox="~/reusable-content/ce-skilling/azure/media/role-based-access-control/add-role-assignment-page.png":::
4545

46-
Next, select the storage account in Azure API for FHIR as a default storage account for $export.
46+
Next, select the storage account in Azure API for FHIR as a default storage account for `$export`.
4747

4848
## Select the storage account for $export
4949

5050
The final step is to assign the Azure storage account to export the data to. Go to **Export** in Azure API for FHIR and then select the storage account.
5151

5252
:::image type="content" source="media/export-data/fhir-export-storage.png" alt-text="Screenshot showing selection of the storage account for export." lightbox="media/export-data/fhir-export-storage.png":::
5353

54-
After you complete this final step, you’re ready to export the data by using the $export command.
54+
After you complete this final step, you’re ready to export the data by using the `$export` command.
5555

5656
> [!Note]
57-
> Only storage accounts in the same subscription as Azure API for FHIR can be registered as the destination for $export operations.
57+
> Only storage accounts in the same subscription as Azure API for FHIR can be registered as the destination for `$export` operations.
5858
5959
## Next steps
6060

6161
[Additional settings](azure-api-for-fhir-additional-settings.md)
6262

63-
[!INCLUDE [FHIR trademark statement](../includes/healthcare-apis-fhir-trademark.md)]
63+
[!INCLUDE[FHIR trademark statement](../includes/healthcare-apis-fhir-trademark.md)]

articles/healthcare-apis/azure-api-for-fhir/configure-local-rbac.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -12,18 +12,18 @@ ms.devlang: azurecli
1212
---
1313
# Configure local RBAC for FHIR
1414

15-
[!INCLUDE [retirement banner](../includes/healthcare-apis-azure-api-fhir-retirement.md)]
15+
[!INCLUDE[retirement banner](../includes/healthcare-apis-azure-api-fhir-retirement.md)]
1616

17-
This article explains how to configure the Azure API for FHIR to use a secondary Microsoft Entra tenant for data access. Use this mode only if it isn't possible for you to use the Microsoft Entra tenant associated with your subscription.
17+
This article explains how to configure the Azure API for FHIR® to use a secondary Microsoft Entra tenant for data access. Use this mode only if it isn't possible for you to use the Microsoft Entra tenant associated with your subscription.
1818

1919
> [!NOTE]
2020
> If your FHIR service is configured to use your primary Microsoft Entra tenant associated with your subscription, [use Azure RBAC to assign data plane roles](configure-azure-rbac.md).
2121
2222
## Add a new service principal or use an existing one
2323

24-
Local RBAC allows you to use a service principal in the secondary Microsoft Entra tenant with your FHIR server. You can create a new service principal through the Azure portal, PowerShell or CLI commands, or use an existing service principal. The process is also known as [application registration](../register-application.md). You can review and modify the service principals through Microsoft Entra ID from the portal or using scripts.
24+
Local role-based access control (RBAC) allows you to use a service principal in the secondary Microsoft Entra tenant with your FHIR server. You can create a new service principal through the Azure portal, PowerShell or CLI commands, or use an existing service principal. The process is also known as [application registration](../register-application.md). You can review and modify the service principals through Microsoft Entra ID from the portal or using scripts.
2525

26-
The PowerShell and CLI scripts below, which are tested and validated in Visual Studio Code, create a new service principal (or client application), and add a client secret. The service principal ID is used for local RBAC and the application ID and client secret will be used to access the FHIR service later.
26+
The following PowerShell and CLI scripts, which are tested and validated in Visual Studio Code, create a new service principal (or client application), and add a client secret. The service principal ID is used for local RBAC and the application ID and client secret is used to access the FHIR service later.
2727

2828
You can use the `Az` PowerShell module:
2929

@@ -50,11 +50,11 @@ clientsecret=$(az ad app credential reset --id $appid --append --credential-desc
5050

5151
## Configure local RBAC
5252

53-
You can configure the Azure API for FHIR to use a secondary Microsoft Entra tenant in the **Authentication** blade:
53+
You can configure the Azure API for FHIR to use a secondary Microsoft Entra tenant in the **Authentication** blade.
5454

5555
![Local RBAC assignments](media/rbac/local-rbac-guids.png)
5656

57-
In the authority box, enter a valid secondary Microsoft Entra tenant. Once the tenant has been validated, the **Allowed object IDs** box should be activated and you can enter one or a list of Microsoft Entra service principal object IDs. These IDs can be the identity object IDs of:
57+
In the authority box, enter a valid secondary Microsoft Entra tenant. Once the tenant is validated, the **Allowed object IDs** box should be activated and you can enter one or a list of Microsoft Entra service principal object IDs. These IDs can be the identity object IDs of:
5858

5959
* A Microsoft Entra user.
6060
* A Microsoft Entra service principal.
@@ -71,16 +71,16 @@ The local RBAC setting is only visible from the authentication blade; it isn't v
7171
7272
## Caching behavior
7373

74-
The Azure API for FHIR will cache decisions for up to 5 minutes. If you grant a user access to the FHIR server by adding them to the list of allowed object IDs, or you remove them from the list, you should expect it to take up to five minutes for changes in permissions to propagate.
74+
The Azure API for FHIR caches decisions for up to 5 minutes. If you grant a user access to the FHIR server by adding them to the list of allowed object IDs, or you remove them from the list, you should expect it to take up to five minutes for changes in permissions to propagate.
7575

7676
## Next steps
7777

78-
In this article, you learned how to assign FHIR data plane access using an external (secondary) Microsoft Entra tenant. Next learn about additional settings for the Azure API for FHIR:
78+
In this article, you learned how to assign FHIR data plane access using an external (secondary) Microsoft Entra tenant. Next learn about additional settings for the Azure API for FHIR.
7979

8080
>[!div class="nextstepaction"]
8181
>[Configure CORS](configure-cross-origin-resource-sharing.md)
8282
8383
>[!div class="nextstepaction"]
8484
>[Configure Private Link](configure-private-link.md)
8585
86-
FHIR® is a registered trademark of [HL7](https://hl7.org/fhir/) and is used with the permission of HL7.
86+
[!INCLUDE[FHIR trademark statement](../includes/healthcare-apis-fhir-trademark.md)]

0 commit comments

Comments
 (0)