Risoluzione dei problemi relativi ai codici di errore di esecuzione del processo di Spostamento archiviazione

Un agente di Spostamento archiviazione di Azure usa codici di stato stringa per gli stati trasmessi all'utente finale. Tutti i codici di stato hanno il prefisso AZSM seguito da quattro cifre decimali. La prima cifra decimale indica l'ambito generale dello stato. Ogni codice di stato deve appartenere a uno degli ambiti seguenti:

  • Stato che si applica all'intero agente.
    Questi codici utilizzano la cifra di ambito 0 e pertanto hanno il prefisso AZSM0.
  • Stato che si applica a un processo specifico eseguito dall'agente.
    Questi codici usano la cifra di ambito 1 e pertanto hanno il prefisso AZSM1.
  • Stato che può essere impostato dall'agente in un file o in una directory specifica trasferita da un processo eseguito dall'agente.
    Questi codici usano la cifra di ambito 2 e pertanto hanno il prefisso AZSM2.

Ognuno di questi ambiti divide ulteriormente gli stati in categorie e sottocategorie. Ogni sottocategoria riserva in genere 20 codici di stato per supportare l'espansione futura.

Suggerimento

AZSM0000 è il codice di stato speciale indipendente dall'ambito che indica l'operazione riuscita e deve essere usato per indicare l'operazione riuscita a qualsiasi ambito/livello.

