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-preview
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 por meio da API do Gerenciador de Recursos do Azure ou por meio do portal. |
subscription
|
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 |
Interrompeu com êxito a instância gerenciada. |
|
202 Accepted |
A interrupção da instância gerenciada está em andamento. |
|
Other Status Codes |
Respostas de erro: ***
|
Exemplos
Stops the managed instance.
Sample Request
POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/stoprg/providers/Microsoft.Sql/managedInstances/mitostop/stop?api-version=2023-08-01-preview
Sample Response
{
"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. |
Freemium |
Clima ou não Instância Gerenciada é freemium. |
Hybrid |
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). |
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 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 inclusivo 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 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. |
Principal |
Tipo principal 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.
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 |
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.
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 |
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 de instância, 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 |
Especifica o ponto no tempo (formato ISO8601) da criação do 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 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 |
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 da 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 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 |
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 |
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úblicos 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 |
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 |
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 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 |
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 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 |
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 |
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 |
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.
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. |