Tipos de contentor do SharePoint Embedded

Um tipo de contentor é um recurso do SharePoint Embedded que define a relação, os privilégios de acesso e a responsabilidade de faturação entre uma aplicação Do SharePoint Embedded e um conjunto de contentores. Além disso, o tipo de contentor define comportamentos no conjunto de contentores.

Cada tipo de contentor é fortemente associado a uma aplicação Do SharePoint Embedded, que é referida como a aplicação proprietária. O programador da aplicação proprietária é responsável pela criação e gestão dos respetivos tipos de contentor. O SharePoint Embedded determina uma relação 1:1 entre a aplicação proprietária e um tipo de contentor.

Um tipo de contentor é representado em cada instância de contentor como uma propriedade imutável (ContainerTypeID) e é utilizado em todo o ecossistema do SharePoint Embedded, incluindo:

• Autorização de acesso: uma aplicação Do SharePoint Embedded tem de estar associada a um tipo de contentor para obter acesso a instâncias de contentor desse tipo. Uma vez associada, a aplicação tem acesso a todas as instâncias de contentor desse tipo. O privilégio de acesso real é determinado pela definição de permissão application-ContainerTypeID. Por predefinição, a aplicação proprietária tem privilégios de acesso total a todas as instâncias de contentor do tipo de contentor com o qual está fortemente associada. Saiba mais sobre a Autorização do SharePoint Embedded.
• Exploração fácil: os tipos de contentor podem ser criados para fins de avaliação, permitindo que os programadores explorem o desenvolvimento de aplicações do SharePoint Embedded e avaliem as respetivas funcionalidades gratuitamente.
• Faturação: os tipos de contentor para fins não experimentais são faturáveis e têm de ser criados com uma Subscrição Azure. A utilização de contentores é limitada e cobrada. Saiba mais sobre a medição e a experiência de faturação do SharePoint Embedded.
• Comportamentos configuráveis: o tipo de contentor define os comportamentos selecionados para todas as instâncias de contentor desse tipo. Saiba mais sobre como definir a configuração do Tipo de contentor.

Observação

1. Tem de especificar a finalidade do tipo de contentor que está a criar no momento da criação. Não é possível converter um conjunto de tipos de contentor para fins de avaliação para produção; ou vice-versa.
2. Standard e os tipos de contentores pass-through não podem ser convertidos uma vez criados. Se quiser converter um tipo de contentor padrão para faturação pass-through ou vice-versa, tem de eliminar e recriar o tipo de contentor.

Requisitos de locatário

• É necessária uma instância ativa do SharePoint no seu inquilino do Microsoft 365.
• Os utilizadores que se autenticam em contentores e tipos de contentores do SharePoint Embedded têm de estar no Microsoft Entra ID (Membros e Convidados)
• Um Microsoft Entra ID registo de aplicações tem de ser configurado para a gestão do tipo de contentor. Para obter mais informações, veja Autorização e autenticação do SharePoint Embedded.

Observação

Não é necessária uma licença do Office para colaborar em documentos do Microsoft Office armazenados num contentor.

Criar tipos de contentor

O SharePoint Embedded tem dois tipos de contentor diferentes que pode criar.

1. Tipo de contentor de avaliação. Utiliza a trial classificação de faturação.
2. Standard tipo de contentor. Utiliza a standard classificação de faturação ou directToCustomer .

Para criar um tipo de contentor, o Microsoft Entra ID aplicação tem de ter a permissão de aplicação FileStorageContainerType.Manage.All no inquilino proprietário. A aplicação Microsoft Entra ID tem de chamar o ponto final Create fileStorageContainerType em nome de um Administrador do SharePoint Embedded:

POST https://graph.microsoft.com/beta/storage/fileStorage/containerTypes
Content-Type: application/json

{
  "name": "{ContainerTypeName}",
  "owningAppId": "{ApplicationId}",
  "billingClassification": "{BillingClassification}",
  "settings": {
    ...
  }
}

Observação

Tem de substituir:

• {ContainerTypeName} com um nome amigável para a sua aplicação SharePoint Embedded.
• {ApplicationId} com o ID do ID da aplicação configurado corretamente.
• {BillingClassification} trialcom , standardou directToCustomer. Continue a ler para compreender o que cada um significa.

