MQTT 데이터 흐름 엔드포인트 구성

1. 운영 환경에서 데이터 흐름 엔드포인트를 선택합니다.

2. 설정을 보거나 편집하려면 기본 엔드포인트를 선택합니다.

   

az iot ops 데이터 흐름 엔드포인트 적용 명령을 사용하여 기본 MQTT broker 데이터 흐름 엔드포인트를 만들거나 변경합니다.

az iot ops dataflow endpoint apply --resource-group <ResourceGroupName> --instance <AioInstanceName> --name default --config-file <ConfigFilePathAndName>

--config-file 매개 변수는 리소스 속성을 포함하는 JSON 구성 파일의 경로 및 파일 이름입니다.

이 예제에서는 사용자의 홈 디렉터리에 저장된 다음 콘텐츠로 명명 default-mqtt-endpoint.json 된 구성 파일을 가정합니다.

{
    "endpointType": "Mqtt",
    "mqttSettings": {
        "host": "aio-broker:18883",
        "authentication": {
            "method": "ServiceAccountToken",
            "serviceAccountTokenSettings": {
                "audience": "aio-internal"
            }
        },
        "tls": {
            "mode": "Enabled",
            "trustedCaCertificateConfigMapRef": "azure-iot-operations-aio-ca-trust-bundle"
        }
    }
}

다음은 기본 MQTT broker 데이터 흐름 엔드포인트를 만들거나 업데이트하는 예제 명령입니다.

az iot ops dataflow endpoint apply --resource-group myResourceGroup --instance myAioInstance --name default --config-file ~/default-mqtt-endpoint.json

기본 엔드포인트를 편집하려면 다음 콘텐츠가 포함된 Bicep .bicep 파일을 만듭니다. 필요에 따라 설정을 업데이트하고 <AIO_INSTANCE_NAME>과 같은 자리 표시자 값을 원하는 값으로 바꿉니다.

param aioInstanceName string = '<AIO_INSTANCE_NAME>'
param customLocationName string = '<CUSTOM_LOCATION_NAME>'

resource aioInstance 'Microsoft.IoTOperations/instances@2024-11-01' existing = {
  name: aioInstanceName
}
resource customLocation 'Microsoft.ExtendedLocation/customLocations@2021-08-31-preview' existing = {
  name: customLocationName
}
resource defaultMqttBrokerDataflowEndpoint 'Microsoft.IoTOperations/instances/dataflowEndpoints@2024-11-01' = {
  parent: aioInstance
  name: 'default'
  extendedLocation: {
    name: customLocation.id
    type: 'CustomLocation'
  }
  properties: {
    endpointType: 'Mqtt'
    mqttSettings: {
      host: 'aio-broker:18883'
      authentication: {
        method: 'ServiceAccountToken'
        serviceAccountTokenSettings: {
          audience: 'aio-internal'
        }
      }
      tls: {
        mode: 'Enabled'
        trustedCaCertificateConfigMapRef: 'azure-iot-operations-aio-ca-trust-bundle'
      }
    }
  }
}

그런 다음 Azure CLI를 통해 배포합니다.

az deployment group create --resource-group <RESOURCE_GROUP> --template-file <FILE>.bicep

Kubernetes 클러스터에서 기본 MQTT 브로커 엔드포인트 설정을 볼 수 있습니다. 설정을 보려면 다음 명령을 사용합니다.

kubectl get dataflowendpoint default -n azure-iot-operations -o yaml

1. 운영 환경에서 데이터 흐름 엔드포인트를 선택합니다.

