Managed Instances - Create Or Update

Serviço:: SQL Database

Versão da API:: 2025-01-01

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
managedInstanceName	path	True	string	O nome da instância gerenciada.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser um UUID.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Corpo do Pedido

Name	Necessário	Tipo	Description
location	True	string	A geolocalização onde o recurso vive
identity		ResourceIdentity	A identidade do Azure Active Directory da instância gerida.
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 (password)	A senha de login do administrador (necessária para a criação da instância gerenciada).
properties.administrators		ManagedInstanceExternalAdministrator	O administrador do Azure Active Directory pode ser utilizado durante a criação de instâncias e para atualizações de instâncias, exceto pela propriedade azureADOnlyAuthentication. Para atualizar a propriedade azureADOnlyAuthentication, a API individual deve ser usada.
properties.authenticationMetadata		AuthMetadataLookupModes	Modo de pesquisa de metadados de autenticação da instância gerenciada.
properties.collation		string	Agrupamento da instância gerenciada.
properties.databaseFormat		ManagedInstanceDatabaseFormat	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		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		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).
properties.maintenanceConfigurationId		string	Especifica a ID de configuração de manutenção a ser aplicada a essa instância gerenciada.
properties.managedInstanceCreateMode		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.
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		PricingModel	Modelo de preços da Managed Instance.
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		ManagedInstanceProxyOverride	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		BackupStorageRedundancy	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		AvailabilityZoneType	Especifica a zona de disponibilidade lógica à qual a Managed Instance 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		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. Windows mantém detalhes sobre os fusos horários suportados, incluindo o id, no registo sob KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Pode obter esses valores do registo via 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á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	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	ManagedInstance	Operação de atualização do recurso 'ManagedInstance' bem-sucedida
201 Created	ManagedInstance	Resource 'ManagedInstance' criar operação bem-sucedida Cabeçalhos Location: string Retry-After: integer
202 Accepted		Operação de recurso aceita. Cabeçalhos Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Segurança

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

Create managed instance with all properties

Create managed instance with minimal properties

Create managed instance with all properties

Pedido de amostra

HTTP

PUT https://management.azure.com/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2025-01-01

{
  "location": "Japan East",
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "PLACEHOLDER",
    "administrators": {
      "azureADOnlyAuthentication": true,
      "login": "bob@contoso.com",
      "principalType": "User",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111"
    },
    "authenticationMetadata": "AzureAD",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "databaseFormat": "AlwaysUpToDate",
    "dnsZonePartner": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
    "hybridSecondaryUsage": "Passive",
    "instancePoolId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1",
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "minimalTlsVersion": "1.2",
    "proxyOverride": "Redirect",
    "publicDataEndpointEnabled": false,
    "requestedBackupStorageRedundancy": "Geo",
    "requestedLogicalAvailabilityZone": "1",
    "servicePrincipal": {
      "type": "SystemAssigned"
    },
    "storageSizeInGB": 1024,
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "timezoneId": "UTC",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose"
  },
  "tags": {
    "tagKey1": "TagValue1"
  }
}

Resposta da amostra

Código de estado:: 200

{
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances",
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "location": "japaneast",
  "properties": {
    "administratorLogin": "dummylogin",
    "administrators": {
      "azureADOnlyAuthentication": true,
      "login": "bob@contoso.com",
      "principalType": "User",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111"
    },
    "authenticationMetadata": "AzureAD",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "currentBackupStorageRedundancy": "Geo",
    "databaseFormat": "AlwaysUpToDate",
    "dnsZone": "1b4e2caff2530",
    "externalGovernanceStatus": "Enabled",
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "hybridSecondaryUsage": "Passive",
    "instancePoolId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1",
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "minimalTlsVersion": "1.2",
    "provisioningState": "Creating",
    "proxyOverride": "Redirect",
    "publicDataEndpointEnabled": false,
    "requestedBackupStorageRedundancy": "Geo",
    "requestedLogicalAvailabilityZone": "1",
    "servicePrincipal": {
      "type": "SystemAssigned",
      "clientId": "00000011-1111-2222-2222-123456789111",
      "principalId": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111"
    },
    "state": "Ready",
    "storageSizeInGB": 1024,
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "timezoneId": "UTC",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "capacity": 8,
    "family": "Gen5",
    "tier": "GeneralPurpose"
  },
  "tags": {
    "tagKey1": "TagValue1"
  }
}

Código de estado:: 201

