Compartilhar 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

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 na API do Azure Resource Manager ou no portal.

subscriptionId
path True

string

A ID da assinatura que identifica uma assinatura do Azure.

api-version
query True

string

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

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.

Cabeçalhos

Location: string

Other Status Codes

ErrorResponse

Respostas de erro: ***

  • 400 NameAlreadyExists - O nome fornecido já existe.

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

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

  • 400 ManagementServiceStartStopManagedInstanceSubscriptionNotEnabledForFeature – O usuário tentou usar o recurso Iniciar/Parar sem ter a assinatura na lista de permissões para o recurso de assinatura apropriado.

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

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

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

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

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

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

  • 400 TokenTooLong – O token fornecido é muito longo.

  • 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 SubscriptionDisabled – 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 do máximo de solicitações 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 novamente a operação.

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

Exemplos

Starts the managed instance.

Solicitação de exemplo

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

Resposta de exemplo

{
  "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.

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 uma entidade de segurança do Azure Active Directory para o recurso.

ManagedInstance

Uma instância gerenciada de 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 preços da Instância Gerenciada.

PrincipalType

Tipo de entidade de segurança 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.

Valor Description
ActiveDirectory

AuthMetadataLookupModes

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

Valor Description
AzureAD
Paired
Windows

BackupStorageRedundancy

O tipo de conta de armazenamento usado para armazenar backups para essa instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)

Valor Description
Geo
GeoZone
Local
Zone

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.

Valor Description
Disabled
Enabled

HybridSecondaryUsage

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

Valor Description
Active
Passive

HybridSecondaryUsageDetected

Uso secundário híbrido detectado. Os valores possíveis são 'Ativo' (o cliente não atende aos requisitos para usar o secundário como DR Passivo) e 'Passivo' (o cliente atende aos requisitos para usar o secundário como DR passivo).

Valor Description
Active
Passive

IdentityType

O tipo de identidade. Defina isso como "SystemAssigned" para criar e atribuir automaticamente uma entidade de segurança do Azure Active Directory para o recurso.

Valor Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

ManagedInstance

Uma instância gerenciada de 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 por exemplo, 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 (date-time)

Especifica o ponto no tempo (formato ISO8601) da criação da 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.minimalTlsVersion

string

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

properties.pricingModel

PricingModel

Modelo de preços da Instância Gerenciada.

properties.primaryUserAssignedIdentityId

string (arm-id)

A ID de recurso de uma identidade atribuída pelo usuário a ser usada por padrão.

properties.privateEndpointConnections

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.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: 16384. Incrementos de 32 GB somente permitidos. O valor máximo depende da família de hardware selecionada e do número de vCores.

properties.storageThroughputMBps

integer (int32)

Não há suporte para o parâmetro MBps de taxa de transferência de armazenamento na operação de criação/atualização da instância.

properties.subnetId

string (arm-id)

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

properties.timezoneId

string

Id do fuso horário. Os valores permitidos são fusos horários compatíveis com o Windows. O Windows mantém detalhes sobre fusos horários com suporte, incluindo a ID, no Registro em KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fusos Horários. Você pode obter esses valores do Registro por meio do SQL Server consultando o nome SELECT AS timezone_id FROM sys.time_zone_info. A lista de IDs também pode ser obtida executando [System.TimeZoneInfo]::GetSystemTimeZones() no PowerShell. Um exemplo de ID de fuso horário válida é "Horário Padrão do Pacífico" ou "W. Horário Padrão da Europa".

properties.vCores

integer (int32)

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

properties.virtualClusterId

string

ID de recurso de cluster virtual para a Instância Gerenciada.

properties.zoneRedundant

boolean

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

sku

Sku

SKU da 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.

Valor Description
AlwaysUpToDate
SQLServer2022

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 de entidade de segurança do administrador de sever.

sid

string (uuid)

SID (ID do objeto) do administrador do servidor.

tenantId

string (uuid)

ID do locatário do administrador.

ManagedInstanceLicenseType

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

Valor Description
BasePrice
LicenseIncluded

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

O status da conexão do serviço de link privado.

ManagedInstanceProxyOverride

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

Valor Description
Default
Proxy
Redirect

ManagedServerCreateMode

Especifica o modo de criação de banco de dados.

Padrão: criação de instância regular.

Restauração: cria uma instância restaurando um conjunto de backups para um ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId devem ser especificados.

Valor Description
Default
PointInTimeRestore

PricingModel

Modelo de preços da Instância Gerenciada.

Valor Description
Freemium
Regular

PrincipalType

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

Valor Description
Application
Group
User

ProvisioningState

Estado de provisionamento da instância gerenciada.

Valor Description
Canceled
Created
Failed
InProgress
Succeeded

ResourceIdentity

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

Nome Tipo Description
principalId

string (uuid)

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

tenantId

string (uuid)

A ID do locatário do Azure Active Directory.

type

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.

Valor Description
None
SystemAssigned

Sku

Um SKU de recurso do ARM.

Nome Tipo Description
capacity

integer (int32)

Capacidade da SKU específica.

family

string

Se o serviço tiver diferentes gerações de hardware, para a mesma SKU, isso poderá ser capturado aqui.

name

string

O nome da SKU, normalmente, uma letra + código de número, por exemplo, P3.

size

string

Tamanho da SKU específica

tier

string

A camada ou edição da SKU específica, por exemplo, Basic, Premium.

UserIdentity

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

Nome Tipo Description
clientId

string (uuid)

A ID do cliente do Azure Active Directory.

principalId

string (uuid)

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