Managed Instances - Stop

Tjänst:

SQL Database

API-version:

2023-08-01-preview

Stoppar den hanterade instansen.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
managedInstanceName	path	True	string	Namnet på den hanterade instansen.
resourceGroupName	path	True	string	Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.
subscriptionId	path	True	string	Det prenumerations-ID som identifierar en Azure-prenumeration.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Svar

Name	Typ	Description
200 OK	ManagedInstance	Den hanterade instansen har stoppats.
202 Accepted		Den hanterade instansen stoppas.
Other Status Codes	ErrorResponse	Felsvar: *** 400 ManagementServiceStopManagedInstanceZoneRedundant – Stoppa körs på en instans med zonredundans aktiverat. 400 ManagementServiceStopManagedInstancePartOfFailoverGroup – Stoppa körs på den instans som ingår i redundansgruppen. 400 NameAlreadyExists – Det angivna namnet finns redan. 400 ManagementServiceStartStopManagedInstanceSubscriptionNotEnabledForFeature – Användaren försökte använda funktionen Start/Stop utan att ha prenumerationen tillåten för lämplig prenumerationsfunktion. 400 ManagementServiceStopManagedInstanceNotSupportedOnSKU – Stoppåtgärden stöds inte på den angivna SKU:n. 400 InvalidServerName – Ogiltigt servernamn har angetts. 400 StartStopOfManagedInstanceIsDisabled – Start- och stoppåtgärden på den hanterade instansen är inte aktiverad. 400 InvalidIdentifier – identifieraren innehåller NULL eller ett ogiltigt unicode-tecken. 400 ManagementServiceStopManagedInstanceUsingMILink – Stoppa körs på den instans som har en konfigurerad länk för hanterad instans. 400 ManagementServiceStopManagedInstanceFeatureDisabled – Användaren försökte använda funktionen Stoppa Azure SQL Managed Instance, som är inaktiverad. 400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform – Stoppa körs på den instans som inte körs med Funktionsvåg november 2022 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen. 404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte 404 OperationIdNotFound – åtgärden med ID finns inte. 404 ResourceNotFound – Den begärda resursen hittades inte. 404 OperationIdNotFound – åtgärden med ID finns inte. 409 ManagementServiceStopManagedInstanceAlreadyInProgress – Stoppa åtgärd som skickats för en åtgärd som är i stopp-/stopptillstånd. 409 ManagementServiceStopManagedInstanceConflictingOperation – Stoppa Azure SQL Managed Instance motstridiga åtgärdsmeddelande. 409 ManagementServiceStopManagedInstanceDroppedDuringStop – Stoppa körs på en instans som är i borttagningstillstånd eller tas bort under tiden. 409 SubscriptionDisabled – Prenumerationen är inaktiverad. 409 CannotCancelOperation – hanteringsåtgärden är i ett tillstånd som inte kan avbrytas. 409 OperationCancelled – Åtgärden har avbrutits av användaren. 409 OperationInterrupted – Det gick inte att slutföra åtgärden på resursen eftersom den avbröts av en annan åtgärd på samma resurs. 429 SubscriptionTooManyCreateUpdateRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 500 OperationTimedOut – Tidsgränsen för åtgärden uppnåddes och återställdes automatiskt. Försök att utföra åtgärden igen. 503 TooManyRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

Exempel

Stops the managed instance.

Exempelbegäran

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

Exempelsvar

Statuskod:

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

Statuskod:

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

Definitioner

