Créer macOsVppApp

Article
08/01/2024

Espace de noms: microsoft.graph

Important: Les API Microsoft Graph sous la version /beta sont susceptibles d’être modifiées ; l’utilisation de production n’est pas prise en charge.

Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.

Créez un objet macOsVppApp .

Cette API est disponible dans les déploiements de cloud national suivants.

Service global	Gouvernement des États-Unis L4	Us Government L5 (DOD)	Chine gérée par 21Vianet
✅	✅	✅	✅

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation	Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire)	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All
Déléguée (compte Microsoft personnel)	Non prise en charge.
Application	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All

Requête HTTP

POST /deviceAppManagement/mobileApps

En-têtes de demande

En-tête	Valeur
Autorisation	Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Accepter	application/json

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON pour l’objet macOsVppApp.

Le tableau suivant indique les propriétés requises lorsque vous créez l’application macOsVppApp.

Propriété	Type	Description
id	String	Clé de l’entité. Cette propriété est en lecture seule. Hérité de mobileApp.
displayName	String	Titre de l’application, importé ou fourni par l’administrateur. Hérité de mobileApp.
description	String	Description de l’application. Hérité de mobileApp.
éditeur	String	Éditeur de l’application. Hérité de mobileApp.
largeIcon	mimeContent	Grande icône, à afficher dans les détails de l’application et permettant de télécharger l’icône. Hérité de mobileApp.
createdDateTime	DateTimeOffset	Date et heure de création de l’application. Cette propriété est en lecture seule. Hérité de mobileApp.
lastModifiedDateTime	DateTimeOffset	Date et heure de la dernière modification de l’application. Cette propriété est en lecture seule. Hérité de mobileApp.
isFeaturedisFeatured	Booléen	Valeur indiquant si l’application est marquée comme recommandée par l’administrateur- Hérité de mobileApp.
privacyInformationUrl	String	URL de déclaration de confidentialité. Hérité de mobileApp.
informationUrl	String	URL pour plus d’informations. Hérité de mobileApp.
owner	String	Propriétaire de l’application. Hérité de mobileApp.
developer	String	Développeur de l’application. Hérité de mobileApp.
notes	String	Notes de l’application. Hérité de mobileApp.
uploadState	Int32	État de chargement. Les valeurs possibles sont : 0 - `Not Ready`, 1 - `Ready`, 2 - `Processing`. Cette propriété est en lecture seule. Hérité de mobileApp.
publishingState	mobileAppPublishingState	État de publication pour l’application. L’application ne peut pas être affectée, sauf si elle est publiée. Cette propriété est en lecture seule. Hérité de mobileApp. Les valeurs possibles sont `notPublished`, `processing` et `published`.
isAssigned	Boolean	Valeur indiquant si l’application est affectée à au moins un groupe. Cette propriété est en lecture seule. Hérité de mobileApp.
roleScopeTagIds	String collection	Liste des ID de balise d’étendue pour cette application mobile. Hérité de mobileApp.
dependentAppCount	Int32	Nombre total de dépendances de l’application enfant. Cette propriété est en lecture seule. Hérité de mobileApp.
supersedingAppCount	Int32	Nombre total d’applications que cette application remplace directement ou indirectement. Cette propriété est en lecture seule. Hérité de mobileApp.
supersededAppCount	Int32	Nombre total d’applications par laquelle cette application est remplacée directement ou indirectement. Cette propriété est en lecture seule. Hérité de mobileApp.
usedLicenseCount	Int32	Nombre de licences VPP en cours d’utilisation.
totalLicenseCount	Int32	Nombre total de licences VPP.
releaseDateTime	DateTimeOffset	Date et heure de publication d’application VPP.
appStoreUrl	String	URL de la boutique.
licensingType	vppLicensingType	Type de licence pris en charge.
vppTokenOrganizationName	String	Organisation associée au jeton du programme d’achat en volume d’Apple
vppTokenAccountType	vppTokenAccountType	Type de programme d’achat en volume auquel est associé le jeton du programme d’achat en volume Apple donné. Les valeurs possibles sont les suivantes : `business` et `education`. Les valeurs possibles sont les suivantes : `business` et `education`.
vppTokenAppleId	String	Identifiant Apple associé jeton du programme d’achat en volume Apple donné.
bundleId	String	Nom d’identité.
vppTokenId	String	Identificateur du jeton VPP associé à cette application.
revokeLicenseActionResults	Collection macOsVppAppRevokeLicensesActionResult	Résultats des actions de révocation de licence sur cette application.

Réponse

Si elle réussit, cette méthode renvoie un 201 Created code de réponse et un objet macOsVppApp dans le corps de la réponse.

Exemple

Demande

Voici un exemple de demande.

POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps
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"
    }
  ]
}

Réponse

Voici un exemple de réponse. Remarque : l’objet de réponse illustré ici peut être tronqué à des fins de concision. Toutes les propriétés sont renvoyées à partir d’un appel réel.

HTTP/1.1 201 Created
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"
    }
  ]
}

Partager via

Créer macOsVppApp

Autorisations

Requête HTTP

En-têtes de demande

Corps de la demande

Réponse

Exemple

Demande

Réponse

Commentaires

Ressources supplémentaires