Rozwiązywanie problemów z kodami błędów uruchamiania zadania Mover magazynu

Agent usługi Azure Storage Mover używa kodów stanu ciągu dla stanów przekazywanych użytkownikowi końcowemu. Wszystkie kody stanu mają prefiks AZSM , po którym następują cztery cyfry dziesiętne. Pierwsza cyfra dziesiętna wskazuje ogólny zakres stanu. Każdy kod stanu powinien należeć do jednego z następujących zakresów:

• Stan, który ma zastosowanie do całego agenta.
  Te kody używają cyfry 0zakresu i dlatego mają prefiks AZSM0.
• Stan, który ma zastosowanie do określonego zadania uruchomionego przez agenta.
  Te kody używają cyfry 1 zakresu i dlatego mają prefiks AZSM1.
• Stan, który może być ustawiony przez agenta w określonym pliku lub katalogu, który jest transferowany przez zadanie uruchamiane przez agenta.
  Te kody używają cyfry 2 zakresu i dlatego mają prefiks AZSM2.

Każdy z tych zakresów dodatkowo dzieli stany na kategorie i podkategorie. Każda podkategoria zazwyczaj rezerwuje 20 kodów stanu, aby uwzględnić przyszłe rozszerzenie.

Napiwek

AZSM0000 to specjalny, niezależny od zakresu kod stanu wskazujący pomyślną operację i powinien służyć do oznaczania pomyślnej operacji na dowolnym poziomie/zakresie.

