Microsoft.Sql managedInstances

Definição de recurso do Bicep

O tipo de recurso managedInstances pode ser implantado com operações de destino:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Sql/managedInstances, adicione o Bicep a seguir ao modelo.

resource symbolicname 'Microsoft.Sql/managedInstances@2024-11-01-preview' = {
  scope: resourceSymbolicName or scope
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    administratorLogin: 'string'
    administratorLoginPassword: 'string'
    administrators: {
      administratorType: 'string'
      azureADOnlyAuthentication: bool
      login: 'string'
      principalType: 'string'
      sid: 'string'
      tenantId: 'string'
    }
    authenticationMetadata: 'string'
    collation: 'string'
    databaseFormat: 'string'
    dnsZonePartner: 'string'
    hybridSecondaryUsage: 'string'
    instancePoolId: 'string'
    isGeneralPurposeV2: bool
    keyId: 'string'
    licenseType: 'string'
    maintenanceConfigurationId: 'string'
    managedInstanceCreateMode: 'string'
    memorySizeInGB: int
    minimalTlsVersion: 'string'
    pricingModel: 'string'
    primaryUserAssignedIdentityId: 'string'
    proxyOverride: 'string'
    publicDataEndpointEnabled: bool
    requestedBackupStorageRedundancy: 'string'
    requestedLogicalAvailabilityZone: 'string'
    restorePointInTime: 'string'
    servicePrincipal: {
      type: 'string'
    }
    sourceManagedInstanceId: 'string'
    storageIOps: int
    storageSizeInGB: int
    storageThroughputMBps: int
    subnetId: 'string'
    timezoneId: 'string'
    vCores: int
    zoneRedundant: bool
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propriedade

Microsoft.Sql/managedInstances

Name	Description	Value
identidade	A identidade do Azure Active Directory da instância gerenciada.	ResourceIdentity
local	Local do recurso.	cadeia de caracteres (obrigatório)
name	O nome do recurso	cadeia de caracteres (obrigatório)
properties	Propriedades do recurso.	ManagedInstanceProperties
escopo	Use ao criar um recurso em um escopo diferente do escopo de implantação.	Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão .
sku	SKU da instância gerenciada. Valores permitidos para sku.name: GP_Gen5 (Uso Geral, Série Padrão); GP_G8IM (Uso Geral, Série Premium); GP_G8IH (uso geral, memória da série Premium otimizada); BC_Gen5 (Crítico para os Negócios, Standard-Series); BC_G8IM (Business Critical, série Premium); BC_G8IH (Business Critical, otimizado para memória da série Premium).	Sku
tags	Etiquetas de recursos	Dicionário de nomes e valores de tags. Consulte Marcas em modelos

ManagedInstanceExternalAdministrator

Name	Description	Value
administratorType	Tipo do administrador de sever.	'ActiveDirectory'
azureADOnlyAuthentication	Somente autenticação do Azure Active Directory habilitada.	bool
login	Nome de logon do administrador do servidor.	cadeia
principalType	Tipo de entidade de segurança do administrador de sever.	'Application' 'Group' 'User'
sid	SID (ID do objeto) do administrador do servidor.	string Constraints: Comprimento mínimo = 36 Comprimento máximo = 36 Padrão = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
tenantId	ID do locatário do administrador.	string Constraints: Comprimento mínimo = 36 Comprimento máximo = 36 Padrão = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`

ManagedInstanceProperties

Name	Description	Value
administratorLogin	Nome de usuário do administrador para a instância gerenciada. Só pode ser especificado quando a instância gerenciada está sendo criada (e é necessária para a criação).	cadeia
administratorLoginPassword	A senha de logon do administrador (necessária para a criação da instância gerenciada).	string Constraints: Valor confidencial. Passe como um parâmetro seguro.
administrators	O administrador do Azure Active Directory pode ser utilizado durante a criação da instância e para atualizações de instância, exceto para a propriedade azureADOnlyAuthentication. Para atualizar a propriedade azureADOnlyAuthentication, a API individual deve ser usada.	ManagedInstanceExternalAdministrator
authenticationMetadata	O modo de pesquisa de metadados de autenticação da instância gerenciada.	'AzureAD' 'Paired' 'Windows'
agrupamento	Ordenação da instância gerenciada.	cadeia
databaseFormat	Especifica o formato interno de bancos de dados de instância específicos para a versão do mecanismo SQL.	'AlwaysUpToDate' 'SQLServer2022' 'SQLServer2025'
dnsZonePartner	A ID de recurso de outra instância gerenciada cuja zona DNS essa instância gerenciada compartilhará após a criação.	cadeia
hybridSecondaryUsage	Uso secundário híbrido. Os valores possíveis são 'Ativo' (valor padrão) e 'Passivo' (o cliente usa o secundário como DR Passivo).	'Active' 'Passive'
instancePoolId	A ID do pool de instâncias à qual este servidor gerenciado pertence.	cadeia
isGeneralPurposeV2	Se esta é ou não uma variante GPv2 da edição Uso Geral.	bool
keyId	Um URI do CMK da chave a ser usada para criptografia.	cadeia
licenseType	O tipo de licença. Os valores possíveis são 'LicenseIncluded' (preço regular inclusive de uma nova licença sql) e 'BasePrice' (preço ahb com desconto para trazer suas próprias licenças SQL).	'BasePrice' 'LicenseIncluded'
maintenanceConfigurationId	Especifica a ID de configuração de manutenção a ser aplicada a essa instância gerenciada.	cadeia
managedInstanceCreateMode	Especifica o modo de criação de banco de dados. Padrão: criação de instância regular. Restauração: cria uma instância restaurando um conjunto de backups para um ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId devem ser especificados.	'Default' 'PointInTimeRestore'
memorySizeInGB	Tamanho da memória em GB. Valor mínimo: 28. Valor máximo: 870. O valor mínimo e máximo depende do número de vCores e da camada de serviço. Leia mais sobre limites de recursos: https://aka.ms/mi-resource-limits-api.	int
minimalTlsVersion	Versão mínima do TLS. Valores permitidos: 'None', '1.0', '1.1', '1.2'	cadeia
pricingModel	Modelo de preços da Instância Gerenciada.	'Freemium' 'Regular'
primaryUserAssignedIdentityId	A ID de recurso de uma identidade atribuída pelo usuário a ser usada por padrão.	cadeia
proxyOverride	Tipo de conexão usado para se conectar à instância.	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	Se o ponto de extremidade de dados público está habilitado ou não.	bool
requestedBackupStorageRedundancy	O tipo de conta de armazenamento a ser usado para armazenar backups para essa instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)	'Geo' 'GeoZone' 'Local' 'Zone'
requestedLogicalAvailabilityZone	Especifica a zona de disponibilidade lógica na qual a Instância Gerenciada está fixada.	'1' '2' '3' 'NoPreference'
restorePointInTime	Especifica o ponto no tempo (formato ISO8601) do banco de dados de origem que será restaurado para criar o novo banco de dados.	cadeia
servicePrincipal	A entidade de serviço da instância gerenciada.	ServicePrincipal
sourceManagedInstanceId	O identificador de recurso da instância gerenciada de origem associada à operação de criação dessa instância.	cadeia
storageIOps	IOps de armazenamento. Valor mínimo: 300. Valor máximo: 80000. Incrementos de 1 IOps somente permitidos. O valor máximo depende da família de hardware selecionada e do número de vCores.	int
storageSizeInGB	Tamanho do armazenamento em GB. Valor mínimo: 32. Valor máximo: 32768. Incrementos de 32 GB somente permitidos. O valor máximo depende da família de hardware selecionada e do número de vCores.	int
storageThroughputMBps	Não há suporte para o parâmetro MBps de taxa de transferência de armazenamento na operação de criação/atualização da instância.	int
subnetId	ID de recurso de sub-rede para a instância gerenciada.	cadeia
timezoneId	Id do fuso horário. Os valores permitidos são fusos horários compatíveis com o Windows. O Windows mantém detalhes sobre fusos horários com suporte, incluindo a ID, no Registro em KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fusos horários. Você pode obter esses valores do Registro por meio do SQL Server consultando o nome SELECT AS timezone_id FROM sys.time_zone_info. A lista de IDs também pode ser obtida executando [System.TimeZoneInfo]::GetSystemTimeZones() no PowerShell. Um exemplo de ID de fuso horário válida é "Horário Padrão do Pacífico" ou "W. Horário Padrão da Europa".	cadeia
vCores	O número de vCores. Valores permitidos: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Os vCores com suporte dependem da família de hardware e da camada de serviço selecionadas.	int
zoneRedundant	Se a redundância de zona está habilitada ou não.	bool

ResourceIdentity

Name	Description	Value
tipo	O tipo de identidade. Defina isso como "SystemAssigned" para criar e atribuir automaticamente uma entidade de segurança do Azure Active Directory para o recurso.	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'
userAssignedIdentities	As IDs de recurso das identidades atribuídas pelo usuário a serem usadas	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name	Description	Value

ServicePrincipal

Name	Description	Value
tipo	Tipo de entidade de serviço.	'None' 'SystemAssigned'

Sku

Name	Description	Value
capacidade	Capacidade da SKU específica.	int
family	Se o serviço tiver diferentes gerações de hardware, para a mesma SKU, isso poderá ser capturado aqui.	cadeia
name	O nome da SKU, normalmente, uma letra + código de número, por exemplo, P3.	cadeia de caracteres (obrigatório)
size	Tamanho da SKU específica	cadeia
nível	A camada ou edição da SKU específica, por exemplo, Basic, Premium.	cadeia

TrackedResourceTags

Name	Description	Value

UserIdentity

Name	Description	Value

Exemplos de uso

Módulos verificados do Azure

O módulos verificados do Azure a seguir pode ser usado para implantar esse tipo de recurso.

Module	Description
Instância Gerenciada de SQL	Módulo de recurso AVM para Instância Gerenciada de SQL

Exemplos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir contêm exemplos de Bicep para implantar esse tipo de recurso.

Arquivo Bicep	Description
Criar MI do SQL dentro do novo de rede virtual	Implantar a MI (Instância Gerenciada de Banco de Dados Sql) do Azure dentro da nova Rede Virtual.

Definição de recurso de modelo do ARM

O tipo de recurso managedInstances pode ser implantado com operações de destino:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Sql/managedInstances, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.Sql/managedInstances",
  "apiVersion": "2024-11-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "administratorLogin": "string",
    "administratorLoginPassword": "string",
    "administrators": {
      "administratorType": "string",
      "azureADOnlyAuthentication": "bool",
      "login": "string",
      "principalType": "string",
      "sid": "string",
      "tenantId": "string"
    },
    "authenticationMetadata": "string",
    "collation": "string",
    "databaseFormat": "string",
    "dnsZonePartner": "string",
    "hybridSecondaryUsage": "string",
    "instancePoolId": "string",
    "isGeneralPurposeV2": "bool",
    "keyId": "string",
    "licenseType": "string",
    "maintenanceConfigurationId": "string",
    "managedInstanceCreateMode": "string",
    "memorySizeInGB": "int",
    "minimalTlsVersion": "string",
    "pricingModel": "string",
    "primaryUserAssignedIdentityId": "string",
    "proxyOverride": "string",
    "publicDataEndpointEnabled": "bool",
    "requestedBackupStorageRedundancy": "string",
    "requestedLogicalAvailabilityZone": "string",
    "restorePointInTime": "string",
    "servicePrincipal": {
      "type": "string"
    },
    "sourceManagedInstanceId": "string",
    "storageIOps": "int",
    "storageSizeInGB": "int",
    "storageThroughputMBps": "int",
    "subnetId": "string",
    "timezoneId": "string",
    "vCores": "int",
    "zoneRedundant": "bool"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propriedade

Microsoft.Sql/managedInstances

Name	Description	Value
apiVersion	A versão da API	'2024-11-01-preview'
identidade	A identidade do Azure Active Directory da instância gerenciada.	ResourceIdentity
local	Local do recurso.	cadeia de caracteres (obrigatório)
name	O nome do recurso	cadeia de caracteres (obrigatório)
properties	Propriedades do recurso.	ManagedInstanceProperties
sku	SKU da instância gerenciada. Valores permitidos para sku.name: GP_Gen5 (Uso Geral, Série Padrão); GP_G8IM (Uso Geral, Série Premium); GP_G8IH (uso geral, memória da série Premium otimizada); BC_Gen5 (Crítico para os Negócios, Standard-Series); BC_G8IM (Business Critical, série Premium); BC_G8IH (Business Critical, otimizado para memória da série Premium).	Sku
tags	Etiquetas de recursos	Dicionário de nomes e valores de tags. Consulte Marcas em modelos
tipo	O tipo de recurso	'Microsoft.Sql/managedInstances'

ManagedInstanceExternalAdministrator

Name	Description	Value
administratorType	Tipo do administrador de sever.	'ActiveDirectory'
azureADOnlyAuthentication	Somente autenticação do Azure Active Directory habilitada.	bool
login	Nome de logon do administrador do servidor.	cadeia
principalType	Tipo de entidade de segurança do administrador de sever.	'Application' 'Group' 'User'
sid	SID (ID do objeto) do administrador do servidor.	string Constraints: Comprimento mínimo = 36 Comprimento máximo = 36 Padrão = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
tenantId	ID do locatário do administrador.	string Constraints: Comprimento mínimo = 36 Comprimento máximo = 36 Padrão = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`

ManagedInstanceProperties

Name	Description	Value
administratorLogin	Nome de usuário do administrador para a instância gerenciada. Só pode ser especificado quando a instância gerenciada está sendo criada (e é necessária para a criação).	cadeia
administratorLoginPassword	A senha de logon do administrador (necessária para a criação da instância gerenciada).	string Constraints: Valor confidencial. Passe como um parâmetro seguro.
administrators	O administrador do Azure Active Directory pode ser utilizado durante a criação da instância e para atualizações de instância, exceto para a propriedade azureADOnlyAuthentication. Para atualizar a propriedade azureADOnlyAuthentication, a API individual deve ser usada.	ManagedInstanceExternalAdministrator
authenticationMetadata	O modo de pesquisa de metadados de autenticação da instância gerenciada.	'AzureAD' 'Paired' 'Windows'
agrupamento	Ordenação da instância gerenciada.	cadeia
databaseFormat	Especifica o formato interno de bancos de dados de instância específicos para a versão do mecanismo SQL.	'AlwaysUpToDate' 'SQLServer2022' 'SQLServer2025'
dnsZonePartner	A ID de recurso de outra instância gerenciada cuja zona DNS essa instância gerenciada compartilhará após a criação.	cadeia
hybridSecondaryUsage	Uso secundário híbrido. Os valores possíveis são 'Ativo' (valor padrão) e 'Passivo' (o cliente usa o secundário como DR Passivo).	'Active' 'Passive'
instancePoolId	A ID do pool de instâncias à qual este servidor gerenciado pertence.	cadeia
isGeneralPurposeV2	Se esta é ou não uma variante GPv2 da edição Uso Geral.	bool
keyId	Um URI do CMK da chave a ser usada para criptografia.	cadeia
licenseType	O tipo de licença. Os valores possíveis são 'LicenseIncluded' (preço regular inclusive de uma nova licença sql) e 'BasePrice' (preço ahb com desconto para trazer suas próprias licenças SQL).	'BasePrice' 'LicenseIncluded'
maintenanceConfigurationId	Especifica a ID de configuração de manutenção a ser aplicada a essa instância gerenciada.	cadeia
managedInstanceCreateMode	Especifica o modo de criação de banco de dados. Padrão: criação de instância regular. Restauração: cria uma instância restaurando um conjunto de backups para um ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId devem ser especificados.	'Default' 'PointInTimeRestore'
memorySizeInGB	Tamanho da memória em GB. Valor mínimo: 28. Valor máximo: 870. O valor mínimo e máximo depende do número de vCores e da camada de serviço. Leia mais sobre limites de recursos: https://aka.ms/mi-resource-limits-api.	int
minimalTlsVersion	Versão mínima do TLS. Valores permitidos: 'None', '1.0', '1.1', '1.2'	cadeia
pricingModel	Modelo de preços da Instância Gerenciada.	'Freemium' 'Regular'
primaryUserAssignedIdentityId	A ID de recurso de uma identidade atribuída pelo usuário a ser usada por padrão.	cadeia
proxyOverride	Tipo de conexão usado para se conectar à instância.	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	Se o ponto de extremidade de dados público está habilitado ou não.	bool
requestedBackupStorageRedundancy	O tipo de conta de armazenamento a ser usado para armazenar backups para essa instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)	'Geo' 'GeoZone' 'Local' 'Zone'
requestedLogicalAvailabilityZone	Especifica a zona de disponibilidade lógica na qual a Instância Gerenciada está fixada.	'1' '2' '3' 'NoPreference'
restorePointInTime	Especifica o ponto no tempo (formato ISO8601) do banco de dados de origem que será restaurado para criar o novo banco de dados.	cadeia
servicePrincipal	A entidade de serviço da instância gerenciada.	ServicePrincipal
sourceManagedInstanceId	O identificador de recurso da instância gerenciada de origem associada à operação de criação dessa instância.	cadeia
storageIOps	IOps de armazenamento. Valor mínimo: 300. Valor máximo: 80000. Incrementos de 1 IOps somente permitidos. O valor máximo depende da família de hardware selecionada e do número de vCores.	int
storageSizeInGB	Tamanho do armazenamento em GB. Valor mínimo: 32. Valor máximo: 32768. Incrementos de 32 GB somente permitidos. O valor máximo depende da família de hardware selecionada e do número de vCores.	int
storageThroughputMBps	Não há suporte para o parâmetro MBps de taxa de transferência de armazenamento na operação de criação/atualização da instância.	int
subnetId	ID de recurso de sub-rede para a instância gerenciada.	cadeia
timezoneId	Id do fuso horário. Os valores permitidos são fusos horários compatíveis com o Windows. O Windows mantém detalhes sobre fusos horários com suporte, incluindo a ID, no Registro em KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fusos horários. Você pode obter esses valores do Registro por meio do SQL Server consultando o nome SELECT AS timezone_id FROM sys.time_zone_info. A lista de IDs também pode ser obtida executando [System.TimeZoneInfo]::GetSystemTimeZones() no PowerShell. Um exemplo de ID de fuso horário válida é "Horário Padrão do Pacífico" ou "W. Horário Padrão da Europa".	cadeia
vCores	O número de vCores. Valores permitidos: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Os vCores com suporte dependem da família de hardware e da camada de serviço selecionadas.	int
zoneRedundant	Se a redundância de zona está habilitada ou não.	bool

