Dela via

Managed Instances - Start

  • Referens
Tjänst:
SQL Database
API-version:
2023-08-01

Startar den hanterade instansen.

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

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 startats.
202 Accepted

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

Sidhuvuden

Location: string
Other Status Codes

ErrorResponse

Felsvar: ***

  • 400 NameAlreadyExists – Det angivna namnet finns redan.

  • 400 InvalidServerName – Ogiltigt servernamn har angetts.

  • 400 ManagementServiceStartManagedInstanceNotSupportedOnSKU – Startåtgärden stöds inte på den angivna SKU:n.

  • 400 ManagementServiceStartStopManagedInstanceSubscriptionNotEnabledForFeature – Användaren försökte använda start-/stoppfunktionen utan att ha prenumerationen tillåten för lämplig prenumerationsfunktion.

  • 400 StartStopOfManagedInstanceIsDisabled – Start- och stoppåtgärden på den hanterade instansen är inte aktiverad.

  • 400 ManagementServiceStartManagedInstanceTriggeredWhileStartInProgress – Användaren försökte starta Azure SQL Managed Instance som inte är i stoppat tillstånd.

  • 400 ManagementServiceStartManagedInstanceFeatureDisabled – Användaren försökte använda funktionen Starta Azure SQL Managed Instance, som är inaktiverad.

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

  • 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 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 Å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

Starts the managed instance.

Exempelbegäran

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

Exempelsvar

Statuskod:
200 
{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen5"
  },
  "properties": {
    "fullyQualifiedDomainName": "mitostart.1234567891234.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "state": "Ready",
    "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/startrg/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/startrg/providers/Microsoft.Sql/managedInstances/mitostart",
  "name": "mitostart",
  "type": "Microsoft.Sql/managedInstances"
}
Statuskod:
202 
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/locations/westeurope/startManagedInstanceOperationResults/11111111-1111-1111-1111-111111111111
Azure-AsyncOperation: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/locations/westeurope/startManagedInstanceAzureAsyncOperation/11111111-1111-1111-1111-111111111111

Definitioner

Name Description
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

Uppräkning

Typ av administratör för serverservern.

Värde Description
ActiveDirectory

AuthMetadataLookupModes

Uppräkning

Den hanterade instansens uppslagsläge för autentiseringsmetadata.

Värde Description
AzureAD
Paired
Windows

BackupStorageRedundancy

Uppräkning

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 Description
Geo
GeoZone
Local
Zone

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name Typ Description
info

object

Ytterligare information.
type

string

Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.
code

string

Felkoden.
details

ErrorDetail[]

Felinformationen.
message

string

Felmeddelandet.
target

string

Felmålet.

ErrorResponse

Objekt

Felsvar

Name Typ Description
error

ErrorDetail

Felobjektet.

ExternalGovernanceStatus

Uppräkning

Status för extern styrning.

Värde Description
Disabled
Enabled

HybridSecondaryUsage

Uppräkning

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 Description
Active
Passive

HybridSecondaryUsageDetected

Uppräkning

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 Description
Active
Passive

IdentityType

Uppräkning

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

Värde Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

ManagedInstance

Objekt

En hanterad Azure SQL-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 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

Uppräkning

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

Värde Description
AlwaysUpToDate
SQLServer2022

ManagedInstanceExternalAdministrator

Objekt

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

Name Typ Description
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

Uppräkning

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 Description
BasePrice
LicenseIncluded

ManagedInstancePecProperty

Objekt

En privat slutpunktsanslutning under en hanterad instans

Name Typ Description
id

string

Resurs-ID.
properties

ManagedInstancePrivateEndpointConnectionProperties

Egenskaper för privat slutpunktsanslutning

ManagedInstancePrivateEndpointConnectionProperties

Objekt

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

Tillståndet för den privata slutpunktsanslutningen.

ManagedInstancePrivateEndpointProperty

Objekt
Name Typ Description
id

string

Resurs-ID för den privata slutpunkten.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Objekt
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

Uppräkning

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

Värde Description
Default
Proxy
Redirect

ManagedServerCreateMode

Uppräkning

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 Description
Default
PointInTimeRestore

PricingModel

Uppräkning

Prismodell för Hanterad instans.

Värde Description
Freemium
Regular

PrincipalType

Uppräkning

Huvudtyp för sever-administratören.

Värde Description
Application
Group
User

ProvisioningState

Uppräkning

Etableringstillstånd för hanterad instans.

Värde Description
Canceled
Created
Failed
InProgress
Succeeded

ResourceIdentity

Objekt

Azure Active Directory-identitetskonfiguration för en resurs.

Name Typ Description
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

Objekt

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

Name Typ Description
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

Uppräkning

Tjänstens huvudnamnstyp.

Värde Description
None
SystemAssigned

Sku

Objekt

En ARM-resurs-SKU.

Name Typ Description
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

Objekt

Azure Active Directory-identitetskonfiguration för en resurs.

Name Typ Description
clientId

string (uuid)

Azure Active Directory-klient-ID: t.
principalId

string (uuid)

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