2. 새 데이터 흐름 엔드포인트 만들기에서 Azure IoT 작업 로컬 MQTT>새로 만들기를 선택합니다.

   

   엔드포인트에 대해 다음 설정을 입력합니다.

   설정	설명
   이름	데이터 흐름 엔드포인트의 이름입니다.
   호스트	MQTT 브로커의 호스트 이름과 포트입니다. <hostname>:<port> 형식 사용
   인증 방법	인증에 사용되는 방법입니다. 서비스 계정 토큰 또는 X509 인증서를 선택합니다.
   서비스 대상 그룹	서비스 계정 토큰의 대상 그룹입니다. 서비스 계정 토큰을 사용하는 경우 필요합니다.
   X509 클라이언트 인증서	인증에 사용되는 X.509 클라이언트 인증서입니다. X509 인증서를 사용하는 경우 필요합니다. 업계 표준 다중 라인 X509 인증서를 업로드하여 디바이스 인증 관리, 보안 및 유연성을 개선할 수 있습니다.
   X509 클라이언트 키	X.509 클라이언트 인증서에 해당하는 프라이빗 키입니다. X509 인증서를 사용하는 경우 필요합니다.
   X509 중간 인증서	X.509 클라이언트 인증서 체인에 대한 중간 인증서입니다. X509 인증서를 사용하는 경우 필요합니다.

만들기 또는 바꾸기

az iot ops 데이터 흐름 엔드포인트 create fabric-onelake 명령을 사용하여 로컬 MQTT broker 데이터 흐름 엔드포인트를 만들거나 바꿉니다.

az iot ops dataflow endpoint create local-mqtt --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName> --port <Port> --host <Host>

이 명령은 기본 설정을 사용하여 로컬 MQTT broker 엔드포인트를 만듭니다. 필요에 따라 추가 옵션을 지정할 수 있습니다.

다음은 이름이 지정된 로컬 MQTT broker 데이터 흐름 엔드포인트를 만들거나 바꾸는 예제 명령입니다 local-mqtt-endpoint.

az iot ops dataflow endpoint create local-mqtt --resource-group myResourceGroup --instance myAioInstance --name local-mqtt-endpoint --port 1883 --host aio-broker --auth-type ServiceAccountToken --audience aio-internal

만들기 또는 변경

az iot ops 데이터 흐름 엔드포인트 적용 명령을 사용하여 로컬 MQTT broker 데이터 흐름 엔드포인트를 만들거나 변경합니다.

az iot ops dataflow endpoint apply --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName> --config-file <ConfigFilePathAndName>

--config-file 매개 변수는 리소스 속성을 포함하는 JSON 구성 파일의 경로 및 파일 이름입니다.

이 예제에서는 사용자의 홈 디렉터리에 저장된 다음 콘텐츠로 명명 local-mqtt-endpoint.json 된 구성 파일을 가정합니다.

{
    "endpointType": "Mqtt",
    "mqttSettings": {
        "host": "aio-broker:1883",
        "authentication": {
            "method": "ServiceAccountToken",
            "serviceAccountTokenSettings": {
                "audience": "aio-internal"
            }
        },
        "tls": {
            "mode": "Enabled",
            "trustedCaCertificateConfigMapRef": "azure-iot-operations-aio-ca-trust-bundle"
        }
    }
}

다음은 이름이 지정된 로컬 MQTT broker 데이터 흐름 엔드포인트를 만들거나 업데이트하는 예제 명령입니다 local-mqtt-endpoint.

az iot ops dataflow endpoint apply --resource-group myResourceGroup --instance myAioInstance --name local-mqtt-endpoint --config-file ~/local-mqtt-endpoint.json

param aioInstanceName string = '<AIO_INSTANCE_NAME>'
param customLocationName string = '<CUSTOM_LOCATION_NAME>'
param endpointName string = '<ENDPOINT_NAME>'
param mqttBrokerHostname string = '<HOSTNAME>:<PORT>'
param trustedCA string = '<TRUST_BUNDLE>'
param serviceAccountAudience string = '<SA_AUDIENCE>'

