Řešení potíží s kódy chyb spuštění úlohy služby Storage Mover

Agent Mover služby Azure Storage používá stavové kódy řetězců pro stavy, které se předávají koncovému uživateli. Všechny stavové kódy mají předponu AZSM následovanou čtyřmi desetinnými číslicemi. První desetinná číslice označuje obor stavu vysoké úrovně. Každý stavový kód by měl patřit do jednoho z následujících oborů:

• Stav, který platí pro celého agenta
  Tyto kódy používají číslici 0oboru , a proto mají předponu AZSM0.
• Stav, který platí pro konkrétní úlohu spuštěnou agentem.
  Tyto kódy používají číslici 1 oboru, a proto mají předponu AZSM1.
• Stav, který může agent nastavit v určitém souboru nebo adresáři, který je přenesen úlohou spuštěnou agentem.
  Tyto kódy používají číslici 2 oboru, a proto mají předponu AZSM2.

Každý z těchto oborů dále rozděluje stavy do kategorií a podkategorií. Každá podkategorie si obvykle vyhrazuje 20 stavových kódů, aby se přizpůsobilo budoucímu rozšíření.

Tip

AZSM0000 je speciální stavový kód nezávislý na oboru označující úspěšnou operaci a měl by se použít k označení úspěšné operace na libovolné úrovni nebo oboru.

