Actualizar depOnboardingSettingUpdate depOnboardingSetting

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 depOnboardingSetting .Update the properties of a depOnboardingSetting 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.
ApplicationApplication DeviceManagementServiceConfig.ReadWrite.AllDeviceManagementServiceConfig.ReadWrite.All

Solicitud HTTPHTTP Request

PATCH /deviceManagement/depOnboardingSettings/{depOnboardingSettingId}

Encabezados de solicitudRequest headers

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

Cuerpo de solicitudRequest body

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

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

PropiedadProperty TipoType DescripciónDescription
idid CadenaString UUID para el objetoUUID for the object
appleIdentifierappleIdentifier StringString IDENTIFICADOR de Apple que se usa para obtener el token actual.The Apple ID used to obtain the current token.
tokenExpirationDateTimetokenExpirationDateTime DateTimeOffsetDateTimeOffset Cuándo va a expirar el token.When the token will expire.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Cuando el servicio estaba incorporado.When the service was onboarded.
lastSuccessfulSyncDateTimelastSuccessfulSyncDateTime DateTimeOffsetDateTimeOffset La última vez que el servicio syned con IntuneWhen the service last syned with Intune
lastSyncTriggeredDateTimelastSyncTriggeredDateTime DateTimeOffsetDateTimeOffset La última vez que Intune solicitó una sincronización.When Intune last requested a sync.
shareTokenWithSchoolDataSyncServiceshareTokenWithSchoolDataSyncService BooleanBoolean Indica si el uso compartido de tokens de DEP está habilitado con el servicio de School Data Sync.Whether or not the Dep token sharing is enabled with the School Data Sync service.
lastSyncErrorCodelastSyncErrorCode Int32Int32 Código de error notificado por Apple durante la última sincronización de DEP.Error code reported by Apple during last dep sync.
tokenTypetokenType depTokenTypedepTokenType Obtiene o establece el tipo de token de DEP.Gets or sets the Dep Token Type. Los valores posibles son: none, dep y appleSchoolManager.Possible values are: none, dep, appleSchoolManager.
tokenNametokenName CadenaString Nombre descriptivo para el token de DEPFriendly Name for Dep Token
syncedDeviceCountsyncedDeviceCount Int32Int32 Obtiene el recuento de dispositivos sincronizadosGets synced device count
dataSharingConsentGranteddataSharingConsentGranted BooleanBoolean Consentimiento otorgado para uso compartido de datos con el servicio de Apple DEPConsent granted for data sharing with Apple Dep Service
roleScopeTagIdsroleScopeTagIds Colección StringString collection Lista de etiquetas de ámbito para esta instancia de entidad.List of Scope Tags for this Entity instance.

RespuestaResponse

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto depOnboardingSetting actualizado en el cuerpo de la respuesta.If successful, this method returns a 200 OK response code and an updated depOnboardingSetting 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/depOnboardingSettings/{depOnboardingSettingId}
Content-type: application/json
Content-length: 576

{
  "@odata.type": "#microsoft.graph.depOnboardingSetting",
  "appleIdentifier": "Apple Identifier value",
  "tokenExpirationDateTime": "2016-12-31T23:59:54.0590989-08:00",
  "lastSuccessfulSyncDateTime": "2017-01-01T00:03:28.120883-08:00",
  "lastSyncTriggeredDateTime": "2017-01-01T00:00:02.0916369-08:00",
  "shareTokenWithSchoolDataSyncService": true,
  "lastSyncErrorCode": 1,
  "tokenType": "dep",
  "tokenName": "Token Name value",
  "syncedDeviceCount": 1,
  "dataSharingConsentGranted": true,
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ]
}

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

{
  "@odata.type": "#microsoft.graph.depOnboardingSetting",
  "id": "40342229-2229-4034-2922-344029223440",
  "appleIdentifier": "Apple Identifier value",
  "tokenExpirationDateTime": "2016-12-31T23:59:54.0590989-08:00",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "lastSuccessfulSyncDateTime": "2017-01-01T00:03:28.120883-08:00",
  "lastSyncTriggeredDateTime": "2017-01-01T00:00:02.0916369-08:00",
  "shareTokenWithSchoolDataSyncService": true,
  "lastSyncErrorCode": 1,
  "tokenType": "dep",
  "tokenName": "Token Name value",
  "syncedDeviceCount": 1,
  "dataSharingConsentGranted": true,
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ]
}