Managed Instances - Stop

Service:

SQL Database

API Version:

2023-08-01-preview

Zastaví spravovanou instanci.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
managedInstanceName	path	True	string	Název spravované instance.
resourceGroupName	path	True	string	Název skupiny prostředků, která prostředek obsahuje. Tuto hodnotu můžete získat z rozhraní API Resource Manager Azure nebo z portálu.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.

Odpovědi

Name	Typ	Description
200 OK	ManagedInstance	Spravovaná instance se úspěšně zastavila.
202 Accepted		Zastavuje se spravovaná instance.
Other Status Codes	ErrorResponse	Chybové odpovědi: *** 400 ManagementServiceStopManagedInstanceZoneRedundant – zastavení spuštění v instanci s povolenou zónovou redundancí. 400 ManagementServiceStopManagedInstancePartOfFailoverGroup – zastavení spuštění v instanci, která je součástí skupiny převzetí služeb při selhání. 400 NameAlreadyExists – zadaný název již existuje. 400 ManagementServiceStartStopManagedInstanceSubscriptionNotEnabledForFeature – uživatel se pokusil použít funkci Start/Stop, aniž by měl předplatné v seznamu povolených pro příslušnou funkci předplatného. 400 ManagementServiceStopManagedInstanceNotSupportedOnSKU – U dané skladové položky se nepodporuje operace zastavení. 400 InvalidServerName – zadaný neplatný název serveru. 400 StartStopOfManagedInstanceIsDisabled – Operace spuštění a zastavení ve spravované instanci není povolená. 400 InvalidIdentifier – identifikátor obsahuje hodnotu NULL nebo neplatný znak unicode. 400 ManagementServiceStopManagedInstanceUsingMILink – zastavení spuštění u instance, která má nakonfigurovanou službu Managed Instance Link. 400 ManagementServiceStopManagedInstanceFeatureDisabled – uživatel se pokusil použít funkci Zastavit Azure SQL Managed Instance, která je zakázaná. 400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform – zastavení spuštění v instanci, která není spuštěná s funkcí Wave v listopadu 2022 404 ServerNotInSubscriptionResourceGroup – zadaný server v zadané skupině prostředků a předplatném neexistuje. 404 SubscriptionDoesNotHaveServer – Požadovaný server se nenašel. 404 OperationIdNotFound – operace s ID neexistuje. 404 ResourceNotFound – Požadovaný prostředek se nenašel. 404 OperationIdNotFound – operace s ID neexistuje. 409 ManagementServiceStopManagedInstanceAlreadyInProgress – operace zastavení odeslaná pro operaci, která je ve stavu zastavení/zastavení. 409 ManagementServiceStopManagedInstanceConflictingOperation – Zastavení Azure SQL Managed Instance zprávy o konfliktní operaci. 409 ManagementServiceStopManagedInstanceDroppedDuringStop – zastavení spuštění u instance, která je mezitím ve stavu odstraňování nebo je odebraná. 409 SubscriptionDisabled – Předplatné je zakázané. 409 CannotCancelOperation – operace správy je ve stavu, který nelze zrušit. 409 OperationCancelled – operace byla zrušena uživatelem. 409 OperationInterrupted – Operaci s prostředkem nebylo možné dokončit, protože byla přerušena jinou operací se stejným prostředkem. 429 SubscriptionTooManyCreateUpdateRequests – požadavky nad maximální počet požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 500 OperationTimedOut – časový limit operace vypršel a automaticky se vrátila zpět. Opakujte operaci. 503 TooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky.

Příklady

Stops the managed instance.

Sample Request

HTTP

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

Status code:

200

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

Status code:

202

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

Definice