Kod błędu	Komunikat o błędzie	Szczegóły/Kroki rozwiązywania problemów/Środki zaradcze
AZSM1001	Nie można zainstalować ścieżki źródłowej	Sprawdź, czy podana nazwa serwera lub adres IP są prawidłowe lub lokalizacja źródłowa jest poprawna. Jeśli używasz protokołu SMB, sprawdź, czy podana nazwa użytkownika i hasło są poprawne.
AZSM1002	Wystąpił błąd podczas skanowania źródła	Ponów próbę lub utwórz bilet pomocy technicznej.
AZSM1003	Nie można uzyskać dostępu do folderu źródłowego z powodu problemów z uprawnieniami	Sprawdź, czy agent otrzymał uprawnienia do źródłowego udziału plików.
AZSM1004	Podana ścieżka źródłowa jest nieprawidłowa	Utwórz nowy punkt końcowy z prawidłową ścieżką udziału źródłowego i zaktualizuj definicję zadania i ponów próbę.
AZSM1020	Inny błąd podczas uzyskiwania dostępu do źródła	Ten błąd jest zgłaszany z jakiegokolwiek powodu, który powoduje błędy odczytu pliku źródłowego/folderu. Niektóre błędy mogą być następujące: "brak takiego pliku lub katalogu", "odmowa uprawnień", "błąd wejściowy/wyjściowy" itp. Upewnij się, że połączenie sieciowe między agentem a udziałem źródłowym działa prawidłowo. Źródłowy udział sieciowy/katalogi/pliki muszą być obecne, a agent powinien mieć dostęp do odczytu do źródłowego udziału.
AZSM1021	Nie można uzyskać dostępu do folderu docelowego z powodu problemów z uprawnieniami	Ponów próbę lub utwórz bilet pomocy technicznej.
AZSM1022	Podana ścieżka docelowa jest nieprawidłowa	Utwórz nowy punkt końcowy z prawidłowym kontenerem docelowym i ścieżką oraz zaktualizuj definicję zadania i ponów próbę.
AZSM1023	Dzierżawa wygasła dla tego agenta w kontenerze docelowym	Ponów próbę lub utwórz bilet pomocy technicznej.
AZSM1024	Niepowodzenie autoryzacji podczas uzyskiwania dostępu do lokalizacji docelowej	Agent nie ma wystarczających uprawnień dostępu do lokalizacji docelowej. Przypisania ról RBAC (kontroli dostępu opartej na rolach) są wykonywane automatycznie podczas tworzenia zasobów przy użyciu witryny Azure Portal. Jeśli używasz interfejsów API, poleceń cmdlet programu PowerShell lub zestawów SDK, utwórz ręcznie przypisanie roli dla tożsamości zarządzanej agenta w celu uzyskania dostępu do lokalizacji docelowej. W przypadku obiektu docelowego kontenera Blob Storage użyj przydziału roli Współautor danych Blob Storage. W przypadku udziału plików Azure jako miejsca docelowego użyj Storage File Data Privileged Contributor. Aby przypisać rolę RBAC, na przykład odwołaj się do artykułu Przypisywanie roli platformy Azure w celu uzyskania dostępu do danych obiektów blob .
AZSM1025	Niepowodzenie uwierzytelniania podczas uzyskiwania dostępu do lokalizacji źródłowej	Sprawdź, czy agent ma uprawnienia do lokalizacji źródłowej.
AZSM1026	Typ docelowy nie jest obsługiwany przez agenta	Ten typ docelowy nie jest obsługiwany przez bieżącego agenta usługi Storage Mover.
AZSM1027	Lokalizacja docelowa jest zajęta	Agent nie może zająć docelowego udziału lub kontenera, ponieważ istnieje aktywna dzierżawa. Dzierżawa może być spowodowana przez inne zadanie migracji lub poprzednie przerwane zadanie, które nadal posiada roszczenie do pliku "AZURE_STORAGE_MOVER_MARKER". Upewnij się, że dla tego celu nie jest uruchomione żadne inne zadanie. Jeśli żaden z nich nie jest uruchomiony, uruchom ponownie agenta i spróbuj ponownie; jeśli problem będzie nadal występować, skontaktuj się z pomocą techniczną.
AZSM1028	Niepowodzenie dostępu do usługi Key Vault	Ten błąd może wystąpić, jeśli zarządzana tożsamość agenta nie ma dostępu RBAC "Użytkownik Sekretów Key Vault", jeśli zapory sieciowe lub listy ACL blokują połączenia z punktem końcowym magazynu kluczy, lub jeśli brakuje sekretów. W przypadku błędu "RESPONSE 403" sprawdź przypisania ról i wszystkie reguły zaporowe w skarbcu kluczy, które mogą ograniczać ruch sieciowy. W przypadku innych błędów użyj opcji menu xdmsh "5) Testowanie łączności pojedynczego punktu końcowego" w obszarze "2) Konfiguracja sieci" w celu sprawdzenia dostępności punktu końcowego.
AZSM1029	Źródłowy typ punktu końcowego nie jest obsługiwany przez tę wersję agenta	Ten typ źródła nie jest obsługiwany przez bieżącego agenta usługi Storage Mover.
AZSM1030	Nie można zweryfikować typu konta magazynu	Sprawdź, czy konto magazynu i kontener istnieją oraz czy agent otrzymał uprawnienia do nich.
AZSM1031	Nie można rozpoznać hosta docelowego	Sprawdź konfigurację sieci, aby się upewnić, że zapory ogniowe lub listy kontroli dostępu (ACL) nie blokują dostępu do punktu końcowego konta przechowywania. Użyj opcji menu xdmsh "5) Testowanie łączności pojedynczego punktu końcowego" w obszarze "2) Konfiguracja sieci" w celu sprawdzenia dostępności punktu końcowego.
AZSM1040	Inny błąd podczas uzyskiwania dostępu do obiektu docelowego	Prawdopodobnie ten błąd jest tymczasowy. Ponów próbę wykonania zadania migracji ponownie. Jeśli problem będzie się powtarzać, utwórz bilet pomocy technicznej, aby uzyskać dalszą pomoc.
AZSM1041	Nie można wysłać postępu zadania	Prawdopodobnie ten błąd jest tymczasowy. Ponów próbę wykonania zadania migracji ponownie. Jeśli problem będzie się powtarzać, utwórz bilet pomocy technicznej, aby uzyskać dalszą pomoc.
AZSM1042	Nie można utworzyć zadania	Ten błąd może wystąpić z różnych powodów, na przykład gdy agent nie może uzyskać dostępu do punktu końcowego konta magazynu, zapory ogniowe lub listy kontroli dostępu (ACL) sieci blokują połączenie, gdy ruch od agenta jest kierowany przez publiczny adres IP, podczas gdy na koncie magazynu skonfigurowano prywatny punkt końcowy, lub gdy serwer proxy modyfikuje certyfikat. Aby zweryfikować dostępność punktu końcowego konta magazynowego, użyj opcji menu xdmsh "5) Testowanie łączności pojedynczego punktu końcowego" pod "2) Konfiguracja sieci". Jeśli zgłoszony błąd to "x509: certyfikat podpisany przez nieznany urząd", wskazuje, że sieć lokalna przechwytuje i zmienia certyfikaty SSL (przechwytywanie SSL) dla ruchu do wymaganych punktów końcowych, co powoduje, że agent nie rozpoznaje odebranych certyfikatów. Normalnie dodanie certyfikatów do agenta rozwiązałoby ten problem, ale ta funkcja nie jest obecnie wspierana. Aby umożliwić agentowi dostęp do tych punktów końcowych, rozważ dodanie ich do listy dozwolonych w celu obejścia przechwytywania protokołu SSL.
AZSM1043	Nie można wznowić zadania	Ponów próbę lub utwórz bilet pomocy technicznej.
AZSM1044	Nie można sfinalizować zadania.	Ponów próbę lub utwórz bilet pomocy technicznej.
AZSM1045	Zadanie zostało przerwane, gdy nadal działa.	Ponów próbę lub utwórz bilet pomocy technicznej.
AZSM1060	Inny błąd podczas wykonywania zadania.	Ten błąd może wystąpić z różnych powodów. Przejrzyj zgłoszony błąd i podejmij działania naprawcze na podstawie jego szczegółów, jak opisano poniżej. Jeśli błąd wskazuje: 1) "InvalidResourceName": Sprawdź, czy nazwy folderów i plików są zgodne z obsługiwanymi konwencjami nazewnictwa. Na przykład "con" nie jest prawidłową nazwą katalogu. 2) "Określony udział jest pełny": Sprawdź pojemność udziału docelowego. 3) "nieprawidłowy deskryptor plików": Upewnij się, że połączenie sieciowe SMB między agentem i źródłem działa prawidłowo, a serwer SMB odpowiada na żądania odczytu. 4) "403 To żądanie nie jest autoryzowane do wykonania tej operacji": Jeśli prywatny punkt końcowy jest skonfigurowany dla docelowego konta przechowywania, sprawdź, czy system DNS jest poprawnie skonfigurowany i upewnij się, że nie ma błędnych przekierowań DNS ani konfiguracji równoważnika obciążenia, które powodują niepoprawne rozpoznawanie adresów IP. 5) W przypadku innych błędów spróbuj ponownie wykonać zadanie; Jeśli problem będzie nadal występował, utwórz bilet pomocy technicznej.
AZSM2021	Typ pliku nie jest obsługiwany przez element docelowy.	Ten typ docelowy nie obsługuje plików tego typu. Dodatkowe informacje można znaleźć w celach dotyczących skalowalności i wydajności dla usług Azure Files i Azure Blob Storage .
AZSM2024	Długość ścieżki źródłowej dłuższa niż maksymalna obsługiwana przez element docelowy.	Zapoznaj się ze wskazówkami w artykule Nazewnictwo i odwoływanie się do udziałów, katalogów, plików i metadanych .
AZSM2026	Plik źródłowy ma rozmiar większy niż maksymalny obsługiwany przez element docelowy.	Zapoznaj się ze wskazówkami w artykule Nazewnictwo i odwoływanie się do udziałów, katalogów, plików i metadanych .
AZSM2027	Deskryptor zabezpieczeń pliku źródłowego ma nieobsługiwane właściwości	Przejrzyj uprawnienia pliku lub folderu.
AZSM2061	Nieznany błąd napotkany podczas skanowania źródła.	Może to być błąd przejściowy. Uruchom ponownie zadanie migracji.
AZSM2062	Nie można odczytać pliku źródłowego z powodu problemów z uprawnieniami.	Sprawdź, czy agent ma uprawnienia do lokalizacji źródłowej.
AZSM2063	Napotkano błąd we/wy podczas odczytywania pliku źródłowego.	Prawdopodobnie ten błąd jest tymczasowy. Ponów próbę wykonania zadania migracji ponownie. Jeśli problem będzie się powtarzać, utwórz bilet pomocy technicznej, aby uzyskać dalszą pomoc.
AZSM2069	Nie można odczytać pliku docelowego z powodu problemów z uprawnieniami.	Sprawdź, czy agent otrzymał uprawnienia do lokalizacji docelowej.
AZSM2070	Nie można zapisać obiektu blob, ponieważ ma aktywną dzierżawę	Ten błąd może być spowodowany przez innego agenta zapisu w lokalizacji. Upewnij się, że żadne inne zadanie nie jest uruchomione względem obiektu docelowego. Ponów próbę lub utwórz bilet pomocy technicznej.
AZSM2071	Plik źródłowy został zmodyfikowany podczas transferu	Prawdopodobnie ten błąd jest tymczasowy. Ponów próbę wykonania zadania migracji ponownie. Jeśli problem będzie się powtarzać, utwórz bilet pomocy technicznej, aby uzyskać dalszą pomoc.
AZSM2080	Kopiowanie nie powiodło się z powodu nieznanego błędu	Prawdopodobnie ten błąd jest tymczasowy. Ponów próbę wykonania zadania migracji ponownie. Jeśli problem będzie się powtarzać, utwórz bilet pomocy technicznej, aby uzyskać dalszą pomoc.

