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
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Obtenha uma lista dos objetos customDataProvidedResourceUploadSession e as respetivas propriedades.
Esta API está disponível nas seguintes implementações de cloud nacionais.
| Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Permissões
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
| Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | EntitlementManagement.ReadWrite.All | Indisponível. |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | EntitlementManagement.ReadWrite.All | Indisponível. |
Dica
Para acesso delegado através de contas escolares ou profissionais, o utilizador com sessão iniciada tem de ter uma função de administrador com permissões de função suportadas através de uma das seguintes opções:
- Uma função no sistema de Gestão de Direitos em que a função com menos privilégios é Proprietário do catálogo. Esta é a opção com menos privilégios.
- Mais funções de Microsoft Entra privilegiadas suportadas para esta operação:
- Administrador de Governação de Identidades
Em cenários apenas de aplicações, a aplicação de chamadas pode ser atribuída a uma das funções suportadas anteriores em vez da permissão da aplicação EntitlementManagement.ReadWrite.All . A função de proprietário do Catálogo tem menos privilégios do que a permissão da aplicação EntitlementManagement.ReadWrite.All .
Para obter mais informações, veja Delegação e funções na gestão de direitos e como delegar a governação de acesso aos gestores de pacotes de acesso na gestão de direitos.
Solicitação HTTP
GET /identityGovernance/catalogs/{catalogId}/accessPackageResources/{accessPackageResourceId}/uploadSessions
Parâmetros de consulta opcionais
Este método suporta os $expandparâmetros de consulta , $filter, $top, $skip, $orderby$count OData para ajudar a personalizar a resposta. Para obter informações gerais, acesse Parâmetros de consulta OData.
** Consultas de exemplo para aninhados $filter e $orderby suportados para a relação de ficheiros do tipo customDataProvidedResourceUploadSession.
| Propriedade | Operadores | Exemplo |
|---|---|---|
| nome |
eq, ne |
$expand=files($filter=name eq 'building-a-access.csv') |
| size |
eq, ne, gt, ge, lt, le |
$expand=files($filter=size gt 1000000) |
| uploadedDateTime |
eq, ne, gt, ge, lt, le |
$expand=files($filter=uploadedDateTime ge 2026-01-01T00:00:00Z) |
O nome, o tamanho e as proeprties uploadedDateTime também suportam $orderby , conforme mostrado nos seguintes exemplos:
Obtenha a sessão de carregamento com ficheiros ordenados por uploadedDateTime:
Get upload session with files sorted by **uploadedDateTime**:
```http
GET /identityGovernance/entitlementManagement/catalogs/{catalogId}/accessPackageResources/{resourceId}/uploadSessions/{sessionId}?$expand=files($orderby=uploadedDateTime desc)
Obter sessão de carregamento com ficheiros filtrados por tamanho (superior a 1 MB)@
GET /identityGovernance/entitlementManagement/catalogs/{catalogId}/accessPackageResources/{resourceId}/uploadSessions/{sessionId}?$expand=files($filter=size gt 1000000)
Obtenha a sessão de carregamento com ficheiros ordenados pelo nome:
GET /identityGovernance/entitlementManagement/catalogs/{catalogId}/accessPackageResources/{resourceId}/uploadSessions/{sessionId}?$expand=files($orderby=name asc)
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, este método devolve um 200 OK código de resposta e uma coleção de objetos customDataProvidedResourceUploadSession no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/beta/identityGovernance/catalogs/{catalogId}/accessPackageResources/{accessPackageResourceId}/uploadSessions
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/catalogs('3c9f2b1e-8a4d-4e7f-9d2a-6b3e1c7f5a9d')/accessPackageResources('15eeb4df-bd15-4d8b-9679-e75791dbc1d9')/uploadSessions",
"value": [
{
"id": "2fa3bc17-de50-4f48-91f0-dd4aede5c424",
"referenceId": "6ddffb12-922b-4825-93c3-9457dc2c1f81",
"status": "complete",
"isUploadDone": true,
"createdDateTime": "2026-03-24T21:34:56.220345Z",
"source": "BuildingAccessData",
"type": "#microsoft.graph.accessReviewDataUploadTriggerCallbackData",
"stats": {
"filesUploaded": 1,
"totalBytesUploaded": 10331
},
"data": {
"@odata.type": "#microsoft.graph.accessReviewResourceDataUploadSessionContextData",
"accessReviewId": "a89003b1-d457-4b8a-b060-42a3b6ad6c44",
"accessReviewInstanceId": "6ddffb12-922b-4825-93c3-9457dc2c1f81"
},
"files": [
{
"id": "330667fd-c977-4367-99ea-2eb12c42c573",
"name": "test-data.csv",
"size": 10331,
"uploadedDateTime": "2026-03-24T21:34:57.1713709Z"
}
]
},
{
"id": "3717bbf7-6d72-4a6d-b83e-11e6038de8a1",
"referenceId": "ec98588d-6de1-4f47-8a6b-0ad1b6192b6f",
"status": "complete",
"isUploadDone": true,
"createdDateTime": "2026-03-27T21:02:25.0632085Z",
"source": "CustomAccessData",
"type": "#microsoft.graph.accessReviewDataUploadTriggerCallbackData",
"stats": {
"filesUploaded": 1,
"totalBytesUploaded": 2415
},
"data": {
"@odata.type": "#microsoft.graph.accessReviewResourceDataUploadSessionContextData",
"accessReviewId": "170dc1f2-0622-4380-b44b-ee8bc58b975d",
"accessReviewInstanceId": "ec98588d-6de1-4f47-8a6b-0ad1b6192b6f"
},
"files": [
{
"id": "2d66944b-6fa8-4604-a60e-d03ec4962d00",
"name": "generated_test_data_20.csv",
"size": 2415,
"uploadedDateTime": "2026-03-27T21:02:58.9849683Z"
}
]
}
]
}