Name	Description
AdministratorType	Typ správce serveru.
AuthMetadataLookupModes	Režim vyhledávání metadat ověřování spravované instance
BackupStorageRedundancy	Typ účtu úložiště, který slouží k ukládání záloh pro tuto instanci. Možnosti jsou Místní (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) a GeoZone(GeoZoneRedundantStorage).
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě
ErrorResponse	Odpověď na chybu
ExternalGovernanceStatus	Stav externích zásad správného řízení
FreemiumType	Spravovaná instance o počasí nebo ne je freemium.
HybridSecondaryUsage	Hybridní sekundární využití. Možné hodnoty jsou Aktivní (výchozí hodnota) a Pasivní (zákazník používá sekundární hodnotu jako pasivní zotavení po havárii).
HybridSecondaryUsageDetected	Zjistilo se hybridní sekundární využití. Možné hodnoty jsou Aktivní (zákazník nesplňuje požadavky na použití sekundární jako pasivní zotavení po havárii) a Pasivní (zákazník splňuje požadavky na použití sekundární jako pasivní zotavení po havárii).
IdentityType	Typ identity. Tuto možnost nastavte na SystemAssigned, aby se pro prostředek automaticky vytvořil a přiřadil objekt zabezpečení Služby Azure Active Directory.
ManagedInstance	Spravovaná instance Azure SQL.
ManagedInstanceDatabaseFormat	Určuje interní formát databáze instance specifické pro verzi modulu SQL.
ManagedInstanceExternalAdministrator	Vlastnosti správce služby Active Directory.
ManagedInstanceLicenseType	Typ licence. Možné hodnoty jsou LicenseIncluded (běžná cena včetně nové licence SQL) a BasePrice (zvýhodněná cena AHB za používání vlastních licencí SQL).
ManagedInstancePecProperty	Připojení privátního koncového bodu ve spravované instanci
ManagedInstancePrivateEndpointConnectionProperties	Vlastnosti připojení privátního koncového bodu.
ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride	Typ připojení použitý pro připojení k instanci.
ManagedServerCreateMode	Určuje režim vytváření databáze. Výchozí: Pravidelné vytváření instancí. Obnovení: Vytvoří instanci obnovením sady záloh k určitému bodu v čase. Musí být zadány hodnoty RestorePointInTime a SourceManagedInstanceId.
PrincipalType	Typ objektu zabezpečení správce serveru.
ProvisioningState	Stav zřizování spravované instance
ResourceIdentity	Konfigurace identity Azure Active Directory pro prostředek
ServicePrincipal	Konfigurace instančního objektu spravované instance pro prostředek.
ServicePrincipalType	Typ instančního objektu.
Sku	Skladová položka prostředku ARM.
UserIdentity	Konfigurace identity Azure Active Directory pro prostředek

AdministratorType

Typ správce serveru.

Name	Typ	Description
ActiveDirectory	string

AuthMetadataLookupModes

Režim vyhledávání metadat ověřování spravované instance

Name	Typ	Description
AzureAD	string
Paired	string
Windows	string

BackupStorageRedundancy

Typ účtu úložiště, který slouží k ukládání záloh pro tuto instanci. Možnosti jsou Místní (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) a GeoZone(GeoZoneRedundantStorage).

Name	Typ	Description
Geo	string
GeoZone	string
Local	string
Zone	string

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Typ další informace.

ErrorDetail

Podrobnosti o chybě

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva
target	string	Cíl chyby.

ErrorResponse

Odpověď na chybu

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

ExternalGovernanceStatus

Stav externích zásad správného řízení

Name	Typ	Description
Disabled	string
Enabled	string

FreemiumType

Spravovaná instance o počasí nebo ne je freemium.

Name	Typ	Description
Freemium	string
Regular	string

HybridSecondaryUsage

Hybridní sekundární využití. Možné hodnoty jsou Aktivní (výchozí hodnota) a Pasivní (zákazník používá sekundární hodnotu jako pasivní zotavení po havárii).

Name	Typ	Description
Active	string
Passive	string

HybridSecondaryUsageDetected

Zjistilo se hybridní sekundární využití. Možné hodnoty jsou Aktivní (zákazník nesplňuje požadavky na použití sekundární jako pasivní zotavení po havárii) a Pasivní (zákazník splňuje požadavky na použití sekundární jako pasivní zotavení po havárii).

Name	Typ	Description
Active	string
Passive	string

IdentityType