resource aioInstance 'Microsoft.IoTOperations/instances@2024-11-01' existing = {
  name: aioInstanceName
}
resource customLocation 'Microsoft.ExtendedLocation/customLocations@2021-08-31-preview' existing = {
  name: customLocationName
}
resource MqttBrokerDataflowEndpoint 'Microsoft.IoTOperations/instances/dataflowEndpoints@2024-11-01' = {
  parent: aioInstance
  name: endpointName
  extendedLocation: {
    name: customLocation.id
    type: 'CustomLocation'
  }
  properties: {
    endpointType: 'Mqtt'
    mqttSettings: {
      host: mqttBrokerHostname
      authentication: {
        method: 'ServiceAccountToken'
        serviceAccountTokenSettings: {
          audience: serviceAccountAudience
        }
      }
      tls: {
        mode: 'Enabled'
        trustedCaCertificateConfigMapRef: trustedCA
      }
    }
  }
}

apiVersion: connectivity.iotoperations.azure.com/v1
kind: DataflowEndpoint
metadata:
  name: <ENDPOINT_NAME>
  namespace: azure-iot-operations
spec:
  endpointType: Mqtt
  mqttSettings:
    host: "<HOSTNAME>:<PORT>"
    tls:
      mode: Enabled
      trustedCaCertificateConfigMapRef: <TRUST_BUNDLE>
    authentication:
      method: ServiceAccountToken
      serviceAccountTokenSettings:
        audience: <SA_AUDIENCE>

1. 운영 환경에서 데이터 흐름 엔드포인트 탭을 선택합니다.

2. 새 데이터 흐름 엔드포인트 만들기에서 Azure Event Grid MQTT>새로 만들기를 선택합니다.

   

   엔드포인트에 대해 다음 설정을 입력합니다.

   설정	설명
   이름	데이터 흐름 엔드포인트의 이름입니다.
   호스트	Event Grid MQTT 브로커의 호스트 이름과 포트입니다. <NAMESPACE>.<REGION>-1.ts.eventgrid.azure.net:8883 형식 사용
   인증 방법	인증에 사용되는 방법입니다. 시스템이 할당한 관리 ID 또는 사용자가 할당한 관리 ID를 선택하는 것이 좋습니다.

3. 적용을 선택하여 엔드포인트를 프로비전합니다.

만들기 또는 바꾸기

az iot ops 데이터 흐름 엔드포인트 create eventgrid 명령을 사용하여 Azure Event Grid MQTT 데이터 흐름 엔드포인트를 만들거나 바꿉니다.

az iot ops dataflow endpoint create eventgrid --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName> --host <Namespace>.<Region>-1.ts.eventgrid.azure.net --port 9092

이 명령은 기본 설정 및 시스템 할당 관리 ID 인증을 사용하여 Event Grid MQTT broker 엔드포인트를 만듭니다. 필요에 따라 추가 옵션을 지정할 수 있습니다.

다음은 Event Grid MQTT broker 데이터 흐름 엔드포인트를 만들거나 바꾸는 예제 명령입니다 event-grid-endpoint.

az iot ops dataflow endpoint create eventgrid --resource-group myResourceGroup --instance myAioInstance --name event-grid-endpoint --host mynamespace.eastus-1.ts.eventgrid.azure.net --port 9092

만들기 또는 변경

az iot ops 데이터 흐름 엔드포인트 적용 명령을 사용하여 Azure Event Grid MQTT broker 데이터 흐름 엔드포인트를 만들거나 변경합니다.

az iot ops dataflow endpoint apply --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName> --config-file <ConfigFilePathAndName>

--config-file 매개 변수는 리소스 속성을 포함하는 JSON 구성 파일의 경로 및 파일 이름입니다.

이 예제에서는 사용자의 홈 디렉터리에 저장된 다음 콘텐츠로 명명 event-grid-endpoint.json 된 구성 파일을 가정합니다.

{
    "endpointType": "Mqtt",
    "mqttSettings": {
        "host": "mynamespace.eastus-1.ts.eventgrid.azure.net:9092",
        "authentication": {
            "method": "SystemAssignedManagedIdentity",
            "systemAssignedManagedIdentitySettings": {}
        },
        "tls": {
            "mode": "Enabled"
        }
    }
}

다음은 Event Grid MQTT broker 데이터 흐름 엔드포인트를 만들거나 업데이트하는 예제 명령입니다 event-grid-endpoint.

