Condividi tramite

API REST File di Azure

  • Articolo

File di Azure fornisce condivisioni file cloud ospitate a cui è possibile accedere (montare) usando protocolli di file system standard del settore, ad esempio SMB e NFS. Quando si monta una condivisione file nel computer usando SMB o NFS, il sistema operativo reindirizza le richieste API per il file system locale. Il reindirizzamento include le richieste API locali eseguite usando interfacce .NET System.IO o i metodi di apertura, lettura o scrittura di Python. Ciò significa che gli utenti di queste applicazioni non devono eseguire alcuna operazione speciale o addirittura sapere che i dati si trovano in una condivisione file remota anziché nell'archiviazione locale.

File di Azure fornisce anche un'API REST, spesso denominata API FileREST. Per usare l'API FileREST, creare richieste HTTPS per gli endpoint HTTPS FileREST. È possibile scrivere codice per creare manualmente richieste HTTPS, ma sono disponibili SDK di Azure che usano automaticamente l'API FileREST, fornendo un wrapper di linguaggio idiomatico sull'API FileREST in linguaggi comuni, ad esempio C#, Java, Python, JavaScript e Go.

Poiché l'API FileREST è stata progettata specificamente per File di Azure, consente di accedere alle funzionalità di File di Azure a cui non è possibile accedere tramite SMB o NFS. Consente inoltre di eseguire determinate operazioni, ad esempio la copia, in modo più efficiente di quanto sia possibile tramite SMB o NFS.

La natura senza stato di HTTPS rende l'API FileREST utile per i servizi cloud o le applicazioni che devono accedere a molte condivisioni file di Azure. Ad esempio, è possibile associare servizi o applicazioni a una condivisione file di Azure per aggiungere una funzionalità. Questi servizi o applicazioni possono includere antivirus, backup, gestione dei dati o prodotti di replica. Sincronizzazione file di Azure e Backup di Azure sono importanti servizi Microsoft che usano ampiamente l'API FileREST per aggiungere valore in cima a una condivisione file di Azure di proprietà del cliente.

È consigliabile usare l'API FileREST se si creano servizi o applicazioni a valore aggiunto, soprattutto se si forniscono tali servizi ai clienti. Se si sta creando un'applicazione line-of-business, in particolare un'applicazione che gli utenti useranno in una condivisione file di Azure montata, è possibile usare SMB/NFS o FileREST. Tuttavia, è possibile che l'uso di SMB o NFS fornisca un percorso più semplice perché questi protocolli consentono di usare le API native del file system.

Se si dispone di un'applicazione esistente scritta con API native del file system, non è necessario riscriverla per sfruttare i vantaggi di File di Azure. La proposta di valore chiave di File di Azure espone le API native del file system tramite l'uso di SMB o NFS.

Per altre informazioni sulle File di Azure, tra cui la distribuzione, la rete e la configurazione delle identità, vedere:

Piano di controllo

In Azure il piano di controllo viene fornito tramite Azure Resource Manager, che offre un modo comune per esporre le risorse di Azure che il cliente gestirà. L'unità di primo livello di gestione è l'account di archiviazione. L'account di archiviazione è una risorsa rilevata in File di Azure e in altri servizi di archiviazione, ad esempio Archiviazione BLOB di Azure.

L'account di archiviazione è gestito dal provider di risorse di archiviazione, che ha lo spazio dei nomi Microsoft.Storage. Il provider di risorse di archiviazione espone anche la gestione delle risorse figlio o delle risorse proxy che consentono la gestione dei servizi di archiviazione aggregati nell'account di archiviazione. Per File di Azure, sono disponibili due risorse proxy pertinenti:

  • Risorsa FileService . Fornisce impostazioni specifiche per File di Azure che si applicano a tutte le condivisioni file nell'account di archiviazione. La FileService risorsa è un elemento figlio dell'account di archiviazione. Un account di archiviazione ha sempre una FileService sola risorsa: default.

  • Risorsa FileShare . Rappresenta una condivisione file o uno snapshot di una condivisione file. La FileShare risorsa è un elemento figlio della FileService risorsa e può contenere un numero infinito di condivisioni file.

Anche se una FileService risorsa può contenere un numero infinito di risorse, l'uso di FileShare un numero molto elevato non è una buona idea perché tutti gli elementi all'interno di un account di archiviazione condividono un pool definito di I/O, larghezza di banda e altri limiti. Per altre informazioni, vedere Obiettivi di scalabilità e prestazioni per File di Azure.

Per informazioni su come chiamare le API del piano di controllo, vedere:

Le operazioni sugli FileService oggetti e FileShare possono essere eseguite anche tramite il piano dati. Si tratta di un artefatto di File di Azure che precede azure Resource Manager. Anche se queste API sono completamente supportate, nella maggior parte dei casi è consigliabile usare le API del provider di risorse di archiviazione per gestire File di Azure per questi motivi:

  • Le operazioni esposte tramite Azure Resource Manager usano Microsoft Entra ID per l'autenticazione e l'autorizzazione, quindi è possibile gestire File di Azure usando il controllo degli accessi in base al ruolo. È possibile autorizzare l'applicazione o il servizio a chiamare queste API a livello di codice con un'entità servizio Microsoft Entra.

  • È possibile chiamare le API di Azure Resource Manager in modo imperativo, tramite l'API REST direttamente o tramite un SDK. In alternativa, è possibile chiamarli in modo dichiarativo, dichiarando quali risorse devono essere distribuite tramite i modelli di Azure. Per le risorse che devono essere create ripetutamente insieme (ad esempio, nelle distribuzioni del servizio), l'uso dei modelli può semplificare notevolmente il lavoro necessario.

  • Sebbene sia consigliabile usare il provider di risorse di archiviazione per gestire le risorse di archiviazione, l'uso delle API di gestione del piano dati FileREST offrirà prestazioni migliori nei casi che richiedono scalabilità elevata. Un esempio di questo caso è un carico di lavoro che crea o modifica migliaia di condivisioni file all'interno dello stesso account di archiviazione.

    • Microsoft.Storage storageAccounts/fileServices/shares attiva un'operazione del piano di controllo tramite il provider di risorse di archiviazione.
    • Microsoft.Storage storageAccounts/fileServices/fileshares è un'operazione del piano dati. L'impostazione di ruoli a livello di condivisione, ad esempio l'utilità di lettura condivisione SMB dei dati del file di archiviazione , deve essere un'operazione del piano dati e deve usare questa risorsa.

Piano dati

File di Azure fornisce un file system gerarchico per i dati non strutturati. L'API FileREST modella i due oggetti importanti nello spazio del file system: file e directory. Per informazioni su come chiamare le API FileREST, vedere:

Vedi anche