Managed Instances - Get

Ottiene un'istanza gestita.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
managedInstanceName
path True

string

Nome dell'istanza gestita.

resourceGroupName
path True

string

Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale.

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

Nome Tipo Descrizione
200 OK

ManagedInstance

È stata recuperata correttamente l'istanza gestita specificata.

Other Status Codes

Risposte di errore:

  • 400 MiGeoRestoreWithWbackupStorageRedundancy: Geo-Restore non è consentito per le istanze gestite con ridondanza dell'archiviazione di backup con archiviazione con ridondanza dell'archiviazione di backup con ridondanza dell'archiviazione con archiviazione con ridondanza locale/archiviazione con ridondanza dell'archiviazione con ridondanza dell'archiviazione di backup con ridondanza dell'archiviazione con ridondanza dell'archiviazione con ridondanza locale.

  • 400 UpdatingInstanceAndBackupRedundancy: la ridondanza della zona dell'istanza e la ridondanza dell'archiviazione di backup non possono essere aggiornate nella stessa richiesta.

  • 400 ProvisioningDisabled - Visualizza il messaggio di errore dell'agente di autorizzazione dell'operazione risorse così come è, senza modifiche

  • 400 AadOnlyAuthenticationIsEnabled - È abilitata solo l'autenticazione di Azure Active Directory. Contattare l'amministratore di sistema.

  • 400 ManagementServiceFeatureDisabled : l'utente ha tentato di usare una funzionalità disabilitata.

  • 404 SubscriptionNotFound: la sottoscrizione richiesta non è stata trovata.

  • 404 ServerNotInSubscription : il server specificato non esiste nella sottoscrizione specificata.

  • 404 ManagedInstanceNotInSubscriptionResourceGroup : l'istanza gestita specificata non esiste nel gruppo di risorse e nella sottoscrizione specificati.

  • 404 SubscriptionNotFound: la sottoscrizione richiesta non è stata trovata.

  • 404 ResourceNotFound: la risorsa richiesta non è stata trovata.

  • 409 ConflictingManagedInstanceOperation : un'operazione è attualmente in corso per l'istanza gestita.

  • 409 BackupRedundancyUpdateAndInstanceRedundancyConflict: l'istanza è multi-az, ma l'archiviazione di backup viene aggiornata dalla ridondanza della zona alla ridondanza della zona.

  • 409 InstanceRedundancyUpdateWhileBackupRedundancyUpdateInProgress - Impossibile aggiornare la ridondanza dell'istanza perché l'aggiornamento della ridondanza dell'archiviazione di backup è in corso.

  • 409 InstanceRedundancyUpdateAndBackupRedundancyConflict: l'archiviazione di backup è con ridondanza della zona, ma la ridondanza dell'istanza viene aggiornata alla ridondanza della zona.

  • 409 BackupRedundancyUpdateConflict - Impossibile aggiornare la ridondanza dell'archiviazione di backup perché è già in corso un aggiornamento della ridondanza dell'archiviazione di backup.

  • 409 MiDropFailedOnAuthLocks - L'utente ha tentato di eliminare l'ultima Istanza gestita nella subnet con blocco applicato alle risorse.

  • 409 MiCreateFailedNonDelegatedSubnet : l'utente ha tentato di distribuire Istanza gestita o Istanza gestita pool nella subnet non delegata a Microsoft.Sql/managedInstances.

  • 412 InstanceNotReadyForBackupRedundancyUpdate - Impossibile aggiornare la ridondanza dell'archiviazione di backup perché l'istanza non è pronta.

  • 429 SubscriptionTooManyCreateUpdateRequests: richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 429 SubscriptionTooManyCreateUpdateRequests: richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 429 ConflictingSubscriptionOperation - Un'operazione è attualmente in corso per la sottoscrizione.

  • 503 TooManyRequests: richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 503 TooManyRequests: richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

  • 504 RequestTimeout : la richiesta di servizio ha superato il timeout consentito.

  • 504 RequestTimeout : la richiesta di servizio ha superato il timeout consentito.

Esempio

Get managed instance
Get managed instance with $expand=administrators/activedirectory

Get managed instance

Sample Request

GET https://management.azure.com/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2021-11-01

Sample Response

{
  "sku": {
    "name": "GP_Gen4",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen4"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.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",
    "instancePoolId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/instancePool1",
    "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "servicePrincipal": {
      "principalId": "00000011-1111-2222-2222-123456789111",
      "clientId": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "type": "SystemAssigned"
    }
  },
  "location": "japaneast",
  "tags": {
    "key": "value"
  },
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}

Get managed instance with $expand=administrators/activedirectory

Sample Request

GET https://management.azure.com/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2021-11-01

Sample Response

{
  "sku": {
    "name": "GP_Gen4",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen4"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.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",
    "instancePoolId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/instancePool1",
    "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",
  "tags": {
    "key": "value"
  },
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}

Definizioni

Nome Descrizione
AdministratorType

Tipo di amministratore del server.

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

ManagedInstanceExternalAdministrator

Proprietà di un amministratore di Active Directory.

ManagedInstanceLicenseType

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

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.

PrincipalType

Tipo di entità dell'amministratore del server.

ResourceIdentity

Configurazione delle 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 di risorsa arm.

UserIdentity

Configurazione delle identità di Azure Active Directory per una risorsa.

AdministratorType

Tipo di amministratore del server.

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 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. È 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.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 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.keyId

string

URI CMK della chiave da usare per la crittografia.

properties.licenseType

ManagedInstanceLicenseType

Tipo di licenza. I valori possibili sono 'LicenseIncluded' (prezzo normale incluso 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 TLS minima. Valori consentiti: 'Nessuno', '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 delle connessioni endpoint private 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 usato per la connessione all'istanza.

properties.publicDataEndpointEnabled

boolean

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

SKU dell'istanza gestita. Valori consentiti per sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH

tags

object

Tag di risorse.

type

string

Tipo di risorsa.

ManagedInstanceExternalAdministrator

Proprietà di un amministratore di Active Directory.

Nome Tipo Descrizione
administratorType

AdministratorType

Tipo dell'amministratore di sever.

azureADOnlyAuthentication

boolean

Solo autenticazione di Azure Active Directory abilitata.

login

string

Nome di accesso dell'amministratore del server.

principalType

PrincipalType

Tipo di entità dell'amministratore di sever.

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

Nome Tipo Descrizione
BasePrice

string

LicenseIncluded

string

ManagedInstancePecProperty

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

provisioningState

string

Stato della connessione dell'endpoint privato.

ManagedInstancePrivateEndpointProperty

Nome Tipo Descrizione
id

string

ID risorsa dell'endpoint privato.

ManagedInstancePrivateLinkServiceConnectionStateProperty

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

ManagedInstanceProxyOverride

Tipo di connessione usato per la connessione all'istanza.

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 del server.

Nome Tipo Descrizione
Application

string

Group

string

User

string

ResourceIdentity

Configurazione delle 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 dell'applicazione 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 di 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, è 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.

UserIdentity

Configurazione delle 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.