az iot ops dataflow endpoint apply --resource-group myResourceGroup --instance myAioInstance --name event-grid-endpoint --config-file ~/event-grid-endpoint.json

다음 콘텐츠로 Bicep .bicep 파일을 만듭니다.

param aioInstanceName string = '<AIO_INSTANCE_NAME>'
param customLocationName string = '<CUSTOM_LOCATION_NAME>'
param endpointName string = '<ENDPOINT_NAME>'
param eventGridHostName string = '<NAMESPACE>.<REGION>-1.ts.eventgrid.azure.net:8883'

resource aioInstance 'Microsoft.IoTOperations/instances@2024-11-01' existing = {
  name: aioInstanceName
}
resource customLocation 'Microsoft.ExtendedLocation/customLocations@2021-08-31-preview' existing = {
  name: customLocationName
}
resource remoteMqttBrokerDataflowEndpoint 'Microsoft.IoTOperations/instances/dataflowEndpoints@2024-11-01' = {
  parent: aioInstance
  name: endpointName
  extendedLocation: {
    name: customLocation.id
    type: 'CustomLocation'
  }
  properties: {
    endpointType: 'Mqtt'
    mqttSettings: {
      host: eventGridHostName
      authentication: {
        // See available authentication methods section for method types
        // method: <METHOD_TYPE>
      }
      tls: {
        mode: 'Enabled'
      }
    }
  }
}

그런 다음 Azure CLI를 통해 배포합니다.

az deployment group create --resource-group <RESOURCE_GROUP> --template-file <FILE>.bicep

다음 콘텐츠로 Kubernetes 매니페스트 .yaml 파일을 만듭니다.

apiVersion: connectivity.iotoperations.azure.com/v1
kind: DataflowEndpoint
metadata:
  name: <ENDPOINT_NAME>
  namespace: azure-iot-operations
spec:
  endpointType: Mqtt
  mqttSettings:
    host: <NAMESPACE>.<REGION>-1.ts.eventgrid.azure.net:8883
    authentication:
      # See available authentication methods section for method types
      # method: <METHOD_TYPE>
    tls:
      mode: Enabled

그런 다음 매니페스트 파일을 Kubernetes 클러스터에 적용합니다.

kubectl apply -f <FILE>.yaml

1. 운영 환경에서 데이터 흐름 엔드포인트 탭을 선택합니다.

2. 새 데이터 흐름 엔드포인트 만들기에서 사용자 지정 MQTT 브로커>새로 만들기를 선택합니다.

   

3. 엔드포인트에 대해 다음 설정을 입력합니다.

   설정	설명
   이름	데이터 흐름 엔드포인트의 이름
   호스트	<hostname>.<port> 형식의 MQTT 브로커 엔드포인트의 호스트 이름입니다.
   인증 방법	인증에 사용되는 방법입니다. 서비스 계정 토큰 또는 X509 인증서를 선택합니다.
   서비스 대상 그룹	서비스 계정 토큰의 대상 그룹입니다. 서비스 계정 토큰을 사용하는 경우 필요합니다.
   X509 클라이언트 인증서	인증에 사용되는 X.509 클라이언트 인증서입니다. X509 인증서를 사용하는 경우 필요합니다. 업계 표준 다중 라인 X509 인증서를 업로드하여 디바이스 인증 관리, 보안 및 유연성을 개선할 수 있습니다.
   X509 클라이언트 키	X.509 클라이언트 인증서에 해당하는 프라이빗 키입니다. X509 인증서를 사용하는 경우 필요합니다.
   X509 중간 인증서	X.509 클라이언트 인증서 체인에 대한 중간 인증서입니다. X509 인증서를 사용하는 경우 필요합니다.

4. 적용을 선택하여 엔드포인트를 프로비전합니다.

만들기 또는 바꾸기

az iot ops 데이터 흐름 엔드포인트 create custom-mqtt 명령을 사용하여 사용자 지정 MQTT broker 데이터 흐름 엔드포인트를 만들거나 바꿉니다.

az iot ops dataflow endpoint create custom-mqtt --resource-group <ResourceGroupName> --instance <AioInstanceName>  --name <EndpointName> --host <Host> --port <Port>

