az eventgrid topic

Azure Event Grid 항목을 관리합니다.

명령

az eventgrid topic create

토픽을 만듭니다.

az eventgrid topic delete

토픽을 삭제합니다.

az eventgrid topic key

토픽의 공유 액세스 키를 관리합니다.

az eventgrid topic key list

토픽의 공유 액세스 키를 나열합니다.

az eventgrid topic key regenerate

토픽의 공유 액세스 키를 다시 생성합니다.

az eventgrid topic list

사용 가능한 항목을 나열합니다.

az eventgrid topic private-endpoint-connection

항목의 개인 끝점 연결을 관리 합니다.

az eventgrid topic private-endpoint-connection approve

항목에 대 한 개인 끝점 연결 요청을 승인 합니다.

az eventgrid topic private-endpoint-connection delete

항목에 대 한 개인 끝점 연결을 삭제 합니다.

az eventgrid topic private-endpoint-connection list

항목에 대 한 모든 개인 끝점 연결의 속성을 나열 합니다.

az eventgrid topic private-endpoint-connection reject

항목에 대 한 개인 끝점 연결 요청을 거부 합니다.

az eventgrid topic private-endpoint-connection show

항목에 대 한 개인 끝점 연결의 속성을 표시 합니다.

az eventgrid topic private-link-resource

토픽의 프라이빗 링크 리소스를 관리합니다.

az eventgrid topic private-link-resource list

토픽에 대한 모든 프라이빗 링크 리소스의 속성을 나열합니다.

az eventgrid topic private-link-resource show

토픽에 대한 프라이빗 링크 리소스의 속성을 표시합니다.

az eventgrid topic show

토픽의 세부 정보를 얻습니다.

az eventgrid topic update

토픽을 업데이트합니다.

az eventgrid topic create

토픽을 만듭니다.

az eventgrid topic create --name
                          --resource-group
                          [--extended-location-name]
                          [--extended-location-type {customlocation}]
                          [--identity {noidentity, systemassigned}]
                          [--inbound-ip-rules]
                          [--input-mapping-default-values]
                          [--input-mapping-fields]
                          [--input-schema {cloudeventschemav1_0, customeventschema, eventgridschema}]
                          [--kind {azure, azurearc}]
                          [--location]
                          [--public-network-access {disabled, enabled}]
                          [--sku {basic, premium}]
                          [--subscription]
                          [--tags]

예제

새 토픽을 만듭니다.

az eventgrid topic create -g rg1 --name topic1 -l westus2

사용자 지정 입력 매핑을 사용하여 새 항목을 만듭니다.

az eventgrid topic create -g rg1 --name topic1 -l westus2 --input-schema customeventschema --input-mapping-fields topic=myTopicField eventType=myEventTypeField --input-mapping-default-values subject=DefaultSubject dataVersion=1.0

CloudEvents V1.0 스키마에 게시된 이벤트를 허용하는 새 항목을 만듭니다.

az eventgrid topic create -g rg1 --name topic1 -l westus2 --input-schema cloudeventschemav1_0

기본 Sku 및 시스템 할당 ID를 사용하여 특정 인바운드 IP 규칙을 허용하는 새 항목 만들기

az eventgrid topic create -g rg1 --name topic1 -l westus2 --public-network-access enabled --inbound-ip-rules 10.0.0.0/8 Allow --inbound-ip-rules 10.2.0.0/8 Allow --sku Basic --identity systemassigned

Azure에서 새 토픽을 만듭니다.

az eventgrid topic create -g rg1 --name topic1 -l westus2

Azure에서 새 토픽을 만듭니다.

az eventgrid topic create -g rg1 --name topic1 -l westus2 --kind azure

사용자 지정 위치를 대상으로 하는 AzureArc에서 새 항목을 만듭니다.

az eventgrid topic create -g rg1 --name topic1 -l eastus2euap --kind azurearc --extended-location-name /subscriptions/<subid>/resourcegroups/<rgname>/providers/microsoft.extendedlocation/customlocations/<cust-loc-name> --extended-location-type customlocation --input-schema CloudEventSchemaV1_0

필수 매개 변수

--name -n

항목의 이름입니다.

--resource-group -g

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

선택적 매개 변수

--extended-location-name

확장된 위치 이름(kind==azurearc인 경우)입니다.

--extended-location-type

kind==azurearc인 경우 확장된 위치 유형입니다.

허용되는 값: customlocation
--identity

리소스의 관리 ID 형식입니다.

허용되는 값: noidentity, systemassigned
--inbound-ip-rules

인바운드 IP 규칙 목록입니다.

--input-mapping-default-values

input-schema가 customeventschema로 지정된 경우 이 매개 변수를 사용하여 기본값에 따라 입력 매핑을 지정할 수 있습니다. 사용자 지정 스키마에 이 매개 변수에서 지원하는 세 필드 중 하나에 해당하는 필드가 포함되지 않은 경우 이 매개 변수를 사용할 수 있습니다. 공백으로 구분된 매핑을 'key=value' 형식으로 지정합니다. 허용되는 키 이름은 'subject', 'eventtype', 'dataversion'입니다. 해당 값 이름은 매핑에 사용할 기본값을 지정해야 하며 게시된 이벤트에 특정 필드에 대한 유효한 매핑이 없는 경우에만 사용됩니다.

