Criar iosVppApp

Namespace: microsoft.graph

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.

Cria um novo objeto iosVppApp.

Pré-requisitos

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegada (conta corporativa ou de estudante) DeviceManagementApps.ReadWrite.All
Delegada (conta pessoal da Microsoft) Sem suporte.
Aplicativo DeviceManagementApps.ReadWrite.All

Solicitação HTTP

POST /deviceAppManagement/mobileApps

Cabeçalhos de solicitação

Cabeçalho Valor
Autorização <Token> de portador obrigatório.
Aceitar application/json

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON do objeto iosVppApp.

A tabela a seguir mostra as propriedades obrigatórias ao criar iosVppApp.

Propriedade Tipo Descrição
id String Chave da entidade. Herdado de mobileApp
displayName String O título do aplicativo importado ou definido pelo administrador. Herdado de mobileApp
description String A descrição do aplicativo. Herdado de mobileApp
publicador String O publicador do aplicativo. Herdado de mobileApp
largeIcon mimeContent O ícone grande, a ser exibido nos detalhes do aplicativo e usado para o carregamento do ícone. Herdado de mobileApp
createdDateTime DateTimeOffset A data e a hora da criação do aplicativo. Herdado de mobileApp
lastModifiedDateTime DateTimeOffset A data e a hora que o aplicativo foi modificado pela última vez. Herdado de mobileApp
isFeatured Boolean O valor que indica se o aplicativo está marcado como em destaque pelo administrador. Herdado de mobileApp
privacyInformationUrl String A URL da declaração de privacidade. Herdado de mobileApp
informationUrl String A URL de informações adicionais. Herdado de mobileApp
owner String O proprietário do conteúdo. Herdado de mobileApp
developer String O desenvolvedor do aplicativo. Herdado de mobileApp
notes String Anotações do aplicativo. Herdado de mobileApp
publishingState mobileAppPublishingState O estado de publicação do aplicativo. O aplicativo não pode ser assinado, a menos que ele seja publicado. Herdado do mobileApp. Os valores possíveis são: notPublished, processing, published.
usedLicenseCount Int32 O número de aplicativos VPP em uso.
totalLicenseCount Int32 O número total de licenças VPP.
releaseDateTime DateTimeOffset A data e a hora de lançamento do aplicativo VPP.
appStoreUrl String A URL da loja.
licensingType vppLicensingType O tipo de licença com suporte.
applicableDeviceType iosDeviceType O tipo de dispositivo iOS aplicável.
vppTokenOrganizationName String A organização associada ao Token do Programa de Compra por Volume da Apple
vppTokenAccountType vppTokenAccountType O tipo de programa de compra por volume ao qual o Token do Programa de Compra por Volume da Apple especificado está associado. Os valores possíveis são: business, education. Os valores possíveis são: business, education.
vppTokenAppleId String O Apple Id associado ao Token do Programa de Compra de Volume da Apple.
bundleId String O Nome da Identidade.

Resposta

Se tiver êxito, este método retornará o código de resposta 201 Created e o objeto iosVppApp no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

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

{
  "@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",
  "bundleId": "Bundle Id value"
}

Resposta

Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada real.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1394

{
  "@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",
  "bundleId": "Bundle Id value"
}