@dynatrace-sdk/client-automation

中文文档
8.10.0发布于 2026/10/16Apache-2.0TypeScriptESM + CJS近 30 天下载 3505

自动化API允许与工作流程和各种触发选项合作.

中文使用文档
文档目录71 节
  1. 安装
  2. 获得帮助
  3. 许可证
  4. 动作执行
  5. 获取动作执行
  6. 获取动作执行日志
  7. 动作SampleResult客户端
  8. 获得行动实例
  9. 商业卡通
  10. 创建商务日历
  11. 删除商务日历
  12. 重复商务日历
  13. 获取商务日历
  14. 获取商务记录历史
  15. 获取商务记录历史记录
  16. 获取商务算法
  17. 补丁商务日历
  18. 恢复商业分类历史记录
  19. 更新商务日历
  20. 触发事件
  21. 预览筛选
  22. 处决
  23. 取消执行
  24. 取消任务执行
  25. 获取全部事件日志
  26. 获取执行
  27. 获取执行动作
  28. 获取执行日志
  29. 获取执行
  30. 获取任务执行
  31. 获得任务输出
  32. 获取任务执行日志
  33. 获得任务执行结果
  34. 获取任务执行
  35. 获取过渡
  36. 暂停执行
  37. 恢复执行
  38. 调度
  39. 获取国家
  40. 获取 Holiday 日历
  41. 获取时区
  42. 预览附表
  43. 调度规则
  44. 创建规则
  45. 删除规则
  46. 复制规则
  47. 获取规则
  48. 获取规则历史记录
  49. 获取规则历史记录
  50. 获取规则
  51. 补丁规则
  52. 预览规则
  53. 恢复规则历史记录
  54. 更新规则
  55. 设置
  56. 获取服务用户
  57. 获取设置
  58. 用户许可
  59. 获取用户设置
  60. 更新授权
  61. 版本客户端
  62. 获取版本
  63. 网约车
  64. 删除Webhook汉德勒
  65. 获得韦布克汉德勒
  66. 获取WebhookHandlers 软件
  67. 写出WebhookHandler
  68. 工作流程
  69. 创建工作流程
  70. 删除已崩溃的工作流程
  71. 删除工作流程

@ dynatrace- sdk/ 客户端自定义

npm License

与自动化Engine API管理并运行工作流程.

安装

npm install @dynatrace-sdk/client-automation

获得帮助

许可证

此 SDK 分布于 Apache 许可证,2.0版本,更多信息见LICENSE.

API 参考

最新版本SDK的API 完整参考文件也可在 Dynatrace 开发者。 。 。 .

动作执行

import { actionExecutionsClient } from '@dynatrace-sdk/client-automation';

获取动作执行

动作Executions Client.get ActionExecution(配置):承诺 <动作执行> 翻译:

所需范围 : 自动化:工作流程:已读

参数

名称类型说明
配置.admin 访问布尔允许访问所有工作流程/执行----额外要求 自动化:工作流程:admin

默认 : false
配置.id*必须字符串一个UUID字符串识别此动作执行 .

回返

返回类型状态代码说明
动作执行200个

掷出

错误类型错误消息
信封错误
代码示例
import { actionExecutionsClient } from "@dynatrace-sdk/client-automation";

const data =
  await actionExecutionsClient.getActionExecution({
    id: "...",
  });

获取动作执行日志

