Policy Enrollments - List For Resource

Szolgáltatás:: Policy

API-verzió:: 2026-01-01-preview

Lekéri az összes erőforrásra vonatkozó szabályzati regisztrációt.
Ez a művelet visszanyeri az adott erőforráscsoportban és előfizetésben található összes politikai regisztráció listáját, amelyek megfelelnek az adott opcionális $filter. Érvényes értékek $filter a következők: 'atScope()' vagy 'atExactScope()'. Ha $filter nincs megadva, a szűretlen lista tartalmazza az erőforráshoz kapcsolódó összes szabályzati regisztrációt, beleértve azokat is, amelyek közvetlenül vagy minden hatókörből érvényesek, valamint az erőforrásban lévő erőforrásokra alkalmazott adatokat. Egy adott erőforrás azonosításához három paraméter és az erőforrás neve használható. Ha az erőforrás nem szülőerőforrás része (annál gyakoribb), a szülőerőforrás elérési útját nem szabad megadni (vagy "" néven kell megadni). Egy webalkalmazás például megadható a következőként: ({resourceProviderNamespace} == "Microsoft.Web", {parentResourcePath} == '', {resourceType} == 'sites', {resourceName} == 'MyWebApp'). Ha az erőforrás egy szülőerőforrás része, akkor minden paramétert meg kell adni. Megadható például egy virtuális gép DNS-neve a következőként: ({resourceProviderNamespace} == 'Microsoft.Compute', {parentResourcePath} == 'virtualMachines/MyVirtualMachine', {resourceType} == 'domainNames', {resourceName} == 'MyComputerName'). A névtér és a típusnév külön-külön történő megadásának kényelmes alternatíva a {resourceType} paraméter formátumának megadása: ({resourceProviderNamespace} == '', {parentResourcePath} == '', {resourceType} == '', {resourceType} == 'Microsoft.Web/sites', {resourceName} == 'MyWebApp').

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{parentResourcePath}/{resourceType}/{resourceName}/providers/Microsoft.Authorization/policyEnrollments?api-version=2026-01-01-preview

Opcionális paraméterekkel:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{parentResourcePath}/{resourceType}/{resourceName}/providers/Microsoft.Authorization/policyEnrollments?api-version=2026-01-01-preview&$filter={$filter}

URI-paraméterek

Name	In	Kötelező	Típus	Description
parentResourcePath	path	True	string	A szülőerőforrás elérési útja. Üres sztring használata, ha nincs.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
resourceName	path	True	string pattern: ^.+$	Az erőforrás neve.
resourceProviderNamespace	path	True	string	Az erőforrás-szolgáltató névtere. Egy virtuális gép névtere például a Microsoft.Compute (a Microsoft.Compute/virtualMachines szolgáltatásból).
resourceType	path	True	string	Az erőforrástípus neve. Egy webalkalmazás típusneve például "webhelyek" (a Microsoft.Web/sites webhelyről).
subscriptionId	path	True	string (uuid)	A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.
$filter	query		string	A műveletre alkalmazandó szűrő. Érvényes értékek $filter a következők: 'atScope()' vagy 'atExactScope()'. Ha $filter nincs megadva, a rendszer nem végez szűrést. Ha $filter nincs megadva, a szűretlen lista tartalmazza az összes szabályozási regisztrációt, amely a hatókörhöz kapcsolódik, beleértve azokat is, amelyek közvetlenül vagy a hatókkört tartalmazóakból. Ha $filter=atScope() van megadva, a visszaküldött lista tartalmazza az összes olyan politikai regisztrációt, amely a scope-ra vonatkozik, ami az összes szűretlen listában szereplő, kivéve azokat, amelyek az adott hatótávon belül lévő al-scope-okra vonatkoznak. Ha $filter=atExactScope() van megadva, a visszaküldött lista csak az adott hatáskörben érvényes politikai regisztrációt tartalmazza.

Válaszok

