---
title: "Gets a list of repair tasks matching the given filters."
method: GET
path: "/$/GetRepairTaskList"
tags: ["RepairManagement"]
---

# Gets a list of repair tasks matching the given filters.

`GET /$/GetRepairTaskList`

This API supports the Service Fabric platform; it is not meant to be used directly from your code.

## Query parameters

- `api-version` '6.0', required
- `TaskIdFilter` string
- `StateFilter` integer
- `ExecutorFilter` string

## Response `200`

A successful operation will return 200 status code.
The response body provides a list of repair tasks matching all of the given filters.

- RepairTask[] — A list of repair tasks.
  - `TaskId` string, required — The ID of the repair task.
  - `Version` string — The version of the repair task. When creating a new repair task, the version must be set to zero. When updating a repair task, the version is used for optimistic concurrency checks. If the version is set to zero, the update will not check for write conflicts. If the version is set to a non-zero value, then the update will only succeed if the actual current version of the repair task matches this value.
  - `Description` string — A description of the purpose of the repair task, or other informational details. May be set when the repair task is created, and is immutable once set.
  - `State` 'Invalid' | 'Created' | 'Claimed' | 'Preparing' | 'Approved' | 'Executing' | 'Restoring' | 'Completed', required — The workflow state of the repair task. Valid initial states are Created, Claimed, and Preparing.
  - `Flags` integer — A bitwise-OR of the following values, which gives additional details about the status of the repair task. - 1 - Cancellation of the repair has been requested - 2 - Abort of the repair has been requested - 4 - Approval of the repair was forced via client request
  - `Action` string, required — The requested repair action. Must be specified when the repair task is created, and is immutable once set.
  - `Target` RepairTargetDescriptionBase — Describes the entities targeted by a repair action. This type supports the Service Fabric platform; it is not meant to be used directly from your code.
    - `Kind` 'Invalid' | 'Node', required — Specifies the kind of the repair target. This type supports the Service Fabric platform; it is not meant to be used directly from your code.'
  - `Executor` string — The name of the repair executor. Must be specified in Claimed and later states, and is immutable once set.
  - `ExecutorData` string — A data string that the repair executor can use to store its internal state.
  - `Impact` RepairImpactDescriptionBase — Describes the expected impact of executing a repair task. This type supports the Service Fabric platform; it is not meant to be used directly from your code.
    - `Kind` 'Invalid' | 'Node', required — Specifies the kind of the impact. This type supports the Service Fabric platform; it is not meant to be used directly from your code.'
  - `ResultStatus` 'Invalid' | 'Succeeded' | 'Cancelled' | 'Interrupted' | 'Failed' | 'Pending' — A value describing the overall result of the repair task execution. Must be specified in the Restoring and later states, and is immutable once set.
  - `ResultCode` integer — A numeric value providing additional details about the result of the repair task execution. May be specified in the Restoring and later states, and is immutable once set.
  - `ResultDetails` string — A string providing additional details about the result of the repair task execution. May be specified in the Restoring and later states, and is immutable once set.
  - `History` RepairTaskHistory — A record of the times when the repair task entered each state. This type supports the Service Fabric platform; it is not meant to be used directly from your code.
    - `CreatedUtcTimestamp` string, date-time — The time when the repair task entered the Created state.
    - `ClaimedUtcTimestamp` string, date-time — The time when the repair task entered the Claimed state.
    - `PreparingUtcTimestamp` string, date-time — The time when the repair task entered the Preparing state.
    - `ApprovedUtcTimestamp` string, date-time — The time when the repair task entered the Approved state
    - `ExecutingUtcTimestamp` string, date-time — The time when the repair task entered the Executing state
    - `RestoringUtcTimestamp` string, date-time — The time when the repair task entered the Restoring state
    - `CompletedUtcTimestamp` string, date-time — The time when the repair task entered the Completed state
    - `PreparingHealthCheckStartUtcTimestamp` string, date-time — The time when the repair task started the health check in the Preparing state.
    - `PreparingHealthCheckEndUtcTimestamp` string, date-time — The time when the repair task completed the health check in the Preparing state.
    - `RestoringHealthCheckStartUtcTimestamp` string, date-time — The time when the repair task started the health check in the Restoring state.
    - `RestoringHealthCheckEndUtcTimestamp` string, date-time — The time when the repair task completed the health check in the Restoring state.
  - `PreparingHealthCheckState` 'NotStarted' | 'InProgress' | 'Succeeded' | 'Skipped' | 'TimedOut' — Specifies the workflow state of a repair task's health check. This type supports the Service Fabric platform; it is not meant to be used directly from your code.
  - `RestoringHealthCheckState` 'NotStarted' | 'InProgress' | 'Succeeded' | 'Skipped' | 'TimedOut' — Specifies the workflow state of a repair task's health check. This type supports the Service Fabric platform; it is not meant to be used directly from your code.
  - `PerformPreparingHealthCheck` boolean — A value to determine if health checks will be performed when the repair task enters the Preparing state.
  - `PerformRestoringHealthCheck` boolean — A value to determine if health checks will be performed when the repair task enters the Restoring state.

## Other responses

- `default` — The detailed error response.

---

[API](https://skmtc.net/azure/apis/servicefabric-servicefabric.md) · [All operations](https://skmtc.net/azure/apis/servicefabric-servicefabric/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/servicefabric-servicefabric/revisions/8fd479ce0f16/schema)
