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
Crie um objeto customDataProvidedResourceUploadSession . Apenas uma sessão de upload é permitida por instância de referência (por exemplo, instância de revisão de acesso) e par accessPackageResource . Depois de criar uma sessão de upload, carregar arquivos e concluir a sessão, os dados são processados e você não pode criar outra sessão de upload para o mesmo par. Se você encontrar erros com arquivos carregados ou precisar começar do zero, poderá excluir a sessão de upload ativa para criar uma nova.
A tabela a seguir lista os tipos derivados de customDataProvidedResourceUploadSession que podem ser criados. Especifique o @odata.type no corpo da solicitação para indicar o tipo derivado.
| Tipo derivado | Descrição |
|---|---|
| customDataProvidedResourceAccessReviewUploadSession | Uma sessão de upload para cenários de revisão de acesso. |
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.ReadWrite.All | Indisponível. |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | EntitlementManagement.ReadWrite.All | Indisponível. |
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
POST /identityGovernance/entitlementManagement/catalogs/{accessPackageCatalogId}/resources/{accessPackageResourceId}/uploadSessions
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Content-Type | application/json. Obrigatório. |
Corpo da solicitação
No corpo da solicitação, forneça uma representação JSON de um objeto customDataProvidedResourceUploadSessionRequest e defina a @odata.type propriedade como o tipo derivado customDataProvidedResourceUploadSession que você deseja criar. Para cenários de revisão de acesso, defina @odata.type como #microsoft.graph.customDataProvidedResourceAccessReviewUploadSession.
Você pode especificar as propriedades a seguir ao criar um customDataProvidedResourceUploadSession.
| Propriedade | Tipo | Descrição |
|---|---|---|
| data | microsoft.graph.customDataProvidedResourcePayloads.data | Contém informações sobre o contexto para o qual os dados estão sendo carregados. Para cenários de revisão de acesso, use microsoft.graph.customDataProvidedResourcePayloads.accessReviewContextData. Obrigatório. |
Resposta
Se for bem-sucedido, esse método retornará um código de 201 Created resposta e um objeto customDataProvidedResourceUploadSession no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
POST https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/catalogs/{accessPackageCatalogId}/resources/{accessPackageResourceId}/uploadSessions
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.customDataProvidedResourceAccessReviewUploadSession",
"data": {
"@odata.type": "#microsoft.graph.customDataProvidedResourcePayloads.accessReviewContextData",
"reviewDefinitionId": "9e4b1c6f-2a3d-4f8e-9b7a-5c1e2d3f4a6b",
"reviewInstanceId": "15eeb4df-8a4d-4f8e-9b7a-6b3e1c7f5a9d"
}
}
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 201 Created
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/$entity",
"@odata.type": "#microsoft.graph.customDataProvidedResourceAccessReviewUploadSession",
"id": "0b64df22-1a83-472c-9556-6c3dc41742b9",
"referenceId": "ca24f9b9-5917-4971-9b5b-07aae0aa74e8",
"status": "active",
"isUploadDone": false,
"createdDateTime": "2026-04-01T18:24:07.148406Z",
"stats": {
"filesUploaded": 0,
"totalBytesUploaded": 0
},
"data": {
"@odata.type": "#microsoft.graph.customDataProvidedResourcePayloads.accessReviewContextData",
"reviewDefinitionId": "f5744a40-bca0-4506-a286-a8afac513d1c",
"reviewInstanceId": "ca24f9b9-5917-4971-9b5b-07aae0aa74e8"
},
"files": []
}