Name	Description
AdministratorType	Typ av serveradministratör.
AuthMetadataLookupModes	Den hanterade instansens uppslagsläge för autentiseringsmetadata.
BackupStorageRedundancy	Den typ av lagringskonto som används för att lagra säkerhetskopior för den här instansen. Alternativen är Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) och GeoZone(GeoZoneRedundantStorage)
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
ExternalGovernanceStatus	Status för extern styrning.
FreemiumType	Väder eller inte Hanterad instans är freemium.
HybridSecondaryUsage	Sekundär hybridanvändning. Möjliga värden är "Aktiv" (standardvärde) och "Passiv" (kunden använder den sekundära som passiv DR).
HybridSecondaryUsageDetected	Hybridens sekundära användning har identifierats. Möjliga värden är "Aktiv" (kunden uppfyller inte kraven för att använda den sekundära som passiv DR) och "Passiv" (kunden uppfyller kraven för att använda den sekundära som passiv DR).
IdentityType	Identitetstypen. Ange "SystemAssigned" (SystemAssigned) för att automatiskt skapa och tilldela ett Azure Active Directory-huvudnamn för resursen.
ManagedInstance	En Azure SQL hanterad instans.
ManagedInstanceDatabaseFormat	Anger det interna formatet för instansdatabaser som är specifika för SQL-motorns version.
ManagedInstanceExternalAdministrator	Egenskaper för en Active Directory-administratör.
ManagedInstanceLicenseType	Licenstypen. Möjliga värden är "LicenseIncluded" (vanligt pris inklusive en ny SQL-licens) och "BasePrice" (rabatterat AHB-pris för att ta med dina egna SQL-licenser).
ManagedInstancePecProperty	En privat slutpunktsanslutning under en hanterad instans
ManagedInstancePrivateEndpointConnectionProperties	Egenskaper för en privat slutpunktsanslutning.
ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride	Anslutningstyp som används för att ansluta till instansen.
ManagedServerCreateMode	Anger läget för att skapa databasen. Standard: Skapande av vanlig instans. Återställning: Skapar en instans genom att återställa en uppsättning säkerhetskopior till en viss tidpunkt. RestorePointInTime och SourceManagedInstanceId måste anges.
PrincipalType	Huvudtyp för serveradministratören.
ProvisioningState	Etableringstillstånd för hanterad instans.
ResourceIdentity	Azure Active Directory-identitetskonfiguration för en resurs.
ServicePrincipal	Den hanterade instansens konfiguration av tjänstens huvudnamn för en resurs.
ServicePrincipalType	Tjänstens huvudnamnstyp.
Sku	En ARM-resurs-SKU.
UserIdentity	Azure Active Directory-identitetskonfiguration för en resurs.

AdministratorType

Typ av serveradministratör.

Name	Typ	Description
ActiveDirectory	string

AuthMetadataLookupModes

Den hanterade instansens uppslagsläge för autentiseringsmetadata.

Name	Typ	Description
AzureAD	string
Paired	string
Windows	string

BackupStorageRedundancy

Den typ av lagringskonto som används för att lagra säkerhetskopior för den här instansen. Alternativen är Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) och GeoZone(GeoZoneRedundantStorage)

Name	Typ	Description
Geo	string
GeoZone	string
Local	string
Zone	string

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Den ytterligare informationen.
type	string	Ytterligare informationstyp.

ErrorDetail

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

ExternalGovernanceStatus

Status för extern styrning.

Name	Typ	Description
Disabled	string
Enabled	string

FreemiumType

Väder eller inte Hanterad instans är freemium.

Name	Typ	Description
Freemium	string
Regular	string

HybridSecondaryUsage

Sekundär hybridanvändning. Möjliga värden är "Aktiv" (standardvärde) och "Passiv" (kunden använder den sekundära som passiv DR).

Name	Typ	Description
Active	string
Passive	string

HybridSecondaryUsageDetected

Hybridens sekundära användning har identifierats. Möjliga värden är "Aktiv" (kunden uppfyller inte kraven för att använda den sekundära som passiv DR) och "Passiv" (kunden uppfyller kraven för att använda den sekundära som passiv DR).

Name	Typ	Description
Active	string
Passive	string

IdentityType

Identitetstypen. Ange "SystemAssigned" (SystemAssigned) för att automatiskt skapa och tilldela ett Azure Active Directory-huvudnamn för resursen.

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

