Entender tipos e contêineres de contêiner

Aplica-se a: Desenvolvedor

Use este artigo para entender os dois principais objetos de armazenamento no SharePoint Embedded: tipos de contêiner e contêineres.

Para obter a referência completa de criação e gerenciamento, consulte Tipos de contêiner do SharePoint Embedded.

Modelo de objetos

O SharePoint Embedded armazena arquivos e documentos em contêineres, que são agrupados por tipo de contêiner. Você cria um tipo de contêiner antes de poder criar qualquer contêiner para um aplicativo.

Conceito de tipo de contêiner

Um tipo de contêiner é um recurso do SharePoint Embedded. Ele define:

• O aplicativo proprietário.
• Os privilégios de acesso entre aplicativos e contêineres.
• O modelo de responsabilidade de cobrança.
• Comportamentos selecionados que se aplicam a contêineres desse tipo.

Cada tipo de contêiner é fortemente acoplado a um aplicativo do SharePoint Embedded, chamado de aplicativo proprietário. O SharePoint Embedded requer uma relação de 1:1 entre o aplicativo proprietário e o tipo de contêiner. O desenvolvedor do aplicativo proprietário é responsável por criar e gerenciar o tipo de contêiner.

Identidade do tipo de contêiner

O tipo de contêiner é representado em cada contêiner como uma propriedade imutável chamada ContainerTypeID. A propriedade é usada em todo o ecossistema do SharePoint Embedded. Isso afeta:

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

Contêineres

Um contêiner é a unidade de armazenamento básica no SharePoint Embedded e define um limite de segurança e conformidade. Os aplicativos criam contêineres em locatários de consumo usando o Microsoft Graph. A criação de contêineres requer um aplicativo cliente confidencial, portanto, planeje um componente que contenha um segredo ou certificado do cliente. Para obter mais informações, consulte Autenticação e permissões de plano.

Files, pastas, metadados, versões e conteúdo da lixeira são armazenados em contêineres e estão sujeitos aos limites atuais do SharePoint Embedded.

Para limites, consulte Entender limites e padrões de chamada.

Propriedade

A propriedade do tipo de contêiner e a residência do contêiner são diferentes. O locatário desenvolvedor cria o tipo de contêiner. O locatário consumidor usa o tipo de contêiner e hospeda contêineres.

Todo o conteúdo do contêiner criado por meio do aplicativo é armazenado dentro do limite de locatário do Microsoft 365 do locatário consumidor.

Para arquitetura de locatário, consulte Entender a arquitetura de aplicativo e locatário.

Autorização de acesso

Um aplicativo incorporado do SharePoint deve ser associado a um tipo de contêiner para acessar contêineres desse tipo. Após a associação, o aplicativo tem acesso a contêineres desse tipo de acordo com as permissões do tipo de contêiner de aplicativo. O aplicativo proprietário tem privilégio de acesso total por padrão para contêineres do tipo de contêiner ao qual está acoplado. O acesso real também depende se o aplicativo usa o acesso delegado ou somente o acesso ao aplicativo.

Para planejamento de permissões, consulte Planejar autenticação e permissões.

Tipos de contêiner de avaliação

Use um tipo de contêiner de avaliação para explorar o desenvolvimento do SharePoint Embedded sem vincular um perfil de cobrança do Azure.

Para tipos de contêiner de avaliação:

• O locatário do desenvolvedor é o mesmo que o locatário consumidor.
• Cada desenvolvedor pode ter apenas um tipo de contêiner de avaliação em seu locatário por vez.
• O teste é válido por até 30 dias.
• Até cinco contêineres do tipo contêiner podem ser criados, incluindo contêineres ativos e contêineres na lixeira.
• Cada contêiner tem até 1 GB de armazenamento.
• O tipo de contêiner é restrito ao locatário do desenvolvedor.

Um tipo de contêiner de teste não pode ser convertido em produção.

Para criar um tipo de contêiner de avaliação, os desenvolvedores podem usar a extensão do Visual Studio Code Embedded do SharePoint ou a API de tipo de contêiner do Microsoft Graph.

Os tipos de contêiner são criados com o ponto de extremidade do Microsoft Graph POST /v1.0/storage/fileStorage/containerTypes , usando a trial classificação de cobrança. Essa chamada requer a permissão delegada. Não há suporte para o acesso somente ao FileStorageContainerType.Manage.All aplicativo. O usuário de chamada deve ser um membro não convidado do locatário desenvolvedor (nenhuma função de administrador é necessária) e é atribuído automaticamente como proprietário do novo tipo de contêiner.

Tipos de contêiner Standard

Um tipo de contêiner padrão é usado para cenários sem avaliação.

Por padrão, cada locatário pode ter 25 tipos de contêiner por vez; Um pode ser um tipo de contêiner de teste gratuito e o restante são tipos de contêiner padrão. Você pode solicitar um aumento por meio do suporte da Microsoft ou do seu contato de integração do SharePoint Embedded.

Os tipos de contêiner Standard são faturáveis e devem usar um modelo de cobrança.

O SharePoint Embedded dá suporte a:

• Cobrança Standard (standardclassificação de cobrança).
• Cobrança de passagem (directToCustomer classificação de cobrança).

Para a seleção de cobrança, consulte Escolher um modelo de cobrança.

Tipo de contêiner de cobrança Standard

Com a cobrança padrão, as cobranças baseadas em consumo são cobradas do locatário que possui ou desenvolve o aplicativo.

O locatário desenvolvedor anexa um perfil de cobrança depois de criar o tipo de contêiner padrão.

Crie o tipo de contêiner com o ponto de extremidade do Microsoft Graph POST /v1.0/storage/fileStorage/containerTypes usando a classificação de standard cobrança e anexe um perfil de cobrança do Azure:

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

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

Tipo de contêiner de cobrança de passagem

Com a cobrança de passagem, os encargos são cobrados diretamente do locatário consumidor.

O desenvolvedor cria o tipo de contêiner com a directToCustomer classificação de cobrança e não anexa um perfil de cobrança no locatário do desenvolvedor.

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

Após o registro, um Administrador Global no locatário consumidor configura a cobrança no locatário consumidor.

Administração e desenvolvedor

Desenvolvedores e administradores interagem com diferentes camadas.

Configuração de tipo de contêiner

Os desenvolvedores podem definir as configurações de tipo de contêiner selecionadas após a criação.

Você pode definir estas configurações de tipo de contêiner:

• 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, consulte Criar aplicativos com o PowerShell.

Registro

Para criar e interagir com contêineres em um locatário consumidor, o tipo de contêiner deve ser registrado nesse locatário.

O aplicativo proprietário invoca a API de registro para definir permissões de aplicativo para o tipo de contêiner.

Para obter detalhes completos, consulte Registrar permissões de aplicativo do tipo de contêiner de armazenamento de arquivos.

Lista de verificação de planejamento

• Escolha avaliação ou padrão.
• Escolha o faturamento padrão ou o faturamento de passagem para produção.
• Identifique o aplicativo proprietário.
• Confirme o nome do tipo de contêiner.
• Confirme o(s) locatário(s) consumidor(es).
• Planeje o registro do tipo de contêiner.
• Planejar permissões de aplicativo.
• Planeje quais configurações de tipo de contêiner são necessárias.
• Planeje o ciclo de vida e a exclusão do contêiner.

Próximas etapas

Autenticação e autorização de plano: Autenticação e permissões de plano.