Managed Instances - Create Or Update
Cria ou atualiza uma instância gerenciada.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}?api-version=2025-01-01
Parâmetros do URI
| Name | Em | Necessário | Tipo | Description |
|---|---|---|---|---|
|
managed
|
path | True |
string |
O nome da instância gerenciada. |
|
resource
|
path | True |
string |
O nome do grupo de recursos que contém o recurso. Você pode obter esse valor da API do Azure Resource Manager ou do portal. |
|
subscription
|
path | True |
string |
A ID de assinatura que identifica uma assinatura do Azure. |
|
api-version
|
query | True |
string |
A versão da API a ser usada para a solicitação. |
Corpo do Pedido
| Name | Necessário | Tipo | Description |
|---|---|---|---|
| location | True |
string |
Localização do recurso. |
| identity |
A identidade do Azure Ative Directory da instância gerenciada. |
||
| properties.administratorLogin |
string |
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). |
|
| properties.administratorLoginPassword |
string |
A senha de login do administrador (necessária para a criação da instância gerenciada). |
|
| properties.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. |
||
| properties.authenticationMetadata |
Modo de pesquisa de metadados de autenticação da instância gerenciada. |
||
| properties.collation |
string |
Agrupamento da instância gerenciada. |
|
| properties.databaseFormat |
Especifica o formato interno dos bancos de dados de instância específicos para a versão do mecanismo SQL. |
||
| properties.dnsZonePartner |
string (arm-id) |
A ID de recurso de outra instância gerenciada cuja zona DNS essa instância gerenciada compartilhará após a criação. |
|
| properties.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). |
||
| properties.instancePoolId |
string |
A Id do pool de instâncias ao qual esse servidor gerenciado pertence. |
|
| properties.isGeneralPurposeV2 |
boolean |
Se esta é ou não uma variante GPv2 da edição de uso geral. |
|
| properties.keyId |
string |
Um URI CMK da chave a ser usada para criptografia. |
|
| properties.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). |
||
| properties.maintenanceConfigurationId |
string |
Especifica a ID de configuração de manutenção a ser aplicada a essa instância gerenciada. |
|
| properties.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. |
||
| properties.memorySizeInGB |
integer (int32) |
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. |
|
| properties.minimalTlsVersion |
string |
Versão TLS mínima. Valores permitidos: 'Nenhum', '1.0', '1.1', '1.2' |
|
| properties.pricingModel |
Modelo de precificação da Instância Gerenciada. |
||
| properties.primaryUserAssignedIdentityId |
string (arm-id) |
A id de recurso de uma identidade atribuída ao usuário a ser usada por padrão. |
|
| properties.proxyOverride |
Tipo de conexão usado para se conectar à instância. |
||
| properties.publicDataEndpointEnabled |
boolean |
Se o ponto de extremidade de dados públicos está habilitado ou não. |
|
| properties.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) |
||
| properties.requestedLogicalAvailabilityZone |
Especifica a zona de disponibilidade lógica à qual a Instância Gerenciada está fixada. |
||
| properties.restorePointInTime |
string (date-time) |
Especifica o ponto no tempo (formato ISO8601) do banco de dados de origem que será restaurado para criar o novo banco de dados. |
|
| properties.servicePrincipal |
A entidade de serviço da instância gerenciada. |
||
| properties.sourceManagedInstanceId |
string (arm-id) |
O identificador de recurso da instância gerenciada de origem associada à operação de criação dessa instância. |
|
| properties.storageIOps |
integer (int32) |
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. |
|
| properties.storageSizeInGB |
integer (int32) |
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. |
|
| properties.storageThroughputMBps |
integer (int32) |
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. |
|
| properties.subnetId |
string (arm-id) |
ID do recurso de sub-rede para a instância gerenciada. |
|
| properties.timezoneId |
string |
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 a id, no registro em KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. 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". |
|
| properties.vCores |
integer (int32) |
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. |
|
| properties.zoneRedundant |
boolean |
Se a redundância de zona está habilitada ou nã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). |
||
| tags |
object |
Tags de recursos. |
Respostas
| Name | Tipo | Description |
|---|---|---|
| 200 OK |
Atualizada com êxito a instância gerenciada. |
|
| 201 Created |
Criada com êxito a instância gerenciada. |
|
| 202 Accepted |
Aceito Cabeçalhos Location: string |
|
| Other Status Codes |
Respostas de erro: ***
|
Exemplos
| Create managed instance with all properties |
| Create managed instance with minimal properties |
Create managed instance with all properties
Pedido de amostra
PUT https://management.azure.com/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2025-01-01
{
"tags": {
"tagKey1": "TagValue1"
},
"location": "Japan East",
"sku": {
"name": "GP_Gen5",
"tier": "GeneralPurpose"
},
"properties": {
"administratorLogin": "dummylogin",
"administratorLoginPassword": "PLACEHOLDER",
"subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
"vCores": 8,
"storageSizeInGB": 1024,
"licenseType": "LicenseIncluded",
"collation": "SQL_Latin1_General_CP1_CI_AS",
"dnsZonePartner": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
"publicDataEndpointEnabled": false,
"proxyOverride": "Redirect",
"minimalTlsVersion": "1.2",
"timezoneId": "UTC",
"instancePoolId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1",
"maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
"requestedBackupStorageRedundancy": "Geo",
"administrators": {
"principalType": "User",
"login": "bob@contoso.com",
"sid": "00000011-1111-2222-2222-123456789111",
"tenantId": "00000011-1111-2222-2222-123456789111",
"azureADOnlyAuthentication": true
},
"hybridSecondaryUsage": "Passive",
"servicePrincipal": {
"type": "SystemAssigned"
},
"databaseFormat": "AlwaysUpToDate",
"requestedLogicalAvailabilityZone": "1",
"authenticationMetadata": "AzureAD"
}
}
Resposta da amostra
{
"sku": {
"name": "GP_Gen5",
"tier": "GeneralPurpose",
"capacity": 8,
"family": "Gen5"
},
"properties": {
"fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
"administratorLogin": "dummylogin",
"subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
"state": "Ready",
"provisioningState": "Creating",
"vCores": 8,
"storageSizeInGB": 1024,
"licenseType": "LicenseIncluded",
"collation": "SQL_Latin1_General_CP1_CI_AS",
"publicDataEndpointEnabled": false,
"proxyOverride": "Redirect",
"minimalTlsVersion": "1.2",
"dnsZone": "1b4e2caff2530",
"timezoneId": "UTC",
"instancePoolId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1",
"maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
"currentBackupStorageRedundancy": "Geo",
"requestedBackupStorageRedundancy": "Geo",
"administrators": {
"principalType": "User",
"login": "bob@contoso.com",
"sid": "00000011-1111-2222-2222-123456789111",
"tenantId": "00000011-1111-2222-2222-123456789111",
"azureADOnlyAuthentication": true
},
"servicePrincipal": {
"principalId": "00000011-1111-2222-2222-123456789111",
"clientId": "00000011-1111-2222-2222-123456789111",
"tenantId": "00000011-1111-2222-2222-123456789111",
"type": "SystemAssigned"
},
"externalGovernanceStatus": "Enabled",
"hybridSecondaryUsage": "Passive",
"databaseFormat": "AlwaysUpToDate",
"requestedLogicalAvailabilityZone": "1",
"authenticationMetadata": "AzureAD"
},
"location": "japaneast",
"tags": {
"tagKey1": "TagValue1"
},
"id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
"name": "testinstance",
"type": "Microsoft.Sql/managedInstances"
}
{
"sku": {
"name": "GP_Gen5",
"tier": "GeneralPurpose",
"capacity": 8,
"family": "Gen5"
},
"properties": {
"fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
"administratorLogin": "dummylogin",
"subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
"state": "Ready",
"provisioningState": "Creating",
"vCores": 8,
"storageSizeInGB": 1024,
"licenseType": "LicenseIncluded",
"collation": "SQL_Latin1_General_CP1_CI_AS",
"publicDataEndpointEnabled": false,
"proxyOverride": "Redirect",
"minimalTlsVersion": "1.2",
"dnsZone": "1b4e2caff2530",
"timezoneId": "UTC",
"instancePoolId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1",
"maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
"currentBackupStorageRedundancy": "Geo",
"requestedBackupStorageRedundancy": "Geo",
"administrators": {
"principalType": "User",
"login": "bob@contoso.com",
"sid": "00000011-1111-2222-2222-123456789111",
"tenantId": "00000011-1111-2222-2222-123456789111",
"azureADOnlyAuthentication": true
},
"servicePrincipal": {
"principalId": "00000011-1111-2222-2222-123456789111",
"clientId": "00000011-1111-2222-2222-123456789111",
"tenantId": "00000011-1111-2222-2222-123456789111",
"type": "SystemAssigned"
},
"hybridSecondaryUsage": "Passive",
"databaseFormat": "AlwaysUpToDate",
"requestedLogicalAvailabilityZone": "1",
"authenticationMetadata": "AzureAD"
},
"location": "japaneast",
"tags": {
"tagKey1": "TagValue1"
},
"id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
"name": "testinstance",
"type": "Microsoft.Sql/managedInstances"
}
Create managed instance with minimal properties
Pedido de amostra
PUT https://management.azure.com/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2025-01-01
{
"sku": {
"name": "GP_Gen5",
"tier": "GeneralPurpose"
},
"properties": {
"administratorLogin": "dummylogin",
"administratorLoginPassword": "PLACEHOLDER",
"subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
"vCores": 8,
"storageSizeInGB": 1024,
"licenseType": "LicenseIncluded"
},
"location": "Japan East"
}
Resposta da amostra
{
"sku": {
"name": "GP_Gen5",
"tier": "GeneralPurpose",
"capacity": 8,
"family": "Gen4"
},
"properties": {
"fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
"administratorLogin": "dummylogin",
"subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
"state": "Ready",
"provisioningState": "Creating",
"vCores": 8,
"storageSizeInGB": 1024,
"licenseType": "LicenseIncluded",
"collation": "SQL_Latin1_General_CP1_CI_AS",
"publicDataEndpointEnabled": false,
"proxyOverride": "Redirect",
"dnsZone": "1b4e2caff2530",
"currentBackupStorageRedundancy": "Geo",
"requestedBackupStorageRedundancy": "Geo",
"externalGovernanceStatus": "Enabled",
"hybridSecondaryUsage": "Passive",
"databaseFormat": "SQLServer2022"
},
"location": "japaneast",
"tags": {},
"id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
"name": "testinstance",
"type": "Microsoft.Sql/managedInstances"
}
{
"sku": {
"name": "GP_Gen5",
"tier": "GeneralPurpose",
"capacity": 8,
"family": "Gen4"
},
"properties": {
"fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
"administratorLogin": "dummylogin",
"subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
"state": "Ready",
"provisioningState": "Creating",
"vCores": 8,
"storageSizeInGB": 1024,
"licenseType": "LicenseIncluded",
"collation": "SQL_Latin1_General_CP1_CI_AS",
"publicDataEndpointEnabled": false,
"proxyOverride": "Redirect",
"dnsZone": "1b4e2caff2530",
"currentBackupStorageRedundancy": "Geo",
"requestedBackupStorageRedundancy": "Geo",
"externalGovernanceStatus": "Enabled",
"hybridSecondaryUsage": "Passive",
"databaseFormat": "SQLServer2022"
},
"location": "japaneast",
"tags": {},
"id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
"name": "testinstance",
"type": "Microsoft.Sql/managedInstances"
}
Definições
| Name | Description |
|---|---|
|
Administrator |
Tipo de administrador de corte. |
|
Auth |
Modo de pesquisa de metadados de autenticação da instância gerenciada. |
|
Availability |
Especifica a zona de disponibilidade lógica à qual a Instância Gerenciada está fixada. |
|
Backup |
O tipo de conta de armazenamento usado para armazenar backups para esta instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage) |
|
Error |
O erro de gerenciamento de recursos informações adicionais. |
|
Error |
O detalhe do erro. |
|
Error |
Resposta de erro |
|
External |
Estatuto da governação externa. |
|
Hybrid |
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). |
|
Hybrid |
Uso secundário híbrido detetado. Os valores possíveis são 'Ativo' (o cliente não atende aos requisitos para usar o secundário como DR passivo) e 'Passivo' (o cliente atende aos requisitos para usar o secundário como DR passivo). |
|
Identity |
O tipo de identidade. Defina isso como 'SystemAssigned' para criar e atribuir automaticamente uma entidade do Azure Ative Directory para o recurso. |
|
Managed |
Uma instância gerenciada SQL do Azure. |
|
Managed |
Especifica o formato interno dos bancos de dados de instância específicos para a versão do mecanismo SQL. |
|
Managed |
Propriedades de um administrador do Ative Directory. |
|
Managed |
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). |
|
Managed |
Uma conexão de ponto de extremidade privada em uma instância gerenciada |
|
Managed |
Propriedades de uma conexão de ponto de extremidade privada. |
|
Managed |
|
|
Managed |
|
|
Managed |
Tipo de conexão usado para se conectar à instância. |
|
Managed |
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. |
|
Pricing |
Modelo de precificação da Instância Gerenciada. |
|
Principal |
Tipo principal do administrador de corte. |
|
Provisioning |
Estado de provisionamento da instância gerenciada. |
|
Resource |
Configuração de identidade do Azure Ative Directory para um recurso. |
|
Service |
A configuração da entidade de serviço da instância gerenciada para um recurso. |
|
Service |
Tipo de entidade de serviço. |
| Sku |
Um SKU de recurso ARM. |
|
User |
Configuração de identidade do Azure Ative Directory para um recurso. |
AdministratorType
Tipo de administrador de corte.
| Valor | Description |
|---|---|
| ActiveDirectory |
AuthMetadataLookupModes
Modo de pesquisa de metadados de autenticação da instância gerenciada.
| Valor | Description |
|---|---|
| AzureAD | |
| Paired | |
| Windows |
AvailabilityZoneType
Especifica a zona de disponibilidade lógica à qual a Instância Gerenciada está fixada.
| Valor | Description |
|---|---|
| NoPreference | |
| 1 | |
| 2 | |
| 3 |
BackupStorageRedundancy
O tipo de conta de armazenamento usado para armazenar backups para esta instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)
| Valor | Description |
|---|---|
| Geo | |
| Local | |
| Zone | |
| GeoZone |
ErrorAdditionalInfo
O erro de gerenciamento de recursos informações adicionais.
| Name | Tipo | Description |
|---|---|---|
| info |
object |
As informações adicionais. |
| type |
string |
O tipo de informação adicional. |
ErrorDetail
O detalhe do erro.
| Name | Tipo | Description |
|---|---|---|
| additionalInfo |
O erro informações adicionais. |
|
| code |
string |
O código de erro. |
| details |
Os detalhes do erro. |
|
| message |
string |
A mensagem de erro. |
| target |
string |
O alvo do erro. |
ErrorResponse
Resposta de erro
| Name | Tipo | Description |
|---|---|---|
| error |
O objeto de erro. |
ExternalGovernanceStatus
Estatuto da governação externa.
| Valor | Description |
|---|---|
| Enabled | |
| Disabled |
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).
| Valor | Description |
|---|---|
| Active | |
| Passive |
HybridSecondaryUsageDetected
Uso secundário híbrido detetado. Os valores possíveis são 'Ativo' (o cliente não atende aos requisitos para usar o secundário como DR passivo) e 'Passivo' (o cliente atende aos requisitos para usar o secundário como DR passivo).
| Valor | Description |
|---|---|
| Active | |
| Passive |
IdentityType
O tipo de identidade. Defina isso como 'SystemAssigned' para criar e atribuir automaticamente uma entidade do Azure Ative Directory para o recurso.
| Valor | Description |
|---|---|
| None | |
| SystemAssigned | |
| UserAssigned | |
| SystemAssigned,UserAssigned |
ManagedInstance
Uma instância gerenciada SQL do Azure.
| Name | Tipo | Description |
|---|---|---|
| id |
string |
ID do recurso. |
| identity |
A identidade do Azure Ative Directory da instância gerenciada. |
|
| location |
string |
Localização do recurso. |
| name |
string |
Nome do recurso. |
| properties.administratorLogin |
string |
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). |
| properties.administratorLoginPassword |
string |
A senha de login do administrador (necessária para a criação da instância gerenciada). |
| properties.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. |
|
| properties.authenticationMetadata |
Modo de pesquisa de metadados de autenticação da instância gerenciada. |
|
| properties.collation |
string |
Agrupamento da instância gerenciada. |
| properties.createTime |
string (date-time) |
Especifica o point-in-time (formato ISO8601) da criação da Instância Gerenciada. |
| properties.currentBackupStorageRedundancy |
O tipo de conta de armazenamento usado para armazenar backups para esta instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage) |
|
| properties.databaseFormat |
Especifica o formato interno dos bancos de dados de instância específicos para a versão do mecanismo SQL. |
|
| properties.dnsZone |
string |
A zona Dns em que a instância gerenciada está. |
| properties.dnsZonePartner |
string (arm-id) |
A ID de recurso de outra instância gerenciada cuja zona DNS essa instância gerenciada compartilhará após a criação. |
| properties.externalGovernanceStatus |
Estatuto da governação externa. |
|
| properties.fullyQualifiedDomainName |
string |
O nome de domínio totalmente qualificado da instância gerenciada. |
| properties.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). |
|
| properties.hybridSecondaryUsageDetected |
Uso secundário híbrido detetado. Os valores possíveis são 'Ativo' (o cliente não atende aos requisitos para usar o secundário como DR passivo) e 'Passivo' (o cliente atende aos requisitos para usar o secundário como DR passivo). |
|
| properties.instancePoolId |
string |
A Id do pool de instâncias ao qual esse servidor gerenciado pertence. |
| properties.isGeneralPurposeV2 |
boolean |
Se esta é ou não uma variante GPv2 da edição de uso geral. |
| properties.keyId |
string |
Um URI CMK da chave a ser usada para criptografia. |
| properties.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). |
|
| properties.maintenanceConfigurationId |
string |
Especifica a ID de configuração de manutenção a ser aplicada a essa instância gerenciada. |
| properties.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. |
|
| properties.memorySizeInGB |
integer (int32) |
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. |
| properties.minimalTlsVersion |
string |
Versão TLS mínima. Valores permitidos: 'Nenhum', '1.0', '1.1', '1.2' |
| properties.pricingModel |
Modelo de precificação da Instância Gerenciada. |
|
| properties.primaryUserAssignedIdentityId |
string (arm-id) |
A id de recurso de uma identidade atribuída ao usuário a ser usada por padrão. |
| properties.privateEndpointConnections |
Lista de conexões de ponto de extremidade privado em uma instância gerenciada. |
|
| properties.provisioningState |
Estado de provisionamento da instância gerenciada. |
|
| properties.proxyOverride |
Tipo de conexão usado para se conectar à instância. |
|
| properties.publicDataEndpointEnabled |
boolean |
Se o ponto de extremidade de dados públicos está habilitado ou não. |
| properties.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) |
|
| properties.requestedLogicalAvailabilityZone |
Especifica a zona de disponibilidade lógica à qual a Instância Gerenciada está fixada. |
|
| properties.restorePointInTime |
string (date-time) |
Especifica o ponto no tempo (formato ISO8601) do banco de dados de origem que será restaurado para criar o novo banco de dados. |
| properties.servicePrincipal |
A entidade de serviço da instância gerenciada. |
|
| properties.sourceManagedInstanceId |
string (arm-id) |
O identificador de recurso da instância gerenciada de origem associada à operação de criação dessa instância. |
| properties.state |
string |
O estado da instância gerenciada. |
| properties.storageIOps |
integer (int32) |
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. |
| properties.storageSizeInGB |
integer (int32) |
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. |
| properties.storageThroughputMBps |
integer (int32) |
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. |
| properties.subnetId |
string (arm-id) |
ID do recurso de sub-rede para a instância gerenciada. |
| properties.timezoneId |
string |
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 a id, no registro em KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. 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". |
| properties.vCores |
integer (int32) |
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. |
| properties.virtualClusterId |
string |
ID de recurso de cluster virtual para a instância gerenciada. |
| properties.zoneRedundant |
boolean |
Se a redundância de zona está habilitada ou nã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). |
|
| tags |
object |
Tags de recursos. |
| type |
string |
Tipo de recurso. |
ManagedInstanceDatabaseFormat
Especifica o formato interno dos bancos de dados de instância específicos para a versão do mecanismo SQL.
| Valor | Description |
|---|---|
| AlwaysUpToDate | |
| SQLServer2022 | |
| SQLServer2025 |
ManagedInstanceExternalAdministrator
Propriedades de um administrador do Ative Directory.
| Name | Tipo | Description |
|---|---|---|
| administratorType |
Tipo de administrador de corte. |
|
| azureADOnlyAuthentication |
boolean |
Somente Autenticação do Ative Directory do Azure habilitada. |
| login |
string |
Nome de login do administrador do servidor. |
| principalType |
Tipo principal do administrador de corte. |
|
| sid |
string (uuid) |
SID (ID do objeto) do administrador do servidor. |
| tenantId |
string (uuid) |
ID do locatário do administrador. |
ManagedInstanceLicenseType
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).
| Valor | Description |
|---|---|
| LicenseIncluded | |
| BasePrice |
ManagedInstancePecProperty
Uma conexão de ponto de extremidade privada em uma instância gerenciada
| Name | Tipo | Description |
|---|---|---|
| id |
string |
ID do recurso. |
| properties |
Propriedades de conexão de ponto de extremidade privado |
ManagedInstancePrivateEndpointConnectionProperties
Propriedades de uma conexão de ponto de extremidade privada.
| Name | Tipo | Description |
|---|---|---|
| privateEndpoint |
Ponto de extremidade privado ao qual a conexão pertence. |
|
| privateLinkServiceConnectionState |
Estado da Conexão da Conexão de Ponto Final Privado. |
|
| provisioningState |
string |
Estado da Conexão de Ponto Final Privado. |
ManagedInstancePrivateEndpointProperty
| Name | Tipo | Description |
|---|---|---|
| id |
string |
ID do recurso do ponto de extremidade privado. |
ManagedInstancePrivateLinkServiceConnectionStateProperty
| Name | Tipo | Description |
|---|---|---|
| actionsRequired |
string |
A descrição da conexão do serviço de link privado. |
| description |
string |
A descrição da conexão do serviço de link privado. |
| status |
string |
O status da conexão do serviço de link privado. |
ManagedInstanceProxyOverride
Tipo de conexão usado para se conectar à instância.
| Valor | Description |
|---|---|
| Proxy | |
| Redirect | |
| Default |
ManagedServerCreateMode
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.
| Valor | Description |
|---|---|
| Default | |
| PointInTimeRestore |
PricingModel
Modelo de precificação da Instância Gerenciada.
| Valor | Description |
|---|---|
| Regular | |
| Freemium |
PrincipalType
Tipo principal do administrador de corte.
| Valor | Description |
|---|---|
| User | |
| Group | |
| Application |
ProvisioningState
Estado de provisionamento da instância gerenciada.
| Valor | Description |
|---|---|
| Created | |
| InProgress | |
| Succeeded | |
| Failed | |
| Canceled |
ResourceIdentity
Configuração de identidade do Azure Ative Directory para um recurso.
| Name | Tipo | Description |
|---|---|---|
| principalId |
string (uuid) |
A ID principal do Azure Ative Directory. |
| tenantId |
string (uuid) |
A ID de locatário do Azure Ative Directory. |
| type |
O tipo de identidade. Defina isso como 'SystemAssigned' para criar e atribuir automaticamente uma entidade do Azure Ative Directory para o recurso. |
|
| userAssignedIdentities |
<string,
User |
As ids de recurso das identidades atribuídas ao usuário a serem usadas |
ServicePrincipal
A configuração da entidade de serviço da instância gerenciada para um recurso.
| Name | Tipo | Description |
|---|---|---|
| clientId |
string |
A ID do cliente do aplicativo Azure Ative Directory. |
| principalId |
string |
A ID do objeto do aplicativo Azure Ative Directory. |
| tenantId |
string |
A ID de locatário do Azure Ative Directory. |
| type |
Tipo de entidade de serviço. |
ServicePrincipalType
Tipo de entidade de serviço.
| Valor | Description |
|---|---|
| None | |
| SystemAssigned |
Sku
Um SKU de recurso ARM.
| Name | Tipo | Description |
|---|---|---|
| capacity |
integer (int32) |
Capacidade do SKU específico. |
| family |
string |
Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui. |
| name |
string |
O nome do SKU, normalmente, uma letra + código numérico, por exemplo, P3. |
| size |
string |
Tamanho do SKU específico |
| tier |
string |
O nível ou edição do SKU específico, por exemplo, Basic, Premium. |
UserIdentity
Configuração de identidade do Azure Ative Directory para um recurso.
| Name | Tipo | Description |
|---|---|---|
| clientId |
string (uuid) |
A ID do cliente do Azure Ative Directory. |
| principalId |
string (uuid) |
A ID principal do Azure Ative Directory. |