global_schedules

Creates, updates, deletes, gets or lists a global_schedules resource.

Overview

Name	global_schedules
Type	Resource
Id	azure.dev_test_labs.global_schedules

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
id	string	The identifier of the resource.
name	string	The name of the resource.
createdDate	string (date-time)	The creation date of the schedule.
dailyRecurrence	object	If the schedule will occur once each day of the week, specify the daily recurrence.
hourlyRecurrence	object	If the schedule will occur multiple times a day, specify the hourly recurrence.
location	string	The location of the resource.
notificationSettings	object	Notification settings.
provisioningState	string	The provisioning status of the resource.
status	string	The status of the schedule (i.e. Enabled, Disabled). Known values are: "Enabled" and "Disabled".
tags	object	The tags of the resource.
targetResourceId	string	The resource ID to which the schedule belongs.
taskType	string	The task type of the schedule (e.g. LabVmsShutdownTask, LabVmAutoStart).
timeZoneId	string	The time zone ID (e.g. China Standard Time, Greenland Standard Time, Pacific Standard time, etc.). The possible values for this property can be found in IReadOnlyCollection TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md).
type	string	The type of the resource.
uniqueIdentifier	string	The unique immutable identifier of a resource (Guid).
weeklyRecurrence	object	If the schedule will occur only some days of the week, specify the weekly recurrence.

list_by_resource_group

Name	Datatype	Description
id	string	The identifier of the resource.
name	string	The name of the resource.
createdDate	string (date-time)	The creation date of the schedule.
dailyRecurrence	object	If the schedule will occur once each day of the week, specify the daily recurrence.
hourlyRecurrence	object	If the schedule will occur multiple times a day, specify the hourly recurrence.
location	string	The location of the resource.
notificationSettings	object	Notification settings.
provisioningState	string	The provisioning status of the resource.
status	string	The status of the schedule (i.e. Enabled, Disabled). Known values are: "Enabled" and "Disabled".
tags	object	The tags of the resource.
targetResourceId	string	The resource ID to which the schedule belongs.
taskType	string	The task type of the schedule (e.g. LabVmsShutdownTask, LabVmAutoStart).
timeZoneId	string	The time zone ID (e.g. China Standard Time, Greenland Standard Time, Pacific Standard time, etc.). The possible values for this property can be found in IReadOnlyCollection TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md).
type	string	The type of the resource.
uniqueIdentifier	string	The unique immutable identifier of a resource (Guid).
weeklyRecurrence	object	If the schedule will occur only some days of the week, specify the weekly recurrence.

list_by_subscription

