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.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Uma das seguintes permissões é necessá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)
Delegado (conta corporativa ou de estudante) DeviceManagementApps.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Application DeviceManagementApps.ReadWrite.All

Solicitação HTTP

POST /deviceAppManagement/mobileApps

Cabeçalhos de solicitação

Cabeçalho Valor
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
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"
}