Atualizar depOnboardingSetting
Namespace: microsoft.graph
Importante: As APIs Graph Microsoft na versão /beta estão sujeitas a alterações; não há suporte para uso de produção.
Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.
Atualize as propriedades de um objeto depOnboardingSetting.
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) |
|---|---|
| Delegado (conta corporativa ou de estudante) | DeviceManagementServiceConfig.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. |
| Aplicativo | DeviceManagementServiceConfig.ReadWrite.All |
Solicitação HTTP
PATCH /deviceManagement/depOnboardingSettings/{depOnboardingSettingId}
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, fornece uma representação JSON para o objeto depOnboardingSetting.
A tabela a seguir mostra as propriedades que são necessárias ao criar o depOnboardingSetting.
| Propriedade | Tipo | Descrição |
|---|---|---|
| id | Cadeia de caracteres | O UUID do objeto. |
| appleIdentifier | Cadeia de caracteres | A ID da Apple usada para obter o token atual. |
| tokenExpirationDateTime | DateTimeOffset | Quando o token expirar. |
| lastModifiedDateTime | DateTimeOffset | Quando o serviço foi integrado. |
| lastSuccessfulSyncDateTime | DateTimeOffset | Quando o serviço foi sintetizado pela última vez com o Intune |
| lastSyncTriggeredDateTime | DateTimeOffset | Quando o Intune solicitou pela última vez uma sincronização. |
| shareTokenWithSchoolDataSyncService | Boleano | Se o compartilhamento de token Dep está habilitado ou não com o School Data Sync serviço. |
| lastSyncErrorCode | Int32 | Código de erro relatado pela Apple durante a última sincronização de dep. |
| tokenType | depTokenType | Obtém ou define o Tipo de Token de Dep. Os valores possíveis são: none, dep, appleSchoolManager. |
| tokenName | Cadeia de Caracteres | Nome amigável para Token de Dep |
| syncedDeviceCount | Int32 | Obtém contagem de dispositivos sincronizados |
| dataSharingConsentGranted | Boleano | Consentimento concedido para compartilhamento de dados com o Serviço de Dep da Apple |
| roleScopeTagIds | String collection | Lista de marcas de escopo para esta instância entity. |
Resposta
Se tiver êxito, este método retornará um código de resposta e um objeto 200 OK depOnboardingSetting atualizado no corpo da resposta.
Exemplo
Solicitação
Este é um exemplo da solicitação.
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"
]
}
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 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"
]
}
Comentários
Enviar e exibir comentários de