Obter deviceManagementConfigurationChoiceSettingDefinition
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.
Leia propriedades e relações do objeto deviceManagementConfigurationChoiceSettingDefinition .
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.Read.All, DeviceManagementConfiguration.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. |
| Aplicativo | DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All |
Solicitação HTTP
GET /deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}
GET /deviceManagement/inventorySettings/{deviceManagementConfigurationSettingDefinitionId}
GET /deviceManagement/complianceSettings/{deviceManagementConfigurationSettingDefinitionId}
GET /deviceManagement/configurationSettings/{deviceManagementConfigurationSettingDefinitionId}
GET /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId}
GET /deviceManagement/configurationPolicyTemplates/{deviceManagementConfigurationPolicyTemplateId}/settingTemplates/{deviceManagementConfigurationSettingTemplateId}/settingDefinitions/{deviceManagementConfigurationSettingDefinitionId}
Parâmetros de consulta opcionais
Este método dá suporte a Parâmetros de consulta OData para ajudar a personalizar a resposta.
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
Não forneça um corpo de solicitação para esse método.
Resposta
Se for bem-sucedido, esse método retornará um código de resposta e um 200 OK objeto deviceManagementConfigurationChoiceSettingDefinition no corpo da resposta.
Exemplo
Solicitação
Este é um exemplo da solicitação.
GET https://graph.microsoft.com/beta/deviceManagement/reusableSettings/{deviceManagementConfigurationSettingDefinitionId}
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: 19687
{
"value": {
"@odata.type": "#microsoft.graph.deviceManagementConfigurationChoiceSettingDefinition",
"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": "30b2258a-258a-30b2-8a25-b2308a25b230",
"description": "Description value",
"helpText": "Help Text value",
"name": "Name value",
"displayName": "Display Name value",
"version": "Version value",
"options": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationOptionDefinition",
"optionValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationGroupSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingValueTemplateReference",
"settingValueTemplateId": "Setting Value Template Id value",
"useTemplateDefault": true
},
"value": "Value value",
"children": [
{
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingInstance",
"settingDefinitionId": "Setting Definition Id value",
"settingInstanceTemplateReference": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationSettingInstanceTemplateReference",
"settingInstanceTemplateId": "Setting Instance Template Id value"
},
"choiceSettingValue": {
"@odata.type": "microsoft.graph.deviceManagementConfigurationChoiceSettingValue",
"settingValueTemplateReference": null,
"value": "Value value",
"children": null
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
}
}
]
},
"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
}
],
"itemId": "Item Id value",
"description": "Description value",
"helpText": "Help Text value",
"name": "Name value",
"displayName": "Display Name value"
}
],
"defaultOptionId": "Default Option Id value"
}
}
Comentários
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, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de