Créer customDataProvidedResourceUploadSession

Espace de noms: microsoft.graph

Créez un objet DataProvidedResourceUploadSession personnalisé . Une seule session de chargement est autorisée par instance de référence (par exemple, une instance de révision d’accès) et la paire accessPackageResource. Une fois que vous avez créé une session de téléchargement, téléchargé des fichiers et terminé la session, les données sont traitées et vous ne pouvez pas créer une autre session de chargement pour cette même paire. Si vous rencontrez des erreurs avec les fichiers chargés ou si vous devez commencer à zéro, vous pouvez supprimer la session de chargement active pour en créer une nouvelle.

Le tableau suivant répertorie les types dérivés de customDataProvidedResourceUploadSession qui peuvent être créés. Spécifiez dans @odata.type le corps de la requête pour indiquer le type dérivé.

Type dérivé	Description
customDataProvidedResourceAccessReviewUploadSession	Une session de chargement pour les scénarios de révision d’accès.

Cette API est disponible dans les déploiements cloud nationaux suivants.

Service global	Gouvernement américain L4	Gouvernement américain L5 (DOD)	Chine exploitée par 21Vianet
✅	❌	❌	❌

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme étant les moins privilégiées pour cette API. Utilisez une ou plusieurs autorisations privilégiées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, voir Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez la référence des autorisations.

Type d’autorisation	Autorisations les moins privilégiées	Autorisations à privilèges plus élevés
Déléguée (compte professionnel ou scolaire)	EntitlementManagement.ReadWrite.All	Non disponible.
Déléguée (compte Microsoft personnel)	Non prise en charge.	Non prise en charge.
Application	EntitlementManagement.ReadWrite.All	Non disponible.

Conseil

Pour l’accès délégué à l’aide de comptes professionnels ou scolaires, l’utilisateur connecté doit disposer d’un rôle d’administrateur avec des autorisations de rôle prises en charge via l’une des options suivantes :

Un rôle dans le système de gestion des droits d’utilisation où le rôle le moins privilégié est Propriétaire du catalogue. Il s’agit de l’option la moins privilégiée.
Rôles Microsoft Entra plus privilégiés pris en charge pour cette opération :
- Administrateur de gouvernance des identités

Dans les scénarios d’application uniquement, l’application appelante peut se voir attribuer l’un des rôles pris en charge précédents au lieu de l’autorisation d’application EntitlementManagement.ReadWrite.All . Le rôle Propriétaire du catalogue est moins privilégié que l’autorisation de l’application EntitlementManagement.ReadWrite.All .

Pour plus d’informations, voir Délégation et rôles dans la gestion des droits d’utilisation et comment déléguer la gouvernance des accès aux gestionnaires de packages d’accès dans la gestion des droits d’utilisation.

Conseil

Un rôle dans le système de gestion des droits d’utilisation où le rôle le moins privilégié est Propriétaire du catalogue. Il s’agit de l’option la moins privilégiée.
Rôles Microsoft Entra plus privilégiés pris en charge pour cette opération :
- Administrateur de gouvernance des identités

Requête HTTP

POST /identityGovernance/entitlementManagement/catalogs/{accessPackageCatalogId}/resources/{accessPackageResourceId}/uploadSessions

En-têtes de demande

Nom	Description
Autorisation	Porteur {token}. Obligatoire. En savoir plus sur l’authentification et les autorisations.
Content-Type	application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON d’un objet customDataProvidedResourceUploadSessionRequest et définissez la @odata.type propriété sur le type dérivé customDataProvidedResourceUploadSession que vous souhaitez créer. Pour les scénarios de révision d’accès, définissez sur @odata.type#microsoft.graph.customDataProvidedResourceAccessReviewUploadSession.

Vous pouvez spécifier les propriétés suivantes lors de la création d’une session customDataProvidedResourceUploadSession.

Propriété	Type	Description
data	microsoft.graph.customDataProvidedResourcePayloads.data	Contient des informations sur le contexte dans lequel les données sont chargées. Pour les scénarios de révision d’accès, utilisez microsoft.graph.customDataProvidedResourcePayloads.accessReviewContextData. Obligatoire.

Réponse

En cas de réussite, cette méthode renvoie un 201 Created code de réponse et un objet customDataProvidedResourceUploadSession dans le corps de la réponse.

Exemples

Demande

L’exemple suivant illustre une demande.

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"
  }
}


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;
using Microsoft.Graph.Models.CustomDataProvidedResourcePayloads;

var requestBody = new CustomDataProvidedResourceAccessReviewUploadSession
{
	OdataType = "#microsoft.graph.customDataProvidedResourceAccessReviewUploadSession",
	Data = new AccessReviewContextData
	{
		OdataType = "#microsoft.graph.customDataProvidedResourcePayloads.accessReviewContextData",
		ReviewDefinitionId = "9e4b1c6f-2a3d-4f8e-9b7a-5c1e2d3f4a6b",
		ReviewInstanceId = "15eeb4df-8a4d-4f8e-9b7a-6b3e1c7f5a9d",
	},
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.IdentityGovernance.EntitlementManagement.Catalogs["{accessPackageCatalog-id}"].Resources["{accessPackageResource-id}"].UploadSessions.PostAsync(requestBody);

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
	  graphmodelscustomdataprovidedresourcepayloads "github.com/microsoftgraph/msgraph-sdk-go/models/customdataprovidedresourcepayloads"
	  //other-imports
)

