@dynatrace-sdk/client-automation v3.0.2
@dynatrace-sdk/client-automation
Automation API allows working with workflows and various trigger options.
Installation
npm install @dynatrace-sdk/client-automation
Getting help
- Visit SDK for Typescript guide in the Dynatrace Developer
- Ask a question in the Dynatrace Community
License
This SDK is distributed under the Apache License, Version 2.0, see LICENSE for more information.
API reference
Full API reference for the latest version of the SDK is also available at the Dynatrace Developer.
actionExecutionsClient
import { actionExecutionsClient } from '@dynatrace-sdk/client-automation';
getActionExecution
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.id*required | string | A UUID string identifying this action execution. |
import { actionExecutionsClient } from "@dynatrace-sdk/client-automation";
const data =
await actionExecutionsClient.getActionExecution({
id: "...",
});
getActionExecutionLog
Required scope: automation:workflows:read
Returns the log output of a specific ActionExecution.
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.id*required | string | A UUID string identifying this action execution. |
import { actionExecutionsClient } from "@dynatrace-sdk/client-automation";
const data =
await actionExecutionsClient.getActionExecutionLog({
id: "...",
});
actionsSampleResultClient
import { actionsSampleResultClient } from '@dynatrace-sdk/client-automation';
getActionSampleResult
Required scope: automation:workflows:read
Parameters
Name | Type |
---|---|
config.actionIdentifier*required | string |
import { actionsSampleResultClient } from "@dynatrace-sdk/client-automation";
const data =
await actionsSampleResultClient.getActionSampleResult({
actionIdentifier: "...",
});
businessCalendarsClient
import { businessCalendarsClient } from '@dynatrace-sdk/client-automation';
createBusinessCalendar
Required scope: automation:calendars:write
Parameters
Name | Type |
---|---|
config.body*required | BusinessCalendarRequest |
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";
const data =
await businessCalendarsClient.createBusinessCalendar({
body: { title: "..." },
});
deleteBusinessCalendar
Required scope: automation:calendars:write
Parameters
Name | Type | Description |
---|---|---|
config.id*required | string | A UUID string identifying this business calendar. |
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";
const data =
await businessCalendarsClient.deleteBusinessCalendar({
id: "...",
});
duplicateBusinessCalendar
Required scope: automation:calendars:write
Parameters
Name | Type | Description |
---|---|---|
config.body*required | DuplicationRequest | |
config.id*required | string | A UUID string identifying this business calendar. |
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";
const data =
await businessCalendarsClient.duplicateBusinessCalendar({
id: "...",
body: {},
});
getBusinessCalendar
Required scope: automation:calendars:read
Parameters
Name | Type | Description |
---|---|---|
config.id*required | string | A UUID string identifying this business calendar. |
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";
const data =
await businessCalendarsClient.getBusinessCalendar({
id: "...",
});
getBusinessCalendarHistoryRecord
Required scope: automation:calendars:read
Parameters
Name | Type | Description |
---|---|---|
config.id*required | string | A UUID string identifying this business calendar. |
config.version*required | string |
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";
const data =
await businessCalendarsClient.getBusinessCalendarHistoryRecord(
{ id: "...", version: "..." },
);
getBusinessCalendarHistoryRecords
Required scope: automation:calendars:read
Parameters
Name | Type | Description |
---|---|---|
config.id*required | string | A UUID string identifying this business calendar. |
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";
const data =
await businessCalendarsClient.getBusinessCalendarHistoryRecords(
{ id: "..." },
);
getBusinessCalendars
Required scope: automation:calendars:read
Parameters
Name | Type | Description |
---|---|---|
config.limit | number | Number of results to return per page. |
config.offset | number | The initial index from which to return the results. |
config.ordering | string | Which field to use when ordering the results. |
config.search | string | A search term. |
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";
const data =
await businessCalendarsClient.getBusinessCalendars();
patchBusinessCalendar
Required scope: automation:calendars:write
Parameters
Name | Type | Description |
---|---|---|
config.body*required | PatchedBusinessCalendarRequest | |
config.id*required | string | A UUID string identifying this business calendar. |
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";
const data =
await businessCalendarsClient.patchBusinessCalendar({
id: "...",
body: {},
});
restoreBusinessCalendarHistoryRecord
Required scope: automation:calendars:write
Parameters
Name | Type | Description |
---|---|---|
config.id*required | string | A UUID string identifying this business calendar. |
config.version*required | string |
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";
const data =
await businessCalendarsClient.restoreBusinessCalendarHistoryRecord(
{ id: "...", version: "..." },
);
updateBusinessCalendar
Required scope: automation:calendars:write
Parameters
Name | Type | Description |
---|---|---|
config.body*required | BusinessCalendarRequest | |
config.id*required | string | A UUID string identifying this business calendar. |
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";
const data =
await businessCalendarsClient.updateBusinessCalendar({
id: "...",
body: { title: "..." },
});
eventTriggersClient
import { eventTriggersClient } from '@dynatrace-sdk/client-automation';
previewFilter
Required scope: automation:workflows:read
Parameters
Name | Type |
---|---|
config.body*required | EventTriggerPreviewRequest |
import { eventTriggersClient } from "@dynatrace-sdk/client-automation";
const data = await eventTriggersClient.previewFilter({
body: {},
});
executionsClient
import { executionsClient } from '@dynatrace-sdk/client-automation';
cancelExecution
Required scope: automation:workflows:run
Tries to cancel an Execution. Can only be done, if the Execution is in an active state.
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.id*required | string | A UUID string identifying this execution. |
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.cancelExecution({
id: "...",
});
cancelTaskExecution
Required scope: automation:workflows:run
Cancels task execution. Canceling action executions cause the task to be cancelled, which causes the workflow to be canceled.
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.executionId*required | string | |
config.id*required | string | Task name |
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.cancelTaskExecution({
executionId: "...",
id: "...",
});
getAllEventLogs
Required scope: automation:workflows:read
Get all event logs
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.id*required | string | A UUID string identifying this execution. |
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.getAllEventLogs({
id: "...",
});
getExecution
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.id*required | string | A UUID string identifying this execution. |
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.getExecution({
id: "...",
});
getExecutionActions
Required scope: automation:workflows:read
Return list of actions assigned to tasks in a given Execution.
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.id*required | string | A UUID string identifying this execution. |
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.getExecutionActions({
id: "...",
});
getExecutionLog
Required scope: automation:workflows:read
Gets the execution log
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.id*required | string | A UUID string identifying this execution. |
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.getExecutionLog({
id: "...",
});
getExecutions
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.limit | number | Number of results to return per page. |
config.offset | number | The initial index from which to return the results. |
config.ordering | string | Which field to use when ordering the results. |
config.schedule | Array<string> | Multiple values may be separated by commas. |
config.search | string | A search term. |
config.startedAtGte | string | |
config.startedAtLte | string | |
config.state | Array<string> | Multiple values may be separated by commas. |
config.task | string | |
config.trigger | string | |
config.triggerType | string | |
config.user | Array<string> | Multiple values may be separated by commas. |
config.workflow | Array<string> | Multiple values may be separated by commas. |
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.getExecutions();
getTaskExecution
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.executionId*required | string | |
config.id*required | string | Task name |
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.getTaskExecution({
executionId: "...",
id: "...",
});
getTaskExecutionInput
Required scope: automation:workflows:read
Returns merged inputs from all ActionExecutions belonging to the TaskExecution.
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.executionId*required | string | |
config.id*required | string | Task name |
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.getTaskExecutionInput({
executionId: "...",
id: "...",
});
getTaskExecutionLog
Required scope: automation:workflows:read
Returns the log output of a specific task. This can be large as its the STDOUT of the Action as defined by the user.
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.executionId*required | string | |
config.id*required | string | Task name |
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.getTaskExecutionLog({
executionId: "...",
id: "...",
});
getTaskExecutionResult
Required scope: automation:workflows:read
Returns merged results from all ActionExecutions belonging to the TaskExecution.
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.executionId*required | string | |
config.id*required | string | Task name |
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.getTaskExecutionResult({
executionId: "...",
id: "...",
});
getTaskExecutions
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.executionId*required | string |
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.getTaskExecutions({
executionId: "...",
});
getTransitions
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.executionId*required | string |
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.getTransitions({
executionId: "...",
});
pauseExecution
Required scope: automation:workflows:run
Pauses an Execution. Can only be done, if the Execution is in an active state.
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.id*required | string | A UUID string identifying this execution. |
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.pauseExecution({
id: "...",
});
previewTaskInput
Required scope: automation:workflows:read
Returns preview expression by given task id from the workflow definition
Parameters
Name | Type |
---|---|
config.body*required | PreviewTaskInputRequest |
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.previewTaskInput({
body: {
task: "...",
workflow: {
title: "...",
throttle: { isLimitHit: false },
},
},
});
resumeExecution
Required scope: automation:workflows:run
Resumes an Execution. Can only be done, if the Execution is in an inactive state.
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.id*required | string | A UUID string identifying this execution. |
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.resumeExecution({
id: "...",
});
schedulesClient
import { schedulesClient } from '@dynatrace-sdk/client-automation';
getHolidayCalendar
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|---|---|
config.from | string | From date in ISO format |
config.key*required | string | |
config.to | string | To date in ISO format |
import { schedulesClient } from "@dynatrace-sdk/client-automation";
const data = await schedulesClient.getHolidayCalendar({
key: "...",
});
getHolidayCalendars
Required scope: automation:workflows:read
import { schedulesClient } from "@dynatrace-sdk/client-automation";
const data = await schedulesClient.getHolidayCalendars();
getTimezones
Required scope: automation:workflows:read
import { schedulesClient } from "@dynatrace-sdk/client-automation";
const data = await schedulesClient.getTimezones();
previewSchedule
Required scope: automation:workflows:read
Parameters
Name | Type |
---|---|
config.body*required | SchedulePreviewRequest |
import { schedulesClient } from "@dynatrace-sdk/client-automation";
const data = await schedulesClient.previewSchedule({
body: { schedule: {} },
});
schedulingRulesClient
import { schedulingRulesClient } from '@dynatrace-sdk/client-automation';
createRule
Required scope: automation:rules:write
Parameters
Name | Type |
---|---|
config.body*required | RuleRequest |
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";
const data = await schedulingRulesClient.createRule({
body: { title: "..." },
});
deleteRule
Required scope: automation:rules:write
Parameters
Name | Type | Description |
---|---|---|
config.id*required | string | A UUID string identifying this rule. |
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";
const data = await schedulingRulesClient.deleteRule({
id: "...",
});
duplicateRule
Required scope: automation:rules:write
Parameters
Name | Type | Description |
---|---|---|
config.body*required | DuplicationRequest | |
config.id*required | string | A UUID string identifying this rule. |
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";
const data = await schedulingRulesClient.duplicateRule({
id: "...",
body: {},
});
getRule
Required scope: automation:rules:read
Parameters
Name | Type | Description |
---|---|---|
config.id*required | string | A UUID string identifying this rule. |
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";
const data = await schedulingRulesClient.getRule({
id: "...",
});
getRuleHistoryRecord
Required scope: automation:rules:read
Parameters
Name | Type | Description |
---|---|---|
config.id*required | string | A UUID string identifying this rule. |
config.version*required | string |
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";
const data =
await schedulingRulesClient.getRuleHistoryRecord({
id: "...",
version: "...",
});
getRuleHistoryRecords
Required scope: automation:rules:read
Parameters
Name | Type | Description |
---|---|---|
config.id*required | string | A UUID string identifying this rule. |
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";
const data =
await schedulingRulesClient.getRuleHistoryRecords({
id: "...",
});
getRules
Required scope: automation:rules:read
Parameters
Name | Type | Description |
---|---|---|
config.limit | number | Number of results to return per page. |
config.offset | number | The initial index from which to return the results. |
config.ordering | string | Which field to use when ordering the results. |
config.search | string | A search term. |
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";
const data = await schedulingRulesClient.getRules();
patchRule
Required scope: automation:rules:write
Parameters
Name | Type | Description |
---|---|---|
config.body*required | PatchedRuleRequest | |
config.id*required | string | A UUID string identifying this rule. |
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";
const data = await schedulingRulesClient.patchRule({
id: "...",
body: {},
});
previewRule
Required scope: automation:workflows:read
Parameters
Name | Type |
---|---|
config.body*required | RulePreviewRequest |
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";
const data = await schedulingRulesClient.previewRule({
body: {},
});
restoreRuleHistoryRecord
Required scope: automation:rules:write
Parameters
Name | Type | Description |
---|---|---|
config.id*required | string | A UUID string identifying this rule. |
config.version*required | string |
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";
const data =
await schedulingRulesClient.restoreRuleHistoryRecord({
id: "...",
version: "...",
});
updateRule
Required scope: automation:rules:write
Parameters
Name | Type | Description |
---|---|---|
config.body*required | RuleRequest | |
config.id*required | string | A UUID string identifying this rule. |
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";
const data = await schedulingRulesClient.updateRule({
id: "...",
body: { title: "..." },
});
settingsClient
import { settingsClient } from '@dynatrace-sdk/client-automation';
getServiceUsers
Required scope: automation:workflows:read
Get service users who could be used as workflow actor
import { settingsClient } from "@dynatrace-sdk/client-automation";
const data = await settingsClient.getServiceUsers();
getSettings
Required scope: automation:workflows:read
Get system settings
import { settingsClient } from "@dynatrace-sdk/client-automation";
const data = await settingsClient.getSettings();
getUserPermissions
Required scope: automation:workflows:read
Get current user effective permissions.
import { settingsClient } from "@dynatrace-sdk/client-automation";
const data = await settingsClient.getUserPermissions();
getUserSettings
Required scope: automation:workflows:read
Get user-specific settings
import { settingsClient } from "@dynatrace-sdk/client-automation";
const data = await settingsClient.getUserSettings();
updateAuthorizations
Required scope: automation:workflows:write
import { settingsClient } from "@dynatrace-sdk/client-automation";
const data = await settingsClient.updateAuthorizations();
versionClient
import { versionClient } from '@dynatrace-sdk/client-automation';
getVersion
Required scope: automation:workflows:read
import { versionClient } from "@dynatrace-sdk/client-automation";
const data = await versionClient.getVersion();
workflowsClient
import { workflowsClient } from '@dynatrace-sdk/client-automation';
createWorkflow
Required scope: automation:workflows:write
Creates a workflow and sets usages
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.body*required | WorkflowRequest |
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data = await workflowsClient.createWorkflow({
body: { title: "...", throttle: { isLimitHit: false } },
});
deleteWorkflow
Required scope: automation:workflows:write
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.id*required | string | A UUID string identifying this workflow. |
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data = await workflowsClient.deleteWorkflow({
id: "...",
});
duplicateWorkflow
Required scope: automation:workflows:write
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.body*required | DuplicationRequest | |
config.id*required | string | A UUID string identifying this workflow. |
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data = await workflowsClient.duplicateWorkflow({
id: "...",
body: {},
});
getWorkflow
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.id*required | string | A UUID string identifying this workflow. |
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data = await workflowsClient.getWorkflow({
id: "...",
});
getWorkflowActions
Required scope: automation:workflows:read
Return list of actions assigned to tasks in a given Workflow.
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.id*required | string | A UUID string identifying this workflow. |
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data = await workflowsClient.getWorkflowActions({
id: "...",
});
getWorkflowHistoryRecord
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.id*required | string | A UUID string identifying this workflow. |
config.version*required | string |
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data = await workflowsClient.getWorkflowHistoryRecord(
{ id: "...", version: "..." },
);
getWorkflowHistoryRecords
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.id*required | string | A UUID string identifying this workflow. |
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data =
await workflowsClient.getWorkflowHistoryRecords({
id: "...",
});
getWorkflowTask
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.id*required | string | |
config.workflowId*required | string |
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data = await workflowsClient.getWorkflowTask({
id: "...",
workflowId: "...",
});
getWorkflowTasks
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.id*required | string | A UUID string identifying this workflow. |
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data = await workflowsClient.getWorkflowTasks({
id: "...",
});
getWorkflows
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.id | string | |
config.lastExecutionStateIn | Array<string> | Multiple values may be separated by commas. |
config.limit | number | Number of results to return per page. |
config.modificationInfoLastModifiedBy | Array<string> | Multiple values may be separated by commas. |
config.offset | number | The initial index from which to return the results. |
config.ordering | string | Which field to use when ordering the results. |
config.owner | string | |
config.ownerType | GetWorkflowsQueryOwnerType | USER - USER GROUP - GROUP |
config.search | string | A search term. |
config.throttleIsLimitHit | boolean | |
config.triggerScheduleIsFaulty | boolean | |
config.triggerType | string | |
config.usages | string |
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data = await workflowsClient.getWorkflows();
patchWorkflow
Required scope: automation:workflows:write
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.body*required | PatchedWorkflowRequest | |
config.id*required | string | A UUID string identifying this workflow. |
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data = await workflowsClient.patchWorkflow({
id: "...",
body: { throttle: { isLimitHit: false } },
});
restoreWorkflowHistoryRecord
Required scope: automation:workflows:write
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.id*required | string | A UUID string identifying this workflow. |
config.version*required | string |
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data =
await workflowsClient.restoreWorkflowHistoryRecord({
id: "...",
version: "...",
});
runWorkflow
Required scope: automation:workflows:run
Creates an Execution for the Workflow.
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.body*required | ExecutionInputsRequest | |
config.id*required | string | A UUID string identifying this workflow. |
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data = await workflowsClient.runWorkflow({
id: "...",
body: {},
});
updateWorkflow
Required scope: automation:workflows:write
Parameters
Name | Type | Description |
---|---|---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin default: false |
config.body*required | WorkflowRequest | |
config.id*required | string | A UUID string identifying this workflow. |
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data = await workflowsClient.updateWorkflow({
id: "...",
body: { title: "...", throttle: { isLimitHit: false } },
});
Types
ActionExecution
Name | Type | Description |
---|---|---|
action*required | string | |
actionExecutionId | null | string | |
attempt | number | |
endedAt | null | Date | |
id | string | |
input | ActionExecutionInput | |
loopItem | ActionExecutionLoopItem | |
result | any | |
runtime | null | number | |
startedAt | null | Date | |
state | ActionExecutionState | |
stateInfo | null | string | |
taskExe | null | string | Parent task execution |
ActionExecutionInput
ActionExecutionLoopItem
BusinessCalendar
Name | Type |
---|---|
description | string |
holidays | Holidays |
id | string |
modificationInfo*required | ModificationInfo |
title*required | string |
validFrom | Date |
validTo | Date |
version*required | number |
weekdays | Weekdays |
weekstart | number |
BusinessCalendarRequest
Name | Type |
---|---|
description | string |
holidays | Holidays |
id | string |
title*required | string |
validFrom | Date |
validTo | Date |
weekdays | Weekdays |
weekstart | number |
ChangeHistory
Name | Type |
---|---|
dateCreated*required | Date |
id*required | number |
user*required | string |
version*required | number |
CronTrigger
Name | Type |
---|---|
cron*required | string |
type*required | Cron |
DavisEventConfig
Name | Type | Default |
---|---|---|
customFilter | string | |
entityTags | EntityTags | {} |
entityTagsMatch | EntityTagsMatch | |
names | Array<DavisEventName> | |
onProblemClose | boolean | false |
types | Array<string> |
DavisEventName
Name | Type |
---|---|
match*required | DavisEventNameMatch |
name*required | string |
DavisEventTriggerConfig
Name | Type |
---|---|
type*required | DavisEvent |
value*required | DavisEventConfig |
DavisProblemCategories
Name | Type |
---|---|
availability | boolean |
custom | boolean |
error | boolean |
info | boolean |
monitoringUnavailable | boolean |
resource | boolean |
slowdown | boolean |
DavisProblemConfig
Name | Type | Default |
---|---|---|
categories*required | DavisProblemCategories | |
customFilter | string | |
entityTags | EntityTags | {} |
entityTagsMatch | EntityTagsMatch | |
onProblemClose | boolean | false |
DavisProblemTriggerConfig
Name | Type |
---|---|
type*required | DavisProblem |
value*required | DavisProblemConfig |
DuplicationRequest
Name | Type |
---|---|
title | string |
EntityTags
Error
Name | Type |
---|---|
details | ErrorDetails |
message*required | string |
ErrorDetails
ErrorEnvelope
Name | Type |
---|---|
error*required | Error |
EventLog
Name | Type |
---|---|
cause*required | string |
context | Record<string | any> |
event*required | string |
source*required | Source |
state*required | EventLogState |
timestamp*required | Date |
EventLogs
extends Array<EventLog>
Name | Type | Description |
---|---|---|
length*required | number | Gets or sets the length of the array. This is a number one higher than the highest index in the array. |