Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Namespace: microsoft.graph
Obtenha uma lista dos objetos customDataProvidedResourceUploadSession e suas propriedades.
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) | EntitlementManagement.Read.All | EntitlementManagement.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | EntitlementManagement.Read.All | EntitlementManagement.ReadWrite.All |
Dica
Para acesso delegado usando contas corporativas ou de estudante, o usuário conectado deve receber uma função de administrador com permissões de função com suporte por meio de uma das seguintes opções:
- Uma função no sistema de Gerenciamento de Direitos em que a função menos privilegiada é Proprietário do catálogo. Essa é a opção menos privilegiada.
- Funções do Microsoft Entra com mais privilégios com suporte para esta operação:
- Administrador de Governança de Identidade
Em cenários somente de aplicativo, o aplicativo de chamada pode receber uma das funções com suporte anteriores em vez da permissão do EntitlementManagement.ReadWrite.All aplicativo. A função de proprietário do catálogo é menos privilegiada do que a permissão do EntitlementManagement.ReadWrite.All aplicativo.
Para obter mais informações, consulte Delegação e funções no gerenciamento de direitos e como delegar governança de acesso para gerenciadores de pacotes de acesso no gerenciamento de direitos.
Dica
Para acesso delegado usando contas corporativas ou de estudante, o usuário conectado deve receber uma função de administrador com permissões de função com suporte por meio de uma das seguintes opções:
- Uma função no sistema de Gerenciamento de Direitos em que a função menos privilegiada é Proprietário do catálogo. Essa é a opção menos privilegiada.
- Funções do Microsoft Entra com mais privilégios com suporte para esta operação:
- Administrador de Governança de Identidade
Em cenários somente de aplicativo, o aplicativo de chamada pode receber uma das funções com suporte anteriores em vez da permissão do EntitlementManagement.ReadWrite.All aplicativo. A função de proprietário do catálogo é menos privilegiada do que a permissão do EntitlementManagement.ReadWrite.All aplicativo.
Para obter mais informações, consulte Delegação e funções no gerenciamento de direitos e como delegar governança de acesso para gerenciadores de pacotes de acesso no gerenciamento de direitos.
Solicitação HTTP
GET /identityGovernance/entitlementManagement/catalogs/{accessPackageCatalogId}/resources/{accessPackageResourceId}/uploadSessions
Parâmetros de consulta opcionais
Esse método dá suporte aos $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.
O exemplo a seguir consulta consultas aninhadas $filter e $orderby tem suporte para a relação de arquivos do tipo customDataProvidedResourceFile.
| 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) |
As propriedades name, size e uploadedDateTime também são compatíveis $orderby , conforme mostrado nos exemplos a seguir.
Obtenha uma sessão de upload com arquivos classificados por uploadedDateTime:
GET /identityGovernance/catalogs/{accessPackageCatalogId}/resources/{accessPackageResourceId}/uploadSessions?$expand=files($orderby=uploadedDateTime desc)
Obtenha uma sessão de upload com arquivos filtrados por tamanho (maiores que 1 MB):
GET /identityGovernance/catalogs/{accessPackageCatalogId}/resources/{accessPackageResourceId}/uploadSessions?$expand=files($filter=size gt 1000000)
Obtenha uma sessão de upload com arquivos classificados por nome:
GET /identityGovernance/catalogs/{accessPackageCatalogId}/resources/{accessPackageResourceId}/uploadSessions?$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, esse método retornará 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/v1.0/identityGovernance/entitlementManagement/catalogs/{accessPackageCatalogId}/resources/{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/v1.0/$metadata#identityGovernance/entitlementManagement/catalogs('3c9f2b1e-8a4d-4e7f-9d2a-6b3e1c7f5a9d')/resources('15eeb4df-bd15-4d8b-9679-e75791dbc1d9')/uploadSessions",
"value": [
{
"@odata.type": "#microsoft.graph.customDataProvidedResourceAccessReviewUploadSession",
"id": "2fa3bc17-de50-4f48-91f0-dd4aede5c424",
"referenceId": "6ddffb12-922b-4825-93c3-9457dc2c1f81",
"status": "complete",
"isUploadDone": true,
"createdDateTime": "2026-03-24T21:34:56.220345Z",
"stats": {
"filesUploaded": 1,
"totalBytesUploaded": 10331
},
"data": {
"@odata.type": "#microsoft.graph.customDataProvidedResourcePayloads.accessReviewContextData",
"reviewDefinitionId": "a89003b1-d457-4b8a-b060-42a3b6ad6c44",
"reviewInstanceId": "6ddffb12-922b-4825-93c3-9457dc2c1f81"
}
}
]
}