Name	Típus	Description
200 OK	PolicyEnrollmentListResult	Az Azure-művelet sikeresen befejeződött.
Other Status Codes	ErrorResponse	Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory Oauth2-folyamat.

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

List policy enrollments for resource

Mintakérelem

HTTP

GET https://management.azure.com/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/resourceGroups/TestResourceGroup/providers/Microsoft.Compute/virtualMachines/MyTestVm/domainNames/MyTestComputer.cloudapp.net/providers/Microsoft.Authorization/policyEnrollments?api-version=2026-01-01-preview

Mintaválasz

Állapotkód:: 200

{
  "value": [
    {
      "properties": {
        "policyAssignmentId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyAssignments/CostManagement",
        "policyDefinitionReferenceIds": [
          "Limit_Skus"
        ],
        "policyAssignmentInstanceId": "00000000-0000-0000-0000-000000000000",
        "displayName": "Enroll demo cluster",
        "description": "Enroll demo cluster from limit sku",
        "metadata": {
          "reason": "Enrollment for a expensive VM demo"
        }
      },
      "systemData": {
        "createdBy": "string",
        "createdByType": "User",
        "createdAt": "2020-07-01T01:01:01.1075056Z",
        "lastModifiedBy": "string",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2020-07-01T02:01:01.1075056Z"
      },
      "id": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/resourceGroups/TestResourceGroup/providers/Microsoft.Authorization/policyEnrollments/DemoExpensiveVMGroup",
      "type": "Microsoft.Authorization/policyEnrollments",
      "eTag": "00000000-0000-0000-0000-000000000000",
      "name": "DemoExpensiveVMGroup"
    },
    {
      "properties": {
        "policyAssignmentId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyAssignments/LimitPorts",
        "policyAssignmentInstanceId": "00000000-0000-0000-0000-000000000000",
        "displayName": "Enroll jump box open ports",
        "description": "Enroll jump box open ports from limit ports policy",
        "metadata": {
          "reason": "Need to open RDP port to corp net"
        }
      },
      "systemData": {
        "createdBy": "string",
        "createdByType": "User",
        "createdAt": "2020-07-01T01:01:01.1075056Z",
        "lastModifiedBy": "string",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2020-07-01T02:01:01.1075056Z"
      },
      "id": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/resourceGroups/TestResourceGroup/providers/Microsoft.Compute/virtualMachines/MyTestVm/providers/Microsoft.Authorization/policyEnrollments/jumpBoxEnrollment",
      "type": "Microsoft.Authorization/policyEnrollments",
      "eTag": "00000000-0000-0000-0000-000000000000",
      "name": "jumpBoxEnrollment"
    }
  ]
}

Definíciók

Name	Description
AssignmentScopeValidation	Lehetőség annak igazolására, hogy az mentesség vagy beiratkozás a kijelölési területen belül vagy alatt van-e.
createdByType	Az erőforrást létrehozó identitás típusa.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
PolicyEnrollment	A kötvény regisztrációja.
PolicyEnrollmentListResult	A PolicyEnrollment lista művelet válasza.
ResourceSelector	Az erőforrás-választó, amely erőforrás-tulajdonságok alapján szűri a szabályzatokat.
Selector	A választókifejezés.
SelectorKind	A választó típusa.
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

AssignmentScopeValidation

Felsorolás

Lehetőség annak igazolására, hogy az mentesség vagy beiratkozás a kijelölési területen belül vagy alatt van-e.

Érték	Description
Default	Ez a beállítás ellenőrzi, hogy a kivétel a hozzárendelés hatókörében van-e.
DoNotValidate	Ez a beállítás megkerüli azt az ellenőrzést, amelynél a kivétel hatóköre a szabályzat-hozzárendelés hatókörében van vagy alatta van.

createdByType

Felsorolás

Az erőforrást létrehozó identitás típusa.

Érték	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Tárgy

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

Tárgy

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hiba célpontja.

ErrorResponse

Tárgy

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.