Event Grid kaynağı olarak Azure İlkesi
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
- Azure İlkesi durum değişikliği olaylarını yönlendirme hakkında bir kılavuz için bkz. İlke durumu değişiklik bildirimleri için Event Grid kullanma.
- Azure İlkesi Event Grid ile tümleştirmeye genel bakış için bkz. Event Grid kullanarak olayları Azure İlkesi React.
- Azure Event Grid giriş için bkz. Event Grid nedir?
- Azure Event Grid aboneliği oluşturma hakkında daha fazla bilgi için bkz. Event Grid abonelik şeması.