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=2023-08-01
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
managed
|
path | True |
string |
O nome da instância gerenciada. |
resource
|
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. |
subscription
|
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 |
Interrompeu com êxito a instância gerenciada. |
|
202 Accepted |
A interrupção da instância gerenciada está em andamento. Cabeçalhos Location: string |
|
Other Status Codes |
Respostas de erro: ***
|
Exemplos
Stops the managed instance.
Solicitação de exemplo
POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/stoprg/providers/Microsoft.Sql/managedInstances/mitostop/stop?api-version=2023-08-01
Resposta de exemplo
{
"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
Nome | Description |
---|---|
Administrator |
Tipo do administrador de sever. |
Auth |
O modo de pesquisa de metadados de autenticação da instância gerenciada. |
Backup |
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) |
Error |
As informações adicionais do erro de gerenciamento de recursos. |
Error |
O detalhe do erro. |
Error |
Resposta de erro |
External |
Status da governança externa. |
Hybrid |
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). |
Hybrid |
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). |
Identity |
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. |
Managed |
Uma instância gerenciada de SQL do Azure. |
Managed |
Especifica o formato interno de bancos de dados de instância específicos para a versão do mecanismo SQL. |
Managed |
Propriedades de um administrador do active directory. |
Managed |
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). |
Managed |
Uma conexão de ponto de extremidade privado em uma instância gerenciada |
Managed |
Propriedades de uma conexão de ponto de extremidade privado. |
Managed |
|
Managed |
|
Managed |
Tipo de conexão usado para se conectar à instância. |
Managed |
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. |
Pricing |
Modelo de preços da Instância Gerenciada. |
Principal |
Tipo de entidade de segurança do administrador de sever. |
Provisioning |
Estado de provisionamento da instância gerenciada. |
Resource |
Configuração de identidade do Azure Active Directory para um recurso. |
Service |
A configuração da entidade de serviço da instância gerenciada para um recurso. |
Service |
Tipo de entidade de serviço. |
Sku |
Um SKU de recurso do ARM. |
User |
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 |
As informações adicionais do erro. |
|
code |
string |
O código de erro. |
details |
Os detalhes do erro. |
|
message |
string |
A mensagem de erro. |
target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
Nome | Tipo | Description |
---|---|---|
error |
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 |
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 |
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 |
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 |
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 |
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 |
Status da governança externa. |
|
properties.fullyQualifiedDomainName |
string |
O nome de domínio totalmente qualificado da instância gerenciada. |
properties.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 |
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 |
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 |
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 |
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 |
Lista de conexões de ponto de extremidade privado em uma instância gerenciada. |
|
properties.provisioningState |
Estado de provisionamento da instância gerenciada. |
|
properties.proxyOverride |
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 |
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 |
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 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 |
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 |
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 |
Propriedades de conexão de ponto de extremidade privado |
ManagedInstancePrivateEndpointConnectionProperties
Propriedades de uma conexão de ponto de extremidade privado.
Nome | Tipo | Description |
---|---|---|
privateEndpoint |
Ponto de extremidade privado ao qual a conexão pertence. |
|
privateLinkServiceConnectionState |
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 |
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,
User |
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 |
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. |