Crear mobileAppSupersedence

Espacio de nombres: microsoft.graph

Importante: Microsoft admite las API de Intune/beta, pero están sujetas a cambios más frecuentes. Microsoft recomienda usar la versión v1.0 siempre que sea posible. Comprobar la disponibilidad de una API en la versión v1.0 mediante el selector de versión.

Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.

Crear un nuevo objeto mobileAppSupersedence .

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ✅ ✅ ✅

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida.
Aplicación DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All

Solicitud HTTP

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

Encabezados de solicitud

Encabezado Valor
Authorization {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización.
Aceptar application/json

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON para el objeto mobileAppSupersedence.

En la tabla siguiente se muestran las propiedades necesarias para crear la aplicación mobileAppSupersedence.

Propiedad Tipo Descripción
id Cadena El identificador único de la entidad de relación de aplicación móvil. Este identificador único se asigna en la creación de la entidad MobileAppRelationship. Por ejemplo: 2dbc75b9-e993-4e4d-a071-91ac5a218672_43aaaf35-ce51-4695-9447-5eac6df31161. Solo lectura. Se devuelve de forma predeterminada. Soportes: $select. No admite $search, $filter, $orderBy. Heredado de mobileAppRelationship
targetId Cadena El identificador de aplicación único del destino de la entidad de relación de aplicación móvil. Por ejemplo: 2dbc75b9-e993-4e4d-a071-91ac5a218672. Solo lectura. Se devuelve de forma predeterminada. Soportes: $select. No admite $search, $filter, $orderBy. Heredado de mobileAppRelationship
targetDisplayName Cadena El nombre para mostrar de la aplicación que es el destino de la entidad de relación aplicación móvil. Por ejemplo: programa de instalación de Firefox 52.0.2 32bit.intunewin. La longitud máxima es de 500 caracteres. Solo lectura. Se devuelve de forma predeterminada. Soportes: $select. No admite $search, $filter, $orderBy. Esta propiedad es de sólo lectura. Heredado de mobileAppRelationship
targetDisplayVersion Cadena La versión de visualización de la aplicación que es el destino de la entidad de relación de aplicación móvil. Por ejemplo, 1.0 o 1.2203.156. Solo lectura. Se devuelve de forma predeterminada. Soportes: $select. No admite $search, $filter, $orderBy. Esta propiedad es de sólo lectura. Heredado de mobileAppRelationship
targetPublisher Cadena El publicador de la aplicación que es el destino de la entidad de relación de aplicación móvil. Por ejemplo: Fabrikam. La longitud máxima es de 500 caracteres. Solo lectura. Se devuelve de forma predeterminada. Soportes: $select. No admite $search, $filter, $orderBy. Esta propiedad es de sólo lectura. Heredado de mobileAppRelationship
targetPublisherDisplayName Cadena El nombre para mostrar del publicador de la aplicación que es el destino de la entidad de relación de aplicación móvil. Por ejemplo: Fabrikam. La longitud máxima es de 500 caracteres. Solo lectura. Soportes: $select. No admite $search, $filter, $orderBy. Esta propiedad es de sólo lectura. Heredado de mobileAppRelationship
sourceId Cadena El identificador de aplicación único del origen de la entidad de relación de aplicación móvil. Por ejemplo: 2dbc75b9-e993-4e4d-a071-91ac5a218672. Si es null durante la creación de la relación, se rellenará con el id. primario. Solo lectura. Soportes: $select. No admite $search, $filter, $orderBy. Esta propiedad es de sólo lectura. Heredado de mobileAppRelationship
sourceDisplayName Cadena El nombre para mostrar de la aplicación que es el origen de la entidad de relación aplicación móvil. Por ejemplo: Orca. La longitud máxima es de 500 caracteres. Solo lectura. Soportes: $select. No admite $search, $filter, $orderBy. Esta propiedad es de sólo lectura. Heredado de mobileAppRelationship
sourceDisplayVersion Cadena La versión de visualización de la aplicación que es el origen de la entidad de relación de aplicación móvil. Por ejemplo, 1.0.12, 1.2203.156 o 3. Solo lectura. Soportes: $select. No admite $search, $filter, $orderBy. Esta propiedad es de sólo lectura. Heredado de mobileAppRelationship
sourcePublisherDisplayName Cadena El nombre para mostrar del publicador de la aplicación que es el origen de la entidad de relación de aplicación móvil. Por ejemplo: Fabrikam. La longitud máxima es de 500 caracteres. Solo lectura. Soportes: $select. No admite $search, $filter, $orderBy. Esta propiedad es de sólo lectura. Heredado de mobileAppRelationship
targetType mobileAppRelationshipType Tipo de relación que indica si la aplicación de destino de una relación es una relación principal o secundaria en la relación. Los valores posibles son: primario, secundario. Solo lectura. Se devuelve de forma predeterminada. Soportes: $select, $filter. No admite $search, $orderBy. Esta propiedad es de sólo lectura. Heredado de mobileAppRelationship. Los valores posibles son: child, parent y unknownFutureValue.
supersedenceType mobileAppSupersedenceType El tipo de relación de sustitución entre las aplicaciones principales y secundarias. Los valores posibles son: actualizar, reemplazar. Solo lectura. Los valores posibles son: update, replace y unknownFutureValue.
supersededAppCount Int32 El número total de aplicaciones sustituidas directa o indirectamente por la aplicación secundaria. Solo lectura. Esta propiedad es de sólo lectura.
supersedingAppCount Int32 El número total de aplicaciones que sustituyen directa o indirectamente a la aplicación principal. Solo lectura. Esta propiedad es de sólo lectura.

Respuesta

Si se realiza correctamente, este método devuelve un 201 Created código de respuesta y un objeto mobileAppSupersedence en el cuerpo de la respuesta.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

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

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

Respuesta

Aquí tiene un ejemplo de la respuesta. Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar. Todas las propiedades se devolverán desde una llamada real.

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

{
  "@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",
  "targetPublisherDisplayName": "Target Publisher Display Name value",
  "sourceId": "Source Id value",
  "sourceDisplayName": "Source Display Name value",
  "sourceDisplayVersion": "Source Display Version value",
  "sourcePublisherDisplayName": "Source Publisher Display Name value",
  "targetType": "parent",
  "supersedenceType": "replace",
  "supersededAppCount": 2,
  "supersedingAppCount": 3
}
  • Se actualizó por última vez el