Microsoft Azure Policy States Client

The Microsoft Azure Policy States Client is a tool that allows organizations to define and enforce policies for resources within their Azure environment. It provides a centralized platform where administrators can create, manage, and assign policies that govern the configuration and behavior of their resources. By using the Azure Policy States Client, organizations can ensure compliance with internal standards, industry regulations, and best practices.

OpenAPI Specification

policystatesclient-openapi-original.yml Raw ↑
swagger: '2.0'
info:
  title: Microsoft Azure PolicyStatesClient
  version: 2018-07-01-preview
host: management.azure.com
schemes:
  - https
produces:
  - application/json
security:
  - azure_auth:
      - user_impersonation
securityDefinitions:
  azure_auth:
    type: oauth2
    authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
    flow: implicit
    description: Azure Active Directory OAuth2 Flow
    scopes:
      user_impersonation: impersonate your user account
paths:
  ? /providers/{managementGroupsNamespace}/managementGroups/{managementGroupName}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesResource}/queryResults
  : post:
      operationId: microsoftAzurePolicystatesListqueryresultsformanagementgroup
      description: Queries policy states for the resources under the management group.
      parameters:
        - $ref: '#/parameters/policyStatesResourceParameter'
        - $ref: '#/parameters/managementGroupsNamespaceParameter'
        - $ref: '#/parameters/managementGroupNameParameter'
        - $ref: '#/parameters/apiVersionParameter'
        - $ref: '#/parameters/topParameter'
        - $ref: '#/parameters/orderByParameter'
        - $ref: '#/parameters/selectParameter'
        - $ref: '#/parameters/fromParameter'
        - $ref: '#/parameters/toParameter'
        - $ref: '#/parameters/filterParameter'
        - $ref: '#/parameters/applyParameter'
        - $ref: '#/parameters/skipTokenParameter'
      responses:
        '200':
          description: Query results.
          schema:
            $ref: '#/definitions/PolicyStatesQueryResults'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/QueryFailure'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
      x-ms-examples:
        Query latest at management group scope:
          $ref: ./examples/PolicyStates_QueryManagementGroupScope.json
        Query latest at management group scope using odata nextLink:
          $ref: ./examples/PolicyStates_QueryManagementGroupScopeNextLink.json
      summary: >-
        Microsoft Azure Post Providers Managementgroupsnamespace Managementgroups Managementgroupname Providers Microsoft Policyinsights Policystates Policystatesresource Queryresults
      tags:
        - Providers
  ? /providers/{managementGroupsNamespace}/managementGroups/{managementGroupName}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesSummaryResource}/summarize
  : post:
      operationId: microsoftAzurePolicystatesSummarizeformanagementgroup
      description: Summarizes policy states for the resources under the management group.
      parameters:
        - $ref: '#/parameters/policyStatesSummaryResourceParameter'
        - $ref: '#/parameters/managementGroupsNamespaceParameter'
        - $ref: '#/parameters/managementGroupNameParameter'
        - $ref: '#/parameters/apiVersionParameter'
        - $ref: '#/parameters/topParameter'
        - $ref: '#/parameters/fromParameter'
        - $ref: '#/parameters/toParameter'
        - $ref: '#/parameters/filterParameter'
      responses:
        '200':
          description: Summarize results.
          schema:
            $ref: '#/definitions/SummarizeResults'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/QueryFailure'
      x-ms-examples:
        Summarize at management group scope:
          $ref: ./examples/PolicyStates_SummarizeManagementGroupScope.json
      summary: >-
        Microsoft Azure Post Providers Managementgroupsnamespace Managementgroups Managementgroupname Providers Microsoft Policyinsights Policystates Policystatessummaryresource Summarize
      tags:
        - Providers
  /subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesResource}/queryResults:
    post:
      operationId: microsoftAzurePolicystatesListqueryresultsforsubscription
      description: Queries policy states for the resources under the subscription.
      parameters:
        - $ref: '#/parameters/policyStatesResourceParameter'
        - $ref: '#/parameters/subscriptionId'
        - $ref: '#/parameters/apiVersionParameter'
        - $ref: '#/parameters/topParameter'
        - $ref: '#/parameters/orderByParameter'
        - $ref: '#/parameters/selectParameter'
        - $ref: '#/parameters/fromParameter'
        - $ref: '#/parameters/toParameter'
        - $ref: '#/parameters/filterParameter'
        - $ref: '#/parameters/applyParameter'
        - $ref: '#/parameters/skipTokenParameter'
      responses:
        '200':
          description: Query results.
          schema:
            $ref: '#/definitions/PolicyStatesQueryResults'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/QueryFailure'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
      x-ms-examples:
        Query latest at subscription scope:
          $ref: ./examples/PolicyStates_QuerySubscriptionScope.json
        Query latest at subscription scope with next link:
          $ref: ./examples/PolicyStates_QuerySubscriptionScopeNextLink.json
        Time range; sort, select and limit:
          $ref: ./examples/PolicyStates_TimeRangeSortSelectTop.json
        Filter and group with aggregate:
          $ref: ./examples/PolicyStates_FilterAndGroupByWithAggregate.json
        Filter and group without aggregate:
          $ref: ./examples/PolicyStates_FilterAndGroupByWithoutAggregate.json
        Filter and aggregate only:
          $ref: ./examples/PolicyStates_FilterAndAggregateOnly.json
        Filter and multiple groups:
          $ref: ./examples/PolicyStates_FilterAndMultipleGroups.json
      summary: >-
        Microsoft Azure Post Subscriptions Subscriptionid Providers Microsoft Policyinsights Policystates Policystatesresource Queryresults
      tags:
        - Subscriptions
  /subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesSummaryResource}/summarize:
    post:
      operationId: microsoftAzurePolicystatesSummarizeforsubscription
      description: Summarizes policy states for the resources under the subscription.
      parameters:
        - $ref: '#/parameters/policyStatesSummaryResourceParameter'
        - $ref: '#/parameters/subscriptionId'
        - $ref: '#/parameters/apiVersionParameter'
        - $ref: '#/parameters/topParameter'
        - $ref: '#/parameters/fromParameter'
        - $ref: '#/parameters/toParameter'
        - $ref: '#/parameters/filterParameter'
      responses:
        '200':
          description: Summarize results.
          schema:
            $ref: '#/definitions/SummarizeResults'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/QueryFailure'
      x-ms-examples:
        Summarize at subscription scope:
          $ref: ./examples/PolicyStates_SummarizeSubscriptionScope.json
      summary: >-
        Microsoft Azure Post Subscriptions Subscriptionid Providers Microsoft Policyinsights Policystates Policystatessummaryresource Summarize
      tags:
        - Subscriptions
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesResource}/queryResults
  : post:
      operationId: microsoftAzurePolicystatesListqueryresultsforresourcegroup
      description: Queries policy states for the resources under the resource group.
      parameters:
        - $ref: '#/parameters/policyStatesResourceParameter'
        - $ref: '#/parameters/subscriptionId'
        - $ref: '#/parameters/resourceGroupNameParameter'
        - $ref: '#/parameters/apiVersionParameter'
        - $ref: '#/parameters/topParameter'
        - $ref: '#/parameters/orderByParameter'
        - $ref: '#/parameters/selectParameter'
        - $ref: '#/parameters/fromParameter'
        - $ref: '#/parameters/toParameter'
        - $ref: '#/parameters/filterParameter'
        - $ref: '#/parameters/applyParameter'
        - $ref: '#/parameters/skipTokenParameter'
      responses:
        '200':
          description: Query results.
          schema:
            $ref: '#/definitions/PolicyStatesQueryResults'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/QueryFailure'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
      x-ms-examples:
        Query latest at resource group scope:
          $ref: ./examples/PolicyStates_QueryResourceGroupScope.json
        Query latest at resource group scope with next link:
          $ref: ./examples/PolicyStates_QueryResourceGroupScopeNextLink.json
      summary: >-
        Microsoft Azure Post Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Policyinsights Policystates Policystatesresource Queryresults
      tags:
        - Subscriptions
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesSummaryResource}/summarize
  : post:
      operationId: microsoftAzurePolicystatesSummarizeforresourcegroup
      description: Summarizes policy states for the resources under the resource group.
      parameters:
        - $ref: '#/parameters/policyStatesSummaryResourceParameter'
        - $ref: '#/parameters/subscriptionId'
        - $ref: '#/parameters/resourceGroupNameParameter'
        - $ref: '#/parameters/apiVersionParameter'
        - $ref: '#/parameters/topParameter'
        - $ref: '#/parameters/fromParameter'
        - $ref: '#/parameters/toParameter'
        - $ref: '#/parameters/filterParameter'
      responses:
        '200':
          description: Summarize results.
          schema:
            $ref: '#/definitions/SummarizeResults'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/QueryFailure'
      x-ms-examples:
        Summarize at resource group scope:
          $ref: ./examples/PolicyStates_SummarizeResourceGroupScope.json
      summary: >-
        Microsoft Azure Post Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Microsoft Policyinsights Policystates Policystatessummaryresource Summarize
      tags:
        - Subscriptions
  /{resourceId}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesResource}/queryResults:
    post:
      operationId: microsoftAzurePolicystatesListqueryresultsforresource
      description: Queries policy states for the resource.
      parameters:
        - $ref: '#/parameters/policyStatesResourceParameter'
        - $ref: '#/parameters/resourceIdParameter'
        - $ref: '#/parameters/apiVersionParameter'
        - $ref: '#/parameters/topParameter'
        - $ref: '#/parameters/orderByParameter'
        - $ref: '#/parameters/selectParameter'
        - $ref: '#/parameters/fromParameter'
        - $ref: '#/parameters/toParameter'
        - $ref: '#/parameters/filterParameter'
        - $ref: '#/parameters/applyParameter'
        - $ref: '#/parameters/expandParameter'
        - $ref: '#/parameters/skipTokenParameter'
      responses:
        '200':
          description: Query results.
          schema:
            $ref: '#/definitions/PolicyStatesQueryResults'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/QueryFailure'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
      x-ms-examples:
        Query all policy states at resource scope:
          $ref: ./examples/PolicyStates_QueryResourceScope.json
        Query all policy states at resource scope with next link:
          $ref: ./examples/PolicyStates_QueryResourceScopeNextLink.json
        Query all policy states at subscription level resource scope:
          $ref: ./examples/PolicyStates_QuerySubscriptionLevelResourceScope.json
        Query all policy states at nested resource scope:
          $ref: ./examples/PolicyStates_QueryNestedResourceScope.json
        Query all policy states at subscription level nested resource scope:
          $ref: >-
            ./examples/PolicyStates_QuerySubscriptionLevelNestedResourceScope.json
        Query all policy states at resource scope and expand policyEvaluationDetails:
          $ref: >-
            ./examples/PolicyStates_QueryResourceScopeExpandPolicyEvaluationDetails.json
      summary: >-
        Microsoft Azure Post Resourceid Providers Microsoft Policyinsights Policystates Policystatesresource Queryresults
      tags:
        - Providers
  /{resourceId}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesSummaryResource}/summarize:
    post:
      operationId: microsoftAzurePolicystatesSummarizeforresource
      description: Summarizes policy states for the resource.
      parameters:
        - $ref: '#/parameters/policyStatesSummaryResourceParameter'
        - $ref: '#/parameters/resourceIdParameter'
        - $ref: '#/parameters/apiVersionParameter'
        - $ref: '#/parameters/topParameter'
        - $ref: '#/parameters/fromParameter'
        - $ref: '#/parameters/toParameter'
        - $ref: '#/parameters/filterParameter'
      responses:
        '200':
          description: Summarize results.
          schema:
            $ref: '#/definitions/SummarizeResults'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/QueryFailure'
      x-ms-examples:
        Summarize at resource scope:
          $ref: ./examples/PolicyStates_SummarizeResourceScope.json
      summary: >-
        Microsoft Azure Post Resourceid Providers Microsoft Policyinsights Policystates Policystatessummaryresource Summarize
      tags:
        - Providers
  ? /subscriptions/{subscriptionId}/providers/{authorizationNamespace}/policySetDefinitions/{policySetDefinitionName}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesResource}/queryResults
  : post:
      operationId: microsoftAzurePolicystatesListqueryresultsforpolicysetdefinition
      description: Queries policy states for the subscription level policy set definition.
      parameters:
        - $ref: '#/parameters/policyStatesResourceParameter'
        - $ref: '#/parameters/subscriptionId'
        - $ref: '#/parameters/authorizationNamespaceParameter'
        - $ref: '#/parameters/policySetDefinitionNameParameter'
        - $ref: '#/parameters/apiVersionParameter'
        - $ref: '#/parameters/topParameter'
        - $ref: '#/parameters/orderByParameter'
        - $ref: '#/parameters/selectParameter'
        - $ref: '#/parameters/fromParameter'
        - $ref: '#/parameters/toParameter'
        - $ref: '#/parameters/filterParameter'
        - $ref: '#/parameters/applyParameter'
        - $ref: '#/parameters/skipTokenParameter'
      responses:
        '200':
          description: Query results.
          schema:
            $ref: '#/definitions/PolicyStatesQueryResults'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/QueryFailure'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
      x-ms-examples:
        Query latest at subscription level policy set definition scope:
          $ref: >-
            ./examples/PolicyStates_QuerySubscriptionLevelPolicySetDefinitionScope.json
        Query latest at subscription level policy set definition scope with next link:
          $ref: >-
            ./examples/PolicyStates_QuerySubscriptionLevelPolicySetDefinitionScopeNextLink.json
      summary: >-
        Microsoft Azure Post Subscriptions Subscriptionid Providers Authorizationnamespace Policysetdefinitions Policysetdefinitionname Providers Microsoft Policyinsights Policystates Policystatesresource Queryresults
      tags:
        - Subscriptions
  ? /subscriptions/{subscriptionId}/providers/{authorizationNamespace}/policySetDefinitions/{policySetDefinitionName}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesSummaryResource}/summarize
  : post:
      operationId: microsoftAzurePolicystatesSummarizeforpolicysetdefinition
      description: >-
        Summarizes policy states for the subscription level policy set
        definition.
      parameters:
        - $ref: '#/parameters/policyStatesSummaryResourceParameter'
        - $ref: '#/parameters/subscriptionId'
        - $ref: '#/parameters/authorizationNamespaceParameter'
        - $ref: '#/parameters/policySetDefinitionNameParameter'
        - $ref: '#/parameters/apiVersionParameter'
        - $ref: '#/parameters/topParameter'
        - $ref: '#/parameters/fromParameter'
        - $ref: '#/parameters/toParameter'
        - $ref: '#/parameters/filterParameter'
      responses:
        '200':
          description: Summarize results.
          schema:
            $ref: '#/definitions/SummarizeResults'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/QueryFailure'
      x-ms-examples:
        Summarize at policy set definition scope:
          $ref: >-
            ./examples/PolicyStates_SummarizeSubscriptionLevelPolicySetDefinitionScope.json
      summary: >-
        Microsoft Azure Post Subscriptions Subscriptionid Providers Authorizationnamespace Policysetdefinitions Policysetdefinitionname Providers Microsoft Policyinsights Policystates Policystatessummaryresource Summarize
      tags:
        - Subscriptions
  ? /subscriptions/{subscriptionId}/providers/{authorizationNamespace}/policyDefinitions/{policyDefinitionName}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesResource}/queryResults
  : post:
      operationId: microsoftAzurePolicystatesListqueryresultsforpolicydefinition
      description: Queries policy states for the subscription level policy definition.
      parameters:
        - $ref: '#/parameters/policyStatesResourceParameter'
        - $ref: '#/parameters/subscriptionId'
        - $ref: '#/parameters/authorizationNamespaceParameter'
        - $ref: '#/parameters/policyDefinitionNameParameter'
        - $ref: '#/parameters/apiVersionParameter'
        - $ref: '#/parameters/topParameter'
        - $ref: '#/parameters/orderByParameter'
        - $ref: '#/parameters/selectParameter'
        - $ref: '#/parameters/fromParameter'
        - $ref: '#/parameters/toParameter'
        - $ref: '#/parameters/filterParameter'
        - $ref: '#/parameters/applyParameter'
        - $ref: '#/parameters/skipTokenParameter'
      responses:
        '200':
          description: Query results.
          schema:
            $ref: '#/definitions/PolicyStatesQueryResults'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/QueryFailure'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
      x-ms-examples:
        Query latest at subscription level policy definition scope:
          $ref: >-
            ./examples/PolicyStates_QuerySubscriptionLevelPolicyDefinitionScope.json
        Query latest at subscription level policy definition scope with next link:
          $ref: >-
            ./examples/PolicyStates_QuerySubscriptionLevelPolicyDefinitionScopeNextLink.json
      summary: >-
        Microsoft Azure Post Subscriptions Subscriptionid Providers Authorizationnamespace Policydefinitions Policydefinitionname Providers Microsoft Policyinsights Policystates Policystatesresource Queryresults
      tags:
        - Subscriptions
  ? /subscriptions/{subscriptionId}/providers/{authorizationNamespace}/policyDefinitions/{policyDefinitionName}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesSummaryResource}/summarize
  : post:
      operationId: microsoftAzurePolicystatesSummarizeforpolicydefinition
      description: Summarizes policy states for the subscription level policy definition.
      parameters:
        - $ref: '#/parameters/policyStatesSummaryResourceParameter'
        - $ref: '#/parameters/subscriptionId'
        - $ref: '#/parameters/authorizationNamespaceParameter'
        - $ref: '#/parameters/policyDefinitionNameParameter'
        - $ref: '#/parameters/apiVersionParameter'
        - $ref: '#/parameters/topParameter'
        - $ref: '#/parameters/fromParameter'
        - $ref: '#/parameters/toParameter'
        - $ref: '#/parameters/filterParameter'
      responses:
        '200':
          description: Summarize results.
          schema:
            $ref: '#/definitions/SummarizeResults'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/QueryFailure'
      x-ms-examples:
        Summarize at policy definition scope:
          $ref: >-
            ./examples/PolicyStates_SummarizeSubscriptionLevelPolicyDefinitionScope.json
      summary: >-
        Microsoft Azure Post Subscriptions Subscriptionid Providers Authorizationnamespace Policydefinitions Policydefinitionname Providers Microsoft Policyinsights Policystates Policystatessummaryresource Summarize
      tags:
        - Subscriptions
  ? /subscriptions/{subscriptionId}/providers/{authorizationNamespace}/policyAssignments/{policyAssignmentName}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesResource}/queryResults
  : post:
      operationId: >-
        microsoftAzurePolicystatesListqueryresultsforsubscriptionlevelpolicyassignment
      description: Queries policy states for the subscription level policy assignment.
      parameters:
        - $ref: '#/parameters/policyStatesResourceParameter'
        - $ref: '#/parameters/subscriptionId'
        - $ref: '#/parameters/authorizationNamespaceParameter'
        - $ref: '#/parameters/policyAssignmentNameParameter'
        - $ref: '#/parameters/apiVersionParameter'
        - $ref: '#/parameters/topParameter'
        - $ref: '#/parameters/orderByParameter'
        - $ref: '#/parameters/selectParameter'
        - $ref: '#/parameters/fromParameter'
        - $ref: '#/parameters/toParameter'
        - $ref: '#/parameters/filterParameter'
        - $ref: '#/parameters/applyParameter'
        - $ref: '#/parameters/skipTokenParameter'
      responses:
        '200':
          description: Query results.
          schema:
            $ref: '#/definitions/PolicyStatesQueryResults'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/QueryFailure'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
      x-ms-examples:
        Query latest at subscription level policy assignment scope:
          $ref: >-
            ./examples/PolicyStates_QuerySubscriptionLevelPolicyAssignmentScope.json
        Query latest at subscription level policy assignment scope with next Link:
          $ref: >-
            ./examples/PolicyStates_QuerySubscriptionLevelPolicyAssignmentScopeNextLink.json
      summary: >-
        Microsoft Azure Post Subscriptions Subscriptionid Providers Authorizationnamespace Policyassignments Policyassignmentname Providers Microsoft Policyinsights Policystates Policystatesresource Queryresults
      tags:
        - Subscriptions
  ? /subscriptions/{subscriptionId}/providers/{authorizationNamespace}/policyAssignments/{policyAssignmentName}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesSummaryResource}/summarize
  : post:
      operationId: microsoftAzurePolicystatesSummarizeforsubscriptionlevelpolicyassignment
      description: Summarizes policy states for the subscription level policy assignment.
      parameters:
        - $ref: '#/parameters/policyStatesSummaryResourceParameter'
        - $ref: '#/parameters/subscriptionId'
        - $ref: '#/parameters/authorizationNamespaceParameter'
        - $ref: '#/parameters/policyAssignmentNameParameter'
        - $ref: '#/parameters/apiVersionParameter'
        - $ref: '#/parameters/topParameter'
        - $ref: '#/parameters/fromParameter'
        - $ref: '#/parameters/toParameter'
        - $ref: '#/parameters/filterParameter'
      responses:
        '200':
          description: Summarize results.
          schema:
            $ref: '#/definitions/SummarizeResults'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/QueryFailure'
      x-ms-examples:
        Summarize at policy assignment scope:
          $ref: >-
            ./examples/PolicyStates_SummarizeSubscriptionLevelPolicyAssignmentScope.json
      summary: >-
        Microsoft Azure Post Subscriptions Subscriptionid Providers Authorizationnamespace Policyassignments Policyassignmentname Providers Microsoft Policyinsights Policystates Policystatessummaryresource Summarize
      tags:
        - Subscriptions
  ? /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{authorizationNamespace}/policyAssignments/{policyAssignmentName}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesResource}/queryResults
  : post:
      operationId: >-
        microsoftAzurePolicystatesListqueryresultsforresourcegrouplevelpolicyassignment
      description: Queries policy states for the resource group level policy assignment.
      parameters:
        - $ref: '#/parameters/policyStatesResourceParameter'
        - $ref: '#/parameters/subscriptionId'
        - $ref: '#/parameters/resourceGroupNameParameter'
        - $ref: '#/parameters/authorizationNamespaceParameter'
        - $ref: '#/parameters/policyAssignmentNameParameter'
        - $ref: '#/parameters/apiVersionParameter'
        - $ref: '#/parameters/topParameter'
        - $ref: '#/parameters/orderByParameter'
        - $ref: '#/parameters/selectParameter'
        - $ref: '#/parameters/fromParameter'
        - $ref: '#/parameters/toParameter'
        - $ref: '#/parameters/filterParameter'
        - $ref: '#/parameters/applyParameter'
        - $ref: '#/parameters/skipTokenParameter'
      responses:
        '200':
          description: Query results.
          schema:
            $ref: '#/definitions/PolicyStatesQueryResults'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/QueryFailure'
      x-ms-pageable:
        nextLinkName: '@odata.nextLink'
      x-ms-examples:
        Query latest at resource group level policy assignment scope:
          $ref: >-
            ./examples/PolicyStates_QueryResourceGroupLevelPolicyAssignmentScope.json
        Query latest at resource group level policy assignment scope with next link:
          $ref: >-
            ./examples/PolicyStates_QueryResourceGroupLevelPolicyAssignmentScopeNextLink.json
      summary: >-
        Microsoft Azure Post Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Authorizationnamespace Policyassignments Policyassignmentname Providers Microsoft Policyinsights Policystates Policystatesresource Queryresults
      tags:
        - Subscriptions
  ? /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{authorizationNamespace}/policyAssignments/{policyAssignmentName}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesSummaryResource}/summarize
  : post:
      operationId: microsoftAzurePolicystatesSummarizeforresourcegrouplevelpolicyassignment
      description: Summarizes policy states for the resource group level policy assignment.
      parameters:
        - $ref: '#/parameters/policyStatesSummaryResourceParameter'
        - $ref: '#/parameters/subscriptionId'
        - $ref: '#/parameters/resourceGroupNameParameter'
        - $ref: '#/parameters/authorizationNamespaceParameter'
        - $ref: '#/parameters/policyAssignmentNameParameter'
        - $ref: '#/parameters/apiVersionParameter'
        - $ref: '#/parameters/topParameter'
        - $ref: '#/parameters/fromParameter'
        - $ref: '#/parameters/toParameter'
        - $ref: '#/parameters/filterParameter'
      responses:
        '200':
          description: Summarize results.
          schema:
            $ref: '#/definitions/SummarizeResults'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/QueryFailure'
      x-ms-examples:
        Summarize at policy assignment scope:
          $ref: >-
            ./examples/PolicyStates_SummarizeResourceGroupLevelPolicyAssignmentScope.json
      summary: >-
        Microsoft Azure Post Subscriptions Subscriptionid Resourcegroups Resourcegroupname Providers Authorizationnamespace Policyassignments Policyassignmentname Providers Microsoft Policyinsights Policystates Policystatessummaryresource Summarize
      tags:
        - Subscriptions
  /providers/Microsoft.PolicyInsights/operations:
    get:
      operationId: microsoftAzureOperationsList
      description: Lists available operations.
      parameters:
        - $ref: '#/parameters/apiVersionParameter'
      responses:
        '200':
          description: List of available operations.
          schema:
            $ref: '#/definitions/OperationsListResults'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/QueryFailure'
      x-ms-examples:
        List operations:
          $ref: ./examples/PolicyStates_ListOperations.json
      summary: Microsoft Azure Get Providers Microsoft Policyinsights Operations
      tags:
        - Providers
  /{scope}/providers/Microsoft.PolicyInsights/policyStates/$metadata:
    get:
      operationId: microsoftAzurePolicystatesGetmetadata
      description: Gets OData metadata XML document.
      produces:
        - application/xml
      parameters:
        - $ref: '#/parameters/scopeParameter'
        - $ref: '#/parameters/apiVersionParameter'
      responses:
        '200':
          description: OData metadata XML document.
          schema:
            $ref: '#/definitions/MetadataDocument'
        default:
          description: Error response describing why the operation failed.
          schema:
            $ref: '#/definitions/QueryFailure'
      x-ms-examples:
        Get metadata:
          $ref: ./examples/PolicyStates_GetMetadata.json
      summary: Microsoft Azure Get Scope Providers Microsoft Policyinsights Policystates $metadata
      tags:
        - Providers
