Managed Instances - Start

Serviço:: SQL Database

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

Inicia a instância gerenciada.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/start?api-version=2025-01-01

Parâmetros de URI

Nome	Em	Obrigató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 uma UUID.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Respostas

Nome	Tipo	Description
200 OK	ManagedInstance	Operação do Azure concluída com sucesso.
202 Accepted		Operação de recurso aceita. Cabeçalhos Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Nome

Tipo

Description

200 OK

ManagedInstance

Operação do Azure concluída com sucesso.

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
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

Starts the managed instance.

Solicitação de exemplo

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/managedInstances/mitostart/start?api-version=2025-01-01

Resposta de exemplo

Código de status:: 200

{
  "name": "mitostart",
  "type": "Microsoft.Sql/managedInstances",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/managedInstances/mitostart",
  "location": "japaneast",
  "properties": {
    "administratorLogin": "dummylogin",
    "authenticationMetadata": "Windows",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "currentBackupStorageRedundancy": "Geo",
    "databaseFormat": "SQLServer2022",
    "dnsZone": "1234567891234",
    "externalGovernanceStatus": "Enabled",
    "fullyQualifiedDomainName": "mitostart.1234567891234.database.windows.net",
    "hybridSecondaryUsage": "Passive",
    "instancePoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/instancePools/instancePool1",
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "minimalTlsVersion": "1.2",
    "provisioningState": "Succeeded",
    "proxyOverride": "Default",
    "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/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "capacity": 8,
    "family": "Gen5",
    "tier": "GeneralPurpose"
  },
  "tags": {
    "key": "value"
  }
}

Código de status:: 202

Azure-AsyncOperation: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/locations/westeurope/startManagedInstanceAzureAsyncOperation/11111111-1111-1111-1111-111111111111
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/locations/westeurope/startManagedInstanceOperationResults/11111111-1111-1111-1111-111111111111

Definições

Nome	Description
AdministratorType	Tipo do administrador de sever.
AuthMetadataLookupModes	O modo de pesquisa de metadados de autenticação da instância gerenciada.
AvailabilityZoneType	Especifica a zona de disponibilidade à 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	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
ExternalGovernanceStatus	Status da governança 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 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).
IdentityType	O tipo de identidade. Defina isso como 'SystemAssigned' para criar e atribuir automaticamente um principal do Azure Active Directory para o recurso.
ManagedInstance	Uma instância gerenciada do SQL do Azure.
ManagedInstanceDatabaseFormat	Especifica o formato interno de bancos de dados de instância específicos para a versão do mecanismo SQL.
ManagedInstanceExternalAdministrator	Propriedades de um administrador do active directory.
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).
ManagedInstancePecProperty	Uma conexão de ponto de extremidade privado em uma instância gerenciada
ManagedInstancePrivateEndpointConnectionProperties	Propriedades de uma conexão de ponto de extremidade privado.
ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride	Tipo de conexão usado para se conectar à instância.
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.
PricingModel	Modelo de precificação da Instância Gerenciada.
PrincipalType	Tipo de entidade de segurança do administrador de sever.
ProvisioningState	O estado de provisionamento do 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 do ARM.
systemData	Metadados relativos à criação e última modificação do recurso.
UserIdentity	Configuração de identidade do Azure Active Directory para um recurso.

AdministratorType

Enumeração

Tipo do administrador de sever.

Valor	Description
ActiveDirectory	Active Directory

AuthMetadataLookupModes

Enumeração

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

Valor	Description
AzureAD	AzureAD
Paired	Emparelhado
Windows	Windows

AvailabilityZoneType

Enumeração

Especifica a zona de disponibilidade à 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	Geo
Local	Local
Zone	Zona
GeoZone	GeoZone

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objeto

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

Objeto

O detalhe do erro.

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

ErrorResponse

Objeto

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

ExternalGovernanceStatus

Enumeração

Status da governança externa.

