Microsoft.Sql managedInstances

Definição de recurso do Bicep

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

Para obter uma lista das propriedades alteradas em cada versão da API, consulte 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@2023-05-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'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    administratorLogin: 'string'
    administratorLoginPassword: 'string'
    administrators: {
      administratorType: 'ActiveDirectory'
      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'
    minimalTlsVersion: 'string'
    pricingModel: 'string'
    primaryUserAssignedIdentityId: 'string'
    proxyOverride: 'string'
    publicDataEndpointEnabled: bool
    requestedBackupStorageRedundancy: 'string'
    restorePointInTime: 'string'
    servicePrincipal: {
      type: 'string'
    }
    sourceManagedInstanceId: 'string'
    storageIOps: int
    storageSizeInGB: int
    storageThroughputMBps: int
    subnetId: 'string'
    timezoneId: 'string'
    vCores: int
    zoneRedundant: bool
  }
}

Valores de propriedade

managedInstances

Nome Descrição Valor
name O nome do recurso cadeia de caracteres (obrigatório)

Limite de caracteres: 1-63

Caracteres válidos:
Letras minúsculas, números e hifens.

Não pode iniciar ou terminar com hífen.

O nome do recurso deve ser exclusivo no Azure.
local Local do recurso. cadeia de caracteres (obrigatório)
marcas Marcas de recurso. Dicionário de nomes e valores de marcas. Confira Marcas em modelos
sku SKU de instância gerenciada. Valores permitidos para sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM BC_G8IH Sku
identidade A identidade do Azure Active Directory da instância gerenciada. ResourceIdentity
properties Propriedades do recurso. ManagedInstanceProperties

ResourceIdentity

Nome Descrição Valor
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

Nome Descrição Valor
{propriedade personalizada} UserIdentity

UserIdentity

Esse objeto não contém nenhuma propriedade a ser definida durante a implantação. Todas as propriedades são ReadOnly.

ManagedInstanceProperties

Nome Descrição Valor
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). string
administratorLoginPassword A senha de logon do administrador (necessária para a criação da instância gerenciada). string

Restrições:
Valor confidencial. Passe como um parâmetro seguro.
administradores O administrador do Azure Active Directory da instância. Isso só pode ser usado no momento da criação da instância. Se usado para atualização de instância, ele será ignorado ou resultará em um erro. Para atualizações, as APIs individuais precisarão ser usadas. ManagedInstanceExternalAdministrator
authenticationMetadata O modo de pesquisa de metadados de autenticação da instância gerenciada. 'AzureAD'
'Emparelhado'
'Windows'
ordenação Ordenação da instância gerenciada. string
databaseFormat Especifica o formato interno de bancos de dados de instância específicos para a versão do mecanismo SQL. 'AlwaysUpToDate'
'SQLServer2022'
dnsZonePartner A ID de recurso de outra instância gerenciada cuja zona DNS essa instância gerenciada compartilhará após a criação. string
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). 'Ativo'
'Passivo'
instancePoolId A ID do pool de instâncias à qual este servidor gerenciado pertence. string
isGeneralPurposeV2 Se esta é ou não uma variante GPv2 da edição Uso Geral. bool
keyId Um URI da CMK da chave a ser usada para criptografia. string
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. string
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 ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId devem ser especificados.
'Padrão'
'PointInTimeRestore'
minimalTlsVersion Versão mínima do TLS. Valores permitidos: 'None', '1.0', '1.1', '1.2' string
pricingModel Clima ou não Instância Gerenciada é freemium. 'Freemium'
'Regular'
primaryUserAssignedIdentityId A ID de recurso de uma identidade atribuída pelo usuário a ser usada por padrão. string
proxyOverride Tipo de conexão usado para se conectar à instância. 'Padrão'
'Proxy'
'Redirecionamento'
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 essa instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage) 'Geo'
'GeoZone'
'Local'
'Zone'
restorePointInTime Especifica o ponto no tempo (formato ISO8601) do banco de dados de origem que será restaurado para criar o novo banco de dados. string
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. string
storageIOps IOps de armazenamento. Valor mínimo: 120. Valor máximo: 120000. Incrementos de 1 IOps permitidos apenas. 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: 16384. Incrementos de 32 GB permitidos apenas. O valor máximo depende da família de hardware selecionada e do número de vCores. INT
storageThroughputMBps Taxa de transferência de armazenamento em MBps. Valor mínimo: 25. Valor máximo: 4000. Incrementos de 1 MBps permitidos apenas. O valor máximo depende da família de hardware selecionada e do número de vCores. INT
subnetId ID do recurso de sub-rede para a instância gerenciada. string
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\Time Zones.
Você pode obter esses valores do Registro por meio de 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álida é "Hora Padrão do Pacífico" ou "W. Hora Padrão da Europa".
string
vCores O número de vCores. Valores permitidos: 8, 16, 24, 32, 40, 64, 80. INT
zoneRedundant Se o multi-az está habilitado ou não. bool

