Managed Instances - Stop
Para a instância gerida.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/stop?api-version=2023-08-01-preview
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
managed
|
path | True |
string |
O nome da instância gerida. |
resource
|
path | True |
string |
O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal. |
subscription
|
path | True |
string |
O ID da subscrição que identifica uma subscrição do Azure. |
api-version
|
query | True |
string |
A versão da API a utilizar para o pedido. |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
A instância gerida foi interrompida com êxito. |
|
202 Accepted |
A paragem da instância gerida está em curso. |
|
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
Name | Description |
---|---|
Administrator |
Tipo de administrador de gravidade. |
Auth |
O modo de pesquisa de metadados de autenticação da instância gerida. |
Backup |
O tipo de conta de armazenamento utilizado para armazenar cópias de segurança para esta instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage) |
Error |
Informações adicionais sobre o erro de gestão de recursos. |
Error |
O detalhe do erro. |
Error |
Resposta a erros |
External |
Estado da governação externa. |
Freemium |
A Meteorologia ou não a Instância Gerida é freemium. |
Hybrid |
Utilização secundária híbrida. Os valores possíveis são "Ativo" (valor predefinido) e "Passivo" (o cliente utiliza a secundária como DR Passiva). |
Hybrid |
Utilização secundária híbrida detetada. Os valores possíveis são "Ativo" (o cliente não cumpre os requisitos para utilizar a secundária como DR Passiva) e "Passiva" (o cliente cumpre os requisitos para utilizar a secundária como DR Passiva). |
Identity |
O tipo de identidade. Defina esta opção como "SystemAssigned" para criar e atribuir automaticamente um principal do Azure Active Directory para o recurso. |
Managed |
Uma instância gerida SQL do Azure. |
Managed |
Especifica o formato interno das bases de dados de instância específicas da versão do motor SQL. |
Managed |
Propriedades de um administrador do Active Directory. |
Managed |
O tipo de licença. Os valores possíveis são "LicenseIncluded" (preço normal, incluindo uma nova licença SQL) e "Preço Base" (preço AHB com desconto para trazer as suas próprias licenças SQL). |
Managed |
Uma ligação de ponto final privado numa instância gerida |
Managed |
Propriedades de uma ligação de ponto final privado. |
Managed |
|
Managed |
|
Managed |
Tipo de ligação utilizado para ligar à instância. |
Managed |
Especifica o modo de criação da base de dados. Predefinição: criação de instâncias regulares. Restauro: cria uma instância ao restaurar um conjunto de cópias de segurança para um ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId têm de ser especificados. |
Principal |
Tipo de Principal do administrador de gravidade. |
Provisioning |
Estado de aprovisionamento da instância gerida. |
Resource |
Configuração de identidade do Azure Active Directory para um recurso. |
Service |
A configuração do principal de serviço da instância gerida para um recurso. |
Service |
Tipo de principal de serviço. |
Sku |
Um SKU de Recurso do ARM. |
User |
Configuração de identidade do Azure Active Directory para um recurso. |
AdministratorType
Tipo de administrador de gravidade.
Name | Tipo | Description |
---|---|---|
ActiveDirectory |
string |
AuthMetadataLookupModes
O modo de pesquisa de metadados de autenticação da instância gerida.
Name | Tipo | Description |
---|---|---|
AzureAD |
string |
|
Paired |
string |
|
Windows |
string |
BackupStorageRedundancy
O tipo de conta de armazenamento utilizado para armazenar cópias de segurança para esta instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)
Name | Tipo | Description |
---|---|---|
Geo |
string |
|
GeoZone |
string |
|
Local |
string |
|
Zone |
string |
ErrorAdditionalInfo
Informações adicionais sobre o erro de gestão de recursos.
Name | Tipo | Description |
---|---|---|
info |
object |
As informações adicionais. |
type |
string |
O tipo de informações adicionais. |
ErrorDetail
O detalhe do erro.
Name | 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 a erros
Name | Tipo | Description |
---|---|---|
error |
O objeto de erro. |
ExternalGovernanceStatus
Estado da governação externa.
Name | Tipo | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
FreemiumType
A Meteorologia ou não a Instância Gerida é freemium.
Name | Tipo | Description |
---|---|---|
Freemium |
string |
|
Regular |
string |
HybridSecondaryUsage
Utilização secundária híbrida. Os valores possíveis são "Ativo" (valor predefinido) e "Passivo" (o cliente utiliza a secundária como DR Passiva).
Name | Tipo | Description |
---|---|---|
Active |
string |
|
Passive |
string |
HybridSecondaryUsageDetected
Utilização secundária híbrida detetada. Os valores possíveis são "Ativo" (o cliente não cumpre os requisitos para utilizar a secundária como DR Passiva) e "Passiva" (o cliente cumpre os requisitos para utilizar a secundária como DR Passiva).
Name | Tipo | Description |
---|---|---|
Active |
string |
|
Passive |
string |
IdentityType
O tipo de identidade. Defina esta opção como "SystemAssigned" para criar e atribuir automaticamente um principal do Azure Active Directory para o recurso.
Name | Tipo | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned,UserAssigned |
string |
|
UserAssigned |
string |
ManagedInstance
Uma instância gerida SQL do Azure.
Name | Tipo | Description |
---|---|---|
id |
string |
ID do Recurso. |
identity |
A identidade do Azure Active Directory da instância gerida. |
|
location |
string |
Localização do recurso. |
name |
string |
Nome do recurso. |
properties.administratorLogin |
string |
Nome de utilizador administrador da instância gerida. Só pode ser especificado quando a instância gerida está a ser criada (e é necessária para a criação). |
properties.administratorLoginPassword |
string |
A palavra-passe de início de sessão do administrador (necessária para a criação da instância gerida). |
properties.administrators |
O administrador do Azure Active Directory da instância. Esta ação só pode ser utilizada no momento de criação de instâncias. Se for utilizada para a atualização de instâncias, será ignorada ou resultará num erro. Para atualizações, as APIs individuais terão de ser utilizadas. |
|
properties.authenticationMetadata |
O modo de pesquisa de metadados de autenticação da instância gerida. |
|
properties.collation |
string |
Agrupamento da instância gerida. |
properties.createTime |
string |
Especifica o ponto anterior no tempo (formato ISO8601) da criação da Instância Gerida. |
properties.currentBackupStorageRedundancy |
O tipo de conta de armazenamento utilizado para armazenar cópias de segurança para esta instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage) |
|
properties.databaseFormat |
Especifica o formato interno das bases de dados de instância específicas da versão do motor SQL. |
|
properties.dnsZone |
string |
A Zona DNS na qual se encontra a instância gerida. |
properties.dnsZonePartner |
string |
O ID de recurso de outra instância gerida cuja zona DNS esta instância gerida irá partilhar após a criação. |
properties.externalGovernanceStatus |
Estado da governação externa. |
|
properties.fullyQualifiedDomainName |
string |
O nome de domínio completamente qualificado da instância gerida. |
properties.hybridSecondaryUsage |
Utilização secundária híbrida. Os valores possíveis são "Ativo" (valor predefinido) e "Passivo" (o cliente utiliza a secundária como DR Passiva). |
|
properties.hybridSecondaryUsageDetected |
Utilização secundária híbrida detetada. Os valores possíveis são "Ativo" (o cliente não cumpre os requisitos para utilizar a secundária como DR Passiva) e "Passiva" (o cliente cumpre os requisitos para utilizar a secundária como DR Passiva). |
|
properties.instancePoolId |
string |
O ID do conjunto de instâncias a que este servidor gerido pertence. |
properties.isGeneralPurposeV2 |
boolean |
Quer esta seja ou não uma variante GPv2 da edição Fins Gerais. |
properties.keyId |
string |
Um URI CMK da chave a utilizar para encriptação. |
properties.licenseType |
O tipo de licença. Os valores possíveis são "LicenseIncluded" (preço normal, incluindo uma nova licença SQL) e "Preço Base" (preço AHB com desconto para trazer as suas próprias licenças SQL). |
|
properties.maintenanceConfigurationId |
string |
Especifica o ID de configuração de manutenção a aplicar a esta instância gerida. |
properties.managedInstanceCreateMode |
Especifica o modo de criação da base de dados. Predefinição: criação de instâncias regulares. Restauro: cria uma instância ao restaurar um conjunto de cópias de segurança para um ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId têm de ser especificados. |
|
properties.minimalTlsVersion |
string |
Versão mínima do TLS. Valores permitidos: "None", "1.0", "1.1", "1.2" |
properties.pricingModel |
A Meteorologia ou não a Instância Gerida é freemium. |
|
properties.primaryUserAssignedIdentityId |
string |
O ID de recurso de uma identidade atribuída pelo utilizador a utilizar por predefinição. |
properties.privateEndpointConnections |
Lista de ligações de ponto final privado numa instância gerida. |
|
properties.provisioningState |
Estado de aprovisionamento da instância gerida. |
|
properties.proxyOverride |
Tipo de ligação utilizado para ligar à instância. |
|
properties.publicDataEndpointEnabled |
boolean |
Se o ponto final de dados públicos está ou não ativado. |
properties.requestedBackupStorageRedundancy |
O tipo de conta de armazenamento a ser utilizado para armazenar cópias de segurança para esta instância. As opções são Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage) |
|
properties.restorePointInTime |
string |
Especifica o ponto anterior no tempo (ISO8601 formato) da base de dados de origem que será restaurada para criar a nova base de dados. |
properties.servicePrincipal |
O principal de serviço da instância gerida. |
|
properties.sourceManagedInstanceId |
string |
O identificador de recurso da instância gerida de origem associada à operação de criação desta instância. |
properties.state |
string |
O estado da instância gerida. |
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 |
O parâmetro MBps de débito de armazenamento não é suportado na operação de criação/atualização de instâncias. |
properties.subnetId |
string |
ID de recurso da sub-rede para a instância gerida. |
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 os fusos horários suportados, incluindo o ID, no registo em KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Pode obter esses valores de registo através de SQL Server consultando SELECT name AS timezone_id FROM sys.time_zone_info. A lista de IDs também pode ser obtida ao executar [System.TimeZoneInfo]::GetSystemTimeZones() no PowerShell. Um exemplo de id de fuso horário válido é "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 de recurso do cluster virtual para a Instância Gerida. |
properties.zoneRedundant |
boolean |
Se o multi-az está ou não ativado. |
sku |
SKU da instância gerida. Valores permitidos para sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH |
|
tags |
object |
Etiquetas de recursos. |
type |
string |
Tipo de recurso. |
ManagedInstanceDatabaseFormat
Especifica o formato interno das bases de dados de instância específicas da versão do motor SQL.
Name | Tipo | Description |
---|---|---|
AlwaysUpToDate |
string |
|
SQLServer2022 |
string |
ManagedInstanceExternalAdministrator
Propriedades de um administrador do Active Directory.
Name | Tipo | Description |
---|---|---|
administratorType |
Tipo de administrador de gravidade. |
|
azureADOnlyAuthentication |
boolean |
Apenas a Autenticação do Azure Active Directory está ativada. |
login |
string |
Nome de início de sessão do administrador do servidor. |
principalType |
Tipo de Principal do administrador de gravidade. |
|
sid |
string |
SID (ID de objeto) do administrador do servidor. |
tenantId |
string |
ID do inquilino 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 "Preço Base" (preço AHB com desconto para trazer as suas próprias licenças SQL).
Name | Tipo | Description |
---|---|---|
BasePrice |
string |
|
LicenseIncluded |
string |
ManagedInstancePecProperty
Uma ligação de ponto final privado numa instância gerida
Name | Tipo | Description |
---|---|---|
id |
string |
ID do Recurso. |
properties |
Propriedades de ligação de ponto final privado |
ManagedInstancePrivateEndpointConnectionProperties
Propriedades de uma ligação de ponto final privado.
Name | Tipo | Description |
---|---|---|
privateEndpoint |
Ponto final privado ao qual pertence a ligação. |
|
privateLinkServiceConnectionState |
Estado de Ligação da Ligação de Ponto Final Privado. |
|
provisioningState |
string |
Estado da Ligação de Ponto Final Privado. |
ManagedInstancePrivateEndpointProperty
Name | Tipo | Description |
---|---|---|
id |
string |
ID do recurso do ponto final privado. |
ManagedInstancePrivateLinkServiceConnectionStateProperty
Name | Tipo | Description |
---|---|---|
actionsRequired |
string |
A descrição da ligação do serviço de ligação privada. |
description |
string |
A descrição da ligação do serviço de ligação privada. |
status |
string |
O estado da ligação do serviço de ligação privada. |
ManagedInstanceProxyOverride
Tipo de ligação utilizado para ligar à instância.
Name | Tipo | Description |
---|---|---|
Default |
string |
|
Proxy |
string |
|
Redirect |
string |
ManagedServerCreateMode
Especifica o modo de criação da base de dados.
Predefinição: criação de instâncias regulares.
Restauro: cria uma instância ao restaurar um conjunto de cópias de segurança para um ponto específico no tempo. RestorePointInTime e SourceManagedInstanceId têm de ser especificados.
Name | Tipo | Description |
---|---|---|
Default |
string |
|
PointInTimeRestore |
string |
PrincipalType
Tipo de Principal do administrador de gravidade.
Name | Tipo | Description |
---|---|---|
Application |
string |
|
Group |
string |
|
User |
string |
ProvisioningState
Estado de aprovisionamento da instância gerida.
Name | Tipo | Description |
---|---|---|
Canceled |
string |
|
Created |
string |
|
Failed |
string |
|
InProgress |
string |
|
Succeeded |
string |
ResourceIdentity
Configuração de identidade do Azure Active Directory para um recurso.
Name | Tipo | Description |
---|---|---|
principalId |
string |
O ID principal do Azure Active Directory. |
tenantId |
string |
O ID de inquilino do Azure Active Directory. |
type |
O tipo de identidade. Defina esta opção como "SystemAssigned" para criar e atribuir automaticamente um principal do Azure Active Directory para o recurso. |
|
userAssignedIdentities |
<string,
User |
Os IDs de recursos das identidades atribuídas pelo utilizador a utilizar |
ServicePrincipal
A configuração do principal de serviço da instância gerida para um recurso.
Name | Tipo | Description |
---|---|---|
clientId |
string |
O ID de cliente da aplicação do Azure Active Directory. |
principalId |
string |
O ID de objeto da aplicação do Azure Active Directory. |
tenantId |
string |
O ID de inquilino do Azure Active Directory. |
type |
Tipo de principal de serviço. |
ServicePrincipalType
Tipo de principal de serviço.
Name | Tipo | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
Sku
Um SKU de Recurso do ARM.
Name | Tipo | Description |
---|---|---|
capacity |
integer |
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 de número, por exemplo, P3. |
size |
string |
Tamanho do SKU específico |
tier |
string |
O escalão ou edição do SKU específico, por exemplo, Básico, Premium. |
UserIdentity
Configuração de identidade do Azure Active Directory para um recurso.
Name | Tipo | Description |
---|---|---|
clientId |
string |
O ID de cliente do Azure Active Directory. |
principalId |
string |
O ID principal do Azure Active Directory. |