Criar deviceManagementPartner

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

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

POST /deviceManagement/deviceManagementPartners

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

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

Propriedade	Tipo	Descrição
id	String	ID da entidade
lastHeartbeatDateTime	DateTimeOffset	Carimbo de data/hora da última pulsação após a opção de administrador habilitado conectar-se ao parceiro de gerenciamento de dispositivo
partnerState	deviceManagementPartnerTenantState	Estado do parceiro desse locatário. Os possíveis valores são: unknown, unavailable, enabled, terminated, rejected, unresponsive.
partnerAppType	deviceManagementPartnerAppType	Tipo de aplicativo parceiro. Os valores possíveis são: unknown, singleTenantApp, multiTenantApp.
singleTenantAppId	Cadeia de caracteres	Id do aplicativo do único locatário do parceiro
displayName	String	Nome de exibição de parceiro
isConfigured	Booliano	Se o parceiro de gerenciamento de dispositivo está configurado ou não
whenPartnerDevicesWillBeRemovedDateTime	DateTimeOffset	DateTime no UTC quando PartnerDevices for removido
whenPartnerDevicesWillBeMarkedAsNonCompliantDateTime	DateTimeOffset	DateTime no UTC quando PartnerDevices for marcado como não compatível

Resposta

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

Exemplo

Solicitação

Este é um exemplo da solicitação.

POST https://graph.microsoft.com/v1.0/deviceManagement/deviceManagementPartners
Content-type: application/json
Content-length: 502

{
  "@odata.type": "#microsoft.graph.deviceManagementPartner",
  "lastHeartbeatDateTime": "2016-12-31T23:59:37.9174975-08:00",
  "partnerState": "unavailable",
  "partnerAppType": "singleTenantApp",
  "singleTenantAppId": "Single Tenant App Id value",
  "displayName": "Display Name value",
  "isConfigured": true,
  "whenPartnerDevicesWillBeRemovedDateTime": "2016-12-31T23:56:38.2655023-08:00",
  "whenPartnerDevicesWillBeMarkedAsNonCompliantDateTime": "2016-12-31T23:58:42.2131231-08:00"
}

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

{
  "@odata.type": "#microsoft.graph.deviceManagementPartner",
  "id": "d21e377a-377a-d21e-7a37-1ed27a371ed2",
  "lastHeartbeatDateTime": "2016-12-31T23:59:37.9174975-08:00",
  "partnerState": "unavailable",
  "partnerAppType": "singleTenantApp",
  "singleTenantAppId": "Single Tenant App Id value",
  "displayName": "Display Name value",
  "isConfigured": true,
  "whenPartnerDevicesWillBeRemovedDateTime": "2016-12-31T23:56:38.2655023-08:00",
  "whenPartnerDevicesWillBeMarkedAsNonCompliantDateTime": "2016-12-31T23:58:42.2131231-08:00"
}