Policy Enrollments - List For Resource

Layanan:: Policy

Versi API:: 2026-01-01-preview

Mengambil semua pendaftaran kebijakan yang berlaku untuk sumber daya.
Operasi ini mengambil daftar semua pendaftaran kebijakan yang terkait dengan sumber daya yang ditentukan dalam grup sumber daya dan langganan yang diberikan yang cocok dengan $filter opsional yang diberikan. Nilai yang valid untuk $filter adalah: 'atScope()' atau 'atExactScope()'. Jika $filter tidak disediakan, daftar yang tidak difilter mencakup semua pendaftaran kebijakan yang terkait dengan sumber daya, termasuk yang berlaku secara langsung atau dari semua cakupan yang berisi, serta apa pun yang diterapkan ke sumber daya yang terkandung dalam sumber daya. Tiga parameter ditambah nama sumber daya digunakan untuk mengidentifikasi sumber daya tertentu. Jika sumber daya bukan bagian dari sumber daya induk (kasus yang lebih umum), jalur sumber daya induk tidak boleh disediakan (atau disediakan sebagai ''). Misalnya aplikasi web dapat ditentukan sebagai ({resourceProviderNamespace} == 'Microsoft.Web', {parentResourcePath} == '', {resourceType} == 'sites', {resourceName} == 'MyWebApp'). Jika sumber daya adalah bagian dari sumber daya induk, maka semua parameter harus disediakan. Misalnya nama DNS komputer virtual dapat ditentukan sebagai ({resourceProviderNamespace} == 'Microsoft.Compute', {parentResourcePath} == 'virtualMachines/MyVirtualMachine', {resourceType} == 'domainNames', {resourceName} == 'MyComputerName'). Alternatif yang nyaman untuk menyediakan namespace dan nama jenis secara terpisah adalah menyediakan keduanya dalam parameter {resourceType}, format: ({resourceProviderNamespace} == '', {parentResourcePath} == '', {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

Dengan parameter opsional:

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}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
parentResourcePath	path	True	string	Jalur sumber daya induk. Gunakan string kosong jika tidak ada.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.
resourceName	path	True	string pattern: ^.+$	Nama sumber daya.
resourceProviderNamespace	path	True	string	Namespace penyedia sumber daya. Misalnya, namespace komputer virtual adalah Microsoft.Compute (dari Microsoft.Compute/virtualMachines)
resourceType	path	True	string	Nama jenis sumber daya. Misalnya nama jenis aplikasi web adalah 'situs' (dari Microsoft.Web/sites).
subscriptionId	path	True	string (uuid)	ID langganan target. Nilainya harus sebuah UUID.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.
$filter	query		string	Filter yang akan diterapkan pada operasi. Nilai yang valid untuk $filter adalah: 'atScope()' atau 'atExactScope()'. Jika $filter tidak disediakan, tidak ada pemfilteran yang dilakukan. Jika $filter tidak disediakan, daftar yang tidak difilter mencakup semua pendaftaran kebijakan yang terkait dengan cakupan, termasuk yang berlaku secara langsung atau dari cakupan yang berisi. Jika $filter=atScope() disediakan, daftar yang ditampilkan mencakup semua pendaftaran kebijakan yang berlaku untuk cakupan, yang merupakan semua yang ada dalam daftar yang tidak difilter kecuali yang diterapkan ke sub-cakupan yang terkandung dalam cakupan yang diberikan. Jika $filter=atExactScope() disediakan, daftar yang ditampilkan hanya mencakup semua pendaftaran kebijakan yang berlaku pada cakupan yang diberikan.

Respons

Nama	Jenis	Deskripsi
200 OK	PolicyEnrollmentListResult	Operasi Azure berhasil diselesaikan.
Other Status Codes	ErrorResponse	Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

List policy enrollments for resource

Permintaan sampel

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

Respon sampel

Kode status:: 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"
    }
  ]
}

Definisi

Nama	Deskripsi
AssignmentScopeValidation	Opsi untuk memvalidasi apakah pengecualian atau pendaftaran berada pada atau di bawah cakupan penugasan.
createdByType	Jenis identitas yang membuat sumber daya.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Tanggapan kesalahan
PolicyEnrollment	Pendaftaran kebijakan.
PolicyEnrollmentListResult	Respons operasi daftar PolicyEnrolling.
ResourceSelector	Pemilih sumber daya untuk memfilter kebijakan menurut properti sumber daya.
Selector	Ekspresi pemilih.
SelectorKind	Jenis pemilih.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

AssignmentScopeValidation

Enumerasi

Opsi untuk memvalidasi apakah pengecualian atau pendaftaran berada pada atau di bawah cakupan penugasan.

Nilai	Deskripsi
Default	Opsi ini akan memvalidasi pengecualian berada di atau di bawah cakupan penugasan.
DoNotValidate	Opsi ini akan melewati validasi cakupan pengecualian berada di atau di bawah cakupan penetapan kebijakan.

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Rincian kesalahan.
message	string	Pesan kesalahan.
target	string	Sasaran kesalahan.

ErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.