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 de URI
| Nome | Em | Obrigató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 na API do Azure Resource Manager ou no portal. |
|
subscription
|
path | True |
string |
A ID da 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 da solicitação
| Nome | Obrigatório | Tipo | Description |
|---|---|---|---|
| location | True |
string |
Local do recurso. |
| identity |
A identidade do Azure Active 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 logon do administrador (necessária para a criação da instância gerenciada). |
|
| properties.administrators |
O administrador do Azure Active Directory pode ser utilizado durante a criação da instância e para atualizações de instância, exceto para a propriedade azureADOnlyAuthentication. Para atualizar a propriedade azureADOnlyAuthentication, a API individual deve ser usada. |
||
| properties.authenticationMetadata |
O modo de pesquisa de metadados de autenticação da instância gerenciada. |
||
| properties.collation |
string |
Ordenação da instância gerenciada. |
|
| properties.databaseFormat |
Especifica o formato interno de 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 à qual este servidor gerenciado pertence. |
|
| properties.isGeneralPurposeV2 |
boolean |
Se esta é ou não uma variante GPv2 da edição Uso Geral. |
|
| properties.keyId |
string |
Um URI do CMK da chave a ser usada para criptografia. |
|
| properties.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). |
||
| 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 de banco de dados. Padrão: criação de instância regular. Restauração: cria uma instância restaurando um conjunto de backups para um ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId devem ser especificados. |
||
| properties.memorySizeInGB |
integer (int32) |
Tamanho da memória em GB. Valor mínimo: 28. Valor máximo: 870. O valor mínimo e máximo depende do número de vCores e da camada de serviço. Leia mais sobre limites de recursos: https://aka.ms/mi-resource-limits-api. |
|
| properties.minimalTlsVersion |
string |
Versão mínima do TLS. Valores permitidos: 'None', '1.0', '1.1', '1.2' |
|
| properties.pricingModel |
Modelo de preços da Instância Gerenciada. |
||
| properties.primaryUserAssignedIdentityId |
string (arm-id) |
A ID de recurso de uma identidade atribuída pelo 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úblico está habilitado ou não. |
|
| properties.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) |
||
| properties.requestedLogicalAvailabilityZone |
Especifica a zona de disponibilidade lógica na 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. Incrementos de 1 IOps somente permitidos. O valor máximo depende da família de hardware selecionada e do número de vCores. |
|
| properties.storageSizeInGB |
integer (int32) |
Tamanho do armazenamento em GB. Valor mínimo: 32. Valor máximo: 32768. Incrementos de 32 GB somente permitidos. O valor máximo depende da família de hardware selecionada e do número de vCores. |
|
| properties.storageThroughputMBps |
integer (int32) |
Não há suporte para o parâmetro MBps de taxa de transferência de armazenamento na operação de criação/atualização da instância. |
|
| properties.subnetId |
string (arm-id) |
ID de 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 compatíveis com o Windows. O Windows mantém detalhes sobre fusos horários com suporte, incluindo a ID, no Registro em KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fusos Horários. Você pode obter esses valores do Registro por meio do SQL Server consultando o nome SELECT AS timezone_id FROM sys.time_zone_info. A lista de IDs também pode ser obtida executando [System.TimeZoneInfo]::GetSystemTimeZones() no PowerShell. Um exemplo de ID de fuso horário válida é "Horário Padrão do Pacífico" ou "W. Horário Padrão da Europa". |
|
| 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 com suporte 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 da instância gerenciada. Valores permitidos para sku.name: GP_Gen5 (Uso Geral, Série Padrão); GP_G8IM (Uso Geral, Série Premium); GP_G8IH (uso geral, memória da série Premium otimizada); BC_Gen5 (Crítico para os Negócios, Standard-Series); BC_G8IM (Business Critical, série Premium); BC_G8IH (Business Critical, otimizado para memória da série Premium). |
||
| tags |
object |
Tags de recursos. |
Respostas
| Nome | Tipo | Description |
|---|---|---|
| 200 OK |
Atualizou com êxito a instância gerenciada. |
|
| 201 Created |
A instância gerenciada foi criada com êxito. |
|
| 202 Accepted |
Aceitado 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
Solicitação de exemplo
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 de exemplo
{
"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
Solicitação de exemplo
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 de exemplo
{
"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
| Nome | Description |
|---|---|
|
Administrator |
Tipo do administrador de sever. |
|
Auth |
O modo de pesquisa de metadados de autenticação da instância gerenciada. |
|
Availability |
Especifica a zona de disponibilidade lógica na qual a Instância Gerenciada está fixada. |
|
Backup |
O tipo de conta de armazenamento usado para armazenar backups para essa instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage) |
|
Error |
As informações adicionais do erro de gerenciamento de recursos. |
|
Error |
O detalhe do erro. |
|
Error |
Resposta de erro |
|
External |
Status da governança 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 detectado. 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 de segurança do Azure Active Directory para o recurso. |
|
Managed |
Uma instância gerenciada de SQL do Azure. |
|
Managed |
Especifica o formato interno de bancos de dados de instância específicos para a versão do mecanismo SQL. |
|
Managed |
Propriedades de um administrador do active directory. |
|
Managed |
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). |
|
Managed |
Uma conexão de ponto de extremidade privado em uma instância gerenciada |
|
Managed |
Propriedades de uma conexão de ponto de extremidade privado. |
|
Managed |
|
|
Managed |
|
|
Managed |
Tipo de conexão usado para se conectar à instância. |
|
Managed |
Especifica o modo de criação de banco de dados. Padrão: criação de instância regular. Restauração: cria uma instância restaurando um conjunto de backups para um ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId devem ser especificados. |
|
Pricing |
Modelo de preços da Instância Gerenciada. |
|
Principal |
Tipo de entidade de segurança do administrador de sever. |
|
Provisioning |
Estado de provisionamento da instância gerenciada. |
|
Resource |
Configuração de identidade do Azure Active 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 do ARM. |
|
User |
Configuração de identidade do Azure Active Directory para um recurso. |
AdministratorType
Tipo do administrador de sever.
| Valor | Description |
|---|---|
| ActiveDirectory |
AuthMetadataLookupModes
O 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 na 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 essa instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)
| Valor | Description |
|---|---|
| Geo | |
| Local | |
| Zone | |
| GeoZone |
ErrorAdditionalInfo
As informações adicionais do erro de gerenciamento de recursos.
| Nome | Tipo | Description |
|---|---|---|
| info |
object |
As informações adicionais. |
| type |
string |
O tipo de informação adicional. |
ErrorDetail
O detalhe do erro.
| Nome | Tipo | Description |
|---|---|---|
| additionalInfo |
As informações adicionais do erro. |
|
| code |
string |
O código de erro. |
| details |
Os detalhes do erro. |
|
| message |
string |
A mensagem de erro. |
| target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
| Nome | Tipo | Description |
|---|---|---|
| error |
O objeto de erro. |
ExternalGovernanceStatus
Status da governança 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 detectado. 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 de segurança do Azure Active Directory para o recurso.
| Valor | Description |
|---|---|
| None | |
| SystemAssigned | |
| UserAssigned | |
| SystemAssigned,UserAssigned |
ManagedInstance
Uma instância gerenciada de SQL do Azure.
| Nome | Tipo | Description |
|---|---|---|
| id |
string |
ID do recurso. |
| identity |
A identidade do Azure Active Directory da instância gerenciada. |
|
| location |
string |
Local 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 logon do administrador (necessária para a criação da instância gerenciada). |
| properties.administrators |
O administrador do Azure Active Directory pode ser utilizado durante a criação da instância e para atualizações de instância, exceto para a propriedade azureADOnlyAuthentication. Para atualizar a propriedade azureADOnlyAuthentication, a API individual deve ser usada. |
|
| properties.authenticationMetadata |
O modo de pesquisa de metadados de autenticação da instância gerenciada. |
|
| properties.collation |
string |
Ordenação da instância gerenciada. |
| properties.createTime |
string (date-time) |
Especifica o ponto no tempo (formato ISO8601) da criação da Instância Gerenciada. |
| properties.currentBackupStorageRedundancy |
O tipo de conta de armazenamento usado para armazenar backups para essa instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage) |
|
| properties.databaseFormat |
Especifica o formato interno de 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 |
Status da governança 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 detectado. 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 à qual este servidor gerenciado pertence. |
| properties.isGeneralPurposeV2 |
boolean |
Se esta é ou não uma variante GPv2 da edição Uso Geral. |
| properties.keyId |
string |
Um URI do CMK da chave a ser usada para criptografia. |
| properties.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). |
|
| 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 de banco de dados. Padrão: criação de instância regular. Restauração: cria uma instância restaurando um conjunto de backups para um ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId devem ser especificados. |
|
| properties.memorySizeInGB |
integer (int32) |
Tamanho da memória em GB. Valor mínimo: 28. Valor máximo: 870. O valor mínimo e máximo depende do número de vCores e da camada de serviço. Leia mais sobre limites de recursos: https://aka.ms/mi-resource-limits-api. |
| properties.minimalTlsVersion |
string |
Versão mínima do TLS. Valores permitidos: 'None', '1.0', '1.1', '1.2' |
| properties.pricingModel |
Modelo de preços da Instância Gerenciada. |
|
| properties.primaryUserAssignedIdentityId |
string (arm-id) |
A ID de recurso de uma identidade atribuída pelo 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úblico está habilitado ou não. |
| properties.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) |
|
| properties.requestedLogicalAvailabilityZone |
Especifica a zona de disponibilidade lógica na 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. Incrementos de 1 IOps somente permitidos. O valor máximo depende da família de hardware selecionada e do número de vCores. |
| properties.storageSizeInGB |
integer (int32) |
Tamanho do armazenamento em GB. Valor mínimo: 32. Valor máximo: 32768. Incrementos de 32 GB somente permitidos. O valor máximo depende da família de hardware selecionada e do número de vCores. |
| properties.storageThroughputMBps |
integer (int32) |
Não há suporte para o parâmetro MBps de taxa de transferência de armazenamento na operação de criação/atualização da instância. |
| properties.subnetId |
string (arm-id) |
ID de 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 compatíveis com o Windows. O Windows mantém detalhes sobre fusos horários com suporte, incluindo a ID, no Registro em KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fusos Horários. Você pode obter esses valores do Registro por meio do SQL Server consultando o nome SELECT AS timezone_id FROM sys.time_zone_info. A lista de IDs também pode ser obtida executando [System.TimeZoneInfo]::GetSystemTimeZones() no PowerShell. Um exemplo de ID de fuso horário válida é "Horário Padrão do Pacífico" ou "W. Horário Padrão da Europa". |
| 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 com suporte 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 da instância gerenciada. Valores permitidos para sku.name: GP_Gen5 (Uso Geral, Série Padrão); GP_G8IM (Uso Geral, Série Premium); GP_G8IH (uso geral, memória da série Premium otimizada); BC_Gen5 (Crítico para os Negócios, Standard-Series); BC_G8IM (Business Critical, série Premium); BC_G8IH (Business Critical, otimizado para memória da série Premium). |
|
| tags |
object |
Tags de recursos. |
| type |
string |
Tipo de recurso. |
ManagedInstanceDatabaseFormat
Especifica o formato interno de 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 active directory.
| Nome | Tipo | Description |
|---|---|---|
| administratorType |
Tipo do administrador de sever. |
|
| azureADOnlyAuthentication |
boolean |
Somente autenticação do Azure Active Directory habilitada. |
| login |
string |
Nome de logon do administrador do servidor. |
| principalType |
Tipo de entidade de segurança do administrador de sever. |
|
| 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 regular inclusive de 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 privado em uma instância gerenciada
| Nome | 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 privado.
| Nome | Tipo | Description |
|---|---|---|
| privateEndpoint |
Ponto de extremidade privado ao qual a conexão pertence. |
|
| privateLinkServiceConnectionState |
Estado de conexão da conexão de ponto de extremidade privado. |
|
| provisioningState |
string |
Estado da conexão de ponto de extremidade privado. |
ManagedInstancePrivateEndpointProperty
| Nome | Tipo | Description |
|---|---|---|
| id |
string |
ID do recurso do ponto de extremidade privado. |
ManagedInstancePrivateLinkServiceConnectionStateProperty
| Nome | 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 de banco de dados.
Padrão: criação de instância regular.
Restauração: cria uma instância restaurando um conjunto de backups para um ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId devem ser especificados.
| Valor | Description |
|---|---|
| Default | |
| PointInTimeRestore |
PricingModel
Modelo de preços da Instância Gerenciada.
| Valor | Description |
|---|---|
| Regular | |
| Freemium |
PrincipalType
Tipo de entidade de segurança do administrador de sever.
| 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 Active Directory para um recurso.
| Nome | Tipo | Description |
|---|---|---|
| principalId |
string (uuid) |
A ID da entidade de segurança do Azure Active Directory. |
| tenantId |
string (uuid) |
A ID do locatário do Azure Active Directory. |
| type |
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. |
|
| userAssignedIdentities |
<string,
User |
As IDs de recurso das identidades atribuídas pelo usuário a serem usadas |
ServicePrincipal
A configuração da entidade de serviço da instância gerenciada para um recurso.
| Nome | Tipo | Description |
|---|---|---|
| clientId |
string |
A ID do cliente do aplicativo Azure Active Directory. |
| principalId |
string |
A ID do objeto de aplicativo do Azure Active Directory. |
| tenantId |
string |
A ID do locatário do Azure Active Directory. |
| type |
Tipo de entidade de serviço. |
ServicePrincipalType
Tipo de entidade de serviço.
| Valor | Description |
|---|---|
| None | |
| SystemAssigned |
Sku
Um SKU de recurso do ARM.
| Nome | Tipo | Description |
|---|---|---|
| capacity |
integer (int32) |
Capacidade da SKU específica. |
| family |
string |
Se o serviço tiver diferentes gerações de hardware, para a mesma SKU, isso poderá ser capturado aqui. |
| name |
string |
O nome da SKU, normalmente, uma letra + código de número, por exemplo, P3. |
| size |
string |
Tamanho da SKU específica |
| tier |
string |
A camada ou edição da SKU específica, por exemplo, Basic, Premium. |
UserIdentity
Configuração de identidade do Azure Active Directory para um recurso.
| Nome | Tipo | Description |
|---|---|---|
| clientId |
string (uuid) |
A ID do cliente do Azure Active Directory. |
| principalId |
string (uuid) |
A ID da entidade de segurança do Azure Active Directory. |