az eventgrid partner topic event-subscription

파트너 토픽의 이벤트 구독을 관리합니다.

명령

az eventgrid partner topic event-subscription create

파트너 토픽에 대한 새 이벤트 구독을 만듭니다.

az eventgrid partner topic event-subscription delete

파트너 토픽의 이벤트 구독을 삭제합니다.

az eventgrid partner topic event-subscription list

특정 파트너 토픽의 이벤트 구독을 나열합니다.

az eventgrid partner topic event-subscription show

파트너 토픽의 이벤트 구독에 대한 세부 정보를 확인합니다.

az eventgrid partner topic event-subscription update

파트너 토픽의 이벤트 구독을 업데이트합니다.

az eventgrid partner topic event-subscription create

파트너 토픽에 대한 새 이벤트 구독을 만듭니다.

az eventgrid partner topic event-subscription create --name
                                                     --partner-topic-name
                                                     --resource-group
                                                     [--advanced-filter]
                                                     [--azure-active-directory-application-id-or-uri]
                                                     [--azure-active-directory-tenant-id]
                                                     [--deadletter-endpoint]
                                                     [--delivery-attribute-mapping]
                                                     [--enable-advanced-filtering-on-arrays {false, true}]
                                                     [--endpoint]
                                                     [--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                                     [--event-delivery-schema {cloudeventschemav1_0, custominputschema, eventgridschema}]
                                                     [--event-ttl]
                                                     [--expiration-date]
                                                     [--included-event-types]
                                                     [--labels]
                                                     [--max-delivery-attempts]
                                                     [--max-events-per-batch]
                                                     [--preferred-batch-size-in-kilobytes]
                                                     [--qttl]
                                                     [--subject-begins-with]
                                                     [--subject-case-sensitive {false, true}]
                                                     [--subject-ends-with]
                                                     [--subscription]

예제

기본 필터를 사용하여 Event Grid 파트너 토픽에 대한 새 이벤트 구독을 만듭니다.

az eventgrid partner topic event-subscription create --name es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

주체 접두사 지정 필터를 사용하여 Event Grid 파트너 토픽에 대한 새 이벤트 구독을 만듭니다.

az eventgrid partner topic event-subscription create --name es4 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-begins-with mysubject_prefix

기본 필터 및 CloudEvent V 1.0을 배달 스키마로 사용하여 Event Grid 파트너 토픽에 대한 새 이벤트 구독을 만듭니다.

az eventgrid partner topic event-subscription create -n es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --event-delivery-schema cloudeventschemav1_0

배달 못 한 대상 및 최대 10회 배달 시도의 사용자 지정 재시도 정책과 이벤트 TTL이 2시간(이전에 발생함) 및 만료 날짜를 사용하여 Event Grid 파트너에 대한 새 이벤트 구독을 만듭니다.

az eventgrid partner topic event-subscription create --name es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 \
    --max-delivery-attempts 10 --event-ttl 120 --expiration-date "2022-10-31"

Azure Active Directory 사용하도록 설정된 Webhook를 대상으로 사용하여 Event Grid 파트너 토픽에 대한 새 이벤트 구독을 만듭니다.

az eventgrid partner topic event-subscription create --name es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --azure-active-directory-tenant-id azureactivedirectorytenantid
    --azure-active-directory-application-id-or-uri azureactivedirectoryapplicationidoruri

Azure Function을 대상으로 사용하여 Event Grid 파트너 토픽에 대한 새 이벤트 구독을 만듭니다.

az eventgrid partner topic event-subscription create -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction

메시지 ttl이 5분인 대상으로 Storage 큐를 사용하여 Event Grid 파트너 토픽에 대한 새 이벤트 구독 만들기

az eventgrid partner topic event-subscription create -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --storage-queue-msg-ttl 300

배열에 대한 고급 필터링을 사용하도록 설정된 Event Grid 파트너 토픽에 대한 새 이벤트 구독 만들기

az eventgrid partner topic event-subscription create -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --enable-advanced-filtering-on-arrays true

필수 매개 변수

--name -n

이벤트 구독의 이름입니다.

--partner-topic-name

파트너 토픽의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--advanced-filter

고급 필터를 사용하면 특정 이벤트 속성을 기반으로 이벤트를 필터링할 수 있습니다.

--azure-active-directory-application-id-or-uri

배달 요청에 전달자 토큰으로 포함될 액세스 토큰을 얻기 위한 Azure Active Directory 애플리케이션 ID 또는 URI입니다. 대상인 webhook에만 적용됩니다.

--azure-active-directory-tenant-id

배달 요청에 전달자 토큰으로 포함될 액세스 토큰을 얻기 위한 Azure Active Directory 테넌트 ID입니다. 대상인 webhook에만 적용됩니다.

--deadletter-endpoint

EventGrid가 이 이벤트 구독에 대해 배달할 수 없는 이벤트를 배달하지 않아야 하는 Azure Storage Blob 컨테이너 대상의 Azure 리소스 ID입니다.

--delivery-attribute-mapping

이벤트를 배달할 때 HTTP 헤더를 통해 추가 정보를 보내도록 배달 특성 매핑을 추가합니다. 이 특성은 StorageQueue를 제외한 모든 대상 유형에 유효합니다. 두 개 이상의 인수를 사용하여 여러 특성을 지정할 수 --delivery-attribute-mapping 있습니다.

--enable-advanced-filtering-on-arrays --enable-af-arr

단수 값을 예상하는 대신 값 배열에 대해 고급 필터를 평가할 수 있습니다.

허용되는 값: false, true
--endpoint

EventGrid가 이 이벤트 구독과 일치하는 이벤트를 제공해야 하는 엔드포인트입니다. 웹후크 엔드포인트 유형의 경우 해당 웹후크 URL이어야 합니다. 다른 엔드포인트 유형의 경우 엔드포인트의 Azure 리소스 식별자여야 합니다. Event Grid 명령을 실행하기 전에 대상 엔드포인트를 이미 만들고 사용할 수 있어야 합니다.

--endpoint-type

대상 엔드포인트의 형식입니다.

허용되는 값: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
기본값: webhook
--event-delivery-schema

이 이벤트 구독에 대해 이벤트를 배달해야 하는 스키마입니다. 기본적으로 이벤트는 게시되는 스키마와 동일한 스키마로 전달됩니다(해당 항목의 입력 스키마에 따라).

허용되는 값: cloudeventschemav1_0, custominputschema, eventgridschema
--event-ttl

이벤트 라이브 시간(분)입니다. 1에서 1440 사이의 숫자여야 합니다.

기본값: 1440
--expiration-date

이벤트 구독이 만료되는 날짜 또는 날짜/시간(예: '2018-11-30T11:59:59+00:00' 또는 '2018-11-30')입니다. 기본적으로 이벤트 구독에 대한 만료는 없습니다.

--included-event-types

공백으로 구분된 이벤트 유형 목록(예: Microsoft.Storage. BlobCreated 및 Microsoft. Storage. BlobDeleted). 모든 기본 이벤트 유형을 구독하려면 이 인수에 대한 값을 지정하지 마십시오. Event Grid 토픽의 경우 이벤트 유형은 고객이 정의합니다. Azure 이벤트(예: Storage 계정, IoT Hub 등)의 경우 이 CLI 명령 'az eventgrid topic-type list-event-types'를 사용하여 해당 이벤트 형식을 쿼리할 수 있습니다.

--labels

이 이벤트 구독과 연결할 공백으로 구분된 레이블 목록입니다.

--max-delivery-attempts

최대 배달 시도 횟수입니다. 1에서 30 사이의 숫자여야 합니다.

기본값: 30
--max-events-per-batch

일괄 처리의 최대 이벤트 수입니다. 값은 1에서 5000 사이의 숫자여야 합니다.

--preferred-batch-size-in-kilobytes

기본 일괄 처리 크기(KB)입니다. 값은 1에서 1024 사이의 숫자여야 합니다.

--qttl --storage-queue-msg-ttl

큐 메시지 시간(초)을 Storage.

--subject-begins-with

접두사를 기반으로 이벤트 구독에 대한 이벤트를 필터링하는 선택적 문자열입니다. 와일드카드 문자는 지원되지 않습니다.

--subject-case-sensitive

대/소문자 구분 방식으로 주체 필드를 비교할지 여부를 지정하려면 를 지정합니다. 플래그가 있으면 True입니다.

허용되는 값: false, true
--subject-ends-with

접미사를 기준으로 이벤트 구독에 대한 이벤트를 필터링하는 선택적 문자열입니다. 와일드카드 문자는 지원되지 않습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 기본 구독을 구성할 수 az account set -s NAME_OR_ID 있습니다.

az eventgrid partner topic event-subscription delete

파트너 토픽의 이벤트 구독을 삭제합니다.

az eventgrid partner topic event-subscription delete --name
                                                     --partner-topic-name
                                                     --resource-group
                                                     [--subscription]
                                                     [--yes]

예제

Event Grid 파트너 토픽에 대한 이벤트 구독을 삭제합니다.

az eventgrid partner topic event-subscription delete --name es1 \
    -g rg1 --partner-topic-name partnertopic1 \

필수 매개 변수

--name -n

이벤트 구독의 이름입니다.

--partner-topic-name

파트너 토픽의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 기본 구독을 구성할 수 az account set -s NAME_OR_ID 있습니다.

--yes -y

확인을 묻는 메시지를 표시하지 마세요.

az eventgrid partner topic event-subscription list

특정 파트너 토픽의 이벤트 구독을 나열합니다.

az eventgrid partner topic event-subscription list --partner-topic-name
                                                   --resource-group
                                                   [--odata-query]
                                                   [--query-examples]
                                                   [--subscription]

예제

Event Grid 파트너 토픽에 대해 만든 모든 이벤트 구독을 나열합니다.

az eventgrid partner topic event-subscription list -g rg1 --partner-topic-name partnertopic1

필수 매개 변수

--partner-topic-name

파트너 토픽의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--odata-query

목록 결과를 필터링하는 데 사용되는 OData 쿼리입니다. 필터링은 현재 Name 속성에서만 허용됩니다. 지원되는 작업에는 CONTAINS, eq(같음), ne(같지 않음), AND 및 NOT이 포함됩니다.

--query-examples

JMESPath 문자열을 권장합니다. 쿼리 중 하나를 복사하여 큰따옴표 안에 --query 매개 변수를 붙여넣어 결과를 확인할 수 있습니다. 이러한 키워드를 기반으로 제안을 제공할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 기본 구독을 구성할 수 az account set -s NAME_OR_ID 있습니다.

az eventgrid partner topic event-subscription show

파트너 토픽의 이벤트 구독에 대한 세부 정보를 확인합니다.

az eventgrid partner topic event-subscription show --name
                                                   --partner-topic-name
                                                   --resource-group
                                                   [--include-attrib-secret {false, true}]
                                                   [--include-full-endpoint-url {false, true}]
                                                   [--query-examples]
                                                   [--subscription]

예제

Event Grid 파트너 토픽에 대한 이벤트 구독의 세부 정보를 표시합니다.

az eventgrid partner topic event-subscription show --name es1 \
     -g rg1 --partner-topic-name partnertopic1

Event Grid 파트너 토픽에 대한 이벤트 구독의 세부 정보를 표시하고 정적 배달 특성 비밀을 포함합니다.

az eventgrid partner topic event-subscription show --name es1 \
     -g rg1 --partner-topic-name partnertopic1 --include-static-delivery-attribute-secret

필수 매개 변수

--name -n

이벤트 구독의 이름입니다.

--partner-topic-name

파트너 토픽의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--include-attrib-secret --include-static-delivery-attribute-secret

정적 배달 특성 비밀을 반환해야 하는지 여부를 나타냅니다. 플래그가 있으면 True입니다.

허용되는 값: false, true
--include-full-endpoint-url

전체 엔드포인트 URL을 반환할지 여부를 나타내려면 를 지정합니다. 플래그가 있으면 True입니다.

허용되는 값: false, true
--query-examples

JMESPath 문자열을 권장합니다. 쿼리 중 하나를 복사하여 큰따옴표 안에 --query 매개 변수를 붙여넣어 결과를 확인할 수 있습니다. 이러한 키워드를 기반으로 제안을 제공할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 기본 구독을 구성할 수 az account set -s NAME_OR_ID 있습니다.

az eventgrid partner topic event-subscription update

파트너 토픽의 이벤트 구독을 업데이트합니다.

az eventgrid partner topic event-subscription update --name
                                                     --partner-topic-name
                                                     --resource-group
                                                     [--advanced-filter]
                                                     [--deadletter-endpoint]
                                                     [--delivery-attribute-mapping]
                                                     [--enable-advanced-filtering-on-arrays {false, true}]
                                                     [--endpoint]
                                                     [--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                                     [--included-event-types]
                                                     [--labels]
                                                     [--qttl]
                                                     [--subject-begins-with]
                                                     [--subject-ends-with]
                                                     [--subscription]

예제

Event Grid 파트너 토픽에 대한 이벤트 구독을 업데이트하여 새 엔드포인트를 지정합니다.

az eventgrid partner topic event-subscription update --name es1 \
    -g rg1 --partner-topic-name partnertopic1 --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Event Grid 파트너 토픽에 대한 이벤트 구독을 업데이트하여 새 제목 끝 필터를 지정합니다.

az eventgrid partner topic event-subscription update --name es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --subject-ends-with .jpg

Event Grid 파트너 토픽에 대한 이벤트 구독을 업데이트하여 새 엔드포인트 및 새 주체 끝 항목을 지정하고 포함된 이벤트 유형의 새 목록을 필터링합니다.

az eventgrid partner topic event-subscription update --name es3 \
    -g rg1 --partner-topic-name partnertopic1 \
    --subject-ends-with .png \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted

Azure Event Grid 파트너 토픽에 대한 이벤트 구독을 업데이트하여 데드렛 대상을 포함합니다.

az eventgrid partner topic event-subscription update --name es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1

고급 필터를 사용하여 Azure Event Grid 파트너 토픽에 대한 이벤트 구독을 업데이트합니다.

az eventgrid partner topic event-subscription update --name es3 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --advanced-filter data.blobType StringIn BlockBlob
    --advanced-filter data.url StringBeginsWith https://myaccount.blob.core.windows.net

메시지 ttl이 5분인 대상으로 Storage 큐를 사용하여 Event Grid 파트너 토픽에 대한 이벤트 구독 업데이트

az eventgrid partner topic event-subscription update -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --storage-queue-msg-ttl 300

배열에 대한 고급 필터링을 사용하도록 설정된 Event Grid 파트너 토픽에 대한 이벤트 구독 업데이트

az eventgrid partner topic event-subscription update -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --enable-advanced-filtering-on-arrays true

필수 매개 변수

--name -n

이벤트 구독의 이름입니다.

--partner-topic-name

파트너 토픽의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--advanced-filter

고급 필터를 사용하면 특정 이벤트 속성을 기반으로 이벤트를 필터링할 수 있습니다.

--deadletter-endpoint

EventGrid가 이 이벤트 구독에 대해 배달할 수 없는 이벤트를 배달하지 않아야 하는 Azure Storage Blob 컨테이너 대상의 Azure 리소스 ID입니다.

--delivery-attribute-mapping

이벤트를 배달할 때 HTTP 헤더를 통해 추가 정보를 보내도록 배달 특성 매핑을 추가합니다. 이 특성은 StorageQueue를 제외한 모든 대상 유형에 유효합니다. 두 개 이상의 인수를 사용하여 여러 특성을 지정할 수 --delivery-attribute-mapping 있습니다.

--enable-advanced-filtering-on-arrays --enable-af-arr

단수 값을 예상하는 대신 값 배열에 대해 고급 필터를 평가할 수 있습니다.

허용되는 값: false, true
--endpoint

EventGrid가 이 이벤트 구독과 일치하는 이벤트를 제공해야 하는 엔드포인트입니다. 웹후크 엔드포인트 유형의 경우 해당 웹후크 URL이어야 합니다. 다른 엔드포인트 유형의 경우 엔드포인트의 Azure 리소스 식별자여야 합니다. Event Grid 명령을 실행하기 전에 대상 엔드포인트를 이미 만들고 사용할 수 있어야 합니다.

--endpoint-type

대상 엔드포인트의 형식입니다.

허용되는 값: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
기본값: webhook
--included-event-types

공백으로 구분된 이벤트 유형 목록(예: Microsoft.Storage. BlobCreated 및 Microsoft. Storage. BlobDeleted). 모든 기본 이벤트 유형을 구독하려면 이 인수에 대한 값을 지정하지 마십시오. Event Grid 토픽의 경우 이벤트 유형은 고객이 정의합니다. Azure 이벤트(예: Storage 계정, IoT Hub 등)의 경우 이 CLI 명령 'az eventgrid topic-type list-event-types'를 사용하여 해당 이벤트 형식을 쿼리할 수 있습니다.

--labels

이 이벤트 구독과 연결할 공백으로 구분된 레이블 목록입니다.

--qttl --storage-queue-msg-ttl

큐 메시지 시간(초)을 Storage.

--subject-begins-with

접두사를 기반으로 이벤트 구독에 대한 이벤트를 필터링하는 선택적 문자열입니다. 와일드카드 문자는 지원되지 않습니다.

--subject-ends-with

접미사를 기준으로 이벤트 구독에 대한 이벤트를 필터링하는 선택적 문자열입니다. 와일드카드 문자는 지원되지 않습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 기본 구독을 구성할 수 az account set -s NAME_OR_ID 있습니다.