Kód chyby	Chybová zpráva	Podrobnosti / Postup řešení potíží / Zmírnění rizik
AZSM1001	Připojení zdrojové cesty se nezdařilo.	Ověřte, že zadaný název serveru nebo IP adresa jsou platné nebo je zdrojové umístění správné. Pokud používáte protokol SMB, ověřte správnost zadaného uživatelského jména a hesla.
AZSM1002	Při kontrole zdroje došlo k chybě.	Zkuste to znovu nebo vytvořte lístek podpory.
AZSM1003	Nepodařilo se získat přístup ke zdrojové složce kvůli problémům s oprávněními	Ověřte, že má agent udělená oprávnění ke zdrojové sdílené složce.
AZSM1004	Zadaná zdrojová cesta je neplatná.	Vytvořte nový koncový bod s platnou cestou ke zdrojové sdílené složce a aktualizujte definici úlohy a zkuste to znovu.
AZSM1020	Různá chyba při přístupu ke zdroji	Tato chyba je hlášena z jakéhokoli důvodu, což způsobuje selhání čtení zdrojového souboru nebo složky. Některé chyby mohou být "žádný takový soubor nebo adresář", "oprávnění odepřeno", "chyba vstupu/výstupu" atd. Ujistěte se, že síťové spojení mezi agentem a zdrojovým sdíleným úložištěm funguje bez problémů. Musí existovat zdrojová sdílená složka, složka nebo soubory a agent by měl mít ke zdrojové sdílené složce přístup pro čtení.
AZSM1021	Nepodařilo se získat přístup k cílové složce kvůli problémům s oprávněními	Zkuste to znovu nebo vytvořte lístek podpory.
AZSM1022	Zadaná cílová cesta je neplatná.	Vytvořte nový koncový bod s platným cílovým kontejnerem a cestou a aktualizujte definici úlohy a zkuste to znovu.
AZSM1023	Platnost zapůjčení pro tohoto agenta vypršela v cílovém kontejneru.	Zkuste to znovu nebo vytvořte lístek podpory.
AZSM1024	Selhání autorizace při přístupu k cílovému umístění	Agent nemá dostatečná oprávnění pro přístup k cílovému umístění. Přiřazení rolí RBAC (řízení přístupu na základě role) se provádí automaticky při vytváření prostředků pomocí webu Azure Portal. Pokud používáte rozhraní API, rutiny PowerShellu nebo sady SDK, ručně vytvořte přiřazení role pro spravovanou identitu agenta pro přístup k cílovému umístění. Pro cílový kontejner blobů použijte přiřazení role Přispěvatel dat pro objekt Blob úložiště. Pro sdílenou složku Azure jako cíl použijte Přispěvatel privilegovaných dat souborů úložiště. Pokud chcete například přiřadit roli RBAC, přečtěte si článek Přiřazení role Azure pro přístup k datům objektů blob .
AZSM1025	Selhání ověřování při přístupu ke zdrojovému umístění	Ověřte, že má agent oprávnění ke zdrojovému umístění.
AZSM1026	Agent nepodporuje cílový typ.	Tento cílový typ není podporován aktuálním agentem Storage Mover.
AZSM1027	Cílové umístění je zaneprázdněné.	Agent nemůže reklamovat cílový podíl nebo kontejner, protože existuje aktivní pronájem. Nájem může být způsoben jinou úlohou migrace nebo předchozí ukončenou úlohou, která stále drží nárok na soubor "AZURE_STORAGE_MOVER_MARKER". Ujistěte se, že pro tento cíl neběží žádná jiná úloha. Pokud neběží žádný, restartujte agenta a zkuste to znovu. Pokud potíže potrvají, obraťte se na podporu.
AZSM1028	Selhání přístupu ke službě Key Vault	K této chybě může dojít v případě, že spravovaná identita agenta nemá přístup RBAC "Key Vault Secrets User", pokud brány firewall nebo síťové seznamy ACL blokují připojení ke koncovému bodu trezoru klíčů nebo pokud chybí tajemství. V případě chyby „RESPONSE 403“ zkontrolujte přiřazení rolí a firewallová pravidla v úložišti klíčů, která mohou omezovat provoz. V případě jiných chyb použijte možnost nabídky xdmsh "5) Test připojení jednoho koncového bodu" v části "2) Konfigurace sítě" k ověření dostupnosti koncového bodu.
AZSM1029	Typ zdrojového koncového bodu, který tato verze agenta nepodporuje	Tento typ zdroje nepodporuje aktuální agent služby Storage Mover.
AZSM1030	Nejde ověřit typ účtu úložiště	Ověřte, že účet úložiště a kontejner existují a že agent má udělená oprávnění.
AZSM1031	Řešení cílového hostitele se nezdařilo.	Zkontrolujte konfiguraci sítě a ověřte, že firewally ani ACL neblokují přístup k endpointu účtu úložiště. Pomocí možnosti v nabídce "5) Test připojení jednoho koncového bodu" v části "2) Konfigurace sítě" v xdmsh ověřte dosahování koncového bodu.
AZSM1040	Různé chyby při přístupu k cíli	Je pravděpodobné, že tato chyba je dočasná. Zkuste úlohu migrace zopakovat. Pokud problém přetrvává, vytvořte lístek podpory pro další pomoc.
AZSM1041	Nepovedlo se odeslat průběh úlohy.	Je pravděpodobné, že tato chyba je dočasná. Zkuste úlohu migrace zopakovat. Pokud problém přetrvává, vytvořte lístek podpory pro další pomoc.
AZSM1042	Vytvoření úlohy se nezdařilo.	K této chybě může dojít z různých důvodů: například když se agent nemůže spojit s koncovým bodem účtu úložiště, brány firewall nebo síťové seznamy ACL blokují připojení, kdy je přenos z agenta směrován přes veřejnou IP adresu, přestože je nakonfigurován privátní koncový bod v účtu úložiště, nebo když proxy server upravuje certifikát. Pokud chcete ověřit dostupnost koncového bodu účtu úložiště, použijte možnost v nabídce xdmsh "5) Otestovat konektivitu jediného koncového bodu" pod "2) Konfigurace sítě". Pokud se zobrazí chyba x509: certifikát podepsaný neznámou autoritou, znamená to, že místní síť zachytává a mění certifikáty SSL (Interception) pro přenosy do požadovaných koncových bodů, což způsobí, že agent nerozpozná přijaté certifikáty. Když do agenta přidáte certifikáty, obvykle se tento problém vyřeší, tato funkce se v současné době nepodporuje. Pokud chcete agentovi povolit přístup k těmto koncovým bodům, zvažte jejich přidání do seznamu povolených, aby se obešla intercepce SSL.
AZSM1043	Nepodařilo se obnovit úlohu.	Zkuste to znovu nebo vytvořte lístek podpory.
AZSM1044	Dokončení úlohy se nezdařilo.	Zkuste to znovu nebo vytvořte lístek podpory.
AZSM1045	Úloha byla přerušena, i když byla stále spuštěná.	Zkuste to znovu nebo vytvořte lístek podpory.
AZSM1060	Různé chyby při provádění úlohy.	K této chybě může dojít z různých důvodů. Zkontrolujte nahlášenou chybu a proveďte nápravné akce na základě podrobností uvedených níže. Pokud chyba značí: 1) InvalidResourceName: Zkontrolujte, jestli názvy složek a souborů dodržují podporované zásady vytváření názvů. Například "con" není platný název adresáře. 2) "Zadaná sdílená složka je plná": Ověřte kapacitu cílové sdílené složky. 3) "Chybný popisovač souboru": Ověřte, že síťové připojení SMB mezi agentem a zdrojem funguje správně a že server SMB reaguje na požadavky na čtení. 4) "403 Tento požadavek nemá oprávnění k provedení této operace": Pokud je pro cílový účet úložiště nakonfigurovaný privátní koncový bod, zkontrolujte, jestli je DNS správně nakonfigurovaný, a ověřte, že neexistují žádné konfigurace dns, které by nesprávně směrovaly nebo nástroje pro vyrovnávání zatížení způsobily nesprávné překlad IP adresy. 5) V případě jiných chyb zkuste úlohu zopakovat; Pokud problém přetrvává, vytvořte lístek podpory.
AZSM2021	Typ souboru není podporován cílem.	Tento cílový typ nepodporuje soubory tohoto typu. Další informace najdete v referenčních cílech škálovatelnosti a výkonu pro Azure Files a Azure Blob Storage .
AZSM2024	Délka zdrojové cesty delší než maximální podporovaná cílem	Pokyny najdete v článku Pojmenování a odkazování na sdílené složky, adresáře, soubory a metadata .
AZSM2026	Zdrojový soubor má velikost větší než maximální podporovaná podle cíle.	Pokyny najdete v článku Pojmenování a odkazování na sdílené složky, adresáře, soubory a metadata .
AZSM2027	Popisovač zabezpečení zdrojového souboru má nepodporované vlastnosti.	Zkontrolujte oprávnění souboru nebo složky.
AZSM2061	Při kontrole zdroje došlo k neznámé chybě.	Může se jednat o přechodnou chybu. Znovu spusťte úlohu migrace.
AZSM2062	Nepodařilo se přečíst zdrojový soubor kvůli problémům s oprávněními.	Ověřte, že má agent oprávnění ke zdrojovému umístění.
AZSM2063	Při čtení zdrojového souboru došlo k chybě vstupně-výstupních operací.	Je pravděpodobné, že tato chyba je dočasná. Zkuste úlohu migrace zopakovat. Pokud problém přetrvává, vytvořte lístek podpory pro další pomoc.
AZSM2069	Načtení cílového souboru se nezdařilo kvůli problémům s oprávněními.	Ověřte, že agent má udělená oprávnění k cílovému umístění.
AZSM2070	Nelze zapisovat objekt blob, protože má aktivní zapůjčení.	Příčinou této chyby může být zápis do umístění jiným agentem. Ujistěte se, že pro cíl neběží žádná jiná úloha. Zkuste to znovu nebo vytvořte lístek podpory.
AZSM2071	Zdrojový soubor byl během přenosu změněn.	Je pravděpodobné, že tato chyba je dočasná. Zkuste úlohu migrace zopakovat. Pokud problém přetrvává, vytvořte lístek podpory pro další pomoc.
AZSM2080	Kopírování selhalo kvůli neznámé chybě	Je pravděpodobné, že tato chyba je dočasná. Zkuste úlohu migrace zopakovat. Pokud problém přetrvává, vytvořte lístek podpory pro další pomoc.