{
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances",
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "location": "japaneast",
  "properties": {
    "administratorLogin": "dummylogin",
    "administrators": {
      "azureADOnlyAuthentication": true,
      "login": "bob@contoso.com",
      "principalType": "User",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111"
    },
    "authenticationMetadata": "AzureAD",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "currentBackupStorageRedundancy": "Geo",
    "databaseFormat": "AlwaysUpToDate",
    "dnsZone": "1b4e2caff2530",
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "hybridSecondaryUsage": "Passive",
    "instancePoolId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1",
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "minimalTlsVersion": "1.2",
    "provisioningState": "Creating",
    "proxyOverride": "Redirect",
    "publicDataEndpointEnabled": false,
    "requestedBackupStorageRedundancy": "Geo",
    "requestedLogicalAvailabilityZone": "1",
    "servicePrincipal": {
      "type": "SystemAssigned",
      "clientId": "00000011-1111-2222-2222-123456789111",
      "principalId": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111"
    },
    "state": "Ready",
    "storageSizeInGB": 1024,
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "timezoneId": "UTC",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "capacity": 8,
    "family": "Gen5",
    "tier": "GeneralPurpose"
  },
  "tags": {
    "tagKey1": "TagValue1"
  }
}

Código de estado:: 202

Create managed instance with minimal properties

Pedido de amostra

HTTP

PUT https://management.azure.com/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2025-01-01

{
  "location": "Japan East",
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "PLACEHOLDER",
    "licenseType": "LicenseIncluded",
    "storageSizeInGB": 1024,
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose"
  }
}

Resposta da amostra

Código de estado:: 200

{
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances",
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "location": "japaneast",
  "properties": {
    "administratorLogin": "dummylogin",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "currentBackupStorageRedundancy": "Geo",
    "databaseFormat": "SQLServer2022",
    "dnsZone": "1b4e2caff2530",
    "externalGovernanceStatus": "Enabled",
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "hybridSecondaryUsage": "Passive",
    "licenseType": "LicenseIncluded",
    "provisioningState": "Creating",
    "proxyOverride": "Redirect",
    "publicDataEndpointEnabled": false,
    "requestedBackupStorageRedundancy": "Geo",
    "state": "Ready",
    "storageSizeInGB": 1024,
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "capacity": 8,
    "family": "Gen4",
    "tier": "GeneralPurpose"
  },
  "tags": {}
}

Código de estado:: 201

{
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances",
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "location": "japaneast",
  "properties": {
    "administratorLogin": "dummylogin",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "currentBackupStorageRedundancy": "Geo",
    "databaseFormat": "SQLServer2022",
    "dnsZone": "1b4e2caff2530",
    "externalGovernanceStatus": "Enabled",
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "hybridSecondaryUsage": "Passive",
    "licenseType": "LicenseIncluded",
    "provisioningState": "Creating",
    "proxyOverride": "Redirect",
    "publicDataEndpointEnabled": false,
    "requestedBackupStorageRedundancy": "Geo",
    "state": "Ready",
    "storageSizeInGB": 1024,
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "capacity": 8,
    "family": "Gen4",
    "tier": "GeneralPurpose"
  },
  "tags": {}
}

Código de estado:: 202

Definições

Name	Description
AdministratorType	Tipo de administrador de corte.
AuthMetadataLookupModes	Modo de pesquisa de metadados de autenticação da instância gerenciada.
AvailabilityZoneType	Especifica a zona de disponibilidade na qual o banco de dados está fixado.
BackupStorageRedundancy	O tipo de conta de armazenamento usado para armazenar backups para esse banco de dados.
createdByType	O tipo de identidade que criou o recurso.
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
ExternalGovernanceStatus	Estatuto da governação externa.
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).
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).
IdentityType	O tipo de identidade. Defina isto como 'SystemAssigned' para criar e atribuir automaticamente um principal do Azure Active Directory ao recurso.
ManagedInstance	Uma instância gerida do SQL do Azure.
ManagedInstanceDatabaseFormat	Especifica o formato interno dos bancos de dados de instância específicos para a versão do mecanismo SQL.
ManagedInstanceExternalAdministrator	Propriedades de um administrador do Ative Directory.
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).
ManagedInstancePecProperty	Uma conexão de ponto de extremidade privada em uma instância gerenciada
ManagedInstancePrivateEndpointConnectionProperties	Propriedades de uma conexão de ponto de extremidade privada.
ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride	Tipo de conexão usado para se conectar à instância.
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.
PricingModel	Modelo de preços da Managed Instance.
PrincipalType	Tipo principal do administrador de corte.
ProvisioningState	O estado de provisionamento ARM da execução do trabalho.
ResourceIdentity	Configuração de identidade do Azure Active Directory para um recurso.
ServicePrincipal	A configuração da entidade de serviço da instância gerenciada para um recurso.
ServicePrincipalType	Tipo de entidade de serviço.
Sku	Um SKU de recurso ARM.
systemData	Metadados referentes à criação e última modificação do recurso.
UserIdentity	Configuração de identidade do Azure Active Directory para um recurso.

