Managed Instances - List

Riferimento

Service:: SQL Database

API Version:: 2021-11-01

Ottiene un elenco di tutte le istanze gestite nella sottoscrizione.

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

With optional parameters:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
subscriptionId	path	True	string	ID sottoscrizione che identifica una sottoscrizione di Azure.
api-version	query	True	string	Versione dell'API da usare per la richiesta.
$expand	query		string	Le risorse figlio da includere nella risposta.

Risposte

Nome	Tipo	Descrizione
200 OK	ManagedInstanceListResult	È stato recuperato correttamente l'elenco di istanze gestite.
Other Status Codes		Risposte agli errori: **

Esempio

List managed instances

List managed instances with $expand=administrators/activedirectory

List managed instances

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


import com.azure.core.util.Context;

/** Samples for ManagedInstances List. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedInstanceList.json
     */
    /**
     * Sample code: List managed instances.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listManagedInstances(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstances().list(null, Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

{
  "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",
        "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/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
        "currentBackupStorageRedundancy": "Geo",
        "requestedBackupStorageRedundancy": "Geo"
      }
    },
    {
      "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",
        "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/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
        "currentBackupStorageRedundancy": "Geo",
        "requestedBackupStorageRedundancy": "Geo"
      }
    }
  ]
}

List managed instances with $expand=administrators/activedirectory

Sample Request

HTTP
Java

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


import com.azure.core.util.Context;

/** Samples for ManagedInstances List. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedInstanceListWithExpandEqualsAdministrators.json
     */
    /**
     * Sample code: List managed instances with $expand=administrators/activedirectory.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listManagedInstancesWithExpandAdministratorsActivedirectory(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstances().list(null, Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

{
  "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",
        "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/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
        "currentBackupStorageRedundancy": "Geo",
        "requestedBackupStorageRedundancy": "Geo",
        "administrators": {
          "principalType": "User",
          "login": "bob@contoso.com",
          "sid": "00000011-1111-2222-2222-123456789111",
          "tenantId": "00000011-1111-2222-2222-123456789111",
          "azureADOnlyAuthentication": true
        }
      }
    },
    {
      "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",
        "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/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_2",
        "currentBackupStorageRedundancy": "Geo",
        "requestedBackupStorageRedundancy": "Geo",
        "administrators": {
          "principalType": "User",
          "login": "bob@contoso.com",
          "sid": "00000011-1111-2222-2222-123456789111",
          "tenantId": "00000011-1111-2222-2222-123456789111",
          "azureADOnlyAuthentication": true
        }
      }
    }
  ]
}

Definizioni

Nome	Descrizione
AdministratorType	Tipo dell'amministratore di sever.
BackupStorageRedundancy	Tipo di account di archiviazione usato per archiviare i backup per questa istanza. Le opzioni sono Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)
IdentityType	Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di Azure Active Directory per la risorsa.
ManagedInstance	Istanza gestita di Azure SQL.
ManagedInstanceExternalAdministrator	Proprietà di un amministratore di Active Directory.
ManagedInstanceLicenseType	Tipo di licenza. I valori possibili sono "LicenseIncluded" (prezzo regolare inclusivo di una nuova licenza SQL) e "BasePrice" (prezzo AHB scontato per portare le proprie licenze SQL).
ManagedInstanceListResult	Elenco di istanze gestite.
ManagedInstancePecProperty	Una connessione endpoint privato in un'istanza gestita
ManagedInstancePrivateEndpointConnectionProperties	Proprietà di una connessione endpoint privato.
ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride	Tipo di connessione utilizzato per la connessione all'istanza di .
ManagedServerCreateMode	Specifica la modalità di creazione del database. Impostazione predefinita: creazione di istanze regolari. Ripristino: crea un'istanza ripristinando un set di backup in un momento specifico. È necessario specificare RestorePointInTime e SourceManagedInstanceId.
PrincipalType	Tipo di entità dell'amministratore di sever.
ResourceIdentity	Configurazione dell'identità di Azure Active Directory per una risorsa.
ServicePrincipal	Configurazione dell'entità servizio dell'istanza gestita per una risorsa.
ServicePrincipalType	Tipo di entità servizio.
Sku	SKU della risorsa ARM.
UserIdentity	Configurazione dell'identità di Azure Active Directory per una risorsa.

AdministratorType

Tipo dell'amministratore di sever.

Nome	Tipo	Descrizione
ActiveDirectory	string

BackupStorageRedundancy

Tipo di account di archiviazione usato per archiviare i backup per questa istanza. Le opzioni sono Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)

Nome	Tipo	Descrizione
Geo	string
GeoZone	string
Local	string
Zone	string

IdentityType

Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di Azure Active Directory per la risorsa.

Nome	Tipo	Descrizione
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

ManagedInstance

Istanza gestita di Azure SQL.

Nome	Tipo	Descrizione
id	string	ID risorsa.
identity	ResourceIdentity	Identità di Azure Active Directory dell'istanza gestita.
location	string	Percorso della risorsa.
name	string	Nome risorsa.
properties.administratorLogin	string	Nome utente amministratore per l'istanza gestita. Può essere specificato solo quando viene creata l'istanza gestita ed è necessaria per la creazione.
properties.administratorLoginPassword	string	Password di accesso dell'amministratore (necessaria per la creazione dell'istanza gestita).
properties.administrators	ManagedInstanceExternalAdministrator	Amministratore di Azure Active Directory del server.
properties.collation	string	Regole di confronto dell'istanza gestita.
properties.currentBackupStorageRedundancy	BackupStorageRedundancy	Tipo di account di archiviazione usato per archiviare i backup per questa istanza. Le opzioni sono Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)
properties.dnsZone	string	Zona DNS in cui si trova l'istanza gestita.
properties.dnsZonePartner	string	ID risorsa di un'altra istanza gestita la cui zona DNS questa istanza gestita condividerà dopo la creazione.
properties.fullyQualifiedDomainName	string	Nome di dominio completo dell'istanza gestita.
properties.instancePoolId	string	ID del pool di istanze a cui appartiene il server gestito.
properties.keyId	string	URI cmk della chiave da usare per la crittografia.
properties.licenseType	ManagedInstanceLicenseType	Tipo di licenza. I valori possibili sono "LicenseIncluded" (prezzo regolare inclusivo di una nuova licenza SQL) e "BasePrice" (prezzo AHB scontato per portare le proprie licenze SQL).
properties.maintenanceConfigurationId	string	Specifica l'ID di configurazione della manutenzione da applicare a questa istanza gestita.
properties.managedInstanceCreateMode	ManagedServerCreateMode	Specifica la modalità di creazione del database. Impostazione predefinita: creazione di istanze regolari. Ripristino: crea un'istanza ripristinando un set di backup in un momento specifico. È necessario specificare RestorePointInTime e SourceManagedInstanceId.
properties.minimalTlsVersion	string	Versione minima di TLS. Valori consentiti: 'None', '1.0', '1.1', '1.2'
properties.primaryUserAssignedIdentityId	string	ID risorsa di un'identità assegnata dall'utente da usare per impostazione predefinita.
properties.privateEndpointConnections	ManagedInstancePecProperty[]	Elenco di connessioni di endpoint privato in un'istanza gestita.
properties.provisioningState	enum: Accepted Canceled Created Creating Deleted Deleting Failed NotSpecified Registering Running Succeeded TimedOut Unknown Unrecognized Updating
properties.proxyOverride	ManagedInstanceProxyOverride	Tipo di connessione utilizzato per la connessione all'istanza di .
properties.publicDataEndpointEnabled	boolean	Indica se l'endpoint dati pubblico è abilitato o meno.
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Tipo di account di archiviazione da usare per archiviare i backup per questa istanza. Le opzioni sono Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)
properties.restorePointInTime	string	Specifica il punto nel tempo (ISO8601 formato) del database di origine che verrà ripristinato per creare il nuovo database.
properties.servicePrincipal	ServicePrincipal	Entità servizio dell'istanza gestita.
properties.sourceManagedInstanceId	string	Identificatore della risorsa dell'istanza gestita di origine associata all'operazione di creazione di questa istanza.
properties.state	string	Stato dell'istanza gestita.
properties.storageSizeInGB	integer	Dimensioni di archiviazione in GB. Valore minimo: 32. Valore massimo: 16384. Incrementi di 32 GB consentiti solo. Il valore massimo dipende dalla famiglia di hardware selezionata e dal numero di vCore.
properties.subnetId	string	ID risorsa subnet per l'istanza gestita.
properties.timezoneId	string	ID del fuso orario. I valori consentiti sono fusi orari supportati da Windows. Windows mantiene i dettagli sui fusi orari supportati, incluso l'ID, nel Registro di sistema in KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. È possibile ottenere tali valori del Registro di sistema tramite SQL Server eseguendo una query su SELECT name AS timezone_id FROM sys.time_zone_info. È anche possibile ottenere un elenco di ID eseguendo [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell. Un esempio di ID fuso orario valido è "Pacific Standard Time" o "W. Ora solare europa".
properties.vCores	integer	Numero di vCore. Valori consentiti: 8, 16, 24, 32, 40, 64, 80.
properties.zoneRedundant	boolean	Indica se multi-az è abilitato o meno.
sku	Sku	SKU dell'istanza gestita. Valori consentiti per sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH
tags	object	Tag delle risorse.
type	string	Tipo di risorsa.

ManagedInstanceExternalAdministrator

Proprietà di un amministratore di Active Directory.

Nome	Tipo	Descrizione
administratorType	AdministratorType	Tipo di amministratore del server.
azureADOnlyAuthentication	boolean	Autenticazione di Azure Active Directory abilitata solo.
login	string	Nome di accesso dell'amministratore del server.
principalType	PrincipalType	Tipo di entità dell'amministratore del server.
sid	string	SID (ID oggetto) dell'amministratore del server.
tenantId	string	ID tenant dell'amministratore.

ManagedInstanceLicenseType

Tipo di licenza. I valori possibili sono "LicenseIncluded" (prezzo regolare inclusivo di una nuova licenza SQL) e "BasePrice" (prezzo AHB scontato per portare le proprie licenze SQL).

Nome	Tipo	Descrizione
BasePrice	string
LicenseIncluded	string

ManagedInstanceListResult

Elenco di istanze gestite.

Nome	Tipo	Descrizione
nextLink	string	Collegamento per recuperare la pagina successiva dei risultati.
value	ManagedInstance[]	Matrice di risultati.

ManagedInstancePecProperty

Una connessione endpoint privato in un'istanza gestita

Nome	Tipo	Descrizione
id	string	ID risorsa.
properties	ManagedInstancePrivateEndpointConnectionProperties	Proprietà di connessione dell'endpoint privato

ManagedInstancePrivateEndpointConnectionProperties

Proprietà di una connessione endpoint privato.

Nome	Tipo	Descrizione
privateEndpoint	ManagedInstancePrivateEndpointProperty	Endpoint privato a cui appartiene la connessione.
privateLinkServiceConnectionState	ManagedInstancePrivateLinkServiceConnectionStateProperty	Stato della connessione dell'endpoint privato.
provisioningState	string	Stato della connessione endpoint privato.

ManagedInstancePrivateEndpointProperty

Nome	Tipo	Descrizione
id	string	ID risorsa dell'endpoint privato.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Nome	Tipo	Descrizione
actionsRequired	string	Descrizione della connessione al servizio collegamento privato.
description	string	Descrizione della connessione al servizio collegamento privato.
status	string	Stato di connessione del servizio di collegamento privato.

ManagedInstanceProxyOverride

Tipo di connessione utilizzato per la connessione all'istanza di .

Nome	Tipo	Descrizione
Default	string
Proxy	string
Redirect	string

ManagedServerCreateMode

Specifica la modalità di creazione del database.

Impostazione predefinita: creazione di istanze regolari.

Ripristino: crea un'istanza ripristinando un set di backup in un momento specifico. È necessario specificare RestorePointInTime e SourceManagedInstanceId.

Nome	Tipo	Descrizione
Default	string
PointInTimeRestore	string

PrincipalType

Tipo di entità dell'amministratore di sever.

Nome	Tipo	Descrizione
Application	string
Group	string
User	string

ResourceIdentity

Configurazione dell'identità di Azure Active Directory per una risorsa.

Nome	Tipo	Descrizione
principalId	string	ID entità di Azure Active Directory.
tenantId	string	ID tenant di Azure Active Directory.
type	IdentityType	Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di Azure Active Directory per la risorsa.
userAssignedIdentities	<string, UserIdentity>	ID risorsa delle identità assegnate dall'utente da usare

ServicePrincipal

Configurazione dell'entità servizio dell'istanza gestita per una risorsa.

Nome	Tipo	Descrizione
clientId	string	ID client dell'applicazione Azure Active Directory.
principalId	string	ID oggetto applicazione di Azure Active Directory.
tenantId	string	ID tenant di Azure Active Directory.
type	ServicePrincipalType	Tipo di entità servizio.

ServicePrincipalType

Tipo di entità servizio.

Nome	Tipo	Descrizione
None	string
SystemAssigned	string

Sku

SKU della risorsa ARM.

Nome	Tipo	Descrizione
capacity	integer	Capacità dello SKU specifico.
family	string	Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, può essere acquisito qui.
name	string	Nome dello SKU, in genere una lettera + codice numerico, ad esempio P3.
size	string	Dimensioni dello SKU specifico
tier	string	Livello o edizione dello SKU specifico, ad esempio Basic, Premium.

UserIdentity

Configurazione dell'identità di Azure Active Directory per una risorsa.

Nome	Tipo	Descrizione
clientId	string	ID client di Azure Active Directory.
principalId	string	ID entità di Azure Active Directory.

Managed Instances - List

Parametri dell'URI

Risposte

Esempio

List managed instances

Sample Request

Sample Response

List managed instances with $expand=administrators/activedirectory

Sample Request

Sample Response

Definizioni

AdministratorType

BackupStorageRedundancy

IdentityType

ManagedInstance

ManagedInstanceExternalAdministrator

ManagedInstanceLicenseType

ManagedInstanceListResult

ManagedInstancePecProperty

ManagedInstancePrivateEndpointConnectionProperties

ManagedInstancePrivateEndpointProperty

ManagedInstancePrivateLinkServiceConnectionStateProperty

ManagedInstanceProxyOverride

ManagedServerCreateMode

PrincipalType

ResourceIdentity

ServicePrincipal

ServicePrincipalType

Sku

UserIdentity

Risorse aggiuntive