Řešení problémů s řízením přístupu na základě role (RBAC) v nástroji Storage Mover

Během spuštění úlohy dojde k automatickému přiřazování RBAC. Pokud dojde k selháním přiřazování rolí, přidejte ručně potřebné přiřazení role.

1. Přejděte k příslušnému prostředku – Key Vault, File Share nebo Blob kontejner.
2. Přejděte do řízení přístupu (IAM).
3. Přidejte nové přiřazení role: Přiřazení rolí Azure prostřednictvím Azure portálu – Azure RBAC | Microsoft Learn.
4. V průvodci přidáním přiřazení role vyhledejte v následující tabulce příslušnou roli pro typ prostředku vybraný v kroku 1. V následujícím příkladu by prostředek byl Key Vault.

Typ prostředku	Požadované role
Key Vault	Uživatel tajných kódů služby Key Vault
Sdílení souborů	Privilegovaný přispěvatel dat úložného souboru
Kontejner Blobů	Privilegovaný přispěvatel dat ve Storage Blob

i. Přiřazení přístupu by mělo být pro "Managed Identity".
Ii. V pravém podokně vyberte spravovaný typ identity jako Stroj – Azure Arc.
Iii. Ze seznamu vyberte oblouk stroje. Má stejný název jako agent.
Iv. Dokončete zadání.