Managed Instances - List

Ruft eine Liste aller verwalteten Instanzen im Abonnement ab.

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

URI-Parameter

Name In Required Type Description
subscriptionId
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 Type Description
200 OK

Die Liste der verwalteten Instanzen wurde erfolgreich abgerufen.

Other Status Codes

Fehlerantworten: ***

Beispiele

List managed instances

Sample Request

GET https://management.azure.com/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Sql/managedInstances?api-version=2020-08-01-preview

Sample Response

{
  "value": [
    {
      "location": "japaneast",
      "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance1",
      "name": "testinstance1",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "GP_Gen4",
        "tier": "GeneralPurpose",
        "capacity": 8,
        "family": "Gen4"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance1.1b4e2caff2530.database.windows.net",
        "administratorLogin": "dummylogin",
        "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
        "state": "Ready",
        "vCores": 8,
        "storageSizeInGB": 1024,
        "licenseType": "LicenseIncluded",
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "publicDataEndpointEnabled": false,
        "proxyOverride": "Default",
        "dnsZone": "1b4e2caff2530",
        "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
        "storageAccountType": "GRS"
      }
    },
    {
      "location": "japaneast",
      "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/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/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/subnet2",
        "state": "Ready",
        "vCores": 16,
        "storageSizeInGB": 1024,
        "licenseType": "Full",
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "publicDataEndpointEnabled": false,
        "proxyOverride": "Default",
        "dnsZone": "2c3d1bdae3412",
        "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_2",
        "storageAccountType": "GRS"
      }
    }
  ]
}

Definitionen

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 Azure SQL verwaltete Instanz.

ManagedInstanceLicenseType

