Erstellen von customDataProvidedResourceUploadSession

Namespace: microsoft.graph

Erstellen Sie ein customDataProvidedResourceUploadSession-Objekt . Pro Verweis instance (z. B. Zugriffsüberprüfung instance) und accessPackageResource-Paar ist nur eine Uploadsitzung zulässig. Nachdem Sie eine Uploadsitzung erstellt, Dateien hochgeladen und die Sitzung abgeschlossen haben, werden die Daten verarbeitet, und Sie können keine weitere Uploadsitzung für dasselbe Paar erstellen. Wenn bei hochgeladenen Dateien Fehler auftreten oder neu gestartet werden müssen, können Sie die aktive Uploadsitzung löschen , um eine neue zu erstellen.

In der folgenden Tabelle sind die abgeleiteten Typen von customDataProvidedResourceUploadSession aufgeführt, die erstellt werden können. Geben Sie den @odata.type im Anforderungstext an, um den abgeleiteten Typ anzugeben.

Abgeleiteter Typ Beschreibung
customDataProvidedResourceAccessReviewUploadSession Eine Uploadsitzung für Zugriffsüberprüfungsszenarien.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ❌ ❌ ❌

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) EntitlementManagement.ReadWrite.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application EntitlementManagement.ReadWrite.All Nicht verfügbar.

Tipp

Für delegierten Zugriff über Geschäfts-, Schul- oder Unikonten muss dem angemeldeten Benutzer über eine der folgenden Optionen eine Administratorrolle mit unterstützten Rollenberechtigungen zugewiesen werden:

In reinen App-Szenarien kann der aufrufenden App anstelle EntitlementManagement.ReadWrite.All der Anwendungsberechtigung eine der oben genannten unterstützten Rollen zugewiesen werden. Die Rolle Katalogbesitzer ist weniger privilegiert als die EntitlementManagement.ReadWrite.All Anwendungsberechtigung.

Weitere Informationen finden Sie unter Delegierung und Rollen in der Berechtigungsverwaltung und Delegieren der Zugriffsgovernance an Zugriffspaket-Manager in der Berechtigungsverwaltung.

Tipp

Für delegierten Zugriff über Geschäfts-, Schul- oder Unikonten muss dem angemeldeten Benutzer über eine der folgenden Optionen eine Administratorrolle mit unterstützten Rollenberechtigungen zugewiesen werden:

In reinen App-Szenarien kann der aufrufenden App anstelle EntitlementManagement.ReadWrite.All der Anwendungsberechtigung eine der oben genannten unterstützten Rollen zugewiesen werden. Die Rolle Katalogbesitzer ist weniger privilegiert als die EntitlementManagement.ReadWrite.All Anwendungsberechtigung.

Weitere Informationen finden Sie unter Delegierung und Rollen in der Berechtigungsverwaltung und Delegieren der Zugriffsgovernance an Zugriffspaket-Manager in der Berechtigungsverwaltung.

HTTP-Anforderung

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

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung eines customDataProvidedResourceUploadSessionRequest-Objekts an, und legen Sie die @odata.type Eigenschaft auf den abgeleiteten CustomDataProvidedResourceUploadSession-Typ fest, den Sie erstellen möchten. Legen Sie für Zugriffsüberprüfungsszenarien auf fest @odata.type#microsoft.graph.customDataProvidedResourceAccessReviewUploadSession.

Sie können die folgenden Eigenschaften angeben, wenn Sie eine customDataProvidedResourceUploadSession erstellen.

Eigenschaft Typ Beschreibung
data microsoft.graph.customDataProvidedResourcePayloads.data Enthält Informationen zum Kontext, für den Daten hochgeladen werden. Verwenden Sie für Zugriffsüberprüfungsszenarien microsoft.graph.customDataProvidedResourcePayloads.accessReviewContextData. Erforderlich.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein customDataProvidedResourceUploadSession-Objekt im Antworttext zurück.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

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": []
}
  • Last updated on