ManagedInstanceExternalAdministrator

Nome Descrição Valor
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. string
principalType Tipo principal do administrador de sever. 'Application'
'Group'
'User'
sid SID (ID do objeto) do administrador do servidor. string

Restrições:
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

Restrições:
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}$

ServicePrincipal

Nome Descrição Valor
tipo Tipo de entidade de serviço. 'None'
'SystemAssigned'

Sku

Nome Descrição Valor
ALOCADA Capacidade do SKU específico. INT
família Se o serviço tiver diferentes gerações de hardware, para a mesma SKU, isso poderá ser capturado aqui. string
name O nome do SKU, normalmente, uma letra + Código de número, por exemplo, P3. cadeia de caracteres (obrigatório)
tamanho Tamanho do SKU específico string
Camada A camada ou edição do SKU específico, por exemplo, Básico, Premium. string

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Implantar Instância Gerenciada de SQL com Rede

Implantar no Azure
Implantar UDR e NSG para dar suporte a Instância Gerenciada de SQL do Azure e implantar o Instância Gerenciada
Criar MI do SQL dentro da nova rede virtual

Implantar no Azure
Implante a MI (Instância Gerenciada do Banco de Dados Sql do Azure) dentro de novas Rede Virtual.
Criar a MI do SQL com o envio configurado de logs e métricas

Implantar no Azure
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 uma nova rede virtual

Implantar no Azure
Implante o Banco de Dados Sql do Azure Instância Gerenciada (SQL MI) e o JumpBox com O SSMS dentro de novas Rede Virtual.
Criar a MI do SQL com a conexão ponto a site configurada

Implantar no Azure
Implante o BANCO de Dados Sql do Azure Instância Gerenciada (MI sql) e o gateway de rede virtual configurado para conexão ponto a site dentro da nova rede virtual.

Definição de recurso de modelo do 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 de recurso

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

{
  "type": "Microsoft.Sql/managedInstances",
  "apiVersion": "2023-05-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",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "administratorLogin": "string",
    "administratorLoginPassword": "string",
    "administrators": {
      "administratorType": "ActiveDirectory",
      "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",
    "minimalTlsVersion": "string",
    "pricingModel": "string",
    "primaryUserAssignedIdentityId": "string",
    "proxyOverride": "string",
    "publicDataEndpointEnabled": "bool",
    "requestedBackupStorageRedundancy": "string",
    "restorePointInTime": "string",
    "servicePrincipal": {
      "type": "string"
    },
    "sourceManagedInstanceId": "string",
    "storageIOps": "int",
    "storageSizeInGB": "int",
    "storageThroughputMBps": "int",
    "subnetId": "string",
    "timezoneId": "string",
    "vCores": "int",
    "zoneRedundant": "bool"
  }
}

Valores de propriedade

managedInstances

Nome Descrição Valor
tipo O tipo de recurso 'Microsoft.Sql/managedInstances'
apiVersion A versão da API de recursos '2023-05-01-preview'
name O nome do recurso cadeia de caracteres (obrigatório)

Limite de caracteres: 1 a 63

