Azure 서비스 버스


Azure Service Bus 통합구성요소를 통해 Home Assistant 내에서 Azure Service Bus로 메시지를 보낼 수 있습니다.

최초 셋업

이는 이미 Azure 계정이 있다고 가정합니다. 그렇지 않으면 무료 계정을 작성하십시오 여기.

Service Bus 네임 스페이스를 만들어야합니다. 이 안내서를 따를 수 있습니다.

그런 다음 Send 클레임을 사용하여 서비스 버스에 대한 공유 액세스 정책을 작성하거나 네임 스페이스에서 RootManageAccessKey를 사용해야합니다 (이 키에는 이벤트 허브 관리 및 청취(listening)를 위해 추가 클레임이 있으며 이 목적에는 필요하지 않음). 서비스 버스의 보안에 대한 세부 사항은 go here에서 확인하십시오. 또는 하나의 queue 또는 topic에 대한 전용 키를 작성하여 해당 queue 또는 topic에만 액세스를 제한 할 수 있습니다.

Send 정책을 가진 연결 문자열이 있으면 통합 자체를 설정할 수 있습니다.

Home Assistant 내에서 서비스 버스 네임 스페이스를 사용하려면 보내기 전에 큐 또는 토픽이 있어야합니다. 대기열 설정 방법은 여기와 topic 및 subscriptions 설정은 여기를 참조하십시오.

설정

configuration.yaml 파일에 다음 줄을 추가하십시오 :

# Example configuration.yaml entry
notify:
  - platform: azure_service_bus
    connection_string: !secret servicebus_connection_string
    topic: t-test
  - platform: azure_service_bus
    connection_string: !secret servicebus_connection_string
    queue: q-test

Configuration Variables

name

(string)(Optional)

Setting the optional parameter name allows multiple notifiers to be created. The notifier will bind to the service notify.NOTIFIER_NAME.

Default value:

notify

connection_string

(string)(Required)

Connection string found in the Azure portal, with send claim in the key.

queue

(string)(Exclusive)

Which queue to send notifications on.

topic

(string)(Exclusive)

Which topic to send notifications on.

Home Assistant 내에서 하나 이상의 엔티티에서 모든 상태 변경을 보내려는 경우 Azure Event Hub 통합구성요소를 대신 사용하는 것이 좋습니다.

사용법

알림 서비스는 서비스 버스의 JSON 오브젝트에 제공된 데이터를 변환합니다. message 필드는 항상 설정되지만 targettitle 필드는 선택 사항이며 설정된 경우 서비스 버스 메시지에만 포함됩니다. data 섹션에 주어진 모든 입력은 JSON 객체의 루트로 단조로워지고 주어진 구조를 따릅니다. 데이터 섹션에 제공된 모든 입력이 메시지에 포함됩니다.

자동화 트리거가 서비스 버스의 메시지로 변환되는 방법은 아래 예를 참조하십시오.

automation:
  - alias: Sunset Service Bus message
    trigger:
      platform: sun
      event: sunset
    action:
      service: notify.test_queue
      data:
        message: "Sun is going down"
        title: "Good evening"
        data:
          sun_direction: "Down"
          custom_field: 123
          custom_object:
            trigger_more: true
            explain: "Its starting to get dark"

queue 또는 topic subscription에서 검색 할 수있는 메시지 :

{
  "message": "Sun is going down",
  "title": "Good evening",
  "sun_direction": "Down",
  "custom_field": 123,
  "custom_object": {
    "trigger_more": true,
    "explain": "Its starting to get dark"
  }
}