Managed Instances - List

Servizio:: SQL Database

Versione API:: 2025-01-01

Ottiene un elenco di tutte le istanze gestite nella sottoscrizione.

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

Con parametri facoltativi:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.
$expand	query		string	Risorse figlio da includere nella risposta.

Risposte

Nome	Tipo	Descrizione
200 OK	ManagedInstanceListResult	Operazione Azure completata con successo.
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Sicurezza

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

List managed instances

List managed instances with $expand=administrators/activedirectory

List managed instances

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 200

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

List managed instances with $expand=administrators/activedirectory

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 200

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

Definizioni

Nome	Descrizione
AdministratorType	Tipo dell'amministratore di sever.
AuthMetadataLookupModes	Modalità di ricerca dei metadati di autenticazione dell'istanza gestita.
AvailabilityZoneType	Specifica la zona di disponibilità a cui viene aggiunto il database.
BackupStorageRedundancy	Tipo di account di archiviazione usato per archiviare i backup per questo database.
createdByType	Tipo di identità che ha creato la risorsa.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
ExternalGovernanceStatus	Stato della governance esterna.
HybridSecondaryUsage	Uso secondario ibrido. I valori possibili sono 'Active' (valore predefinito) e 'Passive' (il cliente usa il database secondario come ripristino di emergenza passivo).
HybridSecondaryUsageDetected	Rilevato utilizzo secondario ibrido. I valori possibili sono "Active" (il cliente non soddisfa i requisiti per l'uso del ripristino di emergenza passivo) e "Passivo" (il cliente soddisfa i requisiti per usare il database secondario come ripristino di emergenza passivo).
IdentityType	Tipo di identità. Imposta questo su 'SystemAssigned' per creare e assegnare automaticamente un Azure Active Directory principal per la risorsa.
ManagedInstance	Un'istanza gestita di Azure SQL.
ManagedInstanceDatabaseFormat	Specifica il formato interno dei database dell'istanza specifici della versione del motore 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	La risposta di un'operazione di lista ManagedInstance.
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 a un punto specifico nel tempo. È necessario specificare RestorePointInTime e SourceManagedInstanceId.
PricingModel	Modello di pricing di Istanza gestita.
PrincipalType	Tipo di entità dell'amministratore di sever.
ProvisioningState	Stato di provisioning arm dell'esecuzione del processo.
ResourceIdentity	Azure Active Directory configurazione dell'identità per una risorsa.
ServicePrincipal	Configurazione dell'entità servizio dell'istanza gestita per una risorsa.
ServicePrincipalType	Tipo di entità servizio.
Sku	SKU della risorsa ARM.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
UserIdentity	Azure Active Directory configurazione dell'identità per una risorsa.

AdministratorType

Enumerazione

Tipo dell'amministratore di sever.

Valore	Descrizione
ActiveDirectory	Istanza di ActiveDirectory

AuthMetadataLookupModes

Enumerazione

Modalità di ricerca dei metadati di autenticazione dell'istanza gestita.

Valore	Descrizione
AzureAD	Azure AD
Paired	Accoppiati
Windows	Windows

AvailabilityZoneType

Enumerazione

Specifica la zona di disponibilità a cui viene aggiunto il database.

Valore	Descrizione
NoPreference	Nessuna preferenza
1	1
2	2
3	3

BackupStorageRedundancy

Enumerazione

Tipo di account di archiviazione usato per archiviare i backup per questo database.

Valore	Descrizione
Geo	Geo
Local	Locale
Zone	Zona
GeoZone	GeoZone

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ExternalGovernanceStatus

Enumerazione

Stato della governance esterna.

Valore	Descrizione
Enabled	Enabled
Disabled	Disattivato

HybridSecondaryUsage

Enumerazione

Uso secondario ibrido. I valori possibili sono 'Active' (valore predefinito) e 'Passive' (il cliente usa il database secondario come ripristino di emergenza passivo).

Valore	Descrizione
Active	Active
Passive	Passive

HybridSecondaryUsageDetected

Enumerazione

Rilevato utilizzo secondario ibrido. I valori possibili sono "Active" (il cliente non soddisfa i requisiti per l'uso del ripristino di emergenza passivo) e "Passivo" (il cliente soddisfa i requisiti per usare il database secondario come ripristino di emergenza passivo).

Valore	Descrizione
Active	Active
Passive	Passive

IdentityType

Enumerazione

Tipo di identità. Imposta questo su 'SystemAssigned' per creare e assegnare automaticamente un Azure Active Directory principal per la risorsa.

Valore	Descrizione
None	Nessuno
SystemAssigned	Assegnato dal sistema
UserAssigned	UserAssigned
SystemAssigned,UserAssigned	SystemAssigned, UserAssigned

ManagedInstance

Oggetto

Un'istanza gestita di Azure SQL.

Nome	Tipo	Descrizione
id	string (arm-id)	ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ResourceIdentity	L'identità di Azure Active Directory dell'istanza gestita.
location	string	Posizione geografica in cui risiede la risorsa
name	string	Nome della risorsa
properties.administratorLogin	string	Nome utente amministratore per l'istanza gestita. Può essere specificato solo quando l'istanza gestita viene creata (ed è necessaria per la creazione).
properties.administratorLoginPassword	string (password)	Password di accesso dell'amministratore (necessaria per la creazione dell'istanza gestita).
properties.administrators	ManagedInstanceExternalAdministrator	L'amministratore di Azure Active Directory può essere utilizzato durante la creazione delle istanze e per gli aggiornamenti delle istanze, ad eccezione della proprietà azureADOnlyAuthentication. Per aggiornare la proprietà azureADOnlyAuthentication, è necessario usare una singola API.
properties.authenticationMetadata	AuthMetadataLookupModes	Modalità di ricerca dei metadati di autenticazione dell'istanza gestita.
properties.collation	string	Regole di confronto dell'istanza gestita.
properties.createTime	string (date-time)	Specifica il momento nel tempo (formato ISO8601) della creazione della 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.databaseFormat	ManagedInstanceDatabaseFormat	Specifica il formato interno dei database dell'istanza specifici della versione del motore SQL.
properties.dnsZone	string	Zona DNS in cui si trova l'istanza gestita.
properties.dnsZonePartner	string (arm-id)	ID risorsa di un'altra istanza gestita la cui zona DNS questa istanza gestita condividerà dopo la creazione.
properties.externalGovernanceStatus	ExternalGovernanceStatus	Stato della governance esterna.
properties.fullyQualifiedDomainName	string	Nome di dominio completo dell'istanza gestita.
properties.hybridSecondaryUsage	HybridSecondaryUsage	Uso secondario ibrido. I valori possibili sono 'Active' (valore predefinito) e 'Passive' (il cliente usa il database secondario come ripristino di emergenza passivo).
properties.hybridSecondaryUsageDetected	HybridSecondaryUsageDetected	Rilevato utilizzo secondario ibrido. I valori possibili sono "Active" (il cliente non soddisfa i requisiti per l'uso del ripristino di emergenza passivo) e "Passivo" (il cliente soddisfa i requisiti per usare il database secondario come ripristino di emergenza passivo).
properties.instancePoolId	string	ID del pool di istanze a cui appartiene il server gestito.
properties.isGeneralPurposeV2	boolean	Indica se si tratta di una variante GPv2 dell'edizione Per utilizzo generico.
properties.keyId	string	URI 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 a un punto specifico nel tempo. È necessario specificare RestorePointInTime e SourceManagedInstanceId.
properties.memorySizeInGB	integer (int32)	Dimensione della memoria in GB. Valore minimo: 28. Valore massimo: 870. Il valore minimo e massimo dipendono dal numero di vCore e dal livello di servizio. Per saperne di più sui limiti delle risorse: https://aka.ms/mi-resource-limits-api.
properties.minimalTlsVersion	string	Versione minima di TLS. Valori consentiti: 'Nessuno', '1.0', '1.1', '1.2'
properties.pricingModel	PricingModel	Modello di pricing di Istanza gestita.
properties.primaryUserAssignedIdentityId	string (arm-id)	ID risorsa di un'identità assegnata dall'utente da usare per impostazione predefinita.
properties.privateEndpointConnections	ManagedInstancePecProperty[]	Elenco delle connessioni di endpoint privato in un'istanza gestita.
properties.provisioningState	ProvisioningState	Stato di provisioning dell'istanza gestita.
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.requestedLogicalAvailabilityZone	AvailabilityZoneType	Specifica la zona di disponibilità logica a cui è fissata Istanza gestita.
properties.restorePointInTime	string (date-time)	Specifica il punto nel tempo (formato ISO8601) del database di origine che verrà ripristinato per creare il nuovo database.
properties.servicePrincipal	ServicePrincipal	Entità servizio dell'istanza gestita.
properties.sourceManagedInstanceId	string (arm-id)	Identificatore della risorsa dell'istanza gestita di origine associata all'operazione di creazione di questa istanza.
properties.state	string	Stato dell'istanza gestita.
properties.storageIOps	integer (int32)	I/O al secondo di archiviazione. Valore minimo: 300. Valore massimo: 80000. Incrementi di 1 operazioni di I/O al secondo consentite solo. Il valore massimo dipende dalla famiglia di hardware e dal numero di vCore selezionati.
properties.storageSizeInGB	integer (int32)	Dimensioni di archiviazione in GB. Valore minimo: 32. Valore massimo: 32768. Incrementi di soli 32 GB consentiti. Il valore massimo dipende dalla famiglia di hardware e dal numero di vCore selezionati.
properties.storageThroughputMBps	integer (int32)	Il parametro MBps della velocità effettiva di archiviazione non è supportato nell'operazione di creazione/aggiornamento dell'istanza.
properties.subnetId	string (arm-id)	ID risorsa subnet per l'istanza gestita.
properties.timezoneId	string	ID del fuso orario. I valori consentiti sono fusi orari supportati da Windows. Windows conserva i dettagli sui fusi orari supportati, incluso l'id, nel registro sotto KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. Puoi ottenere quei valori del registro tramite SQL Server interrogando SELECT name AS timezone_id DA 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 (int32)	Numero di vCore. Valori consentiti: 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. I vCore supportati dipendono dalla famiglia di hardware e dal livello di servizio selezionati.
properties.virtualClusterId	string	ID risorsa del cluster virtuale per la Istanza gestita.
properties.zoneRedundant	boolean	Se la ridondanza della zona è abilitata o meno.
sku	Sku	SKU dell'istanza gestita. Valori consentiti per sku.name: GP_Gen5 (General Purpose, serie standard); GP_G8IM (General Purpose, serie Premium); GP_G8IH (per utilizzo generico, ottimizzata per la memoria della serie Premium); BC_Gen5 (Business Critical, Standard-Series); BC_G8IM (Business Critical, serie Premium); BC_G8IH (Business Critical, ottimizzata per la memoria della serie Premium).
systemData	systemData	Azure Resource Manager metadati contenenti informazioni createBy e modifiedBy.
tags	object	Tag di risorsa.
type	string	Tipo di risorsa. Ad esempio: "Microsoft. Compute/virtualMachines" oppure "Microsoft. Storage/storageAccounts"

ManagedInstanceDatabaseFormat

Enumerazione

Specifica il formato interno dei database dell'istanza specifici della versione del motore SQL.

Valore	Descrizione
AlwaysUpToDate	AlwaysToDate
SQLServer2022	SQLServer2022
SQLServer2025	SQLServer2025

ManagedInstanceExternalAdministrator

Oggetto

Proprietà di un amministratore di Active Directory.

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

ManagedInstanceLicenseType

Enumerazione

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).

Valore	Descrizione
LicenseIncluded	LicenzaInclusa
BasePrice	BasePrice

ManagedInstanceListResult

Oggetto

La risposta di un'operazione di lista ManagedInstance.

Nome	Tipo	Descrizione
nextLink	string (uri)	Il link alla pagina successiva degli elementi
value	ManagedInstance[]	Gli elementi ManagedInstance presenti in questa pagina

ManagedInstancePecProperty

Oggetto

Una connessione endpoint privato in un'istanza gestita

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

ManagedInstancePrivateEndpointConnectionProperties

Oggetto

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

Oggetto

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

ManagedInstancePrivateLinkServiceConnectionStateProperty

Oggetto

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

ManagedInstanceProxyOverride

Enumerazione

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

Valore	Descrizione
Proxy	Proxy
Redirect	Reindirizzare
Default	Valore predefinito

ManagedServerCreateMode

Enumerazione

Specifica la modalità di creazione del database.

Impostazione predefinita: creazione di istanze regolari.

Ripristino: crea un'istanza ripristinando un set di backup a un punto specifico nel tempo. È necessario specificare RestorePointInTime e SourceManagedInstanceId.

Valore	Descrizione
Default	Valore predefinito
PointInTimeRestore	PointInTimeRestore

PricingModel

Enumerazione

Modello di pricing di Istanza gestita.

Valore	Descrizione
Regular	Regolare
Freemium	Freemium

PrincipalType

Enumerazione

Tipo di entità dell'amministratore di sever.

Valore	Descrizione
User	User
Group	Gruppo
Application	Applicazione

ProvisioningState

Enumerazione

Stato di provisioning arm dell'esecuzione del processo.

Valore	Descrizione
Created	Creato
InProgress	In corso
Succeeded	Succeeded
Failed	Non riuscito
Canceled	Operazione annullata

ResourceIdentity

Oggetto

Azure Active Directory configurazione dell'identità per una risorsa.

Nome	Tipo	Descrizione
principalId	string (uuid)	L'id principale di Azure Active Directory.
tenantId	string (uuid)	L'ID tenant di Azure Active Directory.
type	IdentityType	Tipo di identità. Imposta questo su 'SystemAssigned' per creare e assegnare automaticamente un Azure Active Directory principal per la risorsa.
userAssignedIdentities	<string, UserIdentity>	ID risorsa delle identità assegnate dall'utente da usare

ServicePrincipal

Oggetto

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

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

ServicePrincipalType

Enumerazione

Tipo di entità servizio.

Valore	Descrizione
None	Nessuno
SystemAssigned	Assegnato dal sistema

Sku

Oggetto

SKU della risorsa ARM.

Nome	Tipo	Descrizione
capacity	integer (int32)	Capacità dello SKU specifico.
family	string	Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui.
name	string	Il nome dello SKU, in genere, una lettera + codice numerico, ad esempio P3.
size	string	Dimensioni dello SKU specifico
tier	string	Il livello o l'edizione dello SKU specifico, ad esempio Basic, Premium.

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Il timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

UserIdentity

Oggetto

Azure Active Directory configurazione dell'identità per una risorsa.

Nome	Tipo	Descrizione
clientId	string (uuid)	L'ID client di Azure Active Directory.
principalId	string (uuid)	L'id principale di Azure Active Directory.

Condividi tramite

Managed Instances - List

Parametri dell'URI

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

List managed instances

Esempio di richiesta

Risposta di esempio

List managed instances with $expand=administrators/activedirectory

Esempio di richiesta

Risposta di esempio

Definizioni

AdministratorType

AuthMetadataLookupModes

AvailabilityZoneType

BackupStorageRedundancy

createdByType

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

systemData

UserIdentity