Codice di errore Messaggio di errore Dettagli/Procedura per la risoluzione dei problemi/Mitigazione
AZSM1001 Non è possibile montare il percorso di origine Verificare che il nome del server o l'indirizzo IP specificato sia valido oppure che il percorso di origine sia corretto. Se si usa SMB, verificare che il nome utente e la password specificati siano corretti.
AZSM1002 Si è verificato un errore durante l'analisi dell'origine Riprovare o creare un ticket di supporto.
AZSM1003 Non è possibile accedere alla cartella di origine a causa di problemi di autorizzazione Verificare che all'agente siano state concesse le autorizzazioni per la condivisione del file di origine.
AZSM1004 Il percorso di origine specificato non è valido Creare un nuovo endpoint con un percorso di condivisione di origine valido, aggiornare la definizione del processo e riprovare.
AZSM1020 Errore vario durante l'accesso all'origine Questo errore viene segnalato per qualsiasi motivo che provochi errori di lettura dei file o delle cartelle sorgente. Alcuni errori potrebbero essere "nessun file o directory di questo tipo", "autorizzazione negata", "errore di input/output" e così via. Verificare che la connessione di rete tra l'agente e la condivisione di origine funzioni correttamente. La condivisione/la cartella/i file di origine devono essere presenti e l'agente deve avere accesso in lettura alla condivisione di origine.
AZSM1021 Non è possibile accedere alla cartella di destinazione a causa di problemi di autorizzazione Riprovare o creare un ticket di supporto.
AZSM1022 Il percorso di destinazione specificato non è valido Creare un nuovo endpoint con un contenitore e un percorso di destinazione validi, aggiornare la definizione del processo e riprovare.
AZSM1023 Lease scaduto per questo agente nel contenitore di destinazione Riprovare o creare un ticket di supporto.
AZSM1024 Errore di autorizzazione durante l'accesso al percorso di destinazione L'agente non dispone di autorizzazioni sufficienti per accedere al percorso di destinazione. Le assegnazioni di ruolo del controllo degli accessi in base al ruolo (controllo degli accessi in base al ruolo) vengono eseguite automaticamente quando le risorse vengono create usando il portale di Azure. Se si usano le API, i cmdlet di PowerShell o gli SDK, creare manualmente un'assegnazione di ruolo per l'identità gestita dell'agente per accedere al percorso di destinazione. Per la destinazione del contenitore BLOB di archiviazione, usare l'assegnazione del ruolo Collaboratore dati BLOB di archiviazione. Per la condivisione file di Azure come destinazione, usare Collaboratore con privilegi per i dati dei file di archiviazione. Ad esempio, per assegnare un ruolo RBAC, fare riferimento all'articolo Assegnare un ruolo di Azure per l'accesso ai dati BLOB.
AZSM1025 Errore di autenticazione durante l'accesso al percorso di origine Verificare che l'agente disponga delle autorizzazioni per il percorso di origine.
AZSM1026 Il tipo di destinazione non è supportato dall'agente Questo tipo di destinazione non è supportato dall'agente di Spostamento archiviazione corrente.
AZSM1027 Il percorso di destinazione è occupato L'agente non può rivendicare la quota di destinazione o il contenitore perché esiste un contratto di locazione attivo. Il lease può essere dovuto a un altro processo di migrazione o a un processo interrotto precedente che mantiene ancora un'attestazione sul file "AZURE_STORAGE_MOVER_MARKER". Assicurarsi che nessun altro processo sia in esecuzione per questa destinazione. Se nessuno è in esecuzione, riavviare l'agente e riprovare. se il problema persiste, contattare il supporto tecnico.
AZSM1028 errore di accesso Key Vault Questo errore può verificarsi se l'identità gestita dell'agente non dispone dell'accesso RBAC al ruolo "Key Vault Secrets User", se i firewall o gli ACL di rete bloccano le connessioni all'endpoint del Key Vault, o se mancano i segreti. Per un errore "RESPONSE 403", controllare le assegnazioni di ruolo e le eventuali regole del firewall nell'insieme di credenziali delle chiavi che potrebbero limitare il traffico. Per altri errori, usare l'opzione di menu xdmsh "5) Testare la connettività a endpoint singolo" in "2) Configurazione di rete" per verificare la raggiungibilità degli endpoint.
AZSM1029 Tipo di endpoint di origine non supportato da questa versione dell'agente Questo tipo di origine non è supportato dall'agente di Spostamento archiviazione corrente.
AZSM1030 Non è possibile verificare il tipo di account di archiviazione Verificare che l'account di archiviazione e il contenitore esistano e che all'agente siano state concesse le autorizzazioni necessarie.
AZSM1031 Non è possibile risolvere l'host di destinazione Controllare la configurazione di rete per verificare che i firewall o gli ACL non blocchino l'accesso all'endpoint dell'account di archiviazione. Usare l'opzione di menu xdmsh "5) Testare la connettività a endpoint singolo" in "2) Configurazione di rete" per verificare la raggiungibilità degli endpoint.
AZSM1040 Errore vario durante l'accesso alla destinazione È probabile che questo errore sia temporaneo. Ripetere il processo di migrazione. Se il problema persiste, creare un ticket di supporto per ulteriore assistenza.
AZSM1041 Non è possibile inviare lo stato del processo È probabile che questo errore sia temporaneo. Ripetere il processo di migrazione. Se il problema persiste, creare un ticket di supporto per ulteriore assistenza.
AZSM1042 Non è possibile creare il processo Questo errore può verificarsi a causa di diversi motivi, ad esempio l'agente non è in grado di raggiungere l'endpoint dell'account di archiviazione, i firewall o gli ACL di rete che bloccano la connessione, il traffico proveniente dall'agente instradato su un indirizzo IP pubblico quando un endpoint privato è configurato nell'account di archiviazione o un proxy che modifica il certificato. Per verificare la raggiungibilità dell'endpoint dell'account di archiviazione, usare l'opzione di menu xdmsh "5) Testare la connettività a endpoint singolo" in "2) Configurazione di rete". Se l'errore segnalato è "x509: certificato firmato da autorità sconosciuta", indica che la rete locale intercetta e modifica i certificati SSL (intercettazione SSL) per il traffico verso gli endpoint necessari, causando l'agente di non riconoscere i certificati ricevuti. Sebbene l'aggiunta di certificati all'Agente risolverebbe normalmente questo problema, questa funzionalità non è attualmente supportata. Per consentire all'agente di accedere a questi endpoint, è consigliabile aggiungerli all'elenco di permessi per aggirare l'intercettazione SSL.
AZSM1043 Non è possibile riprendere il processo Riprovare o creare un ticket di supporto.
AZSM1044 Non è possibile finalizzare il processo. Riprovare o creare un ticket di supporto.
AZSM1045 Il processo è stato interrotto mentre era ancora in esecuzione. Riprovare o creare un ticket di supporto.
AZSM1060 Errore vario durante l'esecuzione del processo. Questo errore può verificarsi a causa di vari motivi. Esaminare l'errore segnalato e intraprendere azioni correttive in base ai relativi dettagli, come descritto di seguito. Se l'errore indica: 1) "InvalidResourceName": verificare che i nomi di cartella e file seguano le convenzioni di denominazione supportate. Ad esempio, "con" non è un nome di directory valido. 2) "La condivisione specificata è piena": verificare la capacità della condivisione di destinazione. 3) "Descrittore di file non valido": verificare che la connessione di rete SMB tra l'agente e l'origine funzioni correttamente e che il server SMB sia reattivo alle richieste di lettura. 4) "403 Questa richiesta non è autorizzata a eseguire questa operazione": se un endpoint privato è configurato per l'account di archiviazione di destinazione, verificare che DNS sia configurato correttamente e verificare che non siano presenti configurazioni dns non corrette o di bilanciamento del carico che causano una risoluzione IP errata. 5) Per altri errori, ripeti il lavoro; se il problema persiste, crea un ticket di supporto.
AZSM2021 Tipo di file non supportato dalla destinazione. Questo tipo di destinazione non supporta file di questo tipo. Per altre informazioni, fare riferimento a obiettivi di scalabilità e prestazioni per File di Azure e Archiviazione BLOB di Azure.
AZSM2024 Lunghezza del percorso di origine superiore al massimo supportata dalla destinazione. Fare riferimento alle linee guida all'interno dell'articolo Sulla denominazione e sul riferimento a condivisioni, directory, file e metadati.
AZSM2026 Le dimensioni del file di origine sono maggiori del numero massimo supportato dalla destinazione. Fare riferimento alle linee guida all'interno dell'articolo Sulla denominazione e sul riferimento a condivisioni, directory, file e metadati.
AZSM2027 Il descrittore di protezione del file di origine contiene proprietà non supportate Esaminare le autorizzazioni del file o della cartella.
AZSM2061 Errore sconosciuto durante l'analisi dell'origine. Può essere un errore temporaneo. Eseguire di nuovo il processo di migrazione.
AZSM2062 Non è possibile leggere il file di origine a causa di problemi di autorizzazione. Verificare che l'agente disponga delle autorizzazioni per il percorso di origine.
AZSM2063 Si è verificato un errore di I/O durante la lettura del file di origine. È probabile che questo errore sia temporaneo. Ripetere il processo di migrazione. Se il problema persiste, creare un ticket di supporto per ulteriore assistenza.
AZSM2069 Non è stato possibile leggere il file di destinazione a causa di problemi di autorizzazione. Verificare che all'agente siano state concesse le autorizzazioni per il percorso di destinazione.
AZSM2070 Non è possibile scrivere il BLOB perché ha un lease attivo Questo errore può essere causato da un altro agente che scrive nel percorso. Verificare che nessun altro processo sia in esecuzione nella destinazione. Riprovare o creare un ticket di supporto.
AZSM2071 Il file di origine è stato modificato durante il trasferimento È probabile che questo errore sia temporaneo. Ripetere il processo di migrazione. Se il problema persiste, creare un ticket di supporto per ulteriore assistenza.
AZSM2080 Copia non riuscita a causa di un errore sconosciuto È probabile che questo errore sia temporaneo. Ripetere il processo di migrazione. Se il problema persiste, creare un ticket di supporto per ulteriore assistenza.

