Criar vppToken
Namespace: microsoft.graph
Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; a utilização de produção não é suportada.
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.
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) | 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 possíveis valores são: unknown , valid , expired , invalid , assignedToExternalMDM , duplicateLocationId . |
tokenActionResults | coleção vppTokenActionResult | A coleção de estados das ações executadas no Token do Programa de Compra em Volume da Apple. |
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. |
dataSharingConsentGranted | Booliano | Consentimento concedido para partilha de dados com o Apple Volume Purchase Program. |
displayName | Cadeia de caracteres | Um nome amigável de token especificado pelo administrador. |
locationName | Cadeia de caracteres | Localização do token devolvida a partir do Apple VPP. |
claimTokenManagementFromExternalMdm | Booliano | Consentimento do administrador para permitir a gestão de tokens de afirmação a partir da MDM externa. |
roleScopeTagIds | Coleção de cadeias de caracteres | IDs de Etiquetas de Âmbito de Função atribuídos a esta entidade. |
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.
POST https://graph.microsoft.com/beta/deviceAppManagement/vppTokens
Content-type: application/json
Content-length: 1002
{
"@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",
"tokenActionResults": [
{
"@odata.type": "microsoft.graph.vppTokenActionResult",
"actionName": "Action Name value",
"actionState": "pending",
"startDateTime": "2016-12-31T23:58:46.7156189-08:00",
"lastUpdatedDateTime": "2017-01-01T00:00:56.8321556-08:00"
}
],
"lastSyncStatus": "inProgress",
"automaticallyUpdateApps": true,
"countryOrRegion": "Country Or Region value",
"dataSharingConsentGranted": true,
"displayName": "Display Name value",
"locationName": "Location Name value",
"claimTokenManagementFromExternalMdm": true,
"roleScopeTagIds": [
"Role Scope Tag Ids 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: 1115
{
"@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",
"tokenActionResults": [
{
"@odata.type": "microsoft.graph.vppTokenActionResult",
"actionName": "Action Name value",
"actionState": "pending",
"startDateTime": "2016-12-31T23:58:46.7156189-08:00",
"lastUpdatedDateTime": "2017-01-01T00:00:56.8321556-08:00"
}
],
"lastSyncStatus": "inProgress",
"automaticallyUpdateApps": true,
"countryOrRegion": "Country Or Region value",
"dataSharingConsentGranted": true,
"displayName": "Display Name value",
"locationName": "Location Name value",
"claimTokenManagementFromExternalMdm": true,
"roleScopeTagIds": [
"Role Scope Tag Ids value"
]
}