Managing Schedules

This page describes the schedule details window and how to use it to monitor and manage the schedules you have created.

Note

Important! To create schedules using these procedures, you must have the permissions to access and modify Resource Scheduler schedules (see Example 1) AND you must create a policy to allow a schedule to manage resources (see Example 2).

For more information, see Authentication and Authorization, Resource Scheduler Policies, and Example Policies.

Example 1. This policy gives users permission to manage (create, delete, activate, and others) resource schedules in their tenancy.

General example
Allow group <groupname> to manage resource-schedule-family in tenancy

Specific example
Allow group ResourceScheduleAdmins to manage resource-schedule-family in tenancy

Example 2. This policy gives a resource schedule permission to perform an action on a resource.

When a resource schedule is created, by default, it doesn't have permission to perform the action on target resources, so you must give it permission.

This policy allows a schedule to manage predefined resources such as instances in a compartment.

General example
Allow any-user to manage <resource_type> 
in compartment id <compartment_ocid> where all
{request.principal.type='resourceschedule',
request.principal.id='<ocid_of_resourceschedule>'}

Specific example
Allow any-user to manage instance in
compartment id ocid.compartment.oc1...q7fa where all
{request.principal.type='resourceschedule',
request.principal.id='ocid.resourceschedule.oc1.iad.axgr...dt8zb'}

To display the details page for a specific schedule:
1. Open the navigation menu and click Governance & Administration.
2. Under Resource Scheduler, click Schedules. The list of existing schedules is displayed.
3. Click the Display name of a schedule that you want to manage. The schedule Details page opens.
4. Optional: Click the actions menu at the right end of the row that contains the schedule you want to manage. The schedule Details page opens.
The main section of the schedule details page shows detailed information about the schedule, including the set of tasks that you can perform on a schedule.
The Schedule Details section of the page shows these details about the schedule:
- The schedule OCID, which you can show or hide, and copy
- The Description of the schedule
- Recurrence Details, for example, Every day at 00:00
- The compartment ID, which you can show or hide, and copy
- The last Action used in the schedule (Start or Stop)
- The number of resources acted on by this schedule
- Time Created- the time the schedule was created
- Time Starts- the time the schedule started
- End Date- the date the schedule ends
- The last run date (if any)
- The next run date (if any)
  Optional: Click Resources to open the Resources in schedule window. This window shows:
  
  The Display Name,
  
  The Resource type,
  
  The resource OCID
  
  The Compartment that the resource is in
  
  The Status of the resource
  
  The date the resource was created
The Work Requests section of the details page is a table that shows the details of each schedule run.
- The Run date when the schedule will run or has run
- The number of Resources in this schedule
- The Status of the schedule, including Succeeded, Failed, or Needs Attention.
- The Duration of the run,
  Optional: Click the Run Date of the schedule to display details about the run. The Run details window opens. It shows the following details:
  
  The schedule OCID
  
  The Operation Type: Create schedule, Update schedule, Start resource, Stop resource
  
  The status of the operation: Succeeded or Failed
  
  The Resource Type, for example, resourceschedule
  
  The work request OCID
  
  The resource Status, for example: Created or In-progress
  
  The Actions menu () on the right side of the row. Click the menu, then click Copy OCID to copy the resource type and OCID.
Use the Resource SchedulerGet Schedule CLI command and required parameters to show schedule details.
```
Command
oci resource-scheduler schedule get --schedule-id, -? | -h | --help   
```
For a complete list of parameters and values for CLI commands, see the CLI Command Reference.
Use the Resource Scheduler Get Schedule to list schedules.
For a complete list of Resource Scheduler APIs, see Resource Scheduler APIs.

Oracle Cloud Infrastructure Documentation

Managing Schedules