ManagedInstance

En Azure SQL hanterad instans.

Name	Typ	Description
id	string	Resurs-ID.
identity	ResourceIdentity	Azure Active Directory-identiteten för den hanterade instansen.
location	string	Resursplats.
name	string	Resursnamn.
properties.administratorLogin	string	Administratörsanvändarnamn för den hanterade instansen. Kan bara anges när den hanterade instansen skapas (och krävs för att skapa).
properties.administratorLoginPassword	string	Administratörens inloggningslösenord (krävs för att skapa hanterade instanser).
properties.administrators	ManagedInstanceExternalAdministrator	Azure Active Directory-administratören för instansen. Detta kan endast användas när instansen skapas. Om det används för instansuppdatering ignoreras det eller så resulterar det i ett fel. För uppdateringar måste enskilda API:er användas.
properties.authenticationMetadata	AuthMetadataLookupModes	Den hanterade instansens uppslagsläge för autentiseringsmetadata.
properties.collation	string	Sortering av den hanterade instansen.
properties.createTime	string	Anger tidpunkten (ISO8601 format) för skapandet av den hanterade instansen.
properties.currentBackupStorageRedundancy	BackupStorageRedundancy	Lagringskontotypen som används för att lagra säkerhetskopior för den här instansen. Alternativen är Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) och GeoZone(GeoZoneRedundantStorage)
properties.databaseFormat	ManagedInstanceDatabaseFormat	Anger det interna formatet för instansdatabaser som är specifika för SQL-motorversionen.
properties.dnsZone	string	Dns-zonen som den hanterade instansen finns i.
properties.dnsZonePartner	string	Resurs-ID för en annan hanterad instans vars DNS-zon den här hanterade instansen kommer att dela när den har skapats.
properties.externalGovernanceStatus	ExternalGovernanceStatus	Status för extern styrning.
properties.fullyQualifiedDomainName	string	Det fullständigt kvalificerade domännamnet för den hanterade instansen.
properties.hybridSecondaryUsage	HybridSecondaryUsage	Sekundär hybridanvändning. Möjliga värden är "Aktiv" (standardvärde) och "Passiv" (kunden använder den sekundära som passiv DR).
properties.hybridSecondaryUsageDetected	HybridSecondaryUsageDetected	Den sekundära hybridanvändningen har identifierats. Möjliga värden är "Aktiva" (kunden uppfyller inte kraven för att använda den sekundära som passiv DR) och "Passiv" (kunden uppfyller kraven för att använda den sekundära som passiv DR).
properties.instancePoolId	string	ID:t för instanspoolen som den hanterade servern tillhör.
properties.isGeneralPurposeV2	boolean	Oavsett om detta är en GPv2-variant av Generell användning edition.
properties.keyId	string	En CMK-URI för nyckeln som ska användas för kryptering.
properties.licenseType	ManagedInstanceLicenseType	Licenstypen. Möjliga värden är "LicenseIncluded" (vanligt pris inklusive en ny SQL-licens) och "BasePrice" (rabatterat AHB-pris för att ta med egna SQL-licenser).
properties.maintenanceConfigurationId	string	Anger underhållskonfigurations-ID som ska tillämpas på den här hanterade instansen.
properties.managedInstanceCreateMode	ManagedServerCreateMode	Anger läget för att skapa databasen. Standard: Skapande av vanlig instans. Återställning: Skapar en instans genom att återställa en uppsättning säkerhetskopior till en viss tidpunkt. RestorePointInTime och SourceManagedInstanceId måste anges.
properties.minimalTlsVersion	string	Minimal TLS-version. Tillåtna värden: "Ingen", "1.0", "1.1", "1.2"
properties.pricingModel	FreemiumType	Väder eller inte Hanterad instans är freemium.
properties.primaryUserAssignedIdentityId	string	Resurs-ID för en användartilldelad identitet som ska användas som standard.
properties.privateEndpointConnections	ManagedInstancePecProperty[]	Lista över privata slutpunktsanslutningar på en hanterad instans.
properties.provisioningState	ProvisioningState	Etableringstillstånd för hanterad instans.
properties.proxyOverride	ManagedInstanceProxyOverride	Anslutningstyp som används för att ansluta till instansen.
properties.publicDataEndpointEnabled	boolean	Om den offentliga dataslutpunkten är aktiverad eller inte.
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Den lagringskontotyp som ska användas för att lagra säkerhetskopior för den här instansen. Alternativen är Local (LocallyRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) och GeoZone(GeoZoneRedundantStorage)
properties.restorePointInTime	string	Anger tidpunkten (ISO8601 format) för källdatabasen som ska återställas för att skapa den nya databasen.
properties.servicePrincipal	ServicePrincipal	Den hanterade instansens tjänsthuvudnamn.
properties.sourceManagedInstanceId	string	Resursidentifieraren för den källhanterade instans som är associerad med skapandeåtgärden för den här instansen.
properties.state	string	Tillståndet för den hanterade instansen.
properties.storageIOps	integer	Lagrings-IOps. Minsta värde: 300. Maximalt värde: 80000. Steg om endast 1 IOps tillåts. Maximalt värde beror på den valda maskinvarufamiljen och antalet virtuella kärnor.
properties.storageSizeInGB	integer	Lagringsstorlek i GB. Minsta värde: 32. Maximalt värde: 16384. Steg på endast 32 GB tillåts. Maximalt värde beror på den valda maskinvarufamiljen och antalet virtuella kärnor.
properties.storageThroughputMBps	integer	Mbit/s-parametern för lagringsdataflöde stöds inte i instansens create/update-åtgärd.
properties.subnetId	string	Resurs-ID för undernätet för den hanterade instansen.
properties.timezoneId	string	ID för tidszonen. Tillåtna värden är tidszoner som stöds av Windows. Windows behåller information om tidszoner som stöds, inklusive ID:t, i registret under KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Tidszoner. Du kan hämta dessa registervärden via SQL Server genom att fråga SELECT name AS timezone_id FROM sys.time_zone_info. Du kan också hämta en lista över ID:t genom att köra [System.TimeZoneInfo]::GetSystemTimeZones() i PowerShell. Ett exempel på ett giltigt tidszons-ID är "Pacific Standard Time" eller "W. Europe Standard Time".
properties.totalMemoryMB	integer	Totalt minne i MB. Minsta värde: 7168. Maximalt värde: 891328. Steg på endast 1 MB tillåts. Maximalt värde beror på den valda maskinvarufamiljen och antalet virtuella kärnor.
properties.vCores	integer	Antalet virtuella kärnor. Tillåtna värden: 8, 16, 24, 32, 40, 64, 80.
properties.virtualClusterId	string	Resurs-ID för virtuellt kluster för den hanterade instansen.
properties.zoneRedundant	boolean	Om multi-az är aktiverat eller inte.
sku	Sku	SKU för hanterad instans. Tillåtna värden för sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH
tags	object	Resurstaggar.
type	string	Resurstyp.

