Solução de problemas de códigos de erro de execução de tarefas do Storage Mover

Um agente do Azure Storage Mover usa códigos de status de cadeia de caracteres para status que são transmitidos ao usuário final. Todos os códigos de status têm o prefixo AZSM seguido por quatro dígitos decimais. O primeiro dígito decimal indica o escopo de alto nível do status. Cada código de status deve pertencer a um dos seguintes escopos:

• Status que se aplica a todo o agente.
  Esses códigos usam o dígito 0de escopo e, portanto, têm o prefixo AZSM0.
• Status que se aplica a um trabalho específico executado pelo agente.
  Esses códigos usam o dígito 1 de escopo e, portanto, têm o prefixo AZSM1.
• Status que pode ser definido pelo agente em um arquivo ou diretório específico que é transferido por um trabalho executado pelo agente.
  Esses códigos usam o dígito 2 de escopo e, portanto, têm o prefixo AZSM2.

Cada um desses escopos divide ainda mais os status em categorias e subcategorias. Cada subcategoria normalmente reserva 20 códigos de status para acomodar a expansão futura.

Gorjeta

AZSM0000 é o código de status agnóstico de escopo especial que indica operação bem-sucedida e deve ser usado para significar operação bem-sucedida em qualquer escopo/nível.

Código de Erro	Mensagem de Erro	Detalhes/Etapas de solução de problemas/Mitigação
AZSM1001	Falha ao montar o caminho de origem	Verifique se o nome do servidor fornecido ou o endereço IP é válido ou se o local de origem está correto. Se estiver usando o SMB, verifique se o nome de usuário e a senha fornecidos estão corretos.
AZSM1002	Encontrou um erro ao verificar a origem	Tente novamente ou crie um tíquete de suporte.
AZSM1003	Falha ao acessar a pasta de origem devido a problemas de permissão	Verifique se o agente recebeu permissões para o compartilhamento de arquivos de origem.
AZSM1004	O caminho de origem fornecido é inválido	Crie um novo ponto de extremidade com um caminho de compartilhamento de origem válido e atualize a definição de tarefa e tente novamente.
AZSM1020	Erro diverso ao acessar a fonte	Este erro é relatado por qualquer motivo que cause falhas de leitura de arquivo/pasta de origem. Alguns dos erros podem ser "nenhum arquivo ou diretório desse tipo", "permissão negada", "erro de entrada/saída", etc. Verifique se a conexão de rede entre o agente e o compartilhamento de origem está funcionando bem. A partilha/pasta/ficheiros de origem deve estar disponível e o agente deve ter acesso de leitura à partilha de origem.
AZSM1021	Falha ao acessar a pasta de destino devido a problemas de permissão	Tente novamente ou crie um tíquete de suporte.
AZSM1022	O caminho de destino fornecido é inválido	Crie um novo ponto de extremidade com um contêiner e um caminho de destino válidos e atualize a definição do trabalho e tente novamente.
AZSM1023	A concessão expirou para este agente no contêiner de destino	Tente novamente ou crie um tíquete de suporte.
AZSM1024	Falha de autorização ao acessar o local de destino	O agente não tem permissão suficiente para acessar o local de destino. As atribuições de função RBAC (controle de acesso baseado em função) são executadas automaticamente quando os recursos são criados usando o portal do Azure. Se você estiver usando APIs, cmdlets do PowerShell ou SDKs, crie manualmente uma atribuição de função para a identidade gerenciada do agente para acessar o local de destino. Para o destino do contêiner de Blob de Armazenamento, use a atribuição de função Colaborador de Dados de Blob de Armazenamento . Para o compartilhamento de arquivos do Azure como destino, use o Colaborador Privilegiado de Dados do Arquivo de Armazenamento. Como exemplo, para atribuir a função RBAC, consulte o artigo Atribuir uma função do Azure para acesso a dados de blob .
AZSM1025	Falha de autenticação ao acessar o local de origem	Verifique se o agente tem permissões para o local de origem.
AZSM1026	O tipo de destino não é suportado pelo agente	Esse tipo de destino não é suportado pelo agente atual do Storage Mover.
AZSM1027	O local de destino está ocupado	O agente não pode reivindicar a partilha ou o contêiner de destino porque existe uma concessão ativa. A concessão pode ser devida a outro trabalho de migração ou a um trabalho anterior abortado que ainda mantém uma reivindicação no arquivo "AZURE_STORAGE_MOVER_MARKER". Certifique-se de que nenhum outro trabalho está sendo executado para esse alvo. Se nenhum estiver em execução, reinicie o agente e tente novamente; Se o problema persistir, contacte o Serviço de Apoio.
AZSM1028	Falha de acesso ao Cofre da Chave	Esse erro pode ocorrer se a identidade gerida do agente não tiver acesso RBAC como "Key Vault Secrets User", se os firewalls ou as ACLs de rede bloquearem as conexões com o endpoint do cofre de chaves, ou se os segredos do cofre de chaves estiverem faltando. Para um erro "RESPONSE 403", verifique as atribuições de função e quaisquer regras de firewall no cofre de chaves que possam restringir o tráfego. Para outros erros, use a opção do menu xdmsh "5) Testar a conectividade de um único ponto final" em "2) Configuração de rede" para verificar o alcance do ponto final.
AZSM1029	Tipo de ponto de extremidade de origem não suportado por esta versão do agente	Esse tipo de origem não é suportado pelo agente atual do Storage Mover.
AZSM1030	Não é possível verificar o tipo de conta de armazenamento	Verifique se a conta de armazenamento e o contêiner existem e se o agente recebeu permissões para eles.
AZSM1031	Falha ao resolver o host de destino	Verifique a configuração da rede para confirmar se firewalls ou ACLs não estão a bloquear o acesso ao endpoint da conta de armazenamento. Use a opção do menu xdmsh "5) Testar a conectividade de um único ponto final" em "2) Configuração de rede" para verificar o alcance do ponto final.
AZSM1040	Erro diverso ao acessar o destino	É provável que esse erro seja temporário. Tente novamente o trabalho de migração. Se o problema persistir, crie um tíquete de suporte para obter mais assistência.
AZSM1041	Falha ao enviar o progresso do trabalho	É provável que esse erro seja temporário. Tente novamente o trabalho de migração. Se o problema persistir, crie um tíquete de suporte para obter mais assistência.
AZSM1042	Falha na criação de emprego	Esse erro pode ocorrer devido a vários motivos, como o agente não conseguir acessar o ponto de extremidade da conta de armazenamento, firewalls ou ACLs de rede bloqueando a conexão, o tráfego do agente sendo roteado por um IP público quando um ponto de extremidade privado é configurado na conta de armazenamento ou um proxy modificando o certificado. Para verificar a acessibilidade do ponto de extremidade da conta de armazenamento, use a opção do menu xdmsh "5) Testar conectividade de ponto de extremidade único" em "2) Configuração de rede". Se o erro relatado for "x509: certificado assinado por autoridade desconhecida", isso indica que a rede local está intercetando e alterando certificados SSL (Intercetação SSL) para o tráfego para os pontos de extremidade necessários, fazendo com que o Agente não reconheça os certificados recebidos. Embora a adição de certificados ao Agente normalmente resolva esse problema, esse recurso não é suportado no momento. Para permitir que o Agente acesse esses pontos de extremidade, considere adicioná-los à lista de permissões para ignorar a Intercetação SSL.
AZSM1043	Falha ao retomar o trabalho	Tente novamente ou crie um tíquete de suporte.
AZSM1044	Falha ao finalizar o trabalho.	Tente novamente ou crie um tíquete de suporte.
AZSM1045	Job foi abortado enquanto ainda estava em execução.	Tente novamente ou crie um tíquete de suporte.
AZSM1060	Erro diverso durante a execução do trabalho.	Este erro pode ocorrer devido a várias razões. Analise o erro relatado e tome medidas corretivas com base em seus detalhes, conforme descrito abaixo. Se o erro indicar: 1) "InvalidResourceName": Verifique se os nomes de pastas e arquivos seguem as convenções de nomenclatura suportadas. Por exemplo, "con" não é um nome de diretório válido. 2) "A quota especificada está cheia": Verificar a capacidade da quota alvo. 3) "descritor de arquivo incorreto": Confirme se a conexão de rede SMB entre o agente e a fonte está funcionando corretamente e se o servidor SMB está respondendo a solicitações de leitura. 4) "403 Esta solicitação não está autorizada a executar esta operação": Se um ponto de extremidade privado estiver configurado para a conta de armazenamento de destino, verifique se o DNS está configurado corretamente e verifique se não há erros de roteamento de DNS ou configurações de balanceador de carga que causem resolução IP incorreta. 5) Para outros erros, tente novamente o trabalho; se o problema persistir, crie um ticket de suporte.
AZSM2021	Tipo de ficheiro não suportado pelo destino.	Este tipo de destino não suporta ficheiros deste tipo. Consulte metas de escalabilidade e desempenho para Arquivos do Azure e Armazenamento de Blob do Azure para obter informações adicionais.
AZSM2024	Comprimento do caminho de origem maior do que o máximo suportado pelo destino.	Consulte as orientações no artigo Nomeando e referenciando compartilhamentos, diretórios, arquivos e metadados .
AZSM2026	O arquivo de origem tem tamanho maior do que o máximo suportado pelo destino.	Consulte as orientações no artigo Nomeando e referenciando compartilhamentos, diretórios, arquivos e metadados .
AZSM2027	O descritor de segurança do ficheiro de origem tem propriedades não suportadas	Revise as permissões do arquivo ou pasta.
AZSM2061	Erro desconhecido encontrado ao verificar a fonte.	Pode ser um erro transitório. Execute novamente o trabalho de migração.
AZSM2062	Falha ao ler o arquivo de origem devido a problemas de permissão.	Verifique se o agente tem permissões para o local de origem.
AZSM2063	Erro de E/S encontrado ao ler o arquivo de origem.	É provável que esse erro seja temporário. Tente novamente o trabalho de migração. Se o problema persistir, crie um tíquete de suporte para obter mais assistência.
AZSM2069	Falha ao ler o arquivo de destino devido a problemas de permissão.	Verifique se o agente recebeu permissões para o local de destino.
AZSM2070	Não é possível escrever blob porque tem uma concessão ativa	Este erro pode ser causado por outro agente gravando no local. Certifique-se de que nenhum outro trabalho está sendo executado contra o alvo. Tente novamente ou crie um tíquete de suporte.
AZSM2071	O arquivo de origem foi modificado durante a transferência	É provável que esse erro seja temporário. Tente novamente o trabalho de migração. Se o problema persistir, crie um tíquete de suporte para obter mais assistência.
AZSM2080	Falha na cópia devido a um erro desconhecido	É provável que esse erro seja temporário. Tente novamente o trabalho de migração. Se o problema persistir, crie um tíquete de suporte para obter mais assistência.

