Share via


Managed Instances - Start

Inicia a instância gerenciada.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
managedInstanceName
path True

string

O nome da instância gerenciada.

resourceGroupName
path True

string

O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.

subscriptionId
path True

string

A ID de assinatura que identifica uma assinatura do Azure.

api-version
query True

string

A versão da API a ser usada para a solicitação.

Respostas

Nome Tipo Description
200 OK

ManagedInstance

Iniciou com êxito a instância gerenciada.

202 Accepted

A inicialização da instância gerenciada está em andamento.

Other Status Codes

ErrorResponse

Respostas de erro: ***

  • 400 ManagementServiceStartManagedInstanceTriggeredWhileStartInProgress - O usuário tentou iniciar Instância Gerenciada de SQL do Azure que não está no estado Parado.

  • 400 NameAlreadyExists - O nome fornecido já existe.

  • 400 ManagementServiceStartStopManagedInstanceSubscriptionNotEnabledForFeature - O usuário tentou usar o recurso Iniciar/Parar sem ter a assinatura permitida para o recurso de assinatura apropriado.

  • 400 ManagementServiceStartManagedInstanceNotSupportedOnSKU – Não há suporte para a operação iniciar na SKU fornecida.

  • 400 InvalidServerName - Nome do servidor inválido especificado.

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

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

  • 400 ManagementServiceStartManagedInstanceFeatureDisabled – O usuário tentou usar o recurso Iniciar Instância Gerenciada de SQL do Azure, que está desabilitado.

  • 404 ServerNotInSubscriptionResourceGroup – O servidor especificado não existe no grupo de recursos e na assinatura especificados.

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

  • 404 OperationIdNotFound – A operação com id não existe.

  • 404 ResourceNotFound – O recurso solicitado não foi encontrado.

  • 404 OperationIdNotFound – A operação com id não existe.

  • 409 Assinatura Desabilitada – A assinatura está desabilitada.

  • 409 CannotCancelOperation – A operação de gerenciamento está em um estado que não pode ser cancelado.

  • 409 OperationCancelled – A operação foi cancelada pelo usuário.

  • 409 OperationInterrupted – A operação no recurso não pôde ser concluída porque foi interrompida por outra operação no mesmo recurso.

  • 429 SubscriptionTooManyCreateUpdateRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

  • 429 SubscriptionTooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

  • 500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Tente executar a operação novamente.

  • 503 TooManyRequests – Solicitações além das solicitações máximas que podem ser processadas 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

Nome Description
AdministratorType

Tipo do administrador de sever.

AuthMetadataLookupModes

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

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)

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.

FreemiumType

Clima ou não Instância Gerenciada é freemium.

HybridSecondaryUsage

Uso secundário híbrido. Os valores possíveis são 'Active' (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 uma entidade de segurança do Azure Active Directory para o recurso.

ManagedInstance

Uma instância gerenciada 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 inclusivo 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 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 ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId devem ser especificados.

PrincipalType

Tipo principal do administrador de sever.

ProvisioningState

Estado de provisionamento da instância gerenciada.

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.

UserIdentity

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

AdministratorType

Tipo do administrador de sever.

Nome Tipo Description
ActiveDirectory

string

AuthMetadataLookupModes

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

Nome Tipo Description
AzureAD

string

Paired

string

Windows

string

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)

Nome Tipo Description
Geo

string

GeoZone

string

Local

string

Zone

string

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

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 de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

ExternalGovernanceStatus

Status da governança externa.

Nome Tipo Description
Disabled

string

Enabled

string

FreemiumType

Clima ou não Instância Gerenciada é freemium.

Nome Tipo Description
Freemium

string

Regular

string

HybridSecondaryUsage

Uso secundário híbrido. Os valores possíveis são 'Active' (valor padrão) e 'Passivo' (o cliente usa o secundário como DR passivo).

Nome Tipo Description
Active

string

Passive

string

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).

Nome Tipo Description
Active

string

Passive

string

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.

Nome Tipo Description
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

ManagedInstance

Uma instância gerenciada SQL do Azure.

Nome Tipo Description
id

string

ID do recurso.

identity

ResourceIdentity

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

ManagedInstanceExternalAdministrator

O administrador do Azure Active Directory da instância. Isso só pode ser usado no momento da criação da instância. Se usado para atualização de instância, ele será ignorado ou resultará em um erro. Para atualizações, as APIs individuais precisarão ser usadas.

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

Especifica o ponto 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 na qual a instância gerenciada está.

properties.dnsZonePartner

string

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 da 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 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 ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId devem ser especificados.

properties.minimalTlsVersion

string

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

properties.pricingModel

FreemiumType

Clima ou não Instância Gerenciada é freemium.

properties.primaryUserAssignedIdentityId

string

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úblicos 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.restorePointInTime

string

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

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

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

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

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 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\Time Zones. Você pode obter esses valores do Registro por meio de SQL Server consultando SELECT name AS timezone_id FROM sys.time_zone_info. A lista de IDs também pode ser obtida executando [System.TimeZoneInfo]::GetSystemTimeZones() no PowerShell. Um exemplo de ID de fuso horário válida é "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 do recurso de cluster virtual para o Instância Gerenciada.

properties.zoneRedundant

boolean

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

sku

Sku

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

tags

object

Marcas de recurso.

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.

Nome Tipo Description
AlwaysUpToDate

string

SQLServer2022

string

ManagedInstanceExternalAdministrator

Propriedades de um administrador do Active Directory.

Nome Tipo Description
administratorType

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

PrincipalType

Tipo principal do administrador de sever.

sid

string

SID (ID do objeto) do administrador do servidor.

tenantId

string

ID do locatário do administrador.

ManagedInstanceLicenseType

O tipo de licença. Os valores possíveis são 'LicenseIncluded' (preço regular inclusivo de uma nova licença SQL) e 'BasePrice' (preço ahb com desconto para trazer suas próprias licenças SQL).

Nome Tipo Description
BasePrice

string

LicenseIncluded

string

ManagedInstancePecProperty

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

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

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

A conexão do serviço de link privado status.

ManagedInstanceProxyOverride

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

Nome Tipo Description
Default

string

Proxy

string

Redirect

string

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 ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId devem ser especificados.

Nome Tipo Description
Default

string

PointInTimeRestore

string

PrincipalType

Tipo principal do administrador de sever.

Nome Tipo Description
Application

string

Group

string

User

string

ProvisioningState

Estado de provisionamento da instância gerenciada.

Nome Tipo Description
Canceled

string

Created

string

Failed

string

InProgress

string

Succeeded

string

ResourceIdentity

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

Nome Tipo Description
principalId

string

A ID da entidade de segurança do Azure Active Directory.

tenantId

string

A ID do locatário do Azure Active Directory.

type

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.

userAssignedIdentities

<string,  UserIdentity>

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

ServicePrincipalType

Tipo de entidade de serviço.

ServicePrincipalType

Tipo de entidade de serviço.

Nome Tipo Description
None

string

SystemAssigned

string

Sku

Um SKU de recurso do ARM.

Nome Tipo Description
capacity

integer

Capacidade do SKU específico.

family

string

Se o serviço tiver gerações diferentes 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 do SKU específico

tier

string

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

UserIdentity

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

Nome Tipo Description
clientId

string

A ID do cliente do Azure Active Directory.

principalId

string

A ID da entidade de segurança do Azure Active Directory.