Criar dispositivoAndAppManagementAssignmentFilter
Namespace: microsoft.graph
Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; não há suporte para o uso de produção.
Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.
Crie um novo objeto deviceAndAppManagementAssignmentFilter .
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Permissões
Uma das seguintes permissões é necessá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) | DeviceManagementConfiguration.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. |
Aplicativo | DeviceManagementConfiguration.ReadWrite.All |
Solicitação HTTP
POST /deviceManagement/assignmentFilters
Cabeçalhos de solicitação
Cabeçalho | Valor |
---|---|
Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Aceitar | application/json |
Corpo da solicitação
No corpo da solicitação, forneça uma representação JSON para o objeto deviceAndAppManagementAssignmentFilter.
A tabela a seguir mostra as propriedades necessárias ao criar o dispositivoAndAppManagementAssignmentFilter.
Propriedade | Tipo | Descrição |
---|---|---|
id | Cadeia de caracteres | Chave do Filtro de Atribuição. |
createdDateTime | DateTimeOffset | O tempo de criação do filtro de atribuição. O valor não pode ser modificado e é preenchido automaticamente durante o novo processo de filtro de atribuição. O tipo de carimbo de data e hora representa informações de data e hora usando o formato ISO 8601 e está sempre em tempo UTC. Por exemplo, meia-noite em UTC no dia 1º de janeiro de 2014 teria esta aparência: '2014-01-01T00:00:00Z'. |
lastModifiedDateTime | DateTimeOffset | Última hora modificada do Filtro de Atribuição. O tipo de carimbo de data e hora representa informações de data e hora usando o formato ISO 8601 e está sempre em tempo UTC. Por exemplo, meia-noite em UTC no dia 1º de janeiro de 2014 teria esta aparência: '2014-01-01T00:00:00Z' |
displayName | Cadeia de caracteres | O nome do Filtro de Atribuição. |
description | Cadeia de caracteres | Descrição opcional do Filtro de Atribuição. |
plataforma | devicePlatformType | Indica que o filtro é aplicado a qual flatform. Os valores possíveis são android,androidForWork,iOS,macOS,windowsPhone81,windows81AndLater,windows10AndLater,androidWorkProfile, unknown, androidAOSP, androidMobileApplicationManagement, iOSMobileApplicationManagement, windowsMobileApplicationManagement. O filtro padrão será aplicado a 'desconhecido'. Os valores possíveis são: android , , androidForWork , iOS , macOS , windowsPhone81 , windows81AndLater , windows10AndLater , androidWorkProfile , unknown , androidAOSP , androidMobileApplicationManagement , iOSMobileApplicationManagement , , unknownFutureValue , . windowsMobileApplicationManagement |
Regra | Cadeia de caracteres | Definição de regra do filtro de atribuição. |
roleScopeTags | String collection | Indica marcas de escopo de função atribuídas para o filtro de atribuição. |
Cargas | coleção payloadByFilter | Indica atribuições associadas para um filtro específico. |
assignmentFilterManagementType | assignmentFilterManagementType | Indica que o filtro é aplicado ao tipo de gerenciamento "dispositivos" ou "aplicativos". Os valores possíveis são dispositivos, aplicativos. O filtro padrão será aplicado a 'dispositivos'. Os valores possíveis são: devices , apps , unknownFutureValue . |
Resposta
Se for bem-sucedido, esse método retornará um 201 Created
código de resposta e um objeto deviceAndAppManagementAssignmentFilter no corpo da resposta.
Exemplo
Solicitação
Este é um exemplo da solicitação.
POST https://graph.microsoft.com/beta/deviceManagement/assignmentFilters
Content-type: application/json
Content-length: 588
{
"@odata.type": "#microsoft.graph.deviceAndAppManagementAssignmentFilter",
"displayName": "Display Name value",
"description": "Description value",
"platform": "androidForWork",
"rule": "Rule value",
"roleScopeTags": [
"Role Scope Tags value"
],
"payloads": [
{
"@odata.type": "microsoft.graph.payloadByFilter",
"payloadId": "Payload Id value",
"payloadType": "deviceConfigurationAndCompliance",
"groupId": "Group Id value",
"assignmentFilterType": "include"
}
],
"assignmentFilterManagementType": "apps"
}
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 201 Created
Content-Type: application/json
Content-Length: 760
{
"@odata.type": "#microsoft.graph.deviceAndAppManagementAssignmentFilter",
"id": "819818db-18db-8198-db18-9881db189881",
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"displayName": "Display Name value",
"description": "Description value",
"platform": "androidForWork",
"rule": "Rule value",
"roleScopeTags": [
"Role Scope Tags value"
],
"payloads": [
{
"@odata.type": "microsoft.graph.payloadByFilter",
"payloadId": "Payload Id value",
"payloadType": "deviceConfigurationAndCompliance",
"groupId": "Group Id value",
"assignmentFilterType": "include"
}
],
"assignmentFilterManagementType": "apps"
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de