Condividi tramite


Managed Instances - Get

Ottiene un'istanza gestita.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}?api-version=2023-08-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}?$expand={$expand}&api-version=2023-08-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 che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager 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

ErrorResponse

Risposte di errore:

  • 400 SubnetMissingRequiredDelegation: la subnet selezionata non è delegata per Istanza gestita di SQL.

  • 400 ManagementServiceManagedServerDisabled - Operazione non riuscita perché l'istanza gestita '{0}' è disabilitata. Abilitare Istanza gestita e riprovare.

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

  • 400 LastBackupNameHasNewline - Non usare caratteri non consentiti ('\n', '\r') in lastBackupName.

  • 400 LastBackupNameHasNonAsciiCharacter - L'operazione è stata interrotta perché il parametro 'LastBackupName' contiene caratteri non validi. Sono consentiti solo caratteri ASCII.

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

  • 400 LRSCutoverDatabaseDoesNotExist - L'operazione è stata interrotta perché il nome del database specificato nella richiesta non corrisponde ad alcun nome di database nel server specificato.

  • 400 LRSCutoverDatabaseNotInRestoringState- L'operazione è stata interrotta perché il database specificato non è in stato di ripristino.

  • 400 LRSCutoverDatabaseAlreadyRestored- L'operazione è stata interrotta perché il database specificato è già stato ripristinato.

  • 400 LRSCutoverAlreadyInitiated - L'operazione è stata interrotta perché è già in corso un cutover per il database specificato.

  • 400 ManagementServiceFeatureDisabled - L'utente ha tentato di usare una funzionalità disabilitata.

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

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

  • 400 DeleteOfManagedInstanceIsDisabled - L'operazione di eliminazione dell'istanza gestita è disabilitata.

  • 400 RequestCantLandOnPaaSv2Platform: la richiesta deve essere impostata sulla piattaforma PaaSv2, ma PaaSv2 non è abilitata.

  • 400 CustomMaintenanceWindowIsDisabled - Finestra di manutenzione personalizzata non abilitata.

  • 400 DeleteOfVersion2VirtualClusterIsDisabled : l'eliminazione del cluster virtuale con la versione 2 non è abilitata.

  • 400 DeleteOfVirtualClusterIsDisabled: l'eliminazione del cluster virtuale non è abilitata.

  • 400 MICantBeMovedFromOrToInstancePool: l'istanza gestita esistente non può essere spostata nel pool di istanze gestite.

  • 400 DnsRefreshOnVirtualClusterIsDisabled - L'aggiornamento dei record DNS nel cluster virtuale non è abilitato.

  • 404 SubscriptionNotFound - La sottoscrizione richiesta non è stata trovata.

  • 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 ServerNotInSubscription - Il server specificato non esiste nella sottoscrizione specificata.

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

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

  • 409 InstancePoolBusy - Un pool di istanze è occupato con un'altra operazione in corso

  • 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 è ridondante per la zona, ma la ridondanza dell'istanza viene aggiornata con 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.

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

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

  • 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 while resource is updating
Get managed instance with $expand=administrators/activedirectory

Get managed instance

Esempio di richiesta

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

Risposta di esempio

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen5"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/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/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/instancePool1",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "virtualClusterId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-5555555-6666-7777-8888-999999999999",
    "servicePrincipal": {
      "principalId": "00000011-1111-2222-2222-123456789111",
      "clientId": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "type": "SystemAssigned"
    },
    "externalGovernanceStatus": "Enabled",
    "hybridSecondaryUsage": "Passive",
    "authenticationMetadata": "Windows",
    "pricingModel": "Regular",
    "createTime": "2022-11-01T01:01:01.011Z",
    "databaseFormat": "SQLServer2022"
  },
  "location": "japaneast",
  "tags": {
    "key": "value"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}

Get managed instance while resource is updating

Esempio di richiesta

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

Risposta di esempio

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen5"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "state": "Ready",
    "provisioningState": "Updating",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "publicDataEndpointEnabled": false,
    "proxyOverride": "Default",
    "minimalTlsVersion": "1.2",
    "dnsZone": "1b4e2caff2530",
    "instancePoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/instancePool1",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "virtualClusterId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-5555555-6666-7777-8888-999999999999",
    "externalGovernanceStatus": "Enabled",
    "pricingModel": "Regular",
    "createTime": "2022-11-01T01:01:01.011Z",
    "authenticationMetadata": "Windows",
    "databaseFormat": "SQLServer2022"
  },
  "location": "japaneast",
  "tags": {
    "key": "value"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}

