Recuperar ou excluir permanentemente itens

Fabric dá suporte à exclusão suave e à recuperação de itens individuais em ambientes de trabalho. Quando você exclui um item com suporte, ele insere um período de retenção durante o qual colaboradores, membros e administradores do workspace podem recuperá-lo. Essa proteção ajuda a evitar a perda acidental de dados, dando a você a oportunidade de restaurar itens antes que eles sejam permanentemente removidos.

Neste artigo, você aprenderá a configurar a retenção de itens, recuperar itens excluídos e excluir itens permanentemente antes que o período de retenção expire.

Para obter uma visão geral de como a retenção funciona para espaços de trabalho e itens, consulte Retenção e recuperação no Fabric.

Pré-requisitos

  • Para definir as configurações de retenção de item, você precisa de uma função de administrador de locatário .
  • Para recuperar itens excluídos, você precisa de pelo menos permissões de Colaborador do Workspace . Consulte Permissões para a matriz de permissões completa.
  • Para excluir permanentemente itens recuperáveis, você precisa de permissões de Administrador do Workspace .

Configurar o período de retenção para itens excluídos

Observação

A recuperação de itens agora está habilitada por padrão, com um período de retenção de três dias. O padrão se aplica a inquilinos que nunca configuraram explicitamente a configuração de Recuperação de Itens e a locatários recém-criados. Fabric preserva as configurações definidas explicitamente por um administrador: se você já ativou a recuperação de itens, seu valor de retenção atual permanece o mesmo, e, se você a desativou explicitamente, ela permanece desativada.

Você pode alterar o período de retenção (de 3 para 90 dias) ou desativar a recuperação de itens usando a configuração de tenant de Recuperação de Items .

  1. No portal de administração, vá para as configurações do locatário>Recuperação de item.
  2. Certifique-se de que a configuração esteja ativada e então insira o número de dias para o período de retenção (de 3 a 90 dias).
  3. Selecione Aplicar.

Observação

Quando a configuração Item Recovery está desativada, Fabric não retém itens excluídos quando você exclui um item individual.

A configuração de Recuperação de Item não afeta o prazo de retenção das áreas de trabalho. Consulte Retenção e recuperação em Fabric para detalhes sobre a retenção do workspace.

Restaurar um item excluído

Enquanto um item excluído está em um período de retenção, colaboradores, membros e administradores do workspace podem restaurá-lo e suas propriedades.

Use a lixeira do workspace para restaurar um item

A lixeira do workspace é uma exibição dedicada em cada espaço de trabalho onde você pode procurar, restaurar ou excluir permanentemente itens excluídos temporariamente.

  1. Abra o espaço de trabalho que continha o item excluído.
  2. Selecione Lixeira na navegação do workspace.
  3. Localize o item que você deseja recuperar. Você pode usar as opções de filtro e pesquisa para localizar itens específicos.
  4. Selecione o item e escolha Restaurar na barra de ferramentas.

O item restaurado reaparece em seu workspace original com suas propriedades, configurações e relações intactas.

Usar a API REST para restaurar um item

Use a API REST para recuperar itens excluídos programaticamente.

Solicitação:

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/recoverableItems/{itemId}/recover

Parâmetros:

  • workspaceId - O identificador exclusivo do workspace que contém o item excluído.
  • itemId - O identificador exclusivo do item a ser recuperado.

Exemplo:

curl --request POST \
  --url https://api.fabric.microsoft.com/v1/workspaces/aaaabbbb-0000-cccc-1111-dddd2222eeee/recoverableItems/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2/recover \
  --header 'Authorization: Bearer {token}'

Resposta:

  • 200 OK – Item recuperado com êxito.
  • 404 Não Encontrado – Item não encontrado ou não mais no período de recuperação.
  • 403 Proibido – O usuário não tem permissão para recuperar o item.

Observação

Os itens recuperados mantêm suas propriedades, configurações e permissões originais. Se o item depender de outros itens excluídos, talvez seja necessário restaurar essas dependências primeiro.

Importante

Se existir um novo item com o mesmo nome do item excluído temporariamente no mesmo workspace, a recuperação falhará até que você renomeie o item existente. Para recuperar o item excluído, renomeie o novo item e repita a operação de recuperação.

Excluir permanentemente um item recuperável

Embora um item excluído esteja em seu período de retenção, você poderá excluí-lo permanentemente se tiver permissões de administrador do workspace.

Usar a lixeira do workspace para excluir permanentemente um item

  1. Abra o espaço de trabalho que continha o item excluído.
  2. Selecione Lixeira na navegação do workspace.
  3. Localize o item que você deseja excluir permanentemente.
  4. Selecione o item e, em seguida, escolha Excluir permanentemente na barra de ferramentas.

Você será solicitado a confirmar a exclusão permanente.

Cuidado

Depois de confirmar a exclusão permanente, o item e seu conteúdo não serão mais recuperáveis.

Depois de excluir permanentemente um item, o OneLake retém os dados por mais sete dias. Você não pode restaurar dados durante esse período. A exclusão é final e não pode ser revertida.

Usar a API REST para excluir permanentemente um item

Use a API REST para excluir itens programaticamente durante o período de retenção.

Solicitação:

DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/recoverableItems/{itemId}

Parâmetros:

  • workspaceId - O identificador exclusivo do workspace que contém o item excluído.
  • itemId - O identificador exclusivo do item a ser excluído permanentemente.

Exemplo:

curl --request DELETE \
  --url https://api.fabric.microsoft.com/v1/workspaces/aaaabbbb-0000-cccc-1111-dddd2222eeee/recoverableItems/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2 \
  --header 'Authorization: Bearer {token}'

Cuidado

Depois de confirmar a exclusão permanente, o item e seu conteúdo não serão mais recuperáveis.

Depois de excluir permanentemente um item, o OneLake retém os dados por mais sete dias. Você não pode restaurar dados durante esse período. A exclusão é final e não pode ser revertida.

Conteúdo relacionado

  • Last updated on