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
Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.
Actualice las propiedades de un objeto iosVppApp.
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, especifique una representación JSON del objeto iosVppApp.
En la tabla siguiente se muestran las propiedades necesarias para crear el objeto iosVppApp.
| 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. |
| 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, published. |
| 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. |
| applicableDeviceType | iosDeviceType | Tipo de dispositivo iOS aplicable. |
| 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, education. Los valores posibles son: business, education. |
| vppTokenAppleId | Cadena | Identificador de Apple asociado al token del Programa de Compras por Volumen de Apple especificado. |
| vppTokenDisplayName | Cadena | Nombre para mostrar del token de VPP asociado a esta aplicación. |
| bundleId | Cadena | Nombre de la identidad. |
Respuesta
Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y un objeto iosVppApp actualizado en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
PATCH https://graph.microsoft.com/v1.0/deviceAppManagement/mobileApps/{mobileAppId}
Content-type: application/json
Content-length: 1280
{
"@odata.type": "#microsoft.graph.iosVppApp",
"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",
"publishingState": "processing",
"usedLicenseCount": 0,
"totalLicenseCount": 1,
"releaseDateTime": "2017-01-01T00:01:34.7470482-08:00",
"appStoreUrl": "https://example.com/appStoreUrl/",
"licensingType": {
"@odata.type": "microsoft.graph.vppLicensingType",
"supportsUserLicensing": true,
"supportsDeviceLicensing": true
},
"applicableDeviceType": {
"@odata.type": "microsoft.graph.iosDeviceType",
"iPad": true,
"iPhoneAndIPod": true
},
"vppTokenOrganizationName": "Vpp Token Organization Name value",
"vppTokenAccountType": "education",
"vppTokenAppleId": "Vpp Token Apple Id value",
"vppTokenDisplayName": "Vpp Token Display Name value",
"bundleId": "Bundle Id value"
}
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: 1452
{
"@odata.type": "#microsoft.graph.iosVppApp",
"id": "a0ac9b6f-9b6f-a0ac-6f9b-aca06f9baca0",
"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",
"publishingState": "processing",
"usedLicenseCount": 0,
"totalLicenseCount": 1,
"releaseDateTime": "2017-01-01T00:01:34.7470482-08:00",
"appStoreUrl": "https://example.com/appStoreUrl/",
"licensingType": {
"@odata.type": "microsoft.graph.vppLicensingType",
"supportsUserLicensing": true,
"supportsDeviceLicensing": true
},
"applicableDeviceType": {
"@odata.type": "microsoft.graph.iosDeviceType",
"iPad": true,
"iPhoneAndIPod": true
},
"vppTokenOrganizationName": "Vpp Token Organization Name value",
"vppTokenAccountType": "education",
"vppTokenAppleId": "Vpp Token Apple Id value",
"vppTokenDisplayName": "Vpp Token Display Name value",
"bundleId": "Bundle Id value"
}