Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Bicep resource definition
The services resource type can be deployed with operations that target:
- Resource groups - See resource group deployment commands
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.HealthcareApis/services resource, add the following Bicep to your template.
resource symbolicname 'Microsoft.HealthcareApis/services@2019-09-16' = {
etag: 'string'
identity: {
type: 'string'
}
kind: 'string'
location: 'string'
name: 'string'
properties: {
accessPolicies: [
{
objectId: 'string'
}
]
authenticationConfiguration: {
audience: 'string'
authority: 'string'
smartProxyEnabled: bool
}
corsConfiguration: {
allowCredentials: bool
headers: [
'string'
]
maxAge: int
methods: [
'string'
]
origins: [
'string'
]
}
cosmosDbConfiguration: {
offerThroughput: int
}
exportConfiguration: {
storageAccountName: 'string'
}
}
tags: {
{customized property}: 'string'
}
}
Property Values
Microsoft.HealthcareApis/services
| Name | Description | Value |
|---|---|---|
| etag | An etag associated with the resource, used for optimistic concurrency when editing it. | string |
| identity | Setting indicating whether the service has a managed identity associated with it. | ResourceIdentity |
| kind | The kind of the service. | 'fhir' 'fhir-R4' 'fhir-Stu3' (required) |
| location | The resource location. | string (required) |
| name | The resource name | string Constraints: Min length = 3 Max length = 24 (required) |
| properties | The common properties of a service. | ServicesProperties |
| tags | Resource tags | Dictionary of tag names and values. See Tags in templates |
ResourceIdentity
| Name | Description | Value |
|---|---|---|
| type | Type of identity being specified, currently SystemAssigned and None are allowed. | 'None' 'SystemAssigned' |
ResourceTags
| Name | Description | Value |
|---|
ServiceAccessPolicyEntry
| Name | Description | Value |
|---|---|---|
| objectId | An Azure AD object ID (User or Apps) that is allowed access to the FHIR service. | string Constraints: Pattern = ^(([0-9A-Fa-f]{8}[-]?(?:[0-9A-Fa-f]{4}[-]?){3}[0-9A-Fa-f]{12}){1})+$ (required) |
ServiceAuthenticationConfigurationInfo
| Name | Description | Value |
|---|---|---|
| audience | The audience url for the service | string |
| authority | The authority url for the service | string |
| smartProxyEnabled | If the SMART on FHIR proxy is enabled | bool |
ServiceCorsConfigurationInfo
| Name | Description | Value |
|---|---|---|
| allowCredentials | If credentials are allowed via CORS. | bool |
| headers | The headers to be allowed via CORS. | string[] |
| maxAge | The max age to be allowed via CORS. | int Constraints: Min value = 0 Max value = 99999 |
| methods | The methods to be allowed via CORS. | string[] |
| origins | The origins to be allowed via CORS. | string Constraints: Pattern = ^(?:(?:(?:[hH][tT][tT][pP](?:[sS]|))\:\/\/(?:[a-zA-Z0-9-]+[.]?)+(?:\:[0-9]{1,5})?|[*]))$[] |
ServiceCosmosDbConfigurationInfo
| Name | Description | Value |
|---|---|---|
| offerThroughput | The provisioned throughput for the backing database. | int Constraints: Min value = 400 |
ServiceExportConfigurationInfo
| Name | Description | Value |
|---|---|---|
| storageAccountName | The name of the default export storage account. | string |
ServicesProperties
| Name | Description | Value |
|---|---|---|
| accessPolicies | The access policies of the service instance. | ServiceAccessPolicyEntry[] |
| authenticationConfiguration | The authentication configuration for the service instance. | ServiceAuthenticationConfigurationInfo |
| corsConfiguration | The settings for the CORS configuration of the service instance. | ServiceCorsConfigurationInfo |
| cosmosDbConfiguration | The settings for the Cosmos DB database backing the service. | ServiceCosmosDbConfigurationInfo |
| exportConfiguration | The settings for the export operation of the service instance. | ServiceExportConfigurationInfo |
Usage Examples
Azure Quickstart Samples
The following Azure Quickstart templates contain Bicep samples for deploying this resource type.
| Bicep File | Description |
|---|---|
| Deploy Azure API for FHIR | This template creates an instance of Azure API for FHIR®. The Azure API for FHIR® is a managed, standards-based, and compliant healthcare data platform. It enables organizations to bring their clinical health data into the cloud based on the interoperable data standard FHIR®. |
ARM template resource definition
The services resource type can be deployed with operations that target:
- Resource groups - See resource group deployment commands
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.HealthcareApis/services resource, add the following JSON to your template.
{
"type": "Microsoft.HealthcareApis/services",
"apiVersion": "2019-09-16",
"name": "string",
"etag": "string",
"identity": {
"type": "string"
},
"kind": "string",
"location": "string",
"properties": {
"accessPolicies": [
{
"objectId": "string"
}
],
"authenticationConfiguration": {
"audience": "string",
"authority": "string",
"smartProxyEnabled": "bool"
},
"corsConfiguration": {
"allowCredentials": "bool",
"headers": [ "string" ],
"maxAge": "int",
"methods": [ "string" ],
"origins": [ "string" ]
},
"cosmosDbConfiguration": {
"offerThroughput": "int"
},
"exportConfiguration": {
"storageAccountName": "string"
}
},
"tags": {
"{customized property}": "string"
}
}
Property Values
Microsoft.HealthcareApis/services
| Name | Description | Value |
|---|---|---|
| apiVersion | The api version | '2019-09-16' |
| etag | An etag associated with the resource, used for optimistic concurrency when editing it. | string |
| identity | Setting indicating whether the service has a managed identity associated with it. | ResourceIdentity |
| kind | The kind of the service. | 'fhir' 'fhir-R4' 'fhir-Stu3' (required) |
| location | The resource location. | string (required) |
| name | The resource name | string Constraints: Min length = 3 Max length = 24 (required) |
| properties | The common properties of a service. | ServicesProperties |
| tags | Resource tags | Dictionary of tag names and values. See Tags in templates |
| type | The resource type | 'Microsoft.HealthcareApis/services' |
ResourceIdentity
| Name | Description | Value |
|---|---|---|
| type | Type of identity being specified, currently SystemAssigned and None are allowed. | 'None' 'SystemAssigned' |
ResourceTags
| Name | Description | Value |
|---|
ServiceAccessPolicyEntry
| Name | Description | Value |
|---|---|---|
| objectId | An Azure AD object ID (User or Apps) that is allowed access to the FHIR service. | string Constraints: Pattern = ^(([0-9A-Fa-f]{8}[-]?(?:[0-9A-Fa-f]{4}[-]?){3}[0-9A-Fa-f]{12}){1})+$ (required) |
ServiceAuthenticationConfigurationInfo
| Name | Description | Value |
|---|---|---|
| audience | The audience url for the service | string |
| authority | The authority url for the service | string |
| smartProxyEnabled | If the SMART on FHIR proxy is enabled | bool |
ServiceCorsConfigurationInfo
| Name | Description | Value |
|---|---|---|
| allowCredentials | If credentials are allowed via CORS. | bool |
| headers | The headers to be allowed via CORS. | string[] |
| maxAge | The max age to be allowed via CORS. | int Constraints: Min value = 0 Max value = 99999 |
| methods | The methods to be allowed via CORS. | string[] |
| origins | The origins to be allowed via CORS. | string Constraints: Pattern = ^(?:(?:(?:[hH][tT][tT][pP](?:[sS]|))\:\/\/(?:[a-zA-Z0-9-]+[.]?)+(?:\:[0-9]{1,5})?|[*]))$[] |
ServiceCosmosDbConfigurationInfo
| Name | Description | Value |
|---|---|---|
| offerThroughput | The provisioned throughput for the backing database. | int Constraints: Min value = 400 |
ServiceExportConfigurationInfo
| Name | Description | Value |
|---|---|---|
| storageAccountName | The name of the default export storage account. | string |
ServicesProperties
| Name | Description | Value |
|---|---|---|
| accessPolicies | The access policies of the service instance. | ServiceAccessPolicyEntry[] |
| authenticationConfiguration | The authentication configuration for the service instance. | ServiceAuthenticationConfigurationInfo |
| corsConfiguration | The settings for the CORS configuration of the service instance. | ServiceCorsConfigurationInfo |
| cosmosDbConfiguration | The settings for the Cosmos DB database backing the service. | ServiceCosmosDbConfigurationInfo |
| exportConfiguration | The settings for the export operation of the service instance. | ServiceExportConfigurationInfo |
Usage Examples
Azure Quickstart Templates
The following Azure Quickstart templates deploy this resource type.
| Template | Description |
|---|---|
Deploy Azure API for FHIR |
This template creates an instance of Azure API for FHIR®. The Azure API for FHIR® is a managed, standards-based, and compliant healthcare data platform. It enables organizations to bring their clinical health data into the cloud based on the interoperable data standard FHIR®. |
Terraform (AzAPI provider) resource definition
The services resource type can be deployed with operations that target:
- Resource groups
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.HealthcareApis/services resource, add the following Terraform to your template.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.HealthcareApis/services@2019-09-16"
name = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = [
"string"
]
}
location = "string"
tags = {
{customized property} = "string"
}
body = {
etag = "string"
kind = "string"
properties = {
accessPolicies = [
{
objectId = "string"
}
]
authenticationConfiguration = {
audience = "string"
authority = "string"
smartProxyEnabled = bool
}
corsConfiguration = {
allowCredentials = bool
headers = [
"string"
]
maxAge = int
methods = [
"string"
]
origins = [
"string"
]
}
cosmosDbConfiguration = {
offerThroughput = int
}
exportConfiguration = {
storageAccountName = "string"
}
}
}
}
Property Values
Microsoft.HealthcareApis/services
| Name | Description | Value |
|---|---|---|
| etag | An etag associated with the resource, used for optimistic concurrency when editing it. | string |
| identity | Setting indicating whether the service has a managed identity associated with it. | ResourceIdentity |
| kind | The kind of the service. | 'fhir' 'fhir-R4' 'fhir-Stu3' (required) |
| location | The resource location. | string (required) |
| name | The resource name | string Constraints: Min length = 3 Max length = 24 (required) |
| properties | The common properties of a service. | ServicesProperties |
| tags | Resource tags | Dictionary of tag names and values. |
| type | The resource type | "Microsoft.HealthcareApis/services@2019-09-16" |
ResourceIdentity
| Name | Description | Value |
|---|---|---|
| type | Type of identity being specified, currently SystemAssigned and None are allowed. | 'None' 'SystemAssigned' |
ResourceTags
| Name | Description | Value |
|---|
ServiceAccessPolicyEntry
| Name | Description | Value |
|---|---|---|
| objectId | An Azure AD object ID (User or Apps) that is allowed access to the FHIR service. | string Constraints: Pattern = ^(([0-9A-Fa-f]{8}[-]?(?:[0-9A-Fa-f]{4}[-]?){3}[0-9A-Fa-f]{12}){1})+$ (required) |
ServiceAuthenticationConfigurationInfo
| Name | Description | Value |
|---|---|---|
| audience | The audience url for the service | string |
| authority | The authority url for the service | string |
| smartProxyEnabled | If the SMART on FHIR proxy is enabled | bool |
ServiceCorsConfigurationInfo
| Name | Description | Value |
|---|---|---|
| allowCredentials | If credentials are allowed via CORS. | bool |
| headers | The headers to be allowed via CORS. | string[] |
| maxAge | The max age to be allowed via CORS. | int Constraints: Min value = 0 Max value = 99999 |
| methods | The methods to be allowed via CORS. | string[] |
| origins | The origins to be allowed via CORS. | string Constraints: Pattern = ^(?:(?:(?:[hH][tT][tT][pP](?:[sS]|))\:\/\/(?:[a-zA-Z0-9-]+[.]?)+(?:\:[0-9]{1,5})?|[*]))$[] |
ServiceCosmosDbConfigurationInfo
| Name | Description | Value |
|---|---|---|
| offerThroughput | The provisioned throughput for the backing database. | int Constraints: Min value = 400 |
ServiceExportConfigurationInfo
| Name | Description | Value |
|---|---|---|
| storageAccountName | The name of the default export storage account. | string |
ServicesProperties
| Name | Description | Value |
|---|---|---|
| accessPolicies | The access policies of the service instance. | ServiceAccessPolicyEntry[] |
| authenticationConfiguration | The authentication configuration for the service instance. | ServiceAuthenticationConfigurationInfo |
| corsConfiguration | The settings for the CORS configuration of the service instance. | ServiceCorsConfigurationInfo |
| cosmosDbConfiguration | The settings for the Cosmos DB database backing the service. | ServiceCosmosDbConfigurationInfo |
| exportConfiguration | The settings for the export operation of the service instance. | ServiceExportConfigurationInfo |