Valor	Description
Enabled	Habilitado
Disabled	Desactivado

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

HybridSecondaryUsageDetected

Enumeração

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

IdentityType

Enumeração

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

Valor	Description
None	Nenhum
SystemAssigned	AtribuídoPeloSistema
UserAssigned	UserAssigned
SystemAssigned,UserAssigned	SystemAssignado, UsuárioAtribuído

ManagedInstance

Objeto

Uma instância gerenciada do SQL do Azure.

Nome	Tipo	Description
id	string (arm-id)	ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ResourceIdentity	A identidade do Azure Active Directory da instância gerenciada.
location	string	A localização geográfica onde o recurso reside
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 logon 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	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 momento no tempo (formato ISO8601) da criação do Instância Gerenciada.
properties.currentBackupStorageRedundancy	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)
properties.databaseFormat	ManagedInstanceDatabaseFormat	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	ExternalGovernanceStatus	Status da governança 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 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	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).
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 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	PricingModel	Modelo de precificação 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	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úblico está habilitado ou não.
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	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	AvailabilityZoneType	Especifica a zona de disponibilidade lógica à qual o Instância Gerenciada está fixado.
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. 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. Valores permitidos são fusos horários suportados pelo Windows. Windows mantém detalhes sobre fusos horários suportados, incluindo o ID, no registro sob KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Você pode obter esses valores de registro via SQL Server consultando o nome SELECT AS timezone_id DE 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 virtual do cluster para a Instância Gerenciada.
properties.zoneRedundant	boolean	Se a redundância de zona está habilitada ou não.
sku	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).
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. Compute/virtualMachines" ou "Microsoft. ContasArmazenamento/Armazenamento"

ManagedInstanceDatabaseFormat

Enumeração

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

Valor	Description
AlwaysUpToDate	SempreAtualizado
SQLServer2022	SQLServer2022
SQLServer2025	SQLServer2025

ManagedInstanceExternalAdministrator

Objeto

Propriedades de um administrador do active directory.

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

Enumeração

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

ManagedInstancePecProperty

Objeto

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

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

ManagedInstancePrivateEndpointConnectionProperties

Objeto

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

Nome	Tipo	Description
privateEndpoint	ManagedInstancePrivateEndpointProperty	Ponto de extremidade privado ao qual a conexão pertence.
privateLinkServiceConnectionState	ManagedInstancePrivateLinkServiceConnectionStateProperty	Estado de conexão da conexão de ponto de extremidade privado.
provisioningState	string	Estado da conexão de ponto de extremidade privado.

ManagedInstancePrivateEndpointProperty

Objeto

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

ManagedInstancePrivateLinkServiceConnectionStateProperty

Objeto

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

Enumeração

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

Valor	Description
Proxy	Proxy
Redirect	Redirecionar
Default	Default

ManagedServerCreateMode

Enumeração

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	Default
PointInTimeRestore	PointInTimeRestore

PricingModel

Enumeração

Modelo de precificação da Instância Gerenciada.

Valor	Description
Regular	Regular
Freemium	Freemium

PrincipalType

Enumeração

Tipo de entidade de segurança do administrador de sever.

Valor	Description
User	Usuário
Group	Grupo
Application	Aplicativo

ProvisioningState

Enumeração

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

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

ResourceIdentity

Objeto

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

Nome	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 isso como 'SystemAssigned' para criar e atribuir automaticamente um principal do Azure Active Directory para o recurso.
userAssignedIdentities	<string, UserIdentity>	As IDs de recurso das identidades atribuídas pelo usuário a serem usadas

ServicePrincipal

Objeto

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

Nome	Tipo	Description
clientId	string	O ID do cliente da aplicação Azure Active Directory.
principalId	string	O ID do objeto de aplicação do 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ídoPeloSistema

Sku

Objeto

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.

systemData

Objeto

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

Nome	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

Objeto

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

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