Managed Instances - List

Referenz

Dienst:: SQL Database

API-Version:: 2023-08-01

Ruft eine Liste aller verwalteten Instanzen im Abonnement ab.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/managedInstances?api-version=2023-08-01

Mit optionalen Parametern:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/managedInstances?$expand={$expand}&api-version=2023-08-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
subscriptionId	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.
$expand	query		string	Die untergeordneten Ressourcen, die in die Antwort eingeschlossen werden sollen.

Antworten

Name	Typ	Beschreibung
200 OK	ManagedInstanceListResult	Die Liste der verwalteten Instanzen wurde erfolgreich abgerufen.
Other Status Codes	ErrorResponse	Fehlerantworten: ***

Beispiele

List managed instances

List managed instances with $expand=administrators/activedirectory

List managed instances

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:: 200

{
  "value": [
    {
      "location": "japaneast",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance1",
      "name": "testinstance1",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "GP_Gen5",
        "tier": "GeneralPurpose",
        "capacity": 8,
        "family": "Gen5"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance1.1b4e2caff2530.database.windows.net",
        "administratorLogin": "dummylogin",
        "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/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": "1b4e2caff2530",
        "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
        "currentBackupStorageRedundancy": "Geo",
        "requestedBackupStorageRedundancy": "Geo",
        "virtualClusterId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-5555555-6666-7777-8888-999999999999",
        "externalGovernanceStatus": "Enabled",
        "hybridSecondaryUsage": "Passive",
        "authenticationMetadata": "Windows",
        "pricingModel": "Regular",
        "createTime": "2022-11-01T01:01:01.011Z",
        "databaseFormat": "SQLServer2022"
      }
    },
    {
      "location": "japaneast",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance2",
      "name": "testinstance2",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "BC_Gen5",
        "tier": "BusinessCritical",
        "capacity": 16,
        "family": "Gen5"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance2.2c3d1bdae3412.database.windows.net",
        "administratorLogin": "dummylogin",
        "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/subnet2",
        "state": "Ready",
        "provisioningState": "Succeeded",
        "vCores": 16,
        "storageSizeInGB": 1024,
        "licenseType": "Full",
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "publicDataEndpointEnabled": false,
        "proxyOverride": "Default",
        "minimalTlsVersion": "1.2",
        "dnsZone": "2c3d1bdae3412",
        "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
        "currentBackupStorageRedundancy": "Geo",
        "requestedBackupStorageRedundancy": "Geo",
        "virtualClusterId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-5555555-6666-7777-8888-444444444444",
        "externalGovernanceStatus": "Enabled",
        "hybridSecondaryUsage": "Passive",
        "authenticationMetadata": "Windows",
        "pricingModel": "Regular",
        "createTime": "2022-11-01T01:01:01.011Z",
        "databaseFormat": "SQLServer2022"
      }
    }
  ]
}

List managed instances with $expand=administrators/activedirectory

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:: 200

{
  "value": [
    {
      "location": "japaneast",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance1",
      "name": "testinstance1",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "GP_Gen5",
        "tier": "GeneralPurpose",
        "capacity": 8,
        "family": "Gen4"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance1.1b4e2caff2530.database.windows.net",
        "administratorLogin": "dummylogin",
        "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/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": "1b4e2caff2530",
        "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
        "currentBackupStorageRedundancy": "Geo",
        "requestedBackupStorageRedundancy": "Geo",
        "virtualClusterId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-5555555-6666-7777-8888-999999999999",
        "administrators": {
          "principalType": "User",
          "login": "bob@contoso.com",
          "sid": "00000011-1111-2222-2222-123456789111",
          "tenantId": "00000011-1111-2222-2222-123456789111",
          "azureADOnlyAuthentication": true
        },
        "externalGovernanceStatus": "Enabled",
        "hybridSecondaryUsage": "Passive",
        "authenticationMetadata": "Windows",
        "pricingModel": "Regular",
        "createTime": "2022-11-01T01:01:01.011Z",
        "databaseFormat": "SQLServer2022"
      }
    },
    {
      "location": "japaneast",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance2",
      "name": "testinstance2",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "BC_Gen5",
        "tier": "BusinessCritical",
        "capacity": 16,
        "family": "Gen4"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance2.2c3d1bdae3412.database.windows.net",
        "administratorLogin": "dummylogin",
        "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/subnet2",
        "state": "Ready",
        "provisioningState": "Succeeded",
        "vCores": 16,
        "storageSizeInGB": 1024,
        "licenseType": "Full",
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "publicDataEndpointEnabled": false,
        "proxyOverride": "Default",
        "minimalTlsVersion": "1.2",
        "dnsZone": "2c3d1bdae3412",
        "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_2",
        "currentBackupStorageRedundancy": "Geo",
        "requestedBackupStorageRedundancy": "Geo",
        "virtualClusterId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-5555555-6666-7777-8888-444444444444",
        "administrators": {
          "principalType": "User",
          "login": "bob@contoso.com",
          "sid": "00000011-1111-2222-2222-123456789111",
          "tenantId": "00000011-1111-2222-2222-123456789111",
          "azureADOnlyAuthentication": true
        },
        "externalGovernanceStatus": "Enabled",
        "hybridSecondaryUsage": "Passive",
        "authenticationMetadata": "Windows",
        "pricingModel": "Regular",
        "createTime": "2022-11-01T01:01:01.011Z",
        "databaseFormat": "SQLServer2022"
      }
    }
  ]
}

