---
title: "PATCH /configuration/{resourceIdentifier}"
method: PATCH
path: "/configuration/{resourceIdentifier}"
---

# PATCH /configuration/{resourceIdentifier}

`PATCH /configuration/{resourceIdentifier}`

Update a practice run configuration to change one or more of the following: add, change, or remove the blocking alarm; change the outcome alarm; or add, change, or remove blocking dates or time windows.

## Path parameters

- `resourceIdentifier` string, required

## Request body

- object
  - `blockedWindows` BlockedWindow[] — <p>Add, change, or remove windows of days and times for when you can, optionally, block ARC from starting a practice run for a resource.</p> <p>The format for blocked windows is: DAY:HH:SS-DAY:HH:SS. Keep in mind, when you specify dates, that dates and times for practice runs are in UTC. Also, be aware of potential time adjustments that might be required for daylight saving time differences. Separate multiple blocked windows with spaces.</p> <p>For example, say you run business report summaries three days a week. For this scenario, you might set the following recurring days and times as blocked windows, for example: <code>MON-20:30-21:30 WED-20:30-21:30 FRI-20:30-21:30</code>.</p>
  - `blockedDates` BlockedDate[] — <p>Add, change, or remove blocked dates for a practice run in zonal autoshift.</p> <p>Optionally, you can block practice runs for specific calendar dates. The format for blocked dates is: YYYY-MM-DD. Keep in mind, when you specify dates, that dates and times for practice runs are in UTC. Separate multiple blocked dates with spaces.</p> <p>For example, if you have an application update scheduled to launch on May 1, 2024, and you don't want practice runs to shift traffic away at that time, you could set a blocked date for <code>2024-05-01</code>.</p>
  - `blockingAlarms` ControlCondition[] — Add, change, or remove the Amazon CloudWatch alarms that you optionally specify as the blocking alarms for practice runs.
    - `type` 'CLOUDWATCH', required — The type of alarm specified for a practice run. You can only specify Amazon CloudWatch alarms for practice runs, so the only valid value is <code>CLOUDWATCH</code>.
    - `alarmIdentifier` string, required — The Amazon Resource Name (ARN) for an Amazon CloudWatch alarm that you specify as a control condition for a practice run.
  - `allowedWindows` AllowedWindow[] — <p>Add, change, or remove windows of days and times for when you can, optionally, allow ARC to start a practice run for a resource.</p> <p>The format for allowed windows is: DAY:HH:SS-DAY:HH:SS. Keep in mind, when you specify dates, that dates and times for practice runs are in UTC. Also, be aware of potential time adjustments that might be required for daylight saving time differences. Separate multiple allowed windows with spaces.</p> <p>For example, say you want to allow practice runs only on Wednesdays and Fridays from noon to 5 p.m. For this scenario, you could set the following recurring days and times as allowed windows, for example: <code>Wed-12:00-Wed:17:00 Fri-12:00-Fri:17:00</code>.</p> <important> <p>The <code>allowedWindows</code> have to start and end on the same day. Windows that span multiple days aren't supported.</p> </important>
  - `outcomeAlarms` ControlCondition[] — Specify one or more Amazon CloudWatch alarms as the outcome alarms for practice runs.
    - `type` 'CLOUDWATCH', required — The type of alarm specified for a practice run. You can only specify Amazon CloudWatch alarms for practice runs, so the only valid value is <code>CLOUDWATCH</code>.
    - `alarmIdentifier` string, required — The Amazon Resource Name (ARN) for an Amazon CloudWatch alarm that you specify as a control condition for a practice run.

## Response `200`

Success

- UpdatePracticeRunConfigurationResponse
  - `arn` string, required — The Amazon Resource Name (ARN) of the resource that you updated the practice run for.
  - `name` string, required — The name of the resource that you updated the practice run for.
  - `zonalAutoshiftStatus` 'ENABLED' | 'DISABLED', required — The zonal autoshift status for the resource that you updated the practice run for.
  - `practiceRunConfiguration` object, required — The practice run configuration that was updated.
    - `blockingAlarms` ControlCondition[] — <i>Blocking alarms</i> for practice runs are optional alarms that you can specify that block practice runs when one or more of the alarms is in an <code>ALARM</code> state.
      - `type` 'CLOUDWATCH', required — The type of alarm specified for a practice run. You can only specify Amazon CloudWatch alarms for practice runs, so the only valid value is <code>CLOUDWATCH</code>.
      - `alarmIdentifier` string, required — The Amazon Resource Name (ARN) for an Amazon CloudWatch alarm that you specify as a control condition for a practice run.
    - `outcomeAlarms` ControlCondition[], required — <i>Outcome alarms</i> for practice runs are alarms that you specify that end a practice run when one or more of the alarms is in an <code>ALARM</code> state.
      - `type` 'CLOUDWATCH', required — The type of alarm specified for a practice run. You can only specify Amazon CloudWatch alarms for practice runs, so the only valid value is <code>CLOUDWATCH</code>.
      - `alarmIdentifier` string, required — The Amazon Resource Name (ARN) for an Amazon CloudWatch alarm that you specify as a control condition for a practice run.
    - `blockedWindows` BlockedWindow[] — <p>An array of one or more windows of days and times that you can block ARC from starting practice runs for a resource.</p> <p>Specify the blocked windows in UTC, using the format <code>DAY:HH:MM-DAY:HH:MM</code>, separated by spaces. For example, <code>MON:18:30-MON:19:30 TUE:18:30-TUE:19:30</code>.</p> <p>The <code>blockedWindows</code> have to start and end on the same day. Windows that span multiple days aren't supported.</p>
    - `allowedWindows` AllowedWindow[] — <p>An array of one or more windows of days and times that you can allow ARC to start practice runs for a resource.</p> <p>For example, say you want to allow practice runs only on Wednesdays and Fridays from noon to 5 p.m. For this scenario, you could set the following recurring days and times as allowed windows, for example: <code>Wed-12:00-Wed:17:00 Fri-12:00-Fri:17:00</code>.</p> <p>The <code>allowedWindows</code> have to start and end on the same day. Windows that span multiple days aren't supported.</p>
    - `blockedDates` BlockedDate[] — <p>An array of one or more dates that you can specify when Amazon Web Services does not start practice runs for a resource.</p> <p>Specify blocked dates, in UTC, in the format <code>YYYY-MM-DD</code>, separated by spaces. </p>

## Other responses

- `480` — InternalServerException
- `481` — ConflictException
- `482` — ResourceNotFoundException
- `483` — ThrottlingException
- `484` — AccessDeniedException
- `485` — ValidationException

---

[API](https://skmtc.net/aws/apis/arc-zonal-shift.md) · [All operations](https://skmtc.net/aws/apis/arc-zonal-shift/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/arc-zonal-shift/versions/082f46183a4a/schema)
