Microsoft.Sql managedInstances

Definição de recursos do bíceps

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

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

Formato do recurso

Para criar um recurso Microsoft.Sql/managedInstances, adicione o seguinte Bicep ao seu 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 Ative Directory da instância gerenciada.	ResourceIdentity
localização	Localização do recurso.	string (obrigatório)
name	O nome do recurso	string (obrigatório)
properties	Propriedades do recurso.	ManagedInstanceProperties
âmbito	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 de 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 (Business Critical, Standard-Series); BC_G8IM (Business Critical, série Premium); BC_G8IH (Business Critical, memória da série Premium otimizada).	Sku
tags	Etiquetas de recursos	Dicionário de nomes e valores de tags. Consulte Tags em modelos

ManagedInstanceExternalAdministrator

Name	Description	Value
administratorType	Tipo de administrador de corte.	'ActiveDirectory'
azureADOnlyAuthentication	Somente Autenticação do Ative Directory do Azure habilitada.	bool
login	Nome de login do administrador do servidor.	cadeia (de caracteres)
principalType	Tipo principal do administrador de corte.	'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 (de caracteres)
administratorLoginPassword	A senha de login do administrador (necessária para a criação da instância gerenciada).	string Constraints: Valor sensível. Passe como um parâmetro seguro.
administrators	O administrador do Azure Ative 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	Modo de pesquisa de metadados de autenticação da instância gerenciada.	'AzureAD' 'Paired' 'Windows'
agrupamento	Agrupamento da instância gerenciada.	cadeia (de caracteres)
databaseFormat	Especifica o formato interno dos 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 (de caracteres)
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 ao qual esse servidor gerenciado pertence.	cadeia (de caracteres)
isGeneralPurposeV2	Se esta é ou não uma variante GPv2 da edição de uso geral.	bool
keyId	Um URI CMK da chave a ser usada para criptografia.	cadeia (de caracteres)
licenseType	O tipo de licença. Os valores possíveis são 'LicenseIncluded' (preço normal incluindo 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 (de caracteres)
managedInstanceCreateMode	Especifica o modo de criação do banco de dados. Padrão: criação de instância regular. Restauração: cria uma instância restaurando um conjunto de backups para um point-in-time específico. RestorePointInTime e SourceManagedInstanceId devem ser especificados.	'Default' 'PointInTimeRestore'
memóriaSizeInGB	Tamanho da memória em GB. Valor mínimo: 28. Valor máximo: 870. Os valores mínimo e máximo dependem 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 TLS mínima. Valores permitidos: 'Nenhum', '1.0', '1.1', '1.2'	cadeia (de caracteres)
pricingModel	Modelo de precificação da Instância Gerenciada.	'Freemium' 'Regular'
primaryUserAssignedIdentityId	A id de recurso de uma identidade atribuída ao usuário a ser usada por padrão.	cadeia (de caracteres)
proxyOverride	Tipo de conexão usado para se conectar à instância.	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	Se o ponto de extremidade de dados públicos está habilitado ou não.	bool
requestedBackupStorageRedundancy	O tipo de conta de armazenamento a ser usado para armazenar backups para esta 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 à 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 (de caracteres)
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 (de caracteres)
storageIOps	IOps de armazenamento. Valor mínimo: 300. Valor máximo: 80000. Apenas são permitidos incrementos de 1 IOps. O valor máximo depende da família de hardware selecionada e do número de vCores.	int
storageSizeInGB	Tamanho de armazenamento em GB. Valor mínimo: 32. Valor máximo: 32768. Apenas são permitidos incrementos de 32 GB. O valor máximo depende da família de hardware selecionada e do número de vCores.	int
storageThroughputMBps	O parâmetro MBps de taxa de transferência de armazenamento não é suportado na operação de criação/atualização da instância.	int
subnetId	ID do recurso de sub-rede para a instância gerenciada.	cadeia (de caracteres)
timezoneId	Id do fuso horário. Os valores permitidos são fusos horários suportados pelo Windows. O Windows mantém detalhes sobre fusos horários suportados, incluindo o id, no registro em KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fuso horário. Você pode obter esses valores do Registro via SQL Server consultando SELECT name 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álido é "Pacific Standard Time" ou "W. Hora Padrão da Europa".	cadeia (de caracteres)
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 suportados 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 do Azure Ative Directory para o recurso.	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'
userAssignedIdentities	As ids de recurso das identidades atribuídas ao 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 do SKU específico.	int
family	Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui.	cadeia (de caracteres)
name	O nome do SKU, normalmente, uma letra + código numérico, por exemplo, P3.	string (obrigatório)
size	Tamanho do SKU específico	cadeia (de caracteres)
escalão	O nível ou edição do SKU específico, por exemplo, Basic, Premium.	cadeia (de caracteres)

TrackedResourceTags

Name	Description	Value

UserIdentity

Name	Description	Value

Exemplos de uso

Módulos verificados do Azure

Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.

Module	Description
Instância gerenciada SQL	Módulo de recursos AVM para instância gerenciada SQL

Exemplos de início rápido do Azure

Os seguintes modelos início rápido do Azure contêm exemplos de Bicep para implantar esse tipo de recurso.

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

Definição de recurso de modelo ARM

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

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

Formato do recurso

Para criar um recurso Microsoft.Sql/managedInstances, adicione o seguinte JSON ao seu 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 api	'2024-11-01-preview'
identidade	A identidade do Azure Ative Directory da instância gerenciada.	ResourceIdentity
localização	Localização do recurso.	string (obrigatório)
name	O nome do recurso	string (obrigatório)
properties	Propriedades do recurso.	ManagedInstanceProperties
sku	SKU de 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 (Business Critical, Standard-Series); BC_G8IM (Business Critical, série Premium); BC_G8IH (Business Critical, memória da série Premium otimizada).	Sku
tags	Etiquetas de recursos	Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo	O tipo de recurso	'Microsoft.Sql/managedInstances'

ManagedInstanceExternalAdministrator

Name	Description	Value
administratorType	Tipo de administrador de corte.	'ActiveDirectory'
azureADOnlyAuthentication	Somente Autenticação do Ative Directory do Azure habilitada.	bool
login	Nome de login do administrador do servidor.	cadeia (de caracteres)
principalType	Tipo principal do administrador de corte.	'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 (de caracteres)
administratorLoginPassword	A senha de login do administrador (necessária para a criação da instância gerenciada).	string Constraints: Valor sensível. Passe como um parâmetro seguro.
administrators	O administrador do Azure Ative 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	Modo de pesquisa de metadados de autenticação da instância gerenciada.	'AzureAD' 'Paired' 'Windows'
agrupamento	Agrupamento da instância gerenciada.	cadeia (de caracteres)
databaseFormat	Especifica o formato interno dos 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 (de caracteres)
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 ao qual esse servidor gerenciado pertence.	cadeia (de caracteres)
isGeneralPurposeV2	Se esta é ou não uma variante GPv2 da edição de uso geral.	bool
keyId	Um URI CMK da chave a ser usada para criptografia.	cadeia (de caracteres)
licenseType	O tipo de licença. Os valores possíveis são 'LicenseIncluded' (preço normal incluindo 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 (de caracteres)
managedInstanceCreateMode	Especifica o modo de criação do banco de dados. Padrão: criação de instância regular. Restauração: cria uma instância restaurando um conjunto de backups para um point-in-time específico. RestorePointInTime e SourceManagedInstanceId devem ser especificados.	'Default' 'PointInTimeRestore'
memóriaSizeInGB	Tamanho da memória em GB. Valor mínimo: 28. Valor máximo: 870. Os valores mínimo e máximo dependem 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 TLS mínima. Valores permitidos: 'Nenhum', '1.0', '1.1', '1.2'	cadeia (de caracteres)
pricingModel	Modelo de precificação da Instância Gerenciada.	'Freemium' 'Regular'
primaryUserAssignedIdentityId	A id de recurso de uma identidade atribuída ao usuário a ser usada por padrão.	cadeia (de caracteres)
proxyOverride	Tipo de conexão usado para se conectar à instância.	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	Se o ponto de extremidade de dados públicos está habilitado ou não.	bool
requestedBackupStorageRedundancy	O tipo de conta de armazenamento a ser usado para armazenar backups para esta 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 à 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 (de caracteres)
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 (de caracteres)
storageIOps	IOps de armazenamento. Valor mínimo: 300. Valor máximo: 80000. Apenas são permitidos incrementos de 1 IOps. O valor máximo depende da família de hardware selecionada e do número de vCores.	int
storageSizeInGB	Tamanho de armazenamento em GB. Valor mínimo: 32. Valor máximo: 32768. Apenas são permitidos incrementos de 32 GB. O valor máximo depende da família de hardware selecionada e do número de vCores.	int
storageThroughputMBps	O parâmetro MBps de taxa de transferência de armazenamento não é suportado na operação de criação/atualização da instância.	int
subnetId	ID do recurso de sub-rede para a instância gerenciada.	cadeia (de caracteres)
timezoneId	Id do fuso horário. Os valores permitidos são fusos horários suportados pelo Windows. O Windows mantém detalhes sobre fusos horários suportados, incluindo o id, no registro em KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fuso horário. Você pode obter esses valores do Registro via SQL Server consultando SELECT name 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álido é "Pacific Standard Time" ou "W. Hora Padrão da Europa".	cadeia (de caracteres)
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 suportados 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 do Azure Ative Directory para o recurso.	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'
userAssignedIdentities	As ids de recurso das identidades atribuídas ao 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 do SKU específico.	int
family	Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui.	cadeia (de caracteres)
name	O nome do SKU, normalmente, uma letra + código numérico, por exemplo, P3.	string (obrigatório)
size	Tamanho do SKU específico	cadeia (de caracteres)
escalão	O nível ou edição do SKU específico, por exemplo, Basic, Premium.	cadeia (de caracteres)

TrackedResourceTags

Name	Description	Value

UserIdentity

Name	Description	Value

Exemplos de uso

Modelos de início rápido do Azure

Os seguintes modelos de início rápido do Azure implantar esse tipo de recurso.

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

Definição de recursos Terraform (provedor AzAPI)

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

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

Formato do recurso

Para criar um recurso Microsoft.Sql/managedInstances, adicione o seguinte Terraform 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 Ative Directory da instância gerenciada.	ResourceIdentity
localização	Localização do recurso.	string (obrigatório)
name	O nome do recurso	string (obrigatório)
parent_id	A ID do recurso ao qual aplicar esse recurso de extensão.	string (obrigatório)
properties	Propriedades do recurso.	ManagedInstanceProperties
sku	SKU de 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 (Business Critical, Standard-Series); BC_G8IM (Business Critical, série Premium); BC_G8IH (Business Critical, memória da série Premium otimizada).	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 de administrador de corte.	'ActiveDirectory'
azureADOnlyAuthentication	Somente Autenticação do Ative Directory do Azure habilitada.	bool
login	Nome de login do administrador do servidor.	cadeia (de caracteres)
principalType	Tipo principal do administrador de corte.	'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 (de caracteres)
administratorLoginPassword	A senha de login do administrador (necessária para a criação da instância gerenciada).	string Constraints: Valor sensível. Passe como um parâmetro seguro.
administrators	O administrador do Azure Ative 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	Modo de pesquisa de metadados de autenticação da instância gerenciada.	'AzureAD' 'Paired' 'Windows'
agrupamento	Agrupamento da instância gerenciada.	cadeia (de caracteres)
databaseFormat	Especifica o formato interno dos 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 (de caracteres)
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 ao qual esse servidor gerenciado pertence.	cadeia (de caracteres)
isGeneralPurposeV2	Se esta é ou não uma variante GPv2 da edição de uso geral.	bool
keyId	Um URI CMK da chave a ser usada para criptografia.	cadeia (de caracteres)
licenseType	O tipo de licença. Os valores possíveis são 'LicenseIncluded' (preço normal incluindo 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 (de caracteres)
managedInstanceCreateMode	Especifica o modo de criação do banco de dados. Padrão: criação de instância regular. Restauração: cria uma instância restaurando um conjunto de backups para um point-in-time específico. RestorePointInTime e SourceManagedInstanceId devem ser especificados.	'Default' 'PointInTimeRestore'
memóriaSizeInGB	Tamanho da memória em GB. Valor mínimo: 28. Valor máximo: 870. Os valores mínimo e máximo dependem 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 TLS mínima. Valores permitidos: 'Nenhum', '1.0', '1.1', '1.2'	cadeia (de caracteres)
pricingModel	Modelo de precificação da Instância Gerenciada.	'Freemium' 'Regular'
primaryUserAssignedIdentityId	A id de recurso de uma identidade atribuída ao usuário a ser usada por padrão.	cadeia (de caracteres)
proxyOverride	Tipo de conexão usado para se conectar à instância.	'Default' 'Proxy' 'Redirect'
publicDataEndpointEnabled	Se o ponto de extremidade de dados públicos está habilitado ou não.	bool
requestedBackupStorageRedundancy	O tipo de conta de armazenamento a ser usado para armazenar backups para esta 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 à 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 (de caracteres)
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 (de caracteres)
storageIOps	IOps de armazenamento. Valor mínimo: 300. Valor máximo: 80000. Apenas são permitidos incrementos de 1 IOps. O valor máximo depende da família de hardware selecionada e do número de vCores.	int
storageSizeInGB	Tamanho de armazenamento em GB. Valor mínimo: 32. Valor máximo: 32768. Apenas são permitidos incrementos de 32 GB. O valor máximo depende da família de hardware selecionada e do número de vCores.	int
storageThroughputMBps	O parâmetro MBps de taxa de transferência de armazenamento não é suportado na operação de criação/atualização da instância.	int
subnetId	ID do recurso de sub-rede para a instância gerenciada.	cadeia (de caracteres)
timezoneId	Id do fuso horário. Os valores permitidos são fusos horários suportados pelo Windows. O Windows mantém detalhes sobre fusos horários suportados, incluindo o id, no registro em KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fuso horário. Você pode obter esses valores do Registro via SQL Server consultando SELECT name 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álido é "Pacific Standard Time" ou "W. Hora Padrão da Europa".	cadeia (de caracteres)
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 suportados 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 do Azure Ative Directory para o recurso.	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned'
userAssignedIdentities	As ids de recurso das identidades atribuídas ao 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 do SKU específico.	int
family	Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui.	cadeia (de caracteres)
name	O nome do SKU, normalmente, uma letra + código numérico, por exemplo, P3.	string (obrigatório)
size	Tamanho do SKU específico	cadeia (de caracteres)
escalão	O nível ou edição do SKU específico, por exemplo, Basic, Premium.	cadeia (de caracteres)

TrackedResourceTags

Name	Description	Value

UserIdentity

Name	Description	Value

Exemplos de uso

Módulos verificados do Azure

Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.

Module	Description
Instância gerenciada SQL	Módulo de recursos AVM para instância gerenciada SQL

Comentários

Esta página foi útil?

Last updated on 2025-09-17

Partilhar via

Microsoft.Sql managedInstances

Definição de recursos do bíceps

Formato do 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 ARM

Formato do 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 recursos Terraform (provedor AzAPI)

Formato do 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