Definitionen

Name	Beschreibung
AdministratorType	Typ des Serveradministrators.
AuthMetadataLookupModes	Nachschlagemodus für die Authentifizierungsmetadaten der verwalteten Instanz.
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)
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
ExternalGovernanceStatus	Status der externen Governance.
HybridSecondaryUsage	Hybride sekundäre Nutzung. Mögliche Werte sind "Aktiv" (Standardwert) und "Passiv" (Kunde verwendet die sekundäre als passive DR).
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).
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.
ManagedInstance	Eine von Azure SQL verwaltete Instanz.
ManagedInstanceDatabaseFormat	Gibt das interne Format von Instanzdatenbanken an, die für die SQL-Modulversion spezifisch sind.
ManagedInstanceExternalAdministrator	Eigenschaften eines Active Directory-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).
ManagedInstanceListResult	Eine Liste der verwalteten Instanzen.
ManagedInstancePecProperty	Eine private Endpunktverbindung unter einer verwalteten Instanz
ManagedInstancePrivateEndpointConnectionProperties	Eigenschaften einer privaten Endpunktverbindung.
ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride	Verbindungstyp, der für die Verbindung mit der Instanz verwendet wird.
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.
PricingModel	Preismodell der verwalteten Instanz.
PrincipalType	Prinzipaltyp des Serveradministrators.
ProvisioningState	Bereitstellungsstatus der verwalteten Instanz.
ResourceIdentity	Azure Active Directory-Identitätskonfiguration für eine Ressource.
ServicePrincipal	Die Dienstprinzipalkonfiguration der verwalteten Instanz für eine Ressource.
ServicePrincipalType	Dienstprinzipaltyp.
Sku	Eine ARM-Ressourcen-SKU.
UserIdentity	Azure Active Directory-Identitätskonfiguration für eine Ressource.

AdministratorType

Enumeration

Typ des Serveradministrators.

Wert	Beschreibung
ActiveDirectory

AuthMetadataLookupModes

Enumeration

Nachschlagemodus für die Authentifizierungsmetadaten der verwalteten Instanz.

Wert	Beschreibung
AzureAD
Paired
Windows

BackupStorageRedundancy

Enumeration

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

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

ExternalGovernanceStatus

Enumeration

Status der externen Governance.

Wert	Beschreibung
Disabled
Enabled

HybridSecondaryUsage

Enumeration

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

Enumeration

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

Enumeration

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

Objekt

Eine von Azure SQL verwaltete Instanz.

Name	Typ	Beschreibung
id	string	Ressourcen-ID.
identity	ResourceIdentity	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	ManagedInstanceExternalAdministrator	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	AuthMetadataLookupModes	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	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)
properties.databaseFormat	ManagedInstanceDatabaseFormat	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	ExternalGovernanceStatus	Status der externen Governance.
properties.fullyQualifiedDomainName	string	Der vollqualifizierte Domänenname der verwalteten Instanz.
properties.hybridSecondaryUsage	HybridSecondaryUsage	Hybride sekundäre Nutzung. Mögliche Werte sind "Aktiv" (Standardwert) und "Passiv" (Kunde verwendet die sekundäre als passive DR).
properties.hybridSecondaryUsageDetected	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	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).
properties.maintenanceConfigurationId	string	Gibt die Wartungskonfigurations-ID an, die auf diese verwaltete Instanz angewendet werden soll.
properties.managedInstanceCreateMode	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.
properties.minimalTlsVersion	string	Minimale TLS-Version. Zulässige Werte: 'None', '1.0', '1.1', '1.2'
properties.pricingModel	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	ManagedInstancePecProperty[]	Liste der privaten Endpunktverbindungen in einer verwalteten Instanz.
properties.provisioningState	ProvisioningState	Bereitstellungsstatus der verwalteten Instanz.
properties.proxyOverride	ManagedInstanceProxyOverride	Verbindungstyp, der für die Verbindung mit der Instanz verwendet wird.
properties.publicDataEndpointEnabled	boolean	Gibt an, ob der öffentliche Datenendpunkt aktiviert ist.
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	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	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	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

