Share via


Managed Instances - Start

Inicia a instância gerida.

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

Parâmetros do URI

Name Em Necessário Tipo Description
managedInstanceName
path True

string

O nome da instância gerida.

resourceGroupName
path True

string

O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.

subscriptionId
path True

string

O ID da subscrição que identifica uma subscrição do Azure.

api-version
query True

string

A versão da API a utilizar para o pedido.

Respostas

Name Tipo Description
200 OK

ManagedInstance

A instância gerida foi iniciada com êxito.

202 Accepted

A iniciar a instância gerida está em curso.

Other Status Codes

ErrorResponse

Respostas de Erro: ***

  • 400 ManagementServiceStartManagedInstanceTriggeredWhileStartInProgress - O utilizador tentou Iniciar Azure SQL Managed Instance que não está no estado Parado.

  • 400 NameAlreadyExists – o nome fornecido já existe.

  • 400 ManagementServiceStartStopManagedInstanceSubscriptionNotEnabledForFeature – o utilizador tentou utilizar a funcionalidade Iniciar/Parar sem ter a subscrição na lista de permissões para a funcionalidade de subscrição adequada.

  • 400 ManagementServiceStartManagedInstanceNotSupportedOnSKU – A operação de início não é suportada no SKU especificado.

  • 400 InvalidServerName – nome de servidor inválido especificado.

  • 400 StartStopOfManagedInstanceIsDisabled – a operação iniciar e parar na instância gerida não está ativada.

  • 400 InvalidIdentifier - O identificador contém NULL ou um caráter unicode inválido.

  • 400 ManagementServiceStartManagedInstanceFeatureDisabled – o utilizador tentou utilizar a funcionalidade Iniciar Azure SQL Managed Instance, que está desativada.

  • 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e subscrição especificados.

  • 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado

  • 404 OperationIdNotFound - A operação com o ID não existe.

  • 404 ResourceNotFound – o recurso pedido não foi encontrado.

  • 404 OperationIdNotFound - A operação com o ID não existe.

  • 409 SubscriptionDisabled - A subscrição está desativada.

  • 409 CannotCancelOperation - A operação de gestão está num estado que não pode ser cancelado.

  • 409 OperationCancelled - A operação foi cancelada pelo utilizador.

  • 409 OperationInterrupted - Não foi possível concluir a operação no recurso porque foi interrompida por outra operação no mesmo recurso.

  • 429 SubscriptionTooManyCreateUpdateRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

  • 429 SubscriptionTooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

  • 500 OperationTimedOut – a operação excedeu o limite de tempo e foi revertida automaticamente. Repita a operação.

  • 503 TooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

Exemplos

Starts the managed instance.

Sample Request

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

Sample Response

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen5"
  },
  "properties": {
    "fullyQualifiedDomainName": "mitostart.1234567891234.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "state": "Ready",
    "provisioningState": "Succeeded",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "publicDataEndpointEnabled": false,
    "proxyOverride": "Default",
    "minimalTlsVersion": "1.2",
    "dnsZone": "1234567891234",
    "instancePoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/instancePools/instancePool1",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "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",
    "authenticationMetadata": "Windows",
    "databaseFormat": "SQLServer2022"
  },
  "location": "japaneast",
  "tags": {
    "key": "value"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/managedInstances/mitostart",
  "name": "mitostart",
  "type": "Microsoft.Sql/managedInstances"
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/locations/westeurope/startManagedInstanceOperationResults/11111111-1111-1111-1111-111111111111
Azure-AsyncOperation: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/locations/westeurope/startManagedInstanceAzureAsyncOperation/11111111-1111-1111-1111-111111111111

Definições

Name Description
AdministratorType

Tipo de administrador de gravidade.

AuthMetadataLookupModes

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

BackupStorageRedundancy

O tipo de conta de armazenamento utilizado para armazenar cópias de segurança para esta instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta a erros

ExternalGovernanceStatus

Estado da governação externa.

FreemiumType

A Meteorologia ou não a Instância Gerida é freemium.

HybridSecondaryUsage

Utilização secundária híbrida. Os valores possíveis são "Ativo" (valor predefinido) e "Passivo" (o cliente utiliza o secundário como DR Passivo).

HybridSecondaryUsageDetected

Utilização secundária híbrida detetada. Os valores possíveis são "Ativo" (o cliente não cumpre os requisitos para utilizar o secundário como DR Passivo) e "Passivo" (o cliente cumpre os requisitos para utilizar o secundário como DR Passivo).

IdentityType

O tipo de identidade. Defina esta opção como "SystemAssigned" para criar e atribuir automaticamente um principal do Azure Active Directory para o recurso.

ManagedInstance

Uma instância gerida SQL do Azure.

ManagedInstanceDatabaseFormat

Especifica o formato interno das bases de dados de instância específicas da versão do motor SQL.

ManagedInstanceExternalAdministrator

Propriedades de um administrador do Active Directory.

ManagedInstanceLicenseType

O tipo de licença. Os valores possíveis são "LicenseIncluded" (preço normal, incluindo uma nova licença SQL) e "Preço Base" (preço AHB com desconto para trazer as suas próprias licenças SQL).

ManagedInstancePecProperty

Uma ligação de ponto final privado numa instância gerida

ManagedInstancePrivateEndpointConnectionProperties

Propriedades de uma ligação de ponto final privado.

ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride

Tipo de ligação utilizado para ligar à instância.

ManagedServerCreateMode

Especifica o modo de criação da base de dados.

Predefinição: criação de instâncias regulares.

Restauro: cria uma instância ao restaurar um conjunto de cópias de segurança para um ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId têm de ser especificados.

PrincipalType

Tipo principal do administrador de gravidade.

ProvisioningState

Estado de aprovisionamento da instância gerida.

ResourceIdentity

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

ServicePrincipal

A configuração do principal de serviço da instância gerida para um recurso.

ServicePrincipalType

Tipo de principal de serviço.

Sku

Um SKU de Recurso do ARM.

UserIdentity

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

AdministratorType

Tipo de administrador de gravidade.

Name Tipo Description
ActiveDirectory

string

AuthMetadataLookupModes

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

Name Tipo Description
AzureAD

string

Paired

string

Windows

string

BackupStorageRedundancy

O tipo de conta de armazenamento utilizado para armazenar cópias de segurança para esta instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)