ManagedInstanceDatabaseFormat

Anger det interna formatet för instansdatabaser som är specifika för SQL-motorns version.

Name	Typ	Description
AlwaysUpToDate	string
SQLServer2022	string

ManagedInstanceExternalAdministrator

Egenskaper för en Active Directory-administratör.

Name	Typ	Description
administratorType	AdministratorType	Typ av serveradministratör.
azureADOnlyAuthentication	boolean	Endast Azure Active Directory-autentisering aktiverat.
login	string	Serveradministratörens inloggningsnamn.
principalType	PrincipalType	Huvudtyp för serveradministratören.
sid	string	SID (objekt-ID) för serveradministratören.
tenantId	string	Administratörens klientorganisations-ID.

ManagedInstanceLicenseType

Licenstypen. Möjliga värden är "LicenseIncluded" (vanligt pris inklusive en ny SQL-licens) och "BasePrice" (rabatterat AHB-pris för att ta med dina egna SQL-licenser).

Name	Typ	Description
BasePrice	string
LicenseIncluded	string

ManagedInstancePecProperty

En privat slutpunktsanslutning under en hanterad instans

Name	Typ	Description
id	string	Resurs-ID.
properties	ManagedInstancePrivateEndpointConnectionProperties	Egenskaper för privat slutpunktsanslutning