Rozwiązywanie problemów z kontrolą dostępu opartą na rolach (RBAC) z urządzeniem Storage Mover.

Podczas uruchamiania zadania wykonywane są automatyczne przypisania kontroli dostępu opartej na rolach. Jeśli występują błędy w przypisaniach, ręcznie dodaj wymagane przypisanie roli.

1. Przejdź do odpowiedniego zasobu — Key Vault, udziału plików lub kontenera obiektów Blob.
2. Przejdź do opcji Zarządzanie tożsamością i dostępem (IAM).
3. Dodawanie nowego przypisania roli: Przypisywanie ról platformy Azure przy użyciu witryny Azure Portal — Azure RBAC | Microsoft Learn.
4. W kreatorze dodawania przypisania roli wyszukaj odpowiednią rolę dla rodzaju zasobu wybranego w kroku 1 w poniższej tabeli. W poniższym przykładzie zasobem jest Key Vault.

Typ zasobu	Wymagane role
Key Vault	Użytkownik sekretów usługi Key Vault
Udział plików	Uprzywilejowany współautor danych w plikach magazynowanych
Kontener obiektów blob	Uprzywilejowany współautor danych Storage Blob

punkt i. Dostęp powinien być przydzielony jako "Tożsamość zarządzana".
Ii. W okienku po prawej stronie wybierz pozycję Typ tożsamości zarządzanej jako Maszyna — Azure Arc.
iii. Wybierz łuk maszyny z listy. Nosi tę samą nazwę co agent.
Iv. Ukończ zadanie.