Megosztás a következőn keresztül:

Policy States - Summarize For Resource Group Level Policy Assignment

  • Referencia
Service:
Policy
API Version:
2019-10-01

Az erőforráscsoportszintű szabályzat-hozzárendelés szabályzatállapotait összegzi.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}/providers/Microsoft.PolicyInsights/policyStates/latest/summarize?api-version=2019-10-01
With optional parameters: 
POST https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}/providers/Microsoft.PolicyInsights/policyStates/latest/summarize?api-version=2019-10-01&$top={$top}&$from={$from}&$to={$to}&$filter={$filter}

URI-paraméterek

Name In Kötelező Típus Description
authorizationNamespace
 path True

AuthorizationNamespaceType

A Microsoft Engedélyezési erőforrás-szolgáltató névtere; Csak a "Microsoft.Authorization" engedélyezett.
policyAssignmentName
 path True

string

Szabályzat-hozzárendelés neve.
policyStatesSummaryResource
 path True

PolicyStatesSummaryResourceType

A PolicyStates erőforrástípus alatt található virtuális erőforrás összegzési művelethez. Egy adott időtartományban a "latest" a legújabb szabályzatállapot(oka)t jelöli, és ez az egyetlen engedélyezett érték.
resourceGroupName
 path True

string

Az erőforráscsoport neve.
subscriptionId
 path True

string

Microsoft Azure-előfizetés azonosítója.
api-version
 query True

string

Client API-verzió.
$filter
 query

string

OData szűrőkifejezés.
$from
 query

string

date-time

ISO 8601 formátumú időbélyeg, amely a lekérdezési időköz kezdő időpontját adja meg. Ha nincs megadva, a szolgáltatás ($to - 1 napos) értéket használ.
$to
 query

string

date-time

ISO 8601 formátumú időbélyeg, amely a lekérdezési időköz befejezési idejét adja meg. Ha nincs megadva, a szolgáltatás kérési időt használ.
$top
 query

integer

int32

A visszaadandó rekordok maximális száma.

Válaszok

Name Típus Description
200 OK

SummarizeResults

Eredmények összegzése.
Other Status Codes

QueryFailure

Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation felhasználói fiók megszemélyesítése

Példák

Summarize at policy assignment scope

Sample Request

POST https://management.azure.com/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourcegroups/myResourceGroup/providers/Microsoft.Authorization/policyAssignments/b7a1ca2596524e3ab19597f2/providers/Microsoft.PolicyInsights/policyStates/latest/summarize?api-version=2019-10-01

Sample Response

