v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1439179139.2 KB

Returns a list of shifts based on rotation configuration parameters.

The Incident Manager primarily uses this operation to populate the Preview calendar. It is not typically run by end users.

post/#X-Amz-Target=SSMContacts.ListPreviewRotationShifts

Query parameters

MaxResultsstring

Pagination limit

NextTokenstring

Pagination token

Headers

X-Amz-Target'SSMContacts.ListPreviewRotationShifts' required

Request body

RotationStartTimestring date-time

The date and time a rotation would begin. The first shift is calculated from this date and time.

StartTimestring date-time

Used to filter the range of calculated shifts before sending the response back to the user.

EndTimestring date-time required

The date and time a rotation shift would end.

MembersMember[] required

The contacts that would be assigned to a rotation.

TimeZoneIdstring required

The time zone the rotation’s activity would be based on, in Internet Assigned Numbers Authority (IANA) format. For example: "America/Los_Angeles", "UTC", or "Asia/Seoul".

NextTokenstring

A token to start the list. This token is used to get the next set of results.

MaxResultsinteger

The maximum number of items to return for this call. The call also returns a token that can be specified in a subsequent call to get the next set of results.

Response

Success

NextTokenstring

The token for the next set of items to return. This token is used to get the next set of results.