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

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

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

Summarizes policy states for the resources under the subscription.

## Path parameters

- `policyStatesSummaryResource` 'latest', required
- `subscriptionId` 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.net/azure/apis/policystatesclient.md) · [All operations](https://skmtc.net/azure/apis/policystatesclient/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/policystatesclient/revisions/b38ff3b427a5/schema)