AdministratorType

Enumeração

Tipo de administrador de corte.

Valor	Description
ActiveDirectory	ActiveDirectory

AuthMetadataLookupModes

Enumeração

Modo de pesquisa de metadados de autenticação da instância gerenciada.

Valor	Description
AzureAD	AzureAD
Paired	Emparelhados
Windows	Windows

AvailabilityZoneType

Enumeração

Especifica a zona de disponibilidade na qual o banco de dados está fixado.

Valor	Description
NoPreference	Sem Preferência
1	1
2	2
3	3

BackupStorageRedundancy

Enumeração

O tipo de conta de armazenamento usado para armazenar backups para esse banco de dados.

Valor	Description
Geo	Geografia
Local	Local
Zone	Zona
GeoZone	GeoZona

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

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

Object

O detalhe do erro.

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O alvo do erro.

ErrorResponse

Object

Resposta de erro

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

ExternalGovernanceStatus

Enumeração

Estatuto da governação externa.

Valor	Description
Enabled	Ativado
Disabled	Disabled

HybridSecondaryUsage

Enumeração

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	Ativos
Passive	Passive

HybridSecondaryUsageDetected

Enumeração

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	Ativos
Passive	Passive

IdentityType

Enumeração

O tipo de identidade. Defina isto como 'SystemAssigned' para criar e atribuir automaticamente um principal do Azure Active Directory ao recurso.

Valor	Description
None	Nenhum
SystemAssigned	Atribuído pelo Sistema
UserAssigned	UserAssigned
SystemAssigned,UserAssigned	SystemAssigned, UserAssigned

ManagedInstance

Object

Uma instância gerida do SQL do Azure.

Name	Tipo	Description
id	string (arm-id)	ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ResourceIdentity	A identidade do Azure Active Directory da instância gerida.
location	string	A geolocalização onde o recurso vive
name	string	O 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 (password)	A senha de login do administrador (necessária para a criação da instância gerenciada).
properties.administrators	ManagedInstanceExternalAdministrator	O administrador do Azure Active Directory pode ser utilizado durante a criação de instâncias e para atualizações de instâncias, exceto pela propriedade azureADOnlyAuthentication. Para atualizar a propriedade azureADOnlyAuthentication, a API individual deve ser usada.
properties.authenticationMetadata	AuthMetadataLookupModes	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 momento no tempo (formato ISO8601) da criação da Managed Instance.
properties.currentBackupStorageRedundancy	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)
properties.databaseFormat	ManagedInstanceDatabaseFormat	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	ExternalGovernanceStatus	Estatuto da governação externa.
properties.fullyQualifiedDomainName	string	O nome de domínio totalmente qualificado da instância gerenciada.
properties.hybridSecondaryUsage	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	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	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).
properties.maintenanceConfigurationId	string	Especifica a ID de configuração de manutenção a ser aplicada a essa instância gerenciada.
properties.managedInstanceCreateMode	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.
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	PricingModel	Modelo de preços da Managed Instance.
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	ManagedInstancePecProperty[]	Lista de conexões de ponto de extremidade privado em uma instância gerenciada.
properties.provisioningState	ProvisioningState	Estado de provisionamento da instância gerenciada.
properties.proxyOverride	ManagedInstanceProxyOverride	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	BackupStorageRedundancy	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	AvailabilityZoneType	Especifica a zona de disponibilidade lógica à qual a Managed Instance 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	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. Windows mantém detalhes sobre os fusos horários suportados, incluindo o id, no registo sob KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Pode obter esses valores do registo via 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á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 do cluster virtual para a Managed Instance.
properties.zoneRedundant	boolean	Se a redundância de zona está habilitada ou não.
sku	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).
systemData	systemData	Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
tags	object	Tags de recursos.
type	string	O tipo do recurso. Por exemplo, "Microsoft. Computação/Máquinas Virtuais" ou "Microsoft. ContasArmazenamento/Armazenamento"

ManagedInstanceDatabaseFormat

Enumeração

Especifica o formato interno dos bancos de dados de instância específicos para a versão do mecanismo SQL.

Valor	Description
AlwaysUpToDate	SempreAtualizado
SQLServer2022	SQLServer2022
SQLServer2025	SQLServer2025

ManagedInstanceExternalAdministrator

Object

Propriedades de um administrador do Ative Directory.