Além disso, pode configurar o tipo de contentor durante a criação com o settings campo .

Tipo de contentor de avaliação

Um tipo de contentor pode ser criado para fins de avaliação/desenvolvimento e não está ligado a nenhum perfil de faturação Azure. Os tipos de contentores de avaliação permitem que os programadores explorem o desenvolvimento de aplicações do SharePoint Embedded e avaliem as respetivas funcionalidades gratuitamente. Para tipos de contentores de avaliação, o inquilino do programador é o mesmo que o inquilino que está a consumir. Cada programador só pode ter um tipo de contentor com trial classificação de faturação no respetivo inquilino de cada vez. O tipo de contentor de avaliação é válido até 30 dias, mas pode ser removido em qualquer altura dentro deste período.

Pode configurar facilmente um tipo de contentor de avaliação com a extensão de Visual Studio Code do SharePoint Embedded.

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.

Standard tipos de contentor (não repetidos)

Um tipo de contentor padrão pode ser utilizado em ambientes de produção. Cada inquilino pode ter 25 tipos de contentor de cada vez. Standard tipos de contentor não têm as mesmas restrições que os tipos de contentores de avaliação, mas continuam a ter limites. Para obter mais informações, veja Limites do SharePoint Embedded.

Para saber mais sobre os medidores pay as you go suportados, veja o artigo Medidores do SharePoint Embedded .

Perfil de faturação

O SharePoint Embedded é uma oferta pay as you go (PAYG) baseada no consumo, que significa que paga apenas pelo que utiliza. O SharePoint Embedded fornece dois modelos de faturação que o inquilino que desenvolve a aplicação SharePoint Embedded pode selecionar para os respetivos tipos de contentor, adaptando-o aos seus requisitos empresariais exclusivos. Os dois modelos de faturação são Standard e faturação Passthrough.

Standard tipo de contentor - com perfil de faturação

Com o perfil de faturação padrão, todos os custos baseados no consumo são faturados diretamente ao inquilino que detém ou desenvolve a aplicação. O administrador no inquilino do programador tem de estabelecer um perfil de faturação válido ao criar um tipo de contentor padrão.

Existem limites em torno do número de tipos de contentor que cada inquilino pode ter. Para obter mais informações, veja Limites do SharePoint Embedded.

Funções e Permissões

• O administrador que configura a relação de faturação do SharePoint Embedded tem de ter permissões de proprietário ou contribuidor na subscrição Azure.
• O administrador tem de ter uma função de Administrador Incorporado do SharePoint ou Administrador Global para operar cmdlets de faturação.

Assinatura do Azure

Para o tipo de contentor de faturação padrão, o Administrador Global tem de:

• Criar uma subscrição de Azure no seu inquilino
• Criar um grupo de recursos anexado à subscrição do Azure

Depois de criar o tipo de contentor com standard a classificação de faturação, tem de anexar um perfil de faturação ao tipo de contentor.

Definir o perfil de faturação

O perfil de faturação do seu tipo de contentor é criado com Shell de Gerenciamento do SharePoint Online:

1. Transferir e instalar a versão mais recente do Shell de Gerenciamento do SharePoint Online
2. Abra Shell de Gerenciamento do SharePoint Online a partir do ecrã Início, escreva sharepoint e, em seguida, selecione Shell de Gerenciamento do SharePoint Online.
3. Ligue-se ao serviço SPO através Connect-SPOService do cmdlet ao fornecer credenciais de administrador associadas ao inquilino. Para obter informações, veja como utilizar o Connect-SPOService. . Para criar o perfil de faturação padrão para o seu tipo de contentor, utilize o seguinte cmdlet:

Add-SPOContainerTypeBilling –ContainerTypeId <ContainerTypeId> -AzureSubscriptionId <AzureSubscriptionId> -ResourceGroup <ResourceGroup> -Region <Region>

Observação

O administrador que configura uma relação de faturação para o SharePoint Embedded tem de ter permissões de proprietário ou contribuidor na subscrição do Azure e ser-lhe atribuída a função Administrador Incorporado do SharePoint ou Administrador Global.

Cada tipo de contentor tem de ter uma aplicação proprietária.

Uma aplicação proprietária única só pode possuir um tipo de contentor de cada vez.