ResourceIdentity

Name	Description	Value
tipo	O tipo de identidade. Defina isso como "SystemAssigned" para criar e atribuir automaticamente uma entidade de segurança do Azure Active Directory para o recurso.	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'
userAssignedIdentities	As IDs de recurso das identidades atribuídas pelo usuário a serem usadas	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name	Description	Value

ServicePrincipal

Name	Description	Value
tipo	Tipo de entidade de serviço.	'None' 'SystemAssigned'

Sku

Name	Description	Value
capacidade	Capacidade da SKU específica.	int
family	Se o serviço tiver diferentes gerações de hardware, para a mesma SKU, isso poderá ser capturado aqui.	cadeia
name	O nome da SKU, normalmente, uma letra + código de número, por exemplo, P3.	cadeia de caracteres (obrigatório)
size	Tamanho da SKU específica	cadeia
nível	A camada ou edição da SKU específica, por exemplo, Basic, Premium.	cadeia

TrackedResourceTags

Name	Description	Value

UserIdentity

Name	Description	Value

Exemplos de uso

Modelos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir implantar esse tipo de recurso.

Template	Description
Criar MI do SQL dentro do novo de rede virtual	Implantar a MI (Instância Gerenciada de Banco de Dados Sql) do Azure dentro da nova Rede Virtual.
Criar MI do SQL com o envio configurado de logs e métricas	Esse modelo permite implantar a MI do SQL e recursos adicionais usados para armazenar logs e métricas (workspace de diagnóstico, conta de armazenamento, hub de eventos).
Criar MI do SQL com jumpbox dentro de novos de rede virtual	Implante a MI (Instância Gerenciada de Banco de Dados Sql) do Azure e o JumpBox com O SSMS dentro da nova Rede Virtual.
Criar MI do SQL com conexão ponto a site configurada	Implante a MI (Instância Gerenciada de Banco de Dados Sql do Azure) e o gateway de rede virtual configurado para conexão ponto a site dentro da nova rede virtual.
implantar a Instância Gerenciada de SQL com de Rede	Implantar UDR e NSG para dar suporte à Instância Gerenciada de SQL do Azure e implantar a Instância Gerenciada

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso managedInstances pode ser implantado com operações de destino:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Sql/managedInstances, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/managedInstances@2024-11-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      administratorLogin = "string"
      administratorLoginPassword = "string"
      administrators = {
        administratorType = "string"
        azureADOnlyAuthentication = bool
        login = "string"
        principalType = "string"
        sid = "string"
        tenantId = "string"
      }
      authenticationMetadata = "string"
      collation = "string"
      databaseFormat = "string"
      dnsZonePartner = "string"
      hybridSecondaryUsage = "string"
      instancePoolId = "string"
      isGeneralPurposeV2 = bool
      keyId = "string"
      licenseType = "string"
      maintenanceConfigurationId = "string"
      managedInstanceCreateMode = "string"
      memorySizeInGB = int
      minimalTlsVersion = "string"
      pricingModel = "string"
      primaryUserAssignedIdentityId = "string"
      proxyOverride = "string"
      publicDataEndpointEnabled = bool
      requestedBackupStorageRedundancy = "string"
      requestedLogicalAvailabilityZone = "string"
      restorePointInTime = "string"
      servicePrincipal = {
        type = "string"
      }
      sourceManagedInstanceId = "string"
      storageIOps = int
      storageSizeInGB = int
      storageThroughputMBps = int
      subnetId = "string"
      timezoneId = "string"
      vCores = int
      zoneRedundant = bool
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  }
}

