Microsoft.Sql managedInstances
- Mais recente
- 2023-05-01-preview
- 2023-02-01-preview
- 2022-11-01-preview
- 2022-08-01-preview
- 2022-05-01-preview
- 2022-02-01-preview
- 2021-11-01
- 2021-11-01-preview
- 01-2021-08-01-preview
- 01-2021-05-01-preview
- 2021-02-01-preview
- 2020-11-01-preview
- 2020-08-01-preview
- 2020-02-02-preview
- 06-01-pré-visualização de 2018
- 05-05-01-preview de 2015
Definição de recurso do Bicep
O tipo de recurso managedInstances pode ser implementado com operações que visam:
- Grupos de recursos – veja os comandos de implementação do grupo de recursos
Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo 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@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 (obrigatório) Limite de carateres: 1-63 Carateres válidos: Letras minúsculas, números e hífenes. Não é possível iniciar ou terminar com hífen. O nome do recurso tem de ser exclusivo em todo o Azure. |
| localização | Localização do recurso. | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos. | Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos |
| sku | SKU da instância gerida. 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 gerida. | ResourceIdentity |
| propriedades | Propriedades do recurso. | ManagedInstanceProperties |
ResourceIdentity
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de identidade. Defina esta opção como "SystemAssigned" para criar e atribuir automaticamente um principal do Azure Active Directory para o recurso. | "Nenhum" "SystemAssigned" "SystemAssigned,UserAssigned" "UserAssigned" |
| userAssignedIdentities | Os IDs de recursos das identidades atribuídas pelo utilizador a utilizar | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Nome | Descrição | Valor |
|---|---|---|
| {customized property} | UserIdentity |
UserIdentity
Este objeto não contém quaisquer propriedades a definir durante a implementação. Todas as propriedades são ReadOnly.
ManagedInstanceProperties
| Nome | Descrição | Valor |
|---|---|---|
| administratorLogin | Nome de utilizador administrador da instância gerida. Só pode ser especificado quando a instância gerida está a ser criada (e é necessária para a criação). | string |
| administratorLoginPassword | A palavra-passe de início de sessão do administrador (necessária para a criação da instância gerida). | string Restrições: Valor confidencial. Transmita como um parâmetro seguro. |
| administradores | O administrador do Azure Active Directory da instância. Esta ação só pode ser utilizada no momento de criação de instâncias. Se for utilizada para a atualização de instâncias, será ignorada ou resultará num erro. Para atualizações, as APIs individuais terão de ser utilizadas. | ManagedInstanceExternalAdministrator |
| authenticationMetadata | O modo de pesquisa de metadados de autenticação da instância gerida. | "AzureAD" "Emparelhado" 'Windows' |
| agrupamento | Agrupamento da instância gerida. | string |
| databaseFormat | Especifica o formato interno das bases de dados de instância específicas da versão do motor SQL. | "AlwaysUpToDate" "SQLServer2022" |
| dnsZonePartner | O ID de recurso de outra instância gerida cuja zona DNS esta instância gerida irá partilhar após a criação. | string |
| hybridSecondaryUsage | Utilização secundária híbrida. Os valores possíveis são "Ativo" (valor predefinido) e "Passivo" (o cliente utiliza a secundária como DR Passiva). | "Ativo" "Passivo" |
| instancePoolId | O ID do conjunto de instâncias a que este servidor gerido pertence. | string |
| isGeneralPurposeV2 | Quer esta seja ou não uma variante GPv2 da edição Fins Gerais. | bool |
| keyId | Um URI CMK da chave a utilizar para encriptação. | string |
| licenseType | O tipo de licença. Os valores possíveis são "LicenseIncluded" (preço normal, incluindo uma nova licença SQL) e "Preço Base" (preço AHB com desconto para trazer as suas próprias licenças SQL). | "Preço Base" "LicenseIncluded" |
| maintenanceConfigurationId | Especifica o ID de configuração de manutenção a aplicar a esta instância gerida. | string |
| managedInstanceCreateMode | Especifica o modo de criação da base de dados. Predefinição: criação de instâncias regulares. Restauro: cria uma instância ao restaurar um conjunto de cópias de segurança para um ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId têm de ser especificados. |
'Predefinição' "PointInTimeRestore" |
| minimalTlsVersion | Versão mínima do TLS. Valores permitidos: "None", "1.0", "1.1", "1.2" | string |
| pricingModel | A Meteorologia ou não a Instância Gerida é freemium. | 'Freemium' 'Regular' |
| primaryUserAssignedIdentityId | O ID de recurso de uma identidade atribuída pelo utilizador a utilizar por predefinição. | string |
| proxyOverride | Tipo de ligação utilizado para ligar à instância. | 'Predefinição' 'Proxy' "Redirecionamento" |
| publicDataEndpointEnabled | Se o ponto final de dados públicos está ou não ativado. | bool |
| requestedBackupStorageRedundancy | O tipo de conta de armazenamento a ser utilizado para armazenar cópias de segurança para esta instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage) | 'Geo' "Zona Geográfica" "Local" "Zona" |
| restorePointInTime | Especifica o ponto anterior no tempo (ISO8601 formato) da base de dados de origem que será restaurada para criar a nova base de dados. | string |
| servicePrincipal | O principal de serviço da instância gerida. | ServicePrincipal |
| sourceManagedInstanceId | O identificador de recurso da instância gerida de origem associada à operação de criação desta 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 | Débito 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 gerida. | string |
| 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 registo em KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fusos Horários. Pode obter esses valores de registo através de SQL Server consultando o nome SELECT AS timezone_id FROM sys.time_zone_info. A lista de IDs também pode ser obtida ao executar [System.TimeZoneInfo]::GetSystemTimeZones() no PowerShell. Um exemplo de ID de fuso horário válido é "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á ou não ativado. | bool |
ManagedInstanceExternalAdministrator
| Nome | Descrição | Valor |
|---|---|---|
| administratorType | Tipo de administrador de gravidade. | "ActiveDirectory" |
| azureADOnlyAuthentication | Apenas a Autenticação do Azure Active Directory está ativada. | bool |
| início de sessão | Nome de início de sessão do administrador do servidor. | string |
| principalType | Tipo principal do administrador de gravidade. | "Aplicação" "Grupo" "Utilizador" |
| 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 inquilino 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 principal de serviço. | "Nenhum" "SystemAssigned" |
Sku
| Nome | Descrição | Valor |
|---|---|---|
| capacidade | Capacidade do SKU específico. | int |
| família | Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui. | string |
| name | O nome do SKU, normalmente, uma letra + Código de número, por exemplo, P3. | cadeia (obrigatório) |
| size | Tamanho do SKU específico | string |
| tier | O escalão ou edição do SKU específico, por exemplo, Básico, Premium. | string |
Modelos de início rápido
Os seguintes modelos de início rápido implementam este tipo de recurso.
| Modelo | Description |
|---|---|
Implementar SQL Managed Instance com Redes |
Implementar o UDR e o NSG para suportar Azure SQL Managed Instance e implementar a Instância Gerida |
| Criar o SQL MI dentro da nova rede virtual |
Implemente o Azure Sql Database Managed Instance (SQL MI) dentro de novas Rede Virtual. |
| Criar o SQL MI com o envio configurado de registos e métricas |
Este modelo permite-lhe implementar o SQL MI e recursos adicionais utilizados para armazenar registos e métricas (área de trabalho de diagnóstico, conta de armazenamento, hub de eventos). |
| Criar o SQL MI com a jumpbox dentro de uma nova rede virtual |
Implemente o Azure Sql Database Managed Instance (SQL MI) e o JumpBox com o SSMS dentro de novas Rede Virtual. |
| Criar o SQL MI com a ligação ponto a site configurada |
Implemente o Azure Sql Database Managed Instance (SQL MI) e o Gateway de rede virtual configurados para ligação ponto a site dentro da nova rede virtual. |
Definição de recurso de modelo do ARM
O tipo de recurso managedInstances pode ser implementado com operações que visam:
- Grupos de recursos – veja comandos de implementação de grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, veja registo 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": "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 (obrigatório) Limite de carateres: 1-63 Carateres válidos: Letras minúsculas, números e hífenes. Não é possível iniciar ou terminar com hífen. O nome do recurso tem de ser exclusivo em todo o Azure. |
| localização | Localização do recurso. | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos. | Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos |
| sku | SKU de instância gerida. 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 gerida. | ResourceIdentity |
| propriedades | Propriedades do recurso. | ManagedInstanceProperties |
ResourceIdentity
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de identidade. Defina esta opção como "SystemAssigned" para criar e atribuir automaticamente um principal do Azure Active Directory para o recurso. | "Nenhum" "SystemAssigned" "SystemAssigned,UserAssigned" "UserAssigned" |
| userAssignedIdentities | Os IDs de recursos das identidades atribuídas pelo utilizador a utilizar | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Nome | Descrição | Valor |
|---|---|---|
| {customized property} | UserIdentity |
UserIdentity
Este objeto não contém quaisquer propriedades a definir durante a implementação. Todas as propriedades são ReadOnly.
ManagedInstanceProperties
| Nome | Descrição | Valor |
|---|---|---|
| administratorLogin | Nome de utilizador administrador da instância gerida. Só pode ser especificado quando a instância gerida está a ser criada (e é necessária para a criação). | string |
| administratorLoginPassword | A palavra-passe de início de sessão do administrador (necessária para a criação de instância gerida). | string Restrições: Valor sensível. Transmita como um parâmetro seguro. |
| administradores | O administrador do Azure Active Directory da instância. Isto só pode ser utilizado no tempo de criação de instâncias. Se for utilizada para a atualização de instâncias, esta será ignorada ou resultará num erro. Para atualizações, as APIs individuais terão de ser utilizadas. | ManagedInstanceExternalAdministrator |
| authenticationMetadata | O modo de pesquisa de metadados de autenticação da instância gerida. | "AzureAD" "Emparelhado" 'Windows' |
| agrupamento | Agrupamento da instância gerida. | string |
| databaseFormat | Especifica o formato interno das bases de dados de instância específicas da versão do motor SQL. | "AlwaysUpToDate" "SQLServer2022" |
| dnsZonePartner | O ID de recurso de outra instância gerida cuja zona DNS esta instância gerida irá partilhar após a criação. | string |
| hybridSecondaryUsage | Utilização secundária híbrida. Os valores possíveis são "Ativo" (valor predefinido) e "Passivo" (o cliente utiliza a secundária como DR Passiva). | "Ativo" "Passivo" |
| instancePoolId | O ID do conjunto de instâncias a que este servidor gerido pertence. | string |
| isGeneralPurposeV2 | Quer esta seja ou não uma variante GPv2 da edição Fins Gerais. | bool |
| keyId | Um URI CMK da chave a utilizar para encriptação. | string |
| licenseType | O tipo de licença. Os valores possíveis são "LicenseIncluded" (preço normal, incluindo uma nova licença SQL) e "Preço Base" (preço AHB com desconto para trazer as suas próprias licenças SQL). | "Preço Base" "LicenseIncluded" |
| maintenanceConfigurationId | Especifica o ID de configuração de manutenção a aplicar a esta instância gerida. | string |
| managedInstanceCreateMode | Especifica o modo de criação da base de dados. Predefinição: criação de instâncias regulares. Restauro: cria uma instância ao restaurar um conjunto de cópias de segurança para um ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId têm de ser especificados. |
'Predefinição' "PointInTimeRestore" |
| minimalTlsVersion | Versão mínima do TLS. Valores permitidos: "None", "1.0", "1.1", "1.2" | string |
| pricingModel | A Meteorologia ou não a Instância Gerida é freemium. | 'Freemium' 'Regular' |
| primaryUserAssignedIdentityId | O ID de recurso de uma identidade atribuída pelo utilizador a utilizar por predefinição. | string |
| proxyOverride | Tipo de ligação utilizado para ligar à instância. | 'Predefinição' 'Proxy' "Redirecionamento" |
| publicDataEndpointEnabled | Se o ponto final de dados públicos está ou não ativado. | bool |
| requestedBackupStorageRedundancy | O tipo de conta de armazenamento a ser utilizado para armazenar cópias de segurança para esta instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage) | 'Geo' "Zona Geográfica" "Local" "Zona" |
| restorePointInTime | Especifica o ponto anterior no tempo (ISO8601 formato) da base de dados de origem que será restaurada para criar a nova base de dados. | string |
| servicePrincipal | O principal de serviço da instância gerida. | ServicePrincipal |
| sourceManagedInstanceId | O identificador de recurso da instância gerida de origem associada à operação de criação desta 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 | Débito 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 de recurso da sub-rede para a instância gerida. | string |
| timezoneId | ID do fuso horário. Os valores permitidos são fusos horários suportados pelo Windows. O Windows mantém detalhes sobre os fusos horários suportados, incluindo o ID, no registo em KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Pode obter esses valores de registo através de SQL Server consultando SELECT name AS timezone_id FROM sys.time_zone_info. A lista de IDs também pode ser obtida ao executar [System.TimeZoneInfo]::GetSystemTimeZones() no PowerShell. Um exemplo de id de fuso horário válido é "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á ou não ativado. | bool |
ManagedInstanceExternalAdministrator
| Nome | Descrição | Valor |
|---|---|---|
| administratorType | Tipo de administrador de gravidade. | "ActiveDirectory" |
| azureADOnlyAuthentication | Apenas a Autenticação do Azure Active Directory está ativada. | bool |
| início de sessão | Nome de início de sessão do administrador do servidor. | string |
| principalType | Tipo principal do administrador de gravidade. | "Aplicação" "Grupo" "Utilizador" |
| 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 inquilino 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 principal de serviço. | "Nenhum" "SystemAssigned" |
Sku
| Nome | Descrição | Valor |
|---|---|---|
| capacidade | Capacidade do SKU específico. | int |
| família | Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui. | string |
| name | O nome do SKU, normalmente, uma letra + Código de número, por exemplo, P3. | cadeia (obrigatório) |
| size | Tamanho do SKU específico | string |
| tier | O escalão ou edição do SKU específico, por exemplo, Básico, Premium. | string |
Modelos de início rápido
Os seguintes modelos de início rápido implementam este tipo de recurso.
| Modelo | Description |
|---|---|
| Implementar SQL Managed Instance com Redes |
Implementar o UDR e o NSG para suportar Azure SQL Managed Instance e implementar a Instância Gerida |
| Criar o SQL MI dentro da nova rede virtual |
Implemente o Azure Sql Database Managed Instance (SQL MI) dentro de novas Rede Virtual. |
| Criar o SQL MI com o envio configurado de registos e métricas |
Este modelo permite-lhe implementar o SQL MI e recursos adicionais utilizados para armazenar registos e métricas (área de trabalho de diagnóstico, conta de armazenamento, hub de eventos). |
| Criar o SQL MI com a jumpbox dentro de uma nova rede virtual |
Implemente o Azure Sql Database Managed Instance (SQL MI) e o JumpBox com o SSMS dentro de novas Rede Virtual. |
| Criar o SQL MI com a ligação ponto a site configurada |
Implemente o Azure Sql Database Managed Instance (SQL MI) e o Gateway de rede virtual configurados para ligação ponto a site dentro da nova rede virtual. |
Definição de recurso do Terraform (fornecedor AzAPI)
O tipo de recurso managedInstances pode ser implementado com operações que visam:
- Grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, veja registo 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@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 (obrigatório) Limite de carateres: 1-63 Carateres válidos: Letras minúsculas, números e hífenes. Não é possível iniciar ou terminar com hífen. O nome do recurso tem de ser exclusivo em todo o Azure. |
| localização | Localização do recurso. | cadeia (obrigatório) |
| parent_id | Para implementar num grupo de recursos, utilize o ID desse grupo de recursos. | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos. | Dicionário de nomes e valores de etiquetas. |
| sku | SKU de instância gerida. 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 gerida. | ResourceIdentity |
| propriedades | Propriedades do recurso. | ManagedInstanceProperties |
ResourceIdentity
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de identidade. Defina esta opção como "SystemAssigned" para criar e atribuir automaticamente um principal do Azure Active Directory para o recurso. | "SystemAssigned" "SystemAssigned,UserAssigned" "UserAssigned" |
| identity_ids | Os IDs de recursos das identidades atribuídas pelo utilizador a utilizar | Matriz de IDs de identidade de utilizador. |
ResourceIdentityUserAssignedIdentities
| Nome | Descrição | Valor |
|---|---|---|
| {customized property} | UserIdentity |
UserIdentity
Este objeto não contém quaisquer propriedades a definir durante a implementação. Todas as propriedades são ReadOnly.
ManagedInstanceProperties
| Nome | Descrição | Valor |
|---|---|---|
| administratorLogin | Nome de utilizador administrador da instância gerida. Só pode ser especificado quando a instância gerida está a ser criada (e é necessária para a criação). | string |
| administratorLoginPassword | A palavra-passe de início de sessão do administrador (necessária para a criação de instância gerida). | string Restrições: Valor sensível. Transmita como um parâmetro seguro. |
| administradores | O administrador do Azure Active Directory da instância. Isto só pode ser utilizado no tempo de criação de instâncias. Se for utilizada para a atualização de instâncias, esta será ignorada ou resultará num erro. Para atualizações, as APIs individuais terão de ser utilizadas. | ManagedInstanceExternalAdministrator |
| authenticationMetadata | O modo de pesquisa de metadados de autenticação da instância gerida. | "AzureAD" "Emparelhado" "Windows" |
| agrupamento | Agrupamento da instância gerida. | string |
| databaseFormat | Especifica o formato interno das bases de dados de instância específicas da versão do motor SQL. | "AlwaysUpToDate" "SQLServer2022" |
| dnsZonePartner | O ID de recurso de outra instância gerida cuja zona DNS esta instância gerida irá partilhar após a criação. | string |
| hybridSecondaryUsage | Utilização secundária híbrida. Os valores possíveis são "Ativo" (valor predefinido) e "Passivo" (o cliente utiliza o secundário como DR Passivo). | "Ativo" "Passivo" |
| instancePoolId | O ID do conjunto de instâncias a que este servidor gerido pertence. | string |
| isGeneralPurposeV2 | Quer se trate ou não de uma variante GPv2 de Fins Gerais edição. | bool |
| keyId | Um URI de CMK da chave a utilizar para encriptação. | string |
| licenseType | O tipo de licença. Os valores possíveis são "LicenseIncluded" (preço normal, incluindo uma nova licença SQL) e "Preço Base" (preço AHB com desconto para trazer as suas próprias licenças SQL). | "Preço Base" "LicenseIncluded" |
| maintenanceConfigurationId | Especifica o ID de configuração de manutenção a aplicar a esta instância gerida. | string |
| managedInstanceCreateMode | Especifica o modo de criação da base de dados. Predefinição: criação de instâncias regulares. Restauro: cria uma instância ao restaurar um conjunto de cópias de segurança para um ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId têm de ser especificados. |
"Predefinição" "PointInTimeRestore" |
| minimalTlsVersion | Versão mínima do TLS. Valores permitidos: "None", "1.0", "1.1", "1.2" | string |
| pricingModel | A Meteorologia ou não a Instância Gerida é freemium. | "Freemium" "Regular" |
| primaryUserAssignedIdentityId | O ID de recurso de uma identidade atribuída pelo utilizador a utilizar por predefinição. | string |
| proxyOverride | Tipo de ligação utilizado para ligar à instância. | "Predefinição" "Proxy" "Redirecionamento" |
| publicDataEndpointEnabled | Se o ponto final de dados públicos está ou não ativado. | bool |
| requestedBackupStorageRedundancy | O tipo de conta de armazenamento a ser utilizado para armazenar cópias de segurança para esta instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage) | "Geo" "Zona Geográfica" "Local" "Zona" |
| restorePointInTime | Especifica o ponto anterior no tempo (ISO8601 formato) da base de dados de origem que será restaurada para criar a nova base de dados. | string |
| servicePrincipal | O principal de serviço da instância gerida. | ServicePrincipal |
| sourceManagedInstanceId | O identificador de recurso da instância gerida de origem associada à operação de criação desta 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 | Débito 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 de recurso da sub-rede para a instância gerida. | string |
| timezoneId | ID do fuso horário. Os valores permitidos são fusos horários suportados pelo Windows. O Windows mantém detalhes sobre os fusos horários suportados, incluindo o ID, no registo em KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Pode obter esses valores de registo através de SQL Server consultando SELECT name AS timezone_id FROM sys.time_zone_info. A lista de IDs também pode ser obtida ao executar [System.TimeZoneInfo]::GetSystemTimeZones() no PowerShell. Um exemplo de id de fuso horário válido é "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á ou não ativado. | bool |
ManagedInstanceExternalAdministrator
| Nome | Descrição | Valor |
|---|---|---|
| administratorType | Tipo de administrador de gravidade. | "ActiveDirectory" |
| azureADOnlyAuthentication | Apenas a Autenticação do Azure Active Directory está ativada. | bool |
| início de sessão | Nome de início de sessão do administrador do servidor. | string |
| principalType | Tipo de Principal do administrador de gravidade. | "Aplicação" "Grupo" "Utilizador" |
| 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 inquilino 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 principal de serviço. | "Nenhum" "SystemAssigned" |
Sku
| Nome | Descrição | Valor |
|---|---|---|
| capacidade | Capacidade do SKU específico. | int |
| família | Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui. | string |
| name | O nome do SKU, normalmente, uma letra + Código de número, por exemplo, P3. | cadeia (obrigatório) |
| size | Tamanho do SKU específico | string |
| tier | O escalão ou edição do SKU específico, por exemplo, Básico, Premium. | string |