Atualizar vppToken

Namespace: microsoft.graph

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

Atualizar as propriedades de um objeto vppToken.

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)	DeviceManagementServiceConfig.ReadWrite.All
Delegada (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	DeviceManagementServiceConfig.ReadWrite.All

Solicitação HTTP

PATCH /deviceAppManagement/vppTokens/{vppTokenId}

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

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

Propriedade	Tipo	Descrição
id	String	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 tiver êxito, este método retornará um código de resposta 200 OK e um objeto vppToken atualizado no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

PATCH https://graph.microsoft.com/v1.0/deviceAppManagement/vppTokens/{vppTokenId}
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"
}

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 200 OK
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"
}