Partilhar via


Managed Instances - Stop

Interrompe a instância gerenciada.

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

Parâmetros do URI

Name Em Necessá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 da API do Azure Resource Manager ou 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

Name Tipo Description
200 OK

ManagedInstance

Interrompida com êxito a instância gerenciada.

202 Accepted

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

Other Status Codes

ErrorResponse

Respostas de erro: ***

  • 400 ManagementServiceStopManagedInstanceZoneRedundant - Pare executado na instância com redundância de zona habilitada.

  • 400 ManagementServiceStopManagedInstancePartOfFailoverGroup - Parada executada na instância que faz parte do grupo de failover.

  • 400 NameAlreadyExists - O nome fornecido já existe.

  • 400 ManagementServiceStartStopManagedInstanceSubscriptionNotEnabledForFeature - O usuário tentou usar o recurso Start/Stop sem ter a assinatura permitidalistada para o recurso de assinatura apropriado.

  • 400 ManagementServiceStopManagedInstanceNotSupportedOnSKU - A operação Stop não é suportada no SKU fornecido.

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

  • 400 StartStopOfManagedInstanceIsDisabled - Iniciar e parar a operação na instância gerenciada não está habilitado.

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

  • 400 ManagementServiceStopManagedInstanceUsingMILink - Parada executada na instância que tem o link Instância Gerenciada configurado.

  • 400 ManagementServiceStopManagedInstanceFeatureDisabled - O usuário tentou usar o recurso Parar Instância Gerenciada SQL do Azure, que está desabilitado.

  • 400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform - Pare executado na instância que não está sendo executada com o Feature Wave novembro de 2022

  • 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 ManagementServiceStopManagedInstanceAlreadyInProgress - Operação de parada enviada para operação que está no estado de parada/parada.

  • 409 ManagementServiceStopManagedInstanceConflictingOperation - Parar a mensagem de operação conflitante da Instância Gerenciada SQL do Azure.

  • 409 ManagementServiceStopManagedInstanceDroppedDuringStop - Parada executada em instância que está em estado de exclusão ou removida entretanto.

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

  • 409 ManagementServiceStopManagedInstanceConflictingOperationOnInstancePool - Interrompa a mensagem de operação do pool de instâncias SQL do Azure conflitante na operação do pool de instâncias.

  • 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 pelos recursos disponíveis.

  • 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

  • 500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Por favor, tente novamente a operação.

  • 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

Exemplos

Stops the managed instance.

Pedido de amostra

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/stoprg/providers/Microsoft.Sql/managedInstances/mitostop/stop?api-version=2024-05-01-preview

Resposta da amostra

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen5"
  },
  "properties": {
    "fullyQualifiedDomainName": "mitostop.1234567891234.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/stoprg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "state": "Stopped",
    "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/stoprg/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/stoprg/providers/Microsoft.Sql/managedInstances/mitostop",
  "name": "mitostop",
  "type": "Microsoft.Sql/managedInstances"
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/stoprg/providers/Microsoft.Sql/locations/westeurope/stopManagedInstanceOperationResults/11111111-1111-1111-1111-111111111111
Azure-AsyncOperation: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/stoprg/providers/Microsoft.Sql/locations/westeurope/stopManagedInstanceAzureAsyncOperation/11111111-1111-1111-1111-111111111111

Definições

Name Description
AdministratorType

Tipo de administrador de corte.

AuthMetadataLookupModes

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

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)

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 isso como 'SystemAssigned' para criar e atribuir automaticamente uma entidade do Azure Ative Directory para o recurso.

ManagedInstance

Uma instância gerenciada 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 precificação da Instância Gerenciada.

PrincipalType

Tipo principal do administrador de corte.

ProvisioningState

Estado de provisionamento da instância gerenciada.

ResourceIdentity

Configuração de identidade do Azure Ative 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.

UserIdentity

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

AdministratorType

Tipo de administrador de corte.

Valor Description
ActiveDirectory

AuthMetadataLookupModes

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 esta instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)

Valor Description
Geo
GeoZone
Local
Zone

ErrorAdditionalInfo

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

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 destino do erro.

ErrorResponse

Resposta de erro

Name Tipo Description
error

ErrorDetail

O objeto de erro.

ExternalGovernanceStatus

Estatuto da governação 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 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
Passive

IdentityType

O tipo de identidade. Defina isso como 'SystemAssigned' para criar e atribuir automaticamente uma entidade do Azure Ative Directory para o recurso.

Valor Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

ManagedInstance

Uma instância gerenciada SQL do Azure.

Name Tipo Description
id

string

ID do recurso.

identity

ResourceIdentity

A identidade do Azure Ative Directory da instância gerenciada.

location

string

Localização 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 login do administrador (necessária para a criação da instância gerenciada).

properties.administrators

ManagedInstanceExternalAdministrator

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

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 point-in-time (formato ISO8601) da criação da Instância Gerenciada.

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

string

Versão TLS mínima. Valores permitidos: 'Nenhum', '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 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.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: 16384. 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. O Windows mantém detalhes sobre fusos horários suportados, incluindo a id, no registro em KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Você pode obter esses valores do Registro via 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álido é "Pacific Standard Time" ou "W. Hora Padrão da Europa".

properties.totalMemoryMB

integer (int32)

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

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 de instância gerenciada. Valores permitidos para sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM BC_G8IH

tags

object

Tags de recursos.

type

string

Tipo de recurso.

ManagedInstanceDatabaseFormat

Especifica o formato interno dos 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 Ative Directory.

Name Tipo Description
administratorType

AdministratorType

Tipo de administrador de corte.

azureADOnlyAuthentication

boolean

Somente Autenticação do Ative Directory do Azure habilitada.

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

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
BasePrice
LicenseIncluded

ManagedInstancePecProperty

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

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

Name Tipo Description
id

string

ID do recurso do ponto de extremidade privado.

ManagedInstancePrivateLinkServiceConnectionStateProperty

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

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

Valor Description
Default
Proxy
Redirect

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.

Valor Description
Default
PointInTimeRestore

PricingModel

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

Valor Description
Freemium
Regular

PrincipalType

Tipo principal do administrador de corte.

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 Ative Directory para um recurso.

Name Tipo Description
principalId

string (uuid)

A ID principal do Azure Ative Directory.

tenantId

string (uuid)

A ID de locatário do Azure Ative Directory.

type

IdentityType

O tipo de identidade. Defina isso como 'SystemAssigned' para criar e atribuir automaticamente uma entidade do Azure Ative Directory para o recurso.

userAssignedIdentities

<string,  UserIdentity>

As ids de recurso das identidades atribuídas ao usuário a serem usadas

ServicePrincipal

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

Name Tipo Description
clientId

string

A ID do cliente do aplicativo Azure Ative Directory.

principalId

string

A ID do objeto do aplicativo Azure Ative Directory.

tenantId

string

A ID de locatário do Azure Ative 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 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.

UserIdentity

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

Name Tipo Description
clientId

string (uuid)

A ID do cliente do Azure Ative Directory.

principalId

string (uuid)

A ID principal do Azure Ative Directory.