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 개의 배달 시도에 대 한 사용자 지정 재시도 정책 및 2 시간의 이벤트 TTL (이전에 발생) 및 만료 날짜를 사용 하 여 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

저장소 큐를 대상으로 사용 하는 Event Grid 파트너 토픽의 새 이벤트 구독 만들기 5 분의 메시지 ttl

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가이 이벤트 구독과 일치 하는 이벤트를 제공 해야 하는 끝점입니다. Webhook 끝점 형식의 경우 해당 webhook URL 이어야 합니다. 다른 끝점 형식의 경우 끝점의 Azure 리소스 식별자 여야 합니다. Event Grid 명령을 실행 하기 전에 대상 끝점을 이미 만들고 사용할 수 있어야 합니다.

--endpoint-type

대상 끝점의 형식입니다.

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

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

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

이벤트 ttl (time to live) (분)입니다. 1에서 1440 사이의 숫자 여야 합니다.

기본값: 1440
--expiration-date

날짜 또는 날짜/시간 (UTC, 예: ' 2018-11-30T11:59:59 + 00:00 ' 또는 ' 2018-11-30 ') 후에 이벤트 구독이 만료 됩니다. 기본적으로 이벤트 구독은 만료 되지 않습니다.

--included-event-types

공백으로 구분 된 이벤트 유형 목록 (예: Microsoft. 저장소나 Created 및 Microsoft. Storage. Blobcreated)입니다. 모든 기본 이벤트 유형을 구독 하려면이 인수에 값을 지정 하지 마십시오. Event grid 토픽의 경우 이벤트 유형은 customer로 정의 됩니다. Azure 이벤트 (예: 저장소 계정, IoT Hub 등)의 경우이 CLI 명령 ' az event grid 토픽-type list-i n t e r t e r '를 사용 하 여 해당 이벤트 유형을 쿼리할 수 있습니다.

--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

저장소 큐 메시지 ttl (time to live) (초)입니다.

--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 쿼리입니다. 필터링은 현재 이름 속성에만 허용 됩니다. 지원 되는 작업에는 CONTAINS, eq (같음), ne (같지 않음), AND, OR 및 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

저장소 큐를 대상으로 사용 하 여 저장소 큐를 5 분의 대상으로 사용 하는 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가이 이벤트 구독과 일치 하는 이벤트를 제공 해야 하는 끝점입니다. Webhook 끝점 형식의 경우 해당 webhook URL 이어야 합니다. 다른 끝점 형식의 경우 끝점의 Azure 리소스 식별자 여야 합니다. Event Grid 명령을 실행 하기 전에 대상 끝점을 이미 만들고 사용할 수 있어야 합니다.

--endpoint-type

대상 끝점의 형식입니다.

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

공백으로 구분 된 이벤트 유형 목록 (예: Microsoft. 저장소나 Created 및 Microsoft. Storage. Blobcreated)입니다. 모든 기본 이벤트 유형을 구독 하려면이 인수에 값을 지정 하지 마십시오. Event grid 토픽의 경우 이벤트 유형은 customer로 정의 됩니다. Azure 이벤트 (예: 저장소 계정, IoT Hub 등)의 경우이 CLI 명령 ' az event grid 토픽-type list-i n t e r t e r '를 사용 하 여 해당 이벤트 유형을 쿼리할 수 있습니다.

--labels

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

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

저장소 큐 메시지 ttl (time to live) (초)입니다.

--subject-begins-with

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

--subject-ends-with

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

--subscription

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