Der Lizenztyp. Mögliche Werte sind "LicenseIncluded" (regulärer Preis inklusive einer neuen SQL-Lizenz) und "BasePrice" (rabattierte AHB-Preise für das Bringen ihrer eigenen 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: Regelmäßige Instanzerstellung.

Wiederherstellung: Erstellt eine Instanz, indem eine Reihe von Sicherungen zu einem bestimmten Zeitpunkt wiederhergestellt wird. RestorePointInTime und SourceManagedInstanceId müssen angegeben werden.

ResourceIdentity

Azure Active Directory Identitätskonfiguration für eine Ressource.

Sku

Eine ARM-Ressourcen-SKU.

StorageAccountType

Der Speicherkontotyp, der zum Speichern von Sicherungen für diese Instanz verwendet wird. Die Optionen sind LRS (LokalRedundantStorage), ZRS (ZoneRedundantStorage) und GRS (GeoRedundantStorage)

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 Type Description
None
  • string
SystemAssigned
  • string
SystemAssigned,UserAssigned
  • string
UserAssigned
  • string

ManagedInstance

Eine Azure SQL verwaltete Instanz.

Name Type Description
id
  • string

Ressourcen-ID

identity

Die Azure Active Directory Identität der verwalteten Instanz.

location
  • string

Ressourcenspeicherort

name
  • string

Name der Ressource.

properties.administratorLogin
  • string

Administratorname 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 Anmeldekennwort des Administrators (erforderlich für die Erstellung verwalteter Instanzen).

properties.collation
  • string

Sortierung der verwalteten Instanz.

properties.dnsZone
  • string

Die Dns-Zone, in der sich die verwaltete Instanz befindet.

properties.dnsZonePartner
  • string

Die Ressourcen-ID einer anderen verwalteten Instanz, deren DNS-Zone diese verwaltete Instanz nach der Erstellung freigeben wird.

properties.fullyQualifiedDomainName
  • string

Der vollqualifizierte Domänenname der verwalteten Instanz.

properties.instancePoolId
  • string

Die ID des Instanzpools, zu dem dieser verwaltete Server gehört.

properties.licenseType

Der Lizenztyp. Mögliche Werte sind "LicenseIncluded" (regulärer Preis inklusive einer neuen SQL-Lizenz) und "BasePrice" (rabattierte AHB-Preise für das Bringen ihrer eigenen 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: Regelmäßige Instanzerstellung.

Wiederherstellung: 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.privateEndpointConnections

Liste der privaten Endpunktverbindungen in einer verwalteten Instanz.

properties.provisioningState enum:
  • Creating
  • Deleting
  • Failed
  • Succeeded
  • Unknown
  • Updating
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.restorePointInTime
  • string

Gibt den Zeitpunkt (ISO8601-Format) der Quelldatenbank an, die wiederhergestellt wird, um die neue Datenbank zu erstellen.

properties.sourceManagedInstanceId
  • string

Der Ressourcenbezeichner der verwalteten Quellinstanz, die dem Erstellungsvorgang dieser Instanz zugeordnet ist.

properties.state
  • string

Der Status der verwalteten Instanz.

properties.storageAccountType

Der Speicherkontotyp, der zum Speichern von Sicherungen für diese Instanz verwendet wird. Die Optionen sind LRS (LokalRedundantStorage), ZRS (ZoneRedundantStorage) und GRS (GeoRedundantStorage)

properties.storageSizeInGB
  • integer

Storage Größe in GB. Mindestwert: 32. Maximaler Wert: 8192. Nur 32 GB zulässig.

properties.subnetId
  • string

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 enthält 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 DEN SELECT-Namen 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. Europa Standardzeit".

properties.vCores
  • integer

Die Anzahl der vCores. Zulässige Werte: 8, 16, 24, 32, 40, 64, 80.

properties.zoneRedundant
  • boolean

Gibt an, ob das Multi-Az aktiviert ist.

sku

SKU der verwalteten Instanz. Zulässige Werte für sku.name: GP_Gen4, GP_Gen5, BC_Gen4, BC_Gen5

tags
  • object

Ressourcentags.

type
  • string

Der Ressourcentyp.

ManagedInstanceLicenseType

Der Lizenztyp. Mögliche Werte sind "LicenseIncluded" (regulärer Preis inklusive einer neuen SQL-Lizenz) und "BasePrice" (rabattierte AHB-Preise für das Bringen ihrer eigenen SQL Lizenzen).

Name Type Description
BasePrice
  • string
LicenseIncluded
  • string

ManagedInstanceListResult

Eine Liste der verwalteten Instanzen.

Name Type Description
nextLink
  • string

Link zum Abrufen der nächsten Seite der Ergebnisse.

value

Array von Ergebnissen.

ManagedInstancePecProperty

Eine private Endpunktverbindung unter einer verwalteten Instanz

Name Type Description
id
  • string

Ressourcen-ID

properties

Eigenschaften für private Endpunktverbindung

ManagedInstancePrivateEndpointConnectionProperties

Eigenschaften einer privaten Endpunktverbindung.

Name Type Description
privateEndpoint

Privater Endpunkt, zu dem die Verbindung gehört.

privateLinkServiceConnectionState

Verbindungsstatus der privaten Endpunktverbindung.

provisioningState
  • string

Status der privaten Endpunktverbindung.

ManagedInstancePrivateEndpointProperty

Name Type Description
id
  • string

Ressourcen-ID des privaten Endpunkts.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Name Type Description
actionsRequired
  • string

Die Beschreibung der Verbindung des privaten Linksdiensts.

description
  • string

Die Beschreibung der Verbindung des privaten Linksdiensts.

status
  • string

Der Status der Verbindung des privaten Linksdiensts.

ManagedInstanceProxyOverride

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

Name Type Description
Default
  • string
Proxy
  • string
Redirect
  • string

ManagedServerCreateMode

Gibt den Modus der Datenbankerstellung an.

Standard: Regelmäßige Instanzerstellung.

Wiederherstellung: Erstellt eine Instanz, indem eine Reihe von Sicherungen zu einem bestimmten Zeitpunkt wiederhergestellt wird. RestorePointInTime und SourceManagedInstanceId müssen angegeben werden.

Name Type Description
Default
  • string
PointInTimeRestore
  • string

ResourceIdentity

Azure Active Directory Identitätskonfiguration für eine Ressource.

Name Type Description
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.

Sku

Eine ARM-Ressourcen-SKU.

Name Type Description
capacity
  • integer

Kapazität der jeweiligen SKU.

family
  • string

Wenn der Dienst über unterschiedliche Hardwaregenerationen verfügt, für dieselbe SKU, kann dies hier erfasst werden.

name
  • string

Der Name der SKU, in der Regel ein Buchstaben + Zahlencode, z. B. P3.

size
  • string

Größe der bestimmten SKU

tier
  • string

Die Ebene oder Edition der jeweiligen SKU, z. B. Basic, Premium.

StorageAccountType

Der Speicherkontotyp, der zum Speichern von Sicherungen für diese Instanz verwendet wird. Die Optionen sind LRS (LokalRedundantStorage), ZRS (ZoneRedundantStorage) und GRS (GeoRedundantStorage)

Name Type Description
GRS
  • string
LRS
  • string
ZRS
  • string