Aracılığıyla paylaş


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
parentResourcePath
path True

string

Üst kaynak yolu. Yoksa boş dize kullanın.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Kaynak grubunun adı. İsim büyük/küçük harfe duyarsızdır.

resourceName
path True

string

pattern: ^.+$

Kaynağın adı.

resourceProviderNamespace
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)

resourceType
path True

string

Kaynak türü adı. Örneğin, bir web uygulamasının tür adı "siteler"dir (Microsoft.Web/sites'tan).

subscriptionId
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

PolicyEnrollmentListResult

Azure işlemi başarıyla tamamlandı.

Other Status Codes

ErrorResponse

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
AssignmentScopeValidation

Muafiyet veya kayıt kapsamında mı yoksa altında mı yoksa muafiyet kapsamında mı olduğunu doğrulama seçeneği.

createdByType

Kaynağı oluşturan kimliğin türü.

ErrorAdditionalInfo

Kaynak yönetimi hatası ek bilgileri.

ErrorDetail

Hata ayrıntısı.

ErrorResponse

Hata yanıtı

PolicyEnrollment

Poliçe kayıt.

PolicyEnrollmentListResult

Bir PolitikaKayıt listesi operasyonunun yanıtı.

ResourceSelector

İlkeleri kaynak özelliklerine göre filtrelemek için kaynak seçici.

Selector

Seçici ifadesi.

SelectorKind

Seçici türü.

systemData

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

ErrorAdditionalInfo[]

Hata ek bilgileri.

code

string

Hata kodu.

details

ErrorDetail[]

Hata ayrıntıları.

message

string

Hata iletisi.

target

string

Hata hedefi

ErrorResponse

Hata yanıtı

Name Tür Description
error

ErrorDetail

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

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 policyDefinitions[*].policyDefinitionReferenceId küme karşılık gelir. Belirtildiğinde ve boş olmadığında, yalnızca referans verilen politika tanımlarına kayıt olur. Aksi takdirde, tüm poliçe seti

properties.resourceSelectors

ResourceSelector[]

İlkeleri kaynak özelliklerine göre filtrelemek için kaynak seçici listesi.

systemData

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

PolicyEnrollment[]

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

SelectorKind

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

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

createdByType

Kaynağı en son değiştiren kimlik türü.