Criar deviceManagementIntent

Namespace: microsoft.graph

Importante: As APIs Graph Microsoft na versão /beta estão sujeitas a alterações; não há suporte para uso de produção.

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

Crie um novo objeto deviceManagementIntent.

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)
Delegado (conta corporativa ou de estudante) DeviceManagementConfiguration.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Aplicativo DeviceManagementConfiguration.ReadWrite.All

Solicitação HTTP

POST /deviceManagement/intents

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, fornece uma representação JSON para o objeto deviceManagementIntent.

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

Propriedade Tipo Descrição
id Cadeia de caracteres A ID de intenção
displayName Cadeia de caracteres O nome de exibição dado pelo usuário
description Cadeia de caracteres A descrição dada pelo usuário
isAssigned Boolean Significa se a intenção é atribuída ou não aos usuários
lastModifiedDateTime DateTimeOffset Quando a intenção foi modificada pela última vez
templateId Cadeia de Caracteres A ID do modelo de que essa intenção foi criada (se alguma)
roleScopeTagIds String collection Lista de marcas de escopo para esta instância entity.

Resposta

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

Exemplo

Solicitação

Este é um exemplo da solicitação.

POST https://graph.microsoft.com/beta/deviceManagement/intents
Content-type: application/json
Content-length: 266

{
  "@odata.type": "#microsoft.graph.deviceManagementIntent",
  "displayName": "Display Name value",
  "description": "Description value",
  "isAssigned": true,
  "templateId": "Template Id value",
  "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: 379

{
  "@odata.type": "#microsoft.graph.deviceManagementIntent",
  "id": "f972c33e-c33e-f972-3ec3-72f93ec372f9",
  "displayName": "Display Name value",
  "description": "Description value",
  "isAssigned": true,
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "templateId": "Template Id value",
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ]
}