Enumeration

Gibt das interne Format von Instanzdatenbanken an, die für die SQL-Modulversion spezifisch sind.

Wert	Beschreibung
AlwaysUpToDate
SQLServer2022

ManagedInstanceExternalAdministrator

Objekt

Eigenschaften eines Active Directory-Administrators.

Name	Typ	Beschreibung
administratorType	AdministratorType	Typ des Serveradministrators.
azureADOnlyAuthentication	boolean	Nur Azure Active Directory-Authentifizierung aktiviert.
login	string	Anmeldename des Serveradministrators.
principalType	PrincipalType	Prinzipaltyp des Serveradministrators.
sid	string (uuid)	SID (Objekt-ID) des Serveradministrators.
tenantId	string (uuid)	Mandanten-ID des Administrators.

ManagedInstanceLicenseType

Enumeration

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

ManagedInstanceListResult

Objekt

Eine Liste der verwalteten Instanzen.

Name	Typ	Beschreibung
nextLink	string	Link zum Abrufen der nächsten Seite mit Ergebnissen.
value	ManagedInstance[]	Array von Ergebnissen.

ManagedInstancePecProperty

Objekt

Eine private Endpunktverbindung unter einer verwalteten Instanz

Name	Typ	Beschreibung
id	string	Ressourcen-ID.
properties	ManagedInstancePrivateEndpointConnectionProperties	Eigenschaften der privaten Endpunktverbindung

ManagedInstancePrivateEndpointConnectionProperties

Objekt

Eigenschaften einer privaten Endpunktverbindung.

Name	Typ	Beschreibung
privateEndpoint	ManagedInstancePrivateEndpointProperty	Privater Endpunkt, zu dem die Verbindung gehört.
privateLinkServiceConnectionState	ManagedInstancePrivateLinkServiceConnectionStateProperty	Verbindungsstatus der privaten Endpunktverbindung.
provisioningState	string	Status der privaten Endpunktverbindung.

ManagedInstancePrivateEndpointProperty

Objekt

Name	Typ	Beschreibung
id	string	Ressourcen-ID des privaten Endpunkts.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Objekt

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

Enumeration

Verbindungstyp, der für die Verbindung mit der Instanz verwendet wird.

Wert	Beschreibung
Default
Proxy
Redirect

ManagedServerCreateMode

Enumeration

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

Enumeration

Preismodell der verwalteten Instanz.

Wert	Beschreibung
Freemium
Regular

PrincipalType

Enumeration

Prinzipaltyp des Serveradministrators.

Wert	Beschreibung
Application
Group
User

ProvisioningState

Enumeration

Bereitstellungsstatus der verwalteten Instanz.

Wert	Beschreibung
Canceled
Created
Failed
InProgress
Succeeded

ResourceIdentity

Objekt

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	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.
userAssignedIdentities	<string, UserIdentity>	Die Ressourcen-IDs der vom Benutzer zugewiesenen Identitäten, die verwendet werden sollen

ServicePrincipal

Objekt

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	ServicePrincipalType	Dienstprinzipaltyp.

ServicePrincipalType

Enumeration

Dienstprinzipaltyp.

Wert	Beschreibung
None
SystemAssigned

Sku

Objekt

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

Objekt

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.

Freigeben über

Managed Instances - List

URI-Parameter

Antworten

Beispiele

List managed instances

Beispielanforderung

Beispiel für eine Antwort

List managed instances with $expand=administrators/activedirectory

Beispielanforderung

Beispiel für eine Antwort

Definitionen

AdministratorType

AuthMetadataLookupModes

BackupStorageRedundancy

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExternalGovernanceStatus

HybridSecondaryUsage

HybridSecondaryUsageDetected

IdentityType

ManagedInstance

ManagedInstanceDatabaseFormat

ManagedInstanceExternalAdministrator

ManagedInstanceLicenseType

ManagedInstanceListResult

ManagedInstancePecProperty

ManagedInstancePrivateEndpointConnectionProperties

ManagedInstancePrivateEndpointProperty

ManagedInstancePrivateLinkServiceConnectionStateProperty

ManagedInstanceProxyOverride

ManagedServerCreateMode

PricingModel

PrincipalType

ProvisioningState

ResourceIdentity

ServicePrincipal

ServicePrincipalType

Sku

UserIdentity

Zusätzliche Ressourcen