Typ identity. Tuto možnost nastavte na SystemAssigned, aby se pro prostředek automaticky vytvořil a přiřadil objekt zabezpečení Služby Azure Active Directory.

Name	Typ	Description
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

ManagedInstance

Spravovaná instance Azure SQL.

Name	Typ	Description
id	string	ID prostředku.
identity	ResourceIdentity	Identita Azure Active Directory spravované instance.
location	string	Umístění prostředku.
name	string	Název prostředku.
properties.administratorLogin	string	Uživatelské jméno správce pro spravovanou instanci Lze zadat pouze v případě, že se spravovaná instance vytváří (a vyžaduje se k vytvoření).
properties.administratorLoginPassword	string	Přihlašovací heslo správce (vyžadované pro vytvoření spravované instance)
properties.administrators	ManagedInstanceExternalAdministrator	Správce instance Azure Active Directory. Tuto možnost lze použít pouze v době vytvoření instance. Pokud se použije pro aktualizaci instance, bude ignorována nebo výsledkem bude chyba. Pro aktualizace bude potřeba použít jednotlivá rozhraní API.
properties.authenticationMetadata	AuthMetadataLookupModes	Režim vyhledávání metadat ověřování spravované instance
properties.collation	string	Kolace spravované instance.
properties.createTime	string	Určuje bod v čase (formát ISO8601) vytvoření spravované instance.
properties.currentBackupStorageRedundancy	BackupStorageRedundancy	Typ účtu úložiště, který se používá k ukládání záloh pro tuto instanci. Možnosti jsou Místní (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) a GeoZone(GeoZoneRedundantStorage).
properties.databaseFormat	ManagedInstanceDatabaseFormat	Určuje interní formát databází instancí specifických pro verzi modulu SQL.
properties.dnsZone	string	Zóna DNS, ve které se spravovaná instance nachází.
properties.dnsZonePartner	string	ID prostředku jiné spravované instance, jejíž zónu DNS bude tato spravovaná instance po vytvoření sdílet.
properties.externalGovernanceStatus	ExternalGovernanceStatus	Stav externích zásad správného řízení
properties.fullyQualifiedDomainName	string	Plně kvalifikovaný název domény spravované instance.
properties.hybridSecondaryUsage	HybridSecondaryUsage	Hybridní sekundární využití. Možné hodnoty jsou Aktivní (výchozí hodnota) a Pasivní (zákazník používá sekundární hodnotu jako pasivní zotavení po havárii).
properties.hybridSecondaryUsageDetected	HybridSecondaryUsageDetected	Zjistilo se hybridní sekundární využití. Možné hodnoty jsou Aktivní (zákazník nesplňuje požadavky na použití sekundární jako pasivní zotavení po havárii) a Pasivní (zákazník splňuje požadavky na použití sekundární jako pasivní zotavení po havárii).
properties.instancePoolId	string	ID fondu instancí, do který tento spravovaný server patří.
properties.isGeneralPurposeV2	boolean	Zda se jedná o variantu GPv2 Pro obecné účely edice.
properties.keyId	string	Identifikátor URI CMK klíče, který se má použít k šifrování.
properties.licenseType	ManagedInstanceLicenseType	Typ licence. Možné hodnoty jsou LicenseIncluded (běžná cena včetně nové licence SQL) a BasePrice (zvýhodněná cena AHB za používání vlastních licencí SQL).
properties.maintenanceConfigurationId	string	Určuje ID konfigurace údržby, které se má použít pro tuto spravovanou instanci.
properties.managedInstanceCreateMode	ManagedServerCreateMode	Určuje režim vytváření databáze. Výchozí: Pravidelné vytváření instancí. Obnovení: Vytvoří instanci obnovením sady záloh do konkrétního bodu v čase. Musí být zadány RestorePointInTime a SourceManagedInstanceId.
properties.minimalTlsVersion	string	Minimální verze protokolu TLS. Povolené hodnoty: 'None', '1.0', '1.1', '1.2'
properties.pricingModel	FreemiumType	Počasí nebo ne spravovaná instance je freemium.
properties.primaryUserAssignedIdentityId	string	ID prostředku identity přiřazené uživatelem, které se má použít ve výchozím nastavení.
properties.privateEndpointConnections	ManagedInstancePecProperty[]	Seznam připojení privátních koncových bodů ve spravované instanci
properties.provisioningState	ProvisioningState	Stav zřizování spravované instance
properties.proxyOverride	ManagedInstanceProxyOverride	Typ připojení použitý pro připojení k instanci.
properties.publicDataEndpointEnabled	boolean	Určuje, jestli je povolený veřejný datový koncový bod.
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Typ účtu úložiště, který se má použít k ukládání záloh pro tuto instanci. Možnosti jsou Místní (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) a GeoZone(GeoZoneRedundantStorage).
properties.restorePointInTime	string	Určuje bod v čase (ISO8601 formát) zdrojové databáze, která se obnoví za účelem vytvoření nové databáze.
properties.servicePrincipal	ServicePrincipal	Instanční objekt spravované instance.
properties.sourceManagedInstanceId	string	Identifikátor prostředku zdrojové spravované instance přidružené k operaci vytvoření této instance.
properties.state	string	Stav spravované instance.
properties.storageIOps	integer	IOps úložiště. Minimální hodnota: 300. Maximální hodnota: 80000. Jsou povoleny pouze přírůstky po 1 vstupně-výstupních operacích. Maximální hodnota závisí na vybrané řadě hardwaru a počtu virtuálních jader.
properties.storageSizeInGB	integer	Velikost úložiště v GB. Minimální hodnota: 32. Maximální hodnota: 16384. Jsou povoleny pouze přírůstky o velikosti 32 GB. Maximální hodnota závisí na vybrané řadě hardwaru a počtu virtuálních jader.
properties.storageThroughputMBps	integer	Parametr mb/s propustnosti úložiště se v operaci vytvoření/aktualizace instance nepodporuje.
properties.subnetId	string	ID prostředku podsítě pro spravovanou instanci
properties.timezoneId	string	ID časového pásma. Povolené hodnoty jsou časová pásma podporovaná systémem Windows. Systém Windows uchovává podrobnosti o podporovaných časových pásmech, včetně ID, v registru v KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\systém Windows NT\CurrentVersion\Time Zones. Tyto hodnoty registru můžete získat prostřednictvím SQL Server dotazem na název SELECT AS timezone_id FROM sys.time_zone_info. Seznam ID můžete také získat spuštěním příkazu [System.TimeZoneInfo]::GetSystemTimeZones() v PowerShellu. Příkladem platného ID časového pásma je "Tichomoří (běžný čas) nebo "W". Evropa (běžný čas).
properties.totalMemoryMB	integer	Celková paměť v MB. Minimální hodnota: 7168. Maximální hodnota: 891328. Jsou povoleny pouze přírůstky po 1 MB. Maximální hodnota závisí na vybrané řadě hardwaru a počtu virtuálních jader.
properties.vCores	integer	Počet virtuálních jader. Povolené hodnoty: 8, 16, 24, 32, 40, 64, 80.
properties.virtualClusterId	string	ID prostředku virtuálního clusteru pro spravovanou instanci
properties.zoneRedundant	boolean	Určuje, jestli je povolený multi-az.
sku	Sku	Skladová položka spravované instance. Povolené hodnoty pro sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH
tags	object	Značky prostředků.
type	string	Typ prostředku.