Name Tipo Description
Geo

string

GeoZone

string

Local

string

Zone

string

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Tipo Description
additionalInfo

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

Resposta a erros

Name Tipo Description
error

ErrorDetail

O objeto de erro.

ExternalGovernanceStatus

Estado da governação externa.

Name Tipo Description
Disabled

string

Enabled

string

FreemiumType

A Meteorologia ou não a Instância Gerida é freemium.

Name Tipo Description
Freemium

string

Regular

string

HybridSecondaryUsage

Utilização secundária híbrida. Os valores possíveis são "Ativo" (valor predefinido) e "Passivo" (o cliente utiliza o secundário como DR Passivo).

Name Tipo Description
Active

string

Passive

string

HybridSecondaryUsageDetected

Utilização secundária híbrida detetada. Os valores possíveis são "Ativo" (o cliente não cumpre os requisitos para utilizar o secundário como DR Passivo) e "Passivo" (o cliente cumpre os requisitos para utilizar o secundário como DR Passivo).

Name Tipo Description
Active

string

Passive

string

IdentityType

O tipo de identidade. Defina esta opção como "SystemAssigned" para criar e atribuir automaticamente um principal do Azure Active Directory para o recurso.

Name Tipo Description
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

ManagedInstance

Uma instância gerida SQL do Azure.

Name Tipo Description
id

string

ID do Recurso.

identity

ResourceIdentity

A identidade do Azure Active Directory da instância gerida.

location

string

Localização do recurso.

name

string

Nome do recurso.

properties.administratorLogin

string

Nome de utilizador administrador da instância gerida. Só pode ser especificado quando a instância gerida está a ser criada (e é necessária para a criação).

properties.administratorLoginPassword

string

A palavra-passe de início de sessão do administrador (necessária para a criação da instância gerida).

properties.administrators

ManagedInstanceExternalAdministrator

O administrador do Azure Active Directory da instância. Esta ação só pode ser utilizada no momento de criação de instâncias. Se for utilizada para a atualização de instâncias, será ignorada ou resultará num erro. Para atualizações, as APIs individuais terão de ser utilizadas.

properties.authenticationMetadata

AuthMetadataLookupModes

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

properties.collation

string

Agrupamento da instância gerida.

properties.createTime

string

Especifica o ponto anterior no tempo (formato ISO8601) da criação da Instância Gerida.

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

O tipo de conta de armazenamento utilizado para armazenar cópias de segurança para esta instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)

properties.databaseFormat

ManagedInstanceDatabaseFormat

Especifica o formato interno das bases de dados de instância específicas da versão do motor SQL.

properties.dnsZone

string

A Zona DNS na qual se encontra a instância gerida.

properties.dnsZonePartner

string

