Criar vppToken

Namespace: microsoft.graph

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

Criar um novo objeto vppToken.

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global	Governo dos EUA L4	GOVERNO DOS EUA 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)	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Sem suporte.
Application	DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All

Solicitação HTTP

POST /deviceAppManagement/vppTokens

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

A tabela a seguir mostra as propriedades que são necessárias ao criar o vppToken.

Propriedade	Tipo	Descrição
id	Cadeia de caracteres	Isso é gerado automaticamente quando o appleVolumePurchaseProgramToken é criado. É a Chave da entidade.
organizationName	Cadeia de caracteres	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.
appleId	Cadeia de caracteres	O Apple ID associado ao Token do Apple Volume Purchase Program.
expirationDateTime	DateTimeOffset	A data e hora de expiração do Token do Apple Volume Purchase Program.
lastSyncDateTime	DateTimeOffset	A última vez que uma sincronização de aplicativo foi realizada com o serviço do Apple Volume Purchase Program usando o Token do Apple Volume Purchase Program.
token	Cadeia de caracteres	A cadeia de caracteres do Token do Apple Volume Purchase Program baixada do Apple Volume Purchase Program.
lastModifiedDateTime	DateTimeOffset	Data e hora da última modificação associada com o Token do Apple Volume Purchase Program.
state	vppTokenState	Estado atual do Token do Apple Volume Purchase Program. Os valores possíveis são: unknown, valid, expired, invalid, assignedToExternalMDM. Os valores possíveis são: unknown, valid, expired, invalid, assignedToExternalMDM.
lastSyncStatus	vppTokenSyncStatus	Status atual de sincronização da última sincronização de aplicativo que foi feita usando o Token do Apple Volume Purchase Program. Os valores possíveis são: none, inProgress, completed, failed. Os valores possíveis são: none, inProgress, completed, failed.
automaticallyUpdateApps	Boolean	Se os aplicativos para o token VPP serão automaticamente atualizados ou não.
countryOrRegion	Cadeia de caracteres	Se os aplicativos para o token VPP serão automaticamente atualizados ou não.

Resposta

Se bem-sucedido, este método retorna um código de resposta 201 Created e um objeto vppToken no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

HTTP

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

{
  "@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"
}

C#

// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new VppToken
{
	OdataType = "#microsoft.graph.vppToken",
	OrganizationName = "Organization Name value",
	VppTokenAccountType = VppTokenAccountType.Education,
	AppleId = "Apple Id value",
	ExpirationDateTime = DateTimeOffset.Parse("2016-12-31T23:57:57.2481234-08:00"),
	LastSyncDateTime = DateTimeOffset.Parse("2017-01-01T00:02:49.3205976-08:00"),
	Token = "Token value",
	State = VppTokenState.Valid,
	LastSyncStatus = VppTokenSyncStatus.InProgress,
	AutomaticallyUpdateApps = true,
	CountryOrRegion = "Country Or Region value",
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.DeviceAppManagement.VppTokens.PostAsync(requestBody);

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

CLI

mgc device-app-management vpp-tokens create --body '{\
  "@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"\
}\
'

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Ir

// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  "time"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewVppToken()
organizationName := "Organization Name value"
requestBody.SetOrganizationName(&organizationName) 
vppTokenAccountType := graphmodels.EDUCATION_VPPTOKENACCOUNTTYPE 
requestBody.SetVppTokenAccountType(&vppTokenAccountType) 
appleId := "Apple Id value"
requestBody.SetAppleId(&appleId) 
expirationDateTime , err := time.Parse(time.RFC3339, "2016-12-31T23:57:57.2481234-08:00")
requestBody.SetExpirationDateTime(&expirationDateTime) 
lastSyncDateTime , err := time.Parse(time.RFC3339, "2017-01-01T00:02:49.3205976-08:00")
requestBody.SetLastSyncDateTime(&lastSyncDateTime) 
token := "Token value"
requestBody.SetToken(&token) 
state := graphmodels.VALID_VPPTOKENSTATE 
requestBody.SetState(&state) 
lastSyncStatus := graphmodels.INPROGRESS_VPPTOKENSYNCSTATUS 
requestBody.SetLastSyncStatus(&lastSyncStatus) 
automaticallyUpdateApps := true
requestBody.SetAutomaticallyUpdateApps(&automaticallyUpdateApps) 
countryOrRegion := "Country Or Region value"
requestBody.SetCountryOrRegion(&countryOrRegion) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
vppTokens, err := graphClient.DeviceAppManagement().VppTokens().Post(context.Background(), requestBody, nil)

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Java

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

VppToken vppToken = new VppToken();
vppToken.setOdataType("#microsoft.graph.vppToken");
vppToken.setOrganizationName("Organization Name value");
vppToken.setVppTokenAccountType(VppTokenAccountType.Education);
vppToken.setAppleId("Apple Id value");
OffsetDateTime expirationDateTime = OffsetDateTime.parse("2016-12-31T23:57:57.2481234-08:00");
vppToken.setExpirationDateTime(expirationDateTime);
OffsetDateTime lastSyncDateTime = OffsetDateTime.parse("2017-01-01T00:02:49.3205976-08:00");
vppToken.setLastSyncDateTime(lastSyncDateTime);
vppToken.setToken("Token value");
vppToken.setState(VppTokenState.Valid);
vppToken.setLastSyncStatus(VppTokenSyncStatus.InProgress);
vppToken.setAutomaticallyUpdateApps(true);
vppToken.setCountryOrRegion("Country Or Region value");
VppToken result = graphClient.deviceAppManagement().vppTokens().post(vppToken);

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const vppToken = {
  '@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'
};

await client.api('/deviceAppManagement/vppTokens')
	.post(vppToken);

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

PHP

<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\VppToken;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new VppToken();
$requestBody->setOdataType('#microsoft.graph.vppToken');
$requestBody->setOrganizationName('Organization Name value');
$requestBody->setVppTokenAccountType(new VppTokenAccountType('education'));
$requestBody->setAppleId('Apple Id value');
$requestBody->setExpirationDateTime(new \DateTime('2016-12-31T23:57:57.2481234-08:00'));
$requestBody->setLastSyncDateTime(new \DateTime('2017-01-01T00:02:49.3205976-08:00'));
$requestBody->setToken('Token value');
$requestBody->setState(new VppTokenState('valid'));
$requestBody->setLastSyncStatus(new VppTokenSyncStatus('inProgress'));
$requestBody->setAutomaticallyUpdateApps(true);
$requestBody->setCountryOrRegion('Country Or Region value');

$result = $graphServiceClient->deviceAppManagement()->vppTokens()->post($requestBody)->wait();

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

PowerShell

Import-Module Microsoft.Graph.Devices.CorporateManagement

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

New-MgDeviceAppManagementVppToken -BodyParameter $params

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Python

from msgraph import GraphServiceClient
from msgraph.generated.models.vpp_token import VppToken

graph_client = GraphServiceClient(credentials, scopes)

request_body = VppToken(
	odata_type = "#microsoft.graph.vppToken",
	organization_name = "Organization Name value",
	vpp_token_account_type = VppTokenAccountType.Education,
	apple_id = "Apple Id value",
	expiration_date_time = "2016-12-31T23:57:57.2481234-08:00",
	last_sync_date_time = "2017-01-01T00:02:49.3205976-08:00",
	token = "Token value",
	state = VppTokenState.Valid,
	last_sync_status = VppTokenSyncStatus.InProgress,
	automatically_update_apps = True,
	country_or_region = "Country Or Region value",
)

result = await graph_client.device_app_management.vpp_tokens.post(request_body)

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

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

{
  "@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"
}