다음을 통해 공유

Event Grid 원본으로서의 Azure App Configuration

  • 아티클

이 문서에서는 Azure App Configuration 이벤트에 대한 속성과 스키마를 제공합니다. 이벤트 스키마에 대한 소개는 Azure Event Grid 이벤트 스키마를 참조하세요. 이벤트 원본으로 Azure App Configuration을 사용하기 위한 빠른 시작 및 자습서의 목록도 제공합니다.

사용할 수 있는 이벤트 유형

Event Grid는 이벤트 구독을 사용하여 이벤트 메시지를 구독자에게 라우팅합니다. Azure App Configuration은 다음과 같은 이벤트 유형을 내보냅니다.

이벤트 유형 설명
Microsoft.AppConfiguration.KeyValueModified 키-값이 만들어지거나 바뀔 때 발생합니다.
Microsoft.AppConfiguration.KeyValueDeleted 키-값이 삭제될 때 발생합니다.
Microsoft.AppConfiguration.SnapshotCreated 스냅샷을 만들 때 발생합니다.
Microsoft.AppConfiguration.SnapshotModified 스냅샷이 수정될 때 발생합니다.

이벤트 스키마

이벤트에는 다음과 같은 최상위 데이터가 있습니다.

속성 Type Description
source string 이벤트 원본에 대한 전체 리소스 경로입니다. 이 필드는 쓸 수 없습니다. Event Grid는 이 값을 제공합니다.
subject string 게시자가 정의한 이벤트 주체의 경로입니다.
type string 이 이벤트 원본에 대해 등록된 이벤트 유형 중 하나입니다.
time string 공급자의 UTC 시간을 기준으로 이벤트가 생성되는 시간입니다.
id string 이벤트에 대한 고유 식별자입니다.
data 개체 App Configuration 이벤트 데이터.
specversion string CloudEvents 스키마 사양 버전입니다.

데이터 개체의 속성은 다음과 같습니다.

키-값 이벤트

속성 Type Description
key string 수정되거나 삭제된 키-값의 키입니다.
label string 수정되거나 삭제된 키-값의 레이블(있는 경우)입니다.
etag string KeyValueModified의 경우 새 키-값의 etag입니다. KeyValueDeleted의 경우 삭제된 키-값의 etag입니다.
syncToken string 키-값 이벤트 이후의 서버 상태를 나타내는 동기화 토큰입니다.

스냅샷 이벤트

속성 Type Description
name string 만들거나 수정한 스냅샷의 이름입니다.
etag string SnapshotCreated의 경우 새 스냅샷의 etag입니다. SnapshotModified의 경우 수정된 스냅샷의 etag입니다.
syncToken string 스냅샷 이벤트 이후의 서버 상태를 나타내는 동기화 토큰입니다.

예제 이벤트

다음 예제에서는 키-값 수정 이벤트의 스키마를 보여줍니다.

[{
  "id": "84e17ea4-66db-4b54-8050-df8f7763f87b",
  "source": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/microsoft.appconfiguration/configurationstores/contoso",
  "subject": "https://contoso.azconfig.io/kv/Foo?label=FizzBuzz",
  "data": {
    "key": "Foo",
    "label": "FizzBuzz",
    "etag": "FnUExLaj2moIi4tJX9AXn9sakm0"
  },
  "type": "Microsoft.AppConfiguration.KeyValueModified",
  "time": "2019-05-31T20:05:03Z",
  "specversion": "1.0"
}]

다음 예제에서는 키-값 삭제 이벤트의 스키마를 보여줍니다.

[{
  "id": "84e17ea4-66db-4b54-8050-df8f7763f87b",
  "source": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/microsoft.appconfiguration/configurationstores/contoso",
  "subject": "https://contoso.azconfig.io/kv/Foo?label=FizzBuzz",
  "data": {
    "key": "Foo",
    "label": "FizzBuzz",
    "etag": "FnUExLaj2moIi4tJX9AXn9sakm0"
  },
  "type": "Microsoft.AppConfiguration.KeyValueDeleted",
  "time": "2019-05-31T20:05:03Z",
  "specversion": "1.0"
}]

다음 예제에서는 스냅샷 생성 이벤트의 스키마를 보여줍니다.

[{
  "source": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/microsoft.appconfiguration/configurationstores/contoso",
  "subject": "https://contoso.azconfig.io/kvsnapshots/Foo",
  "type": "Microsoft.AppConfiguration.SnapshotCreated",
  "time": "2023-09-02T20:05:03.0000000Z",
  "id": "84e17ea4-66db-4b54-8050-df8f7763f87b",
  "data": {
    "name": "Foo",
    "etag": "FnUExLaj2moIi4tJX9AXn9sakm0",
    "syncToken": "zAJw6V16=Njo1IzUxNjQ2NzM=;sn=5164673"
  },
  "specversion": "1.0"
}]

다음 예제에서는 스냅샷 수정 이벤트의 스키마를 보여줍니다.

[{
  "source": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/microsoft.appconfiguration/configurationstores/contoso",
  "subject": "https://contoso.azconfig.io/snapshots/Foo",
  "type": "Microsoft.AppConfiguration.SnapshotModified",
  "time": "2023-09-03T20:05:03.0000000Z",
  "id": "84e17ea4-66db-4b54-8050-df8f7763f87b",
  "data": {
    "name": "Foo",
    "etag": "FnUExLaj2moIi4tJX9AXn9sakm0",
    "syncToken": "zAJw6V16=Njo1IzUxNjQ2NzM=;sn=5164673"
  },
  "specversion": "1.0"
}]

자습서 및 방법

제목 설명
Event Grid를 사용하여 Azure App Configuration 이벤트에 대응 Azure App Configuration과 Event Grid 통합 개요.
데이터 변경 알림에 Event Grid 사용 Azure App Configuration 이벤트 구독을 사용하여 키-값 수정 이벤트를 웹 엔드포인트로 보내는 방법에 대해 알아봅니다.

다음 단계