Policy Enrollments - List For Resource
Bir kaynağa uygulanan tüm politika kayıtlarını alır.
Bu işlem, verilen kaynak grubundaki ve abonelikte belirtilen kaynakla ilişkili tüm politika kayıtlarının listesini alır ve bu kayıtlar isteğe bağlı $filter ile eşleşir. $filter için geçerli değerler şunlardır: 'atScope()' veya 'atExactScope()'. Eğer $filter sağlanmazsa, filtrelenmemiş liste kaynakla ilişkili tüm politika kayıtlarını içerir; doğrudan veya tüm kapsamlardan geçerli olanlar ile kaynak içindeki kaynaklara uygulananlar dahil. Belirli bir kaynağı tanımlamak için üç parametre ve kaynak adı kullanılır. Kaynak bir üst kaynağın parçası değilse (daha yaygın bir durum), üst kaynak yolu sağlanmamalıdır (veya '' olarak sağlanmamalıdır). Örneğin bir web uygulaması ({resourceProviderNamespace} == 'Microsoft.Web', {parentResourcePath} == '', {resourceType} == 'sites', {resourceName} == 'MyWebApp') olarak belirtilebilir. Kaynak bir üst kaynağın parçasıysa, tüm parametreler sağlanmalıdır. Örneğin bir sanal makine DNS adı ({resourceProviderNamespace} == 'Microsoft.Compute', {parentResourcePath} == 'virtualMachines/MyVirtualMachine', {resourceType} == 'domainNames', {resourceName} == 'MyComputerName') olarak belirtilebilir. Ad alanı ve tür adını ayrı ayrı sağlamanın kullanışlı bir alternatifi, hem {resourceType} parametresinde, biçim: ({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
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 Parametreleri
| Name | İçinde | Gerekli | Tür | Description |
|---|---|---|---|---|
|
parent
|
path | True |
string |
Üst kaynak yolu. Yoksa boş dize kullanın. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Kaynak grubunun adı. İsim büyük/küçük harfe duyarsızdır. |
|
resource
|
path | True |
string pattern: ^.+$ |
Kaynağın adı. |
|
resource
|
path | True |
string |
Kaynak sağlayıcısının ad alanı. Örneğin, bir sanal makinenin ad alanı Microsoft.Compute 'dir (Microsoft.Compute/virtualMachines'ten) |
|
resource
|
path | True |
string |
Kaynak türü adı. Örneğin, bir web uygulamasının tür adı "siteler"dir (Microsoft.Web/sites'tan). |
|
subscription
|
path | True |
string (uuid) |
Hedef aboneliğin kimliği. Değer bir UUID olmalıdır. |
|
api-version
|
query | True |
string minLength: 1 |
Bu işlem için kullanılacak API sürümü. |
|
$filter
|
query |
string |
İşlemde uygulanacak filtre. $filter için geçerli değerler şunlardır: 'atScope()' veya 'atExactScope()'. $filter sağlanmazsa, filtreleme yapılmaz. Eğer $filter sağlanmazsa, filtrelenmemiş liste kapsamla ilişkili tüm politika kayıtlarını içerir; doğrudan veya kapsam içeren olanlar da dahil. Eğer $filter=atScope() sağlanırsa, geri dönen liste kapsama uygulanan tüm politika kayıtlarını içerir; kapsam kapsamı da filtrelenmemiş listedeki her şeyi içerir, ancak verilen kapsam içindeki alt kapsamlara uygulananlar hariç. Eğer $filter=atExactScope() sağlanırsa, iade edilen liste yalnızca verilen kapsamda geçerli olan tüm politika kayıtlarını içerir. |
Yanıtlar
| Name | Tür | Description |
|---|---|---|
| 200 OK |
Azure işlemi başarıyla tamamlandı. |
|
| Other Status Codes |
Beklenmeyen bir hata yanıtı. |
Güvenlik
azure_auth
Azure Active Directory OAuth2 Flow.
Tür:
oauth2
Akış:
implicit
Yetkilendirme URL’si:
https://login.microsoftonline.com/common/oauth2/authorize
Kapsamlar
| Name | Description |
|---|---|
| user_impersonation | kullanıcı hesabınızın kimliğine bürünme |
Örnekler
List policy enrollments for resource
Örnek isteği
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
Örnek yanıt
{
"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"
}
]
}
Tanımlar
| Name | Description |
|---|---|
|
Assignment |
Muafiyet veya kayıt kapsamında mı yoksa altında mı yoksa muafiyet kapsamında mı olduğunu doğrulama seçeneği. |
|
created |
Kaynağı oluşturan kimliğin türü. |
|
Error |
Kaynak yönetimi hatası ek bilgileri. |
|
Error |
Hata ayrıntısı. |
|
Error |
Hata yanıtı |
|
Policy |
Poliçe kayıt. |
|
Policy |
Bir PolitikaKayıt listesi operasyonunun yanıtı. |
|
Resource |
İlkeleri kaynak özelliklerine göre filtrelemek için kaynak seçici. |
| Selector |
Seçici ifadesi. |
|
Selector |
Seçici türü. |
|
system |
Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler. |
AssignmentScopeValidation
Muafiyet veya kayıt kapsamında mı yoksa altında mı yoksa muafiyet kapsamında mı olduğunu doğrulama seçeneği.
| Değer | Description |
|---|---|
| Default |
Bu seçenek, muafiyetin atama kapsamında veya altında olduğunu doğrular. |
| DoNotValidate |
Bu seçenek, muafiyet kapsamının ilke atama kapsamında veya kapsamındaki doğrulamayı atlar. |
createdByType
Kaynağı oluşturan kimliğin türü.
| Değer | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Kaynak yönetimi hatası ek bilgileri.
| Name | Tür | Description |
|---|---|---|
| info |
object |
Ek bilgiler. |
| type |
string |
Ek bilgi türü. |
ErrorDetail
Hata ayrıntısı.
| Name | Tür | Description |
|---|---|---|
| additionalInfo |
Hata ek bilgileri. |
|
| code |
string |
Hata kodu. |
| details |
Hata ayrıntıları. |
|
| message |
string |
Hata iletisi. |
| target |
string |
Hata hedefi |
ErrorResponse
Hata yanıtı
| Name | Tür | Description |
|---|---|---|
| error |
Hata nesnesi. |
PolicyEnrollment
Poliçe kayıt.
| Name | Tür | Description |
|---|---|---|
| eTag |
string |
Poliçe kaydı için ETag. |
| id |
string (arm-id) |
Kaynağın tam kaynak kimliği. Örneğin "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Kaynağın adı |
| properties.assignmentScopeValidation |
Kaydın onaylanması seçeneği atama kapsamında veya altında olabilir. |
|
| properties.description |
string |
Poliçe kayıt açıklaması. |
| properties.displayName |
string |
Poliçe kaydının gösterim adı. |
| properties.metadata |
Politika kayıt meta verileri. Meta veriler açık uçlu bir nesnedir ve genellikle anahtar değer çiftleri koleksiyonudur. |
|
| properties.policyAssignmentId |
string (arm-id) |
Kayıtlı olan poliçe atamasının kimliği. |
| properties.policyAssignmentInstanceId |
string (uuid) |
Bu kayıtla ilişkili politika atama örneği ID'si. Değer, kayıt oluşturulduğunda veya güncellendiğinde policyAssignmentId'nin referans verdiği politika atamasının örnek kimliğine ayarlanır. Format bir GUID dizisi. |
| properties.policyDefinitionReferenceIds |
string[] |
Politika tanımı, atanan bir politika kümesi tanımında politika tanımları için kimlik tanımlarına referans verir.
Bu ID'ler, politika kümesi tanımında bir alt |
| properties.resourceSelectors |
İlkeleri kaynak özelliklerine göre filtrelemek için kaynak seçici listesi. |
|
| systemData |
createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri. |
|
| type |
string |
Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts" |
PolicyEnrollmentListResult
Bir PolitikaKayıt listesi operasyonunun yanıtı.
| Name | Tür | Description |
|---|---|---|
| nextLink |
string (uri) |
Öğelerin bir sonraki sayfasına bağlantı |
| value |
Bu sayfadaki PolitikaKayıt maddeleri |
ResourceSelector
İlkeleri kaynak özelliklerine göre filtrelemek için kaynak seçici.
| Name | Tür | Description |
|---|---|---|
| name |
string |
Kaynak seçicinin adı. |
| selectors |
Selector[] |
Seçici ifadelerinin listesi. |
Selector
Seçici ifadesi.
| Name | Tür | Description |
|---|---|---|
| in |
string[] |
Filtre uygulamak için değerlerin listesi. |
| kind |
Seçici türü. |
|
| notIn |
string[] |
Filtreleneceği değerlerin listesi. |
SelectorKind
Seçici türü.
| Değer | Description |
|---|---|
| resourceLocation |
İlkeleri kaynak konumuna göre filtrelemek için seçici türü. |
| resourceType |
İlkeleri kaynak türüne göre filtrelemek için seçici türü. |
| resourceWithoutLocation |
İlkeleri konuma sahip olmayan kaynağa göre filtrelemek için seçici türü. |
| policyDefinitionReferenceId |
İlkeleri ilke tanımı başvuru kimliğine göre filtrelemek için seçici türü. |
| userPrincipalId |
Seçici türü, politikaları kullanıcı ana kimliğine göre filtreler. |
| groupPrincipalId |
Güvenlik grubu üyelik kimliğine göre politikaları filtreleyen seçici tür. |
systemData
Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
| Name | Tür | Description |
|---|---|---|
| createdAt |
string (date-time) |
Kaynak oluşturma (UTC) zaman damgası. |
| createdBy |
string |
Kaynağı oluşturan kimlik. |
| createdByType |
Kaynağı oluşturan kimliğin türü. |
|
| lastModifiedAt |
string (date-time) |
Kaynağın son değişikliğinin zaman damgası (UTC) |
| lastModifiedBy |
string |
Kaynağı en son değiştiren kimlik. |
| lastModifiedByType |
Kaynağı en son değiştiren kimlik türü. |