Skip to content

StartPlanExecutionRequest

Source code in docs_src/capo_arc_region_switch/types/start_plan_execution_request.py
class StartPlanExecutionRequest(TypedDict, closed=True):
    plan_arn: "capo_arc_region_switch.types.plan_arn.PlanArn"
    """<p>The Amazon Resource Name (ARN) of the plan to execute.</p>"""
    target_region: "str"
    """<p>The Amazon Web Services Region to target with this execution. This is the Region that traffic will be shifted to or from, depending on the action.</p>"""
    action: "capo_arc_region_switch.types.execution_action.ExecutionAction"
    """<p>The action to perform. Valid values are <code>activate</code> (to shift traffic to the target Region) or <code>deactivate</code> (to shift traffic away from the target Region).</p>"""
    mode: "capo_arc_region_switch.types.execution_mode.ExecutionMode"
    """<p>The plan execution mode. Valid values are <code>graceful</code>, for starting the execution in graceful mode, or <code>ungraceful</code>, for starting the execution in ungraceful mode.</p>"""
    comment: NotRequired[
        "capo_arc_region_switch.types.execution_comment.ExecutionComment"
    ]
    """<p>An optional comment explaining why the plan execution is being started.</p>"""
    latest_version: NotRequired["str"]
    """<p>A boolean value indicating whether to use the latest version of the plan. If set to false, you must specify a specific version.</p>"""
    recovery_execution_id: NotRequired[
        "capo_arc_region_switch.types.recovery_execution_id.RecoveryExecutionId"
    ]
    """<p>The execution identifier of the recovery execution that ran in the opposite region post-recovery is ran in. Required when starting a post-recovery execution.</p>"""
    client_token: NotRequired["str"]
    """<p>A unique, case-sensitive identifier to ensure that the operation completes no more than one time. If this token matches a previous request, the service ignores the request and returns the result of the original successful request. If you don't provide a client token, the service automatically generates one. For more information about idempotency, see <a href="https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/">Making retries safe with idempotent APIs</a>.</p>"""

action instance-attribute

The action to perform. Valid values are activate (to shift traffic to the target Region) or deactivate (to shift traffic away from the target Region).

client_token instance-attribute

client_token: NotRequired[str]

A unique, case-sensitive identifier to ensure that the operation completes no more than one time. If this token matches a previous request, the service ignores the request and returns the result of the original successful request. If you don't provide a client token, the service automatically generates one. For more information about idempotency, see Making retries safe with idempotent APIs.

comment instance-attribute

comment: NotRequired[ExecutionComment]

An optional comment explaining why the plan execution is being started.

latest_version instance-attribute

latest_version: NotRequired[str]

A boolean value indicating whether to use the latest version of the plan. If set to false, you must specify a specific version.

mode instance-attribute

The plan execution mode. Valid values are graceful, for starting the execution in graceful mode, or ungraceful, for starting the execution in ungraceful mode.

plan_arn instance-attribute

plan_arn: PlanArn

The Amazon Resource Name (ARN) of the plan to execute.

recovery_execution_id instance-attribute

recovery_execution_id: NotRequired[RecoveryExecutionId]

The execution identifier of the recovery execution that ran in the opposite region post-recovery is ran in. Required when starting a post-recovery execution.

target_region instance-attribute

target_region: str

The Amazon Web Services Region to target with this execution. This is the Region that traffic will be shifted to or from, depending on the action.