Criar e configurar um tipo de contentor

Aplica-se a: Programador

Crie um tipo de contentor do SharePoint Embedded para a sua aplicação criar contentores ou armazenar ficheiros. Um tipo de contentor define o acesso, a responsabilidade de faturação e os comportamentos selecionados para contentores criados pela sua aplicação.

Se estiver apenas a começar, conclua o Início Rápido: Criar a sua primeira aplicação com o VS Code. Em seguida, utilize este artigo para decisões de avaliação, padrão e pass-through.

Para decidir primeiro entre modelos de inquilino único e multi-inquilino, veja Escolher um modelo de aplicação.

Compreender a relação do tipo de contentor

Um tipo de contentor é fortemente associado a uma aplicação Microsoft Entra ID, denominada aplicação proprietária.

O SharePoint Embedded requer uma relação um-para-um entre uma aplicação proprietária e um tipo de contentor.

O ID do tipo de contentor é armazenado em cada contentor como uma propriedade imutável.

O ID é utilizado para autorização de acesso, exploração de avaliação, faturação e comportamentos configuráveis.

Observação

O microsoft API do Graph — Criar fileStorageContainerType — é delegado apenas e pode ser chamado por qualquer utilizador que não seja proprietário de um inquilino convidado. O autor da chamada não precisa de uma função de administrador e é automaticamente atribuído como proprietário do novo tipo de contentor.

Escolher avaliação ou produção

Escolha a finalidade do tipo de contentor ao criá-la.

Não pode converter um tipo de contentor de avaliação para produção mais tarde.

Não pode converter um tipo de faturação padrão para faturação pass-through mais tarde.

Caso de uso	Tipo de contentor
Prova de conceito local	Tipo de contentor de avaliação
Pagamentos do proprietário da aplicação	Standard tipo de contentor com perfil de faturação
Pagamentos do inquilino do cliente	Standard tipo de contentor com faturação pass-through

Importante

Se escolher o objetivo errado ou o modelo de faturação, tem de recriar o tipo de contentor.

Pré-requisitos

Antes de criar um tipo de contentor, certifique-se de que tem:

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

Observação

• A criação de um tipo de contentor através do Microsoft Graph requer apenas a FileStorageContainerType.Manage.All permissão delegada. Qualquer utilizador não convidado no inquilino proprietário pode criar um e é automaticamente atribuído como proprietário desse tipo de contentor. Para operações administrativas ao nível do inquilino, veja Criar aplicações com o PowerShell.

• Os utilizadores que se autenticam em contentores têm de existir no Microsoft Entra ID como membros ou convidados. Não é necessária uma licença do Office para colaborar em documentos do Office armazenados num contentor, exceto em experiências excecionais documentadas, como menções.

Criar um tipo de contentor de avaliação

Utilize um tipo de contentor de avaliação para avaliação.

Pode criar uma com a extensão de Visual Studio Code do SharePoint Embedded ou o Microsoft Graph.

O caminho Visual Studio Code é mais rápido para uma primeira aplicação. Veja Início Rápido: Criar a sua primeira aplicação com o VS Code.

Para o Microsoft Graph, crie o tipo de contentor com a trial classificação de faturação.

As seguintes restrições são aplicadas aos tipos de contentores de avaliação:

• O inquilino pode ter até cinco contentores do tipo de contentor. Isto inclui contentores ativos e contentores na reciclagem.
• Cada contentor tem até 1 GB de espaço de armazenamento.
• O tipo de contentor expira após 30 dias e o acesso a quaisquer contentores existentes desse tipo de contentor é removido.
• O programador tem de eliminar permanentemente todos os contentores de um tipo de contentor existente na versão de avaliação status para criar um novo tipo de contentor para avaliação. Isto inclui contentores na coleção de contentores eliminados.
• O tipo de contentor está restrito para funcionar no inquilino do programador. Não pode ser implementado noutros inquilinos que consumam.

Criar um tipo de contentor padrão com a faturação do proprietário da aplicação

Utilize a faturação padrão quando o inquilino do programador ou do proprietário da aplicação pagar pelo consumo.

Cada inquilino pode ter até 25 tipos de contentor padrão de cada vez.

1. Crie ou identifique a aplicação proprietária Microsoft Entra ID.
2. Crie o tipo de contentor com a standard classificação de faturação.
3. Anexe um perfil de faturação Azure com a extensão de Visual Studio Code do SharePoint Embedded ou um fluxo de faturação gerido pelo administrador.
4. Registe o ID do tipo de contentor.
5. Continue a registar no inquilino que está a consumir.

Observação

Se a configuração da faturação falhar com SubscriptionNotRegistered, aguarde vários minutos e repita. O Microsoft.Syntex registo do fornecedor de recursos pode demorar algum tempo.

