Skip to content

GetCanaryRunsRequest

Source code in docs_src/capo_synthetics/types/get_canary_runs_request.py
class GetCanaryRunsRequest(TypedDict, closed=True):
    name: "capo_synthetics.types.canary_name.CanaryName"
    """<p>The name of the canary that you want to see runs for.</p>"""
    next_token: NotRequired["capo_synthetics.types.token.Token"]
    """<p>A token that indicates that there is more data available. You can use this token in a subsequent <code>GetCanaryRuns</code> operation to retrieve the next set of results.</p> <note> <p>When auto retry is enabled for the canary, the first subsequent retry is suffixed with *1 indicating its the first retry and the next subsequent try is suffixed with *2.</p> </note>"""
    max_results: NotRequired["capo_synthetics.types.max_size100.MaxSize100"]
    """<p>Specify this parameter to limit how many runs are returned each time you use the <code>GetCanaryRuns</code> operation. If you omit this parameter, the default of 100 is used.</p>"""
    dry_run_id: NotRequired["capo_synthetics.types.uuid.UUID"]
    """<p>The DryRunId associated with an existing canary’s dry run. You can use this DryRunId to retrieve information about the dry run.</p>"""
    run_type: NotRequired["capo_synthetics.types.run_type.RunType"]
    """<ul> <li> <p>When you provide <code>RunType=CANARY_RUN</code> and <code>dryRunId</code>, you will get an exception </p> </li> <li> <p>When a value is not provided for <code>RunType</code>, the default value is <code>CANARY_RUN</code> </p> </li> <li> <p>When <code>CANARY_RUN</code> is provided, all canary runs excluding dry runs are returned</p> </li> <li> <p>When <code>DRY_RUN</code> is provided, all dry runs excluding canary runs are returned</p> </li> </ul>"""

dry_run_id instance-attribute

dry_run_id: NotRequired[UUID]

The DryRunId associated with an existing canary’s dry run. You can use this DryRunId to retrieve information about the dry run.

max_results instance-attribute

max_results: NotRequired[MaxSize100]

Specify this parameter to limit how many runs are returned each time you use the GetCanaryRuns operation. If you omit this parameter, the default of 100 is used.

name instance-attribute

name: CanaryName

The name of the canary that you want to see runs for.

next_token instance-attribute

next_token: NotRequired[Token]

A token that indicates that there is more data available. You can use this token in a subsequent GetCanaryRuns operation to retrieve the next set of results.

When auto retry is enabled for the canary, the first subsequent retry is suffixed with *1 indicating its the first retry and the next subsequent try is suffixed with *2.

run_type instance-attribute

run_type: NotRequired[RunType]
  • When you provide RunType=CANARY_RUN and dryRunId, you will get an exception

  • When a value is not provided for RunType, the default value is CANARY_RUN

  • When CANARY_RUN is provided, all canary runs excluding dry runs are returned

  • When DRY_RUN is provided, all dry runs excluding canary runs are returned