Microsoft.Sql managedInstances 2020-08-01-preview

Article
02/26/2024

Bicep resource definition

The managedInstances 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.Sql/managedInstances resource, add the following Bicep to your template.

resource symbolicname 'Microsoft.Sql/managedInstances@2020-08-01-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  identity: {
    type: 'string'
  }
  properties: {
    administratorLogin: 'string'
    administratorLoginPassword: 'string'
    collation: 'string'
    dnsZonePartner: 'string'
    instancePoolId: 'string'
    licenseType: 'string'
    maintenanceConfigurationId: 'string'
    managedInstanceCreateMode: 'string'
    minimalTlsVersion: 'string'
    proxyOverride: 'string'
    publicDataEndpointEnabled: bool
    restorePointInTime: 'string'
    sourceManagedInstanceId: 'string'
    storageAccountType: 'string'
    storageSizeInGB: int
    subnetId: 'string'
    timezoneId: 'string'
    vCores: int
    zoneRedundant: bool
  }
}

Property values

managedInstances

Name	Description	Value
name	The resource name	string (required) Character limit: 1-63 Valid characters: Lowercase letters, numbers, and hyphens. Can't start or end with hyphen. Resource name must be unique across Azure.
location	Resource location.	string (required)
tags	Resource tags.	Dictionary of tag names and values. See Tags in templates
sku	Managed instance SKU. Allowed values for sku.name: GP_Gen4, GP_Gen5, BC_Gen4, BC_Gen5	Sku
identity	The Azure Active Directory identity of the managed instance.	ResourceIdentity
properties	Resource properties.	ManagedInstanceProperties

ResourceIdentity

Name	Description	Value
type	The identity type. Set this to 'SystemAssigned' in order to automatically create and assign an Azure Active Directory principal for the resource.	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'

ManagedInstanceProperties