Get managed instance with $expand=administrators/activedirectory

Esempio di richiesta

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

Risposta di esempio

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen5"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/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/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/instancePool1",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "virtualClusterId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-5555555-6666-7777-8888-999999999999",
    "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
    },
    "externalGovernanceStatus": "Enabled",
    "hybridSecondaryUsage": "Passive",
    "authenticationMetadata": "Windows",
    "pricingModel": "Regular",
    "createTime": "2022-11-01T01:01:01.011Z",
    "databaseFormat": "SQLServer2022"
  },
  "location": "japaneast",
  "tags": {
    "key": "value"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}

Definizioni

Nome Descrizione
AdministratorType

Tipo dell'amministratore di sever.

AuthMetadataLookupModes

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

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)

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à. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di azure Active Directory per la risorsa.

ManagedInstance

Istanza gestita di SQL di Azure.

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

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 determinazione dei prezzi di Istanza gestita.

PrincipalType

Tipo di entità dell'amministratore di sever.

ProvisioningState

Stato di provisioning dell'istanza gestita.

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.

Valore Descrizione
ActiveDirectory

AuthMetadataLookupModes

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

Valore Descrizione
AzureAD
Paired
Windows

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)

Valore Descrizione
Geo
GeoZone
Local
Zone

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

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

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

ExternalGovernanceStatus

Stato della governance esterna.

Valore Descrizione
Disabled
Enabled

HybridSecondaryUsage

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
Passive

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

Valore Descrizione
Active
Passive

IdentityType

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

Valore Descrizione
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

ManagedInstance

Istanza gestita di SQL di Azure.

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 l'istanza gestita viene creata (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 dell'istanza. Questa operazione può essere usata solo in fase di creazione dell'istanza. Se usato per l'aggiornamento dell'istanza, verrà ignorato o verrà generato un errore. Per gli aggiornamenti è necessario usare le singole 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 punto nel tempo (formato ISO8601) della creazione 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.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.minimalTlsVersion

string

Versione minima di TLS. Valori consentiti: 'Nessuno', '1.0', '1.1', '1.2'

properties.pricingModel

PricingModel

Modello di determinazione dei prezzi 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.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)

Operazioni di 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: 16384. 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 mantiene i dettagli sui fusi orari supportati, incluso l'ID, nel Registro di sistema in KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fusi orari. È possibile ottenere questi 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 solare europa".

properties.vCores

integer (int32)

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

properties.virtualClusterId

string

ID risorsa cluster virtuale per Istanza gestita.

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

type

string

Tipo di risorsa.

ManagedInstanceDatabaseFormat

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

Valore Descrizione
AlwaysUpToDate
SQLServer2022

ManagedInstanceExternalAdministrator

Proprietà di un amministratore di Active Directory.

Nome Tipo Descrizione
administratorType

AdministratorType

Tipo dell'amministratore di sever.

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

sid

string (uuid)

SID (ID oggetto) dell'amministratore del server.

tenantId

string (uuid)

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

Valore Descrizione
BasePrice
LicenseIncluded

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

description

string

Descrizione della connessione al servizio di collegamento privato.

status

string

Stato della connessione al servizio collegamento privato.

ManagedInstanceProxyOverride

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

Valore Descrizione
Default
Proxy
Redirect

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.

Valore Descrizione
Default
PointInTimeRestore

PricingModel

Modello di determinazione dei prezzi di Istanza gestita.

Valore Descrizione
Freemium
Regular

PrincipalType

Tipo di entità dell'amministratore di sever.

Valore Descrizione
Application
Group
User

ProvisioningState

Stato di provisioning dell'istanza gestita.

Valore Descrizione
Canceled
Created
Failed
InProgress
Succeeded

ResourceIdentity

Configurazione dell'identità di Azure Active Directory per una risorsa.

Nome Tipo Descrizione
principalId

string (uuid)

ID dell'entità di sicurezza di Azure Active Directory.

tenantId

string (uuid)

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.

Valore Descrizione
None
SystemAssigned

Sku

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.

UserIdentity

Configurazione dell'identità di Azure Active Directory per una risorsa.

Nome Tipo Descrizione
clientId

string (uuid)

ID client di Azure Active Directory.

principalId

string (uuid)

ID dell'entità di sicurezza di Azure Active Directory.