Solução de problemas de códigos de erro de execução de tarefa do Migrador de Armazenamento

Um agente do Migrador de Armazenamento do Azure usa códigos de status de cadeia de caracteres para os status que são transmitidos ao usuário final. Todos os códigos de status têm o prefixo AZSM seguido de 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 de escopo 0 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 de escopo 1 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 de escopo 2 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.

Dica

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

Código do 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 ou o endereço IP fornecido é válido ou se o local de origem está correto. Se estiver usando 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 ponto de extremidade com um caminho de compartilhamento de origem válido, atualize a definição do trabalho e tente novamente.
AZSM1020	Erro diverso ao acessar a origem	Esse erro é relatado por qualquer motivo que cause falhas de leitura de arquivo/pasta de origem. Alguns dos erros podem ser "arquivo ou diretório não encontrado", "permissão negada", "erro de entrada/saída", etc. Verifique se a conexão de rede entre o agente e a origem compartilhada está funcionando bem. O compartilhamento/pasta/arquivos de origem devem estar presentes e o agente deve ter acesso de leitura ao compartilhamento 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 ponto de extremidade com um contêiner e caminho de destino válidos, atualize a repetição e definição do trabalho.
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 realizadas automaticamente quando os recursos são criados usando o portal do Azure. Se estiver usando as APIs, os cmdlets do PowerShell ou os 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 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. Por exemplo, para atribuir uma 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 agente não dá suporte ao tipo de destino	Este tipo de destino não tem suporte com o agente do Migrador de Armazenamento atual.
AZSM1027	O local de destino está ocupado	O agente não pode declarar o compartilhamento de destino ou o contêiner porque existe uma concessão ativa. A concessão pode ser devido a outro trabalho de migração ou um trabalho anulado anterior ainda mantendo uma declaração no arquivo "AZURE_STORAGE_MOVER_MARKER". Verifique se nenhum outro trabalho está em execução para esse destino. Se nenhum estiver em execução, reinicie o agente e tente novamente; se o problema continuar, entre em contato com o suporte.
AZSM1028	Falha no acesso ao Key Vault	Esse erro poderá ocorrer se a identidade gerenciada do agente não tiver acesso RBAC como "Usuário de Segredos do Cofre de Chaves", se firewalls ou ACLs (listas de controle de acesso de rede) bloquearem conexões com o ponto de extremidade do cofre de chaves, ou se os segredos estiverem ausentes. Para um erro "RESPONSE 403", verifique as atribuições de função e as regras de firewall no cofre de chaves que possam restringir o tráfego. Para outros erros, use a opção de menu xdmsh "5) Testar conectividade de ponto de extremidade único" em "2) Configuração de rede" para verificar a acessibilidade do ponto de extremidade.
AZSM1029	Tipo de ponto de extremidade de origem sem suporte por esta versão do agente	Este tipo de origem não tem suporte com o agente do Migrador de Armazenamento atual.
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 que os firewalls ou ACLs não estão bloqueando o acesso ao endpoint da conta de armazenamento. Use a opção de menu xdmsh "5) Testar conectividade do ponto de extremidade único" em "2) Configuração de rede" para verificar a acessibilidade do ponto de extremidade.
AZSM1040	Erro diverso ao acessar o destino	É provável que esse erro seja temporário. Repetir o trabalho de migração. Se o problema persistir, crie um tíquete de suporte para obter assistência adicional.
AZSM1041	Falha ao enviar o progresso do trabalho	É provável que esse erro seja temporário. Repetir o trabalho de migração. Se o problema persistir, crie um tíquete de suporte para obter assistência adicional.
AZSM1042	Falha ao criar o trabalho	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 de 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 de certificação desconhecida", isso indica que a rede nas instalações locais está interceptando e alterando certificados SSL (interceptação SSL) para o tráfego direcionado aos endpoints 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 tem suporte no momento. Para permitir que o Agente acesse esses endpoints, considere adicioná-los à lista de permissões para ignorar a Interceptação de 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	O trabalho foi anulado enquanto ainda estava em execução.	Tente novamente ou crie um tíquete de suporte.
AZSM1060	Erro diverso durante a execução do trabalho.	Esse erro pode ocorrer devido a vários motivos. Examine o erro relatado e execute ações corretivas com base em seus detalhes, conforme descrito abaixo. Se o erro indicar: 1) "InvalidResourceName": verifique se os nomes de pasta e arquivo seguem convenções de nomenclatura com suporte. Por exemplo, "con" não é um nome de diretório válido. 2) "O compartilhamento especificado está cheio": verifique a capacidade do compartilhamento de destino. 3) "descritor de arquivo incorreto": confirme se a conexão de rede SMB entre o agente e a origem está funcionando corretamente e se o servidor SMB está respondendo às 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á configurações de balanceador de carga ou de redirecionamento de DNS causando resolução de IP incorreta. 5) Para outros erros, tente executar o trabalho novamente; se o problema continuar, abra um chamado de suporte.
AZSM2021	Tipo de arquivo sem suporte pelo destino.	Esse tipo de destino não dá suporte para arquivos desse tipo. Consulte as metas de escalabilidade e desempenho para Arquivos do Azure e Armazenamento de Blobs do Azure para obter informações adicionais.
AZSM2024	Comprimento do caminho de origem maior do que o máximo com suporte pelo destino.	Consulte as diretrizes no artigo Nomeando e referenciando compartilhamentos, diretórios, arquivos e metadados.
AZSM2026	O arquivo de origem tem tamanho maior do que o máximo com suporte pelo destino.	Consulte as diretrizes no artigo Nomeando e referenciando compartilhamentos, diretórios, arquivos e metadados.
AZSM2027	O descritor de segurança do arquivo de origem tem propriedades sem suporte	Revise as permissões do arquivo ou da pasta.
AZSM2061	Erro desconhecido encontrado durante a verificação da origem.	Pode ser um erro transitório. Execute novamente o trabalho de migração.
AZSM2062	Falha na leitura do 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 durante a leitura do arquivo de origem.	É provável que esse erro seja temporário. Repetir o trabalho de migração. Se o problema persistir, crie um tíquete de suporte para obter assistência adicional.
AZSM2069	Falha na leitura do 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 gravar o blob porque ele tem uma concessão ativa	Esse erro pode ser causado por outro agente que esteja gravando no local. Certifique-se de que nenhum outro trabalho esteja sendo executado no destino. 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. Repetir o trabalho de migração. Se o problema persistir, crie um tíquete de suporte para obter assistência adicional.
AZSM2080	A cópia falhou devido a um erro desconhecido	É provável que esse erro seja temporário. Repetir o trabalho de migração. Se o problema persistir, crie um tíquete de suporte para obter assistência adicional.

Solução de problemas de RBAC do Storage Mover

Durante uma execução de trabalho, ocorrem atribuições automáticas de RBAC. Se houver falhas nas atribuições, adicione manualmente a atribuição de função necessária.

1. Navegue até o recurso apropriado – Key Vault, Compartilhamento de Arquivos ou Contêiner de Blobs.
2. Navegue até o Controle de Acesso (IAM).
3. Adicionar uma nova atribuição de função: atribuir funções do Azure usando o portal do Azure – RBAC do Azure | Microsoft Learn.
4. No assistente Adicionar atribuição de função, pesquise 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	Usuário de segredos do Key Vault
Compartilhamento de Arquivos	Colaborador Privilegiado de Dados de Arquivo de Armazenamento
Contêiner de Blob	Colaborador privilegiado de dados de blob de armazenamento

i. O acesso deve ser atribuído para "Identidade Gerenciada".
ii. No painel direito, selecione o tipo de Identidade Gerenciada como Máquina – Azure Arc.
iii. Selecione o arco do computador na lista. Tem o mesmo nome que o agente.
iv. Conclua a tarefa.