Compreender os tipos de contentor e os contentores

Aplica-se a: Programador

Utilize este artigo para compreender os dois objetos de armazenamento principais no SharePoint Embedded: tipos de contentor e contentores.

Para obter a referência de criação e gestão completa, veja Tipos de contentores do SharePoint Embedded.

Modelo de objetos

O SharePoint Embedded armazena ficheiros e documentos em contentores, que são agrupados por tipo de contentor. Crie um tipo de contentor antes de poder criar contentores para uma aplicação.

Objeto O que representa Quem o gere normalmente
Tipo de contentor Relação entre uma aplicação e um conjunto de contentores, incluindo acesso, comportamento e responsabilidade de faturação. Proprietário do tipo de contentor ou programador.
Contêiner O limite de armazenamento e segurança para ficheiros e pastas. Aplicação através do Microsoft Graph e administradores para operações de governação.

Conceito do tipo de contentor

Um tipo de contentor é um recurso do SharePoint Embedded. Define:

  • A aplicação proprietária.
  • Os privilégios de acesso entre aplicações e contentores.
  • O modelo de responsabilidade de faturação.
  • Comportamentos selecionados que se aplicam a contentores desse tipo.

Cada tipo de contentor é fortemente associado a uma aplicação Do SharePoint Embedded, denominada aplicação proprietária. O SharePoint Embedded requer uma relação 1:1 entre a aplicação proprietária e o tipo de contentor. O programador da aplicação proprietária é responsável por criar e gerir o tipo de contentor.

Identidade do tipo de contentor

O tipo de contentor é representado em cada contentor como uma propriedade imutável chamada ContainerTypeID. A propriedade é utilizada no ecossistema do SharePoint Embedded. Afeta:

  • Autorização de acesso.
  • Exploração experimental.
  • A faturação.
  • Comportamento configurável.

Importante

Planeie cuidadosamente o tipo de contentor. Algumas opções de criação, como a versão de avaliação versus a produção e a faturação padrão versus pass-through, não podem ser convertidas após a criação. Para mudar, tem de eliminar e recriar o tipo de contentor.

Contêineres

Um contentor é a unidade de armazenamento básica no SharePoint Embedded e define um limite de segurança e conformidade. As aplicações criam contentores no consumo de inquilinos com o Microsoft Graph.

Files, pastas, metadados, versões e conteúdo da reciclagem são armazenados nos contentores e estão sujeitos aos limites atuais do SharePoint Embedded.

Para obter limites, veja Compreender os limites e padrões de chamada.

Propriedade

A propriedade do tipo de contentor e a residência do contentor são diferentes. O inquilino proprietário cria o tipo de contentor. O inquilino que consome utiliza o tipo de contentor e aloja contentores.

Todo o conteúdo de contentor criado através da aplicação é armazenado dentro do limite de inquilino do Microsoft 365 do inquilino que está a consumir.

Para a arquitetura de inquilinos, veja Compreender a arquitetura de aplicações e inquilinos.

Autorização de acesso

Uma aplicação Do SharePoint Embedded tem de estar associada a um tipo de contentor para aceder a contentores desse tipo. Após a associação, a aplicação tem acesso a contentores desse tipo de acordo com as permissões de tipo application-container. Por predefinição, a aplicação proprietária tem privilégios de acesso total aos contentores do tipo de contentor com o qual está associada. O acesso real também depende se a aplicação utiliza o acesso delegado ou o acesso apenas à aplicação.

Para planear a permissão, veja Planear a autenticação e as permissões.

Tipos de contentores de avaliação

Utilize um tipo de contentor de avaliação para explorar o desenvolvimento do SharePoint Embedded sem associar um perfil de faturação Azure.

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 de avaliação no respetivo inquilino de cada vez.
  • A avaliação é válida até 30 dias.
  • Podem ser criados até cinco contentores do tipo de contentor, incluindo contentores ativos e contentores na reciclagem.
  • Cada contentor tem até 1 GB de armazenamento.
  • O tipo de contentor está restrito ao inquilino do programador.

Não é possível converter um tipo de contentor de avaliação para produção.