이 명령은 기본 설정 및 시스템 할당 관리 ID 인증을 사용하여 사용자 지정 MQTT broker 엔드포인트를 만듭니다. 필요에 따라 추가 옵션을 지정할 수 있습니다.

다음은 이름이 지정된 사용자 지정 MQTT Broker 데이터 흐름 엔드포인트를 만들거나 바꾸는 예제 명령입니다 custom-mqtt-endpoint.

az iot ops dataflow endpoint create custom-mqtt --resource-group myResourceGroup --instance myAioInstance --name custom-mqtt-endpoint --host mycustombroker.contoso.com --port 8883

만들기 또는 변경

az iot ops 데이터 흐름 엔드포인트 적용 명령을 사용하여 사용자 지정 MQTT broker 데이터 흐름 엔드포인트를 만들거나 변경합니다.

az iot ops dataflow endpoint apply --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName> --config-file <ConfigFilePathAndName>

--config-file 매개 변수는 리소스 속성을 포함하는 JSON 구성 파일의 경로 및 파일 이름입니다.

이 예제에서는 사용자의 홈 디렉터리에 저장된 다음 콘텐츠로 명명 custom-mqtt-endpoint.json 된 구성 파일을 가정합니다.

{
    "endpointType": "Mqtt",
    "mqttSettings": {
        "host": "mycustombroker.contoso.com:8883",
        "authentication": {
          "method": "SystemAssignedManagedIdentity",
          "systemAssignedManagedIdentitySettings": {}
        },
        "tls": {
            "mode": "Enabled"
        }
    }
}

다음은 이름이 지정된 사용자 지정 MQTT broker 데이터 흐름 엔드포인트를 만들거나 업데이트하는 예제 명령입니다 custom-mqtt-endpoint.

az iot ops dataflow endpoint apply --resource-group myResourceGroup --instance myAioInstance --name custom-mqtt-endpoint --config-file ~/custom-mqtt-endpoint.json

mqttSettings: {
  authentication: {
    // See available authentication methods section for method types
    // method: <METHOD_TYPE>
  }
  host: '<HOST>:<PORT>'
  tls: {
    mode: 'Enabled' // or 'Disabled'
    trustedCaCertificateConfigMapRef: '<TRUSTED_CA_CERT_CONFIGMAP>'
  }
}

spec:
  endpointType: Mqtt
  mqttSettings:
    host: <HOST>:<PORT>
    authentication:
      # See available authentication methods section for method types
      # method: <METHOD_TYPE>
    tls:
      mode: Enabled # or Disabled
      trustedCaCertificateConfigMapRef: <TRUSTED_CA_CERT_CONFIGMAP>

운영 환경 데이터 흐름 엔드포인트 설정 페이지에서 기본 탭을 선택한 다음 인증 방법>시스템이 할당한 관리 ID를 선택합니다.

만들기 또는 바꾸기

시스템에서 할당한 관리 ID 인증을 위해 매개 변수를 --auth-type로 설정하여 SystemAssignedManagedIdentity 명령을 사용합니다.

az iot ops dataflow endpoint create <Command> --auth-type SystemAssignedManagedIdentity --audience <Audience> --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName>

만들기 또는 변경

az iot ops 데이터 흐름 엔드포인트 apply 명령을 --config-file 매개 변수와 함께 사용합니다.

이 예제에서는 다음 콘텐츠가 포함된 구성 파일을 가정합니다.

{
    "endpointType": "Mqtt",
    "mqttSettings": {
        "host": "mycustombroker.contoso.com:8883",
        "authentication": {
          "method": "SystemAssignedManagedIdentity",
          "systemAssignedManagedIdentitySettings": {}
        },
        "tls": {
            "mode": "Enabled"
        }
    }
}

mqttSettings: {
  authentication: {
    method: 'SystemAssignedManagedIdentity'
    systemAssignedManagedIdentitySettings: {}
  }
}