Name	Datatype	Description
id	string	The identifier of the resource.
name	string	The name of the resource.
createdDate	string (date-time)	The creation date of the schedule.
dailyRecurrence	object	If the schedule will occur once each day of the week, specify the daily recurrence.
hourlyRecurrence	object	If the schedule will occur multiple times a day, specify the hourly recurrence.
location	string	The location of the resource.
notificationSettings	object	Notification settings.
provisioningState	string	The provisioning status of the resource.
status	string	The status of the schedule (i.e. Enabled, Disabled). Known values are: "Enabled" and "Disabled".
tags	object	The tags of the resource.
targetResourceId	string	The resource ID to which the schedule belongs.
taskType	string	The task type of the schedule (e.g. LabVmsShutdownTask, LabVmAutoStart).
timeZoneId	string	The time zone ID (e.g. China Standard Time, Greenland Standard Time, Pacific Standard time, etc.). The possible values for this property can be found in IReadOnlyCollection TimeZoneConverter.TZConvert.KnownWindowsTimeZoneIds (https://github.com/mattjohnsonpint/TimeZoneConverter/blob/main/README.md).
type	string	The type of the resource.
uniqueIdentifier	string	The unique immutable identifier of a resource (Guid).
weeklyRecurrence	object	If the schedule will occur only some days of the week, specify the weekly recurrence.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	resource_group_name, name, subscription_id	$expand	Get schedule.
list_by_resource_group	select	resource_group_name, subscription_id	$expand, $filter, $top, $orderby	List schedules in a resource group.
list_by_subscription	select	subscription_id	$expand, $filter, $top, $orderby	List schedules in a subscription.
create_or_update	insert	resource_group_name, name, subscription_id		Create or replace an existing schedule.
update	update	resource_group_name, name, subscription_id		Allows modifying tags of schedules. All other properties will be ignored.
create_or_update	replace	resource_group_name, name, subscription_id		Create or replace an existing schedule.
delete	delete	resource_group_name, name, subscription_id		Delete schedule.
execute	exec	resource_group_name, name, subscription_id		Execute a schedule. This operation can take a while to complete.
retarget	exec	resource_group_name, name, subscription_id		Updates a schedule's target resource Id. This operation can take a while to complete.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
name	string	The name of the schedule. Required.
resource_group_name	string	The name of the resource group. Required.
subscription_id	string
$expand	string	Specify the $expand query. Example: 'properties($select=status)'. Default value is None.
$filter	string	The filter to apply to the operation. Example: '$filter=contains(name,'myName'). Default value is None.
$orderby	string	The ordering expression for the results, using OData notation. Example: '$orderby=name desc'. Default value is None.
$top	integer	The maximum number of resources to return from the operation. Example: '$top=10'. Default value is None.

SELECT examples

get

Get schedule.

SELECT
id,
name,
createdDate,
dailyRecurrence,
hourlyRecurrence,
location,
notificationSettings,
provisioningState,
status,
tags,
targetResourceId,
taskType,
timeZoneId,
type,
uniqueIdentifier,
weeklyRecurrence
FROM azure.dev_test_labs.global_schedules
WHERE resource_group_name = '{{ resource_group_name }}' -- required
AND name = '{{ name }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
AND $expand = '{{ $expand }}'
;

list_by_resource_group

List schedules in a resource group.

SELECT
id,
name,
createdDate,
dailyRecurrence,
hourlyRecurrence,
location,
notificationSettings,
provisioningState,
status,
tags,
targetResourceId,
taskType,
timeZoneId,
type,
uniqueIdentifier,
weeklyRecurrence
FROM azure.dev_test_labs.global_schedules
WHERE resource_group_name = '{{ resource_group_name }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
AND $expand = '{{ $expand }}'
AND $filter = '{{ $filter }}'
AND $top = '{{ $top }}'
AND $orderby = '{{ $orderby }}'
;

list_by_subscription

List schedules in a subscription.

SELECT
id,
name,
createdDate,
dailyRecurrence,
hourlyRecurrence,
location,
notificationSettings,
provisioningState,
status,
tags,
targetResourceId,
taskType,
timeZoneId,
type,
uniqueIdentifier,
weeklyRecurrence
FROM azure.dev_test_labs.global_schedules
WHERE subscription_id = '{{ subscription_id }}' -- required
AND $expand = '{{ $expand }}'
AND $filter = '{{ $filter }}'
AND $top = '{{ $top }}'
AND $orderby = '{{ $orderby }}'
;

INSERT examples

create_or_update

Create or replace an existing schedule.

INSERT INTO azure.dev_test_labs.global_schedules (
location,
tags,
properties,
resource_group_name,
name,
subscription_id
)
SELECT 
'{{ location }}',
'{{ tags }}',
'{{ properties }}',
'{{ resource_group_name }}',
'{{ name }}',
'{{ subscription_id }}'
RETURNING
id,
name,
location,
properties,
tags,
type
;

Manifest

# Description fields are for documentation purposes
- name: global_schedules
props:
  - name: resource_group_name
    value: "{{ resource_group_name }}"
    description: Required parameter for the global_schedules resource.
  - name: name
    value: "{{ name }}"
    description: Required parameter for the global_schedules resource.
  - name: subscription_id
    value: "{{ subscription_id }}"
    description: Required parameter for the global_schedules resource.
  - name: location
    value: "{{ location }}"
    description: |
      The location of the resource.
  - name: tags
    value: "{{ tags }}"
    description: |
      The tags of the resource.
  - name: properties
    value:
      status: "{{ status }}"
      taskType: "{{ taskType }}"
      weeklyRecurrence:
        weekdays:
          - "{{ weekdays }}"
        time: "{{ time }}"
      dailyRecurrence:
        time: "{{ time }}"
      hourlyRecurrence:
        minute: {{ minute }}
      timeZoneId: "{{ timeZoneId }}"
      notificationSettings:
        status: "{{ status }}"
        timeInMinutes: {{ timeInMinutes }}
        webhookUrl: "{{ webhookUrl }}"
        emailRecipient: "{{ emailRecipient }}"
        notificationLocale: "{{ notificationLocale }}"
      targetResourceId: "{{ targetResourceId }}"

UPDATE examples

update

Allows modifying tags of schedules. All other properties will be ignored.

UPDATE azure.dev_test_labs.global_schedules
SET 
-- No updatable properties
WHERE 
resource_group_name = '{{ resource_group_name }}' --required
AND name = '{{ name }}' --required
AND subscription_id = '{{ subscription_id }}' --required
RETURNING
id,
name,
location,
properties,
tags,
type;

REPLACE examples

create_or_update

Create or replace an existing schedule.

REPLACE azure.dev_test_labs.global_schedules
SET 
location = '{{ location }}',
tags = '{{ tags }}',
properties = '{{ properties }}'
WHERE 
resource_group_name = '{{ resource_group_name }}' --required
AND name = '{{ name }}' --required
AND subscription_id = '{{ subscription_id }}' --required
RETURNING
id,
name,
location,
properties,
tags,
type;

DELETE examples

delete

Delete schedule.

DELETE FROM azure.dev_test_labs.global_schedules
WHERE resource_group_name = '{{ resource_group_name }}' --required
AND name = '{{ name }}' --required
AND subscription_id = '{{ subscription_id }}' --required
;

Lifecycle Methods

execute

Execute a schedule. This operation can take a while to complete.

EXEC azure.dev_test_labs.global_schedules.execute 
@resource_group_name='{{ resource_group_name }}' --required, 
@name='{{ name }}' --required, 
@subscription_id='{{ subscription_id }}' --required
;

retarget

Updates a schedule's target resource Id. This operation can take a while to complete.

EXEC azure.dev_test_labs.global_schedules.retarget 
@resource_group_name='{{ resource_group_name }}' --required, 
@name='{{ name }}' --required, 
@subscription_id='{{ subscription_id }}' --required
;