Criar deviceManagementConfigurationSettingGroupDefinition
Namespace: microsoft.graph
Importante: As APIs do Microsoft Graph na versão /beta estão sujeitas a alterações; a utilização de produção não é suportada.
Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.
Crie um novo objeto deviceManagementConfigurationSettingGroupDefinition .
Esta API está disponível nas seguintes implementações de cloud nacionais.
Serviço global | US Government L4 | US Government 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. |
Application | DeviceManagementConfiguration.ReadWrite.All |
Solicitação HTTP
POST /deviceManagement/reusableSettings
POST /deviceManagement/inventorySettings
POST /deviceManagement/complianceSettings
POST /deviceManagement/configurationSettings
POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions
POST /deviceManagement/configurationPolicyTemplates/{deviceManagementConfigurationPolicyTemplateId}/settingTemplates/{deviceManagementConfigurationSettingTemplateId}/settingDefinitions
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 do pedido, forneça uma representação JSON para o objeto deviceManagementConfigurationSettingGroupDefinition.
A tabela seguinte mostra as propriedades necessárias quando cria o dispositivoManagementConfigurationSettingGroupDefinition.
Propriedade | Tipo | Descrição |
---|---|---|
aplicabilidade | deviceManagementConfigurationSettingApplicability | Detalhes sobre a definição do dispositivo aplicável. Suporta: $filters. Herdado de deviceManagementConfigurationSettingDefinition |
accessTypes | deviceManagementConfigurationSettingAccessTypes | Modo de acesso de leitura/escrita da definição Herdado de deviceManagementConfigurationSettingDefinition. Os valores possíveis são: none , add , copy , delete , get , replace , execute . |
palavras-chave | String collection | Tokens para procurar definições em Herdado de deviceManagementConfigurationSettingDefinition |
infoUrls | Coleção String | Pode encontrar uma lista de ligações mais informações para a definição em. Herdado de deviceManagementConfigurationSettingDefinition |
ocorrência | deviceManagementConfigurationSettingOccurrence | Indica se a definição é necessária ou não Herdada de deviceManagementConfigurationSettingDefinition |
baseUri | Cadeia de caracteres | Caminho CSP Base Herdado de deviceManagementConfigurationSettingDefinition |
offsetUri | Cadeia de caracteres | Desvio do Caminho CSP da Base Herdada de deviceManagementConfigurationSettingDefinition |
rootDefinitionId | Cadeia de caracteres | ID de definição de definição de raiz se a definição for uma definição subordinada. Herdado de deviceManagementConfigurationSettingDefinition |
categoryId | Cadeia de caracteres | Especifique a categoria na qual a definição se encontra. Suporte $filters. Herdado de deviceManagementConfigurationSettingDefinition |
settingUsage | deviceManagementConfigurationSettingUsage | Indique o tipo de definição para a definição. Os valores possíveis são: configuração, conformidade, reutilizávelDefinição. Cada utilização de definições tem um ponto final de API separado para chamar. Herdado de deviceManagementConfigurationSettingDefinition. Os valores possíveis são: none , configuration , compliance , unknownFutureValue , inventory . |
uxBehavior | deviceManagementConfigurationControlType | Definir representação do tipo de controlo na experiência de utilizador. Os valores possíveis são: predefinição, lista pendente, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane. Herdado de deviceManagementConfigurationSettingDefinition. Os valores possíveis são: default , dropdown , smallTextBox , largeTextBox , toggle , multiheaderGrid , contextPane , unknownFutureValue . |
visibility | deviceManagementConfigurationSettingVisibility | Definir o âmbito de visibilidade como UX. Os valores possíveis são: none, settingsCatalog, template. Herdado de deviceManagementConfigurationSettingDefinition. Os valores possíveis são: none , settingsCatalog , template , unknownFutureValue , inventoryCatalog . |
referredSettingInformationList | deviceManagementConfigurationReferredSettingInformation collection | Lista de informações de definição referidas. Herdado de deviceManagementConfigurationSettingDefinition |
id | Cadeia de caracteres | Identificador do item Herdado de deviceManagementConfigurationSettingDefinition |
description | Cadeia de caracteres | Descrição da definição. Herdado de deviceManagementConfigurationSettingDefinition |
helpText | Cadeia de caracteres | Texto de ajuda da definição. Dê mais detalhes sobre a definição. Herdado de deviceManagementConfigurationSettingDefinition |
nome | Cadeia de caracteres | Nome do item Herdado de deviceManagementConfigurationSettingDefinition |
displayName | Cadeia de caracteres | Nome da configuração. Por exemplo: Permitir Alerta. Herdado de deviceManagementConfigurationSettingDefinition |
versão | Cadeia de caracteres | Versão do Item Herdada de deviceManagementConfigurationSettingDefinition |
childIds | Coleção String | Definições subordinadas dependentes deste grupo de definições. |
dependenteOn | deviceManagementConfigurationDependentOn collection | Lista de Dependências do grupo de definições |
dependedOnBy | deviceManagementConfigurationSettingDependedOnBy collection | Lista de definições subordinadas que dependem desta definição |
Resposta
Se for bem-sucedido, este método devolve um 201 Created
código de resposta e um objeto deviceManagementConfigurationSettingGroupDefinition no corpo da resposta.
Exemplo
Solicitação
Este é um exemplo da solicitação.
POST https://graph.microsoft.com/beta/deviceManagement/reusableSettings
Content-type: application/json
Content-length: 1731
{
"@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingGroupDefinition",
"applicability": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingApplicability",
"description": "Description value",
"platform": "android",
"deviceMode": "kiosk",
"technologies": "mdm"
},
"accessTypes": "add",
"keywords": [
"Keywords value"
],
"infoUrls": [
"Info Urls value"
],
"occurrence": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingOccurrence",
"minDeviceOccurrence": 3,
"maxDeviceOccurrence": 3
},
"baseUri": "Base Uri value",
"offsetUri": "Offset Uri value",
"rootDefinitionId": "Root Definition Id value",
"categoryId": "Category Id value",
"settingUsage": "configuration",
"uxBehavior": "dropdown",
"visibility": "settingsCatalog",
"referredSettingInformationList": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationReferredSettingInformation",
"settingDefinitionId": "Setting Definition Id value"
}
],
"description": "Description value",
"helpText": "Help Text value",
"name": "Name value",
"displayName": "Display Name value",
"version": "Version value",
"childIds": [
"Child Ids value"
],
"dependentOn": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationDependentOn",
"dependentOn": "Dependent On value",
"parentSettingId": "Parent Setting Id value"
}
],
"dependedOnBy": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingDependedOnBy",
"dependedOnBy": "Depended On By value",
"required": true
}
]
}
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: 1780
{
"@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingGroupDefinition",
"applicability": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingApplicability",
"description": "Description value",
"platform": "android",
"deviceMode": "kiosk",
"technologies": "mdm"
},
"accessTypes": "add",
"keywords": [
"Keywords value"
],
"infoUrls": [
"Info Urls value"
],
"occurrence": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingOccurrence",
"minDeviceOccurrence": 3,
"maxDeviceOccurrence": 3
},
"baseUri": "Base Uri value",
"offsetUri": "Offset Uri value",
"rootDefinitionId": "Root Definition Id value",
"categoryId": "Category Id value",
"settingUsage": "configuration",
"uxBehavior": "dropdown",
"visibility": "settingsCatalog",
"referredSettingInformationList": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationReferredSettingInformation",
"settingDefinitionId": "Setting Definition Id value"
}
],
"id": "95dc9604-9604-95dc-0496-dc950496dc95",
"description": "Description value",
"helpText": "Help Text value",
"name": "Name value",
"displayName": "Display Name value",
"version": "Version value",
"childIds": [
"Child Ids value"
],
"dependentOn": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationDependentOn",
"dependentOn": "Dependent On value",
"parentSettingId": "Parent Setting Id value"
}
],
"dependedOnBy": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingDependedOnBy",
"dependedOnBy": "Depended On By value",
"required": true
}
]
}