Para criar um tipo de contentor de avaliação, os programadores podem utilizar a extensão de Visual Studio Code do SharePoint Embedded ou a API do tipo de contentor do Microsoft Graph.

Os tipos de contentor são criados com o ponto final do Microsoft Graph POST /v1.0/storage/fileStorage/containerTypes através da trial classificação de faturação. Esta chamada requer a FileStorageContainerType.Manage.All permissão delegada; o acesso apenas à aplicação não é suportado. O utilizador que chama tem de ser um membro não convidado do inquilino proprietário (não é necessária qualquer função de administrador) e é automaticamente atribuído como proprietário do novo tipo de contentor.

Standard tipos de contentor

É utilizado um tipo de contentor padrão para cenários que não são de avaliação.

Cada inquilino pode ter 25 tipos de contentor de cada vez.

Standard tipos de contentor são faturáveis e têm de utilizar um modelo de faturação.

O SharePoint Embedded suporta:

  • Standard faturação (standardclassificação de faturação).
  • Faturação pass-through (directToCustomer classificação de faturação).

Para seleção de faturação, veja Escolher um modelo de faturação.

Standard tipo de contentor de faturação

Com a faturação padrão, os custos baseados no consumo são faturados ao inquilino que detém ou desenvolve a aplicação.

O inquilino proprietário anexa um perfil de faturação depois de criar o tipo de contentor padrão.

Crie o tipo de contentor com o ponto final do Microsoft Graph POST /v1.0/storage/fileStorage/containerTypes com a standard classificação de faturação e, em seguida, anexe um perfil de faturação Azure:

POST https://graph.microsoft.com/v1.0/storage/fileStorage/containerTypes

{
  "name": "{ContainerTypeName}",
  "owningAppId": "{OwningApplicationId}",
  "billingClassification": "standard"
}

Tipo de contentor de faturação pass-through

Com a faturação pass-through, os custos são faturados diretamente no inquilino que consome.

O programador cria o tipo de contentor com a directToCustomer classificação de faturação e não anexa um perfil de faturação no inquilino do programador.

{
  "name": "{ContainerTypeName}",
  "owningAppId": "{OwningApplicationId}",
  "billingClassification": "directToCustomer"
}

Após o registo, um Administrador Global no inquilino que está a consumir configura a faturação no inquilino que consome.

interação Administração e programador

Os programadores e administradores interagem com diferentes camadas.

Atividade Tipo de contentor Contêiner
Criar a família de armazenamento da aplicação Sim Não
Configurar a relação de propriedade da aplicação Sim Não
Configurar a responsabilidade de faturação Sim Não
Criar instâncias de armazenamento de aplicações Não Sim
Armazenar ficheiros e pastas Não Sim
Aplicar governação específica do contentor Não Sim
Eliminar a família de armazenamento Sim, depois de os contentores serem removidos Não

Configuração do tipo de contentor

Os programadores podem configurar as definições de tipo de contentor selecionadas após a criação.

Pode configurar estas definições de tipo de contentor:

  • ApplicationRedirectUrl
  • DiscoverabilityDisabled
  • SharingRestricted

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

Registro

Para criar e interagir com contentores num inquilino consumidor, o tipo de contentor tem de estar registado nesse inquilino.

A aplicação proprietária invoca a API de registo para definir permissões de aplicação para o tipo de contentor.

Para obter detalhes completos, veja Registar permissões de aplicações do tipo de contentor de armazenamento de ficheiros.

Lista de verificação de planejamento

  • Selecione a versão de avaliação ou padrão.
  • Escolha a faturação padrão ou a faturação pass-through para produção.
  • Identifique a aplicação proprietária.
  • Confirme o nome do tipo de contentor.
  • Confirme o inquilino ou inquilinos que consomem.
  • Planear o registo do tipo de contentor.
  • Planear permissões de aplicação.
  • Planeie as definições de tipo de contentor necessárias.
  • Planear o ciclo de vida e a eliminação do contentor.

Próximas etapas

Planear a autenticação e autorização: planeie a autenticação e as permissões.

  • Last updated on