mqttSettings:
  authentication:
    method: SystemAssignedManagedIdentity
    systemAssignedManagedIdentitySettings:
      {}

운영 환경 데이터 흐름 엔드포인트 설정 페이지에서 기본 탭을 선택한 다음 인증 방법>사용자가 할당한 관리 ID를 선택합니다.

만들기 또는 바꾸기

사용자가 할당한 관리 ID 인증을 위해 az iot ops 데이터 흐름 엔드포인트 만들기 명령에서 --auth-type 매개 변수를 UserAssignedManagedIdentity로 설정하여 사용합니다.

az iot ops dataflow endpoint create <Command> --auth-type UserAssignedManagedIdentity --client-id <ClientId> --tenant-id <TenantId> --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName>

만들기 또는 변경

az iot ops 데이터 흐름 엔드포인트 적용을 --config-file 매개 변수와 함께 사용하십시오.

이 예제에서는 다음 콘텐츠가 포함된 구성 파일을 가정합니다.

{
    "endpointType": "Mqtt",
    "mqttSettings": {
        "authentication": {
          "method": "UserAssignedManagedIdentity",
          "userAssignedManagedIdentitySettings": {
            "clientId": "<ID>",
            "tenantId": "<ID>",
            // Optional
            "scope": "https://<Scope_Url>"
          }
        }
    }
}

mqttSettings: {
  authentication: {
    method: 'UserAssignedManagedIdentity'
    userAssignedManagedIdentitySettings: {
      clientId: '<ID>'
      tenantId: '<ID>'
      // Optional, defaults to 'https://eventgrid.azure.net/.default'
      // scope: 'https://<SCOPE_URL>' 
    }
  }
}

mqttSettings:
  authentication:
    method: UserAssignedManagedIdentity
    userAssignedManagedIdentitySettings:
      clientId: <ID>
      tenantId: <ID>
      # Optional, defaults to 'https://eventgrid.azure.net/.default'
      # scope: https://<SCOPE_URL>

운영 환경 데이터 흐름 엔드포인트 설정 페이지에서 기본 탭을 선택한 다음 인증 방법>서비스 계정 토큰을 선택합니다.

서비스 대상 그룹 고객이 등장했습니다.

만들기 또는 바꾸기

Kubernetes 서비스 계정 토큰 인증을 위해 로 설정된 --auth-type 매개 변수를 사용하여 ServiceAccountToken 명령을 실행합니다.

az iot ops dataflow endpoint create <Command> --auth-type ServiceAccountToken --audience <Audience> --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName>

만들기 또는 변경

az iot ops 데이터플로우 엔드포인트 apply를 --config-file 매개 변수로 사용하세요.

이 예제에서는 다음 콘텐츠가 포함된 구성 파일을 가정합니다.

{
    "endpointType": "Mqtt",
    "mqttSettings": {
        "authentication": {
          "method": "ServiceAccountToken",
          "serviceAccountTokenSettings": {
            "audience": "<ServiceAccountAudience>"
          }
        }
    }
}

mqttSettings: {
  authentication: {
    method: 'ServiceAccountToken'
    serviceAccountTokenSettings: {
      audience: '<YOUR_SERVICE_ACCOUNT_AUDIENCE>'
    }
  }
}

mqttSettings:
  authentication:
    method: ServiceAccountToken
    serviceAccountTokenSettings:
      audience: <YOUR_SERVICE_ACCOUNT_AUDIENCE>

운영 환경 데이터 흐름 엔드포인트 설정 페이지에서 기본 탭을 선택한 다음 인증 방법>X509 인증서를 선택합니다.

여기에서 동기화된 비밀 이름에 비밀 이름을 입력합니다. 이 이름은 데이터 흐름 엔드포인트 설정에서 비밀을 참조하는 데 사용되며 Kubernetes 클러스터에 저장된 비밀의 이름입니다.

그런 다음 X509 클라이언트 인증서, X509 클라이언트 키 및 X509 중간 인증서에서 참조 추가를 선택하여 인증서, 프라이빗 키 및 중간 인증서를 추가합니다. 다음 페이지에서 Azure Key Vault에서 추가 또는 새로 만들기 비밀을 사용하여 Azure Key Vault의 비밀을 선택합니다.