--input-mapping-fields

input-schema가 customeventschema로 지정된 경우 이 매개 변수는 필드 이름에 따라 입력 매핑을 지정하는 데 사용됩니다. 공백으로 구분된 매핑을 'key=value' 형식으로 지정합니다. 허용되는 키 이름은 'id', 'topic', 'eventtime', 'subject', 'eventtype', 'dataversion'입니다. 해당 값 이름은 사용자 지정 입력 스키마의 필드 이름을 지정해야 합니다. 'id' 또는 'eventtime' 중 하나에 대한 매핑이 제공되지 않으면 Event Grid 이러한 두 필드에 대한 기본값을 자동으로 생성합니다.

--input-schema

들어오는 이벤트가 이 토픽/도메인에 게시될 스키마입니다. customeventschema를 이 매개 변수의 값으로 지정하는 경우 --input_mapping_default_values/ --input_mapping_fields 중 하나 이상에 대한 값도 제공해야 합니다.

허용되는 값: cloudeventschemav1_0, customeventschema, eventgridschema
기본값: eventgridschema
--kind

토픽 리소스의 종류입니다.

허용되는 값: azure, azurearc
기본값: Azure
--location -l

위치입니다. 값 출처: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

--public-network-access

이는 공용 네트워크를 통해 트래픽이 허용되는지 여부를 결정합니다. 기본적으로 사용하도록 설정됩니다. 를 구성하여 특정 IP로 추가로 제한할 수 있습니다.

허용되는 값: disabled, enabled
--sku

리소스의 SKU 이름입니다.

허용되는 값: basic, premium
기본값: Basic
--subscription

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

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

az eventgrid topic delete

토픽을 삭제합니다.

az eventgrid topic delete [--ids]
                          [--name]
                          [--resource-group]
                          [--subscription]

예제

토픽을 삭제합니다.

az eventgrid topic delete -g rg1 --name topic1

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

항목의 이름입니다.

--resource-group -g

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

--subscription

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

az eventgrid topic list

사용 가능한 항목을 나열합니다.

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

예제

현재 Azure 구독의 모든 항목을 나열합니다.

az eventgrid topic list

리소스 그룹의 모든 항목을 나열합니다.

az eventgrid topic list -g rg1

이름에 "XYZ" 패턴이 포함된 리소스 그룹의 모든 항목 나열

az eventgrid topic list -g rg1 --odata-query "Contains(name, 'XYZ')"

이름이 "name1"인 도메인을 제외한 리소스 그룹의 모든 항목을 나열합니다.

az eventgrid topic list -g rg1 --odata-query "NOT (name eq 'name1')"

선택적 매개 변수

--odata-query

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

--query-examples

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

--resource-group -g

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

--subscription

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

az eventgrid topic show

토픽의 세부 정보를 얻습니다.

az eventgrid topic show [--ids]
                        [--name]
                        [--query-examples]
                        [--resource-group]
                        [--subscription]

예제

항목의 세부 정보를 표시합니다.

az eventgrid topic show -g rg1 -n topic1

리소스 ID를 기준으로 항목의 세부 정보를 표시합니다.

az eventgrid topic show --ids /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

항목의 이름입니다.

--query-examples

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

--resource-group -g

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

--subscription

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

az eventgrid topic update

토픽을 업데이트합니다.

az eventgrid topic update [--identity {noidentity, systemassigned}]
                          [--ids]
                          [--inbound-ip-rules]
                          [--name]
                          [--public-network-access {disabled, enabled}]
                          [--resource-group]
                          [--sku {basic, premium}]
                          [--subscription]
                          [--tags]

예제

새 SKU, ID 및 공용 네트워크 액세스 정보로 기존 항목의 속성을 업데이트합니다.

az eventgrid topic update -g rg1 --name topic1 --sku Premium --identity systemassigned --public-network-access enabled --inbound-ip-rules 10.0.0.0/8 Allow --inbound-ip-rules 10.2.0.0/8 Allow --tags Dept=IT --sku basic

선택적 매개 변수

--identity

리소스의 관리 ID 형식입니다.

허용되는 값: noidentity, systemassigned
--ids

하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--inbound-ip-rules

IPMask와 일치하거나 일치하지 않는 항목에 따라 수행할 해당 작업과 함께 CIDR 표기법으로 IP 주소(예: 10.0.0.0/8)를 지정하는 인바운드 IP 규칙 목록입니다.

--name -n

항목의 이름입니다.

--public-network-access

이는 공용 네트워크를 통해 트래픽이 허용되는지 여부를 결정합니다. 기본적으로 사용하도록 설정됩니다. 를 구성하여 특정 IP로 추가로 제한할 수 있습니다.

허용되는 값: disabled, enabled
--resource-group -g

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

--sku

리소스의 SKU 이름입니다.

허용되는 값: basic, premium
--subscription

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

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.