Caracteres válidos:
Letras minúsculas, números e hifens.

Não pode iniciar ou terminar com hífen.

O nome do recurso deve ser exclusivo no Azure.
local Local do recurso. cadeia de caracteres (obrigatório)
marcas Marcas de recurso. Dicionário de nomes e valores de marcas. Consulte Marcas em modelos
sku SKU de instância gerenciada. Valores permitidos para sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM BC_G8IH Sku
identidade A identidade do Azure Active Directory da instância gerenciada. ResourceIdentity
properties Propriedades do recurso. ManagedInstanceProperties

ResourceIdentity

Nome Descrição Valor
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

Nome Descrição Valor
{propriedade personalizada} UserIdentity

UserIdentity

Esse objeto não contém nenhuma propriedade a ser definida durante a implantação. Todas as propriedades são ReadOnly.

ManagedInstanceProperties

Nome Descrição Valor
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). string
administratorLoginPassword A senha de logon do administrador (necessária para a criação da instância gerenciada). string

Restrições:
Valor confidencial. Passe como um parâmetro seguro.
administradores O administrador do Azure Active Directory da instância. Isso só pode ser usado no momento da criação da instância. Se usado para atualização de instância, ele será ignorado ou resultará em um erro. Para atualizações, as APIs individuais precisarão ser usadas. ManagedInstanceExternalAdministrator
authenticationMetadata O modo de pesquisa de metadados de autenticação da instância gerenciada. 'AzureAD'
'Emparelhado'
'Windows'
ordenação Ordenação da instância gerenciada. string
databaseFormat Especifica o formato interno de bancos de dados de instância específicos para a versão do mecanismo SQL. 'AlwaysUpToDate'
'SQLServer2022'
dnsZonePartner A ID do recurso de outra instância gerenciada cuja zona DNS essa instância gerenciada compartilhará após a criação. string
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). 'Ativo'
'Passivo'
instancePoolId A ID do pool de instâncias à qual este servidor gerenciado pertence. string
isGeneralPurposeV2 Se esta é ou não uma variante GPv2 da edição Uso Geral. bool
keyId Um URI da CMK da chave a ser usada para criptografia. string
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. string
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 ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId devem ser especificados.
'Padrão'
'PointInTimeRestore'
minimalTlsVersion Versão mínima do TLS. Valores permitidos: 'None', '1.0', '1.1', '1.2' string
pricingModel Clima ou não Instância Gerenciada é freemium. 'Freemium'
'Regular'
primaryUserAssignedIdentityId A ID de recurso de uma identidade atribuída pelo usuário a ser usada por padrão. string
proxyOverride Tipo de conexão usado para se conectar à instância. 'Padrão'
'Proxy'
'Redirecionamento'
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 essa instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage) 'Geo'
'GeoZone'
'Local'
'Zone'
restorePointInTime Especifica o ponto no tempo (formato ISO8601) do banco de dados de origem que será restaurado para criar o novo banco de dados. string
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. string
storageIOps IOps de armazenamento. Valor mínimo: 120. Valor máximo: 120000. Incrementos de 1 IOps permitidos apenas. 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: 16384. Incrementos de 32 GB permitidos apenas. O valor máximo depende da família de hardware selecionada e do número de vCores. INT
storageThroughputMBps Taxa de transferência de armazenamento em MBps. Valor mínimo: 25. Valor máximo: 4000. Incrementos de 1 MBps permitidos apenas. O valor máximo depende da família de hardware selecionada e do número de vCores. INT
subnetId ID do recurso de sub-rede para a instância gerenciada. string
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\Time Zones.
Você pode obter esses valores do Registro por meio de 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álida é "Hora Padrão do Pacífico" ou "W. Hora Padrão da Europa".
string
vCores O número de vCores. Valores permitidos: 8, 16, 24, 32, 40, 64, 80. INT
zoneRedundant Se o multi-az está habilitado ou não. bool

ManagedInstanceExternalAdministrator