Criar um tipo de contentor de faturação pass-through

Utilize a faturação pass-through quando o inquilino consumidor pagar pelo consumo.

1. Crie ou identifique a aplicação proprietária Microsoft Entra ID.
2. Crie o tipo de contentor com a directToCustomer classificação de faturação.
3. Registe o tipo de contentor no inquilino que está a consumir.
4. Peça ao administrador de inquilinos que está a consumir para ativar os serviços pay as you go.

Importante

O inquilino que consome tem de concluir a configuração da faturação para que uma aplicação pass-through possa ser utilizada com êxito.

O administrador de inquilinos que consome ativa os serviços pay as you go no Centro de administração do Microsoft 365. Em Configurar>Faturação e licenças, selecione Ativar serviços pay as you go.

Em Serviços Syntex para, selecione Aplicações e, em seguida, selecione SharePoint Embedded para ativar a faturação da aplicação.

Configurar a aplicação proprietária Entra

Configure a aplicação para que possa ter exatamente um tipo de contentor.

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

Pedir permissão de aplicação do Microsoft Graph FileStorageContainerTypeReg.Selected para o registo do tipo de contentor no consumo de inquilinos.

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

Utilize as credenciais adequadas para fluxos delegados ou apenas de aplicações.

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

Definir propriedades básicas

Propriedade	Orientação
Nome do tipo de contentor	Utilize um nome durável que mapeie para a sua carga de trabalho.
ID da aplicação proprietária	Utilize o registo de aplicações que detém este tipo.
URL de redirecionamento de aplicação	Utilize o URL onde os ficheiros desta aplicação devem ser redirecionados.
Modelo de faturação	Selecione avaliação, padrão ou pass-through no momento da criação.

Cuidado

O ID do tipo de contentor e o ID da aplicação proprietária não podem ser atualizados mais tarde.

Configurar o comportamento do tipo de contentor

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

As definições disponíveis incluem:

• ApplicationRedirectUrl
• DiscoverabilityDisabled
• SharingRestricted

Utilize a API Microsoft Graph Update fileStorageContainerType para atualizações de tipo de contentor suportadas. Para definições administrativas ao nível do inquilino, veja Criar aplicações com o PowerShell.

Importante

A atualização das definições num tipo de contentor pode demorar até 24 horas a ser replicada para todos os inquilinos que consomem. Se uma definição aplicada de inquilino consumidor substituir, essas substituições permanecerão no local. Algumas definições aplicam-se apenas a novos conteúdos e não a conteúdos existentes.

Ver e atualizar tipos de contentor

Utilize o Microsoft Graph para listar e atualizar tipos de contentor.

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

Precisa de acesso de proprietário ou contribuidor a subscrições de faturação para alterações de faturação.

Gerir tipos de contentor com o Microsoft Graph

Também pode gerir tipos de contentor com as APIs do fileStorageContainerType Microsoft Graph.

Operação	API
Criar um tipo de contentor	Criar fileStorageContainerType
Listar tipos de contentor	Ficheiro de listaStorageContainerType
Atualizar um tipo de contentor	Atualizar fileStorageContainerType
Eliminar um tipo de contentor	Eliminar fileStorageContainerType

Os resultados da lista são filtrados pela propriedade. Os utilizadores não administradores veem apenas os tipos de contentor em que lhes foi concedida permissão, enquanto os Administradores Incorporados do SharePoint e os Administradores Globais veem todos os tipos de contentor no inquilino. Para obter as definições que pode configurar, consulte fileStorageContainerTypeSettings.

Só pode eliminar tipos de contentores de avaliação; A eliminação de tipos de contentor padrão ainda não é suportada. Antes de eliminar um tipo de contentor, remova todos os contentores desse tipo, incluindo contentores na coleção de contentores eliminados.

Compreender a dependência de faturação

Para a faturação do proprietário da aplicação, o inquilino do programador anexa uma subscrição Azure e um grupo de recursos.

Para a faturação pass-through, o inquilino que consome ativa os serviços pay as you go.

Para obter detalhes, veja SharePoint Embedded meters and SharePoint Embedded billing management (Medidores do SharePoint Embedded e gestão de faturação do SharePoint Embedded).

Ligar à integração multi-inquilino

Normalmente, uma aplicação multi-inquilino tem um inquilino proprietário e um ou mais inquilinos que consomem.

Utilize esta sequência para cada inquilino que consome:

1. Crie o tipo de contentor no inquilino proprietário.
2. Peça ao administrador inquilino que está a consumir para conceder o consentimento do administrador.
3. Registar permissões de aplicação do tipo de contentor.
4. Configure a faturação pass-through quando o inquilino consumidor pagar.
5. Valide a criação e o acesso do contentor.

Próximas etapas

Registe permissões em Registar permissões de aplicação.