Condividi tramite


Managed Instances - List

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

Esempio di richiesta

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

Risposta di esempio

{
  "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

Esempio di richiesta

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

Risposta di esempio

{
  "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.