Nome Descrição Valor
administratorType Tipo do administrador do servidor. 'ActiveDirectory'
azureADOnlyAuthentication Somente a Autenticação do Azure Active Directory está habilitada. bool
login Nome de logon do administrador do servidor. string
principalType Tipo de entidade de segurança do administrador do servidor. 'Application'
'Group'
'User'
sid SID (ID de objeto) do administrador do servidor. string

Restrições:
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

Restrições:
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}$

ServicePrincipal

Nome Descrição Valor
tipo Tipo de entidade de serviço. 'None'
'SystemAssigned'

Sku

Nome Descrição Valor
ALOCADA Capacidade do SKU específico. INT
família Se o serviço tiver gerações diferentes de hardware, para a mesma SKU, isso poderá ser capturado aqui. string
name O nome da SKU, normalmente, uma letra + código de número, por exemplo, P3. cadeia de caracteres (obrigatório)
tamanho Tamanho do SKU específico string
Camada A camada ou edição do SKU específico, por exemplo, Básico, Premium. string

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Implantar Instância Gerenciada de SQL com Rede

Implantar no Azure
Implantar UDR e NSG para dar suporte a Instância Gerenciada de SQL do Azure e implantar o Instância Gerenciada
Criar MI do SQL dentro da nova rede virtual

Implantar no Azure
Implante o BANCO de Dados Sql do Azure Instância Gerenciada (MI de SQL) dentro de novas Rede Virtual.
Criar MI do SQL com o envio configurado de logs e métricas

Implantar no Azure
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 uma nova rede virtual

Implantar no Azure
Implante o Banco de Dados Sql do Azure Instância Gerenciada (MI do SQL) e o JumpBox com o SSMS dentro de novas Rede Virtual.
Criar MI do SQL com conexão ponto a site configurada

Implantar no Azure
Implante o BANCO de Dados Sql do Azure Instância Gerenciada (MI do SQL) e o gateway de rede virtual configurados para conexão ponto a site dentro da nova rede virtual.

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

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

  • Grupos de recursos

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

Formato de recurso

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/managedInstances@2023-05-01-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      administratorLogin = "string"
      administratorLoginPassword = "string"
      administrators = {
        administratorType = "ActiveDirectory"
        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"
      minimalTlsVersion = "string"
      pricingModel = "string"
      primaryUserAssignedIdentityId = "string"
      proxyOverride = "string"
      publicDataEndpointEnabled = bool
      requestedBackupStorageRedundancy = "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

managedInstances

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.Sql/managedInstances@2023-05-01-preview"
name O nome do recurso cadeia de caracteres (obrigatório)

Limite de caracteres: 1-63

Caracteres válidos:
Letras minúsculas, números e hifens.

Não pode iniciar ou terminar com hífen.

O nome do recurso deve ser exclusivo no Azure.
local Local do recurso. cadeia de caracteres (obrigatório)
parent_id Para implantar em um grupo de recursos, use a ID desse grupo de recursos. cadeia de caracteres (obrigatório)
marcas Marcas de recurso. Dicionário de nomes e valores de marcas.
sku SKU de instância gerenciada. Valores permitidos para sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM BC_G8IH Sku
identidade A identidade do Azure Active Directory da instância gerenciada. ResourceIdentity
properties Propriedades do recurso. ManagedInstanceProperties

ResourceIdentity

Nome Descrição Valor
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. "SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned"
identity_ids As IDs de recurso das identidades atribuídas pelo usuário a serem usadas Matriz de IDs de identidade do usuário.

ResourceIdentityUserAssignedIdentities

Nome Descrição Valor
{propriedade personalizada} UserIdentity

UserIdentity

Esse objeto não contém nenhuma propriedade a ser definida durante a implantação. Todas as propriedades são ReadOnly.

ManagedInstanceProperties

Nome Descrição Valor
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). string
administratorLoginPassword A senha de logon do administrador (necessária para a criação da instância gerenciada). string

