Managed Instances - Start
Startet die verwaltete instance.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/start?api-version=2023-08-01-preview
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
managed
|
path | True |
string |
Der Name der verwalteten Instanz. |
resource
|
path | True |
string |
Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden. |
subscription
|
path | True |
string |
Abonnement-ID für ein Azure-Abonnement. |
api-version
|
query | True |
string |
API-Version, die für die Anforderung verwendet werden soll. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Die verwaltete instance wurde erfolgreich gestartet. |
|
202 Accepted |
Das Starten der verwalteten instance wird ausgeführt. |
|
Other Status Codes |
Fehlerantworten: ***
|
Beispiele
Starts the managed instance.
Beispielanforderung
POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/managedInstances/mitostart/start?api-version=2023-08-01-preview
Beispiel für eine Antwort
{
"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
Definitionen
Name | Beschreibung |
---|---|
Administrator |
Typ des Serveradministrators. |
Auth |
Der Suchmodus für Authentifizierungsmetadaten des verwalteten instance. |
Backup |
Der Speicherkontotyp, der zum Speichern von Sicherungen für diese instance verwendet wird. Die Optionen sind Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) und GeoZone(GeoZoneRedundantStorage). |
Error |
Zusätzliche Informationen zum Ressourcenverwaltungsfehler. |
Error |
Die Fehlerdetails. |
Error |
Fehlerantwort |
External |
Status der externen Governance. |
Freemium |
Wetter oder nicht verwaltete Instanz ist Freemium. |
Hybrid |
Sekundäre Hybridnutzung. Mögliche Werte sind "Active" (Standardwert) und "Passiv" (der Kunde verwendet die sekundäre Notfallwiederherstellung als passive Notfallwiederherstellung). |
Hybrid |
Sekundäre Hybridnutzung erkannt. Mögliche Werte sind "Aktiv" (Der Kunde erfüllt nicht die Anforderungen, die sekundäre Notfallwiederherstellung als passive Notfallwiederherstellung zu verwenden) und "Passiv" (der Kunde erfüllt die Anforderungen, die sekundäre Notfallwiederherstellung zu verwenden). |
Identity |
Der Identitätstyp. Legen Sie dies auf "SystemAssigned" fest, um automatisch einen Azure Active Directory-Prinzipal für die Ressource zu erstellen und zuzuweisen. |
Managed |
Ein Azure SQL verwalteter instance. |
Managed |
Gibt das interne Format von instance Datenbanken an, die für die SQL-Engine-Version spezifisch sind. |
Managed |
Eigenschaften eines Active Directory-Administrators. |
Managed |
Der Lizenztyp. Mögliche Werte sind "LicenseIncluded" (regulärer Preis inklusive einer neuen SQL-Lizenz) und "BasePrice" (ermäßigter AHB-Preis für das Mitbringen Eigener SQL-Lizenzen). |
Managed |
Eine private Endpunktverbindung unter einem verwalteten instance |
Managed |
Eigenschaften einer privaten Endpunktverbindung. |
Managed |
|
Managed |
|
Managed |
Verbindungstyp, der zum Herstellen einer Verbindung mit dem instance verwendet wird. |
Managed |
Gibt den Modus der Datenbankerstellung an. Standard: Reguläre instance Erstellung. Wiederherstellen: Erstellt eine instance, indem eine Reihe von Sicherungen auf einen bestimmten Zeitpunkt wiederhergestellt werden. RestorePointInTime und SourceManagedInstanceId müssen angegeben werden. |
Principal |
Prinzipaltyp des Serveradministrators. |
Provisioning |
Bereitstellungsstatus der verwalteten instance. |
Resource |
Azure Active Directory-Identitätskonfiguration für eine Ressource. |
Service |
Die Dienstprinzipalkonfiguration des verwalteten instance für eine Ressource. |
Service |
Dienstprinzipaltyp. |
Sku |
Eine ARM-Ressourcen-SKU. |
User |
Azure Active Directory-Identitätskonfiguration für eine Ressource. |
AdministratorType
Typ des Serveradministrators.
Name | Typ | Beschreibung |
---|---|---|
ActiveDirectory |
string |
AuthMetadataLookupModes
Der Suchmodus für Authentifizierungsmetadaten des verwalteten instance.
Name | Typ | Beschreibung |
---|---|---|
AzureAD |
string |
|
Paired |
string |
|
Windows |
string |
BackupStorageRedundancy
Der Speicherkontotyp, der zum Speichern von Sicherungen für diese instance verwendet wird. Die Optionen sind Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) und GeoZone(GeoZoneRedundantStorage).
Name | Typ | Beschreibung |
---|---|---|
Geo |
string |
|
GeoZone |
string |
|
Local |
string |
|
Zone |
string |
ErrorAdditionalInfo
Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
Name | Typ | Beschreibung |
---|---|---|
info |
object |
Zusätzliche Informationen. |
type |
string |
Typ der zusätzlichen Informationen. |
ErrorDetail
Die Fehlerdetails.
Name | Typ | Beschreibung |
---|---|---|
additionalInfo |
Die zusätzlichen Fehlerinformationen. |
|
code |
string |
Der Fehlercode. |
details |
Die Fehlerdetails. |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
Name | Typ | Beschreibung |
---|---|---|
error |
Das Fehlerobjekt. |
ExternalGovernanceStatus
Status der externen Governance.
Name | Typ | Beschreibung |
---|---|---|
Disabled |
string |
|
Enabled |
string |
FreemiumType
Wetter oder nicht verwaltete Instanz ist Freemium.
Name | Typ | Beschreibung |
---|---|---|
Freemium |
string |
|
Regular |
string |
HybridSecondaryUsage
Sekundäre Hybridnutzung. Mögliche Werte sind "Active" (Standardwert) und "Passiv" (der Kunde verwendet die sekundäre Notfallwiederherstellung als passive Notfallwiederherstellung).
Name | Typ | Beschreibung |
---|---|---|
Active |
string |
|
Passive |
string |
HybridSecondaryUsageDetected
Sekundäre Hybridnutzung erkannt. Mögliche Werte sind "Aktiv" (Der Kunde erfüllt nicht die Anforderungen, die sekundäre Notfallwiederherstellung als passive Notfallwiederherstellung zu verwenden) und "Passiv" (der Kunde erfüllt die Anforderungen, die sekundäre Notfallwiederherstellung zu verwenden).
Name | Typ | Beschreibung |
---|---|---|
Active |
string |
|
Passive |
string |
IdentityType
Der Identitätstyp. Legen Sie dies auf "SystemAssigned" fest, um automatisch einen Azure Active Directory-Prinzipal für die Ressource zu erstellen und zuzuweisen.
Name | Typ | Beschreibung |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned,UserAssigned |
string |
|
UserAssigned |
string |
ManagedInstance
Ein Azure SQL verwalteter instance.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Ressourcen-ID |
identity |
Die Azure Active Directory-Identität des verwalteten instance. |
|
location |
string |
Ressourcenspeicherort |
name |
string |
Name der Ressource. |
properties.administratorLogin |
string |
Administratorbenutzername für die verwaltete instance. Kann nur angegeben werden, wenn die verwaltete instance erstellt wird (und für die Erstellung erforderlich ist). |
properties.administratorLoginPassword |
string |
Das Administratorkennwort (erforderlich für die Erstellung von verwalteten instance). |
properties.administrators |
Der Azure Active Directory-Administrator des instance. Dies kann nur instance Erstellungszeit verwendet werden. Wenn sie für instance Update verwendet wird, wird dies ignoriert oder führt zu einem Fehler. Für Updates müssen einzelne APIs verwendet werden. |
|
properties.authenticationMetadata |
Der Nachschlagemodus für Authentifizierungsmetadaten des verwalteten instance. |
|
properties.collation |
string |
Sortierung der verwalteten instance. |
properties.createTime |
string |
Gibt den Zeitpunkt (ISO8601 Format) der erstellung des verwaltete Instanz an. |
properties.currentBackupStorageRedundancy |
Der Speicherkontotyp, der zum Speichern von Sicherungen für diese instance verwendet wird. Die Optionen sind Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) und GeoZone(GeoZoneRedundantStorage). |
|
properties.databaseFormat |
Gibt das interne Format instance Datenbanken an, die für die SQL-Engine-Version spezifisch sind. |
|
properties.dnsZone |
string |
Die Dns-Zone, in der sich die verwaltete instance befindet. |
properties.dnsZonePartner |
string |
Die Ressourcen-ID eines anderen verwalteten instance dessen DNS-Zone dieser verwaltete instance nach der Erstellung freigegeben wird. |
properties.externalGovernanceStatus |
Status der externen Governance. |
|
properties.fullyQualifiedDomainName |
string |
Der vollqualifizierte Domänenname des verwalteten instance. |
properties.hybridSecondaryUsage |
Sekundäre Hybridnutzung. Mögliche Werte sind "Active" (Standardwert) und "Passiv" (der Kunde verwendet das sekundäre Als Passive DR). |
|
properties.hybridSecondaryUsageDetected |
Sekundäre Hybridnutzung erkannt. Mögliche Werte sind "Aktiv" (der Kunde erfüllt nicht die Anforderungen, die sekundäre dr als Passive DR zu verwenden) und "Passiv" (Der Kunde erfüllt die Anforderungen, um die sekundäre Notfallwiederherstellung als Passive Dr zu verwenden). |
|
properties.instancePoolId |
string |
Die ID des instance Pools, zu dem dieser verwaltete Server gehört. |
properties.isGeneralPurposeV2 |
boolean |
Gibt an, ob dies eine GPv2-Variante von Universell Edition ist oder nicht. |
properties.keyId |
string |
Ein CMK-URI des Schlüssels, der für die Verschlüsselung verwendet werden soll. |
properties.licenseType |
Der Lizenztyp. Mögliche Werte sind "LicenseIncluded" (regulärer Preis inklusive einer neuen SQL-Lizenz) und "BasePrice" (ermäßigter AHB-Preis für die Bereitstellung Ihrer eigenen SQL-Lizenzen). |
|
properties.maintenanceConfigurationId |
string |
Gibt die Wartungskonfigurations-ID an, die auf diese verwaltete instance angewendet werden soll. |
properties.managedInstanceCreateMode |
Gibt den Modus der Datenbankerstellung an. Standard: Reguläre instance Erstellung. Wiederherstellung: Erstellt eine instance, indem eine Reihe von Sicherungen auf einen bestimmten Zeitpunkt wiederhergestellt wird. RestorePointInTime und SourceManagedInstanceId müssen angegeben werden. |
|
properties.minimalTlsVersion |
string |
Minimale TLS-Version. Zulässige Werte: "None", "1.0", "1.1", "1.2" |
properties.pricingModel |
Wetter oder nicht verwaltete Instanz ist Freemium. |
|
properties.primaryUserAssignedIdentityId |
string |
Die Ressourcen-ID einer benutzerseitig zugewiesenen Identität, die standardmäßig verwendet werden soll. |
properties.privateEndpointConnections |
Liste der privaten Endpunktverbindungen auf einem verwalteten instance. |
|
properties.provisioningState |
Bereitstellungsstatus der verwalteten instance. |
|
properties.proxyOverride |
Verbindungstyp, der zum Herstellen einer Verbindung mit dem instance verwendet wird. |
|
properties.publicDataEndpointEnabled |
boolean |
Gibt an, ob der öffentliche Datenendpunkt aktiviert ist. |
properties.requestedBackupStorageRedundancy |
Der Speicherkontotyp, der zum Speichern von Sicherungen für diese instance verwendet werden soll. Die Optionen sind Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) und GeoZone(GeoZoneRedundantStorage). |
|
properties.restorePointInTime |
string |
Gibt den Zeitpunkt (ISO8601 Format) der Quelldatenbank an, die zum Erstellen der neuen Datenbank wiederhergestellt wird. |
properties.servicePrincipal |
Der Dienstprinzipal des verwalteten instance. |
|
properties.sourceManagedInstanceId |
string |
Der Ressourcenbezeichner der verwalteten Quelle instance dem Erstellungsvorgang dieses instance zugeordnet. |
properties.state |
string |
Der Status des verwalteten instance. |
properties.storageIOps |
integer |
Speicher-IOps. Mindestwert: 300. Maximalwert: 80000. Nur Inkremente von 1 IOps zulässig. Der maximale Wert hängt von der ausgewählten Hardwarefamilie und der Anzahl der virtuellen Kerne ab. |
properties.storageSizeInGB |
integer |
Speichergröße in GB. Mindestwert: 32. Maximalwert: 16384. Nur Inkremente von 32 GB zulässig. Der maximale Wert hängt von der ausgewählten Hardwarefamilie und der Anzahl der virtuellen Kerne ab. |
properties.storageThroughputMBps |
integer |
Der Speicherdurchsatz-MBps-Parameter wird im instance Erstellungs-/Aktualisierungsvorgangs nicht unterstützt. |
properties.subnetId |
string |
Subnetzressourcen-ID für die verwaltete instance. |
properties.timezoneId |
string |
Id der Zeitzone. Zulässige Werte sind von Windows unterstützte Zeitzonen. Windows speichert Details zu unterstützten Zeitzonen, einschließlich der ID, in der Registrierung unter KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Sie können diese Registrierungswerte über SQL Server abrufen, indem Sie SELECT name AS timezone_id FROM sys.time_zone_info abfragen. Die Liste der Ids kann auch abgerufen werden, indem Sie [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell ausführen. Ein Beispiel für eine gültige Zeitzonen-ID ist "Pacific Standard Time" oder "W. Europa Standardzeit". |
properties.totalMemoryMB |
integer |
Gesamtspeicher in MB. Mindestwert: 7168. Maximalwert: 891328. Nur Inkremente von 1 MB zulässig. Der maximale Wert hängt von der ausgewählten Hardwarefamilie und der Anzahl der virtuellen Kerne ab. |
properties.vCores |
integer |
Die Anzahl der virtuellen Kerne. Zulässige Werte: 8, 16, 24, 32, 40, 64, 80. |
properties.virtualClusterId |
string |
Ressourcen-ID des virtuellen Clusters für den verwaltete Instanz. |
properties.zoneRedundant |
boolean |
Gibt an, ob multi-az aktiviert ist. |
sku |
Verwaltete instance-SKU. Zulässige Werte für sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH |
|
tags |
object |
Ressourcentags. |
type |
string |
Der Ressourcentyp. |
ManagedInstanceDatabaseFormat
Gibt das interne Format von instance Datenbanken an, die für die SQL-Engine-Version spezifisch sind.
Name | Typ | Beschreibung |
---|---|---|
AlwaysUpToDate |
string |
|
SQLServer2022 |
string |
ManagedInstanceExternalAdministrator
Eigenschaften eines Active Directory-Administrators.
Name | Typ | Beschreibung |
---|---|---|
administratorType |
Typ des Serveradministrators. |
|
azureADOnlyAuthentication |
boolean |
Nur Azure Active Directory-Authentifizierung aktiviert. |
login |
string |
Anmeldename des Serveradministrators. |
principalType |
Prinzipaltyp des Serveradministrators. |
|
sid |
string |
SID (Objekt-ID) des Serveradministrators. |
tenantId |
string |
Mandanten-ID des Administrators. |
ManagedInstanceLicenseType
Der Lizenztyp. Mögliche Werte sind "LicenseIncluded" (regulärer Preis inklusive einer neuen SQL-Lizenz) und "BasePrice" (ermäßigter AHB-Preis für das Mitbringen Eigener SQL-Lizenzen).
Name | Typ | Beschreibung |
---|---|---|
BasePrice |
string |
|
LicenseIncluded |
string |
ManagedInstancePecProperty
Eine private Endpunktverbindung unter einem verwalteten instance
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Ressourcen-ID |
properties |
Verbindungseigenschaften für private Endpunkte |
ManagedInstancePrivateEndpointConnectionProperties
Eigenschaften einer privaten Endpunktverbindung.
Name | Typ | Beschreibung |
---|---|---|
privateEndpoint |
Privater Endpunkt, zu dem die Verbindung gehört. |
|
privateLinkServiceConnectionState |
Verbindungsstatus der Verbindung mit dem privaten Endpunkt. |
|
provisioningState |
string |
Status der Verbindung mit dem privaten Endpunkt. |
ManagedInstancePrivateEndpointProperty
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Ressourcen-ID des privaten Endpunkts. |
ManagedInstancePrivateLinkServiceConnectionStateProperty
Name | Typ | Beschreibung |
---|---|---|
actionsRequired |
string |
Die Verbindungsbeschreibung des Private Link-Diensts. |
description |
string |
Die Verbindungsbeschreibung des Private Link-Diensts. |
status |
string |
Die Private Link-Dienstverbindung status. |
ManagedInstanceProxyOverride
Verbindungstyp, der zum Herstellen einer Verbindung mit dem instance verwendet wird.
Name | Typ | Beschreibung |
---|---|---|
Default |
string |
|
Proxy |
string |
|
Redirect |
string |
ManagedServerCreateMode
Gibt den Modus der Datenbankerstellung an.
Standard: Reguläre instance Erstellung.
Wiederherstellen: Erstellt eine instance, indem eine Reihe von Sicherungen auf einen bestimmten Zeitpunkt wiederhergestellt werden. RestorePointInTime und SourceManagedInstanceId müssen angegeben werden.
Name | Typ | Beschreibung |
---|---|---|
Default |
string |
|
PointInTimeRestore |
string |
PrincipalType
Prinzipaltyp des Serveradministrators.
Name | Typ | Beschreibung |
---|---|---|
Application |
string |
|
Group |
string |
|
User |
string |
ProvisioningState
Bereitstellungsstatus der verwalteten instance.
Name | Typ | Beschreibung |
---|---|---|
Canceled |
string |
|
Created |
string |
|
Failed |
string |
|
InProgress |
string |
|
Succeeded |
string |
ResourceIdentity
Azure Active Directory-Identitätskonfiguration für eine Ressource.
Name | Typ | Beschreibung |
---|---|---|
principalId |
string |
Die Azure Active Directory-Prinzipal-ID. |
tenantId |
string |
Die Azure Active Directory-Mandanten-ID. |
type |
Der Identitätstyp. Legen Sie dies auf "SystemAssigned" fest, um automatisch einen Azure Active Directory-Prinzipal für die Ressource zu erstellen und zuzuweisen. |
|
userAssignedIdentities |
<string,
User |
Die Ressourcen-ID der zu verwendenden benutzerseitig zugewiesenen Identitäten |
ServicePrincipal
Die Dienstprinzipalkonfiguration des verwalteten instance für eine Ressource.
Name | Typ | Beschreibung |
---|---|---|
clientId |
string |
Die Client-ID der Azure Active Directory-Anwendung. |
principalId |
string |
Die Objekt-ID der Azure Active Directory-Anwendung. |
tenantId |
string |
Die Azure Active Directory-Mandanten-ID. |
type |
Dienstprinzipaltyp. |
ServicePrincipalType
Dienstprinzipaltyp.
Name | Typ | Beschreibung |
---|---|---|
None |
string |
|
SystemAssigned |
string |
Sku
Eine ARM-Ressourcen-SKU.
Name | Typ | Beschreibung |
---|---|---|
capacity |
integer |
Kapazität der jeweiligen SKU. |
family |
string |
Wenn der Dienst über unterschiedliche Hardwaregenerationen für dieselbe SKU verfügt, kann dies hier erfasst werden. |
name |
string |
Der Name der SKU, in der Regel ein Buchstabe + Zahlencode, z. B. P3. |
size |
string |
Größe der jeweiligen SKU |
tier |
string |
Der Tarif oder die Edition der jeweiligen SKU, z. B. Basic, Premium. |
UserIdentity
Azure Active Directory-Identitätskonfiguration für eine Ressource.
Name | Typ | Beschreibung |
---|---|---|
clientId |
string |
Die Azure Active Directory-Client-ID. |
principalId |
string |
Die Azure Active Directory-Prinzipal-ID. |