Dela via


Managed Instances - Stop

Stoppar den hanterade instansen.

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

URI-parametrar

Namn I Krävs Typ Beskrivning
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.

Svaren

Namn Typ Beskrivning
200 OK

ManagedInstance

Den hanterade instansen har stoppats.

202 Accepted

Det pågår att stoppa den hanterade instansen.

Headers

Location: string

Other Status Codes

ErrorResponse

Felsvar: ***

  • 400 ManagementServiceStopManagedInstanceZoneRedundant – Stoppa körs på instansen med zonredundans aktiverad.

  • 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 start-/stoppfunktionen 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 länkad 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 Feature Wave november 2022

  • 400 InvalidServerName – Ogiltigt servernamn har angetts.

  • 400 InvalidIdentifier – Identifieraren innehåller NULL eller ett ogiltigt unicode-tecken.

  • 400 TokenTooLong – den angivna token är för lång.

  • 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ärden som skickas för åtgärden som är i stopp-/stopptillstånd.

  • 409 ManagementServiceStopManagedInstanceConflictingOperation – Stoppa azure SQL Managed Instance-konfliktå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 ManagementServiceStopManagedInstanceConflictingOperationOnInstancePool – Stoppa Azure SQL Managed Instance i konflikt med åtgärdsmeddelandet för instanspoolen.

  • 409 CannotCancelOperation – hanteringsåtgärden är i ett tillstånd som inte kan avbrytas.

  • 409 OperationCancelled – Åtgärden har avbrutits av användaren.

  • 409 Åtgärd avbröts – 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 maxbegä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 igen.

  • 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

Exempel

Stops the managed instance.

Exempelförfrågan

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/stoprg/providers/Microsoft.Sql/managedInstances/mitostop/stop?api-version=2023-08-01

Exempelsvar

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

Definitioner

Namn Beskrivning
AdministratorType

Typ av administratör för serverservern.

AuthMetadataLookupModes

Den hanterade instansens uppslagsläge för autentiseringsmetadata.

BackupStorageRedundancy

Den lagringskontotyp 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.

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

Hybrid sekundär användning 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).

IdentityType

Identitetstypen. Ställ in detta på "SystemAssigned" för att automatiskt skapa och tilldela ett Azure Active Directory-huvudnamn för resursen.

ManagedInstance

En hanterad Azure SQL-instans.

ManagedInstanceDatabaseFormat

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

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 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.

PricingModel

Prismodell för Hanterad instans.

PrincipalType

Huvudtyp för sever-administratö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 administratör för serverservern.

Värde Beskrivning
ActiveDirectory

AuthMetadataLookupModes

Den hanterade instansens uppslagsläge för autentiseringsmetadata.

Värde Beskrivning
AzureAD
Paired
Windows

BackupStorageRedundancy

Den lagringskontotyp 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)

Värde Beskrivning
Geo
Local
Zone
GeoZone

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Namn Typ Beskrivning
info

object

Ytterligare information.

type

string

Ytterligare informationstyp.

ErrorDetail

Felinformationen.

Namn Typ Beskrivning
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.

code

string

Felkoden.

details

ErrorDetail[]

Felinformationen.

message

string

Felmeddelandet.

target

string

Felmålet.

ErrorResponse

Felsvar

Namn Typ Beskrivning
error

ErrorDetail

Felobjektet.

ExternalGovernanceStatus

Status för extern styrning.

Värde Beskrivning
Enabled
Disabled

HybridSecondaryUsage

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

Värde Beskrivning
Active
Passive

HybridSecondaryUsageDetected

Hybrid sekundär användning 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).

Värde Beskrivning
Active
Passive

IdentityType

Identitetstypen. Ställ in detta på "SystemAssigned" för att automatiskt skapa och tilldela ett Azure Active Directory-huvudnamn för resursen.

Värde Beskrivning
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

ManagedInstance

En hanterad Azure SQL-instans.

Namn Typ Beskrivning
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 en hanterad instans).

properties.administrators

ManagedInstanceExternalAdministrator

Azure Active Directory-administratören för instansen. Detta kan endast användas vid instansens skapandetid. 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 (date-time)

