mobileAppSupersedence erstellen

Namespace: microsoft.graph

Wichtig: Microsoft Graph-APIs unter der /beta-Version können sich ändern. Die Verwendung in der Produktion wird nicht unterstützt.

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

Erstellen Sie ein neues mobileAppSupersedence-Objekt .

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

Globaler Dienst	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
Anwendung	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All

HTTP-Anforderung

POST /deviceAppManagement/mobileAppRelationships
POST /deviceAppManagement/mobileApps/{mobileAppId}/relationships

Anforderungsheader

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

Anforderungstext

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

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von mobileAppSupersedence erforderlich sind.

Eigenschaft	Typ	Beschreibung
id	String	Der eindeutige Bezeichner für die Beziehungsentität der mobilen App. Schreibgeschützt. Geerbt von mobileAppRelationship
targetId	String	App-ID der App, die das Ziel der Beziehungsentität der mobilen App ist. Read-Only geerbt von mobileAppRelationship
targetDisplayName	String	Der Anzeigename der App, die das Ziel der Beziehungsentität der mobilen App ist. Schreibgeschützt. Diese Eigenschaft ist schreibgeschützt. Geerbt von mobileAppRelationship
targetDisplayVersion	String	Die Anzeigeversion der App, die das Ziel der Mobile App-Beziehungsentität ist. Schreibgeschützt. Diese Eigenschaft ist schreibgeschützt. Geerbt von mobileAppRelationship
targetPublisher	String	Der Herausgeber der App, die das Ziel der Beziehungsentität für mobile Apps ist. Schreibgeschützt. Diese Eigenschaft ist schreibgeschützt. Geerbt von mobileAppRelationship
targetType	mobileAppRelationshipType	Der Beziehungstyp, der angibt, ob die Zielanwendung einer Beziehung ein übergeordnetes oder untergeordnetes Element in der Beziehung ist. Mögliche Werte sind: übergeordnete, untergeordnete Werte. Schreibgeschützt. Diese Eigenschaft ist schreibgeschützt. Geerbt von mobileAppRelationship. Mögliche Werte sind: child, parent und unknownFutureValue.
supersedenceType	mobileAppSupersedenceType	Der Ablösungsbeziehungstyp zwischen der übergeordneten und der untergeordneten App. Mögliche Werte sind: update, replace. Schreibgeschützt. Mögliche Werte sind: update, replace und unknownFutureValue.
supersedededAppCount	Int32	Die Gesamtzahl der Apps, die direkt oder indirekt von der untergeordneten App abgelöst werden. Schreibgeschützt. Diese Eigenschaft ist schreibgeschützt.
supersedingAppCount	Int32	Die Gesamtzahl der Apps, die direkt oder indirekt die übergeordnete App ablösen. Schreibgeschützt. Diese Eigenschaft ist schreibgeschützt.

Antwort

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

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

POST https://graph.microsoft.com/beta/deviceAppManagement/mobileAppRelationships
Content-type: application/json
Content-length: 375

{
  "@odata.type": "#microsoft.graph.mobileAppSupersedence",
  "targetId": "Target Id value",
  "targetDisplayName": "Target Display Name value",
  "targetDisplayVersion": "Target Display Version value",
  "targetPublisher": "Target Publisher value",
  "targetType": "parent",
  "supersedenceType": "replace",
  "supersededAppCount": 2,
  "supersedingAppCount": 3
}

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: 424

{
  "@odata.type": "#microsoft.graph.mobileAppSupersedence",
  "id": "c0254204-4204-c025-0442-25c0044225c0",
  "targetId": "Target Id value",
  "targetDisplayName": "Target Display Name value",
  "targetDisplayVersion": "Target Display Version value",
  "targetPublisher": "Target Publisher value",
  "targetType": "parent",
  "supersedenceType": "replace",
  "supersededAppCount": 2,
  "supersedingAppCount": 3
}