Criar deviceManagementPartnerCreate deviceManagementPartner

Namespace: microsoft.graphNamespace: microsoft.graph

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Criar um novo objeto deviceManagementPartner.Create a new deviceManagementPartner object.

Pré-requisitosPrerequisites

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (de privilégios máximos a mínimos)Permissions (from most to least privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) DeviceManagementServiceConfig.ReadWrite.AllDeviceManagementServiceConfig.ReadWrite.All
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication Sem suporte.Not supported.

Solicitação HTTPHTTP Request

POST /deviceManagement/deviceManagementPartners

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization <Token> de portador obrigatório.Bearer <token> Required.
AceitarAccept application/jsonapplication/json

Corpo da solicitaçãoRequest body

No corpo da solicitação, forneça uma representação JSON do objeto deviceManagementPartner.In the request body, supply a JSON representation for the deviceManagementPartner object.

A tabela a seguir mostra as propriedades que são necessárias ao criar deviceManagementPartner.The following table shows the properties that are required when you create the deviceManagementPartner.

PropriedadeProperty TipoType DescriçãoDescription
idid StringString ID da entidadeId of the entity
lastHeartbeatDateTimelastHeartbeatDateTime DateTimeOffsetDateTimeOffset Carimbo de data/hora da última pulsação após a opção de administrador habilitado conectar-se ao parceiro de gerenciamento de dispositivoTimestamp of last heartbeat after admin enabled option Connect to Device management Partner
partnerStatepartnerState deviceManagementPartnerTenantStatedeviceManagementPartnerTenantState Estado do parceiro desse locatário.Partner state of this tenant. Os possíveis valores são: unknown, unavailable, enabled, terminated, rejected, unresponsive.Possible values are: unknown, unavailable, enabled, terminated, rejected, unresponsive.
partnerAppTypepartnerAppType deviceManagementPartnerAppTypedeviceManagementPartnerAppType Tipo de aplicativo de parceiro.Partner App type. Os valores possíveis são: unknown, singleTenantApp, multiTenantApp.Possible values are: unknown, singleTenantApp, multiTenantApp.
singleTenantAppIdsingleTenantAppId Cadeia de caracteresString Id do aplicativo do único locatário do parceiroPartner Single tenant App id
displayNamedisplayName Cadeia de caracteresString Nome de exibição de parceiroPartner display name
isConfiguredisConfigured BoolianoBoolean Se o parceiro de gerenciamento de dispositivo está configurado ou nãoWhether device management partner is configured or not
whenPartnerDevicesWillBeRemovedDateTimewhenPartnerDevicesWillBeRemovedDateTime DateTimeOffsetDateTimeOffset DateTime no UTC quando PartnerDevices for removidoDateTime in UTC when PartnerDevices will be removed
whenPartnerDevicesWillBeMarkedAsNonCompliantDateTimewhenPartnerDevicesWillBeMarkedAsNonCompliantDateTime DateTimeOffsetDateTimeOffset DateTime no UTC quando PartnerDevices for marcado como não compatívelDateTime in UTC when PartnerDevices will be marked as NonCompliant

RespostaResponse

Se tiver êxito, este método retornará um código de resposta 201 Created e um objeto deviceManagementPartner no corpo da resposta.If successful, this method returns a 201 Created response code and a deviceManagementPartner object in the response body.

ExemploExample

SolicitaçãoRequest

Este é um exemplo da solicitação.Here is an example of the request.

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

RespostaResponse

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.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

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