Actualización de mobileAppSupersedence
Espacio de nombres: microsoft.graph
Importante: Las API de Microsoft Graph en la versión /beta están sujetas a cambios; no se admite el uso de producción.
Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.
Actualice las propiedades de un objeto mobileAppSupersedence .
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada 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
PATCH /deviceAppManagement/mobileAppRelationships/{mobileAppRelationshipId}
PATCH /deviceAppManagement/mobileApps/{mobileAppId}/relationships/{mobileAppRelationshipId}
Encabezados de solicitud
| Encabezado | Valor |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la 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 al crear mobileAppSupersedence.
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | Cadena | Identificador único de la entidad de relación de aplicación móvil. Esto se asigna en la creación de entidades MobileAppRelationship. Por ejemplo: 2dbc75b9-e993-4e4d-a071-91ac5a218672_43aaaf35-ce51-4695-9447-5eac6df31161. Solo lectura. Se devuelve por defecto. Admite: $select. No admite $search, $filter, $orderBy. Heredado de mobileAppRelationship |
| targetId | Cadena | 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. Admite: $select. No admite $search, $filter, $orderBy. Heredado de mobileAppRelationship |
| targetDisplayName | Cadena | Nombre para mostrar de la aplicación que es el destino de la entidad de relación de la aplicación móvil. Por ejemplo: Firefox Setup 52.0.2 32bit.intunewin. La longitud máxima es de 500 caracteres. Solo lectura. Se devuelve de forma predeterminada. Admite: $select. No admite $search, $filter, $orderBy. Esta propiedad es de sólo lectura. Heredado de mobileAppRelationship |
| targetDisplayVersion | Cadena | La versión para mostrar de la aplicación que es el destino de la entidad de relación de la aplicación móvil. Por ejemplo, 1.0 o 1.2203.156. Solo lectura. Se devuelve de forma predeterminada. Admite: $select. No admite $search, $filter, $orderBy. Esta propiedad es de sólo lectura. Heredado de mobileAppRelationship |
| targetPublisher | Cadena | Publicador de la aplicación que es el destino de la entidad de relación de la aplicación móvil. Por ejemplo: Fabrikam. La longitud máxima es de 500 caracteres. Solo lectura. Se devuelve de forma predeterminada. Admite: $select. No admite $search, $filter, $orderBy. Esta propiedad es de sólo lectura. Heredado de mobileAppRelationship |
| targetPublisherDisplayName | Cadena | Nombre para mostrar del publicador de la aplicación que es el destino de la entidad de relación de la aplicación móvil. Por ejemplo: Fabrikam. La longitud máxima es de 500 caracteres. Solo lectura. Admite: $select. No admite $search, $filter, $orderBy. Esta propiedad es de sólo lectura. Heredado de mobileAppRelationship |
| sourceId | Cadena | Identificador de aplicación único del origen de la entidad de relación de la 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 identificador primario. Solo lectura. Admite: $select. No admite $search, $filter, $orderBy. Esta propiedad es de sólo lectura. Heredado de mobileAppRelationship |
| sourceDisplayName | Cadena | Nombre para mostrar de la aplicación que es el origen de la entidad de relación de la aplicación móvil. Por ejemplo: Orca. La longitud máxima es de 500 caracteres. Solo lectura. Admite: $select. No admite $search, $filter, $orderBy. Esta propiedad es de sólo lectura. Heredado de mobileAppRelationship |
| sourceDisplayVersion | Cadena | La versión para mostrar de la aplicación que es el origen de la entidad de relación de la aplicación móvil. Por ejemplo, 1.0.12 o 1.2203.156 o 3. Solo lectura. Admite: $select. No admite $search, $filter, $orderBy. Esta propiedad es de sólo lectura. Heredado de mobileAppRelationship |
| sourcePublisherDisplayName | Cadena | Nombre para mostrar del publicador de la aplicación que es el origen de la entidad de relación de la aplicación móvil. Por ejemplo: Fabrikam. La longitud máxima es de 500 caracteres. Solo lectura. Admite: $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 primaria o secundaria en la relación. Los valores posibles son: primario, secundario. Solo lectura. Se devuelve de forma predeterminada. Admite: $select, $filter. No admite $search, $orderBy. Esta propiedad es de sólo lectura. Se hereda de mobileAppRelationship. Los valores posibles son: child, parent y unknownFutureValue. |
| supersedenceType | mobileAppSupersedenceType | Tipo de relación de sustitución entre las aplicaciones primarias y secundarias. Los valores posibles son: actualizar, reemplazar. Solo lectura. Los valores posibles son: update, replace y unknownFutureValue. |
| supersededAppCount | Int32 | Número total de aplicaciones reemplazadas 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 supersede directa o indirectamente la aplicación primaria. Solo lectura. Esta propiedad es de sólo lectura. |
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto mobileAppSupersedence actualizado en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileAppRelationships/{mobileAppRelationshipId}
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 200 OK
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
}