---
title: "GET /subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/remediations/{remediationName}"
method: GET
path: "/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/remediations/{remediationName}"
---

# GET /subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/remediations/{remediationName}

`GET /subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/remediations/{remediationName}`

## Request

- Base URL: `https://management.azure.com`
- URL: `https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/remediations/{remediationName}`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `user_impersonation`

Gets an existing remediation at subscription scope.

## Path parameters

- `subscriptionId` string, required
- `remediationName` string, required

## Query parameters

- `api-version` string, required

## Response `200`

The retrieved remediation.

- Remediation: The remediation definition.
  - `properties` RemediationProperties: The remediation properties.
    - `policyAssignmentId` string: The resource ID of the policy assignment that should be remediated.
    - `policyDefinitionReferenceId` string: The policy definition reference ID of the individual definition that should be remediated. Required when the policy assignment being remediated assigns a policy set definition.
    - `resourceDiscoveryMode` 'ExistingNonCompliant' | 'ReEvaluateCompliance': The way resources to remediate are discovered. Defaults to ExistingNonCompliant if not specified.
    - `provisioningState` string: The status of the remediation.
    - `createdOn` string, date-time: The time at which the remediation was created.
    - `lastUpdatedOn` string, date-time: The time at which the remediation was last updated.
    - `filters` RemediationFilters: The filters that will be applied to determine which resources to remediate.
      - `locations` string[]: The resource locations that will be remediated.
    - `deploymentStatus` RemediationDeploymentSummary: The deployment status summary for all deployments created by the remediation.
      - `totalDeployments` integer: The number of deployments required by the remediation.
      - `successfulDeployments` integer: The number of deployments required by the remediation that have succeeded.
      - `failedDeployments` integer: The number of deployments required by the remediation that have failed.
  - `id` string: The ID of the remediation.
  - `type` string: The type of the remediation.
  - `name` string: The name of the remediation.

## Other responses

- `default`: Error response describing why the operation failed.

---

[API](https://skmtc.dev/azure/apis/remediationsclient.md) - [All operations](https://skmtc.dev/azure/apis/remediationsclient/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/remediationsclient/revisions/1cf51ae76be4?raw)