ManagedInstanceDatabaseFormat

Určuje interní formát databáze instance specifické pro verzi modulu SQL.

Name	Typ	Description
AlwaysUpToDate	string
SQLServer2022	string

ManagedInstanceExternalAdministrator

Vlastnosti správce služby Active Directory.

Name	Typ	Description
administratorType	AdministratorType	Typ správce serveru.
azureADOnlyAuthentication	boolean	Povolené ověřování pouze v Azure Active Directory.
login	string	Přihlašovací jméno správce serveru.
principalType	PrincipalType	Typ objektu zabezpečení správce serveru.
sid	string	IDENTIFIKÁTOR SID (ID objektu) správce serveru.
tenantId	string	ID tenanta správce.

ManagedInstanceLicenseType

Typ licence. Možné hodnoty jsou LicenseIncluded (běžná cena včetně nové licence SQL) a BasePrice (zvýhodněná cena AHB za používání vlastních licencí SQL).

Name	Typ	Description
BasePrice	string
LicenseIncluded	string

ManagedInstancePecProperty

Připojení privátního koncového bodu ve spravované instanci

Name	Typ	Description
id	string	ID prostředku.
properties	ManagedInstancePrivateEndpointConnectionProperties	Vlastnosti připojení privátního koncového bodu

ManagedInstancePrivateEndpointConnectionProperties