executionsClient.get ActionExecutionLog( config):承诺<[string](https://developer.mozila.org/en-US/docs/Glossary/String)>

所需范围 : 自动化:工作流程:已读

返回特定动作的日志输出 .

参数

名称类型说明
配置.admin 访问布尔允许访问所有工作流程/执行----额外要求 自动化:工作流程:admin

默认 : false
配置.id*必须字符串一个UUID字符串识别此动作执行 .

回返

返回类型状态代码说明
无效200个

掷出

错误类型错误消息
信封错误
代码示例
import { actionExecutionsClient } from "@dynatrace-sdk/client-automation";

const data =
  await actionExecutionsClient.getActionExecutionLog({
    id: "...",
  });

动作SampleResult客户端

import { actionsSampleResultClient } from '@dynatrace-sdk/client-automation';

获得行动实例

⚠️ 折旧

动作SampleResultClient.get ActionSampleResult( config):承诺<[任何](https://www.typescriptlang.org/docs/handbook/2/every-types.html#any)>

所需范围 : 自动化:工作流程:已读

参数

名称类型
配置. 行动识别符*必须字符串

回返

返回类型状态代码说明
无效200个

掷出

错误类型错误消息
信封错误
代码示例
import { actionsSampleResultClient } from "@dynatrace-sdk/client-automation";

const data =
  await actionsSampleResultClient.getActionSampleResult({
    actionIdentifier: "...",
  });

商业卡通

import { businessCalendarsClient } from '@dynatrace-sdk/client-automation';

创建商务日历

companyCalendersClient.create BusinessCalendar(配置):承诺 <商业平衡对策> 翻译:

所需范围 : 自动化: calendars: write

参数

名称类型
配置. 身体*必须商业算法创造

回返

返回类型状态代码说明
商业平衡对策201 (韩语)

掷出

错误类型错误消息
信封错误
代码示例
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";

const data =
  await businessCalendarsClient.createBusinessCalendar({
    body: { title: "..." },
  });

删除商务日历

商业术语CalendersClient.delete BusinessCalendar(配置):承诺<void>

所需范围 : 自动化: calendars: write

参数

名称类型说明
配置.id*必须字符串一个 UUID 字符串来识别此业务日历 .

回返

返回类型状态代码说明
无效204 (韩语)无反应机构

掷出

错误类型错误消息
信封错误
代码示例
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";

const data =
  await businessCalendarsClient.deleteBusinessCalendar({
    id: "...",
  });

重复商务日历

calenders Client. 重复商业 Calendar(配置):承诺 <商业平衡对策> 翻译:

所需范围 : 自动化: calendars: write

参数

名称类型说明
配置. 身体*必须重复请求
配置.id*必须字符串一个 UUID 字符串来识别此业务日历 .

回返

返回类型状态代码说明
商业平衡对策201 (韩语)

掷出

错误类型错误消息
信封错误
代码示例
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";

const data =
  await businessCalendarsClient.duplicateBusinessCalendar({
    id: "...",
    body: {},
  });

获取商务日历

calendars Client.get BusinessCalendar(配置):承诺 <商业平衡对策> 翻译:

所需范围 : 自动化: 日历: 已读

参数

名称类型说明
配置.id*必须字符串一个 UUID 字符串来识别此业务日历 .

回返

返回类型状态代码说明
商业平衡对策200个

掷出

错误类型错误消息
信封错误
代码示例
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";

const data =
  await businessCalendarsClient.getBusinessCalendar({
    id: "...",
  });

获取商务记录历史

商业交易中心.get 商业交易历史记录(配置):承诺 <商业平衡对策> 翻译:

所需范围 : 自动化: 日历: 已读

参数

名称类型说明
配置.id*必须字符串一个 UUID 字符串来识别此业务日历 .
配置. version*必须字符串模式 : ^[\d]+$

回返

返回类型状态代码说明
商业平衡对策200个

掷出

错误类型错误消息
信封错误
代码示例
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";

const data =
  await businessCalendarsClient.getBusinessCalendarHistoryRecord(
    { id: "...", version: "..." },
  );

获取商务记录历史记录

商业交易中心.getBusinessCalendar历史记录(配置):承诺 <标注 变化历史> 翻译:

所需范围 : 自动化: 日历: 已读

参数

名称类型说明
全部配置布尔当作假时,最新的历史记录不会被退回.

默认 : false
配置.id*必须字符串一个 UUID 字符串来识别此业务日历 .

回返

返回类型状态代码说明
标注 变化历史200个

掷出

错误类型错误消息
信封错误
代码示例
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";

const data =
  await businessCalendarsClient.getBusinessCalendarHistoryRecords(
    { id: "..." },
  );

获取商务算法

calendarsClient.get BusinessCalendars(配置):承诺 <分层商业响应列表> 翻译:

所需范围 : 自动化: 日历: 已读

参数

名称类型说明
配置.限制编号每页返回的结果数量.
配置。 关闭编号初始指数用来返回结果.
配置. 顺序字符串命令结果时要使用哪个字段 .
配置. 搜索字符串一个搜索术语.

回返

返回类型状态代码说明
分层商业响应列表200个

掷出

错误类型错误消息
信封错误
代码示例
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";

const data =
  await businessCalendarsClient.getBusinessCalendars();

补丁商务日历

商业交易中心.patch BusinessCalendar(配置):承诺 <商业平衡对策> 翻译:

所需范围 : 自动化: calendars: write

参数

名称类型说明
配置. 身体*必须商业分类更新
配置.id*必须字符串一个 UUID 字符串来识别此业务日历 .

回返

返回类型状态代码说明
商业平衡对策200个

掷出

错误类型错误消息
信封错误
代码示例
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";

const data =
  await businessCalendarsClient.patchBusinessCalendar({
    id: "...",
    body: {},
  });

恢复商业分类历史记录

calendarsClient.restore BusinessCalendarHistory Record(配置):承诺<void>

所需范围 : 自动化: calendars: write

参数

名称类型说明
配置.id*必须字符串一个 UUID 字符串来识别此业务日历 .
配置. version*必须字符串模式 : ^[\d]+$

回返

返回类型状态代码说明
无效200个无反应机构

掷出

错误类型错误消息
信封错误
代码示例
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";

const data =
  await businessCalendarsClient.restoreBusinessCalendarHistoryRecord(
    { id: "...", version: "..." },
  );

更新商务日历

商业交易中心( Calendars).update BusinessCalendar(配置):承诺 <商业平衡对策> 翻译:

所需范围 : 自动化: calendars: write

参数

名称类型说明
配置. 身体*必须商业分类更新
配置.id*必须字符串一个 UUID 字符串来识别此业务日历 .

回返

返回类型状态代码说明
商业平衡对策200个

掷出

错误类型错误消息
信封错误
代码示例
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";

const data =
  await businessCalendarsClient.updateBusinessCalendar({
    id: "...",
    body: {},
  });

触发事件

import { eventTriggersClient } from '@dynatrace-sdk/client-automation';

预览筛选

⚠️ 折旧

事件 Triggers Client. previewFilter( 配置): 保证 <事件 Trigger 预览回复> 翻译:

所需范围 : 自动化:工作流程:已读

参数

名称类型
配置. 身体*必须事件调试器预览请求

回返

返回类型状态代码说明
事件 Trigger 预览回复200个

掷出

错误类型错误消息
信封错误
代码示例
import { eventTriggersClient } from "@dynatrace-sdk/client-automation";

const data = await eventTriggersClient.previewFilter({
  body: {
    triggerConfiguration: {
      type: "event",
      value: { query: "..." },
    },
  },
});

处决

import { executionsClient } from '@dynatrace-sdk/client-automation';

取消执行

execution( 配置): 保证< 无效>

所需范围 : 自动化:工作流程:运行

试图取消处决. 只有在处决处于活跃状态时才能进行.

参数

名称类型说明
配置.admin 访问布尔允许访问所有工作流程/执行----额外要求 自动化:工作流程:admin

默认 : false
配置.id*必须字符串一个 UUID 字符串可以识别此执行 .

回返

返回类型状态代码说明
无效204 (韩语)无反应机构

掷出

错误类型错误消息
信封错误
代码示例
import { executionsClient } from "@dynatrace-sdk/client-automation";

const data = await executionsClient.cancelExecution({
  id: "...",
});

取消任务执行

execution( 配置): 保证< 无效>

所需范围 : 自动化:工作流程:运行

取消任务执行 . 取消处决行动导致任务被取消 导致工作流程被取消 .

参数

名称类型说明
配置.admin 访问布尔允许访问所有工作流程/执行----额外要求 自动化:工作流程:admin

默认 : false
配置. 执行Id*必须字符串
配置.id*必须字符串任务名称

回返

返回类型状态代码说明
无效200个无反应机构

掷出

错误类型错误消息
信封错误
代码示例
import { executionsClient } from "@dynatrace-sdk/client-automation";

const data = await executionsClient.cancelTaskExecution({
  executionId: "...",
  id: "...",
});

获取全部事件日志

执行 Client. get AllEventLogs( 配置): 保证 <事件日志> 翻译:

所需范围 : 自动化:工作流程:已读

获取全部事件日志

参数

名称类型说明
配置.admin 访问布尔允许访问所有工作流程/执行----额外要求 自动化:工作流程:admin

默认 : false
配置.id*必须字符串一个 UUID 字符串可以识别此执行 .

回返

返回类型状态代码说明
事件日志200个

掷出

错误类型错误消息
信封错误
代码示例
import { executionsClient } from "@dynatrace-sdk/client-automation";

const data = await executionsClient.getAllEventLogs({
  id: "...",
});

获取执行

execution( 配置): 许诺 <执行> 翻译:

所需范围 : 自动化:工作流程:已读

获得执行

参数

名称类型说明
配置.admin 访问布尔允许访问所有工作流程/执行----额外要求 自动化:工作流程:admin

默认 : false
配置.id*必须字符串一个 UUID 字符串可以识别此执行 .

回返

返回类型状态代码说明
执行200个

掷出

错误类型错误消息
信封错误
代码示例
import { executionsClient } from "@dynatrace-sdk/client-automation";

const data = await executionsClient.getExecution({
  id: "...",
});

获取执行动作

execution Actions(配置):承诺 <Array < [string](https://developer.mozila.org/en-US/docs/Glossary/String) *

所需范围 : 自动化:工作流程:已读

返回指定执行中指派任务的行动列表 .

参数

名称类型说明
配置.admin 访问布尔允许访问所有工作流程/执行----额外要求 自动化:工作流程:admin

默认 : false
配置.id*必须字符串一个 UUID 字符串可以识别此执行 .

回返

返回类型状态代码说明
无效200个

掷出

错误类型错误消息
信封错误
代码示例
import { executionsClient } from "@dynatrace-sdk/client-automation";

const data = await executionsClient.getExecutionActions({
  id: "...",
});

获取执行日志

executionLog(配置):承诺<[字符串](https://developer.mozila.org/en-US/docs/Glossary/String)>

所需范围 : 自动化:工作流程:已读

获取执行日志

参数

名称类型说明
配置.admin 访问布尔允许访问所有工作流程/执行----额外要求 自动化:工作流程:admin

默认 : false
配置.id*必须字符串一个 UUID 字符串可以识别此执行 .

回返

返回类型状态代码说明
无效200个

掷出

错误类型错误消息
信封错误
代码示例
import { executionsClient } from "@dynatrace-sdk/client-automation";

const data = await executionsClient.getExecutionLog({
  id: "...",
});

获取执行

executions( 配置): 承诺 <分解列表> 翻译:

所需范围 : 自动化:工作流程:已读

获得处决名单(草稿的执行和简单的工作流程没有包括在答复中).

参数

名称类型说明
配置.admin 访问布尔允许访问所有工作流程/执行----额外要求 自动化:工作流程:admin

默认 : false
配置.限制编号每页返回的结果数量.
配置。 关闭编号初始指数用来返回结果.
配置. 顺序字符串命令结果时要使用哪个字段 .
配置。 外观字符串
配置. parentWorkflow字符串
配置. 排程矩阵 <字符串> 翻译:多个值可以通过逗号来分隔.
配置. 搜索字符串一个搜索术语.
配置. 已启动 AtGte字符串
配置. 已启动 AtLte字符串
配置. 状态矩阵 <字符串> 翻译:多个值可以通过逗号来分隔.
配置. subworkflow of Task字符串过滤执行 parentExecution/task。 。 。 .
配置 触发字符串
配置. triggerType字符串
配置用户矩阵 <字符串> 翻译:多个值可以通过逗号来分隔.
配置. 工作流程矩阵 <字符串> 翻译:多个值可以通过逗号来分隔.

回返

返回类型状态代码说明
分解列表200个

掷出

错误类型错误消息
信封错误
代码示例
import { executionsClient } from "@dynatrace-sdk/client-automation";

const data = await executionsClient.getExecutions();

获取任务执行

executive( 配置): 保证 <任务执行> 翻译:

所需范围 : 自动化:工作流程:已读

参数

名称类型说明
配置.admin 访问布尔允许访问所有工作流程/执行----额外要求 自动化:工作流程:admin

默认 : false
配置. 执行Id*必须字符串
配置.id*必须字符串任务名称

回返

返回类型状态代码说明
任务执行200个

掷出

错误类型错误消息
信封错误
代码示例
import { executionsClient } from "@dynatrace-sdk/client-automation";

const data = await executionsClient.getTaskExecution({
  executionId: "...",
  id: "...",
});

获得任务输出

expert Client.getTaskExecution Input(config):承诺<[任何](https://www.typescriptlang.org/docs/handbook/2/ everyday-types.html#any)>

所需范围 : 自动化:工作流程:已读

返回属于 TaskExecution 的所有动作Execution 的合并输入 .

参数

名称类型说明
配置.admin 访问布尔允许访问所有工作流程/执行----额外要求 自动化:工作流程:admin

默认 : false
配置. 执行Id*必须字符串
配置.id*必须字符串任务名称

回返

返回类型状态代码说明
无效200个

掷出

错误类型错误消息
信封错误
代码示例
import { executionsClient } from "@dynatrace-sdk/client-automation";

const data = await executionsClient.getTaskExecutionInput({
  executionId: "...",
  id: "...",
});

获取任务执行日志

getTaskExecutionLog(配置):承诺 < [string](https://developer.mozila.org/en-US/docs/Glossary/String)>

所需范围 : 自动化:工作流程:已读

返回特定任务的日志输出 . 这可能是大 因为它的 STDOUT 行动 由用户定义.

参数

名称类型说明
配置.admin 访问布尔允许访问所有工作流程/执行----额外要求 自动化:工作流程:admin

默认 : false
配置. 执行Id*必须字符串
配置.id*必须字符串任务名称

回返

返回类型状态代码说明
无效200个

掷出

错误类型错误消息
信封错误
代码示例
import { executionsClient } from "@dynatrace-sdk/client-automation";

const data = await executionsClient.getTaskExecutionLog({
  executionId: "...",
  id: "...",
});

获得任务执行结果

expective.getTaskExecution Result(config):承诺<[任何](https://www.typescriptlang.org/docs/handbook/2/ everyday-types.html#any)> (中文(简体) )

所需范围 : 自动化:工作流程:已读

属于 TaskExecution 的所有动作执行器的返回合并结果 .

参数

名称类型说明
配置.admin 访问布尔允许访问所有工作流程/执行----额外要求 自动化:工作流程:admin

默认 : false
配置. 执行Id*必须字符串
配置.id*必须字符串任务名称

回返

返回类型状态代码说明
无效200个

掷出

错误类型错误消息
信封错误
代码示例
import { executionsClient } from "@dynatrace-sdk/client-automation";

const data = await executionsClient.getTaskExecutionResult({
  executionId: "...",
  id: "...",
});

获取任务执行

expecutions( 配置): 保证 <任务执行> 翻译:

所需范围 : 自动化:工作流程:已读

参数

名称类型说明
配置.admin 访问布尔允许访问所有工作流程/执行----额外要求 自动化:工作流程:admin

默认 : false
配置. 执行Id*必须字符串

回返

返回类型状态代码说明
任务执行200个

掷出

错误类型错误消息
信封错误
代码示例
import { executionsClient } from "@dynatrace-sdk/client-automation";

const data = await executionsClient.getTaskExecutions({
  executionId: "...",
});

获取过渡

执行 Client. get Transitions( 配置): 保证 <任务转换> 翻译:

所需范围 : 自动化:工作流程:已读

参数

名称类型说明
配置.admin 访问布尔允许访问所有工作流程/执行----额外要求 自动化:工作流程:admin

默认 : false
配置. 执行Id*必须字符串

回返

返回类型状态代码说明
任务转换200个

掷出

错误类型错误消息
信封错误
代码示例
import { executionsClient } from "@dynatrace-sdk/client-automation";

const data = await executionsClient.getTransitions({
  executionId: "...",
});

暂停执行

execution(配置):承诺<void>

所需范围 : 自动化:工作流程:运行

暂停处决. 只有在处决处于活跃状态时才能进行.

参数

名称类型说明
配置.admin 访问布尔允许访问所有工作流程/执行----额外要求 自动化:工作流程:admin

默认 : false
配置.id*必须字符串一个 UUID 字符串可以识别此执行 .

回返

返回类型状态代码说明
无效204 (韩语)无反应机构

掷出

错误类型错误消息
信封错误
代码示例
import { executionsClient } from "@dynatrace-sdk/client-automation";

const data = await executionsClient.pauseExecution({
  id: "...",
});

恢复执行

executive( 配置): 保证< 无效>

所需范围 : 自动化:工作流程:运行

恢复处决. 只有执行处于不活动状态时才能完成.

参数

名称类型说明
配置.admin 访问布尔允许访问所有工作流程/执行----额外要求 自动化:工作流程:admin

默认 : false
配置.id*必须字符串一个 UUID 字符串可以识别此执行 .

回返

返回类型状态代码说明
无效204 (韩语)无反应机构

掷出

错误类型错误消息
信封错误
代码示例
import { executionsClient } from "@dynatrace-sdk/client-automation";

const data = await executionsClient.resumeExecution({
  id: "...",
});

调度

import { schedulesClient } from '@dynatrace-sdk/client-automation';

获取国家

附表Client.getCountries(配置):承诺 <国家列表> 翻译:

所需范围 : 自动化:工作流程:已读

返回可用于查看节假日日历的国家列表

回返

返回类型状态代码说明
国家列表200个

掷出

错误类型错误消息
信封错误
代码示例
import { schedulesClient } from "@dynatrace-sdk/client-automation";

const data = await schedulesClient.getCountries();

获取 Holiday 日历

expressClient.getHolidayCalendar(配置):承诺 <假日日历列表> 翻译:

所需范围 : 自动化:工作流程:已读

参数

名称类型说明
配置从字符串从ISO格式的日期开始
配置. key*必须字符串国名
配置( t)字符串迄今采用ISO格式

回返

返回类型状态代码说明
假日日历列表200个

掷出

错误类型错误消息
信封错误
代码示例
import { schedulesClient } from "@dynatrace-sdk/client-automation";

const data = await schedulesClient.getHolidayCalendar({
  key: "...",
});

获取时区

extableClient.getTimezones(配置):承诺 < Array < [string](https://developer.mozila.org/en-US/docs/Glossary/String) *

所需范围 : 自动化:工作流程:已读

回返

返回类型状态代码说明
无效200个

掷出

错误类型错误消息
信封错误
代码示例
import { schedulesClient } from "@dynatrace-sdk/client-automation";

const data = await schedulesClient.getTimezones();

预览附表

⚠️ 折旧

附表 Client.preview 附表(配置):承诺 <排程审查回复> 翻译:

所需范围 : 自动化:工作流程:已读

参数

名称类型
配置. 身体*必须排程审查请求

回返

返回类型状态代码说明
排程审查回复200个

掷出

错误类型错误消息
信封错误
代码示例
import { schedulesClient } from "@dynatrace-sdk/client-automation";

const data = await schedulesClient.previewSchedule({
  body: {
    schedule: {
      trigger: { type: "cron", cron: "0 0 * * *" },
    },
  },
});

调度规则

import { schedulingRulesClient } from '@dynatrace-sdk/client-automation';

创建规则

调度规则Client.create Rules(配置):承诺 <规则> 翻译:

所需范围 : 自动化: 规则: 写入

参数

名称类型
配置. 身体*必须规则创建

回返

返回类型状态代码说明
规则201 (韩语)

掷出

错误类型错误消息
信封错误
代码示例
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";

const data = await schedulingRulesClient.createRule({
  body: { title: "...", ruleType: "rrule" },
});

删除规则

排程规则Client.delate Rule(配置):承诺<void>

所需范围 : 自动化: 规则: 写入

参数

名称类型说明
配置.id*必须字符串一个 UUID 字符串表示此规则 .

回返

返回类型状态代码说明
无效204 (韩语)无反应机构

掷出

错误类型错误消息
信封错误
代码示例
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";

const data = await schedulingRulesClient.deleteRule({
  id: "...",
});

复制规则

排程规则 Client. 复制规则(配置):承诺 <规则> 翻译:

所需范围 : 自动化: 规则: 写入

参数

名称类型说明
配置. 身体*必须重复请求
配置.id*必须字符串一个 UUID 字符串表示此规则 .

回返

返回类型状态代码说明
规则201 (韩语)

掷出

错误类型错误消息
信封错误
代码示例
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";

const data = await schedulingRulesClient.duplicateRule({
  id: "...",
  body: {},
});

获取规则

排程规则Client.get Rule(配置):承诺 <规则> 翻译:

所需范围 : 自动化:规则:已读

参数

名称类型说明
配置.id*必须字符串一个 UUID 字符串表示此规则 .

回返

返回类型状态代码说明
规则200个

掷出

错误类型错误消息
信封错误
代码示例
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";

const data = await schedulingRulesClient.getRule({
  id: "...",
});

获取规则历史记录

排程规则Client.get RuleHistory Record(配置):承诺 <规则> 翻译:

所需范围 : 自动化:规则:已读

参数

名称类型说明
配置.id*必须字符串一个 UUID 字符串表示此规则 .
配置. version*必须字符串模式 : ^[\d]+$

回返

返回类型状态代码说明
规则200个

掷出

错误类型错误消息
信封错误
代码示例
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";

const data =
  await schedulingRulesClient.getRuleHistoryRecord({
    id: "...",
    version: "...",
  });

获取规则历史记录

排程规则Client.get RulesHistory Records(配置):承诺 <标注 变化历史> 翻译:

所需范围 : 自动化:规则:已读

参数

名称类型说明
全部配置布尔当作假时,最新的历史记录不会被退回.

默认 : false
配置.id*必须字符串一个 UUID 字符串表示此规则 .

回返

返回类型状态代码说明
标注 变化历史200个

掷出

错误类型错误消息
信封错误
代码示例
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";

const data =
  await schedulingRulesClient.getRuleHistoryRecords({
    id: "...",
  });

获取规则

调度规则Client.get Rules(配置):承诺 <平面规则列表> 翻译:

所需范围 : 自动化:规则:已读

参数

名称类型说明
配置.限制编号每页返回的结果数量.
配置。 关闭编号初始指数用来返回结果.
配置. 顺序字符串命令结果时要使用哪个字段 .
配置. 搜索字符串一个搜索术语.

回返

返回类型状态代码说明
平面规则列表200个

掷出

错误类型错误消息
信封错误
代码示例
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";

const data = await schedulingRulesClient.getRules();

补丁规则

调度规则Client.patch Rule(配置):承诺 <规则> 翻译:

所需范围 : 自动化: 规则: 写入

参数

名称类型说明
配置. 身体*必须规则更新
配置.id*必须字符串一个 UUID 字符串表示此规则 .

回返

返回类型状态代码说明
规则200个

掷出

错误类型错误消息
信封错误
代码示例
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";

const data = await schedulingRulesClient.patchRule({
  id: "...",
  body: {},
});

预览规则

⚠️ 折旧

调度规则 Client. preview Rules( 配置): 承诺 <规则审查回复> 翻译:

所需范围 : 自动化:工作流程:已读

参数

名称类型
配置. 身体*必须规则审查创建

回返

返回类型状态代码说明
规则审查回复200个

掷出

错误类型错误消息
信封错误
代码示例
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";

const data = await schedulingRulesClient.previewRule({
  body: {
    ruleType: "rrule",
    rrule: { freq: "YEARLY", datestart: "..." },
  },
});

恢复规则历史记录

排程规则Client.restore RuleHistory Record(配置):承诺<void>

所需范围 : 自动化: 规则: 写入

参数

名称类型说明
配置.id*必须字符串一个 UUID 字符串表示此规则 .
配置. version*必须字符串模式 : ^[\d]+$

回返

返回类型状态代码说明
无效200个无反应机构

掷出

错误类型错误消息
信封错误
代码示例
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";

const data =
  await schedulingRulesClient.restoreRuleHistoryRecord({
    id: "...",
    version: "...",
  });

更新规则

排程规则Client.update Rules(配置):承诺 <规则> 翻译:

所需范围 : 自动化: 规则: 写入

参数

名称类型说明
配置. 身体*必须规则更新
配置.id*必须字符串一个 UUID 字符串表示此规则 .

回返

返回类型状态代码说明
规则200个

掷出

错误类型错误消息
信封错误
代码示例
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";

const data = await schedulingRulesClient.updateRule({
  id: "...",
  body: {},
});

设置

import { settingsClient } from '@dynatrace-sdk/client-automation';

获取服务用户

⚠️ 折旧

设置 Client. get Service Users( 配置): 保证 <获取服务用户响应> 翻译:

所需范围 : 自动化:工作流程:已读

获取可用作工作流程演员的服务用户( 已贬值) .

回返

返回类型状态代码说明
无效200个

掷出

错误类型错误消息
信封错误
代码示例
import { settingsClient } from "@dynatrace-sdk/client-automation";

const data = await settingsClient.getServiceUsers();

获取设置

⚠️ 折旧

设置 Client.getSettings( 配置): 保证 <获取定居响应> 翻译:

所需范围 : 自动化:工作流程:已读

获取系统设置

回返

返回类型状态代码说明
获取定居响应200个

掷出

错误类型错误消息
信封错误
代码示例
import { settingsClient } from "@dynatrace-sdk/client-automation";

const data = await settingsClient.getSettings();

用户许可

⚠️ 折旧

设置 Client.getUserPermissions(配置):承诺 < Array < [string](https://developer.mozila.org/en-US/docs/Glossary/String)

所需范围 : 自动化:工作流程:已读

获取当前用户有效权限 .

回返

返回类型状态代码说明
无效200个

掷出

错误类型错误消息
信封错误
代码示例
import { settingsClient } from "@dynatrace-sdk/client-automation";

const data = await settingsClient.getUserPermissions();

获取用户设置

⚠️ 折旧

设置 Client. get UserSettings( 配置): 保证 <用户设置> 翻译:

所需范围 : 自动化:工作流程:已读

获取用户特定设置

回返

返回类型状态代码说明
用户设置200个

掷出

错误类型错误消息
信封错误
代码示例
import { settingsClient } from "@dynatrace-sdk/client-automation";

const data = await settingsClient.getUserSettings();

更新授权

⚠️ 折旧

设置 Client.update Authorizations( 配置): 保证<void>

所需范围 : 自动化:工作流程:已读

回返

返回类型状态代码说明
无效202 (韩语)无反应机构

掷出

错误类型错误消息
信封错误
代码示例
import { settingsClient } from "@dynatrace-sdk/client-automation";

const data = await settingsClient.updateAuthorizations();

版本客户端

import { versionClient } from '@dynatrace-sdk/client-automation';

获取版本

版本Client.getVersion(配置):承诺 <版本响应> 翻译:

所需范围 : 自动化:工作流程:已读

回返

返回类型状态代码说明
版本响应200个

掷出

错误类型错误消息
信封错误
代码示例
import { versionClient } from "@dynatrace-sdk/client-automation";

const data = await versionClient.getVersion();

网约车

import { webhookHandlersClient } from '@dynatrace-sdk/client-automation';

删除Webhook汉德勒

webhookHandlers Client.deleteWebhookHandler(配置):承诺<void> 页面存档备份,存于互联网档案馆 互联网档案馆的存檔,存档日期2011-12-22

所需范围 : 自动化: webhookhandlers: write :

参数

名称类型说明
配置. 连接Id*必须字符串此 Webhook 处理器所属的连接的ID

回返

返回类型状态代码说明
无效204 (韩语)无反应机构

掷出

错误类型错误消息
信封错误
代码示例
import { webhookHandlersClient } from "@dynatrace-sdk/client-automation";

const data =
  await webhookHandlersClient.deleteWebhookHandler({
    connectionId: "...",
  });

获得韦布克汉德勒

webhookHandlersClient.getWebhookHandler(配置):承诺 <韦伯霍克汉德勒> 翻译:

所需范围 : 自动化:webhookhandlers: read

参数

名称类型说明
配置. 连接Id*必须字符串此 Webhook 处理器所属的连接的ID

回返

返回类型状态代码说明
韦伯霍克汉德勒200个

掷出

错误类型错误消息
信封错误
代码示例
import { webhookHandlersClient } from "@dynatrace-sdk/client-automation";

const data = await webhookHandlersClient.getWebhookHandler({
  connectionId: "...",
});

获取WebhookHandlers 软件

webhookHandlers Client.getWebhookHandlers(配置):保证<Array>网络汉字列表>>

所需范围 : 自动化:webhookhandlers: read

回返

返回类型状态代码说明
网络汉字列表200个

掷出

错误类型错误消息
信封错误
代码示例
import { webhookHandlersClient } from "@dynatrace-sdk/client-automation";

const data =
  await webhookHandlersClient.getWebhookHandlers();

写出WebhookHandler

webhook Handlers Client.write WebhookHandler(配置): 承诺 <韦伯霍克汉德勒> 翻译:

所需范围 : 自动化: webhookhandlers: write :

参数

名称类型说明
配置. 身体*必须韦伯霍克汉德勒 Write
配置. 连接Id*必须字符串此 Webhook 处理器所属的连接的ID

回返

返回类型状态代码说明
韦伯霍克汉德勒200个

掷出

错误类型错误消息
信封错误
代码示例
import { webhookHandlersClient } from "@dynatrace-sdk/client-automation";

const data =
  await webhookHandlersClient.writeWebhookHandler({
    connectionId: "...",
    body: {
      active: false,
      validationMethod: "slack",
      eventSignatureHeader: "...",
    },
  });

工作流程

import { workflowsClient } from '@dynatrace-sdk/client-automation';

创建工作流程

工作流程 Client.createWorkflow(配置):承诺 <工作流程> 翻译:

所需范围 : 自动化: 工作流程: 写入

创建工作流程并设定用法

参数

名称类型说明
配置.admin 访问布尔允许访问所有工作流程/执行----额外要求 自动化:工作流程:admin

默认 : false
配置. 身体*必须工作流程创造

回返

返回类型状态代码说明
工作流程201 (韩语)

掷出

错误类型错误消息
信封错误
代码示例
import { workflowsClient } from "@dynatrace-sdk/client-automation";

const data = await workflowsClient.createWorkflow({
  body: { title: "...", throttle: { isLimitHit: false } },
});

删除已崩溃的工作流程

工作流程 Client.delateTrashedWorkflow(配置):承诺<void>

所需范围 : 自动化: 工作流程: 写入

永久删除垃圾堆中的工作流程 。 如果工作流程不存在或没有在垃圾桶中,则返回 404 .

参数

名称类型说明
配置.admin 访问布尔允许访问所有工作流程/执行----额外要求 自动化:工作流程:admin

默认 : false
配置.id*必须字符串一个 UUID 字符串来识别此工作流程 .

回返

返回类型状态代码说明
无效204 (韩语)无反应机构

掷出

错误类型错误消息
信封错误
代码示例
import { workflowsClient } from "@dynatrace-sdk/client-automation";

const data = await workflowsClient.deleteTrashedWorkflow({
  id: "...",
});

删除工作流程

工作流程Client.delateWorkflow(配置):承诺<void>

所需范围 : 自动化: 工作流程: 写入

将工作流程移动到垃圾堆( N)trash=true)或永久删除(trash=false 或省略)。 中断的工作流程可以通过 /trash/workflows/{id}。 。 。 .

参数

名称类型说明
配置.admin 访问布尔允许访问所有工作流程/执行----额外要求 自动化:工作流程:admin

默认 : false
配置.id*必须字符串一个 UUID 字符串来识别此工作流程 .
配置. 废物布尔何时 true,将工作流程移动到垃圾堆中,而不是永久删除。 重复的工作流程是

版本与发布记录

@dynatrace-sdk/client-automation 共发布 50 个版本,首次发布于 2023/04/24;过去 12 个月发布了 10 个版本。

版本发布日期距今
8.10.0latest2026/10/1628 天前
8.7.02026/09/241 个月前
8.5.02026/09/072 个月前
8.4.02026/07/283 个月前
8.2.12026/06/304 个月前
8.1.02026/06/174 个月前

关于 @dynatrace-sdk/client-automation 的常见问题

@dynatrace-sdk/client-automation 是什么?

自动化API允许与工作流程和各种触发选项合作.

如何安装 @dynatrace-sdk/client-automation?

在项目目录运行 npm install @dynatrace-sdk/client-automation,或使用 pnpm add / yarn add / bun add。

@dynatrace-sdk/client-automation 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@dynatrace-sdk/client-automation 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@dynatrace-sdk/client-automation 可以商用吗?

@dynatrace-sdk/client-automation 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@dynatrace-sdk/client-automation 的下载量有多少?

根据 npm 官方下载统计,@dynatrace-sdk/client-automation 在 2026/10/13 – 2026/11/11 这 30 天内被下载 3,505 次,日均约 117 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@dynatrace-sdk/client-automation 还在维护吗?

最新版本 8.10.0 发布于 2026/10/16(28 天前);至今共发布 50 个版本,其中过去 12 个月发布了 10 个;首次发布于 2023/04/24。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。