Event Grid kaynağı olarak Azure İlkesi

  • Makale

Bu makalede, Azure İlkesi olayları için özellikler ve şema sağlanır. Olay şemalarına giriş için bkz. olay şemasını Azure Event Grid. Ayrıca, Azure İlkesi olay kaynağı olarak kullanmak için hızlı başlangıçların ve öğreticilerin bir listesini sunar.

Kullanılabilir olay türleri

Azure İlkesi aşağıdaki olay türlerini yayar:

Olay türü Açıklama
Microsoft.PolicyInsights.PolicyStateCreated İlke uyumluluk durumu oluşturulduğunda oluşturulur.
Microsoft.PolicyInsights.PolicyStateChanged İlke uyumluluk durumu değiştirildiğinde oluşturulur.
Microsoft.PolicyInsights.PolicyStateDeleted İlke uyumluluk durumu silindiğinde tetikleniyor.

Olay özellikleri

Bir olay aşağıdaki üst düzey verilere sahiptir:

Özellik Tür Description
topic dize Olay kaynağının tam kaynak yolu. Bu alan yazılamaz. Event Grid bu değeri sağlar.
subject string Kaynak adı ve kaynak türü de dahil olmak üzere uyumluluk durumu değişikliğinin ilgili olduğu kaynağın tam kimliği. Biçimini kullanır, /subscriptions/<SubscriptionID>/resourceGroups/<ResourceGroup>/providers/<ProviderNamespace>/<ResourceType>/<ResourceName>
eventType string Bu olay kaynağı için kayıtlı olay türlerinden biri.
eventTime string Sağlayıcının UTC saati temelinde olayın oluşturulduğu saat.
id string Olayın benzersiz tanımlayıcısı.
data object Olay verilerini Azure İlkesi.
dataVersion string Veri nesnesinin şema sürümü. Şema sürümünü yayımcı tanımlar.
metadataVersion string Olay meta verilerinin şema sürümü. Event Grid en üst düzey özelliklerin şemasını tanımlar. Event Grid bu değeri sağlar.

Veri nesnesi aşağıdaki özelliklere sahiptir:

Özellik Tür Description
timestamp dize Kaynağın Azure İlkesi tarafından tarandığı saat (UTC olarak). Olayları sıralamak için üst düzey eventTime veya time özellikler yerine bu özelliği kullanın.
policyAssignmentId string İlke atamasının kaynak kimliği.
policyDefinitionId string İlke tanımının kaynak kimliği.
policyDefinitionReferenceId string İlke ataması bir girişime yönelikse, girişim tanımının içindeki ilke tanımının başvuru kimliği. Boş olabilir.
complianceState string İlke atamasıyla ilgili kaynağın uyumluluk durumu.
subscriptionId string Kaynağın abonelik kimliği.
complianceReasonCode string Uyumluluk nedeni kodu. Boş olabilir.

Örnek olay

Aşağıdaki örnekte, abonelik düzeyinde kapsamı belirlenmiş bir ilke durumu oluşturulan olayın şeması gösterilmektedir:

[{
    "id": "5829794FCB5075FCF585476619577B5A5A30E52C84842CBD4E2AD73996714C4C",
    "topic": "/subscriptions/<SubscriptionID>",
    "subject": "/subscriptions/<SubscriptionID>/resourceGroups/<ResourceGroup>/providers/<ProviderNamespace>/<ResourceType>/<ResourceName>",
    "data": {
        "timestamp": "2021-03-27T18:37:42.4496956Z",
        "policyAssignmentId": "<policy-assignment-scope>/providers/microsoft.authorization/policyassignments/<policy-assignment-name>",
        "policyDefinitionId": "<policy-definition-scope>/providers/microsoft.authorization/policydefinitions/<policy-definition-name>",
        "policyDefinitionReferenceId": "",
        "complianceState": "NonCompliant",
        "subscriptionId": "<subscription-id>",
        "complianceReasonCode": ""
    },
    "eventType": "Microsoft.PolicyInsights.PolicyStateCreated",
    "eventTime": "2021-03-27T18:37:42.5241536Z",
    "dataVersion": "1",
    "metadataVersion": "1"
}]

