Sdílet prostřednictvím


Managed Instances - Start

Spustí spravovanou instanci.

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

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á obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API Azure Resource Manageru nebo 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 byla úspěšně spuštěna.

202 Accepted

Probíhá spuštění spravované instance.

Hlavičky

Location: string

Other Status Codes

ErrorResponse

Chybové odpovědi: ***

  • 400 NameAlreadyExists – zadaný název již existuje.

  • 400 InvalidServerName – zadaný neplatný název serveru.

  • 400 ManagementServiceStartManagedInstanceNotSupportedOnSKU – Operace spuštění není u dané skladové položky podporovaná.

  • 400 ManagementServiceStartStopManagedInstanceSubscriptionNotEnabledForFeature – Uživatel se pokusil použít funkci Start/Stop bez povolení předplatného pro příslušnou funkci předplatného.

  • 400 StartStopOfManagedInstanceIsDisabled – Operace spuštění a zastavení ve spravované instanci není povolená.

  • 400 ManagementServiceStartManagedInstanceTriggeredWhileStartInProgress – Uživatel se pokusil spustit spravovanou instanci Azure SQL, která není ve stavu Zastaveno.

  • 400 ManagementServiceStartManagedInstanceFeatureDisabled – Uživatel se pokusil použít funkci Spustit spravovanou instanci Azure SQL, která je zakázaná.

  • 400 InvalidIdentifier – identifikátor obsahuje hodnotu NULL nebo neplatný znak unicode.

  • 400 InvalidServerName – zadaný neplatný název serveru.

  • 400 InvalidIdentifier – identifikátor obsahuje hodnotu NULL nebo neplatný znak unicode.

  • 400 TokenTooLong - Poskytnutý token je příliš dlouhý.

  • 404 ServerNotInSubscriptionResourceGroup – Zadaný server neexistuje v zadané skupině prostředků a předplatném.

  • 404 SubscriptionDoesNotHaveServer – Požadovaný server nebyl nalezen.

  • 404 OperationIdNotFound – operace s ID neexistuje.

  • 404 ResourceNotFound – Požadovaný prostředek nebyl nalezen.

  • 404 OperationIdNotFound – operace s ID neexistuje.

  • 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í na stejném prostředku.

  • 429 SubscriptionTooManyCreateUpdateRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky.

  • 429 SubscriptionTooManyRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky.

  • 500 OperationTimedOut – Vypršel časový limit operace a automaticky se vrátil zpět. Zkuste operaci zopakovat.

  • 503 TooManyRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky.

Příklady

Starts the managed instance.

Ukázkový požadavek

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

Ukázková odpověď

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

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ě použitý k ukládání záloh pro tuto instanci. Možnosti jsou Místní (MístněRedundantStorage), Zóna (ZoneRedundantStorage), Geo (GeoRedundantStorage) a GeoZone(GeoZoneRedundantStorage)

ErrorAdditionalInfo

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

ErrorDetail

Podrobnosti o chybě.

ErrorResponse

Chybová odpověď

ExternalGovernanceStatus

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

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ího systému jako pasivní zotavení po havárii) a Pasivní (zákazník splňuje požadavky na použití sekundárního pasivního zotavení po havárii).

IdentityType

Typ identity. Nastavte ho na SystemAssigned, aby se automaticky vytvořil a přiřadil objekt zabezpečení Azure Active Directory pro daný prostředek.

ManagedInstance

Spravovaná instance Azure SQL

ManagedInstanceDatabaseFormat

Určuje interní formát databází instancí specifických 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í hodnota: Vytvoření pravidelné instance.

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

PricingModel

Cenový model spravované instance

PrincipalType

Hlavní typ 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.

Hodnota Description
ActiveDirectory

AuthMetadataLookupModes

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

Hodnota Description
AzureAD
Paired
Windows

BackupStorageRedundancy

Typ účtu úložiště použitý k ukládání záloh pro tuto instanci. Možnosti jsou Místní (MístněRedundantStorage), Zóna (ZoneRedundantStorage), Geo (GeoRedundantStorage) a GeoZone(GeoZoneRedundantStorage)

Hodnota Description
Geo
Local
Zone
GeoZone

ErrorAdditionalInfo

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

Name Typ Description
info

object

Další informace.

type

string

Další typ informací.

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

Chybová odpověď

Name Typ Description
error

ErrorDetail

Objekt chyby.

ExternalGovernanceStatus

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

Hodnota Description
Enabled
Disabled

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

Hodnota Description
Active
Passive

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ího systému jako pasivní zotavení po havárii) a Pasivní (zákazník splňuje požadavky na použití sekundárního pasivního zotavení po havárii).

Hodnota Description
Active
Passive

IdentityType

Typ identity. Nastavte ho na SystemAssigned, aby se automaticky vytvořil a přiřadil objekt zabezpečení Azure Active Directory pro daný prostředek.

Hodnota Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

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. Je možné zadat pouze při vytváření spravované instance (a vyžaduje se k vytvoření).

properties.administratorLoginPassword

string

Přihlašovací heslo správce (vyžaduje se k vytvoření spravované instance).

properties.administrators

ManagedInstanceExternalAdministrator

Správce služby Azure Active Directory instance. Tuto možnost lze použít pouze v době vytvoření instance. Pokud se používá pro aktualizaci instance, bude ignorován nebo bude mít za následek chybu. 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 (date-time)

Určuje bod v čase (formát ISO8601) vytvoření spravované instance.

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