Status code:
200 
{
  "@odata.context": "https://management.azure.com/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourceGroups/myResourceGroup/providers/Microsoft.Authorization/policyAssignments/b7a1ca2596524e3ab19597f2/providers/Microsoft.PolicyInsights/policyStates/$metadata#summary",
  "@odata.count": 1,
  "value": [
    {
      "@odata.id": null,
      "@odata.context": "https://management.azure.com/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourceGroups/myResourceGroup/providers/Microsoft.Authorization/policyAssignments/b7a1ca2596524e3ab19597f2/providers/Microsoft.PolicyInsights/policyStates/$metadata#summary/$entity",
      "results": {
        "queryResultsUri": "https://management.azure.com/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourceGroups/myResourceGroup/providers/Microsoft.Authorization/policyAssignments/b7a1ca2596524e3ab19597f2/providers/Microsoft.PolicyInsights/policyStates/latest/queryResults?api-version=2019-10-01&$from=2019-10-22 23:54:22Z&$to=2019-10-23 23:54:22Z&$filter=IsCompliant eq false",
        "nonCompliantResources": 7,
        "nonCompliantPolicies": 1,
        "resourceDetails": [
          {
            "complianceState": "compliant",
            "count": 140
          },
          {
            "complianceState": "noncompliant",
            "count": 7
          }
        ],
        "policyDetails": [
          {
            "complianceState": "noncompliant",
            "count": 1
          }
        ],
        "policyGroupDetails": [
          {
            "complianceState": "noncompliant",
            "count": 1
          }
        ]
      },
      "policyAssignments": [
        {
          "policyAssignmentId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourcegroups/myResourceGroup/providers/microsoft.authorization/policyassignments/b7a1ca2596524e3ab19597f2",
          "policySetDefinitionId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/providers/microsoft.authorization/policysetdefinitions/a03db67e-a286-43c3-9098-b2da83d361ad",
          "results": {
            "queryResultsUri": "https://management.azure.com/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourceGroups/myResourceGroup/providers/Microsoft.Authorization/policyAssignments/b7a1ca2596524e3ab19597f2/providers/Microsoft.PolicyInsights/policyStates/latest/queryResults?api-version=2019-10-01&$from=2019-10-22 23:54:22Z&$to=2019-10-23 23:54:22Z&$filter=IsCompliant eq false and PolicyAssignmentId eq '/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourcegroups/myResourceGroup/providers/microsoft.authorization/policyassignments/b7a1ca2596524e3ab19597f2'",
            "nonCompliantResources": 7,
            "nonCompliantPolicies": 1,
            "resourceDetails": [
              {
                "complianceState": "compliant",
                "count": 140
              },
              {
                "complianceState": "noncompliant",
                "count": 7
              }
            ],
            "policyDetails": [
              {
                "complianceState": "noncompliant",
                "count": 1
              }
            ],
            "policyGroupDetails": [
              {
                "complianceState": "noncompliant",
                "count": 1
              }
            ]
          },
          "policyDefinitions": [
            {
              "policyDefinitionId": "/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/providers/microsoft.authorization/policydefinitions/4a0425e4-97bf-4ad0-ab36-145b94083c60",
              "policyDefinitionReferenceId": "2134906828137356512",
              "policyDefinitionGroupNames": [
                "group1"
              ],
              "effect": "audit",
              "results": {
                "queryResultsUri": "https://management.azure.com/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourceGroups/myResourceGroup/providers/Microsoft.Authorization/policyAssignments/b7a1ca2596524e3ab19597f2/providers/Microsoft.PolicyInsights/policyStates/latest/queryResults?api-version=2019-10-01&$from=2019-10-22 23:54:22Z&$to=2019-10-23 23:54:22Z&$filter=IsCompliant eq false and PolicyAssignmentId eq '/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourcegroups/myResourceGroup/providers/microsoft.authorization/policyassignments/b7a1ca2596524e3ab19597f2' and PolicyDefinitionId eq '/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/providers/microsoft.authorization/policydefinitions/4a0425e4-97bf-4ad0-ab36-145b94083c60'",
                "nonCompliantResources": 7,
                "resourceDetails": [
                  {
                    "complianceState": "compliant",
                    "count": 140
                  },
                  {
                    "complianceState": "noncompliant",
                    "count": 7
                  }
                ],
                "policyDetails": [
                  {
                    "complianceState": "noncompliant",
                    "count": 1
                  }
                ],
                "policyGroupDetails": [
                  {
                    "complianceState": "noncompliant",
                    "count": 1
                  }
                ]
              }
            }
          ],
          "policyGroups": [
            {
              "policyGroupName": "group1",
              "results": {
                "queryResultsUri": "https://management.azure.com/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/providers/Microsoft.PolicyInsights/policyStates/latest/queryResults?api-version=2019-10-01&$from=2019-10-12 19:48:53Z&$to=2019-10-13 19:48:53Z&$filter='group1' IN PolicyDefinitionGroupNames and PolicySetDefinitiontId eq '/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/providers/microsoft.authorization/policysetdefinitions/a03db67e-a286-43c3-9098-b2da83d361ad' and PolicyAssignmentId eq '/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/providers/microsoft.authorization/policyassignments/b7a1ca2596524e3ab19597f2' and 'group1' IN PolicyDefinitionGroupNames",
                "nonCompliantResources": 557,
                "resourceDetails": [
                  {
                    "complianceState": "compliant",
                    "count": 140
                  },
                  {
                    "complianceState": "noncompliant",
                    "count": 7
                  }
                ],
                "policyDetails": [
                  {
                    "complianceState": "noncompliant",
                    "count": 1
                  }
                ],
                "policyGroupDetails": [
                  {
                    "complianceState": "noncompliant",
                    "count": 1
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  ]
}

Definíciók

Name Description
AuthorizationNamespaceType

A Microsoft Engedélyezési erőforrás-szolgáltató névtere; Csak a "Microsoft.Authorization" engedélyezett.
ComplianceDetail

A megfelelőségi állapot összesítése.
Error

Hibadefiníció.
PolicyAssignmentSummary

Szabályzat-hozzárendelés összegzése.
PolicyDefinitionSummary

Szabályzatdefiníciók összegzése.
PolicyGroupSummary

Szabályzatdefiníciós csoport összegzése.
PolicyStatesSummaryResourceType

A PolicyStates erőforrástípus alatt található virtuális erőforrás összegzési művelethez. Egy adott időtartományban a "latest" a legújabb szabályzatállapot(oka)t jelöli, és ez az egyetlen engedélyezett érték.
QueryFailure

Hibaválasz.
SummarizeResults

Műveleteredmények összegzése.
Summary

Összesítő eredmények.
SummaryResults

Megfelelőségi összefoglalás egy adott összefoglaló szinten.

AuthorizationNamespaceType

A Microsoft Engedélyezési erőforrás-szolgáltató névtere; Csak a "Microsoft.Authorization" engedélyezett.

Name Típus Description
Microsoft.Authorization

string

ComplianceDetail

A megfelelőségi állapot összesítése.

Name Típus Description
complianceState

string

A megfelelőségi állapot.
count

integer

A megfelelőségi állapot összesített darabszáma.

Error

Hibadefiníció.

Name Típus Description
code

string

Szolgáltatásspecifikus hibakód, amely a HTTP-hibakód alállapotaként szolgál.
message

string

A hiba leírása.

PolicyAssignmentSummary

Szabályzat-hozzárendelés összegzése.

Name Típus Description
policyAssignmentId

string

Szabályzat-hozzárendelés azonosítója.
policyDefinitions

PolicyDefinitionSummary[]

Szabályzatdefiníciók összegzése.
policyGroups

PolicyGroupSummary[]

Szabályzatdefiníciós csoport összegzése.
policySetDefinitionId

string

Szabályzatkészlet definícióazonosítója, ha a szabályzat-hozzárendelés egy szabályzatkészlethez tartozik.
results

SummaryResults

A szabályzat-hozzárendelés megfelelőségi összefoglalása.

PolicyDefinitionSummary

Szabályzatdefiníciók összegzése.

Name Típus Description
effect

string

Szabályzathatás, azaz szabályzatdefiníciós művelet.
policyDefinitionGroupNames

string[]

Szabályzatdefiníciós csoportnevek.
policyDefinitionId

string

Szabályzatdefiníció azonosítója.
policyDefinitionReferenceId

string

Szabályzatdefiníció referencia-azonosítója.
results

SummaryResults

A szabályzatdefiníció megfelelőségi összefoglalása.

PolicyGroupSummary

Szabályzatdefiníciós csoport összegzése.

Name Típus Description
policyGroupName

string

Szabályzatcsoport neve.
results

SummaryResults

A szabályzatdefiníciós csoport megfelelőségi összefoglalása.

PolicyStatesSummaryResourceType

A PolicyStates erőforrástípus alatt található virtuális erőforrás összegzési művelethez. Egy adott időtartományban a "latest" a legújabb szabályzatállapot(oka)t jelöli, és ez az egyetlen engedélyezett érték.

Name Típus Description
latest

string

QueryFailure

Hibaválasz.

Name Típus Description
error

Error

Hibadefiníció.

SummarizeResults

Műveleteredmények összegzése.

Name Típus Description
@odata.context

string

OData környezeti sztring; az OData-ügyfelek használják a metaadatokon alapuló típusinformációk feloldására.
@odata.count

integer

OData-entitások száma; a visszaadott összegzések számát jelöli; mindig 1 értékre van állítva.
value

Summary[]

Műveleteredmények összegzése.

Summary

Összesítő eredmények.

Name Típus Description
@odata.context

string

OData környezeti sztring; az OData-ügyfelek használják a metaadatokon alapuló típusinformációk feloldására.
@odata.id

string

OData-entitás azonosítója; mindig null értékre van állítva, mivel az összegzések nem rendelkeznek entitásazonosítóval.
policyAssignments

PolicyAssignmentSummary[]

Szabályzat-hozzárendelések összegzése.
results

SummaryResults

Megfelelőségi összefoglalás az összes szabályzat-hozzárendeléshez.

SummaryResults

Megfelelőségi összefoglalás egy adott összefoglaló szinten.

Name Típus Description
nonCompliantPolicies

integer

Nem megfelelő szabályzatok száma.
nonCompliantResources

integer

Nem megfelelő erőforrások száma.
policyDetails

ComplianceDetail[]

A szabályzatösszetevő összegzése ezen a szinten. A lekérdezési hatókör szintje a szabályzat-hozzárendelés összegzését jelöli. A szabályzat-hozzárendelési szint a szabályzatdefiníciók összegzését jelöli.
policyGroupDetails

ComplianceDetail[]

A szabályzatdefiníciós csoport összefoglalása ezen a szinten.
queryResultsUri

string

HTTP POST URI a Microsoft.PolicyInsights queryResults műveletéhez a megfelelőségi összefoglalás nyers eredményeinek lekéréséhez. Ez a tulajdonság alapértelmezés szerint nem lesz elérhető a jövőbeli API-verziókban, de explicit módon lekérdezhető.
resourceDetails

ComplianceDetail[]

Az erőforrások összegzése ezen a szinten.