Criar e configurar um tipo de contêiner

Aplica-se a: Desenvolvedor

Crie um tipo de contêiner do SharePoint Embedded para seu aplicativo para criar contêineres ou armazenar arquivos. Um tipo de contêiner define acesso, responsabilidade de cobrança e comportamentos selecionados para contêineres criados por seu aplicativo.

Se você está apenas começando, conclua o Início Rápido: crie seu primeiro aplicativo com o VS Code. Em seguida, use este artigo para decisões de avaliação, padrão e de passagem.

Para decidir entre modelos de locatário único e multilocatário primeiro, consulte Escolher um modelo de aplicativo.

Entender a relação de tipo de contêiner

Um tipo de contêiner é fortemente acoplado a um aplicativo do Microsoft Entra ID, chamado de aplicativo proprietário.

O SharePoint Embedded requer uma relação um-para-um entre um aplicativo proprietário e um tipo de contêiner.

A ID do tipo de contêiner é armazenada em cada contêiner como uma propriedade imutável.

O SharePoint Embedded usa a ID para autorização de acesso, exploração de avaliação, cobrança e comportamentos configuráveis.

Observação

A API do Graph Microsoft Graph — Create fileStorageContainerType — é delegada somente e pode ser chamada por qualquer usuário que não possua o locatário proprietário. O chamador não precisa de uma função de administrador e é atribuído automaticamente como proprietário do novo tipo de contêiner.

Escolha avaliação ou produção

Escolha a finalidade do tipo de contêiner ao criá-lo.

Não é possível converter um tipo de contêiner de avaliação para produção posteriormente.

Você não pode converter um tipo de cobrança padrão em cobrança de passagem mais tarde.

Caso de uso Tipo de contêiner
Prova de conceito local Tipo de contêiner de avaliação
O proprietário do aplicativo paga Tipo de contêiner Standard com perfil de cobrança
O locatário do cliente paga Tipo de contêiner Standard com faturamento de passagem

Importante

Se você escolher a finalidade ou o modelo de cobrança errados, deverá recriar o tipo de contêiner.

Pré-requisitos

Antes de criar um tipo de contêiner, verifique se você tem:

  • Um locatário do Microsoft 365 com SharePoint disponível.
  • Um registro de aplicativo do Microsoft Entra ID para o aplicativo proprietário.
  • Uma conta de membro não convidado no locatário proprietário.
  • Para cobrança padrão, uma assinatura do Azure e um grupo de recursos.
  • Para configuração de cobrança padrão, permissões de proprietário ou contribuidor na assinatura do Azure.

Observação

  • A criação de um tipo de contêiner por meio do Microsoft Graph requer apenas a FileStorageContainerType.Manage.All permissão delegada. Qualquer usuário não convidado no locatário proprietário pode criar um e é atribuído automaticamente como proprietário desse tipo de contêiner. Para operações administrativas em todo o locatário, consulte Criar aplicativos com o PowerShell.

  • Os usuários que se autenticam em contêineres devem existir no Microsoft Entra ID como membros ou convidados. Uma licença do Office não é necessária para colaborar em documentos do Office armazenados em um contêiner, exceto para experiências excepcionais documentadas, como menções.

Criar um tipo de contêiner de avaliação

Use um tipo de contêiner de avaliação para avaliação.

Você pode criar um com a extensão do Visual Studio Code Embedded do SharePoint ou com o Microsoft Graph.

O caminho do Visual Studio Code é o mais rápido para um primeiro aplicativo. Consulte Início Rápido: Criar seu primeiro aplicativo com o VS Code.

Para o Microsoft Graph, crie o tipo de contêiner com a classificação de trial cobrança.

As seguintes restrições se aplicam a tipos de contêiner de avaliação:

  • O locatário pode ter até cinco contêineres do tipo de contêiner. Isso inclui contêineres ativos e aqueles na lixeira.
  • Cada contêiner tem até 1 GB de espaço de armazenamento.
  • O tipo de contêiner expira após 30 dias e o acesso a todos os contêineres existentes nesse tipo de contêiner é removido.
  • O desenvolvedor deve excluir permanentemente todos os contêineres de um tipo de contêiner existente no status de avaliação para criar um novo tipo de contêiner para avaliação. Isso inclui contêineres na coleção de contêineres excluídos.
  • O tipo de contêiner é restrito para funcionar no locatário do desenvolvedor. Ele não pode ser implantado em outros locatários de consumo.

Criar um tipo de contêiner padrão com cobrança de proprietário do aplicativo

Use a cobrança padrão quando o locatário do desenvolvedor ou proprietário do aplicativo pagar pelo consumo.

Cada locatário pode criar até 25 tipos de contêiner no total. Um deles pode ser um tipo de contêiner de teste gratuito; O restante são tipos de contêiner padrão (cobrados).

  1. Crie ou identifique o aplicativo proprietário do Microsoft Entra ID.
  2. Crie o tipo de contêiner com a classificação de standard cobrança.
  3. Anexe um perfil de cobrança do Azure com a extensão do Visual Studio Code Embedded do SharePoint ou um fluxo de cobrança gerenciado pelo administrador.
  4. Registre a ID do tipo de contêiner.
  5. Continue para o registro no locatário consumidor.

Observação

Se a configuração de cobrança falhar com SubscriptionNotRegisteredo , aguarde alguns minutos e tente novamente. O Microsoft.Syntex registro do provedor de recursos pode demorar.

Criar um tipo de contêiner de cobrança de passagem