Typ účtu úložiště použitý k ukládání záloh pro tuto instanci. Možnosti jsou Místní (MístněRedundantStorage), Zóna (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é je spravovaná instance.

properties.dnsZonePartner

string (arm-id)

ID prostředku jiné spravované instance, jejíž zóna DNS bude tato spravovaná instance sdílet po vytvoření.

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ího systému jako pasivní zotavení po havárii) a Pasivní (zákazník splňuje požadavky na použití sekundárního pasivního zotavení po havárii).

properties.instancePoolId

string

ID fondu instancí, do které tento spravovaný server patří.

properties.isGeneralPurposeV2

boolean

Určuje, jestli se jedná o variantu GPv2 edice Pro obecné účely.

properties.keyId

string

Identifikátor URI klíče CMK, 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í hodnota: Vytvoření pravidelné instance.

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

properties.minimalTlsVersion

string

Minimální verze protokolu TLS. Povolené hodnoty: None, 1.0, 1.1, 1.2

properties.pricingModel

PricingModel

Cenový model spravované instance

properties.primaryUserAssignedIdentityId

string (arm-id)

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

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í (MístněRedundantStorage), Zóna (ZoneRedundantStorage), Geo (GeoRedundantStorage) a GeoZone(GeoZoneRedundantStorage)

properties.restorePointInTime

string (date-time)

Určuje bod v čase (formát ISO8601) zdrojové databáze, která se obnoví a vytvoří novou databázi.

properties.servicePrincipal

ServicePrincipal

Instanční objekt spravované instance.

properties.sourceManagedInstanceId

string (arm-id)

Identifikátorprostředkuho

properties.state

string

Stav spravované instance.

properties.storageIOps

integer (int32)

IOps úložiště. Minimální hodnota: 300. Maximální hodnota: 80000. Přírůstky 1 vstupně-výstupních operací za sekundu jsou povolené jenom. Maximální hodnota závisí na vybrané skupině hardwaru a počtu virtuálních jader.

properties.storageSizeInGB

integer (int32)

Velikost úložiště v GB. Minimální hodnota: 32. Maximální hodnota: 16384. Jsou povoleny pouze přírůstky o 32 GB. Maximální hodnota závisí na vybrané skupině hardwaru a počtu virtuálních jader.

properties.storageThroughputMBps

integer (int32)

Parametr MBps propustnosti úložiště se v operaci vytvoření nebo aktualizace instance nepodporuje.

properties.subnetId

string (arm-id)

ID prostředku podsítě pro spravovanou instanci.

properties.timezoneId

string

ID časového pásma. Povolené hodnoty jsou časové pásmo podporované systémem Windows. Systém Windows uchovává podrobnosti o podporovaných časových pásmech, včetně ID, v registru v části KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Tyto hodnoty registru můžete získat prostřednictvím SQL Serveru dotazováním názvu SELECT timezone_id FROM sys.time_zone_info. Seznam ID lze získat také 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. Evropský standardní čas".

properties.vCores

integer (int32)

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

Bez ohledu na to, 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ází instancí specifických pro verzi modulu SQL.

Hodnota Description
AlwaysUpToDate
SQLServer2022

ManagedInstanceExternalAdministrator

Vlastnosti správce služby Active Directory

Name Typ Description
administratorType

AdministratorType

Typ správce serveru.

azureADOnlyAuthentication

boolean

Je povoleno pouze ověřování Azure Active Directory.

login

string

Přihlašovací jméno správce serveru.

principalType

PrincipalType

Hlavní typ správce serveru.

sid

string (uuid)

IDENTIFIKÁTOR SID (ID objektu) správce serveru.

tenantId

string (uuid)

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

Hodnota Description
LicenseIncluded
BasePrice

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

Hodnota Description
Proxy
Redirect
Default

ManagedServerCreateMode

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

Výchozí hodnota: Vytvoření pravidelné instance.

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

Hodnota Description
Default
PointInTimeRestore

PricingModel

Cenový model spravované instance

Hodnota Description
Regular
Freemium

PrincipalType

Hlavní typ správce serveru.

Hodnota Description
User
Group
Application

ProvisioningState

Stav zřizování spravované instance

Hodnota Description
Created
InProgress
Succeeded
Failed
Canceled

ResourceIdentity

Konfigurace identity Azure Active Directory pro prostředek

Name Typ Description
principalId

string (uuid)

ID objektu zabezpečení Azure Active Directory.

tenantId

string (uuid)

ID tenanta Azure Active Directory.

type

IdentityType

Typ identity. Nastavte ho na SystemAssigned, aby se automaticky vytvořil a přiřadil objekt zabezpečení Azure Active Directory pro daný prostředek.

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.

Hodnota Description
None
SystemAssigned

Sku

Skladová položka prostředku ARM.

Name Typ Description
capacity

integer (int32)

Kapacita konkrétní skladové položky.

family

string

Pokud má služba různé generace hardwaru, pro stejnou skladovou položku, můžete ji zde zachytit.

name

string

Název skladové položky, obvykle písmeno + číslo, např. P3.

size

string

Velikost konkrétní skladové položky

tier

string

Úroveň nebo edice konkrétní skladové položky, např. Basic, Premium.

UserIdentity

Konfigurace identity Azure Active Directory pro prostředek

Name Typ Description
clientId

string (uuid)

ID klienta Azure Active Directory.

principalId

string (uuid)

ID objektu zabezpečení Azure Active Directory.