Solução de problemas de RBAC no Storage Mover

Durante a execução de um trabalho, as atribuições do RBAC são realizadas automaticamente. Se houver falhas nas atribuições, adicione manualmente a atribuição de função necessária.

1. Navegue até o recurso apropriado - Cofre de Chaves, Compartilhamento de Arquivos ou Contêiner de Blob.
2. Navegue até Controle de acesso (IAM).
3. Adicionar uma nova atribuição de função: atribuir funções do Azure usando o portal do Azure - Azure RBAC | Microsoft Learn.
4. No assistente Adicionar atribuição de função, procure a função apropriada na tabela abaixo para o tipo de recurso selecionado na etapa 1. No exemplo abaixo, o recurso seria Key Vault.

Tipo de Recurso	Funções necessárias
Key Vault (Cofre de Chaves)	Usuário do Key Vault Secrets
Partilha de Ficheiros	Contribuidor privilegiado de dados de ficheiros de armazenamento
Blob Container	Contribuidor privilegiado de dados de Blob de armazenamento

i) Atribuir acesso deve ser para "Identidade gerenciada".
II. No painel direito, selecione Tipo de identidade gerenciada como Máquina – Azure Arc.
iii. Selecione o arco da máquina na lista. Tem o mesmo nome que o agente.
iv. Conclua a tarefa.