Restrições:
Valor confidencial. Passe como um parâmetro seguro.
administradores O administrador do Azure Active Directory da instância. Isso só pode ser usado no momento da criação da instância. Se usado para atualização de instância, ele será ignorado ou resultará em um erro. Para atualizações, as APIs individuais precisarão ser usadas. ManagedInstanceExternalAdministrator
authenticationMetadata O modo de pesquisa de metadados de autenticação da instância gerenciada. "AzureAD"
"Emparelhado"
“Windows”
ordenação Ordenação da instância gerenciada. string
databaseFormat Especifica o formato interno de bancos de dados de instância específicos para a versão do mecanismo SQL. "AlwaysUpToDate"
"SQLServer2022"
dnsZonePartner A ID do recurso de outra instância gerenciada cuja zona DNS essa instância gerenciada compartilhará após a criação. string
hybridSecondaryUsage Uso secundário híbrido. Os valores possíveis são 'Active' (valor padrão) e 'Passivo' (o cliente usa o secundário como DR passivo). "Ativo"
"Passivo"
instancePoolId A ID do pool de instâncias à qual este servidor gerenciado pertence. string
isGeneralPurposeV2 Se essa é ou não uma variante GPv2 da edição Uso Geral. bool
keyId Um URI cmk da chave a ser usada para criptografia. string
licenseType O tipo de licença. Os valores possíveis são 'LicenseIncluded' (preço regular inclusivo 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. string
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 ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId devem ser especificados.
"Padrão"
"PointInTimeRestore"
minimalTlsVersion Versão mínima do TLS. Valores permitidos: 'None', '1.0', '1.1', '1.2' string
pricingModel Clima ou não Instância Gerenciada é freemium. "Freemium"
"Regular"
primaryUserAssignedIdentityId A ID de recurso de uma identidade atribuída pelo usuário a ser usada por padrão. string
proxyOverride Tipo de conexão usado para se conectar à instância. "Padrão"
"Proxy"
"Redirecionamento"
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 essa instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage) "Geo"
"GeoZone"
"Local"
"Zona"
restorePointInTime Especifica o ponto no tempo (formato ISO8601) do banco de dados de origem que será restaurado para criar o novo banco de dados. string
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. string
storageIOps IOps de armazenamento. Valor mínimo: 120. Valor máximo: 120000. Incrementos de 1 IOps permitidos apenas. 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: 16384. Incrementos de 32 GB permitidos apenas. O valor máximo depende da família de hardware selecionada e do número de vCores. INT
storageThroughputMBps Taxa de transferência de armazenamento em MBps. Valor mínimo: 25. Valor máximo: 4000. Incrementos de 1 MBps permitidos apenas. O valor máximo depende da família de hardware selecionada e do número de vCores. INT
subnetId ID do recurso de sub-rede para a instância gerenciada. string
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\Time Zones.
Você pode obter esses valores do Registro por meio de 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álida é "Hora Padrão do Pacífico" ou "W. Hora Padrão da Europa".
string
vCores O número de vCores. Valores permitidos: 8, 16, 24, 32, 40, 64, 80. INT
zoneRedundant Se o multi-az está habilitado ou não. bool

ManagedInstanceExternalAdministrator

Nome Descrição Valor
administratorType Tipo do administrador do servidor. "ActiveDirectory"
azureADOnlyAuthentication Somente a Autenticação do Azure Active Directory está habilitada. bool
login Nome de logon do administrador do servidor. string
principalType Tipo de entidade de segurança do administrador do servidor. "Aplicativo"
"Agrupar"
"User"
sid SID (ID de objeto) do administrador do servidor. string

Restrições:
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

Restrições:
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}$

ServicePrincipal

Nome Descrição Valor
tipo Tipo de entidade de serviço. "None"
"SystemAssigned"

Sku

Nome Descrição Valor
ALOCADA Capacidade do SKU específico. INT
família Se o serviço tiver gerações diferentes de hardware, para a mesma SKU, isso poderá ser capturado aqui. string
name O nome da SKU, normalmente, uma letra + código de número, por exemplo, P3. cadeia de caracteres (obrigatório)
tamanho Tamanho do SKU específico string
Camada A camada ou edição do SKU específico, por exemplo, Básico, Premium. string