Compartir a través de

Crear vppToken

Espacio de nombres: microsoft.graph

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

Crea un nuevo objeto vppToken.

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) DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida.
Aplicación DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All

Solicitud HTTP

POST /deviceAppManagement/vppTokens

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 vppToken.

En la tabla siguiente se muestran las propiedades necesarias para crear el vppToken.

Propiedad Tipo Descripción
id Cadena Esto se genera automáticamente cuando se crea el appleVolumePurchaseProgramToken. Es la clave de la entidad.
organizationName 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.
Id. de Apple Cadena Identificador de Apple asociado al token del Programa de compras por volumen de Apple especificado.
expirationDateTime DateTimeOffset La fecha y hora de vencimiento del token del Programa de compras por volumen de Apple.
lastSyncDateTime DateTimeOffset La última vez que se realizó la sincronización de una aplicación con el servicio del programa de compras por volumen de Apple utilizando el token de dicho programa de compras.
token Cadena La cadena del token del programa de compras por volumen de Apple descargada desde ese programa de compras.
lastModifiedDateTime DateTimeOffset La fecha y hora de modificación asociada con el token del Programa de compras por volumen de Apple.
state vppTokenState Estado actual del token del Programa de compras por volumen de Apple. Los valores posibles son: unknown, valid, expired, invalid, assignedToExternalMDM. Los valores posibles son: unknown, valid, expired, invalid, assignedToExternalMDM.
lastSyncStatus vppTokenSyncStatus Estado de sincronización actual de la última sincronización de la aplicación que se activó con el Token del programa de compras por volumen de Apple. Los valores posibles son: none, inProgress, completed y failed Los valores posibles son: none, inProgress, completed y failed
automaticallyUpdateApps Booleano Si las aplicaciones para el token VPP se actualizarán automáticamente o no.
countryOrRegion Cadena Si las aplicaciones para el token VPP se actualizarán automáticamente o no.
lastAppCount Int32 Número de aplicaciones en el token del programa de compras por volumen de Apple desde la última sincronización de tokens.

Respuesta

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

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

POST https://graph.microsoft.com/v1.0/deviceAppManagement/vppTokens
Content-type: application/json
Content-length: 484

{
  "@odata.type": "#microsoft.graph.vppToken",
  "organizationName": "Organization Name value",
  "vppTokenAccountType": "education",
  "appleId": "Apple Id value",
  "expirationDateTime": "2016-12-31T23:57:57.2481234-08:00",
  "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
  "token": "Token value",
  "state": "valid",
  "lastSyncStatus": "inProgress",
  "automaticallyUpdateApps": true,
  "countryOrRegion": "Country Or Region value",
  "lastAppCount": 12
}

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: 597

{
  "@odata.type": "#microsoft.graph.vppToken",
  "id": "9ceb2f92-2f92-9ceb-922f-eb9c922feb9c",
  "organizationName": "Organization Name value",
  "vppTokenAccountType": "education",
  "appleId": "Apple Id value",
  "expirationDateTime": "2016-12-31T23:57:57.2481234-08:00",
  "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
  "token": "Token value",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "state": "valid",
  "lastSyncStatus": "inProgress",
  "automaticallyUpdateApps": true,
  "countryOrRegion": "Country Or Region value",
  "lastAppCount": 12
}
  • Last updated on