Valores de propriedade

Microsoft.Sql/managedInstances

Name	Description	Value
identidade	A identidade do Azure Active Directory da instância gerenciada.	ResourceIdentity
local	Local do recurso.	cadeia de caracteres (obrigatório)
name	O nome do recurso	cadeia de caracteres (obrigatório)
parent_id	A ID do recurso ao qual aplicar esse recurso de extensão.	cadeia de caracteres (obrigatório)
properties	Propriedades do recurso.	ManagedInstanceProperties
sku	SKU da instância gerenciada. Valores permitidos para sku.name: GP_Gen5 (Uso Geral, Série Padrão); GP_G8IM (Uso Geral, Série Premium); GP_G8IH (uso geral, memória da série Premium otimizada); BC_Gen5 (Crítico para os Negócios, Standard-Series); BC_G8IM (Business Critical, série Premium); BC_G8IH (Business Critical, otimizado para memória da série Premium).	Sku
tags	Etiquetas de recursos	Dicionário de nomes e valores de tags.
tipo	O tipo de recurso	"Microsoft.Sql/managedInstances@2024-11-01-preview"

ManagedInstanceExternalAdministrator

Name	Description	Value
administratorType	Tipo do administrador de sever.	'ActiveDirectory'
azureADOnlyAuthentication	Somente autenticação do Azure Active Directory habilitada.	bool
login	Nome de logon do administrador do servidor.	cadeia
principalType	Tipo de entidade de segurança do administrador de sever.	'Application' 'Group' 'User'
sid	SID (ID do objeto) do administrador do servidor.	string Constraints: Comprimento mínimo = 36 Comprimento máximo = 36 Padrão = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
tenantId	ID do locatário do administrador.	string Constraints: Comprimento mínimo = 36 Comprimento máximo = 36 Padrão = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`

ManagedInstanceProperties

Name	Description	Value
administratorLogin	Nome de usuário do administrador para a instância gerenciada. Só pode ser especificado quando a instância gerenciada está sendo criada (e é necessária para a criação).	cadeia
administratorLoginPassword	A senha de logon do administrador (necessária para a criação da instância gerenciada).	string Constraints: Valor confidencial. Passe como um parâmetro seguro.
administrators	O administrador do Azure Active Directory pode ser utilizado durante a criação da instância e para atualizações de instância, exceto para a propriedade azureADOnlyAuthentication. Para atualizar a propriedade azureADOnlyAuthentication, a API individual deve ser usada.	ManagedInstanceExternalAdministrator
authenticationMetadata	O modo de pesquisa de metadados de autenticação da instância gerenciada.	'AzureAD' 'Paired' 'Windows'
agrupamento	Ordenação da instância gerenciada.	cadeia
databaseFormat	Especifica o formato interno de bancos de dados de instância específicos para a versão do mecanismo SQL.	'AlwaysUpToDate' 'SQLServer2022' 'SQLServer2025'
dnsZonePartner	A ID de recurso de outra instância gerenciada cuja zona DNS essa instância gerenciada compartilhará após a criação.	cadeia
hybridSecondaryUsage	Uso secundário híbrido. Os valores possíveis são 'Ativo' (valor padrão) e 'Passivo' (o cliente usa o secundário como DR Passivo).	'Active' 'Passive'
instancePoolId	A ID do pool de instâncias à qual este servidor gerenciado pertence.	cadeia
isGeneralPurposeV2	Se esta é ou não uma variante GPv2 da edição Uso Geral.	bool
keyId	Um URI do CMK da chave a ser usada para criptografia.	cadeia
licenseType	O tipo de licença. Os valores possíveis são 'LicenseIncluded' (preço regular inclusive de uma nova licença sql) e 'BasePrice' (preço ahb com desconto para trazer suas próprias licenças SQL).	'BasePrice' 'LicenseIncluded'
maintenanceConfigurationId	Especifica a ID de configuração de manutenção a ser aplicada a essa instância gerenciada.	cadeia
managedInstanceCreateMode	Especifica o modo de criação de banco de dados. Padrão: criação de instância regular. Restauração: cria uma instância restaurando um conjunto de backups para um ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId devem ser especificados.	'Default' 'PointInTimeRestore'
memorySizeInGB	Tamanho da memória em GB. Valor mínimo: 28. Valor máximo: 870. O valor mínimo e máximo depende do número de vCores e da camada de serviço. Leia mais sobre limites de recursos: https://aka.ms/mi-resource-limits-api.	int
minimalTlsVersion	Versão mínima do TLS. Valores permitidos: 'None', '1.0', '1.1', '1.2'	cadeia
pricingModel	Modelo de preços da Instância Gerenciada.	'Freemium' 'Regular'
primaryUserAssignedIdentityId	A ID de recurso de uma identidade atribuída pelo usuário a ser usada por padrão.	cadeia
proxyOverride	Tipo de conexão usado para se conectar à instância.	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	Se o ponto de extremidade de dados público está habilitado ou não.	bool
requestedBackupStorageRedundancy	O tipo de conta de armazenamento a ser usado para armazenar backups para essa instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)	'Geo' 'GeoZone' 'Local' 'Zone'
requestedLogicalAvailabilityZone	Especifica a zona de disponibilidade lógica na qual a Instância Gerenciada está fixada.	'1' '2' '3' 'NoPreference'
restorePointInTime	Especifica o ponto no tempo (formato ISO8601) do banco de dados de origem que será restaurado para criar o novo banco de dados.	cadeia
servicePrincipal	A entidade de serviço da instância gerenciada.	ServicePrincipal
sourceManagedInstanceId	O identificador de recurso da instância gerenciada de origem associada à operação de criação dessa instância.	cadeia
storageIOps	IOps de armazenamento. Valor mínimo: 300. Valor máximo: 80000. Incrementos de 1 IOps somente permitidos. O valor máximo depende da família de hardware selecionada e do número de vCores.	int
storageSizeInGB	Tamanho do armazenamento em GB. Valor mínimo: 32. Valor máximo: 32768. Incrementos de 32 GB somente permitidos. O valor máximo depende da família de hardware selecionada e do número de vCores.	int
storageThroughputMBps	Não há suporte para o parâmetro MBps de taxa de transferência de armazenamento na operação de criação/atualização da instância.	int
subnetId	ID de recurso de sub-rede para a instância gerenciada.	cadeia
timezoneId	Id do fuso horário. Os valores permitidos são fusos horários compatíveis com o Windows. O Windows mantém detalhes sobre fusos horários com suporte, incluindo a ID, no Registro em KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fusos horários. Você pode obter esses valores do Registro por meio do SQL Server consultando o nome SELECT AS timezone_id FROM sys.time_zone_info. A lista de IDs também pode ser obtida executando [System.TimeZoneInfo]::GetSystemTimeZones() no PowerShell. Um exemplo de ID de fuso horário válida é "Horário Padrão do Pacífico" ou "W. Horário Padrão da Europa".	cadeia
vCores	O número de vCores. Valores permitidos: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Os vCores com suporte dependem da família de hardware e da camada de serviço selecionadas.	int
zoneRedundant	Se a redundância de zona está habilitada ou não.	bool

ResourceIdentity

Name	Description	Value
tipo	O tipo de identidade. Defina isso como "SystemAssigned" para criar e atribuir automaticamente uma entidade de segurança do Azure Active Directory para o recurso.	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'
userAssignedIdentities	As IDs de recurso das identidades atribuídas pelo usuário a serem usadas	ResourceIdentityUserAssignedIdentities

ResourceIdentityUserAssignedIdentities

Name	Description	Value

ServicePrincipal

Name	Description	Value
tipo	Tipo de entidade de serviço.	'None' 'SystemAssigned'

Sku

Name	Description	Value
capacidade	Capacidade da SKU específica.	int
family	Se o serviço tiver diferentes gerações de hardware, para a mesma SKU, isso poderá ser capturado aqui.	cadeia
name	O nome da SKU, normalmente, uma letra + código de número, por exemplo, P3.	cadeia de caracteres (obrigatório)
size	Tamanho da SKU específica	cadeia
nível	A camada ou edição da SKU específica, por exemplo, Basic, Premium.	cadeia

TrackedResourceTags

Name	Description	Value

UserIdentity

Name	Description	Value

Exemplos de uso

Módulos verificados do Azure

O módulos verificados do Azure a seguir pode ser usado para implantar esse tipo de recurso.

Module	Description
Instância Gerenciada de SQL	Módulo de recurso AVM para Instância Gerenciada de SQL

Comentários

Esta página foi útil?

Last updated on 2025-09-17

Compartilhar via

Microsoft.Sql managedInstances

Definição de recurso do Bicep

Formato de recurso

Valores de propriedade

Microsoft.Sql/managedInstances

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

Exemplos de uso

Módulos verificados do Azure

Exemplos de Início Rápido do Azure

Definição de recurso de modelo do ARM

Formato de recurso

Valores de propriedade

Microsoft.Sql/managedInstances

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

Exemplos de uso

Modelos de Início Rápido do Azure

Definição de recurso do Terraform (provedor de AzAPI)

Formato de recurso

Valores de propriedade

Microsoft.Sql/managedInstances

ManagedInstanceExternalAdministrator

ManagedInstanceProperties

ResourceIdentity

ResourceIdentityUserAssignedIdentities

ServicePrincipal

Sku

TrackedResourceTags

UserIdentity

Exemplos de uso

Módulos verificados do Azure

Comentários

Recursos adicionais