새로 만들기를 선택한 경우 다음 설정을 입력합니다.

비밀에 대해 자세히 알아보려면 Azure IoT 작업에서 비밀 만들기 및 관리를 참조하세요.

만들기 또는 바꾸기

az iot ops 데이터 흐름 엔드포인트 만들기 명령을 X.509 인증서 인증에 대해 --auth-type 매개 변수로 설정된 X509Certificate와 함께 사용합니다.

az iot ops dataflow endpoint create <Command> --auth-type X509Certificate --secret-name <X509SecretName> --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName>

만들기 또는 변경

az iot ops 데이터플로우 엔드포인트 apply를 --config-file 매개 변수로 사용하세요.

이 예제에서는 다음 콘텐츠가 포함된 구성 파일을 가정합니다.

{
    "endpointType": "Mqtt",
    "mqttSettings": {
        "authentication": {
          "method": "X509Certificate",
          "x509CertificateSettings": {
            "secretRef": "<X509SecretName>"
          }
        }
    }
}

mqttSettings: {
  authentication: {
    method: 'X509Certificate'
      x509CertificateSettings:
        secretRef: '<X509_SECRET_NAME>'
  }
}

mqttSettings:
  authentication:
    method: X509Certificate
    x509CertificateSettings:
      secretRef: <X509_SECRET_NAME>

작업 환경 데이터 흐름 엔드포인트 설정 페이지에서 기본 탭을 선택한 다음 인증 방법>없음을 선택합니다.

만들기 또는 바꾸기

익명 인증을 위한 매개 변수와 함께 --no-auth 명령을 사용합니다.

az iot ops dataflow endpoint create <Command> --no-auth --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName>

만들기 또는 변경

az iot ops 데이터플로우 엔드포인트 apply를 --config-file 매개 변수로 사용하세요.

이 예제에서는 다음 콘텐츠가 포함된 구성 파일을 가정합니다.

{
    "endpointType": "Mqtt",
    "mqttSettings": {
        "authentication": {
          "method": "Anonymous"
        }
    }
}

mqttSettings: {
  authentication: {
    method: 'Anonymous'
  }
}

mqttSettings:
  authentication:
    method: Anonymous
    anonymousSettings:
      {}

운영 환경에서 데이터 흐름 엔드포인트에 대한 고급 탭을 선택합니다.

{
    "mqttSettings": {
        "qos": 1,
        "retain": "Keep",
        "sessionExpirySeconds": 3600,
        "keepAliveSeconds": 60,
        "maxInflightMessages": 100,
        "protocol": "WebSockets",
        "clientIdPrefix": "dataflow",
        "cloudEventAttributes": "Propagate",
        "tls": {
          "mode": "Enabled"
        }
    }
}

// See sections below for explanation of each setting
mqttSettings: {
  qos: 1
  retain: 'Keep'
  sessionExpirySeconds: 3600
  keepAliveSeconds: 60
  maxInflightMessages: 100
  protocol: WebSockets
  clientIdPrefix: 'dataflow'
  cloudEventAttributes : 'Propagate' // or 'CreateOrRemap'
}

# See sections below for explanation of each setting
mqttSettings:
  qos: 1
  retain: Keep
  sessionExpirySeconds: 3600
  keepAliveSeconds: 60
  maxInflightMessages: 100
  protocol: WebSockets
  clientIdPrefix: dataflow
  cloudEventAttributes : Propagate # or CreateOrRemap

운영 환경 데이터 흐름 엔드포인트 설정 페이지에서 고급 탭을 선택한 다음 TLS 모드 사용 옆에 있는 확인란을 사용합니다.

{
    "mqttSettings": {
        "tls": {
          "mode": "Enabled"
        }
    }
}

mqttSettings: {
  tls: {
    mode: 'Enabled' // or 'Disabled'
  }
}

mqttSettings:
  tls:
    mode: Enabled # or Disabled

