Actualizar importedDeviceIdentityUpdate importedDeviceIdentity

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Importante: Las API de Microsoft Graph en la versión/beta están sujetas a cambios; no se admite el uso de producción.Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Actualice las propiedades de un objeto importedDeviceIdentity .Update the properties of a importedDeviceIdentity object.

Requisitos previosPrerequisites

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permisoPermission type Permisos (de más a menos privilegiados)Permissions (from most to least privileged)
Delegado (cuenta profesional o educativa)Delegated (work or school account) DeviceManagementServiceConfig.ReadWrite.AllDeviceManagementServiceConfig.ReadWrite.All
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) No admitida.Not supported.
AplicaciónApplication DeviceManagementServiceConfig.ReadWrite.AllDeviceManagementServiceConfig.ReadWrite.All

Solicitud HTTPHTTP Request

PATCH /deviceManagement/importedDeviceIdentities/{importedDeviceIdentityId}

Encabezados de solicitudRequest headers

EncabezadoHeader ValorValue
AuthorizationAuthorization Se requiere <token> de portador.Bearer <token> Required.
AceptarAccept application/jsonapplication/json

Cuerpo de la solicitudRequest body

En el cuerpo de la solicitud, especifique una representación JSON del objeto importedDeviceIdentity .In the request body, supply a JSON representation for the importedDeviceIdentity object.

En la tabla siguiente se muestran las propiedades necesarias para crear el importedDeviceIdentity.The following table shows the properties that are required when you create the importedDeviceIdentity.

PropiedadProperty TipoType DescripciónDescription
idid CadenaString Identificador de la identidad del dispositivo importadoId of the imported device identity
importedDeviceIdentifierimportedDeviceIdentifier StringString Identificador de dispositivo importadoImported Device Identifier
importedDeviceIdentityTypeimportedDeviceIdentityType importedDeviceIdentityTypeimportedDeviceIdentityType Tipo de identidad del dispositivo importado.Type of Imported Device Identity. Los valores posibles son: unknown, imei y serialNumber.Possible values are: unknown, imei, serialNumber.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Fecha y hora de la última modificación de la descripciónLast Modified DateTime of the description
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Fecha y hora de creación del dispositivoCreated Date Time of the device
lastContactedDateTimelastContactedDateTime DateTimeOffsetDateTimeOffset Fecha y hora del último contacto del dispositivoLast Contacted Date Time of the device
descriptiondescription StringString La descripción del dispositivoThe description of the device
enrollmentStateenrollmentState enrollmentStateenrollmentState El estado del dispositivo en Intune.The state of the device in Intune. Los valores posibles son: unknown, enrolled, pendingReset, failed, notContacted, blocked.Possible values are: unknown, enrolled, pendingReset, failed, notContacted, blocked.
platformplatform variasplatform La plataforma del dispositivo.The platform of the Device. Los valores posibles son: unknown, ios, android, windows, windowsMobile, macOS.Possible values are: unknown, ios, android, windows, windowsMobile, macOS.

RespuestaResponse

Si se ejecuta correctamente, este método 200 OK devuelve un código de respuesta y un objeto importedDeviceIdentity actualizado en el cuerpo de la respuesta.If successful, this method returns a 200 OK response code and an updated importedDeviceIdentity object in the response body.

EjemploExample

SolicitudRequest

Aquí tiene un ejemplo de la solicitud.Here is an example of the request.

PATCH https://graph.microsoft.com/beta/deviceManagement/importedDeviceIdentities/{importedDeviceIdentityId}
Content-type: application/json
Content-length: 332

{
  "@odata.type": "#microsoft.graph.importedDeviceIdentity",
  "importedDeviceIdentifier": "Imported Device Identifier value",
  "importedDeviceIdentityType": "imei",
  "lastContactedDateTime": "2016-12-31T23:58:44.2908994-08:00",
  "description": "Description value",
  "enrollmentState": "enrolled",
  "platform": "ios"
}

RespuestaResponse

Aquí tiene un ejemplo de la respuesta. Nota: Puede que el objeto de respuesta que aparece aquí se trunque para abreviar. Todas las propiedades se devolverán de una llamada 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 200 OK
Content-Type: application/json
Content-Length: 504

{
  "@odata.type": "#microsoft.graph.importedDeviceIdentity",
  "id": "9f70a12f-a12f-9f70-2fa1-709f2fa1709f",
  "importedDeviceIdentifier": "Imported Device Identifier value",
  "importedDeviceIdentityType": "imei",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "lastContactedDateTime": "2016-12-31T23:58:44.2908994-08:00",
  "description": "Description value",
  "enrollmentState": "enrolled",
  "platform": "ios"
}