@dynatrace-sdk/client-automation
![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)
Manage and run workflows with the AutomationEngine API.
Installation
npm install @dynatrace-sdk/client-automation
Getting help
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
actionExecutionsClient.getActionExecution(config): Promise<ActionExecution>
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin |
config.id*required | string | A UUID string identifying this action execution. |
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { actionExecutionsClient } from "@dynatrace-sdk/client-automation";
const data =
await actionExecutionsClient.getActionExecution({
id: "...",
});
getActionExecutionLog
actionExecutionsClient.getActionExecutionLog(config): Promise<[string](https://developer.mozilla.org/en-US/docs/Glossary/String)>
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 |
config.id*required | string | A UUID string identifying this action execution. |
Returns
Return type | Status code | Description |
---|
void | 200 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { actionExecutionsClient } from "@dynatrace-sdk/client-automation";
const data =
await actionExecutionsClient.getActionExecutionLog({
id: "...",
});
actionsSampleResultClient
import { actionsSampleResultClient } from '@dynatrace-sdk/client-automation';
getActionSampleResult
actionsSampleResultClient.getActionSampleResult(config): Promise<[any](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#any)>
Required scope: automation:workflows:read
Parameters
Name | Type |
---|
config.actionIdentifier*required | string |
Returns
Return type | Status code | Description |
---|
void | 200 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { actionsSampleResultClient } from "@dynatrace-sdk/client-automation";
const data =
await actionsSampleResultClient.getActionSampleResult({
actionIdentifier: "...",
});
businessCalendarsClient
import { businessCalendarsClient } from '@dynatrace-sdk/client-automation';
createBusinessCalendar
businessCalendarsClient.createBusinessCalendar(config): Promise<BusinessCalendarResponse>
Required scope: automation:calendars:write
Parameters
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";
const data =
await businessCalendarsClient.createBusinessCalendar({
body: { title: "..." },
});
deleteBusinessCalendar
businessCalendarsClient.deleteBusinessCalendar(config): Promise<void>
Required scope: automation:calendars:write
Parameters
Name | Type | Description |
---|
config.id*required | string | A UUID string identifying this business calendar. |
Returns
Return type | Status code | Description |
---|
void | 204 | No response body |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";
const data =
await businessCalendarsClient.deleteBusinessCalendar({
id: "...",
});
duplicateBusinessCalendar
businessCalendarsClient.duplicateBusinessCalendar(config): Promise<BusinessCalendarResponse>
Required scope: automation:calendars:write
Parameters
Name | Type | Description |
---|
config.body*required | DuplicationRequest | |
config.id*required | string | A UUID string identifying this business calendar. |
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";
const data =
await businessCalendarsClient.duplicateBusinessCalendar({
id: "...",
body: {},
});
getBusinessCalendar
businessCalendarsClient.getBusinessCalendar(config): Promise<BusinessCalendarResponse>
Required scope: automation:calendars:read
Parameters
Name | Type | Description |
---|
config.id*required | string | A UUID string identifying this business calendar. |
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";
const data =
await businessCalendarsClient.getBusinessCalendar({
id: "...",
});
getBusinessCalendarHistoryRecord
businessCalendarsClient.getBusinessCalendarHistoryRecord(config): Promise<BusinessCalendarResponse>
Required scope: automation:calendars:read
Parameters
Name | Type | Description |
---|
config.id*required | string | A UUID string identifying this business calendar. |
config.version*required | string | |
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";
const data =
await businessCalendarsClient.getBusinessCalendarHistoryRecord(
{ id: "...", version: "..." },
);
getBusinessCalendarHistoryRecords
businessCalendarsClient.getBusinessCalendarHistoryRecords(config): Promise<PaginatedChangeHistory>
Required scope: automation:calendars:read
Parameters
Name | Type | Description |
---|
config.id*required | string | A UUID string identifying this business calendar. |
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";
const data =
await businessCalendarsClient.getBusinessCalendarHistoryRecords(
{ id: "..." },
);
getBusinessCalendars
businessCalendarsClient.getBusinessCalendars(config): Promise<PaginatedBusinessCalendarResponseList>
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. |
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";
const data =
await businessCalendarsClient.getBusinessCalendars();
patchBusinessCalendar
businessCalendarsClient.patchBusinessCalendar(config): Promise<BusinessCalendarResponse>
Required scope: automation:calendars:write
Parameters
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";
const data =
await businessCalendarsClient.patchBusinessCalendar({
id: "...",
body: {},
});
restoreBusinessCalendarHistoryRecord
businessCalendarsClient.restoreBusinessCalendarHistoryRecord(config): Promise<BusinessCalendarResponse>
Required scope: automation:calendars:write
Parameters
Name | Type | Description |
---|
config.id*required | string | A UUID string identifying this business calendar. |
config.version*required | string | |
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";
const data =
await businessCalendarsClient.restoreBusinessCalendarHistoryRecord(
{ id: "...", version: "..." },
);
updateBusinessCalendar
businessCalendarsClient.updateBusinessCalendar(config): Promise<BusinessCalendarResponse>
Required scope: automation:calendars:write
Parameters
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { businessCalendarsClient } from "@dynatrace-sdk/client-automation";
const data =
await businessCalendarsClient.updateBusinessCalendar({
id: "...",
body: { title: "..." },
});
eventTriggersClient
import { eventTriggersClient } from '@dynatrace-sdk/client-automation';
previewFilter
eventTriggersClient.previewFilter(config): Promise<EventTriggerPreviewResponse>
Required scope: automation:workflows:read
Parameters
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { eventTriggersClient } from "@dynatrace-sdk/client-automation";
const data = await eventTriggersClient.previewFilter({
body: {
triggerConfiguration: {
type: EventQueryTriggerConfigType.Event,
value: { query: "..." },
},
},
});
executionsClient
import { executionsClient } from '@dynatrace-sdk/client-automation';
cancelExecution
executionsClient.cancelExecution(config): Promise<void>
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 |
config.id*required | string | A UUID string identifying this execution. |
Returns
Return type | Status code | Description |
---|
void | 204 | No response body |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.cancelExecution({
id: "...",
});
cancelTaskExecution
executionsClient.cancelTaskExecution(config): Promise<void>
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 |
config.executionId*required | string | |
config.id*required | string | Task name |
Returns
Return type | Status code | Description |
---|
void | 200 | No response body |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.cancelTaskExecution({
executionId: "...",
id: "...",
});
getAllEventLogs
executionsClient.getAllEventLogs(config): Promise<EventLogs>
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 |
config.id*required | string | A UUID string identifying this execution. |
Returns
Return type | Status code | Description |
---|
EventLogs | 200 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.getAllEventLogs({
id: "...",
});
getExecution
executionsClient.getExecution(config): Promise<Execution>
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin |
config.id*required | string | A UUID string identifying this execution. |
Returns
Return type | Status code | Description |
---|
Execution | 200 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.getExecution({
id: "...",
});
getExecutionActions
executionsClient.getExecutionActions(config): Promise<Array<[string](https://developer.mozilla.org/en-US/docs/Glossary/String)>>
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 |
config.id*required | string | A UUID string identifying this execution. |
Returns
Return type | Status code | Description |
---|
void | 200 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.getExecutionActions({
id: "...",
});
getExecutionLog
executionsClient.getExecutionLog(config): Promise<[string](https://developer.mozilla.org/en-US/docs/Glossary/String)>
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 |
config.id*required | string | A UUID string identifying this execution. |
Returns
Return type | Status code | Description |
---|
void | 200 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.getExecutionLog({
id: "...",
});
getExecutions
executionsClient.getExecutions(config): Promise<PaginatedExecutionList>
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin |
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. |
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.getExecutions();
getTaskExecution
executionsClient.getTaskExecution(config): Promise<TaskExecution>
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin |
config.executionId*required | string | |
config.id*required | string | Task name |
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.getTaskExecution({
executionId: "...",
id: "...",
});
getTaskExecutionInput
executionsClient.getTaskExecutionInput(config): Promise<GetTaskExecutionInputResponse>
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 |
config.executionId*required | string | |
config.id*required | string | Task name |
Returns
Return type | Status code | Description |
---|
void | 200 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.getTaskExecutionInput({
executionId: "...",
id: "...",
});
getTaskExecutionLog
executionsClient.getTaskExecutionLog(config): Promise<[string](https://developer.mozilla.org/en-US/docs/Glossary/String)>
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 |
config.executionId*required | string | |
config.id*required | string | Task name |
Returns
Return type | Status code | Description |
---|
void | 200 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.getTaskExecutionLog({
executionId: "...",
id: "...",
});
getTaskExecutionResult
executionsClient.getTaskExecutionResult(config): Promise<[any](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#any)>
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 |
config.executionId*required | string | |
config.id*required | string | Task name |
Returns
Return type | Status code | Description |
---|
void | 200 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.getTaskExecutionResult({
executionId: "...",
id: "...",
});
getTaskExecutions
executionsClient.getTaskExecutions(config): Promise<TaskExecutions>
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin |
config.executionId*required | string | |
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.getTaskExecutions({
executionId: "...",
});
getTransitions
executionsClient.getTransitions(config): Promise<TaskTransitions>
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin |
config.executionId*required | string | |
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.getTransitions({
executionId: "...",
});
pauseExecution
executionsClient.pauseExecution(config): Promise<void>
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 |
config.id*required | string | A UUID string identifying this execution. |
Returns
Return type | Status code | Description |
---|
void | 204 | No response body |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.pauseExecution({
id: "...",
});
previewTaskInput
executionsClient.previewTaskInput(config): Promise<PreviewTaskInputResponse>
Required scope: automation:workflows:read
Returns preview expression by given task id from the workflow definition
Parameters
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.previewTaskInput({
body: {
expression: {},
task: "...",
workflow: {
title: "...",
throttle: { isLimitHit: false },
},
},
});
resumeExecution
executionsClient.resumeExecution(config): Promise<void>
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 |
config.id*required | string | A UUID string identifying this execution. |
Returns
Return type | Status code | Description |
---|
void | 204 | No response body |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { executionsClient } from "@dynatrace-sdk/client-automation";
const data = await executionsClient.resumeExecution({
id: "...",
});
schedulesClient
import { schedulesClient } from '@dynatrace-sdk/client-automation';
getCountries
schedulesClient.getCountries(config): Promise<CountryList>
Required scope: automation:workflows:read
Returns the list of countries that can be used to look up the holiday calendar
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { schedulesClient } from "@dynatrace-sdk/client-automation";
const data = await schedulesClient.getCountries();
getHolidayCalendar
schedulesClient.getHolidayCalendar(config): Promise<HolidayCalendarList>
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|
config.from | string | From date in ISO format |
config.key*required | string | The country name |
config.to | string | To date in ISO format |
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { schedulesClient } from "@dynatrace-sdk/client-automation";
const data = await schedulesClient.getHolidayCalendar({
key: "...",
});
getTimezones
schedulesClient.getTimezones(config): Promise<Array<[string](https://developer.mozilla.org/en-US/docs/Glossary/String)>>
Required scope: automation:workflows:read
Returns
Return type | Status code | Description |
---|
void | 200 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { schedulesClient } from "@dynatrace-sdk/client-automation";
const data = await schedulesClient.getTimezones();
previewSchedule
schedulesClient.previewSchedule(config): Promise<SchedulePreviewResponse>
Required scope: automation:workflows:read
Parameters
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { schedulesClient } from "@dynatrace-sdk/client-automation";
const data = await schedulesClient.previewSchedule({
body: {
schedule: {
trigger: {
type: CronTriggerType.Cron,
cron: "0 0 * * *",
},
},
},
});
schedulingRulesClient
import { schedulingRulesClient } from '@dynatrace-sdk/client-automation';
createRule
schedulingRulesClient.createRule(config): Promise<Rule>
Required scope: automation:rules:write
Parameters
Returns
Return type | Status code | Description |
---|
Rule | 201 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";
const data = await schedulingRulesClient.createRule({
body: {
title: "...",
ruleType: RuleRequestRuleType.Rrule,
},
});
deleteRule
schedulingRulesClient.deleteRule(config): Promise<void>
Required scope: automation:rules:write
Parameters
Name | Type | Description |
---|
config.id*required | string | A UUID string identifying this rule. |
Returns
Return type | Status code | Description |
---|
void | 204 | No response body |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";
const data = await schedulingRulesClient.deleteRule({
id: "...",
});
duplicateRule
schedulingRulesClient.duplicateRule(config): Promise<Rule>
Required scope: automation:rules:write
Parameters
Returns
Return type | Status code | Description |
---|
Rule | 201 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";
const data = await schedulingRulesClient.duplicateRule({
id: "...",
body: {},
});
getRule
schedulingRulesClient.getRule(config): Promise<Rule>
Required scope: automation:rules:read
Parameters
Name | Type | Description |
---|
config.id*required | string | A UUID string identifying this rule. |
Returns
Return type | Status code | Description |
---|
Rule | 200 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";
const data = await schedulingRulesClient.getRule({
id: "...",
});
getRuleHistoryRecord
schedulingRulesClient.getRuleHistoryRecord(config): Promise<Rule>
Required scope: automation:rules:read
Parameters
Name | Type | Description |
---|
config.id*required | string | A UUID string identifying this rule. |
config.version*required | string | |
Returns
Return type | Status code | Description |
---|
Rule | 200 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";
const data =
await schedulingRulesClient.getRuleHistoryRecord({
id: "...",
version: "...",
});
getRuleHistoryRecords
schedulingRulesClient.getRuleHistoryRecords(config): Promise<PaginatedChangeHistory>
Required scope: automation:rules:read
Parameters
Name | Type | Description |
---|
config.id*required | string | A UUID string identifying this rule. |
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";
const data =
await schedulingRulesClient.getRuleHistoryRecords({
id: "...",
});
getRules
schedulingRulesClient.getRules(config): Promise<PaginatedRuleList>
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. |
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";
const data = await schedulingRulesClient.getRules();
patchRule
schedulingRulesClient.patchRule(config): Promise<Rule>
Required scope: automation:rules:write
Parameters
Returns
Return type | Status code | Description |
---|
Rule | 200 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";
const data = await schedulingRulesClient.patchRule({
id: "...",
body: {},
});
previewRule
schedulingRulesClient.previewRule(config): Promise<RulePreviewResponse>
Required scope: automation:workflows:read
Parameters
Name | Type |
---|
config.body*required | RulePreviewRequest |
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";
const data = await schedulingRulesClient.previewRule({
body: {
ruleType: RRulePreviewRequestRuleType.Rrule,
rrule: { freq: RRuleFreq.Yearly, datestart: "..." },
},
});
restoreRuleHistoryRecord
schedulingRulesClient.restoreRuleHistoryRecord(config): Promise<Rule>
Required scope: automation:rules:write
Parameters
Name | Type | Description |
---|
config.id*required | string | A UUID string identifying this rule. |
config.version*required | string | |
Returns
Return type | Status code | Description |
---|
Rule | 200 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";
const data =
await schedulingRulesClient.restoreRuleHistoryRecord({
id: "...",
version: "...",
});
updateRule
schedulingRulesClient.updateRule(config): Promise<Rule>
Required scope: automation:rules:write
Parameters
Name | Type | Description |
---|
config.body*required | RuleRequest | |
config.id*required | string | A UUID string identifying this rule. |
Returns
Return type | Status code | Description |
---|
Rule | 200 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { schedulingRulesClient } from "@dynatrace-sdk/client-automation";
const data = await schedulingRulesClient.updateRule({
id: "...",
body: {
title: "...",
ruleType: RuleRequestRuleType.Rrule,
},
});
settingsClient
import { settingsClient } from '@dynatrace-sdk/client-automation';
getServiceUsers
settingsClient.getServiceUsers(config): Promise<GetServiceUsersResponse>
Required scope: automation:workflows:read
Get service users who could be used as workflow actor (deprecated).
Returns
Return type | Status code | Description |
---|
void | 200 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { settingsClient } from "@dynatrace-sdk/client-automation";
const data = await settingsClient.getServiceUsers();
getSettings
settingsClient.getSettings(config): Promise<GetSettingsResponse>
Required scope: automation:workflows:read
Get system settings
Returns
Return type | Status code | Description |
---|
void | 200 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { settingsClient } from "@dynatrace-sdk/client-automation";
const data = await settingsClient.getSettings();
getUserPermissions
settingsClient.getUserPermissions(config): Promise<Array<[string](https://developer.mozilla.org/en-US/docs/Glossary/String)>>
Required scope: automation:workflows:read
Get current user effective permissions.
Returns
Return type | Status code | Description |
---|
void | 200 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { settingsClient } from "@dynatrace-sdk/client-automation";
const data = await settingsClient.getUserPermissions();
getUserSettings
settingsClient.getUserSettings(config): Promise<UserSettings>
Required scope: automation:workflows:read
Get user-specific settings
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { settingsClient } from "@dynatrace-sdk/client-automation";
const data = await settingsClient.getUserSettings();
updateAuthorizations
settingsClient.updateAuthorizations(config): Promise<void>
Required scope: automation:workflows:read
Returns
Return type | Status code | Description |
---|
void | 202 | No response body |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { settingsClient } from "@dynatrace-sdk/client-automation";
const data = await settingsClient.updateAuthorizations();
versionClient
import { versionClient } from '@dynatrace-sdk/client-automation';
getVersion
versionClient.getVersion(config): Promise<VersionResponse>
Required scope: automation:workflows:read
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { versionClient } from "@dynatrace-sdk/client-automation";
const data = await versionClient.getVersion();
workflowsClient
import { workflowsClient } from '@dynatrace-sdk/client-automation';
createWorkflow
workflowsClient.createWorkflow(config): Promise<Workflow>
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 |
config.body*required | WorkflowRequest | |
Returns
Return type | Status code | Description |
---|
Workflow | 201 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data = await workflowsClient.createWorkflow({
body: { title: "...", throttle: { isLimitHit: false } },
});
deleteWorkflow
workflowsClient.deleteWorkflow(config): Promise<void>
Required scope: automation:workflows:write
Parameters
Name | Type | Description |
---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin |
config.id*required | string | A UUID string identifying this workflow. |
Returns
Return type | Status code | Description |
---|
void | 204 | No response body |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data = await workflowsClient.deleteWorkflow({
id: "...",
});
duplicateWorkflow
workflowsClient.duplicateWorkflow(config): Promise<Workflow>
Required scope: automation:workflows:write
Parameters
Name | Type | Description |
---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin |
config.body*required | DuplicationRequest | |
config.id*required | string | A UUID string identifying this workflow. |
Returns
Return type | Status code | Description |
---|
Workflow | 201 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data = await workflowsClient.duplicateWorkflow({
id: "...",
body: {},
});
getWorkflow
workflowsClient.getWorkflow(config): Promise<Workflow>
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin |
config.id*required | string | A UUID string identifying this workflow. |
Returns
Return type | Status code | Description |
---|
Workflow | 200 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data = await workflowsClient.getWorkflow({
id: "...",
});
getWorkflowActions
workflowsClient.getWorkflowActions(config): Promise<Array<[string](https://developer.mozilla.org/en-US/docs/Glossary/String)>>
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 |
config.id*required | string | A UUID string identifying this workflow. |
Returns
Return type | Status code | Description |
---|
void | 200 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data = await workflowsClient.getWorkflowActions({
id: "...",
});
getWorkflowHistoryRecord
workflowsClient.getWorkflowHistoryRecord(config): Promise<Workflow>
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin |
config.id*required | string | A UUID string identifying this workflow. |
config.version*required | string | |
Returns
Return type | Status code | Description |
---|
Workflow | 200 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data = await workflowsClient.getWorkflowHistoryRecord(
{ id: "...", version: "..." },
);
getWorkflowHistoryRecords
workflowsClient.getWorkflowHistoryRecords(config): Promise<PaginatedChangeHistory>
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin |
config.id*required | string | A UUID string identifying this workflow. |
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data =
await workflowsClient.getWorkflowHistoryRecords({
id: "...",
});
getWorkflowTask
workflowsClient.getWorkflowTask(config): Promise<Task>
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin |
config.id*required | string | |
config.workflowId*required | string | |
Returns
Return type | Status code | Description |
---|
Task | 200 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data = await workflowsClient.getWorkflowTask({
id: "...",
workflowId: "...",
});
getWorkflowTasks
workflowsClient.getWorkflowTasks(config): Promise<Tasks>
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin |
config.id*required | string | A UUID string identifying this workflow. |
Returns
Return type | Status code | Description |
---|
Tasks | 200 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data = await workflowsClient.getWorkflowTasks({
id: "...",
});
getWorkflows
workflowsClient.getWorkflows(config): Promise<PaginatedWorkflowList>
Required scope: automation:workflows:read
Parameters
Name | Type | Description |
---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin |
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 | "GROUP" | "USER" | |
config.search | string | A search term. |
config.throttleIsLimitHit | boolean | |
config.triggerScheduleIsFaulty | boolean | |
config.triggerType | string | |
config.type | string | |
config.usages | string | |
Returns
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data = await workflowsClient.getWorkflows();
patchWorkflow
workflowsClient.patchWorkflow(config): Promise<Workflow>
Required scope: automation:workflows:write
Parameters
Name | Type | Description |
---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin |
config.body*required | PatchedWorkflowRequest | |
config.id*required | string | A UUID string identifying this workflow. |
Returns
Return type | Status code | Description |
---|
Workflow | 200 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data = await workflowsClient.patchWorkflow({
id: "...",
body: { throttle: { isLimitHit: false } },
});
restoreWorkflowHistoryRecord
workflowsClient.restoreWorkflowHistoryRecord(config): Promise<void>
Required scope: automation:workflows:write
Parameters
Name | Type | Description |
---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin |
config.id*required | string | A UUID string identifying this workflow. |
config.version*required | string | |
Returns
Return type | Status code | Description |
---|
void | 200 | No response body |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data =
await workflowsClient.restoreWorkflowHistoryRecord({
id: "...",
version: "...",
});
runWorkflow
workflowsClient.runWorkflow(config): Promise<Execution>
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 |
config.body*required | ExecutionInputsRequest | |
config.id*required | string | A UUID string identifying this workflow. |
config.monitor | boolean | Specifies whether the execution data of the SIMPLE workflow type is available for monitoring until the execution is complete. |
Returns
Return type | Status code | Description |
---|
Execution | 201 | Execution successfully created |
Execution | 202 | No execution created - execution with uniqueQualifier provided already exists |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
import { workflowsClient } from "@dynatrace-sdk/client-automation";
const data = await workflowsClient.runWorkflow({
id: "...",
body: {},
});
updateWorkflow
workflowsClient.updateWorkflow(config): Promise<Workflow>
Required scope: automation:workflows:write
Parameters
Name | Type | Description |
---|
config.adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin |
config.body*required | WorkflowRequest | |
config.id*required | string | A UUID string identifying this workflow. |
Returns
Return type | Status code | Description |
---|
Workflow | 200 | |
Throws
Error Type | Error Message |
---|
ErrorEnvelopeError | |
Code example
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*required | string | |
input | ActionExecutionInput | |
loopItem | ActionExecutionLoopItem | |
result | any | |
runtime | null | number | |
startedAt | null | Date | |
state | "ERROR" | "IDLE" | "RUNNING" | "SUSPENDED" | "SUCCESS" | "UNKNOWN" | ERROR - ERRORIDLE - IDLERUNNING - RUNNINGSUSPENDED - SUSPENDEDSUCCESS - SUCCESSUNKNOWN - UNKNOWN
|
stateInfo | null | string | |
taskExe | null | string | Parent task execution |
ActionExecutionInput
type: Record<string, any>
ActionExecutionLoopItem
type: Record<string, any>
BusinessCalendarRequest
BusinessCalendarResponse
ChangeHistory
Name | Type |
---|
dateCreated*required | Date |
id*required | number |
user*required | string |
version*required | number |
Country
CountryList
CronTrigger
Name | Type |
---|
cron*required | string |
type*required | "cron" |
DavisEventConfig
Name | Type | Description |
---|
customFilter | string | Additional DQL matcher expression to further filter events to match. |
entityTags | EntityTags | Entity tags to match by key and (optional) values. For example {"foo": [], "bar": ["a", "b", "c"]} |
entityTagsMatch | "all" | "any" | Event must match all or any of the entity tags. |
names | Array<DavisEventName> | |
onProblemClose | boolean | Trigger on Davis event open only or also on close. default: false |
typesDEPRECATED | Array<string> | |
DavisEventName
Name | Type | Description |
---|
match*required | "equals" | "contains" | Davis event name must equal or contain the string provided. |
name*required | string | |
DavisEventTriggerConfig
DavisProblemCategories
DavisProblemConfig
Name | Type | Description |
---|
categories*required | DavisProblemCategories | |
customFilter | string | Additional DQL matcher expression to further filter events to match. |
entityTags | EntityTags | Entity tags to match by key and (optional) values. For example {"foo": [], "bar": ["a", "b", "c"]} |
entityTagsMatch | "all" | "any" | Event must match all or any of the entity tags. |
onProblemClose | boolean | Trigger on Davis problem open only or also on close. default: false |
DavisProblemTriggerConfig
DuplicationRequest
EntityTags
Entity tags to match by key and (optional) values. For example {"foo": [], "bar": ["a", "b", "c"]}
type: Record<string, string | string[] | undefined>
Error
ErrorDetails
type: Record<string, any>
ErrorEnvelope
Name | Type |
---|
error*required | Error |
EventLog
Name | Type |
---|
cause*required | string |
context | Record<string | any> |
event*required | string |
source*required | Source |
state*required | "ERROR" | "IDLE" | "RUNNING" | "SUCCESS" | "DEACTIVATED" | "WAITING" | "PAUSED" | "CANCELLED" | "SKIPPED" | "DISCARDED" |
timestamp*required | Date |
EventLogs
type: Array<EventLog>
EventQuery
Name | Type | Description |
---|
eventType | "events" | "bizevents" | "dt.system.events" | Grail event type. |
query*required | string | DQL matcher expression defining which events to match. |
EventQueryTriggerConfig
Name | Type |
---|
type*required | "event" |
value*required | EventQuery |
EventTrigger
Name | Type |
---|
filterQuery*required | string |
isActive | boolean |
triggerConfiguration | EventTriggerConfig |
uniqueExpression*required | null | string |
EventTriggerPreviewRequest
Name | Type |
---|
triggerConfiguration*required | EventTriggerConfig |
EventTriggerPreviewResponse
EventTriggerRequest
Name | Type |
---|
isActive | boolean |
triggerConfiguration | EventTriggerConfig |
Execution
Name | Type | Description |
---|
actor*required | string | |
endedAt | null | Date | |
eventTrigger | null | string | |
id*required | string | |
input | ExecutionInput | |
params | ExecutionParams | |
runtime*required | number | Calculate the runtime of an execution in seconds. If the Execution is not ended, runtime is calculated until now. |
schedule | null | string | |
startedAt | Date | |
state | "ERROR" | "RUNNING" | "SUCCESS" | "UNKNOWN" | "PAUSED" | "CANCELLED" | CANCELLED - CANCELLEDERROR - ERRORPAUSED - PAUSEDRUNNING - RUNNINGSUCCESS - SUCCESSUNKNOWN - UNKNOWN
|
stateInfo | null | string | |
title*required | string | |
trigger | null | string | |
triggerType*required | string | |
user | null | string | |
workflow | null | string | Executed Workflow |
workflowType*required | "STANDARD" | "SIMPLE" | |
workflowVersion*required | null | number | |
ExecutionInput
type: Record<string, any>
ExecutionInputsRequest
Inputs for workflow executions
Name | Type | Description |
---|
input | ExecutionInputsRequestInput | Inputs (key/value pairs) default: {} |
params | ExecutionInputsRequestParams | Metadata (can be nested object) default: {} |
uniqueQualifier | string | A qualifier that must not have been used before to trigger the execution |
ExecutionParams
type: Record<string, any>
FixedOffsetRule
Name | Type | Description |
---|
offset*required | number | Offset days |
rule*required | string | |
FixedOffsetRulePreviewRequest
GetServiceUsersResponse
type: Record<string, any>
GetSettingsResponse
type: Record<string, any>
GetTaskExecutionInputResponse
type: Record<string, any>
GroupingRule
GroupingRulePreviewRequest
Holiday
Name | Type |
---|
date*required | Date |
title*required | string |
HolidayCalendarList
Holidays
type: Array<Holiday>
IntervalTrigger
Name | Type |
---|
betweenEnd | string |
betweenStart | string |
intervalMinutes*required | number |
type*required | "interval" |
ModificationInfo
Name | Type |
---|
createdBy*required | string |
createdTime*required | Date |
lastModifiedBy*required | string |
lastModifiedTime*required | Date |
PaginatedBusinessCalendarResponseList
PaginatedChangeHistory
PaginatedExecutionList
PaginatedRuleList
Name | Type |
---|
count*required | number |
results*required | Array<Rule> |
PaginatedWorkflowList
PatchedBusinessCalendarRequest
PatchedRuleRequest
PatchedWorkflowRequest
PatchedWorkflowRequestTaskDefaults
type: Record<string, any>
PreviewTaskInputRequest
PreviewTaskInputRequestExpression
type: Record<string, any>
PreviewTaskInputResponse
PreviewTaskInputResponseValue
type: Record<string, any>
RRule
Name | Type | Description |
---|
byday | Array<"MO" | "TU" | "WE" | "TH" | "FR" | "SA" | "SU"> | Define the weekdays where the recurrence will be applied. |
bymonth | Array<number> | The months to apply the recurrence to. |
bymonthday | Array<number> | The month days to apply the recurrence to. |
bysetpos | Array<number> | Each given integer will specify an occurrence number, corresponding to the nth occurrence of the rule inside the frequency period |
byweekno | Array<number> | The week numbers to apply the recurrence to. |
byworkday | "WORKING" | "HOLIDAYS" | "OFF" | The type of days on which the recurrence will be applied. |
byyearday | Array<number> | The year days to apply the recurrence to. |
datestart*required | Date | The recurrence start. |
freq*required | "YEARLY" | "MONTHLY" | "WEEKLY" | "DAILY" | "HOURLY" | "MINUTELY" | "SECONDLY" | |
interval | number | The interval between each freq iteration. default: 1 |
until | Date | Specifying the upper-bound limit of the recurrence. |
wkst | "MO" | "TU" | "WE" | "TH" | "FR" | "SA" | "SU" | The week start day. |
RRulePreviewRequest
RelativeOffsetRule
Name | Type |
---|
direction*required | "next" | "previous" |
sourceRule*required | string |
targetRule*required | string |
RelativeOffsetRulePreviewRequest
Rule
RulePreviewResponse
Name | Type |
---|
error*required | string |
nextExecutions*required | Array<Date> |
valid*required | boolean |
RuleRequest
Name | Type | Description |
---|
businessCalendar | null | string | |
description | string | |
fixedOffsetRule | null | FixedOffsetRule | |
groupingRule | null | GroupingRule | |
id | string | |
relativeOffsetRule | null | RelativeOffsetRule | |
rrule | null | RRule | |
ruleType*required | "fixed_offset" | "grouping" | "rrule" | "relative_offset" | rrule - rrulegrouping - groupingfixed_offset - fixed_offsetrelative_offset - relative_offset
|
title*required | string | |
Schedule
ScheduleFilterParameters
Name | Type | Default |
---|
count | number | 10 |
earliestStart | Date | |
earliestStartTime | string | "00:00:00" |
excludeDates | Array<Date> | |
includeDates | Array<Date> | |
until | Date | |
ScheduleInput
ScheduleInputs
type: Record<string, ScheduleInput | undefined>
SchedulePreviewRequest
SchedulePreviewResponse
Name | Type |
---|
error*required | string |
nextExecutions*required | Array<Date> |
valid*required | boolean |
ScheduleRequest
Source
Name | Type |
---|
id*required | string |
model*required | "Execution" | "TaskExecution" | "ActionExecution" |
str*required | string |
userStr*required | string |
Task
TaskConditionOption
TaskConditionOptionStates
type: Record<string, "SUCCESS" | "ERROR" | "ANY" | "OK" | "NOK" | undefined>
TaskExecution
Name | Type | Description |
---|
action | null | string | |
active*required | boolean | Whether task is active |
conditionResults | TaskExecutionConditionResults | |
conditions*required | TaskExecutionConditions | |
description | null | string | |
endedAt*required | null | Date | |
execution | null | string | Parent execution |
id*required | string | |
input | TaskExecutionInput | |
name*required | string | |
position*required | TaskPosition | |
predecessors*required | Array<string> | |
result*required | any | |
runtime*required | number | Calculate the runtime of an exection in seconds. If the Execution is not ended, runtime is calculated until now. |
startedAt*required | null | Date | |
state | "ERROR" | "IDLE" | "RUNNING" | "SUCCESS" | "UNKNOWN" | "WAITING" | "CANCELLED" | "SKIPPED" | "DISCARDED" | CANCELLED - CANCELLEDDISCARDED - DISCARDEDERROR - ERRORIDLE - IDLERUNNING - RUNNINGSKIPPED - SKIPPEDSUCCESS - SUCCESSWAITING - WAITINGUNKNOWN - UNKNOWN
|
stateInfo | null | string | |
TaskExecutionConditionResults
type: Record<string, any>
TaskExecutionConditions
type: Record<string, any>
TaskExecutionInput
type: Record<string, any>
TaskExecutions
type: Record<string, TaskExecution | undefined>
TaskPosition
TaskRetryOption
Name | Type | Description |
---|
count*required | string | number | Specifies a maximum number of times that a task can be repeated in case it fails on execution. |
delay | string | number | Specifies a delay in seconds between subsequent task retries |
failedLoopIterationsOnly | boolean | Specifies whether retrying the failed iterations or the whole loop. Default: True. default: true |
TaskTransition
The TaskTransitionSerializer inlines the related workflow object and list of variables.
Runtime is added as a property and calculated using the started_at and ended_at timestamps.
TaskTransitions
type: Record<string, TaskTransition | undefined>
Tasks
type: Record<string, Task | undefined>
Throttle
ThrottleLimitEvent
Name | Type |
---|
limit*required | number |
timeLeftInSeconds*required | number |
timestamp*required | Date |
ThrottleLimitEvents
type: Array<ThrottleLimitEvent>
ThrottleRequest
TimeTrigger
Name | Type |
---|
time*required | string |
type*required | "time" |
Trigger
TriggerRequest
UserSettings
Name | Type |
---|
groups*required | Array<string> |
VersionResponse
Name | Type |
---|
version*required | string |
WeekdaysNames
type: Array<"MO" | "TU" | "WE" | "TH" | "FR" | "SA" | "SU">
WeekdaysValues
type: Array<1 | 2 | 3 | 4 | 5 | 6 | 7>
Workflow
WorkflowRequest
WorkflowRequestTaskDefaults
type: Record<string, any>
WorkflowTaskDefaults
type: Record<string, any>
Enums
ActionExecutionState
ERROR
- ERRORIDLE
- IDLERUNNING
- RUNNINGSUSPENDED
- SUSPENDEDSUCCESS
- SUCCESSUNKNOWN
- UNKNOWN
Enum keys
Error
| Idle
| Running
| Success
| Suspended
| Unknown
CronTriggerType
DavisEventNameMatch
Davis event name must equal or contain the string provided.
Enum keys
DavisEventTriggerConfigType
DavisProblemTriggerConfigType
EntityTagsMatch
Event must match all or any of the entity tags.
Enum keys
EventLogState
Enum keys
Cancelled
| Deactivated
| Discarded
| Error
| Idle
| Paused
| Running
| Skipped
| Success
| Waiting
EventQueryTriggerConfigType
EventType
Grail event type.
Enum keys
Bizevents
| DtSystemEvents
| Events
ExecutionState
CANCELLED
- CANCELLEDERROR
- ERRORPAUSED
- PAUSEDRUNNING
- RUNNINGSUCCESS
- SUCCESSUNKNOWN
- UNKNOWN
Enum keys
Cancelled
| Error
| Paused
| Running
| Success
| Unknown
ExecutionWorkflowType
FixedOffsetRulePreviewRequestRuleType
GetWorkflowsQueryOwnerType
GroupingRulePreviewRequestRuleType
IntervalTriggerType
PatchedRuleRequestRuleType
rrule
- rrulegrouping
- groupingfixed_offset
- fixed_offsetrelative_offset
- relative_offset
Enum keys
FixedOffset
| Grouping
| RelativeOffset
| Rrule
PatchedWorkflowRequestOwnerType
PatchedWorkflowRequestType
Workflow type.
STANDARD
- STANDARDSIMPLE
- SIMPLE
Enum keys
RRuleBydayItem
Enum keys
Fr
| Mo
| Sa
| Su
| Th
| Tu
| We
RRuleByworkday
The type of days on which the recurrence will be applied.
Enum keys
RRuleFreq
Enum keys
Daily
| Hourly
| Minutely
| Monthly
| Secondly
| Weekly
| Yearly
RRulePreviewRequestRuleType
RRuleWkst
The week start day.
Enum keys
Fr
| Mo
| Sa
| Su
| Th
| Tu
| We
RelativeOffsetRuleDirection
RelativeOffsetRulePreviewRequestRuleType
RuleRequestRuleType
rrule
- rrulegrouping
- groupingfixed_offset
- fixed_offsetrelative_offset
- relative_offset
Enum keys
FixedOffset
| Grouping
| RelativeOffset
| Rrule
RuleRuleType
rrule
- rrulegrouping
- groupingfixed_offset
- fixed_offsetrelative_offset
- relative_offset
Enum keys
FixedOffset
| Grouping
| RelativeOffset
| Rrule
ScheduleInputType
ScheduleRequestTimezone
ScheduleTimezone
SourceModel
Enum keys
ActionExecution
| Execution
| TaskExecution
TaskConditionOptionElse
TaskExecutionState
CANCELLED
- CANCELLEDDISCARDED
- DISCARDEDERROR
- ERRORIDLE
- IDLERUNNING
- RUNNINGSKIPPED
- SKIPPEDSUCCESS
- SUCCESSWAITING
- WAITINGUNKNOWN
- UNKNOWN
Enum keys
Cancelled
| Discarded
| Error
| Idle
| Running
| Skipped
| Success
| Unknown
| Waiting
TimeTriggerType
WeekdaysNamesItem
Enum keys
Fr
| Mo
| Sa
| Su
| Th
| Tu
| We
WeekdaysValuesItem
Enum keys
WeekdaysValues_1
| WeekdaysValues_2
| WeekdaysValues_3
| WeekdaysValues_4
| WeekdaysValues_5
| WeekdaysValues_6
| WeekdaysValues_7
WorkflowOwnerType
WorkflowRequestOwnerType
WorkflowRequestType
Workflow type.
STANDARD
- STANDARDSIMPLE
- SIMPLE
Enum keys
WorkflowType
Workflow type.
STANDARD
- STANDARDSIMPLE
- SIMPLE
Enum keys