Share via

az acr task timer

Manage timer triggers for a task.

Commands

Name Description Type Status
az acr task timer add

Add a timer trigger to a task.

 Core GA
az acr task timer list

List all timer triggers for a task.

 Core GA
az acr task timer remove

Remove a timer trigger from a task.

 Core GA
az acr task timer update

Update the timer trigger for a task.

 Core GA

az acr task timer add

Edit

Add a timer trigger to a task.

az acr task timer add --name
                      --registry
                      --schedule
                      --timer-name
                      [--enabled {false, true}]
                      [--resource-group]

Examples

Add a timer trigger which schedules the task at 09:30 (UTC) every day of the week from Monday through Friday.

az acr task timer add -n taskname -r registryname --timer-name t2 --schedule "30 9 * * 1-5"

Required Parameters

--name -n

The name of the task.

--registry -r

The name of the container registry. It should be specified in lower case. You can configure the default registry name using az configure --defaults acr=<registry name>.

--schedule

The schedule of the timer trigger represented as a cron expression.

--timer-name

The name of the timer trigger.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--enabled

Indicates whether the timer trigger is enabled.

Property Value
Default value: True
Accepted values: false, true
--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property Value
Default value: False

az acr task timer list

Edit

List all timer triggers for a task.

az acr task timer list --name
                       --registry
                       [--resource-group]

Examples

List all timer triggers for a task.

az acr task timer list -n taskname -r registryname

Required Parameters

--name -n

The name of the task.

--registry -r

The name of the container registry. It should be specified in lower case. You can configure the default registry name using az configure --defaults acr=<registry name>.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property Value
Default value: False

az acr task timer remove

Edit

Remove a timer trigger from a task.

az acr task timer remove --name
                         --registry
                         --timer-name
                         [--resource-group]

Examples

Remove a timer trigger from a task.

az acr task timer remove -n taskname -r registryname --timer-name t2

Required Parameters

--name -n

The name of the task.

--registry -r

The name of the container registry. It should be specified in lower case. You can configure the default registry name using az configure --defaults acr=<registry name>.

--timer-name

The name of the timer trigger.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property Value
Default value: False

az acr task timer update

Edit

Update the timer trigger for a task.

az acr task timer update --name
                         --registry
                         --timer-name
                         [--enabled {false, true}]
                         [--resource-group]
                         [--schedule]

Examples

Update the schedule of a timer trigger for a task.

az acr task timer update -n taskname -r registryname --timer-name t2 --schedule "0 12 * * *"

Update the status of a timer trigger for a task.

az acr task timer update -n taskname -r registryname --timer-name t2 --enabled False

Required Parameters

--name -n

The name of the task.

--registry -r

The name of the container registry. It should be specified in lower case. You can configure the default registry name using az configure --defaults acr=<registry name>.

--timer-name

The name of the timer trigger.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--enabled

Indicates whether the timer trigger is enabled.

Property Value
Accepted values: false, true
--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--schedule

The schedule of the timer trigger represented as a cron expression.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property Value
Default value: False