Limitazioni e problemi noti relativi al supporto di SFTP per Archiviazione Azure Blob

Questo articolo descrive limitazioni e problemi noti con SFTP in Archiviazione BLOB di Azure, così puoi risolvere i problemi nei trasferimenti di file e verificare la compatibilità tra client e workflow.

Importante

Poiché devi abilitare lo spazio di nomi gerarchico per usare SFTP, i problemi nei problemi noti con Azure Data Lake Storage si applicano anche al tuo account.

Client non supportati

I client seguenti sono noti per essere incompatibili con SFTP per Archiviazione BLOB di Azure. Per altre informazioni, vedere Algoritmi supportati.

  • Kemp
  • Paramiko 1.16.0
  • SSH.NET 2016.1.0 o versione precedente
  • Renci SSH.NET 2014.6.0

Questo elenco non è esaustivo e può cambiare nel tempo.

Impostazioni del client

Per trasferire file da o verso Archiviazione BLOB di Azure tramite client SFTP, vedere le impostazioni consigliate seguenti.

  • WinSCP

    • Nella finestra di dialogo Preferenze, seleziona Trasferimento>Resistenza, e quindi imposta Abilita la ripresa del trasferimento/trasferimento in un nome file temporaneo su Disabilita.

Attenzione

Lasciare questa opzione abilitata può causare errori o riduzioni delle prestazioni durante i caricamenti di file di grandi dimensioni.

Operazioni non supportate

Categoria Operazioni non supportate
Scritture casuali Operazioni che includono flag READ e WRITE. Ad esempio: API di creazione SSH.NET
Collegamenti
  • symlink - creazione di collegamenti simbolici
  • ln - creazione di collegamenti fisici
  • Lettura dei collegamenti non supportata
  • Informazioni sulla capacità df - informazioni sull'utilizzo per il filesystem
    Estensioni Le estensioni non supportate includono, ad esempio, fsync@openssh.com, limits@openssh.com, lsetstat@openssh.com, statvfs@openssh.com
    Comandi SSH SFTP è l'unico sottosistema supportato. Le richieste della shell dopo lo scambio di chiavi non riescono.
    Scritture multi-protocollo Scritture e accodamenti casuali (PutBlock,PutBlockList, GetBlockList, AppendBlock, AppendFile) non sono consentiti da altri protocolli (NFS, BLOB REST, Data Lake Storage REST) per i BLOB creati tramite FTP sicuro. Sono consentite sovrascritture complete.
    Operazioni di ridenominazione Le operazioni di ridenominazione in cui il nome del file di destinazione esiste già rappresentano una violazione del protocollo. Se si tenta di eseguire un'operazione di questo tipo, viene restituito un errore. Per altre informazioni, vedere Rimozione e ridenominazione dei file.
    Operazioni su contenitori diversi L'attraversamento tra contenitori o l'esecuzione di operazioni su più contenitori dalla stessa connessione non sono supportati.
    Annulla eliminazione Non puoi ripristinare un blob eliminato temporaneamente tramite SFTP. Usa l'API Undelete REST.

    ACL di accesso e ACL predefinite

    • SFTP attualmente non supporta ACL predefiniti o ACL di accesso aggiuntivi (voci ACL oltre le voci POSIX user::, group::e other:: , ad esempio utenti denominati o gruppi denominati).

    • Se una qualsiasi directory nel percorso di accesso (inclusa la cartella principale dell'utente) ha ACL predefinite o ACL di accesso aggiuntive attivate, le operazioni SFTP falliscono con Permission denied, anche quando l'utente connesso ha permessi necessari.

    Soluzione: Rimuovere gli ACL predefiniti e gli ACL di accesso aggiuntivi da tutte le directory nel percorso di accesso SFTP (inclusa la home directory dell'utente) in modo che rimangano solo le voci POSIX user::, group::e other:: .

    Per altre informazioni sugli elenchi di controllo di accesso e su come modificarli, vedere Elenchi di controllo di accesso (ACL).

    Rete

    • Per accedere all'account di archiviazione usando SFTP, la tua rete deve consentire il traffico sulla porta 22.

    • Gli account di archiviazione non supportano indirizzi IP statici. Questa limitazione non è specifica per SFTP.

    • Le connessioni inattive o non utilizzate scadono dopo due minuti. OpenSSH smette di rispondere e poi si disconnette. Alcuni client si riconnettono automaticamente.

    Limitazioni aggiuntive di SFTP

    • Per informazioni sui problemi di prestazioni e altre considerazioni, vedere Considerazioni sulle prestazioni del Protocollo di trasferimento file SSH (SFTP) in Archiviazione Blob di Azure.

    • Di default, la proprietà Content-MD5 dei blob caricati tramite SFTP è nulla. Per popolare questa proprietà con un hash MD5, il client deve calcolare l'hash e impostare la proprietà Content-MD5 prima di caricare il blob.

    • La dimensione massima di upload del file tramite l'endpoint SFTP è di 500 GB.

    • Il failover pianificato gestito dal cliente è supportato per gli account v2 generici standard e a livello di anteprima per gli account blob a blocchi premium. Per altre informazioni, vedere Pianificazione del ripristino di emergenza e failover dell'archiviazione di Azure.

    • Per modificare le impostazioni di ridondanza o replica dell'account di archiviazione, devi disabilitare SFTP. Puoi riabilitare SFTP dopo che la conversione è terminata.

    • Non puoi accedere a contenitori speciali come $logs, $blobchangefeed, $root, e $web tramite l'endpoint SFTP.

    • FTPS e FTP non sono supportati.

    • SFTP non usa TLS o SSL.

    • È supportata solo la versione 2 di SSH.

    • Evitare nomi di BLOB o directory che terminano con un punto (.), una barra (/), una barra rovesciata (\) o una sequenza o una combinazione dei quattro. Nessun segmento di percorso deve terminare con un punto (.). Per altre informazioni, vedere Denominazione e riferimento a contenitori, BLOB e metadati.

    Funzionalità di Archiviazione BLOB

    Quando si abilita il supporto SFTP, alcune funzionalità di gestione rete virtuale di Azure sono completamente supportate, ma alcune potrebbero essere supportate solo a livello di anteprima o non ancora supportate affatto.

    Per informazioni sul supporto di ogni funzionalità di Archiviazione BLOB negli account con il supporto di FTP sicuro abilitato, vedere Supporto delle funzionalità di Archiviazione BLOB per gli account di Archiviazione di Azure.

    Risoluzione dei problemi

    • Per risolvere l'errore Failed to update SFTP settings for account 'accountname'. Error: The value 'True' isn't allowed for property isSftpEnabled. , verifica che l'account di archiviazione soddisfi i seguenti prerequisiti:

      • L'account è un account per utilizzo generico v2 o un account premium per BLOB in blocchi.

      • Il namespace gerarchico è abilitato per l'account.

    • Per risolvere l'errore Home Directory not accessible, verificare che:

      • L'utente ha i permessi appropriati sul container.

      • La stringa di connessione specifica il nome del container per gli utenti locali che non hanno una directory home.

      • La stringa di connessione specifica il nome del container per gli utenti locali la cui directory home non esiste.

    • Per risolvere l'errore Received disconnect from XX.XXX.XX.XXX port 22:11: durante la connessione, verificare che:

      • L'accesso alla rete pubblica è Enabled from all networks o Enabled from selected virtual networks and IP addresses.

      • L'indirizzo IP del client è consentito dal firewall.

    Vedi anche