작업 환경 데이터 흐름 엔드포인트 설정 페이지에서 고급 탭을 선택한 다음 신뢰할 수 있는 CA 인증서 구성 맵 필드를 사용하여 신뢰할 수 있는 CA 인증서가 포함된 ConfigMap을 지정합니다.

mqttSettings: {
  tls: {
    trustedCaCertificateConfigMapRef: '<YOUR_CA_CERTIFICATE>'
  }
}

{
    "mqttSettings": {
        "tls": {
          "trustedCaCertificateConfigMapRef": "<YOUR_CA_CERTIFICATE>"
        }
    }
}

mqttSettings:
  tls:
    trustedCaCertificateConfigMapRef: <YOUR_CA_CERTIFICATE>

작업 환경 데이터 흐름 엔드포인트 설정 페이지에서 고급 탭을 선택한 다음 클라이언트 ID 접두사 필드를 사용하여 접두사를 지정합니다.

{
    "mqttSettings": {
        "clientIdPrefix": "<YOUR_PREFIX>"
    }
}

mqttSettings: {
  clientIdPrefix: '<YOUR_PREFIX>'
}

mqttSettings:
  clientIdPrefix: <YOUR_PREFIX>

작업 환경 데이터 흐름 엔드포인트 설정 페이지에서 고급 탭을 선택한 다음 QoS(서비스 품질) 필드를 사용하여 QoS 수준을 지정합니다.

{
    "mqttSettings": {
        "qos": 1
    }
}

mqttSettings: {
  qos: 1 // Or 0
}

mqttSettings:
  qos: 1 # Or 0

작업 환경 데이터 흐름 엔드포인트 설정 페이지에서 고급 탭을 선택한 다음 보존 필드를 사용하여 보존 설정을 지정합니다.

{
    "mqttSettings": {
        "retain": "Keep"
    }
}

mqttSettings: {
  retain: Keep // or Never
}

mqttSettings:
  retain: Keep # or Never

작업 환경 데이터 흐름 엔드포인트 설정 페이지에서 고급 탭을 선택한 다음 세션 만료 필드를 사용하여 세션 만료 간격을 지정합니다.

{
    "mqttSettings": {
        "sessionExpirySeconds": 600
    }
}

mqttSettings: {
  sessionExpirySeconds: 600
}

mqttSettings:
  sessionExpirySeconds: 600

작업 환경 데이터 흐름 엔드포인트 설정 페이지에서 고급 탭을 선택한 다음 프로토콜 필드를 사용하여 프로토콜을 지정합니다.

{
    "mqttSettings": {
        "protocol": "WebSockets"
    }
}

mqttSettings: {
  protocol: 'WebSockets'
}

mqttSettings:
  protocol: WebSockets

작업 환경 데이터 흐름 엔드포인트 설정 페이지에서 고급 탭을 선택한 다음 최대 처리 중인 메시지 필드를 사용하여 처리 중인 메시지의 최대 수를 지정합니다.

{
    "mqttSettings": {
        "maxInflightMessages": 100
    }
}

mqttSettings: {
  maxInflightMessages: 100
}

mqttSettings:
  maxInflightMessages: 100

작업 환경 데이터 흐름 엔드포인트 설정 페이지에서 고급 탭을 선택한 다음 활성 유지 필드를 사용하여 활성 유지 간격을 지정합니다.

{
    "mqttSettings": {
        "keepAliveSeconds": 60
    }
}

mqttSettings: {
  keepAliveSeconds: 60
}

mqttSettings:
  keepAliveSeconds: 60

운영 환경 데이터 흐름 엔드포인트 설정 페이지에서 고급 탭을 선택한 다음 클라우드 이벤트 특성 필드를 사용하여 CloudEvents 설정을 지정합니다.

{
    "mqttSettings": {
        "cloudEventAttributes": "Propagate"
    }
}

mqttSettings: {
  cloudEventAttributes : 'Propagate' // or 'CreateOrRemap'
}

mqttSettings:
  cloudEventAttributes : Propagate # or CreateOrRemap