Create Schedule Rotation
Create a specific schedule rotation in Opsgenie.
Make sure that the API key that's used to create the Opsgenie connection for this card is not team-specific. Otherwise, any input value in the Team ID or Team Name fields on this card will not override the team that's specified by a team-specific API key. It is recommended to create and manage API keys on the Opsgenie API key management page.
Options
Field | Definition | Type | Required |
---|---|---|---|
Schedule Identifier |
Type of schedule identifier for the team. Choose one of the following options:
|
Dropdown |
TRUE |
Add Time Restrictions? |
Specify if time restriction is added. Choose one of the following options:
|
Dropdown |
TRUE |
Input
These fields are dynamically generated based on the fields selected in Options.
Field | Definition | Type | Required |
---|---|---|---|
Rotation |
|||
Time Restrictions |
Used to limit schedule rotation to a certain day and time of the week, using multiple start and end times for each day of the week. This allows for applying different scheduling rotations at different times.
If Time Only is selected for Add Time Restrictions? options, the following options are available. Hours are rounded down, and minutes are rounded to the closest 00/30.
For example: Copy
If Day and Time is selected for Add Time Restrictions? options, the following options are available. Both day and time options are required.
For example: Copy
|
Object |
TRUE |
Schedule ID |
Unique ID of the schedule.
This field displays when Schedule ID is selected from the Schedule Identifier option. |
Text |
TRUE |
Schedule Name |
Name of the schedule.
This field displays when Schedule Name is selected from the Schedule Identifier option. |
Text |
TRUE |
Name | Name of the new schedule rotation. |
Text |
FALSE |
Start Date | Start date of the rotation. Date format as yyyy-MM-dd'T'HH:mm:ssZ (for example, 2017-01-15T08:00:00+02:00). Minutes may take 0 or 30 as value. Otherwise they will be converted to nearest 0 or 30 automatically. |
Date & Time |
TRUE |
End Date | End date of the rotation. Date format as yyyy-MM-dd'T'HH:mm:ssZ (for example, 2017-01-15T08:00:00+02:00) Minutes may take 0 or 30 as value. Otherwise they will be converted to nearest 0 or 30 automatically. |
Date & Time |
FALSE |
Type |
Duration of rotation. Choose one of the following options:
|
Dropdown |
TRUE |
Length | Length of the rotation. Default value is 1. |
Number |
FALSE |
Participants |
List of escalations, teams, users or none which are used in a schedule. Each of them can be used multiple times and will be rotated in the order they are given.
For user and team, optionally define ID or username properties. For example: Copy
|
Array of Objects |
FALSE |
Output
Field | Definition | Type |
---|---|---|
Status Code |
Result of the operation. The connector returns an HTTP status code that indicates whether the action taken by the card succeeded or failed. For example:
For a full list of possible status codes, see HTTP status codes. |
Number |
Result |
Result of the API call.
For example, Deleted. |
Text |
Rotation ID | Name of the new schedule rotation. |
Text |
Name | Name of the new schedule rotation. |
Text |