Risoluzione dei problemi relativi al controllo degli accessi in base al ruolo di Spostamento archiviazione

Durante l'esecuzione di un processo, si verificano assegnazioni automatiche del controllo degli accessi in base al ruolo. In caso di errori nelle assegnazioni, aggiungere manualmente l'assegnazione di ruolo richiesta.

  1. Passare alla risorsa appropriata: Key Vault, condivisione file o contenitore BLOB.
  2. Passare a Controllo di accesso (IAM).
  3. Aggiungere una nuova assegnazione di ruolo: assegnare ruoli di Azure usando il portale di Azure - Controllo degli accessi in base al ruolo di Azure |Microsoft Learn.
  4. Nella procedura guidata Aggiungi assegnazione di ruolo cercare il ruolo appropriato nella tabella seguente per il tipo di risorsa selezionato nel passaggio 1. Nell'esempio seguente la risorsa sarà Key Vault.

Immagine che mostra i ruoli assegnati con successo alla risorsa Key Vault.

Tipo di risorsa Ruoli necessari
Key Vault Utente dei segreti di Key Vault
Condivisione file Collaboratore con privilegi per i dati dei file di archiviazione
Contenitore BLOB Collaboratore con privilegi per i dati dei BLOB di archiviazione

i. L'accesso deve essere assegnato a "Identità gestita".
ii. Nel riquadro destro selezionare Identità gestita come Computer - Azure Arc.
iii. Selezionare l'arco della macchina dall'elenco. Ha lo stesso nome dell'agente.
iv. Completare l'assegnazione.