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 |
|---|---|---|---|---|
|
managed
|
path | True |
string |
Název spravované instance. |
|
resource
|
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. |
|
subscription
|
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 |
Spravovaná instance byla úspěšně spuštěna. |
|
| 202 Accepted |
Probíhá spuštění spravované instance. Hlavičky Location: string |
|
| Other Status Codes |
Chybové odpovědi: ***
|
Příklady
Starts the managed instance.
Ukázkový požadavek
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 |
|---|---|
|
Administrator |
Typ správce serveru. |
|
Auth |
Režim vyhledávání metadat ověřování spravované instance. |
|
Backup |
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) |
|
Error |
Další informace o chybě správy prostředků |
|
Error |
Podrobnosti o chybě. |
|
Error |
Chybová odpověď |
|
External |
Stav externích zásad správného řízení |
|
Hybrid |
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). |
|
Hybrid |
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). |
|
Identity |
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. |
|
Managed |
Spravovaná instance Azure SQL |
|
Managed |
Určuje interní formát databází instancí specifických pro verzi modulu SQL. |
|
Managed |
Vlastnosti správce služby Active Directory |
|
Managed |
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). |
|
Managed |
Připojení privátního koncového bodu ve spravované instanci |
|
Managed |
Vlastnosti připojení privátního koncového bodu |
|
Managed |
|
|
Managed |
|
|
Managed |
Typ připojení použitý pro připojení k instanci. |
|
Managed |
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. |
|
Pricing |
Cenový model spravované instance |
|
Principal |
Hlavní typ správce serveru. |
|
Provisioning |
Stav zřizování spravované instance |
|
Resource |
Konfigurace identity Azure Active Directory pro prostředek |
|
Service |
Konfigurace instančního objektu spravované instance pro prostředek. |
|
Service |
Typ instančního objektu. |
| Sku |
Skladová položka prostředku ARM. |
|
User |
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 |
Další informace o chybě. |
|
| code |
string |
Kód chyby. |
| details |
Podrobnosti o chybě. |
|
| message |
string |
Chybová zpráva. |
| target |
string |
Cíl chyby. |
ErrorResponse
Chybová odpověď
| Name | Typ | Description |
|---|---|---|
| error |
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 |
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 |
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 |
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 |
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 |
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 |
Stav externích zásad správného řízení |
|
| properties.fullyQualifiedDomainName |
string |
Plně kvalifikovaný název domény spravované instance. |
| properties.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 |
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 |
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 |
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 |
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 |
Seznam připojení privátních koncových bodů ve spravované instanci |
|
| properties.provisioningState |
Stav zřizování spravované instance |
|
| properties.proxyOverride |
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 |
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 |
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 |
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 |
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 |
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 |
Vlastnosti připojení privátního koncového bodu |
ManagedInstancePrivateEndpointConnectionProperties
Vlastnosti připojení privátního koncového bodu
| Name | Typ | Description |
|---|---|---|
| privateEndpoint |
Privátní koncový bod, ke kterému připojení patří. |
|
| privateLinkServiceConnectionState |
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 |
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,
User |
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 |
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. |