Event Grid 원본으로 Azure Key VaultAzure Key Vault as Event Grid source

  • 읽는 데 5분 걸림

이 문서에서는 Azure Key Vault이벤트에 대 한 속성 및 스키마를 제공 합니다.This article provides the properties and schema for events in Azure Key Vault. 이벤트 스키마에 대한 소개는 Azure Event Grid 이벤트 스키마를 참조하세요.For an introduction to event schemas, see Azure Event Grid event schema.

사용할 수 있는 이벤트 유형Available event types

Azure Key Vault 계정은 다음과 같은 이벤트 유형을 생성 합니다.An Azure Key Vault account generates the following event types:

이벤트 전체 이름Event full name 이벤트 표시 이름Event display name 설명Description
CertificateNewVersionCreatedMicrosoft.KeyVault.CertificateNewVersionCreated 인증서 새 버전이 만들어짐Certificate New Version Created 새 인증서 또는 새 인증서 버전이 만들어질 때 트리거됩니다.Triggered when a new certificate or new certificate version is created.
CertificateNearExpiryMicrosoft.KeyVault.CertificateNearExpiry 인증서 만료 임박Certificate Near Expiry 현재 버전의 인증서가 만료 될 때 트리거됩니다.Triggered when the current version of certificate is about to expire. 이 이벤트는 만료 날짜 30 일 전에 트리거됩니다.(The event is triggered 30 days before the expiration date.)
Microsoft. KeyVault. 인증서 만료 됨Microsoft.KeyVault.CertificateExpired 인증서 만료됨Certificate Expired 인증서가 만료 되 면 트리거됩니다.Triggered when the certificate is expired.
Microsoft. KeyNewVersionCreatedMicrosoft.KeyVault.KeyNewVersionCreated 새로 만든 주요 버전Key New Version Created 새 키 또는 새 키 버전이 만들어질 때 트리거됩니다.Triggered when a new key or new key version is created.
KeyNearExpiryMicrosoft.KeyVault.KeyNearExpiry 키 만료가 임박 합니다.Key Near Expiry 키의 현재 버전이 곧 만료 될 때 트리거됩니다.Triggered when the current version of a key is about to expire. 이 이벤트는 만료 날짜 30 일 전에 트리거됩니다.(The event is triggered 30 days before the expiration date.)
Microsoft. KeyVault. Keyvault 됨Microsoft.KeyVault.KeyExpired 키가 만료 됨Key Expired 키가 만료 되 면 트리거됩니다.Triggered when a key is expired.
SecretNewVersionCreatedMicrosoft.KeyVault.SecretNewVersionCreated 새 보안 버전이 만들어짐Secret New Version Created 새 비밀 또는 새 비밀 버전이 만들어질 때 트리거됩니다.Triggered when a new secret or new secret version is created.
SecretNearExpiryMicrosoft.KeyVault.SecretNearExpiry 비밀 만료 임박Secret Near Expiry 암호의 현재 버전이 곧 만료 될 때 트리거됩니다.Triggered when the current version of a secret is about to expire. 이 이벤트는 만료 날짜 30 일 전에 트리거됩니다.(The event is triggered 30 days before the expiration date.)
SecretExpiredMicrosoft.KeyVault.SecretExpired 비밀 만료 됨Secret Expired 암호가 만료 되 면 트리거됩니다.Triggered when a secret is expired.
VaultAccessPolicyChangedMicrosoft.KeyVault.VaultAccessPolicyChanged 자격 증명 모음 액세스 정책이 변경 됨Vault Access Policy Changed Key Vault에 대 한 액세스 정책이 변경 될 때 트리거됩니다.Triggered when an access policy on Key Vault changed. Azure 역할 기반 액세스 제어에서 Key Vault 권한 모델이 변경 되는 시나리오를 포함 합니다.It includes a scenario when Key Vault permission model is changed to/from Azure role-based access control.

이벤트 예제Event examples

다음 예제에서는 SecretNewVersionCreated 에 대 한 스키마를 보여 줍니다.The following example show schema for Microsoft.KeyVault.SecretNewVersionCreated:

[
   {
      "id":"00eccf70-95a7-4e7c-8299-2eb17ee9ad64",
      "topic":"/subscriptions/{subscription-id}/resourceGroups/sample-rg/providers/Microsoft.KeyVault/vaults/sample-kv",
      "subject":"newsecret",
      "eventType":"Microsoft.KeyVault.SecretNewVersionCreated",
      "eventTime":"2019-07-25T01:08:33.1036736Z",
      "data":{
         "Id":"https://sample-kv.vault.azure.net/secrets/newsecret/ee059b2bb5bc48398a53b168c6cdcb10",
         "vaultName":"sample-kv",
         "objectType":"Secret",
         "objectName ":"newsecret",
         "version":" ee059b2bb5bc48398a53b168c6cdcb10",
         "nbf":"1559081980",
         "exp":"1559082102"
      },
      "dataVersion":"1",
      "metadataVersion":"1"
   }
]

이벤트 속성Event properties

이벤트에는 다음과 같은 최상위 데이터가 있습니다.An event has the following top-level data:

속성Property TypeType DescriptionDescription
topic 문자열string 이벤트 원본에 대한 전체 리소스 경로입니다.Full resource path to the event source. 이 필드는 쓸 수 없습니다.This field isn't writeable. Event Grid는 이 값을 제공합니다.Event Grid provides this value.
subject 문자열string 게시자가 정의한 이벤트 주체의 경로입니다.Publisher-defined path to the event subject.
eventType 문자열string 이 이벤트 원본에 대해 등록된 이벤트 유형 중 하나입니다.One of the registered event types for this event source.
eventTime 문자열string 공급자의 UTC 시간을 기준으로 이벤트가 생성되는 시간입니다.The time the event is generated based on the provider's UTC time.
id 문자열string 이벤트에 대한 고유 식별자입니다.Unique identifier for the event.
data 개체object 앱 구성 이벤트 데이터입니다.App Configuration event data.
dataVersion 문자열string 데이터 개체의 스키마 버전입니다.The schema version of the data object. 게시자가 스키마 버전을 정의합니다.The publisher defines the schema version.
metadataVersion 문자열string 이벤트 메타데이터의 스키마 버전입니다.The schema version of the event metadata. Event Grid는 최상위 속성의 스키마를 정의합니다.Event Grid defines the schema of the top-level properties. Event Grid는 이 값을 제공합니다.Event Grid provides this value.

데이터 개체의 속성은 다음과 같습니다.The data object has the following properties:

속성Property TypeType DescriptionDescription
id 문자열string 이 이벤트를 트리거한 개체의 ID입니다.The ID of the object that triggered this event
vaultName 문자열string 이 이벤트를 트리거한 개체의 키 자격 증명 모음 이름입니다.The key vault name of the object that triggered this event
objectType 문자열string 이 이벤트를 트리거한 개체의 형식입니다.The type of the object that triggered this event
objectName 문자열string 이 이벤트를 트리거한 개체의 이름입니다.The name of the object that triggered this event
version 문자열string 이 이벤트를 트리거한 개체의 버전입니다.The version of the object that triggered this event
nbf 숫자number 이 이벤트를 트리거한 개체의 1970-01-01T00:00:00Z 이후 경과 되지 않은 날짜 (초)입니다.The not-before date in seconds since 1970-01-01T00:00:00Z of the object that triggered this event
exp 숫자number 1970-01-01T00:00:00Z 이후이 이벤트를 트리거한 개체의 만료 날짜 (초)입니다.The expiration date in seconds since 1970-01-01T00:00:00Z of the object that triggered this event

자습서 및 방법Tutorials and how-tos

제목Title 설명Description
Azure Event Grid를 사용 하 여 Key Vault 이벤트 모니터링Monitoring Key Vault events with Azure Event Grid Event Grid와 Key Vault 통합에 대 한 개요입니다.Overview of integrating Key Vault with Event Grid.
자습서: Event Grid를 사용 하 여 Key Vault 이벤트 만들기 및 모니터링Tutorial: Create and monitor Key Vault events with Event Grid Key Vault에 대 한 Event Grid 알림을 설정 하는 방법을 알아봅니다.Learn how to set up Event Grid notifications for Key Vault.

다음 단계Next steps