Name	Description	Value
administratorLogin	Administrator username for the managed instance. Can only be specified when the managed instance is being created (and is required for creation).	string
administratorLoginPassword	The administrator login password (required for managed instance creation).	string
collation	Collation of the managed instance.	string
dnsZonePartner	The resource id of another managed instance whose DNS zone this managed instance will share after creation.	string
instancePoolId	The Id of the instance pool this managed server belongs to.	string
licenseType	The license type. Possible values are 'LicenseIncluded' (regular price inclusive of a new SQL license) and 'BasePrice' (discounted AHB price for bringing your own SQL licenses).	'BasePrice' 'LicenseIncluded'
maintenanceConfigurationId	Specifies maintenance configuration id to apply to this managed instance.	string
managedInstanceCreateMode	Specifies the mode of database creation. Default: Regular instance creation. Restore: Creates an instance by restoring a set of backups to specific point in time. RestorePointInTime and SourceManagedInstanceId must be specified.	'Default' 'PointInTimeRestore'
minimalTlsVersion	Minimal TLS version. Allowed values: 'None', '1.0', '1.1', '1.2'	string
proxyOverride	Connection type used for connecting to the instance.	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	Whether or not the public data endpoint is enabled.	bool
restorePointInTime	Specifies the point in time (ISO8601 format) of the source database that will be restored to create the new database.	string
sourceManagedInstanceId	The resource identifier of the source managed instance associated with create operation of this instance.	string
storageAccountType	The storage account type used to store backups for this instance. The options are LRS (LocallyRedundantStorage), ZRS (ZoneRedundantStorage) and GRS (GeoRedundantStorage)	'GRS' 'LRS' 'ZRS'
storageSizeInGB	Storage size in GB. Minimum value: 32. Maximum value: 8192. Increments of 32 GB allowed only.	int
subnetId	Subnet resource ID for the managed instance.	string
timezoneId	Id of the timezone. Allowed values are timezones supported by Windows. Windows keeps details on supported timezones, including the id, in registry under KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. You can get those registry values via SQL Server by querying SELECT name AS timezone_id FROM sys.time_zone_info. List of Ids can also be obtained by executing [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell. An example of valid timezone id is "Pacific Standard Time" or "W. Europe Standard Time".	string
vCores	The number of vCores. Allowed values: 8, 16, 24, 32, 40, 64, 80.	int
zoneRedundant	Whether or not the multi-az is enabled.	bool

Sku

Name	Description	Value
capacity	Capacity of the particular SKU.	int
family	If the service has different generations of hardware, for the same SKU, then that can be captured here.	string
name	The name of the SKU, typically, a letter + Number code, e.g. P3.	string (required)
size	Size of the particular SKU	string
tier	The tier or edition of the particular SKU, e.g. Basic, Premium.	string

Quickstart templates

The following quickstart templates deploy this resource type.

Template	Description
Deploy SQL Managed Instance with Networking	Deploy UDR and NSG to support Azure SQL Managed Instance and deploy the Managed Instance
Create SQL MI inside the new virtual network	Deploy Azure Sql Database Managed Instance (SQL MI) inside new Virtual Network.
Create SQL MI with configured sending of logs and metrics	This template allows you to deploy SQL MI and additional resources used for storing logs and metrics (diagnostic workspace, storage account, event hub).
Create SQL MI with jumpbox inside new virtual network	Deploy Azure Sql Database Managed Instance (SQL MI) and JumpBox with SSMS inside new Virtual Network.
Create SQL MI with point-to-site connection configured	Deploy Azure Sql Database Managed Instance (SQL MI) and Virtual network gateway configured for point-to-site connection inside the new virtual network.

ARM template resource definition

The managedInstances 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.Sql/managedInstances resource, add the following JSON to your template.

{
  "type": "Microsoft.Sql/managedInstances",
  "apiVersion": "2020-08-01-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "identity": {
    "type": "string"
  },
  "properties": {
    "administratorLogin": "string",
    "administratorLoginPassword": "string",
    "collation": "string",
    "dnsZonePartner": "string",
    "instancePoolId": "string",
    "licenseType": "string",
    "maintenanceConfigurationId": "string",
    "managedInstanceCreateMode": "string",
    "minimalTlsVersion": "string",
    "proxyOverride": "string",
    "publicDataEndpointEnabled": "bool",
    "restorePointInTime": "string",
    "sourceManagedInstanceId": "string",
    "storageAccountType": "string",
    "storageSizeInGB": "int",
    "subnetId": "string",
    "timezoneId": "string",
    "vCores": "int",
    "zoneRedundant": "bool"
  }
}

Property values

managedInstances

Name	Description	Value
type	The resource type	'Microsoft.Sql/managedInstances'
apiVersion	The resource api version	'2020-08-01-preview'
name	The resource name	string (required) Character limit: 1-63 Valid characters: Lowercase letters, numbers, and hyphens. Can't start or end with hyphen. Resource name must be unique across Azure.
location	Resource location.	string (required)
tags	Resource tags.	Dictionary of tag names and values. See Tags in templates
sku	Managed instance SKU. Allowed values for sku.name: GP_Gen4, GP_Gen5, BC_Gen4, BC_Gen5	Sku
identity	The Azure Active Directory identity of the managed instance.	ResourceIdentity
properties	Resource properties.	ManagedInstanceProperties

ResourceIdentity

Name	Description	Value
type	The identity type. Set this to 'SystemAssigned' in order to automatically create and assign an Azure Active Directory principal for the resource.	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'

ManagedInstanceProperties