requestBody := graphmodels.NewCustomDataProvidedResourceUploadSession()
data := graphmodelscustomdataprovidedresourcepayloads.NewAccessReviewContextData()
reviewDefinitionId := "9e4b1c6f-2a3d-4f8e-9b7a-5c1e2d3f4a6b"
data.SetReviewDefinitionId(&reviewDefinitionId) 
reviewInstanceId := "15eeb4df-8a4d-4f8e-9b7a-6b3e1c7f5a9d"
data.SetReviewInstanceId(&reviewInstanceId) 
requestBody.SetData(data)

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
uploadSessions, err := graphClient.IdentityGovernance().EntitlementManagement().Catalogs().ByAccessPackageCatalogId("accessPackageCatalog-id").Resources().ByAccessPackageResourceId("accessPackageResource-id").UploadSessions().Post(context.Background(), requestBody, nil)

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

CustomDataProvidedResourceAccessReviewUploadSession customDataProvidedResourceUploadSession = new CustomDataProvidedResourceAccessReviewUploadSession();
customDataProvidedResourceUploadSession.setOdataType("#microsoft.graph.customDataProvidedResourceAccessReviewUploadSession");
com.microsoft.graph.models.customdataprovidedresourcepayloads.AccessReviewContextData data = new com.microsoft.graph.models.customdataprovidedresourcepayloads.AccessReviewContextData();
data.setOdataType("#microsoft.graph.customDataProvidedResourcePayloads.accessReviewContextData");
data.setReviewDefinitionId("9e4b1c6f-2a3d-4f8e-9b7a-5c1e2d3f4a6b");
data.setReviewInstanceId("15eeb4df-8a4d-4f8e-9b7a-6b3e1c7f5a9d");
customDataProvidedResourceUploadSession.setData(data);
CustomDataProvidedResourceUploadSession result = graphClient.identityGovernance().entitlementManagement().catalogs().byAccessPackageCatalogId("{accessPackageCatalog-id}").resources().byAccessPackageResourceId("{accessPackageResource-id}").uploadSessions().post(customDataProvidedResourceUploadSession);

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).


const options = {
	authProvider,
};

const client = Client.init(options);

const customDataProvidedResourceUploadSession = {
  '@odata.type': '#microsoft.graph.customDataProvidedResourceAccessReviewUploadSession',
  data: {
    '@odata.type': '#microsoft.graph.customDataProvidedResourcePayloads.accessReviewContextData',
    reviewDefinitionId: '9e4b1c6f-2a3d-4f8e-9b7a-5c1e2d3f4a6b',
    reviewInstanceId: '15eeb4df-8a4d-4f8e-9b7a-6b3e1c7f5a9d'
  }
};

await client.api('/identityGovernance/entitlementManagement/catalogs/{accessPackageCatalogId}/resources/{accessPackageResourceId}/uploadSessions')
	.post(customDataProvidedResourceUploadSession);

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).


<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\CustomDataProvidedResourceAccessReviewUploadSession;
use Microsoft\Graph\Generated\Models\CustomDataProvidedResourcePayloads\AccessReviewContextData;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new CustomDataProvidedResourceAccessReviewUploadSession();
$requestBody->setOdataType('#microsoft.graph.customDataProvidedResourceAccessReviewUploadSession');
$data = new AccessReviewContextData();
$data->setOdataType('#microsoft.graph.customDataProvidedResourcePayloads.accessReviewContextData');
$data->setReviewDefinitionId('9e4b1c6f-2a3d-4f8e-9b7a-5c1e2d3f4a6b');
$data->setReviewInstanceId('15eeb4df-8a4d-4f8e-9b7a-6b3e1c7f5a9d');
$requestBody->setData($data);

$result = $graphServiceClient->identityGovernance()->entitlementManagement()->catalogs()->byAccessPackageCatalogId('accessPackageCatalog-id')->resources()->byAccessPackageResourceId('accessPackageResource-id')->uploadSessions()->post($requestBody)->wait();

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).


Import-Module Microsoft.Graph.Identity.Governance

$params = @{
	"@odata.type" = "#microsoft.graph.customDataProvidedResourceAccessReviewUploadSession"
	data = @{
		"@odata.type" = "#microsoft.graph.customDataProvidedResourcePayloads.accessReviewContextData"
		reviewDefinitionId = "9e4b1c6f-2a3d-4f8e-9b7a-5c1e2d3f4a6b"
		reviewInstanceId = "15eeb4df-8a4d-4f8e-9b7a-6b3e1c7f5a9d"
	}
}

New-MgEntitlementManagementCatalogResourceUploadSession -AccessPackageCatalogId $accessPackageCatalogId -AccessPackageResourceId $accessPackageResourceId -BodyParameter $params

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.custom_data_provided_resource_access_review_upload_session import CustomDataProvidedResourceAccessReviewUploadSession
from msgraph.generated.models.custom_data_provided_resource_payloads.access_review_context_data import AccessReviewContextData
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = CustomDataProvidedResourceAccessReviewUploadSession(
	odata_type = "#microsoft.graph.customDataProvidedResourceAccessReviewUploadSession",
	data = AccessReviewContextData(
		odata_type = "#microsoft.graph.customDataProvidedResourcePayloads.accessReviewContextData",
		review_definition_id = "9e4b1c6f-2a3d-4f8e-9b7a-5c1e2d3f4a6b",
		review_instance_id = "15eeb4df-8a4d-4f8e-9b7a-6b3e1c7f5a9d",
	),
)

result = await graph_client.identity_governance.entitlement_management.catalogs.by_access_package_catalog_id('accessPackageCatalog-id').resources.by_access_package_resource_id('accessPackageResource-id').upload_sessions.post(request_body)

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Réponse

L’exemple suivant illustre la réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

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": []
}

Commentaires

Cette page a-t-elle été utile ?

Dernière mise à jour : 2026-08-26

Créer customDataProvidedResourceUploadSession

Autorisations

Requête HTTP

En-têtes de demande

Corps de la demande

Réponse

Exemples

Demande

Réponse

Commentaires

Ressources supplémentaires