Listar contêineres

Namespace: microsoft.graph

Obtenha uma lista de objetos fileStorageContainer acessíveis a um chamador. O parâmetro de filtro containerTypeId é necessário.

Importante

  • As solicitações feitas em nome de um usuário falharão se o usuário não tiver um OneDrive. Esse requisito não se aplica quando você chama o ponto de extremidade sem um contexto de usuário (autenticação somente de aplicativo). O ponto de extremidade também retorna apenas contêineres dos quais o usuário é membro direto. Os contêineres dos quais o usuário é membro por meio de um grupo não são retornados.
  • Atualmente, não há suporte para solicitações feitas sem um contexto de usuário (autenticação somente de aplicativo) para locatários multigeográficos.

Essa API está disponível nas seguintes implantações de nuvem nacional.

Serviço global Governo dos EUA L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante) FileStorageContainer.Selected FileStorageContainer.Manage.All
Delegado (conta pessoal da Microsoft) FileStorageContainer.Selected Indisponível.
Application FileStorageContainer.Selected Indisponível.

Além das permissões do Microsoft Graph, seu aplicativo também deve ter a permissão ou permissões de nível de tipo de contêiner necessárias para chamar essa API. Para obter detalhes sobre tipos de contêiner, consulte Tipos de contêiner. Para saber mais sobre permissões de nível de tipo de contêiner, consulte Autorização Incorporada do SharePoint.

Solicitação HTTP

GET /storage/fileStorage/containers?$filter=containerTypeId eq {containerTypeId}
GET /storage/fileStorage/containers?$filter=containerTypeId eq {containerTypeId} and viewpoint/effectiveRole eq 'principalOwner'

Parâmetros de consulta

Esse método requer o parâmetro containerTypeId . Ele dá suporte ao $expand parâmetro de consulta OData, exceto para as propriedades drive, permissions e customProperties . Se outras $filter condições forem usadas, o ponto de extremidade poderá retornar páginas intermediárias com resultados parciais ou até mesmo nenhum resultado, e o chamador deverá continuar a ler todas as páginas para obter todos os resultados aplicáveis. Para obter mais informações, consulte Parâmetros de consulta OData.

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se for bem-sucedido, esse método retornará um 200 OK código de resposta e uma coleção de objetos fileStorageContainer no corpo da resposta. Apenas um subconjunto limitado de propriedades é retornado para cada fileStorageContainer.

Exemplos

Solicitação

O exemplo a seguir enumera todos os contêineres de um determinado tipo de contêiner.

GET https://graph.microsoft.com/v1.0/storage/fileStorage/containers?$filter=containerTypeId eq e2756c4d-fa33-4452-9c36-2325686e1082

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/v1.0/storage/fileStorage/containers",
  "@odata.count": 1,
  "value": [
    {
      "@odata.type": "#microsoft.graph.fileStorageContainer",
      "id": "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z",
      "displayName": "My File Storage Container",
      "containerTypeId": "e2756c4d-fa33-4452-9c36-2325686e1082",
      "createdDateTime": "2021-11-24T15:41:52.347Z"
    }
  ]
}