Arquivo e restaurar contentores

Aplica-se a: Programador

Utilize o arquivo de contentor do SharePoint Embedded quando um contentor tem de ser retido, mas já não precisa de ser acedido ou utilizado para colaboração. O arquivo utiliza o Microsoft 365 Arquivo, uma camada de armazenamento a frio que reduz os custos de armazenamento mantendo as mesmas normas de segurança, conformidade e pesquisa. Para obter a descrição geral do Microsoft 365 Arquivo, consulte Microsoft 365 Arquivo.

Importante

O Microsoft 365 Arquivo está em Pré-visualização do SharePoint Embedded. Valide a disponibilidade do inquilino, a faturação e o comportamento da API antes de expor as ações de arquivo aos utilizadores.

Ativar o arquivo num tipo de contentor

O arquivo tem de estar ativado no tipo de contentor. Utilize o PowerShell de administrador do SharePoint Embedded para um tipo de contentor existente.

Set-SPOContainerTypeConfiguration -ContainerTypeId <id> -IsArchiveEnabled $true

Ative o arquivo quando criar um novo tipo de contentor ao transmitir -IsArchiveEnabled $true.

New-SPOContainerType -ContainerTypeName <name> -OwningApplicationId <id> -IsArchiveEnabled $true

Mostrar apenas comandos de arquivo na sua aplicação após a aplicação proprietária e o inquilino de consumo estarem configurados para o tipo de contentor.

Arquivo um contentor

Chame a ação de arquivo beta do Microsoft Graph para o contentor de destino.

POST https://graph.microsoft.com/beta/storage/fileStorage/containers/{containerId}/archive

O autor da chamada tem de ter a Owner função ou PrincipalOwner no contentor. Os Administradores Globais e os Administradores Do SharePoint Embedded podem agir em todos os contentores. A aplicação também tem de ter permissão de escrita no contentor.

Um contentor arquivado está inacessível até ser reativado. Pare carregamentos, processadores em segundo plano, fluxos de trabalho dependentes de webhook e edições interativas antes de submeter o pedido de arquivo.

Obter contentores arquivados

Leia um contentor arquivado com a operação normal de obtenção do contentor.

GET https://graph.microsoft.com/beta/storage/fileStorage/containers/{containerId}

Liste os contentores arquivados para um tipo de contentor ao filtrar contentores com detalhes de arquivo.

GET https://graph.microsoft.com/beta/storage/fileStorage/containers?$filter=containerTypeId eq {containerTypeId} and archivalDetails ne null

Utilize esta lista para vistas de ciclo de vida, relatórios de administração ou fluxos de reativação. Torne o estado arquivado visível na sua IU para que os utilizadores compreendam por que motivo os ficheiros não podem ser abertos.

Reativar um contentor

Chame a ação não abrangente beta do Microsoft Graph para reativar um contentor arquivado.

POST https://graph.microsoft.com/beta/storage/fileStorage/containers/{containerId}/unarchive

A reativação é instantânea durante os primeiros sete dias após o arquivo. Após sete dias, a reativação pode demorar até 24 horas. Mantenha as ações de leitura e escrita do contentor desativadas até que o serviço reporte que o contentor está novamente ativo.

Criar controlos de ciclo de vida

Exigir intenção explícita do utilizador antes de arquivar e pedidos não abrangentes. Registe o ID do contentor, o ator, o carimbo de data/hora e os dados de correlação de pedidos do Graph nos registos da aplicação. Não trate o arquivo como eliminação; os requisitos de retenção, Deteção de Dados Eletrónicos, auditoria e conformidade ainda se aplicam aos dados arquivados.

Se uma operação de ciclo de vida falhar, marcar a função de autor da chamada, a permissão de escrita da aplicação, a definição de arquivo do tipo de contentor e se o contentor de destino já está no estado pedido.

Próximas etapas