Vlastnosti připojení privátního koncového bodu.

Name	Typ	Description
privateEndpoint	ManagedInstancePrivateEndpointProperty	Privátní koncový bod, ke kterému připojení patří.
privateLinkServiceConnectionState	ManagedInstancePrivateLinkServiceConnectionStateProperty	Stav připojení privátního koncového bodu.
provisioningState	string	Stav připojení privátního koncového bodu.

ManagedInstancePrivateEndpointProperty

Name	Typ	Description
id	string	ID prostředku privátního koncového bodu

ManagedInstancePrivateLinkServiceConnectionStateProperty

Name	Typ	Description
actionsRequired	string	Popis připojení služby Private Link.
description	string	Popis připojení služby Private Link.
status	string	Stav připojení služby Private Link.

ManagedInstanceProxyOverride

Typ připojení použitý pro připojení k instanci.

Name	Typ	Description
Default	string
Proxy	string
Redirect	string

ManagedServerCreateMode

Určuje režim vytváření databáze.

Výchozí: Pravidelné vytváření instancí.

Obnovení: Vytvoří instanci obnovením sady záloh k určitému bodu v čase. Musí být zadány hodnoty RestorePointInTime a SourceManagedInstanceId.

Name	Typ	Description
Default	string
PointInTimeRestore	string

PrincipalType

Typ objektu zabezpečení správce serveru.

Name	Typ	Description
Application	string
Group	string
User	string

ProvisioningState

Stav zřizování spravované instance

Name	Typ	Description
Canceled	string
Created	string
Failed	string
InProgress	string
Succeeded	string

ResourceIdentity

Konfigurace identity Azure Active Directory pro prostředek

Name	Typ	Description
principalId	string	ID objektu zabezpečení Služby Azure Active Directory.
tenantId	string	ID tenanta Azure Active Directory
type	IdentityType	Typ identity. Tuto možnost nastavte na SystemAssigned, aby se k prostředku automaticky vytvořil a přiřadil objekt zabezpečení Azure Active Directory.
userAssignedIdentities	<string,  UserIdentity>	ID prostředků identit přiřazených uživatelem, které se mají použít

ServicePrincipal

Konfigurace instančního objektu spravované instance pro prostředek.

Name	Typ	Description
clientId	string	ID klienta aplikace Azure Active Directory.
principalId	string	ID objektu aplikace Azure Active Directory.
tenantId	string	ID tenanta Azure Active Directory.
type	ServicePrincipalType	Typ instančního objektu.

ServicePrincipalType

Typ instančního objektu.

Name	Typ	Description
None	string
SystemAssigned	string

Sku

Skladová položka prostředku ARM.

Name	Typ	Description
capacity	integer	Kapacita konkrétní skladové položky.
family	string	Pokud má služba různé generace hardwaru, pro stejnou skladovou položku, můžete to tady zaznamenat.
name	string	Název skladové položky, obvykle písmeno + číselný kód, např. P3.
size	string	Velikost konkrétní skladové položky
tier	string	Úroveň nebo edice konkrétní skladové položky, například Basic, Premium.

UserIdentity

Konfigurace identity Azure Active Directory pro prostředek

Name	Typ	Description
clientId	string	ID klienta Azure Active Directory.
principalId	string	ID objektu zabezpečení Azure Active Directory.