definitions:
  PolicyStatesQueryResults:
    description: Query results.
    properties:
      '@odata.context':
        description: >-
          OData context string; used by OData clients to resolve type
          information based on metadata.
        type: string
      '@odata.count':
        description: >-
          OData entity count; represents the number of policy state records
          returned.
        type: integer
        format: int32
        minimum: 0
      '@odata.nextLink':
        description: Odata next link; URL to get the next set of results.
        type: string
      value:
        description: Query results.
        type: array
        items:
          $ref: '#/definitions/PolicyState'
  PolicyState:
    type: object
    description: Policy state record.
    properties:
      '@odata.id':
        description: >-
          OData entity ID; always set to null since policy state records do not
          have an entity ID.
        type: string
      '@odata.context':
        description: >-
          OData context string; used by OData clients to resolve type
          information based on metadata.
        type: string
      timestamp:
        description: Timestamp for the policy state record.
        type: string
        format: date-time
      resourceId:
        description: Resource ID.
        type: string
      policyAssignmentId:
        description: Policy assignment ID.
        type: string
      policyDefinitionId:
        description: Policy definition ID.
        type: string
      effectiveParameters:
        description: Effective parameters for the policy assignment.
        type: string
      isCompliant:
        description: >-
          Flag which states whether the resource is compliant against the policy
          assignment it was evaluated against.
        type: boolean
      subscriptionId:
        description: Subscription ID.
        type: string
      resourceType:
       

# --- truncated at 32 KB (47 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-azure/refs/heads/main/openapi/policystatesclient-openapi-original.yml