Uma subscrição Azure pode ser anexada a qualquer número de tipos de contentor.

Se o cmdlet acima falhar com um erro SubscriptionNotRegistered, deve-se ao facto de o Microsoft.Syntex não estar registado como fornecedor de recursos na subscrição. O cmdlet envia um pedido de registo do fornecedor de recursos em seu nome, mas demora alguns minutos a ser concluído. Aguarde 5 a 10 minutos e tente novamente até o cmdlet ser bem-sucedido.

Para atualizar o perfil de faturação de um tipo de contentor padrão, utilize o seguinte cmdlet:

Set-SPOContainerType -ContainerTypeId <ContainerTypeId> [-AzureSubscriptionId <AzureSubscriptionId>] [-ResourceGroup <ResourceGroup>]

Observação

A configuração de faturação para tipos de contentor padrão é efetuada através do Shell de Gerenciamento do SharePoint Online. No futuro, esta operação estará disponível como uma operação do Microsoft Graph.

Standard tipo de contentor – faturação pass-through

Com a faturação pass-through, os custos baseados no consumo são faturados diretamente no inquilino registado para utilizar a aplicação SharePoint Embedded (inquilino de consumo). Os administradores no inquilino do programador não precisam de configurar um perfil de faturação Azure ao criar um tipo de contentor do SharePoint Embedded pass-through.

Para os tipos de contentor que se destinam a ser faturados diretamente a um cliente, utilize a directToCustomer classificação de faturação durante a criação do tipo de contentor. Para os tipos de contentor de faturação pass-through, não é necessário anexar um perfil de faturação.

Assim que o tipo de contentor for registado no inquilino que está a consumir, o administrador de inquilinos que está a consumir (Administrador do SharePoint ou Administrador Global) tem de configurar o perfil de faturação no inquilino que está a consumir para utilizar a aplicação SharePoint Embedded.

Configurar o perfil de faturação no inquilino de consumo

1. No Centro de administração do Microsoft 365, selecione Configuração e veja a secção Faturação e licenças. Selecione Ativar serviços pay as you go.

   

2. Selecione Ir para Os serviços Pay as you go.

3. Selecione Aplicações em Serviços Syntex para e, em seguida, selecione SharePoint Embedded no painel Aplicações

   

   Observação

   A subscrição configurada nos serviços Syntex refletirá os custos de consumo no portal de faturação do Azure.

Configurar tipos de contentor

O Administração do Programador pode aplicar a configuração ao chamar o ponto final Create fileStorageContainerType. Em alternativa, podem chamar o ponto final Update fileStorageContainerType para reconfigurar um tipo de contentor existente.

Importante

A atualização das definições num tipo de contentor pode demorar até 24 horas para que os novos valores sejam replicados em todos os inquilinos que consomem. Se um inquilino consumidor aplicar substituições nas definições do tipo de contentor, os novos valores não são aplicados e as substituições permanecem em vigor. Algumas definições aplicam-se apenas a novos conteúdos e não a conteúdos existentes para o tipo de contentor (por exemplo, tamanho de armazenamento, capacidade de deteção ativada, entre outras).

Para obter informações sobre todas as definições suportadas por tipos de contentor, veja fileStorageContainerTypeSettings resource type (Tipo de recurso fileStorageContainerTypeSettings).

Ver tipos de contentor

O Administração de Programador pode ver todos os tipos de contentor do SharePoint Embedded que criaram no inquilino com o ponto final List fileStorageContainerType.

Registar tipos de contentor

Para criar e interagir com contentores, tem de registar o tipo de contentor no Inquilino de Consumo. A aplicação proprietária define as permissões para o tipo de contentor ao invocar o ponto final Create fileStorageContainerTypeRegistration .

Eliminar tipos de contentor

O Administração de Programador só pode eliminar tipos de contentores de avaliação no respetivo inquilino. A eliminação de tipos de contentor padrão ainda não é suportada. Para eliminar um tipo de contentor, primeiro tem de remover todos os contentores desse tipo de contentor, incluindo da coleção de contentores eliminados. Para remover contentores, veja Consumir Administração de Inquilinos. Assim que todos os contentores forem eliminados, os administradores do programador podem eliminar o tipo de contentor com o ponto final Delete fileStorageContainerType.