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-02-01-preview
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/managedInstances?$expand={$expand}&api-version=2021-02-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.

$expand
query
  • string

Risorse figlio da includere nella risposta.

Risposte

Name Type Description
200 OK

È stato recuperato l'elenco delle istanze gestite.

Other Status Codes

Risposte di errore: ***

Esempio

List managed instances
List managed instances with expand equals administrators

List managed instances

Sample Request

GET https://management.azure.com/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Sql/managedInstances?api-version=2021-02-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",
        "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",
        "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",
        "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",
        "storageAccountType": "GRS"
      }
    }
  ]
}

List managed instances with expand equals administrators

Sample Request

GET https://management.azure.com/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Sql/managedInstances?api-version=2021-02-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",
        "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",
        "storageAccountType": "GRS",
        "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",
        "storageAccountType": "GRS",
        "administrators": {
          "principalType": "User",
          "login": "bob@contoso.com",
          "sid": "00000011-1111-2222-2222-123456789111",
          "tenantId": "00000011-1111-2222-2222-123456789111",
          "azureADOnlyAuthentication": true
        }
      }
    }
  ]
}

Definizioni

AdministratorType

Tipo dell'amministratore del server di controllo.

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

ManagedInstanceExternalAdministrator

Proprietà di un amministratore di Active Directory.

ManagedInstanceLicenseType

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

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 regolare dell'istanza.

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

PrincipalType

Tipo di entità dell'amministratore di sever.

ResourceIdentity

Azure Active Directory di identità per una risorsa.

Sku

Uno SKU della risorsa ARM.

StorageAccountType

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

UserIdentity

Azure Active Directory di identità per una risorsa.

AdministratorType

Tipo dell'amministratore del server di controllo.

Name Type Description
ActiveDirectory
  • string

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

Name Type Description
id
  • string

ID risorsa.

identity

Identità Azure Active Directory dell'istanza gestita.

location
  • string

Percorso della risorsa.

name
  • string

Nome della risorsa.

properties.administratorLogin
  • string

Nome utente dell'amministratore per l'istanza gestita. Può essere specificato solo durante la creazione dell'istanza gestita (ed è necessario per la creazione).

properties.administratorLoginPassword
  • string

Password di accesso dell'amministratore (necessaria per la creazione dell'istanza gestita).

properties.administrators

Amministratore Azure Active Directory del server.

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 da questa istanza gestita 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

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

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 regolare dell'istanza.

Ripristino: crea un'istanza ripristinando un set di backup a 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

Elenco di connessioni 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

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

properties.publicDataEndpointEnabled
  • boolean

Indica se l'endpoint dati pubblico è abilitato o meno.

properties.restorePointInTime
  • string

Specifica il punto nel tempo (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 (LocallyRedundantStorage), 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 i fusi orario supportati Windows. Windows 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 questi valori del Registro di sistema SQL Server 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 di fuso orario valido è "Ora solare Pacifico" 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 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 delle risorse.

type
  • string

Tipo di risorsa.

ManagedInstanceExternalAdministrator

Proprietà di un amministratore di Active Directory.

Name Type Description
administratorType

Tipo dell'amministratore del server.

azureADOnlyAuthentication
  • boolean

Azure Active Directory solo l'autenticazione abilitata.

login
  • string

Nome dell'account di accesso dell'amministratore del server.

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 normale incluso in una nuova licenza SQL) e "BasePrice" (prezzo AHB scontato per portare le proprie licenze SQL licenza).

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

Una 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 dell'endpoint privato.

ManagedInstancePrivateEndpointProperty

Name Type Description
id
  • string

ID risorsa dell'endpoint privato.

ManagedInstancePrivateLinkServiceConnectionStateProperty

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

ManagedInstanceProxyOverride

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

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

ManagedServerCreateMode

Specifica la modalità di creazione del database.

Impostazione predefinita: creazione regolare dell'istanza.

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

Name Type Description
Default
  • string
PointInTimeRestore
  • string

PrincipalType

Tipo di entità dell'amministratore di sever.

Name Type Description
Application
  • string
Group
  • string
User
  • string

ResourceIdentity

Azure Active Directory di identità per una risorsa.

Name Type Description
principalId
  • string

ID Azure Active Directory'entità di sicurezza.

tenantId
  • string

ID Azure Active Directory tenant.

type

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

userAssignedIdentities

ID risorsa delle identità assegnate dall'utente da usare

Sku

Uno SKU della 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, questo può essere acquisito qui.

name
  • string

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 (LocallyRedundantStorage), ZRS (ZoneRedundantStorage) e GRS (GeoRedundantStorage)

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

UserIdentity

Azure Active Directory di identità per una risorsa.

Name Type Description
clientId
  • string

ID Azure Active Directory client.

principalId
  • string

ID Azure Active Directory'entità di sicurezza.