oci_resource_scheduler_schedule

This resource provides the Schedule resource in Oracle Cloud Infrastructure Resource Scheduler service.

Creates a Schedule

Example Usage

resource "oci_resource_scheduler_schedule" "test_schedule" {
	#Required
	action = var.schedule_action
	compartment_id = var.compartment_id
	recurrence_details = var.schedule_recurrence_details
	recurrence_type = var.schedule_recurrence_type

	#Optional
	defined_tags = {"Operations.CostCenter"= "42"}
	description = var.schedule_description
	display_name = var.schedule_display_name
	freeform_tags = {"Department"= "Finance"}
	resource_filters {
		#Required
		attribute = var.schedule_resource_filters_attribute

		#Optional
		condition = var.schedule_resource_filters_condition
		should_include_child_compartments = var.schedule_resource_filters_should_include_child_compartments
		value {

			#Optional
			namespace = var.schedule_resource_filters_value_namespace
			tag_key = var.schedule_resource_filters_value_tag_key
			value = var.schedule_resource_filters_value_value
		}
	}
	resources {
		#Required
		id = var.schedule_resources_id

		#Optional
		metadata = var.schedule_resources_metadata
	}
	time_ends = var.schedule_time_ends
	time_starts = var.schedule_time_starts
}

Argument Reference

The following arguments are supported:

• action - (Required) (Updatable) This is the action that will be executed by the schedule.

• compartment_id - (Required) The OCID of the compartment in which the schedule is created

• defined_tags - (Optional) (Updatable) These are defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}

• description - (Optional) (Updatable) This is the description of the schedule.

• display_name - (Optional) (Updatable) This is a user-friendly name for the schedule. It does not have to be unique, and it’s changeable.

• freeform_tags - (Optional) (Updatable) These are free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

• recurrence_details - (Required) (Updatable) This is the frequency of recurrence of a schedule. The frequency field can either conform to RFC-5545 formatting or UNIX cron formatting for recurrences, based on the value specified by the recurrenceType field.

• recurrence_type - (Required) (Updatable) Type of recurrence of a schedule

• resource_filters - (Optional) (Updatable) This is a list of resources filters. The schedule will be applied to resources matching all of them.

  • attribute - (Required) (Updatable) This is the resource attribute on which the threshold is defined.
  • condition - (Applicable when attribute=TIME_CREATED) (Updatable) This is the condition for the filter in comparison to its creation time.
  • should_include_child_compartments - (Applicable when attribute=COMPARTMENT_ID) (Updatable) This sets whether to include child compartments.
  • value - (Optional) (Updatable) This is a collection of resource lifecycle state values.
    • namespace - (Applicable when attribute=DEFINED_TAGS) (Updatable) This is the namespace of the defined tag.
    • tag_key - (Applicable when attribute=DEFINED_TAGS) (Updatable) This is the key of the defined tag.
    • value - (Applicable when attribute=DEFINED_TAGS) (Updatable) This is the value of the defined tag.

• resources - (Optional) (Updatable) This is the list of resources to which the scheduled operation is applied.

  • id - (Required) (Updatable) This is the resource OCID.

  • metadata - (Optional) (Updatable) This is additional information that helps to identity the resource for the schedule.

    { “id”: “” “metadata”: { “namespaceName”: “sampleNamespace”, “bucketName”: “sampleBucket” } }

• time_ends - (Optional) (Updatable) This is the date and time the schedule ends, in the format defined by RFC 3339 Example: 2016-08-25T21:10:29.600Z

• time_starts - (Optional) (Updatable) This is the date and time the schedule starts, in the format defined by RFC 3339 Example: 2016-08-25T21:10:29.600Z

• state - (Optional) (Updatable) The target state for the Schedule. Could be set to ACTIVE or INACTIVE.

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

Attributes Reference

The following attributes are exported:

• action - This is the action that will be executed by the schedule.

• compartment_id - The OCID of the compartment in which the schedule is created

• defined_tags - These are defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}

• description - This is the description of the schedule.

• display_name - This is a user-friendly name for the schedule. It does not have to be unique, and it’s changeable.

• freeform_tags - These are free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

• id - The OCID of the schedule

• recurrence_details - This is the frequency of recurrence of a schedule. The frequency field can either conform to RFC-5545 formatting or UNIX cron formatting for recurrences, based on the value specified by the recurrenceType field.

• recurrence_type - Type of recurrence of a schedule

• resource_filters - This is a list of resources filters. The schedule will be applied to resources matching all of them.

  • attribute - This is the resource attribute on which the threshold is defined.
  • condition - This is the condition for the filter in comparison to its creation time.
  • should_include_child_compartments - This sets whether to include child compartments.
  • value - This is a collection of resource lifecycle state values.
    • namespace - This is the namespace of the defined tag.
    • tag_key - This is the key of the defined tag.
    • value - This is the value of the defined tag.

• resources - This is the list of resources to which the scheduled operation is applied.

  • id - This is the resource OCID.

  • metadata - This is additional information that helps to identity the resource for the schedule.

    { “id”: “” “metadata”: { “namespaceName”: “sampleNamespace”, “bucketName”: “sampleBucket” } }

• state - This is the current state of a schedule.

• system_tags - These are system tags for this resource. Each key is predefined and scoped to a namespace. Example: {"orcl-cloud.free-tier-retained": "true"}

• time_created - This is the date and time the schedule was created, in the format defined by RFC 3339. Example: 2016-08-25T21:10:29.600Z

• time_ends - This is the date and time the schedule ends, in the format defined by RFC 3339 Example: 2016-08-25T21:10:29.600Z

• time_last_run - This is the date and time the schedule runs last time, in the format defined by RFC 3339. Example: 2016-08-25T21:10:29.600Z

• time_next_run - This is the date and time the schedule run the next time, in the format defined by RFC 3339. Example: 2016-08-25T21:10:29.600Z

• time_starts - This is the date and time the schedule starts, in the format defined by RFC 3339 Example: 2016-08-25T21:10:29.600Z

• time_updated - This is the date and time the schedule was updated, in the format defined by RFC 3339. Example: 2016-08-25T21:10:29.600Z

Timeouts

The timeouts block allows you to specify timeouts for certain operations: * create - (Defaults to 20 minutes), when creating the Schedule * update - (Defaults to 20 minutes), when updating the Schedule * delete - (Defaults to 20 minutes), when destroying the Schedule

Import

Schedules can be imported using the id, e.g.

$ terraform import oci_resource_scheduler_schedule.test_schedule "id"