Name	Description	Value
administratorLogin	Administrator username for the managed instance. Can only be specified when the managed instance is being created (and is required for creation).	string
administratorLoginPassword	The administrator login password (required for managed instance creation).	string
collation	Collation of the managed instance.	string
dnsZonePartner	The resource id of another managed instance whose DNS zone this managed instance will share after creation.	string
instancePoolId	The Id of the instance pool this managed server belongs to.	string
licenseType	The license type. Possible values are 'LicenseIncluded' (regular price inclusive of a new SQL license) and 'BasePrice' (discounted AHB price for bringing your own SQL licenses).	'BasePrice' 'LicenseIncluded'
maintenanceConfigurationId	Specifies maintenance configuration id to apply to this managed instance.	string
managedInstanceCreateMode	Specifies the mode of database creation. Default: Regular instance creation. Restore: Creates an instance by restoring a set of backups to specific point in time. RestorePointInTime and SourceManagedInstanceId must be specified.	'Default' 'PointInTimeRestore'
minimalTlsVersion	Minimal TLS version. Allowed values: 'None', '1.0', '1.1', '1.2'	string
proxyOverride	Connection type used for connecting to the instance.	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	Whether or not the public data endpoint is enabled.	bool
restorePointInTime	Specifies the point in time (ISO8601 format) of the source database that will be restored to create the new database.	string
sourceManagedInstanceId	The resource identifier of the source managed instance associated with create operation of this instance.	string
storageAccountType	The storage account type used to store backups for this instance. The options are LRS (LocallyRedundantStorage), ZRS (ZoneRedundantStorage) and GRS (GeoRedundantStorage)	'GRS' 'LRS' 'ZRS'
storageSizeInGB	Storage size in GB. Minimum value: 32. Maximum value: 8192. Increments of 32 GB allowed only.	int
subnetId	Subnet resource ID for the managed instance.	string
timezoneId	Id of the timezone. Allowed values are timezones supported by Windows. Windows keeps details on supported timezones, including the id, in registry under KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. You can get those registry values via SQL Server by querying SELECT name AS timezone_id FROM sys.time_zone_info. List of Ids can also be obtained by executing [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell. An example of valid timezone id is "Pacific Standard Time" or "W. Europe Standard Time".	string
vCores	The number of vCores. Allowed values: 8, 16, 24, 32, 40, 64, 80.	int
zoneRedundant	Whether or not the multi-az is enabled.	bool

Sku

Name	Description	Value
capacity	Capacity of the particular SKU.	int
family	If the service has different generations of hardware, for the same SKU, then that can be captured here.	string
name	The name of the SKU, typically, a letter + Number code, e.g. P3.	string (required)
size	Size of the particular SKU	string
tier	The tier or edition of the particular SKU, e.g. Basic, Premium.	string

Quickstart templates

The following quickstart templates deploy this resource type.

Template	Description
Deploy SQL Managed Instance with Networking	Deploy UDR and NSG to support Azure SQL Managed Instance and deploy the Managed Instance
Create SQL MI inside the new virtual network	Deploy Azure Sql Database Managed Instance (SQL MI) inside new Virtual Network.
Create SQL MI with configured sending of logs and metrics	This template allows you to deploy SQL MI and additional resources used for storing logs and metrics (diagnostic workspace, storage account, event hub).
Create SQL MI with jumpbox inside new virtual network	Deploy Azure Sql Database Managed Instance (SQL MI) and JumpBox with SSMS inside new Virtual Network.
Create SQL MI with point-to-site connection configured	Deploy Azure Sql Database Managed Instance (SQL MI) and Virtual network gateway configured for point-to-site connection inside the new virtual network.

Terraform (AzAPI provider) resource definition

The managedInstances 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.Sql/managedInstances resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/managedInstances@2020-08-01-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
  }
  body = jsonencode({
    properties = {
      administratorLogin = "string"
      administratorLoginPassword = "string"
      collation = "string"
      dnsZonePartner = "string"
      instancePoolId = "string"
      licenseType = "string"
      maintenanceConfigurationId = "string"
      managedInstanceCreateMode = "string"
      minimalTlsVersion = "string"
      proxyOverride = "string"
      publicDataEndpointEnabled = bool
      restorePointInTime = "string"
      sourceManagedInstanceId = "string"
      storageAccountType = "string"
      storageSizeInGB = int
      subnetId = "string"
      timezoneId = "string"
      vCores = int
      zoneRedundant = bool
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  })
}

Property values

managedInstances

