Criar e gerir contentores

Aplica-se a: Programador

Crie e faça a gestão de contentores após o tipo de contentor ser criado, registado e autorizado. Os contentores são a unidade de armazenamento básica no SharePoint Embedded.

Conclua Configurar autenticação e autorização antes de chamar as APIs de contentor.

Compreender os contentores

Todos os ficheiros e documentos do SharePoint Embedded são armazenados em contentores.

Um contentor:

  • Pertence a um inquilino do Microsoft 365 consumidor.
  • Tem um ID de tipo de contentor imutável.
  • Armazena conteúdo para a sua aplicação.
  • Define um limite para associação e permissões.
  • É acedido através do Microsoft Graph.

Para obter a descrição geral da arquitetura, veja Arquitetura da aplicação SharePoint Embedded.

Conhecer o ciclo de vida

Um ciclo de vida típico do contentor inclui:

  1. Crie um contentor.
  2. Adicionar ou confirmar membros.
  3. Carregar e gerir ficheiros.
  4. Ler ou atualizar metadados de contentor.
  5. Recicle um contentor quando este já não estiver ativo.
  6. Restaure um contentor reciclado quando necessário.
  7. Elimine permanentemente os contentores durante a limpeza.

Continue a Carregar, transferir e gerir ficheiros para operações de conteúdo.

Pré-requisitos

Antes de criar contentores, certifique-se de que:

  • O tipo de contentor existe.
  • O tipo de contentor está registado no inquilino que está a consumir.
  • A aplicação tem consentimento do Microsoft Graph FileStorageContainer.Selected .
  • A aplicação tem permissões de tipo de contentor para a operação.
  • Para chamadas delegadas, o utilizador com sessão iniciada pode receber a função de contentor necessária.
  • Para tipos de contentores de avaliação, está dentro dos limites de avaliação.

Importante

Os tipos de contentores de avaliação podem criar até cinco contentores, incluindo contentores ativos e contentores na reciclagem.

Escolher a criação delegada ou apenas da aplicação

Utilize o acesso delegado quando um utilizador inicia a criação, o utilizador deve ser responsável ou o utilizador que cria deve tornar-se Proprietário do contentor.

Utilize o acesso apenas à aplicação quando um serviço aprovisiona contentores, nenhum utilizador está presente e a aplicação tem permissão para criar contentores.

Observação

É atribuída automaticamente a função Proprietário a um utilizador que cria um novo contentor através de chamadas delegadas.

Criar um contentor

Utilize o Microsoft Graph para criar um contentor de armazenamento de ficheiros para o tipo de contentor registado.

Para obter a forma de API canónica, veja Criar ficheiroStorageContainer.

Passos de implementação:

  1. Adquirir um token válido do Microsoft Graph.
  2. Inclua as informações do tipo de contentor de destino exigidas pela API.
  3. Envie o pedido de criação.
  4. Armazene o ID de contentor devolvido.
  5. Armazenar metadados de apresentação de que a sua aplicação precisa.
  6. Atribua ou confirme a associação para cenários delegados.

Dica

Armazene o ID de contentor na base de dados da aplicação como a ligação durável entre o objeto empresarial e o contentor do SharePoint Embedded.

Criar um contentor no Visual Studio Code

Para desenvolvimento de avaliação, a extensão Visual Studio Code pode criar contentores.

  1. Abra a vista Do SharePoint Embedded.

  2. Expanda o tipo de contentor de avaliação registado.

  3. Clique com o botão direito do rato em Contentores.

  4. Selecione Criar contentor.

  5. Insira um nome.

  6. Confirme que o contentor aparece sob o tipo de contentor.

Veja Início Rápido: Criar a sua primeira aplicação com o VS Code para o fluxo de extensão.

Listar contentores

Listar contentores para mostrar os contentores disponíveis, validar o aprovisionamento ou executar a manutenção.

Para obter a forma de API canónica, veja Listar contentores.

Ao listar contentores:

  • Utilize o acesso apenas à aplicação para cenários de inventário de serviços.
  • Utilize o acesso delegado apenas quando o contexto de utilizador for adequado.
  • Processar paginação.
  • Mapear resultados para os dados da sua aplicação.

Observação

Atualmente, os contentores de lista delegados são devolvidos 403 Forbidden se o utilizador não tiver um OneDrive. Esta dependência não se aplica a chamadas de lista apenas de aplicações.

Obter um contentor

Obtenha um contentor quando precisar dos metadados mais recentes antes de agir.

Utilize esta operação para confirmar que o contentor existe, ler as propriedades de apresentação, verificar o tipo de contentor, marcar estado antes das operações de ficheiros e confirmar o restauro.

Ligar implementações a fileStorageContainer tipo de recurso.

Atualizar metadados de contentor

Atualizar metadados quando as propriedades suportadas são alteradas.

Antes de atualizar:

  1. Confirme que a aplicação tem permissão de tipo Write de contentor.
  2. Confirme que o utilizador delegado tem uma função adequada.
  3. Leia o estado atual do contentor.
  4. Aplicar apenas as alterações pretendidas.
  5. Valide a resposta.

Eliminar ou reciclar um contentor

Utilize o comportamento de eliminação quando um contentor já não estiver ativo.

Antes da eliminação:

  • Confirme que o autor da chamada tem permissão.
  • Confirme que a sua aplicação arquivou referências empresariais.
  • Decida se o contentor deve ser reciclado primeiro.
  • Explicar as opções de restauro.

A extensão Visual Studio Code inclui funcionalidades de reciclagem e recuperação para desenvolvimento de versões de avaliação.

Restaurar um contentor reciclado

Um fluxo de restauro deve:

  1. Identifique o contentor reciclado.
  2. Confirme que o autor da chamada tem permissão.
  3. Restaure o contentor.
  4. Atualize o estado da aplicação.
  5. Confirme que estão disponíveis ficheiros e metadados.
  6. Notifique o utilizador.

Importante

Para tipos de contentores de avaliação, os contentores na reciclagem continuam a contar para o limite de cinco contentores.

Eliminar permanentemente contentores

Elimine permanentemente apenas quando tiver a certeza de que o contentor já não é necessário.

Tem de remover todos os contentores de um tipo de contentor, incluindo contentores eliminados, antes de eliminar o próprio tipo de contentor.

Utilize a eliminação permanente para limpeza de avaliação, remoção de dados de teste, extinção de um tipo de contentor ou cumprimento dos requisitos do ciclo de vida.

Validar operações de ciclo de vida

Criar um teste rápido:

  1. Crie um contentor de teste.
  2. Obtenha-o por ID.
  3. Liste os contentores e confirme que são apresentados.
  4. Atualizar um valor de metadados suportado.
  5. Carregue um ficheiro pequeno.
  6. Recicle ou elimine o contentor.
  7. Restaure-o se for suportado.
  8. Elimine-o permanentemente durante a limpeza.

Resolver problemas de ciclo de vida

Sintoma Verificar
Falha ao criar Registo e Create permissão.
Falha na criação delegada Consentimento do utilizador e comportamento de atribuição de função.
A lista falha para o utilizador delegado Dependência do OneDrive indicada no artigo de autenticação.
Falha ao eliminar Delete permissão e função de Proprietário do utilizador.
Falha na criação da versão de avaliação Os contentores ativos e reciclados podem ter atingido o limite.
Falha na eliminação do tipo de contentor Todos os contentores ativos e eliminados têm de ser removidos primeiro.

Próximas etapas

Adicione operações de ficheiros em Carregar, transferir e gerir ficheiros.

  • Last updated on