Actualizar macOsVppApp
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 macOsVppApp .
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/mobileApps/{mobileAppId}
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 macOsVppApp .
En la tabla siguiente se muestran las propiedades necesarias al crear macOsVppApp.
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | Cadena | Clave de la entidad. Esta propiedad es de sólo lectura. Heredado de mobileApp. |
| displayName | Cadena | Título de la aplicación importado o proporcionado por el administrador. Heredado de mobileApp. |
| description | Cadena | Descripción de la aplicación. Heredado de mobileApp. |
| publicador | Cadena | Publicador de la aplicación. Heredado de mobileApp. |
| largeIcon | mimeContent | Icono grande que se mostrará en los detalles de la aplicación y se usa para cargar el icono. Heredado de mobileApp. |
| createdDateTime | DateTimeOffset | Fecha y hora de creación de la aplicación. Esta propiedad es de sólo lectura. Heredado de mobileApp. |
| lastModifiedDateTime | DateTimeOffset | Fecha y hora de la última modificación de la aplicación. Esta propiedad es de sólo lectura. Heredado de mobileApp. |
| isFeatured | Booleano | Valor que indica si el administrador ha marcado la aplicación como destacada. Heredado de mobileApp. |
| privacyInformationUrl | Cadena | Dirección URL de la declaración de privacidad. Heredado de mobileApp. |
| informationUrl | Cadena | Dirección URL para obtener más información. Heredado de mobileApp. |
| owner | Cadena | Propietario de la aplicación. Heredado de mobileApp. |
| developer | Cadena | Desarrollador de la aplicación. Heredado de mobileApp. |
| notas | Cadena | Notas de la aplicación. Heredado de mobileApp. |
| uploadState | Int32 | Estado de carga. Los valores posibles son: 0 - Not Ready, 1 - Ready, 2 - Processing. Esta propiedad es de sólo lectura. Heredado de mobileApp. |
| publishingState | mobileAppPublishingState | Estado de publicación de la aplicación. La aplicación no puede asignarse a menos que se publique. Esta propiedad es de sólo lectura. Se hereda de mobileApp. Los valores posibles son: notPublished, processing y published. |
| isAssigned | Booleano | Valor que indica si la aplicación está asignada a al menos un grupo. Esta propiedad es de sólo lectura. Heredado de mobileApp. |
| roleScopeTagIds | Colección string | Lista de identificadores de etiqueta de ámbito para esta aplicación móvil. Heredado de mobileApp. |
| dependentAppCount | Int32 | Número total de dependencias que tiene la aplicación secundaria. Esta propiedad es de sólo lectura. Heredado de mobileApp. |
| supersedingAppCount | Int32 | El número total de aplicaciones que esta aplicación reemplaza directa o indirectamente. Esta propiedad es de sólo lectura. Heredado de mobileApp. |
| supersededAppCount | Int32 | El número total de aplicaciones por las que esta aplicación se reemplaza directa o indirectamente. Esta propiedad es de sólo lectura. Heredado de mobileApp. |
| usedLicenseCount | Int32 | Número de licencias VPP en uso. |
| totalLicenseCount | Int32 | Número total de licencias VPP. |
| releaseDateTime | DateTimeOffset | Fecha y hora de publicación de la aplicación de VPP. |
| appStoreUrl | Cadena | Dirección URL de la tienda. |
| licensingType | vppLicensingType | Tipo de licencia compatible. |
| vppTokenOrganizationName | Cadena | Organización asociada al token del Programa de Compras por Volumen de Apple |
| vppTokenAccountType | vppTokenAccountType | Tipo de programa de compras por volumen al que está asociado el token del Programa de Compras por Volumen de Apple especificado. Los valores posibles son: business y education. Los valores posibles son: business y education. |
| vppTokenAppleId | Cadena | Identificador de Apple asociado al token del Programa de Compras por Volumen de Apple especificado. |
| bundleId | Cadena | Nombre de la identidad. |
| vppTokenId | Cadena | Identificador del token de VPP asociado a esta aplicación. |
| revokeLicenseActionResults | colección macOsVppAppRevokeLicensesActionResult | Resultados de las acciones de revocación de licencia en esta aplicación. |
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto macOsVppApp actualizado en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}
Content-type: application/json
Content-length: 1926
{
"@odata.type": "#microsoft.graph.macOsVppApp",
"displayName": "Display Name value",
"description": "Description value",
"publisher": "Publisher value",
"largeIcon": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"isFeatured": true,
"privacyInformationUrl": "https://example.com/privacyInformationUrl/",
"informationUrl": "https://example.com/informationUrl/",
"owner": "Owner value",
"developer": "Developer value",
"notes": "Notes value",
"uploadState": 11,
"publishingState": "processing",
"isAssigned": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"dependentAppCount": 1,
"supersedingAppCount": 3,
"supersededAppCount": 2,
"usedLicenseCount": 0,
"totalLicenseCount": 1,
"releaseDateTime": "2017-01-01T00:01:34.7470482-08:00",
"appStoreUrl": "https://example.com/appStoreUrl/",
"licensingType": {
"@odata.type": "microsoft.graph.vppLicensingType",
"supportUserLicensing": true,
"supportDeviceLicensing": true,
"supportsUserLicensing": true,
"supportsDeviceLicensing": true
},
"vppTokenOrganizationName": "Vpp Token Organization Name value",
"vppTokenAccountType": "education",
"vppTokenAppleId": "Vpp Token Apple Id value",
"bundleId": "Bundle Id value",
"vppTokenId": "Vpp Token Id value",
"revokeLicenseActionResults": [
{
"@odata.type": "microsoft.graph.macOsVppAppRevokeLicensesActionResult",
"userId": "User Id value",
"managedDeviceId": "Managed Device Id value",
"totalLicensesCount": 2,
"failedLicensesCount": 3,
"actionFailureReason": "appleFailure",
"actionName": "Action Name value",
"actionState": "pending",
"startDateTime": "2016-12-31T23:58:46.7156189-08:00",
"lastUpdatedDateTime": "2017-01-01T00:00:56.8321556-08:00"
}
]
}
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: 2098
{
"@odata.type": "#microsoft.graph.macOsVppApp",
"id": "10b95265-5265-10b9-6552-b9106552b910",
"displayName": "Display Name value",
"description": "Description value",
"publisher": "Publisher value",
"largeIcon": {
"@odata.type": "microsoft.graph.mimeContent",
"type": "Type value",
"value": "dmFsdWU="
},
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"isFeatured": true,
"privacyInformationUrl": "https://example.com/privacyInformationUrl/",
"informationUrl": "https://example.com/informationUrl/",
"owner": "Owner value",
"developer": "Developer value",
"notes": "Notes value",
"uploadState": 11,
"publishingState": "processing",
"isAssigned": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"dependentAppCount": 1,
"supersedingAppCount": 3,
"supersededAppCount": 2,
"usedLicenseCount": 0,
"totalLicenseCount": 1,
"releaseDateTime": "2017-01-01T00:01:34.7470482-08:00",
"appStoreUrl": "https://example.com/appStoreUrl/",
"licensingType": {
"@odata.type": "microsoft.graph.vppLicensingType",
"supportUserLicensing": true,
"supportDeviceLicensing": true,
"supportsUserLicensing": true,
"supportsDeviceLicensing": true
},
"vppTokenOrganizationName": "Vpp Token Organization Name value",
"vppTokenAccountType": "education",
"vppTokenAppleId": "Vpp Token Apple Id value",
"bundleId": "Bundle Id value",
"vppTokenId": "Vpp Token Id value",
"revokeLicenseActionResults": [
{
"@odata.type": "microsoft.graph.macOsVppAppRevokeLicensesActionResult",
"userId": "User Id value",
"managedDeviceId": "Managed Device Id value",
"totalLicensesCount": 2,
"failedLicensesCount": 3,
"actionFailureReason": "appleFailure",
"actionName": "Action Name value",
"actionState": "pending",
"startDateTime": "2016-12-31T23:58:46.7156189-08:00",
"lastUpdatedDateTime": "2017-01-01T00:00:56.8321556-08:00"
}
]
}
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de