Name	Description	Value
type	The resource type	"Microsoft.Sql/managedInstances@2020-08-01-preview"
name	The resource name	string (required) Character limit: 1-63 Valid characters: Lowercase letters, numbers, and hyphens. Can't start or end with hyphen. Resource name must be unique across Azure.
location	Resource location.	string (required)
parent_id	To deploy to a resource group, use the ID of that resource group.	string (required)
tags	Resource tags.	Dictionary of tag names and values.
sku	Managed instance SKU. Allowed values for sku.name: GP_Gen4, GP_Gen5, BC_Gen4, BC_Gen5	Sku
identity	The Azure Active Directory identity of the managed instance.	ResourceIdentity
properties	Resource properties.	ManagedInstanceProperties

ResourceIdentity

Name	Description	Value
type	The identity type. Set this to 'SystemAssigned' in order to automatically create and assign an Azure Active Directory principal for the resource.	"SystemAssigned" "SystemAssigned,UserAssigned" "UserAssigned"

ManagedInstanceProperties

Name	Description	Value
administratorLogin	Administrator username for the managed instance. Can only be specified when the managed instance is being created (and is required for creation).	string
administratorLoginPassword	The administrator login password (required for managed instance creation).	string
collation	Collation of the managed instance.	string
dnsZonePartner	The resource id of another managed instance whose DNS zone this managed instance will share after creation.	string
instancePoolId	The Id of the instance pool this managed server belongs to.	string
licenseType	The license type. Possible values are 'LicenseIncluded' (regular price inclusive of a new SQL license) and 'BasePrice' (discounted AHB price for bringing your own SQL licenses).	"BasePrice" "LicenseIncluded"
maintenanceConfigurationId	Specifies maintenance configuration id to apply to this managed instance.	string
managedInstanceCreateMode	Specifies the mode of database creation. Default: Regular instance creation. Restore: Creates an instance by restoring a set of backups to specific point in time. RestorePointInTime and SourceManagedInstanceId must be specified.	"Default" "PointInTimeRestore"
minimalTlsVersion	Minimal TLS version. Allowed values: 'None', '1.0', '1.1', '1.2'	string
proxyOverride	Connection type used for connecting to the instance.	"Default" "Proxy" "Redirect"
publicDataEndpointEnabled	Whether or not the public data endpoint is enabled.	bool
restorePointInTime	Specifies the point in time (ISO8601 format) of the source database that will be restored to create the new database.	string
sourceManagedInstanceId	The resource identifier of the source managed instance associated with create operation of this instance.	string
storageAccountType	The storage account type used to store backups for this instance. The options are LRS (LocallyRedundantStorage), ZRS (ZoneRedundantStorage) and GRS (GeoRedundantStorage)	"GRS" "LRS" "ZRS"
storageSizeInGB	Storage size in GB. Minimum value: 32. Maximum value: 8192. Increments of 32 GB allowed only.	int
subnetId	Subnet resource ID for the managed instance.	string
timezoneId	Id of the timezone. Allowed values are timezones supported by Windows. Windows keeps details on supported timezones, including the id, in registry under KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. You can get those registry values via SQL Server by querying SELECT name AS timezone_id FROM sys.time_zone_info. List of Ids can also be obtained by executing [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell. An example of valid timezone id is "Pacific Standard Time" or "W. Europe Standard Time".	string
vCores	The number of vCores. Allowed values: 8, 16, 24, 32, 40, 64, 80.	int
zoneRedundant	Whether or not the multi-az is enabled.	bool

Sku

Name	Description	Value
capacity	Capacity of the particular SKU.	int
family	If the service has different generations of hardware, for the same SKU, then that can be captured here.	string
name	The name of the SKU, typically, a letter + Number code, e.g. P3.	string (required)
size	Size of the particular SKU	string
tier	The tier or edition of the particular SKU, e.g. Basic, Premium.	string

Share via

Microsoft.Sql managedInstances 2020-08-01-preview

Bicep resource definition

Resource format

Property values

managedInstances

ResourceIdentity

ManagedInstanceProperties

Sku

Quickstart templates

ARM template resource definition

Resource format

Property values

managedInstances

ResourceIdentity

ManagedInstanceProperties

Sku

Quickstart templates

Terraform (AzAPI provider) resource definition

Resource format

Property values

managedInstances

ResourceIdentity

ManagedInstanceProperties

Sku

Feedback

Additional resources