---
title: "POST /{resourceId}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesSummaryResource}/summarize"
method: POST
path: "/{resourceId}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesSummaryResource}/summarize"
---

# POST /{resourceId}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesSummaryResource}/summarize

`POST /{resourceId}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesSummaryResource}/summarize`

## Request

- Base URL: `https://management.azure.com`
- URL: `https://management.azure.com/{resourceId}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesSummaryResource}/summarize`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `user_impersonation`

Summarizes policy states for the resource.

## Path parameters

- `policyStatesSummaryResource` 'latest', required
- `resourceId` string, required

## Query parameters

- `api-version` string, required
- `$top` integer
- `$from` string, date-time
- `$to` string, date-time
- `$filter` string

## Response `200`

Summarize results.

- SummarizeResults: Summarize action results.
  - `@odata.context` string: OData context string; used by OData clients to resolve type information based on metadata.
  - `@odata.count` integer: OData entity count; represents the number of summaries returned; always set to 1.
  - `value` Summary[]: Summarize action results.
    - `@odata.id` string: OData entity ID; always set to null since summaries do not have an entity ID.
    - `@odata.context` string: OData context string; used by OData clients to resolve type information based on metadata.
    - `results` SummaryResults: Non-compliance summary on a particular summary level.
      - `queryResultsUri` string: HTTP POST URI for queryResults action on Microsoft.PolicyInsights to retrieve raw results for the non-compliance summary.
      - `nonCompliantResources` integer: Number of non-compliant resources.
      - `nonCompliantPolicies` integer: Number of non-compliant policies.
    - `policyAssignments` PolicyAssignmentSummary[]: Policy assignments summary.
      - `policyAssignmentId` string: Policy assignment ID.
      - `policySetDefinitionId` string: Policy set definition ID, if the policy assignment is for a policy set.
      - `results` SummaryResults: Non-compliance summary on a particular summary level.
        - `queryResultsUri` string: HTTP POST URI for queryResults action on Microsoft.PolicyInsights to retrieve raw results for the non-compliance summary.
        - `nonCompliantResources` integer: Number of non-compliant resources.
        - `nonCompliantPolicies` integer: Number of non-compliant policies.
      - `policyDefinitions` PolicyDefinitionSummary[]: Policy definitions summary.
        - `policyDefinitionId` string: Policy definition ID.
        - `policyDefinitionReferenceId` string: Policy definition reference ID.
        - `effect` string: Policy effect, i.e. policy definition action.
        - `results` SummaryResults: Non-compliance summary on a particular summary level.
          - `queryResultsUri` string: HTTP POST URI for queryResults action on Microsoft.PolicyInsights to retrieve raw results for the non-compliance summary.
          - `nonCompliantResources` integer: Number of non-compliant resources.
          - `nonCompliantPolicies` integer: Number of non-compliant policies.

## Other responses

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

---

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