Use a cobrança de repasse quando o locatário consumidor pagar pelo consumo.

  1. Crie ou identifique o aplicativo proprietário do Microsoft Entra ID.
  2. Crie o tipo de contêiner com a classificação de directToCustomer cobrança.
  3. Registre o tipo de contêiner no locatário consumidor.
  4. Faça com que o administrador do locatário consumidor ative os serviços de pagamento conforme o uso.

Importante

O locatário consumidor deve concluir a configuração de cobrança antes que um aplicativo de passagem possa ser usado com êxito.

O administrador do locatário consumidor ativa os serviços de pagamento conforme o uso no Centro de administração do Microsoft 365. Em Configuração>Cobrança e licenças, selecione Ativar serviços pagos conforme o uso.

Centro de administração do Microsoft 365 Seção Cobrança e licenças com a opção Ativar serviços pagos conforme o uso.

Em Serviços Syntex para, selecione Aplicativos e, em seguida, selecione SharePoint Embedded para habilitar a cobrança para o aplicativo.

Centro de administração do Microsoft 365 Painel Aplicativos com o SharePoint Embedded selecionado para ativar a cobrança paga conforme o uso.

Configurar o aplicativo proprietário do Microsoft Entra ID

Configure o aplicativo para que ele possa ter exatamente um tipo de contêiner.

Solicite permissões do Microsoft Graph para acesso ao SharePoint Embedded.

Solicite permissão do aplicativo Microsoft Graph FileStorageContainerTypeReg.Selected para registro de tipo de contêiner em locatários de consumo.

Use URIs de redirecionamento que correspondam aos seus clientes de desenvolvimento e produção.

Use credenciais apropriadas para fluxos delegados ou somente aplicativos.

Para obter detalhes de autenticação, consulte Configurar autenticação e autorização.

Definir propriedades básicas

Propriedade Orientação
Nome do tipo de contêiner Use um nome durável que mapeie para sua carga de trabalho.
ID do aplicativo proprietário Use o registro de aplicativo que possui esse tipo.
URL de redirecionamento do aplicativo Use a URL para a qual os arquivos deste aplicativo devem redirecionar.
Modelo de cobrança Escolha avaliação, padrão ou passagem no momento da criação.

Cuidado

A ID do tipo de contêiner e a ID do aplicativo proprietário não podem ser atualizadas posteriormente.

Configurar o comportamento do tipo de contêiner

Os desenvolvedores podem configurar comportamentos selecionados após a criação.

As configurações disponíveis incluem:

  • ApplicationRedirectUrl
  • DiscoverabilityDisabled
  • SharingRestricted

Use a API fileStorageContainerType do Microsoft Graph Update para obter atualizações de tipo de contêiner com suporte. Para configurações administrativas de todo o locatário, consulte Criar aplicativos com o PowerShell.

Importante

A atualização de configurações em um tipo de contêiner pode levar até 24 horas para ser replicada para todos os locatários consumidores. Se uma configuração aplicada pelo locatário consumidor for substituída, essas substituições permanecerão em vigor. Algumas configurações se aplicam somente ao novo conteúdo, não ao conteúdo existente.

Exibir e atualizar tipos de contêiner

Use o Microsoft Graph para listar e atualizar tipos de contêiner.

Um proprietário de tipo de contêiner não administrador pode atualizar os tipos de contêiner que possui.

Você precisa de acesso de proprietário ou contribuidor às assinaturas de cobrança para alterações de cobrança.

Gerenciar tipos de contêiner com o Microsoft Graph

Você também pode gerenciar tipos de contêiner com as APIs do fileStorageContainerType Microsoft Graph.

Operação API
Criar um tipo de contêiner Create fileStorageContainerType
Listar tipos de contêiner List fileStorageContainerType
Atualizar um tipo de contêiner Atualizar fileStorageContainerType
Excluir um tipo de contêiner Excluir fileStorageContainerType

Os resultados da lista são filtrados por propriedade. Os usuários não administradores veem apenas os tipos de contêiner para os quais receberam permissão, enquanto os Administradores Embedded e Administradores Globais do SharePoint veem todos os tipos de contêiner no locatário. Para obter as configurações que você pode definir, consulte fileStorageContainerTypeSettings.

Você só pode excluir tipos de contêiner de avaliação; Ainda não há suporte para a exclusão de tipos de contêiner padrão. Antes de excluir um tipo de contêiner, remova todos os contêineres desse tipo, incluindo os contêineres na coleção de contêineres excluídos.

Entender a dependência de cobrança

Para cobrança de proprietário do aplicativo, o locatário desenvolvedor anexa uma assinatura do Azure e um grupo de recursos.

Para a cobrança de passagem, o locatário consumidor ativa os serviços de pagamento conforme o uso.

Para obter detalhes, consulte Medidores incorporados do SharePoint e Gerenciamento de cobrança do SharePoint Embedded.

Um aplicativo multilocatário geralmente tem um locatário proprietário e um ou mais locatários consumidores.

Use esta sequência para cada locatário consumidor:

  1. Crie o tipo de contêiner no locatário proprietário.
  2. Peça ao administrador do locatário consumidor para conceder o consentimento do administrador.
  3. Registre permissões de aplicativo de tipo de contêiner.
  4. Configure a cobrança de repasse quando o locatário consumidor pagar.
  5. Validar a criação e o acesso ao contêiner.

Próximas etapas

Registrar permissões em Registrar permissões de aplicativo.

  • Last updated on