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=2020-08-01-preview

Parametri dell'URI

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

Risposte

Name Type Description
200 OK

È stato recuperato correttamente l'elenco di istanze gestite.

Other Status Codes

Risposte agli errori: **

Esempio

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"
      }
    }
  ]
}

Definizioni

IdentityType

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

ManagedInstance

Istanza gestita Azure SQL.

ManagedInstanceLicenseType

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

ManagedInstanceListResult

Elenco di istanze gestite.

ManagedInstancePecProperty

Connessione endpoint privato in un'istanza gestita

ManagedInstancePrivateEndpointConnectionProperties

Proprietà di una connessione endpoint privato.

ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride

Tipo di connessione usato per la connessione all'istanza.

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.

ResourceIdentity

Azure Active Directory configurazione delle identità per una risorsa.

Sku

SKU di risorsa arm.

StorageAccountType

Tipo di account di archiviazione usato per archiviare i backup per questa istanza. Le opzioni sono LRS (LocalRedundantStorage), ZRS (ZoneRedundantStorage) e GRS (GeoRedundantStorage)

IdentityType

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

Name Type Description
None
  • string
SystemAssigned
  • string
SystemAssigned,UserAssigned
  • string
UserAssigned
  • string

ManagedInstance

Istanza gestita Azure SQL.

Name Type Description
id
  • string

ID risorsa.

identity

Identità 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. È possibile specificare solo quando l'istanza gestita viene creata (ed è necessaria per la creazione).

properties.administratorLoginPassword
  • string

Password di accesso amministratore (richiesta per la creazione di istanze gestite).

properties.collation
  • string

Regole di confronto dell'istanza gestita.

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 verrà condivisa dopo la creazione.

properties.fullyQualifiedDomainName
  • string

Nome di dominio completo dell'istanza gestita.

properties.instancePoolId
  • string

Id del pool di istanze a cui appartiene questo server gestito.

properties.licenseType

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

properties.maintenanceConfigurationId
  • string

Specifica l'ID di configurazione della manutenzione da applicare a questa istanza gestita.

properties.managedInstanceCreateMode

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 TLS minima. Valori consentiti: 'Nessuno', '1.0', '1.1', '1.2'

properties.privateEndpointConnections

Elenco delle connessioni endpoint private in un'istanza gestita.

properties.provisioningState enum:
  • Creating
  • Deleting
  • Failed
  • Succeeded
  • Unknown
  • Updating
properties.proxyOverride

Tipo di connessione usato per la connessione all'istanza.

properties.publicDataEndpointEnabled
  • boolean

Se l'endpoint dati pubblico è abilitato o meno.

properties.restorePointInTime
  • string

Specifica il formato ISO8601 del database di origine che verrà ripristinato per creare il nuovo database.

properties.sourceManagedInstanceId
  • string

Identificatore di risorsa dell'istanza gestita di origine associata all'operazione di creazione di questa istanza.

properties.state
  • string

Stato dell'istanza gestita.

properties.storageAccountType

Tipo di account di archiviazione usato per archiviare i backup per questa istanza. Le opzioni sono LRS (LocalRedundantStorage), ZRS (ZoneRedundantStorage) e GRS (GeoRedundantStorage)

properties.storageSizeInGB
  • integer

Archiviazione dimensioni in GB. Valore minimo: 32. Valore massimo: 8192. Incrementi di 32 GB consentiti solo.

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 fuso orario supportati, inclusi 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 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 standard dell'Europa".

properties.vCores
  • integer

Numero di vCore. Valori consentiti: 8, 16, 24, 32, 40, 64, 80.

properties.zoneRedundant
  • boolean

Se il multi-az è abilitato o meno.

sku

SKU dell'istanza gestita. Valori consentiti per sku.name: GP_Gen4, GP_Gen5, BC_Gen4, BC_Gen5

tags
  • object

Tag di risorse.

type
  • string

Tipo di risorsa.

ManagedInstanceLicenseType

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

Name Type Description
BasePrice
  • string
LicenseIncluded
  • string

ManagedInstanceListResult

Elenco di istanze gestite.

Name Type Description
nextLink
  • string

Collegamento per recuperare la pagina successiva dei risultati.

value

Matrice di risultati.

ManagedInstancePecProperty

Connessione endpoint privato in un'istanza gestita

Name Type Description
id
  • string

ID risorsa.

properties

Proprietà di connessione dell'endpoint privato

ManagedInstancePrivateEndpointConnectionProperties

Proprietà di una connessione endpoint privato.

Name Type Description
privateEndpoint

Endpoint privato a cui appartiene la connessione.

privateLinkServiceConnectionState

Stato della connessione dell'endpoint privato.

provisioningState
  • string

Stato della connessione endpoint privato.

ManagedInstancePrivateEndpointProperty

Name Type Description
id
  • string

ID risorsa dell'endpoint privato.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Name Type Description
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 usato per la connessione all'istanza.

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

Name Type Description
Default
  • string
PointInTimeRestore
  • string

ResourceIdentity

Azure Active Directory configurazione delle identità per una risorsa.

Name Type Description
principalId
  • string

ID entità Azure Active Directory.

tenantId
  • string

ID tenant Azure Active Directory.

type

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

Sku

SKU di risorsa arm.

Name Type Description
capacity
  • integer

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 Numero, ad esempio P3.

size
  • string

Dimensioni dello SKU specifico

tier
  • string

Livello o edizione dello SKU specifico, ad esempio Basic, Premium.

StorageAccountType

Tipo di account di archiviazione usato per archiviare i backup per questa istanza. Le opzioni sono LRS (LocalRedundantStorage), ZRS (ZoneRedundantStorage) e GRS (GeoRedundantStorage)

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