Anger tidpunkten (ISO8601 format) för skapandet av den hanterade instansen.

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

Den lagringskontotyp 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 (arm-id)

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

Hybrid sekundär användning 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

Om det här är en GPv2-variant av General Purpose Edition eller inte.

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

PricingModel

Prismodell för Hanterad instans.

properties.primaryUserAssignedIdentityId

string (arm-id)

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 slutpunkten för offentliga data ä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 (date-time)

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 huvudnamn för tjänsten.

properties.sourceManagedInstanceId

string (arm-id)

Resursidentifieraren för den källhanterade instans som är associerad med skapa-åtgärden för den här instansen.

properties.state

string

Tillståndet för den hanterade instansen.

properties.storageIOps

integer (int32)

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 (int32)

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 (int32)

Mbit/s-parametern för lagringsdataflöde stöds inte i instansens create/update-åtgärd.

properties.subnetId

string (arm-id)

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:er genom att köra [System.TimeZoneInfo]::GetSystemTimeZones() i PowerShell. Ett exempel på giltigt tidszons-ID är "Pacific Standard Time" eller "W. Europa, standardtid".

properties.vCores

integer (int32)

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-motorversionen.

Värde Beskrivning
AlwaysUpToDate
SQLServer2022

ManagedInstanceExternalAdministrator

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

Namn Typ Beskrivning
administratorType

AdministratorType

Typ av administratör för serverservern.

azureADOnlyAuthentication

boolean

Endast Azure Active Directory-autentisering aktiverat.

login

string

Serveradministratörens inloggningsnamn.

principalType

PrincipalType

Huvudtyp för sever-administratören.

sid

string (uuid)

SID (objekt-ID) för serveradministratören.

tenantId

string (uuid)

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 egna SQL-licenser).

Värde Beskrivning
LicenseIncluded
BasePrice

ManagedInstancePecProperty

En privat slutpunktsanslutning under en hanterad instans

Namn Typ Beskrivning
id

string

Resurs-ID.

properties

ManagedInstancePrivateEndpointConnectionProperties

Egenskaper för privat slutpunktsanslutning

ManagedInstancePrivateEndpointConnectionProperties

Egenskaper för en privat slutpunktsanslutning.

Namn Typ Beskrivning
privateEndpoint

ManagedInstancePrivateEndpointProperty

Privat slutpunkt som anslutningen tillhör.

privateLinkServiceConnectionState

ManagedInstancePrivateLinkServiceConnectionStateProperty

Anslutningstillstånd för den privata slutpunktsanslutningen.

provisioningState

string

Tillståndet för den privata slutpunktsanslutningen.

ManagedInstancePrivateEndpointProperty

Namn Typ Beskrivning
id

string

Resurs-ID för den privata slutpunkten.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Namn Typ Beskrivning
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.

Värde Beskrivning
Proxy
Redirect
Default

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.

Värde Beskrivning
Default
PointInTimeRestore

PricingModel

Prismodell för Hanterad instans.

Värde Beskrivning
Regular
Freemium

PrincipalType

Huvudtyp för sever-administratören.

Värde Beskrivning
User
Group
Application

ProvisioningState

Etableringstillstånd för hanterad instans.

Värde Beskrivning
Created
InProgress
Succeeded
Failed
Canceled

ResourceIdentity

Azure Active Directory-identitetskonfiguration för en resurs.

Namn Typ Beskrivning
principalId

string (uuid)

Huvud-ID:t för Azure Active Directory.

tenantId

string (uuid)

Klient-ID:t för Azure Active Directory.

type

IdentityType

Identitetstypen. Ställ in detta på "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.

Namn Typ Beskrivning
clientId

string

Klient-ID:t för Azure Active Directory-programmet.

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.

Värde Beskrivning
None
SystemAssigned

Sku

En ARM-resurs-SKU.

Namn Typ Beskrivning
capacity

integer (int32)

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.

Namn Typ Beskrivning
clientId

string (uuid)

Azure Active Directory-klient-ID: t.

principalId

string (uuid)

Huvud-ID:t för Azure Active Directory.