Abonelik düzeyinde kapsamı değiştirilen bir ilke durumunun şeması benzerdir:

[{
    "id": "5829794FCB5075FCF585476619577B5A5A30E52C84842CBD4E2AD73996714C4C",
    "topic": "/subscriptions/<SubscriptionID>",
    "subject": "/subscriptions/<SubscriptionID>/resourceGroups/<ResourceGroup>/providers/<ProviderNamespace>/<ResourceType>/<ResourceName>",
    "data": {
        "timestamp": "2021-03-27T18:37:42.4496956Z",
        "policyAssignmentId": "<policy-assignment-scope>/providers/microsoft.authorization/policyassignments/<policy-assignment-name>",
        "policyDefinitionId": "<policy-definition-scope>/providers/microsoft.authorization/policydefinitions/<policy-definition-name>",
        "policyDefinitionReferenceId": "",
        "complianceState": "NonCompliant",
        "subscriptionId": "<subscription-id>",
        "complianceReasonCode": ""
    },
    "eventType": "Microsoft.PolicyInsights.PolicyStateChanged",
    "eventTime": "2021-03-27T18:37:42.5241536Z",
    "dataVersion": "1",
    "metadataVersion": "1"
}]

Aşağıdaki örnekte, yönetim grubu düzeyinde kapsamı belirlenmiş bir ilke durumu oluşturulan olayın şeması gösterilmektedir:

[{
    "id": "5829794FCB5075FCF585476619577B5A5A30E52C84842CBD4E2AD73996714C4C",
    "topic": "/tenants/<tenantId>/providers/Microsoft.Management/managementGroups/<managementGroupId>",
    "subject": "/subscriptions/<SubscriptionID>/resourceGroups/<ResourceGroup>/providers/<ProviderNamespace>/<ResourceType>/<ResourceName>",
    "data": {
        "timestamp": "2021-03-27T18:37:42.4496956Z",
        "policyAssignmentId": "<policy-assignment-scope>/providers/microsoft.authorization/policyassignments/<policy-assignment-name>",
        "policyDefinitionId": "<policy-definition-scope>/providers/microsoft.authorization/policydefinitions/<policy-definition-name>",
        "policyDefinitionReferenceId": "",
        "complianceState": "NonCompliant",
        "subscriptionId": "<subscription-id>",
        "complianceReasonCode": ""
    },
    "eventType": "Microsoft.PolicyInsights.PolicyStateCreated",
    "eventTime": "2021-03-27T18:37:42.5241536Z",
    "dataVersion": "1",
    "metadataVersion": "1"
}]

Yönetim grubu düzeyinde kapsamı değiştirilmiş bir ilke durumunun şeması benzerdir:

[{
    "id": "5829794FCB5075FCF585476619577B5A5A30E52C84842CBD4E2AD73996714C4C",
    "topic": "/tenants/<tenantId>/providers/Microsoft.Management/managementGroups/<managementGroupId>",
    "subject": "/subscriptions/<SubscriptionID>/resourceGroups/<ResourceGroup>/providers/<ProviderNamespace>/<ResourceType>/<ResourceName>",
    "data": {
        "timestamp": "2021-03-27T18:37:42.4496956Z",
        "policyAssignmentId": "<policy-assignment-scope>/providers/microsoft.authorization/policyassignments/<policy-assignment-name>",
        "policyDefinitionId": "<policy-definition-scope>/providers/microsoft.authorization/policydefinitions/<policy-definition-name>",
        "policyDefinitionReferenceId": "",
        "complianceState": "NonCompliant",
        "subscriptionId": "<subscription-id>",
        "complianceReasonCode": ""
    },
    "eventType": "Microsoft.PolicyInsights.PolicyStateChanged",
    "eventTime": "2021-03-27T18:37:42.5241536Z",
    "dataVersion": "1",
    "metadataVersion": "1"
}]

Sonraki adımlar