Policy Events - List

Szolgáltatás:

Purview

API-verzió:

2023-01-01

Szabályzatesemények lekérése adott hatókörhöz.

GET {endpoint}/pds/policy-events?scope={scope}&syncToken={syncToken}&api-version=2023-01-01

URI-paraméterek

Name	In	Kötelező	Típus	Description
endpoint	path	True	string (url)	A Purview-fiók végpontja. Példa: https://{accountName}.purview.azure.com.
api-version	query	True	string	A szolgáltatás API-verziója.
scope	query	True	string	A Purview által felügyelt erőforrások azonosítója.
syncToken	query	True	string	Ez a szinkronizálási jogkivonat a szabályzatok legújabb ellenőrzőpontját jelöli. Az ügyfélnek át kell adnia ezt az értéket a későbbi változásváltozások beolvasása közben.

Válaszok

Name	Típus	Description
200 OK	PolicyEventsResponseUpdated	Siker
Other Status Codes		Nincs módosítva
Other Status Codes	ErrorResponseModel	Hiba

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

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

Példák

PolicyEvents_List

Mintakérelem

HTTP

GET {endpoint}/pds/policy-events?scope=/subscriptions/30d9d527-c409-4507-b861-d60e7fe9e292/resourcegroups/pansharm-rg/providers/microsoft.sql/servers/pansharm-sql&syncToken=25251:0&api-version=2023-01-01

Mintaválasz

Állapotkód:

200

x-ms-correlation-request-id: f35b289b-7deb-467b-9976-a163926f981f

{
  "syncToken": "25258:0",
  "value": [
    {
      "eventType": "Microsoft.Purview/PolicyElements/Write",
      "id": "e870dcfa-d89d-4fc1-90a9-ef758d299e15",
      "scopes": [
        "/subscriptions/30d9d527-c409-4507-b861-d60e7fe9e292/resourcegroups/pansharm-rg"
      ],
      "kind": "PolicySet",
      "updatedAt": "2022-03-07T05:21:52.2823168Z",
      "version": 1,
      "elementJson": "{\"id\":\"e870dcfa-d89d-4fc1-90a9-ef758d299e15\",\"name\":\"e870dcfa-d89d-4fc1-90a9-ef758d299e15\",\"kind\":\"policyset\",\"version\":1,\"updatedAt\":\"2022-03-07T05:21:52.2823168Z\",\"preconditionRules\":[{\"dnfCondition\":[[{\"attributeName\":\"resource.azure.path\",\"attributeValueIncludedIn\":[\"/subscriptions/30d9d527-c409-4507-b861-d60e7fe9e292/resourcegroups/pansharm-rg/**\"]}]]}],\"policyRefs\":[\"5f448cc9-33cc-47de-910c-c2de1212cb2f\"]}"
    },
    {
      "eventType": "Microsoft.Purview/PolicyElements/Write",
      "id": "5f448cc9-33cc-47de-910c-c2de1212cb2f",
      "scopes": [
        "/subscriptions/30d9d527-c409-4507-b861-d60e7fe9e292/resourcegroups/pansharm-rg"
      ],
      "kind": "Policy",
      "updatedAt": "2022-06-02T17:05:43.0981228Z",
      "version": 9,
      "elementJson": "{\"id\":\"5f448cc9-33cc-47de-910c-c2de1212cb2f\",\"name\":\"test004\",\"kind\":\"policy\",\"version\":9,\"updatedAt\":\"2022-06-02T17:05:43.0981228Z\",\"decisionRules\":[{\"kind\":\"decisionrule\",\"effect\":\"Permit\",\"id\":\"3ef47a19-55ab-4c3e-bfe4-b274489555da\",\"updatedAt\":\"06/02/2022 17:05:43\",\"cnfCondition\":[[{\"attributeName\":\"resource.azure.path\",\"attributeValueIncludedIn\":[\"/subscriptions/30d9d527-c409-4507-b861-d60e7fe9e292/resourcegroups/pansharm-rg/providers/Microsoft.AzureArcData/SqlServerInstances/pansharm-sql/**\"]}],[{\"attributeName\":\"principal.microsoft.id\",\"attributeValueIncludedIn\":[\"ca4709b3-1fdd-4032-9844-3039025e8ee0\"]}],[{\"fromRule\":\"purviewdatarole_builtin_sqlperfmonitor\",\"attributeName\":\"derived.purview.role\",\"attributeValueIncludes\":\"purviewdatarole_builtin_sqlperfmonitor\"}]]}]}"
    }
  ]
}

Állapotkód:

304

x-ms-correlation-request-id: f35b289b-7deb-467b-9976-a163926f981f

Állapotkód:

default

x-ms-correlation-request-id: f35b289b-7deb-467b-9976-a163926f981f

{
  "error": {
    "code": "1001",
    "message": "Simple error message.",
    "target": "Detailed message or error trace.",
    "details": []
  }
}

Definíciók

Name	Description
ErrorModel	Alapértelmezett hibamodell.
ErrorResponseModel	Alapértelmezett hibaválasz-modell.
PolicyElementEventModelUpdated	A szabályzatelem eseménymodellje.
PolicyElementKind	A szabályzatelem típusát jelöli.
PolicyEventsResponseUpdated	A policy delta fetch API válaszmodellje.

ErrorModel

Objektum

Alapértelmezett hibamodell.

Name	Típus	Description
code	string minLength: 1	Hibakód.
details	ErrorModel[]	Hiba részletei.
message	string minLength: 1	Hibaüzenet.
target	string	Hiba leírása.

ErrorResponseModel

Objektum

Alapértelmezett hibaválasz-modell.

Name	Típus	Description
error	ErrorModel	Alapértelmezett hibamodell.

PolicyElementEventModelUpdated

Objektum

A szabályzatelem eseménymodellje.

Name	Típus	Description
elementJson	string	A szabályzatelem szerializált json hasznos adatai.
eventType	string minLength: 1	Az esemény típusa. Formátum://. Például: Microsoft.Purview/PolicyElements/Delete.
id	string minLength: 1	A szabályzatelem azonosítója.
kind	PolicyElementKind	A szabályzatelem típusát jelöli.
scopes	string[]	A szabályzatban szereplő hatókörök listája.
updatedAt	string (date-time)	A szabályzatelem utolsó frissítésének időpontja.
version	integer (int64)	A szabályzatelem aktuális verziója. Ez automatikusan növekszik minden módosítással. 1-zel kezdődik.

PolicyElementKind

Enumerálás

A szabályzatelem típusát jelöli.

Érték	Description
AttributeRule
Policy
PolicySet

PolicyEventsResponseUpdated

Objektum

A policy delta fetch API válaszmodellje.

Name	Típus	Description
syncToken	string minLength: 1	Ez a szinkronizálási jogkivonat a szabályzatok legújabb ellenőrzőpontját jelöli. Az ügyfélnek át kell adnia ezt az értéket a későbbi változásváltozások beolvasása közben.
value	PolicyElementEventModelUpdated[]	Szabályzatelemek listája.