az datafactory trigger-run
Note
This reference is part of the datafactory extension for the Azure CLI (version 2.15.0 or higher). The extension will automatically install the first time you run an az datafactory trigger-run command. Learn more about extensions.
Manage trigger run with datafactory.
Commands
Name | Description | Type | Status |
---|---|---|---|
az datafactory trigger-run cancel |
Cancel a single trigger instance by runId. |
Extension | GA |
az datafactory trigger-run query-by-factory |
Query trigger runs. |
Extension | GA |
az datafactory trigger-run rerun |
Rerun single trigger instance by runId. |
Extension | GA |
az datafactory trigger-run cancel
Cancel a single trigger instance by runId.
az datafactory trigger-run cancel [--factory-name]
[--ids]
[--resource-group]
[--run-id]
[--subscription]
[--trigger-name]
Examples
Triggers_Cancel
az datafactory trigger-run cancel --factory-name "exampleFactoryName" --resource-group "exampleResourceGroup" --run-id "2f7fdb90-5df1-4b8e-ac2f-064cfa58202b" --trigger-name "exampleTrigger"
Optional Parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
The factory name.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
The pipeline run identifier.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
The trigger name.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
Global Parameters
Increase logging verbosity to show all debug logs.
Property | Value |
---|---|
Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
Property | Value |
---|---|
Default value: | False |
Output format.
Property | Value |
---|---|
Default value: | json |
Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
Property | Value |
---|---|
Default value: | False |
az datafactory trigger-run query-by-factory
Query trigger runs.
az datafactory trigger-run query-by-factory --last-updated-after
--last-updated-before
[--continuation-token]
[--factory-name]
[--filters]
[--ids]
[--order-by]
[--resource-group]
[--subscription]
Examples
TriggerRuns_QueryByFactory
az datafactory trigger-run query-by-factory --factory-name "exampleFactoryName" --filters operand="TriggerName" operator="Equals" values="exampleTrigger" --last-updated-after "2018-06-16T00:36:44.3345758Z" --last-updated-before "2018-06-16T00:49:48.3686473Z" --resource-group "exampleResourceGroup"
Required Parameters
The time at or after which the run event was updated in 'ISO 8601' format.
The time at or before which the run event was updated in 'ISO 8601' format.
Optional Parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
The continuation token for getting the next page of results. Null for first page.
The factory name.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
List of filters.
Usage: --filters operand=XX operator=XX values=XX
operand: Required. Parameter name to be used for filter. The allowed operands to query pipeline runs are PipelineName, RunStart, RunEnd and Status; to query activity runs are ActivityName, ActivityRunStart, ActivityRunEnd, ActivityType and Status, and to query trigger runs are TriggerName, TriggerRunTimestamp and Status. operator: Required. Operator to be used for filter. values: Required. List of filter values.
Multiple actions can be specified by using more than one --filters argument.
One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
List of OrderBy option.
Usage: --order-by order-by=XX order=XX
order-by: Required. Parameter name to be used for order by. The allowed parameters to order by for pipeline runs are PipelineName, RunStart, RunEnd and Status; for activity runs are ActivityName, ActivityRunStart, ActivityRunEnd and Status; for trigger runs are TriggerName, TriggerRunTimestamp and Status. order: Required. Sorting order of the parameter.
Multiple actions can be specified by using more than one --order-by argument.
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
Global Parameters
Increase logging verbosity to show all debug logs.
Property | Value |
---|---|
Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
Property | Value |
---|---|
Default value: | False |
Output format.
Property | Value |
---|---|
Default value: | json |
Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
Property | Value |
---|---|
Default value: | False |
az datafactory trigger-run rerun
Rerun single trigger instance by runId.
az datafactory trigger-run rerun [--factory-name]
[--ids]
[--resource-group]
[--run-id]
[--subscription]
[--trigger-name]
Examples
Triggers_Rerun
az datafactory trigger-run rerun --factory-name "exampleFactoryName" --resource-group "exampleResourceGroup" --run-id "2f7fdb90-5df1-4b8e-ac2f-064cfa58202b" --trigger-name "exampleTrigger"
Optional Parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
The factory name.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
Name of resource group. You can configure the default group using az configure --defaults group=<name>
.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
The pipeline run identifier.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
The trigger name.
Property | Value |
---|---|
Parameter group: | Resource Id Arguments |
Global Parameters
Increase logging verbosity to show all debug logs.
Property | Value |
---|---|
Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
Property | Value |
---|---|
Default value: | False |
Output format.
Property | Value |
---|---|
Default value: | json |
Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Increase logging verbosity. Use --debug for full debug logs.
Property | Value |
---|---|
Default value: | False |