Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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.
Crea un nuevo objeto mobileAppDependency .
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 mobileAppDependency.
En la tabla siguiente se muestran las propiedades necesarias para crear la aplicación mobileAppDependency.
| 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. |
| dependencyType | mobileAppDependencyType | Tipo de relación de dependencia entre las aplicaciones principal y secundaria. Los valores posibles son: detectar, autoinstalar. Solo lectura. Los valores posibles son: detect, autoInstall y unknownFutureValue. |
| dependentAppCount | Int32 | El número total de aplicaciones que dependen directa o indirectamente de la aplicación principal. Solo lectura. Esta propiedad es de sólo lectura. |
| dependsOnAppCount | Int32 | El número total de aplicaciones de las que depende directa o indirectamente la aplicación secundaria. 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 mobileAppDependency 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: 662
{
"@odata.type": "#microsoft.graph.mobileAppDependency",
"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",
"dependencyType": "autoInstall",
"dependentAppCount": 1,
"dependsOnAppCount": 1
}
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: 711
{
"@odata.type": "#microsoft.graph.mobileAppDependency",
"id": "c7f6f9ab-f9ab-c7f6-abf9-f6c7abf9f6c7",
"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",
"dependencyType": "autoInstall",
"dependentAppCount": 1,
"dependsOnAppCount": 1
}