Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a: Desenvolvedor
Use o arquivamento de contêiner do SharePoint Embedded quando um contêiner precisar ser retido, mas não precisar mais ser acessado ativamente ou usado para colaboração. O arquivamento usa o Microsoft 365 Arquivo, uma camada de armazenamento frio que reduz o custo de armazenamento, mantendo os mesmos padrões de segurança, conformidade e pesquisa. Para obter a visão geral do Arquivo do Microsoft 365, consulte Arquivo do Microsoft 365.
Importante
O Arquivo Morto do Microsoft 365 está em versão prévia para o SharePoint Embedded. Valide a disponibilidade, a cobrança e o comportamento da API do locatário antes de expor as ações de arquivo morto aos usuários.
Habilitar o arquivamento em um tipo de contêiner
O arquivamento deve estar habilitado no tipo de contêiner. Use o PowerShell de administrador do SharePoint Embedded para um tipo de contêiner existente.
Set-SPOContainerTypeConfiguration -ContainerTypeId <id> -IsArchiveEnabled $true
Habilitar o arquivamento ao criar um novo tipo de contêiner transmitindo -IsArchiveEnabled $true.
New-SPOContainerType -ContainerTypeName <name> -OwningApplicationId <id> -IsArchiveEnabled $true
Mostrar comandos de arquivo morto somente em seu aplicativo depois que o aplicativo proprietário e o locatário consumidor forem configurados para o tipo de contêiner.
Arquivo um contêiner
Chame a ação de arquivo morto beta do Microsoft Graph para o contêiner de destino.
POST https://graph.microsoft.com/beta/storage/fileStorage/containers/{containerId}/archive
O chamador deve ter a Owner função ou PrincipalOwner no contêiner. Os Administradores Globais e os Administradores Incorporados do SharePoint podem atuar em todos os contêineres. O aplicativo também deve ter permissão de gravação no contêiner.
Um contêiner arquivado fica inacessível até ser reativado. Interrompa uploads, processadores em segundo plano, fluxos de trabalho dependentes de webhook e edições interativas antes de enviar a solicitação de arquivamento.
Obter contêineres arquivados
Leia um contêiner arquivado com a operação normal de obtenção de contêiner.
GET https://graph.microsoft.com/beta/storage/fileStorage/containers/{containerId}
Liste os contêineres arquivados para um tipo de contêiner filtrando os contêineres que têm detalhes de arquivamento.
GET https://graph.microsoft.com/beta/storage/fileStorage/containers?$filter=containerTypeId eq {containerTypeId} and archivalDetails ne null
Use esta lista para visualizações de ciclo de vida, relatórios administrativos ou fluxos de reativação. Torne o estado arquivado visível na interface do usuário para que os usuários entendam por que os arquivos não podem ser abertos.
Reativar um contêiner
Chame a ação de desarquivamento do Microsoft Graph beta para reativar um contêiner 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 arquivamento. Após sete dias, a reativação pode levar até 24 horas. Mantenha as ações de leitura e gravação do contêiner desabilitadas até que o serviço relate que o contêiner está ativo novamente.
Controles do ciclo de vida do design
Exigir intenção explícita do usuário antes de arquivar e desarquivar solicitações. Registre a ID do contêiner, o ator, o carimbo de data/hora e os dados de correlação de solicitação do Graph nos logs do aplicativo. Não trate o arquivo morto como exclusão; Os requisitos de retenção, descoberta eletrônica, auditoria e conformidade ainda se aplicam aos dados arquivados.
Se uma operação de ciclo de vida falhar, marcar a função do chamador, a permissão de gravação do aplicativo, a configuração de arquivamento do tipo de contêiner e se o contêiner de destino já está no estado solicitado.