ManagedInstancePrivateEndpointConnectionProperties

Egenskaper för en privat slutpunktsanslutning.

Name	Typ	Description
privateEndpoint	ManagedInstancePrivateEndpointProperty	Privat slutpunkt som anslutningen tillhör.
privateLinkServiceConnectionState	ManagedInstancePrivateLinkServiceConnectionStateProperty	Anslutningstillstånd för den privata slutpunktsanslutningen.
provisioningState	string	Status för den privata slutpunktsanslutningen.

ManagedInstancePrivateEndpointProperty

Name	Typ	Description
id	string	Resurs-ID för den privata slutpunkten.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Name	Typ	Description
actionsRequired	string	Beskrivning av tjänstanslutningen för privat länk.
description	string	Beskrivning av tjänstanslutningen för privat länk.
status	string	Anslutningsstatus för tjänsten Private Link.

ManagedInstanceProxyOverride

Anslutningstyp som används för att ansluta till instansen.

Name	Typ	Description
Default	string
Proxy	string
Redirect	string

ManagedServerCreateMode

Anger läget för att skapa databasen.

Standard: Skapande av vanlig instans.

Återställning: Skapar en instans genom att återställa en uppsättning säkerhetskopior till en viss tidpunkt. RestorePointInTime och SourceManagedInstanceId måste anges.

Name	Typ	Description
Default	string
PointInTimeRestore	string

PrincipalType

Huvudtyp för serveradministratören.

Name	Typ	Description
Application	string
Group	string
User	string

ProvisioningState

Etableringstillstånd för hanterad instans.

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

ResourceIdentity

Azure Active Directory-identitetskonfiguration för en resurs.

Name	Typ	Description
principalId	string	Huvud-ID:t för Azure Active Directory.
tenantId	string	Klient-ID:t för Azure Active Directory.
type	IdentityType	Identitetstypen. Ange "SystemAssigned" för att automatiskt skapa och tilldela ett Azure Active Directory-huvudnamn för resursen.
userAssignedIdentities	<string,  UserIdentity>	Resurs-ID:n för de användartilldelade identiteter som ska användas

ServicePrincipal

Den hanterade instansens konfiguration av tjänstens huvudnamn för en resurs.

Name	Typ	Description
clientId	string	Klient-ID för Azure Active Directory-program.
principalId	string	Objekt-ID för Azure Active Directory-program.
tenantId	string	Klient-ID:t för Azure Active Directory.
type	ServicePrincipalType	Tjänstens huvudnamnstyp.

ServicePrincipalType

Tjänstens huvudnamnstyp.

Name	Typ	Description
None	string
SystemAssigned	string

Sku

En ARM-resurs-SKU.

Name	Typ	Description
capacity	integer	Kapacitet för den specifika SKU:n.
family	string	Om tjänsten har olika generationer av maskinvara, för samma SKU, kan den samlas in här.
name	string	Namnet på SKU:n, vanligtvis en bokstav + nummerkod, t.ex. P3.
size	string	Storleken på den specifika SKU:n
tier	string	Nivån eller utgåvan av den specifika SKU:n, t.ex. Basic, Premium.

UserIdentity

Azure Active Directory-identitetskonfiguration för en resurs.

Name	Typ	Description
clientId	string	Azure Active Directory-klient-ID: t.
principalId	string	Huvud-ID:t för Azure Active Directory.