Managed Instances - Start
Startet die verwaltete Instanz.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/start?api-version=2023-08-01
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. Sie können diesen Wert aus der Azure Resource Manager-API oder dem Portal abrufen. |
subscription
|
path | True |
string |
Die Abonnement-ID, die ein Azure-Abonnement identifiziert. |
api-version
|
query | True |
string |
Die API-Version, die für die Anforderung verwendet werden soll. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Die verwaltete Instanz wurde erfolgreich gestartet. |
|
202 Accepted |
Das Starten der verwalteten Instanz wird ausgeführt. Header Location: string |
|
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
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 |
Nachschlagemodus für die Authentifizierungsmetadaten der verwalteten Instanz. |
Backup |
Der Speicherkontotyp, der zum Speichern von Sicherungen für diese Instanz verwendet wird. Die Optionen sind Lokal (LokalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) und GeoZone(GeoZoneRedundantStorage) |
Error |
Der Ressourcenverwaltungsfehler zusätzliche Informationen. |
Error |
Das Fehlerdetails. |
Error |
Fehlerantwort |
External |
Status der externen Governance. |
Hybrid |
Hybride sekundäre Nutzung. Mögliche Werte sind "Aktiv" (Standardwert) und "Passiv" (Kunde verwendet die sekundäre als passive DR). |
Hybrid |
Die sekundäre Hybridverwendung wurde erkannt. Mögliche Werte sind "Aktiv" (Kunde erfüllt nicht die Anforderungen für die Verwendung der sekundären als passiven DR) und "Passiv" (Kunde erfüllt die Anforderungen für die Verwendung der sekundären als passive DR). |
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 |
Eine von Azure SQL verwaltete Instanz. |
Managed |
Gibt das interne Format von Instanzdatenbanken an, die für die SQL-Modulversion 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" (reduzierter AHB-Preis für die Bereitstellung Eigener SQL-Lizenzen). |
Managed |
Eine private Endpunktverbindung unter einer verwalteten Instanz |
Managed |
Eigenschaften einer privaten Endpunktverbindung. |
Managed |
|
Managed |
|
Managed |
Verbindungstyp, der für die Verbindung mit der Instanz verwendet wird. |
Managed |
Gibt den Modus der Datenbankerstellung an. Standard: Normale Instanzerstellung. Wiederherstellen: Erstellt eine Instanz, indem eine Reihe von Sicherungen zu einem bestimmten Zeitpunkt wiederhergestellt wird. RestorePointInTime und SourceManagedInstanceId müssen angegeben werden. |
Pricing |
Preismodell der verwalteten Instanz. |
Principal |
Prinzipaltyp des Serveradministrators. |
Provisioning |
Bereitstellungsstatus der verwalteten Instanz. |
Resource |
Azure Active Directory-Identitätskonfiguration für eine Ressource. |
Service |
Die Dienstprinzipalkonfiguration der verwalteten Instanz 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.
Wert | Beschreibung |
---|---|
ActiveDirectory |
AuthMetadataLookupModes
Nachschlagemodus für die Authentifizierungsmetadaten der verwalteten Instanz.
Wert | Beschreibung |
---|---|
AzureAD | |
Paired | |
Windows |
BackupStorageRedundancy
Der Speicherkontotyp, der zum Speichern von Sicherungen für diese Instanz verwendet wird. Die Optionen sind Lokal (LokalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) und GeoZone(GeoZoneRedundantStorage)
Wert | Beschreibung |
---|---|
Geo | |
GeoZone | |
Local | |
Zone |
ErrorAdditionalInfo
Der Ressourcenverwaltungsfehler zusätzliche Informationen.
Name | Typ | Beschreibung |
---|---|---|
info |
object |
Die zusätzlichen Informationen. |
type |
string |
Der zusätzliche Informationstyp. |
ErrorDetail
Das Fehlerdetails.
Name | Typ | Beschreibung |
---|---|---|
additionalInfo |
Die zusätzlichen Informationen des Fehlers. |
|
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.
Wert | Beschreibung |
---|---|
Disabled | |
Enabled |
HybridSecondaryUsage
Hybride sekundäre Nutzung. Mögliche Werte sind "Aktiv" (Standardwert) und "Passiv" (Kunde verwendet die sekundäre als passive DR).
Wert | Beschreibung |
---|---|
Active | |
Passive |
HybridSecondaryUsageDetected
Die sekundäre Hybridverwendung wurde erkannt. Mögliche Werte sind "Aktiv" (Kunde erfüllt nicht die Anforderungen für die Verwendung der sekundären als passiven DR) und "Passiv" (Kunde erfüllt die Anforderungen für die Verwendung der sekundären als passive DR).
Wert | Beschreibung |
---|---|
Active | |
Passive |
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.
Wert | Beschreibung |
---|---|
None | |
SystemAssigned | |
SystemAssigned,UserAssigned | |
UserAssigned |
ManagedInstance
Eine von Azure SQL verwaltete Instanz.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Ressourcen-ID. |
identity |
Die Azure Active Directory-Identität der verwalteten Instanz. |
|
location |
string |
Ressourcenspeicherort. |
name |
string |
Ressourcenname. |
properties.administratorLogin |
string |
Administratorbenutzername für die verwaltete Instanz. Kann nur angegeben werden, wenn die verwaltete Instanz erstellt wird (und für die Erstellung erforderlich ist). |
properties.administratorLoginPassword |
string |
Das Administratoranmeldungskennwort (erforderlich für die Erstellung verwalteter Instanzen). |
properties.administrators |
Der Azure Active Directory-Administrator der Instanz. Dies kann nur zur Erstellungszeit der Instanz verwendet werden. Wenn sie z. B. aktualisiert wird, wird sie ignoriert oder führt zu einem Fehler. Für Updates müssen einzelne APIs verwendet werden. |
|
properties.authenticationMetadata |
Nachschlagemodus für die Authentifizierungsmetadaten der verwalteten Instanz. |
|
properties.collation |
string |
Sortierung der verwalteten Instanz. |
properties.createTime |
string (date-time) |
Gibt den Zeitpunkt (ISO8601 Format) der Erstellung verwalteter Instanzen an. |
properties.currentBackupStorageRedundancy |
Der Speicherkontotyp, der zum Speichern von Sicherungen für diese Instanz verwendet wird. Die Optionen sind Lokal (LokalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) und GeoZone(GeoZoneRedundantStorage) |
|
properties.databaseFormat |
Gibt das interne Format von Instanzdatenbanken an, die für die SQL-Modulversion spezifisch sind. |
|
properties.dnsZone |
string |
Die Dns-Zone, in der sich die verwaltete Instanz befindet. |
properties.dnsZonePartner |
string (arm-id) |
Die Ressourcen-ID einer anderen verwalteten Instanz, deren DNS-Zone diese verwaltete Instanz nach der Erstellung freigeben wird. |
properties.externalGovernanceStatus |
Status der externen Governance. |
|
properties.fullyQualifiedDomainName |
string |
Der vollqualifizierte Domänenname der verwalteten Instanz. |
properties.hybridSecondaryUsage |
Hybride sekundäre Nutzung. Mögliche Werte sind "Aktiv" (Standardwert) und "Passiv" (Kunde verwendet die sekundäre als passive DR). |
|
properties.hybridSecondaryUsageDetected |
Die sekundäre Hybridverwendung wurde erkannt. Mögliche Werte sind "Aktiv" (Kunde erfüllt nicht die Anforderungen für die Verwendung der sekundären als passiven DR) und "Passiv" (Kunde erfüllt die Anforderungen für die Verwendung der sekundären als passive DR). |
|
properties.instancePoolId |
string |
Die ID des Instanzpools, zu dem dieser verwaltete Server gehört. |
properties.isGeneralPurposeV2 |
boolean |
Gibt an, ob dies eine GPv2-Variante der General Purpose Edition ist. |
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" (reduzierter AHB-Preis für die Bereitstellung Eigener SQL-Lizenzen). |
|
properties.maintenanceConfigurationId |
string |
Gibt die Wartungskonfigurations-ID an, die auf diese verwaltete Instanz angewendet werden soll. |
properties.managedInstanceCreateMode |
Gibt den Modus der Datenbankerstellung an. Standard: Normale Instanzerstellung. Wiederherstellen: Erstellt eine Instanz, indem eine Reihe von Sicherungen zu einem 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 |
Preismodell der verwalteten Instanz. |
|
properties.primaryUserAssignedIdentityId |
string (arm-id) |
Die Ressourcen-ID einer vom Benutzer zugewiesenen Identität, die standardmäßig verwendet werden soll. |
properties.privateEndpointConnections |
Liste der privaten Endpunktverbindungen in einer verwalteten Instanz. |
|
properties.provisioningState |
Bereitstellungsstatus der verwalteten Instanz. |
|
properties.proxyOverride |
Verbindungstyp, der für die Verbindung mit der Instanz 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 Instanz verwendet werden soll. Die Optionen sind Lokal (LokalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) und GeoZone(GeoZoneRedundantStorage) |
|
properties.restorePointInTime |
string (date-time) |
Gibt den Zeitpunkt (ISO8601 Format) der Quelldatenbank an, die wiederhergestellt wird, um die neue Datenbank zu erstellen. |
properties.servicePrincipal |
Dienstprinzipal der verwalteten Instanz. |
|
properties.sourceManagedInstanceId |
string (arm-id) |
Der Ressourcenbezeichner der verwalteten Quellinstanz, die dem Erstellungsvorgang dieser Instanz zugeordnet ist. |
properties.state |
string |
Der Status der verwalteten Instanz. |
properties.storageIOps |
integer (int32) |
Speicher-IOps. Mindestwert: 300. Maximalwert: 80000. Nur Inkremente von 1 IOps zulässig. Der Maximalwert hängt von der ausgewählten Hardwarefamilie und der Anzahl der vCores ab. |
properties.storageSizeInGB |
integer (int32) |
Speichergröße in GB. Mindestwert: 32. Maximalwert: 16384. Nur Inkremente von 32 GB zulässig. Der Maximalwert hängt von der ausgewählten Hardwarefamilie und der Anzahl der vCores ab. |
properties.storageThroughputMBps |
integer (int32) |
Der MBps-Parameter für den Speicherdurchsatz wird im Erstellungs-/Aktualisierungsvorgang der Instanz nicht unterstützt. |
properties.subnetId |
string (arm-id) |
Subnetzressourcen-ID für die verwaltete Instanz. |
properties.timezoneId |
string |
ID der Zeitzone. Zulässige Werte sind Zeitzonen, die von Windows unterstützt werden. Windows speichert Details zu unterstützten Zeitzonen, einschließlich der ID, in der Registrierung unter KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Zeitzonen. 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 durch Ausführen von [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell abgerufen werden. Ein Beispiel für gültige Zeitzonen-ID ist "Pacific Standard Time" oder "W. Europe Standard Time". |
properties.vCores |
integer (int32) |
Die Anzahl der vCores. Zulässige Werte: 8, 16, 24, 32, 40, 64, 80. |
properties.virtualClusterId |
string |
Virtuelle Clusterressourcen-ID für die verwaltete Instanz. |
properties.zoneRedundant |
boolean |
Gibt an, ob das Multi-Az aktiviert ist. |
sku |
SKU der verwalteten Instanz. Zulässige Werte für sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH |
|
tags |
object |
Ressourcentags. |
type |
string |
Ressourcentyp. |
ManagedInstanceDatabaseFormat
Gibt das interne Format von Instanzdatenbanken an, die für die SQL-Modulversion spezifisch sind.
Wert | Beschreibung |
---|---|
AlwaysUpToDate | |
SQLServer2022 |
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 (uuid) |
SID (Objekt-ID) des Serveradministrators. |
tenantId |
string (uuid) |
Mandanten-ID des Administrators. |
ManagedInstanceLicenseType
Der Lizenztyp. Mögliche Werte sind "LicenseIncluded" (regulärer Preis inklusive einer neuen SQL-Lizenz) und "BasePrice" (reduzierter AHB-Preis für die Bereitstellung Eigener SQL-Lizenzen).
Wert | Beschreibung |
---|---|
BasePrice | |
LicenseIncluded |
ManagedInstancePecProperty
Eine private Endpunktverbindung unter einer verwalteten Instanz
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Ressourcen-ID. |
properties |
Eigenschaften der privaten Endpunktverbindung |
ManagedInstancePrivateEndpointConnectionProperties
Eigenschaften einer privaten Endpunktverbindung.
Name | Typ | Beschreibung |
---|---|---|
privateEndpoint |
Privater Endpunkt, zu dem die Verbindung gehört. |
|
privateLinkServiceConnectionState |
Verbindungsstatus der privaten Endpunktverbindung. |
|
provisioningState |
string |
Status der privaten Endpunktverbindung. |
ManagedInstancePrivateEndpointProperty
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Ressourcen-ID des privaten Endpunkts. |
ManagedInstancePrivateLinkServiceConnectionStateProperty
Name | Typ | Beschreibung |
---|---|---|
actionsRequired |
string |
Die Verbindungsbeschreibung des privaten Linksdiensts. |
description |
string |
Die Verbindungsbeschreibung des privaten Linksdiensts. |
status |
string |
Der Verbindungsstatus des privaten Verknüpfungsdiensts. |
ManagedInstanceProxyOverride
Verbindungstyp, der für die Verbindung mit der Instanz verwendet wird.
Wert | Beschreibung |
---|---|
Default | |
Proxy | |
Redirect |
ManagedServerCreateMode
Gibt den Modus der Datenbankerstellung an.
Standard: Normale Instanzerstellung.
Wiederherstellen: Erstellt eine Instanz, indem eine Reihe von Sicherungen zu einem bestimmten Zeitpunkt wiederhergestellt wird. RestorePointInTime und SourceManagedInstanceId müssen angegeben werden.
Wert | Beschreibung |
---|---|
Default | |
PointInTimeRestore |
PricingModel
Preismodell der verwalteten Instanz.
Wert | Beschreibung |
---|---|
Freemium | |
Regular |
PrincipalType
Prinzipaltyp des Serveradministrators.
Wert | Beschreibung |
---|---|
Application | |
Group | |
User |
ProvisioningState
Bereitstellungsstatus der verwalteten Instanz.
Wert | Beschreibung |
---|---|
Canceled | |
Created | |
Failed | |
InProgress | |
Succeeded |
ResourceIdentity
Azure Active Directory-Identitätskonfiguration für eine Ressource.
Name | Typ | Beschreibung |
---|---|---|
principalId |
string (uuid) |
Die Azure Active Directory-Prinzipal-ID. |
tenantId |
string (uuid) |
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-IDs der vom Benutzer zugewiesenen Identitäten, die verwendet werden sollen |
ServicePrincipal
Die Dienstprinzipalkonfiguration der verwalteten Instanz für eine Ressource.
Name | Typ | Beschreibung |
---|---|---|
clientId |
string |
Die Client-ID der Azure Active Directory-Anwendung. |
principalId |
string |
Die Id des Azure Active Directory-Anwendungsobjekts. |
tenantId |
string |
Die Azure Active Directory-Mandanten-ID. |
type |
Dienstprinzipaltyp. |
ServicePrincipalType
Dienstprinzipaltyp.
Wert | Beschreibung |
---|---|
None | |
SystemAssigned |
Sku
Eine ARM-Ressourcen-SKU.
Name | Typ | Beschreibung |
---|---|---|
capacity |
integer (int32) |
Kapazität der jeweiligen SKU. |
family |
string |
Wenn der Dienst über unterschiedliche Hardwaregenerationen verfügt, kann dies für dieselbe SKU 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 |
Die Stufe oder Edition der jeweiligen SKU, z. B. Basic, Premium. |
UserIdentity
Azure Active Directory-Identitätskonfiguration für eine Ressource.
Name | Typ | Beschreibung |
---|---|---|
clientId |
string (uuid) |
Die Azure Active Directory-Client-ID. |
principalId |
string (uuid) |
Die Azure Active Directory-Prinzipal-ID. |