Actualizar depOnboardingSetting
Espacio de nombres: 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.
Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.
Actualice las propiedades de un objeto depOnboardingSetting .
Esta API está disponible en las siguientes implementaciones nacionales de nube.
Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Permisos
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.
Tipo de permiso | Permisos (de menos a más privilegiados) |
---|---|
Delegado (cuenta profesional o educativa) | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All |
Delegado (cuenta personal de Microsoft) | No admitida. |
Aplicación | DeviceManagementServiceConfig.ReadWrite.All, DeviceManagementConfiguration.ReadWrite.All |
Solicitud HTTP
PATCH /deviceManagement/depOnboardingSettings/{depOnboardingSettingId}
Encabezados de solicitud
Encabezado | Valor |
---|---|
Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Aceptar | application/json |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione una representación JSON para el objeto depOnboardingSetting .
En la tabla siguiente se muestran las propiedades necesarias al crear depOnboardingSetting.
Propiedad | Tipo | Descripción |
---|---|---|
id | String | UUID para el objeto |
appleIdentifier | Cadena | Id. de Apple usado para obtener el token actual. |
tokenExpirationDateTime | DateTimeOffset | Cuándo expirará el token. |
lastModifiedDateTime | DateTimeOffset | Cuando se incorporó el servicio. |
lastSuccessfulSyncDateTime | DateTimeOffset | La última vez que el servicio se syned con Intune |
lastSyncTriggeredDateTime | DateTimeOffset | La última vez que Intune solicitó una sincronización. |
shareTokenWithSchoolDataSyncService | Booleano | Si el uso compartido de tokens de Dep está habilitado o no con el servicio School Data Sync. |
lastSyncErrorCode | Int32 | Código de error notificado por Apple durante la última sincronización dep. |
tokenType | depTokenType | Obtiene o establece el tipo de token de dep. Los valores posibles son: none , dep y appleSchoolManager . |
tokenName | Cadena | Nombre descriptivo del token de dep |
syncedDeviceCount | Int32 | Obtiene el recuento de dispositivos sincronizados |
dataSharingConsentGranted | Booleano | Consentimiento concedido para el uso compartido de datos con Apple Dep Service |
roleScopeTagIds | Colección de cadenas | Lista de etiquetas de ámbito para esta instancia de entity. |
Respuesta
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.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
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"
]
}
Respuesta
Aquí tiene un ejemplo de la respuesta. Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar. Todas las propiedades se devolverán desde una llamada real.
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"
]
}
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de