Name	Tipo	Description
administratorType	AdministratorType	Tipo de administrador de corte.
azureADOnlyAuthentication	boolean	Apenas Azure Active Directory Autenticação ativada.
login	string	Nome de login do administrador do servidor.
principalType	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

Enumeração

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	LicençaIncluído
BasePrice	BasePrice

ManagedInstancePecProperty

Object

Uma conexão de ponto de extremidade privada em uma instância gerenciada

Name	Tipo	Description
id	string	ID do recurso.
properties	ManagedInstancePrivateEndpointConnectionProperties	Propriedades de conexão de ponto de extremidade privado

ManagedInstancePrivateEndpointConnectionProperties

Object

Propriedades de uma conexão de ponto de extremidade privada.

Name	Tipo	Description
privateEndpoint	ManagedInstancePrivateEndpointProperty	Ponto de extremidade privado ao qual a conexão pertence.
privateLinkServiceConnectionState	ManagedInstancePrivateLinkServiceConnectionStateProperty	Estado da Conexão da Conexão de Ponto Final Privado.
provisioningState	string	Estado da Conexão de Ponto Final Privado.

ManagedInstancePrivateEndpointProperty

Object

Name	Tipo	Description
id	string	ID do recurso do ponto de extremidade privado.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Object

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

Enumeração

Tipo de conexão usado para se conectar à instância.

Valor	Description
Proxy	Proxy
Redirect	Redirecionamento
Default	Predefinição

ManagedServerCreateMode

Enumeração

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	Predefinição
PointInTimeRestore	PointInTimeRestore

PricingModel

Enumeração

Modelo de preços da Managed Instance.

Valor	Description
Regular	Regular
Freemium	Freemium

PrincipalType

Enumeração

Tipo principal do administrador de corte.

Valor	Description
User	User
Group	Grupo
Application	Application

ProvisioningState

Enumeração

O estado de provisionamento ARM da execução do trabalho.

Valor	Description
Created	Criado
InProgress	Em curso
Succeeded	Succeeded
Failed	Falha
Canceled	Cancelado

ResourceIdentity

Object

Configuração de identidade do Azure Active Directory para um recurso.

Name	Tipo	Description
principalId	string (uuid)	O principal id do Azure Active Directory.
tenantId	string (uuid)	O id do tenant do Azure Active Directory.
type	IdentityType	O tipo de identidade. Defina isto como 'SystemAssigned' para criar e atribuir automaticamente um principal do Azure Active Directory ao recurso.
userAssignedIdentities	<string, UserIdentity>	As ids de recurso das identidades atribuídas ao usuário a serem usadas

ServicePrincipal

Object

A configuração da entidade de serviço da instância gerenciada para um recurso.

Name	Tipo	Description
clientId	string	O ID do cliente da aplicação Azure Active Directory.
principalId	string	O ID do objeto da aplicação Azure Active Directory.
tenantId	string	O id do tenant do Azure Active Directory.
type	ServicePrincipalType	Tipo de entidade de serviço.

ServicePrincipalType

Enumeração

Tipo de entidade de serviço.

Valor	Description
None	Nenhum
SystemAssigned	Atribuído pelo Sistema

Sku

Object

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.

systemData

Object

Metadados referentes à criação e última modificação do recurso.

Name	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

UserIdentity

Object

Configuração de identidade do Azure Active Directory para um recurso.

Name	Tipo	Description
clientId	string (uuid)	O ID do cliente do Azure Active Directory.
principalId	string (uuid)	O principal id do Azure Active Directory.

Partilhar via

Managed Instances - Create Or Update

Parâmetros do URI

Corpo do Pedido

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

Create managed instance with all properties

Pedido de amostra

Resposta da amostra

Create managed instance with minimal properties

Pedido de amostra

Resposta da amostra

Definições

AdministratorType

AuthMetadataLookupModes

AvailabilityZoneType

BackupStorageRedundancy

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExternalGovernanceStatus

HybridSecondaryUsage

HybridSecondaryUsageDetected

IdentityType

ManagedInstance

ManagedInstanceDatabaseFormat

ManagedInstanceExternalAdministrator

ManagedInstanceLicenseType

ManagedInstancePecProperty

ManagedInstancePrivateEndpointConnectionProperties

ManagedInstancePrivateEndpointProperty

ManagedInstancePrivateLinkServiceConnectionStateProperty

ManagedInstanceProxyOverride

ManagedServerCreateMode

PricingModel

PrincipalType

ProvisioningState

ResourceIdentity

ServicePrincipal

ServicePrincipalType

Sku

systemData

UserIdentity