O ID de recurso de outra instância gerida cuja zona DNS esta instância gerida irá partilhar após a criação.

properties.externalGovernanceStatus

ExternalGovernanceStatus

Estado da governação externa.

properties.fullyQualifiedDomainName

string

O nome de domínio completamente qualificado da instância gerida.

properties.hybridSecondaryUsage

HybridSecondaryUsage

Utilização secundária híbrida. Os valores possíveis são "Ativo" (valor predefinido) e "Passivo" (o cliente utiliza a secundária como DR Passiva).

properties.hybridSecondaryUsageDetected

HybridSecondaryUsageDetected

Utilização secundária híbrida detetada. Os valores possíveis são "Ativo" (o cliente não cumpre os requisitos para utilizar a secundária como DR Passiva) e "Passiva" (o cliente cumpre os requisitos para utilizar a secundária como DR Passiva).

properties.instancePoolId

string

O ID do conjunto de instâncias a que este servidor gerido pertence.

properties.isGeneralPurposeV2

boolean

Quer esta seja ou não uma variante GPv2 da edição Fins Gerais.

properties.keyId

string

Um URI CMK da chave a utilizar para encriptação.

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 "Preço Base" (preço AHB com desconto para trazer as suas próprias licenças SQL).

properties.maintenanceConfigurationId

string

Especifica o ID de configuração de manutenção a aplicar a esta instância gerida.

properties.managedInstanceCreateMode

ManagedServerCreateMode

Especifica o modo de criação da base de dados.

Predefinição: criação de instâncias regulares.

Restauro: cria uma instância ao restaurar um conjunto de cópias de segurança para um ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId têm de ser especificados.

properties.minimalTlsVersion

string

Versão mínima do TLS. Valores permitidos: "None", "1.0", "1.1", "1.2"

properties.pricingModel

FreemiumType

A Meteorologia ou não a Instância Gerida é freemium.

properties.primaryUserAssignedIdentityId

string

O ID de recurso de uma identidade atribuída pelo utilizador a utilizar por predefinição.

properties.privateEndpointConnections

ManagedInstancePecProperty[]

Lista de ligações de ponto final privado numa instância gerida.

properties.provisioningState

ProvisioningState

Estado de aprovisionamento da instância gerida.

properties.proxyOverride

ManagedInstanceProxyOverride

Tipo de ligação utilizado para ligar à instância.

properties.publicDataEndpointEnabled

boolean

Se o ponto final de dados públicos está ou não ativado.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

O tipo de conta de armazenamento a ser utilizado para armazenar cópias de segurança para esta instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)

properties.restorePointInTime

string

Especifica o ponto anterior no tempo (ISO8601 formato) da base de dados de origem que será restaurada para criar a nova base de dados.

properties.servicePrincipal

ServicePrincipal

O principal de serviço da instância gerida.

properties.sourceManagedInstanceId

string

O identificador de recurso da instância gerida de origem associada à operação de criação desta instância.

properties.state

string

O estado da instância gerida.

properties.storageIOps

integer

IOps de Armazenamento. Valor mínimo: 300. Valor máximo: 80000. Incrementos de 1 IOps permitidos apenas. O valor máximo depende da família de hardware selecionada e do número de vCores.

properties.storageSizeInGB

integer

Tamanho do armazenamento em GB. Valor mínimo: 32. Valor máximo: 16384. Incrementos de 32 GB permitidos apenas. O valor máximo depende da família de hardware selecionada e do número de vCores.

properties.storageThroughputMBps

integer

O parâmetro MBps de débito de armazenamento não é suportado na operação de criação/atualização de instâncias.

properties.subnetId

string

ID de recurso da sub-rede para a instância gerida.

properties.timezoneId

string

ID do fuso horário. Os valores permitidos são fusos horários suportados pelo Windows. O Windows mantém detalhes sobre os fusos horários suportados, incluindo o ID, no registo em KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Pode obter esses valores de registo através de SQL Server consultando SELECT name AS timezone_id FROM sys.time_zone_info. A lista de IDs também pode ser obtida ao executar [System.TimeZoneInfo]::GetSystemTimeZones() no PowerShell. Um exemplo de id de fuso horário válido é "Hora Padrão do Pacífico" ou "W. Hora Padrão da Europa".

properties.totalMemoryMB

integer

Memória total em MB. Valor mínimo: 7168. Valor máximo: 891328. Incrementos de 1 MB permitidos apenas. O valor máximo depende da família de hardware selecionada e do número de vCores.

properties.vCores

integer

O número de vCores. Valores permitidos: 8, 16, 24, 32, 40, 64, 80.

