Freigeben über

managedAppLogCollectionRequest erstellen

Namespace: microsoft.graph

Wichtig: Microsoft unterstützt Intune/beta-APIs, die jedoch häufiger geändert werden. Microsoft empfiehlt, nach Möglichkeit Version 1.0 zu verwenden. Überprüfen Sie die Verfügbarkeit einer API in Version 1.0 mithilfe der Versionsauswahl.

Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.

Erstellen Sie ein neues managedAppLogCollectionRequest-Objekt .

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

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

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Application DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All

HTTP-Anforderung

POST /deviceAppManagement/managedAppRegistrations/{managedAppRegistrationId}/managedAppLogCollectionRequests

Anforderungsheader

Kopfzeile Wert
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Annehmen application/json

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung für das managedAppLogCollectionRequest-Objekt an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die erforderlich sind, wenn Sie managedAppLogCollectionRequest erstellen.

Eigenschaft Typ Beschreibung
id Zeichenfolge Der eindeutige Bezeichner der Protokollsammlungsanforderung für verwaltete Apps. Diese ID wird während der Anforderungserstellung zugewiesen. Schreibgeschützt.
managedAppRegistrationId Zeichenfolge Der eindeutige Bezeichner der App instance, für die Diagnoseprotokolle gesammelt wurden. Schreibgeschützt.
status Zeichenfolge Gibt den status für die App-Protokollsammlungsanforderung an – ausstehend, abgeschlossen oder fehlgeschlagen. Der Standardwert ist ausstehend.
requestedBy Zeichenfolge Der Benutzerprinzipalname, der der Anforderung für die Protokollsammlung der verwalteten Anwendung zugeordnet ist. Schreibgeschützt.
requestedByUserPrincipalName Zeichenfolge Der Benutzerprinzipalname, der der Anforderung für die Protokollsammlung der verwalteten Anwendung zugeordnet ist. Schreibgeschützt.
requestedDateTime DateTimeOffset DateTime des Zeitpunkts, an dem die Protokolluploadanforderung empfangen wurde. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'. Wird standardmäßig zurückgegeben. Schreibgeschützt.
completedDateTime DateTimeOffset DateTime des Zeitpunkts, an dem die Protokolluploadanforderung abgeschlossen wurde. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC-Zeit am 1. Januar 2014 würde z. B. wie folgt aussehen: '2014-01-01T00:00:00Z'. Wird standardmäßig zurückgegeben. Schreibgeschützt.
userLogUploadConsent managedAppLogUploadConsent Gibt an, ob der dem Gerät zugeordnete Benutzer die Zustimmung für die Protokollsammlung erteilt hat. Der Benutzer muss zustimmen, bevor die Diagnoseprotokolle gesammelt werden können. accepted bedeutet, dass der Benutzer zugestimmt hat. "abgelehnt" bedeutet, dass der Benutzer abgelehnt hat. unknown ist der Standardwert. Die Protokollsammlungsanforderung muss innerhalb von 24 Stunden abgeschlossen sein, andernfalls wird sie abgebrochen und gelöscht. Schreibgeschützt. Mögliche Werte: unknown, declined, accepted, unknownFutureValue
uploadedLogs managedAppLogUpload-Sammlung Die Sammlung von Protokolluploadergebnissen, die von jeder Komponente auf dem Gerät gemeldet werden. Diese Komponenten können die Anwendung selbst, das MAM-SDK (Mobile Application Management) und andere komponenten auf dem Gerät sein, die zum Hochladen von Diagnoseprotokollen angefordert werden. Schreibgeschützt.
Version String Version der Entität

Antwort

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

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

POST https://graph.microsoft.com/beta/deviceAppManagement/managedAppRegistrations/{managedAppRegistrationId}/managedAppLogCollectionRequests
Content-type: application/json
Content-length: 799

{
  "@odata.type": "#microsoft.graph.managedAppLogCollectionRequest",
  "managedAppRegistrationId": "Managed App Registration Id value",
  "status": "Status value",
  "requestedBy": "Requested By value",
  "requestedByUserPrincipalName": "Requested By User Principal Name value",
  "requestedDateTime": "2017-01-01T00:01:49.2071853-08:00",
  "completedDateTime": "2016-12-31T23:58:52.3534526-08:00",
  "userLogUploadConsent": "declined",
  "uploadedLogs": [
    {
      "@odata.type": "microsoft.graph.managedAppLogUpload",
      "managedAppComponent": "Managed App Component value",
      "managedAppComponentDescription": "Managed App Component Description value",
      "status": "inProgress",
      "referenceId": "Reference Id value"
    }
  ],
  "version": "Version value"
}

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 848

{
  "@odata.type": "#microsoft.graph.managedAppLogCollectionRequest",
  "id": "95b5bd26-bd26-95b5-26bd-b59526bdb595",
  "managedAppRegistrationId": "Managed App Registration Id value",
  "status": "Status value",
  "requestedBy": "Requested By value",
  "requestedByUserPrincipalName": "Requested By User Principal Name value",
  "requestedDateTime": "2017-01-01T00:01:49.2071853-08:00",
  "completedDateTime": "2016-12-31T23:58:52.3534526-08:00",
  "userLogUploadConsent": "declined",
  "uploadedLogs": [
    {
      "@odata.type": "microsoft.graph.managedAppLogUpload",
      "managedAppComponent": "Managed App Component value",
      "managedAppComponentDescription": "Managed App Component Description value",
      "status": "inProgress",
      "referenceId": "Reference Id value"
    }
  ],
  "version": "Version value"
}
  • Last updated on