Azure CLI를 사용하여 Event Grid 시스템 토픽 만들기, 보기 및 관리

이 문서에서는 Azure CLI를 사용하여 시스템 토픽을 만들고 관리하는 방법을 보여 줍니다. 시스템 항목에 대한 개요는 시스템 항목을 참조하세요.

Azure CLI용 확장 설치

Azure CLI의 경우 Event Grid 확장이 필요합니다.

Cloud Shell에서:

  • 확장을 이전에 설치한 경우 업데이트하세요: az extension update -n eventgrid
  • 이전에 확장을 설치하지 않은 경우 다음을 설치합니다. az extension add -n eventgrid

로컬 설치의 경우:

  1. Azure CLI를 설치합니다. 를 확인하여 최신 버전이 있는지 확인합니다 az --version.
  2. 이전 버전의 확장을 제거합니다. az extension remove -n eventgrid
  3. 를 사용하여 eventgrid 확장 설치 az extension add -n eventgrid

시스템 토픽 만들기

  • 먼저 Azure 원본에서 시스템 토픽을 만든 다음 해당 토픽에 대한 이벤트 구독을 만들려면 다음 참조 항목을 참조하세요.

    • az eventgrid 시스템-토픽 생성

      # Get the ID of the Azure source (for example: Azure Storage account)
      storageid=$(az storage account show \
              --name <AZURE STORAGE ACCOUNT NAME> \
              --resource-group <AZURE RESOURCE GROUP NAME> \
                  --query id --output tsv)
      
      # Create the system topic on the Azure source (example: Azure Storage account)
      az eventgrid system-topic create \
          -g <AZURE RESOURCE GROUP NAME> \
          --name <SPECIFY SYSTEM TOPIC NAME> \
          --location <LOCATION> \
          --topic-type microsoft.storage.storageaccounts \
          --source $storageid
      

      시스템 토픽을 만들 때 사용할 수 있는 값 목록을 받으려면 topic-type 다음 명령을 실행하십시오. 이러한 토픽 형식 값은 시스템 토픽 생성을 지원하는 이벤트 원본을 나타냅니다. 목록에서 Microsoft.EventGrid.TopicsMicrosoft.EventGrid.Domains를 무시하세요.

      az eventgrid topic-type  list --output json | grep -w id
      
    • az eventgrid system-topic event-subscription create

      az eventgrid system-topic event-subscription create --name <SPECIFY EVENT SUBSCRIPTION NAME> \
          -g rg1 --system-topic-name <SYSTEM TOPIC NAME> \
          --endpoint <ENDPOINT URL>		  
      
  • Azure 원본에 대한 이벤트 구독을 만들 때 시스템 토픽을 암시적으로 만들려면 az eventgrid event-subscription create 메서드를 사용합니다. 예제는 다음과 같습니다.

    storageid=$(az storage account show --name <AZURE STORAGE ACCOUNT NAME> --resource-group <AZURE RESOURCE GROUP NAME> --query id --output tsv)
    endpoint=<ENDPOINT URL>
    
    az eventgrid event-subscription create \
      --source-resource-id $storageid \
      --name <EVENT SUBSCRIPTION NAME> \
      --endpoint $endpoint
    

    단계별 지침이 포함된 자습서는 스토리지 계정 구독을 참조하세요.

모든 시스템 항목 보기

선택한 시스템 토픽의 모든 시스템 토픽 및 세부 정보를 보려면 다음 명령을 사용합니다.

시스템 토픽 삭제

시스템 토픽을 삭제하려면 다음 명령을 사용합니다.

다음 단계

Azure Event Grid에서 지원하는 시스템 토픽 및 토픽 유형에 대한 자세한 내용은 Azure Event Grid 섹션의 시스템 항목을 참조하세요.