Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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"
}
]
}