properties.virtualClusterId

string

ID de recurso do cluster virtual para a Instância Gerida.

properties.zoneRedundant

boolean

Se o multi-az está ou não ativado.

sku

Sku

SKU da instância gerida. Valores permitidos para sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH

tags

object

Etiquetas de recursos.

type

string

Tipo de recurso.

ManagedInstanceDatabaseFormat

Especifica o formato interno das bases de dados de instância específicas da versão do motor SQL.

Name Tipo Description
AlwaysUpToDate

string

SQLServer2022

string

ManagedInstanceExternalAdministrator

Propriedades de um administrador do Active Directory.

Name Tipo Description
administratorType

AdministratorType

Tipo de administrador de gravidade.

azureADOnlyAuthentication

boolean

Apenas a Autenticação do Azure Active Directory está ativada.

login

string

Nome de início de sessão do administrador do servidor.

principalType

PrincipalType

Tipo principal do administrador de gravidade.

sid

string

SID (ID do objeto) do administrador do servidor.

tenantId

string

ID do inquilino do administrador.

ManagedInstanceLicenseType

O tipo de licença. Os valores possíveis são "LicenseIncluded" (preço normal, incluindo uma nova licença SQL) e "Preço Base" (preço AHB com desconto para trazer as suas próprias licenças SQL).

Name Tipo Description
BasePrice

string

LicenseIncluded

string

ManagedInstancePecProperty

Uma ligação de ponto final privado numa instância gerida

Name Tipo Description
id

string

ID do Recurso.

properties

ManagedInstancePrivateEndpointConnectionProperties

Propriedades de ligação de ponto final privado

ManagedInstancePrivateEndpointConnectionProperties

Propriedades de uma ligação de ponto final privado.

Name Tipo Description
privateEndpoint

ManagedInstancePrivateEndpointProperty

Ponto final privado ao qual a ligação pertence.

privateLinkServiceConnectionState

ManagedInstancePrivateLinkServiceConnectionStateProperty

Estado de Ligação da Ligação de Ponto Final Privado.

provisioningState

string

Estado da Ligação de Ponto Final Privado.

ManagedInstancePrivateEndpointProperty

Name Tipo Description
id

string

ID de recurso do ponto final privado.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Name Tipo Description
actionsRequired

string

A descrição da ligação do serviço de ligação privada.

description

string

A descrição da ligação do serviço de ligação privada.

status

string

O estado da ligação do serviço de ligação privada.

ManagedInstanceProxyOverride

Tipo de ligação utilizado para ligar à instância.

Name Tipo Description
Default

string

Proxy

string

Redirect

string

ManagedServerCreateMode

Especifica o modo de criação da base de dados.

Predefinição: criação de instâncias regulares.

Restauro: cria uma instância ao restaurar um conjunto de cópias de segurança para um ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId têm de ser especificados.

Name Tipo Description
Default

string

PointInTimeRestore

string

PrincipalType

Tipo principal do administrador de gravidade.

Name Tipo Description
Application

string

Group

string

User

string

ProvisioningState

Estado de aprovisionamento da instância gerida.

Name Tipo Description
Canceled

string

Created

string

Failed

string

InProgress

string

Succeeded

string

ResourceIdentity

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

Name Tipo Description
principalId

string

O ID principal do Azure Active Directory.

tenantId

string

O ID de inquilino do Azure Active Directory.

type

IdentityType

O tipo de identidade. Defina esta opção como "SystemAssigned" para criar e atribuir automaticamente um principal do Azure Active Directory para o recurso.

userAssignedIdentities

<string,  UserIdentity>

Os IDs de recursos das identidades atribuídas pelo utilizador a utilizar

ServicePrincipal

A configuração do principal de serviço da instância gerida para um recurso.

Name Tipo Description
clientId

string

O ID de cliente da aplicação do Azure Active Directory.

principalId

string

O ID do objeto da aplicação do Azure Active Directory.

tenantId

string

O ID de inquilino do Azure Active Directory.

type

ServicePrincipalType

Tipo de principal de serviço.

ServicePrincipalType

Tipo de principal de serviço.

Name Tipo Description
None

string

SystemAssigned

string

Sku

Um SKU de Recurso do ARM.

Name Tipo Description
capacity

integer

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 de número, por exemplo, P3.

size

string

Tamanho do SKU específico

tier

string

O escalão ou edição do SKU específico, por exemplo, Básico, Premium.

UserIdentity

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

Name Tipo Description
clientId

string

O ID de cliente do Azure Active Directory.

principalId

string

O ID principal do Azure Active Directory.