红帽全球峰会2.14. cn=tasks,cn=config 下条目的常用任务调用属性
某些核心目录服务器，可以通过使用 LDAP 工具编辑目录条目来启动任务。这些任务条目包含在 cn=tasks,cn=config 中。可以通过更新条目来调用每个任务，如下所示：
dn: cn=task_id,cn=task_type,cn=tasks,cn=config
...本节列出了所有任务类型的通用属性。
任务条目不是永久配置条目。只要任务操作正在运行，或者直到 ttl 周期过期，则它们才会存在于配置文件中。然后，服务器会自动删除该条目。
2.14.1. cn
cn 属性标识要启动的新任务操作。cn 属性值可以是任意值，只要它定义了新任务。
| 参数 | 描述 |
|---|---|
| 条目 DN | cn=task_name,cn=task_type,cn=tasks,cn=config |
| 有效值 | 任何字符串 |
| 默认值 | |
| 语法 | DirectoryString |
| 示例 | cn: example task entry name |
2.14.2. nsTaskCancel
此属性允许在进行过程中中止任务。此属性可以被用户修改。
| 参数 | 描述 |
|---|---|
| 条目 DN | cn=task_name,cn=task_type,cn=tasks,cn=config |
| 有效值 | true | false |
| 默认值 | |
| 语法 | 不区分大小写的字符串 |
| 示例 | nsTaskCancel: true |
2.14.3. nsTaskCurrentItem
此属性显示任务操作已完成的子任务数量，假设任务可以划分为子任务。如果只有一个任务，则在任务运行时，nsTaskCurrentItem 为 0， 当任务完成时，1 则为 1。这样，属性与进度条类似。当 nsTaskCurrentItem 属性的值与 nsTaskTotalItems 相同时，任务已完成。
此属性值由服务器设置，不应 编辑。
| 参数 | 描述 |
|---|---|
| 条目 DN | cn=task_name,cn=task_type,cn=tasks,cn=config |
| 有效值 | 0 到最大 32 位整数值(2147483647) |
| 默认值 | |
| 语法 | 整数 |
| 示例 | nsTaskCurrentItem: 148 |
2.14.4. nsTaskExitCode
此属性包含任务的退出代码。此属性仅在任务完成后存在，任何值仅在任务完成后有效。结果代码可以是任何 LDAP 退出代码，但只有 0 值等于成功；任何其他结果代码都是错误。
此属性值由服务器设置，不应 编辑。
2.14.5. nsTaskLog
此条目包含任务的所有日志消息，包括警告和信息消息。新消息附加在条目值的末尾，因此此属性值会增大，而不默认删除原始内容。
成功任务操作（其 nsTaskExitCode 为 0 ）仅记录在 nsTaskLog 属性中。任何表示错误的非零响应都可能会记录在错误日志中，但错误消息仅记录在 nsTaskLog 属性中。因此，使用 nsTaskLog 属性中的信息来查找实际发生的错误。
此属性值由服务器设置，不应 编辑。
2.14.6. nsTaskStatus
此属性包含有关任务状态的信息，如累积统计信息或其当前输出消息。只要进程正在运行，该属性的整个内容可能会定期更新。
此属性值由服务器设置，不应 编辑。
| 参数 | 描述 |
|---|---|
| 条目 DN | cn=task_name,cn=task_type,cn=tasks,cn=config |
| 有效值 | 任何字符串 |
| 默认值 | |
| 语法 | case-exact 字符串 |
| 示例 | nsTaskStatus: Loading entries…. |
2.14.7. nsTaskTotalItems
此属性显示必须为任务操作完成的子任务总数。当 nsTaskCurrentItem 属性的值与 nsTaskTotalItems 相同时，任务已完成。
此属性值由服务器设置，不应 编辑。
| 参数 | 描述 |
|---|---|
| 条目 DN | cn=task_name,cn=task_type,cn=tasks,cn=config |
| 有效值 | 0 到最大 32 位整数值(2147483647) |
| 默认值 | |
| 语法 | 整数 |
| 示例 | nsTaskTotalItems: 152 |
2.14.8. ttl
此属性设置任务条目在任务完成或中止后，任务条目将保留在 DSE 中的时间（以秒为单位）。设置 ttl 属性可让任务条目轮询新状态信息，而不会缺少退出代码。将 ttl 属性设置为 0 表示该条目不会被缓存。
| 参数 | 描述 |
|---|---|
| 条目 DN | cn=task_name,cn=task_type,cn=tasks,cn=config |
| 有效值 | 0 （不可缓存）到最大 32 位整数值(2147483647) |
| 默认值 | |
| 语法 | DirectoryString |
| 示例 | ttl: 120 |
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}