oci_resource_scheduler_schedule
This resource provides the Schedule resource in Oracle Cloud Infrastructure Resource Scheduler service.
This API creates a schedule. You must provide either resources or resourceFilters.
Example Usage
resource "oci_resource_scheduler_schedule" "test_schedule" {
<<<<<<< ours
#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
parameters {
#Required
parameter_type = var.schedule_resources_parameters_parameter_type
#Optional
value = var.schedule_resources_parameters_value
}
}
time_ends = var.schedule_time_ends
time_starts = var.schedule_time_starts
=======
#Required
action = var.schedule_action
compartment_id = var.compartment_id
recurrence_details = var.schedule_recurrence_details
recurrence_type = var.schedule_recurrence_type
resource_filters {
# Required
attribute = "DEFINED_TAGS"
value {
namespace="SampleNamespace"
tag_key="SampleTagKey"
value="SampleValue"
}
}
resource_filters {
# Required
attribute = "LIFECYCLE_STATE"
value {
value="SampleLifecycleState"
}
}
resource_filters {
# Required
attribute = "COMPARTMENT_ID"
value {
value=var.compartment_id
}
}
#Optional
defined_tags = map(oci_identity_tag_namespace.tag-namespace1.name.oci_identity_tag.tag1.name, var.schedule_defined_tags_value)
description = var.schedule_description
display_name = var.schedule_display_name
freeform_tags = var.schedule_freeform_tags
time_ends = var.schedule_time_ends
time_starts = var.schedule_time_starts
>>>>>>> theirs
}
Argument Reference
The following arguments are supported:
action- (Required) (Updatable) This is the action that will be executed by the schedule. <<<<<<< ourscompartment_id- (Required) (Updatable) The OCID of the compartment in which the schedule is createddefined_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 =======compartment_id- (Required) The OCID of the compartment in which the schedule is createdrecurrence_type- (Required) (Updatable) Type of recurrence of a schedule. Could be set toICAL,CRONrecurrence_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. Example:FREQ=WEEKLY;BYDAY=MO,TU,WE,TH;BYHOUR=10;INTERVAL=1
theirs *
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. We support 5 different types of attributes:DEFINED_TAGS,COMPARTMENT_ID,TIME_CREATED,LIFECYCLE_STATEandRESOURCE_TYPE. *value- (Optional) (Updatable) This is a collection of resource filter values, different types of filter has different value format, see below: * Whenattribute="DEFINED_TAGS": *namespace- (Updatable) This is the namespace of the defined tag. *tag_key- (Updatable) This is the key of the defined tag. *value- (Updatable) This is the value of the defined tag. * Whenattribute="TIME_CREATED": *condition- (Applicable when attribute=TIME_CREATED) (Updatable) This is the condition for the filter in comparison to its creation time. Could be set toEQUAL,BEFOREandAFTER. *value- (Updatable) This is the date and time of resources used for filtering, in the format defined by RFC 3339 Example:2016-08-25T21:10:29.600Z* Whenattribute="COMPARTMENT_ID": *should_include_child_compartments- (Updatable) This boolean sets whether to include child compartments. *value- (Updatable) This is the compartment id used for filtering. * Whenattribute="RESOURCE_TYPE": *value- (Updatable) This is the resource type used for filtering. * whenattribute="LIFECYCLE_STATE": *value- (Updatable) This is the lifecycle state value used for filtering.
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.
<<<<<<< ours
{ “id”: “parameters - (Optional) (Updatable) This is the user input parameters to use when acting on the resource.
{ "parameters": [ { "parameterType": "BODY", "value": { "ip": "192.168.44.44", "memory": "1024", "synced_folders": [ { "host_path": "data/", "guest_path": "/var/www", "type": "default" } ], "forwarded_ports": [] } }, { "parameterType": "PATH", "value": { "compartmentId": "ocid1.compartment.oc1..xxxxx", "instanceId": "ocid1.vcn.oc1..yyyy" } }, { "parameterType": "QUERY", "value": { "limit": "10", "tenantId": "ocid1.tenant.oc1..zzzz" } }, { "parameterType": "HEADER", "value": { "token": "xxxx" } } ] }
* `parameter_type` - (Required) (Updatable) This is the parameter type on which the input parameter is defined
* `value` - (Optional) (Updatable) This is the HTTP request header value.
=======
{ “id”: “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"}
>>>>>>> theirs
* 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 createddefined_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 schedulelast_run_status- This is the status of the last work request.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 scheduleresource_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 filter 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 designated resource filter type value.
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” } } parameters- This is the user input parameters to use when acting on the resource.{ “parameters”: [ { “parameterType”: “BODY”, “value”: { “ip”: “192.168.44.44”, “memory”: “1024”, “synced_folders”: [ { “host_path”: “data/”, “guest_path”: “/var/www”, “type”: “default” } ], “forwarded_ports”: [] } }, { “parameterType”: “PATH”, “value”: { “compartmentId”: “ocid1.compartment.oc1..xxxxx”, “instanceId”: “ocid1.vcn.oc1..yyyy” } }, { “parameterType”: “QUERY”, “value”: { “limit”: “10”, “tenantId”: “ocid1.tenant.oc1..zzzz” } }, { “parameterType”: “HEADER”, “value”: { “token”: “xxxx” } } ] }
parameter_type- This is the parameter type on which the input parameter is definedvalue- This is the HTTP request header value.
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.600Ztime_ends- This is the date and time the schedule ends, in the format defined by RFC 3339 Example:2016-08-25T21:10:29.600Ztime_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.600Ztime_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.600Ztime_starts- This is the date and time the schedule starts, in the format defined by RFC 3339 Example:2016-08-25T21:10:29.600Ztime_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"