Criar e excluir rotas e pontos de extremidade usando a CLI do Azure

1. Crie um namespace de Hubs de Eventos e um hub de eventos. Para mais informações, consulte Quickstart: Criar um hub de eventos usando Azure CLI.

2. Crie uma regra de autorização que seja usada para dar permissão ao IoT Hub para enviar dados para o event hub.

   Gorjeta

   O valor name do parâmetro RootManageSharedAccessKey é o nome padrão que permite as permissões Gerir, Enviar, Ouvir (acesso). Se você quiser restringir as declarações, dê ao name parâmetro seu próprio nome exclusivo e inclua o --rights sinalizador seguido por uma das declarações. Por exemplo, --name my-name --rights Send.

   az eventhubs eventhub authorization-rule create --resource-group my-resource-group --namespace-name my-routing-namespace --eventhub-name my-event-hubs --name RootManageSharedAccessKey
   

   Para obter mais informações, consulte Autorizar acesso aos Hubs de Eventos do Azure.

1. Crie um espaço de nomes e uma fila do Service Bus. Para obter mais informações, consulte Usar a CLI do Azure para criar um namespace do Service Bus e uma fila.

2. Crie uma regra de autorização que dê permissão ao IoT Hub para enviar dados para a fila. Para name, use um valor exclusivo para sua regra de autorização.

   az servicebus queue authorization-rule create --resource-group my-resource-group --namespace-name my-namespace --queue-name my-queue --name my-auth-rule --rights Listen
   

   Para obter mais opções de regra de autorização, consulte az servicebus queue authorization-rule create.

Crie um namespace, tópico e assinatura do Service Bus. Para obter mais informações, consulte Usar a CLI do Azure para criar um tópico do Service Bus e assinaturas para o tópico.

1. Criar uma conta de armazenamento. Para obter mais informações, consulte Criar uma conta de armazenamento do Azure.

2. Crie um contêiner em sua conta de armazenamento. Para obter mais informações, consulte Gerenciar contêineres de blob usando a CLI do Azure

Crie uma conta do Cosmos DB para a API SQL e um contêiner do Cosmos DB. Para obter mais informações, consulte Criar um Azure Cosmos DB para NoSQL.

Para criar um ponto de extremidade do Event Hubs, utilize a regra de autorização que criou nos pré-requisitos.

1. Use o comando az eventhubs eventhub authorization-rule keys list para listar sua regra de autorização. Forneça os seguintes valores para as variáveis de substituição:

   parâmetro	valor
   eventhub_group	Grupo de recursos do hub de eventos.
   eventhub_namespace	Nome do namespace Hubs de Eventos.
   eventhub_name	Nome do hub de eventos.
   rule_name	O nome da regra de autorização para o hub de eventos. Se você copiou o exemplo nos pré-requisitos, esse nome é RootManageSharedAccessKey.

   az eventhubs eventhub authorization-rule keys list --resource-group {eventhub_group} --namespace-name {eventhub_namespace} --eventhub-name my-event-hubs --name {rule_name}
   

2. Copie a sua cadeia de conexão do hub de eventos a partir da saída.

3. Use o comando az iot hub message-endpoint create eventhub para criar o seu ponto de extremidade personalizado. Forneça os seguintes valores para as variáveis de substituição:

   parâmetro	valor
   iothub_name	O nome do hub IoT onde esse ponto de extremidade está sendo criado.
   endpoint_name	Um nome único para o novo ponto de extremidade.
   eventhub_subscription	ID de assinatura do hub de eventos. Esse argumento pode ser deixado de lado se o hub de eventos estiver na mesma assinatura que o hub IoT.
   eventhub_group	Grupo de recursos do hub de eventos. Esse argumento pode ser deixado de lado se o hub de eventos estiver no mesmo grupo de recursos que o hub IoT.
   eventhub_connection_string	A cadeia de conexão que copiaste da regra de autorização do hub de eventos.

   az iot hub message-endpoint create eventhub --hub-name {iothub_name} --endpoint-name {endpoint_name}  --connection-string "{eventhub_connection_string}" --endpoint-subscription-id {eventhub_subscription} --endpoint-resource-group {eventhub_group}
   

Para criar um ponto de extremidade de fila do Service Bus, use a regra de autorização que você criou nos pré-requisitos.

1. Use o comando az servicebus queue authorization-rule keys list para obter a sua cadeia de conexão de fila do Service Bus. Forneça os seguintes valores para as variáveis de substituição:

   parâmetro	valor
   queue_group	Grupo de recursos da fila do Service Bus.
   queue_namespace	Nome do namespace da fila do Service Bus.
   queue_name	Nome da fila.
   rule_name	O nome da regra de autorização para a fila. Se você copiou o exemplo nos pré-requisitos, esse nome é my-auth-rule.

   az servicebus queue authorization-rule keys list --resource-group {queue_group} --namespace-name {queue_namespace} --queue-name {queue_name} --name {rule_name}
   

2. Copie a cadeia de conexão da fila do Service Bus a partir da saída.

3. Use o comando az iot hub message-endpoint create servicebus-queue para criar o seu endpoint personalizado. Forneça os seguintes valores para as variáveis de substituição:

   parâmetro	valor
   iothub_name	O nome do hub IoT onde esse ponto de extremidade está sendo criado.
   endpoint_name	Um nome único para o novo ponto de extremidade.
   queue_connection_string	A cadeia de conexão que você copiou da regra de autorização de fila do Service Bus.
   queue_subscription	ID de assinatura da fila do Service Bus. Esse argumento pode ser omitido se a fila estiver na mesma assinatura que o hub IoT.
   queue_group	Grupo de recursos da fila do Service Bus. Esse argumento pode ser deixado de fora se a fila estiver no mesmo grupo de recursos que o hub IoT.

   az iot hub message-endpoint create servicebus-queue --hub-name {iothub_name} --endpoint-name {endpoint_name} --connection-string "Endpoint={queue_connection_string}" --endpoint-resource-group {queue_group} --endpoint-subscription-id {queue_subscription}
   

1. Use o comando az servicebus topic authorization-rule keys list para obter a sua cadeia de conexão de tópico do Service Bus. O nome padrão da regra de autorização que vem com um novo namespace é RootManageSharedAccessKey. Forneça os seguintes valores para as variáveis de substituição:

   parâmetro	valor
   topic_group	Grupo de recursos do tópico Service Bus.
   topic_namespace	Nome do namespace do tópico do Service Bus.
   topic_name	Nome do tópico.

   az servicebus topic authorization-rule keys list --resource-group {topic_group} --namespace-name {topic_namespace} --topic-name {topic_name} --name RootManageSharedAccessKey
   

2. Copie a cadeia de conexão do tópico do Service Bus a partir da saída.

3. Use o comando az iot hub message-endpoint create servicebus-topic para criar o seu endpoint personalizado. Forneça os seguintes valores para as variáveis de substituição:

   parâmetro	valor
   iothub_name	O nome do hub IoT onde esse ponto de extremidade está sendo criado.
   endpoint_name	Um nome único para o novo ponto de extremidade.
   topic_connection_string	A cadeia de conexão que você copiou da regra de autorização de tópico do Service Bus.
   subscrição_de_tópico	ID de subscrição do tópico do Service Bus. Esse argumento pode ser deixado de lado se o tópico estiver na mesma assinatura que o hub IoT.
   topic_group	Grupo de recursos do tópico Service Bus. Esse argumento pode ser deixado de lado se o tópico estiver no mesmo grupo de recursos que o hub IoT.

   az iot hub message-endpoint create servicebus-topic --hub-name {iothub_name} --endpoint-name {endpoint_name} --connection-string "Endpoint={topic_connection_string};EntityPath=my-service-bus-topic --endpoint-resource-group {topic_group} --endpoint-subscription-id {topic_subscription}
   

1. Utilize o comando az storage account show-connection-string para obter a cadeia de conexão do seu recurso de Armazenamento do Azure e criar um ponto final. Forneça os seguintes valores para as variáveis de substituição:

   parâmetro	valor
   grupo_armazenamento	Grupo de recursos da conta de armazenamento.
   storage_name	Nome da conta de armazenamento.

   az storage account show-connection-string --resource-group my-resource-group --name my-storage-account 
   

2. Copie a cadeia de conexão da conta de armazenamento da saída.

3. Utilize o comando az iot hub message-endpoint create storage-container para criar um novo ponto de extremidade do Armazenamento do Azure. Para todos os outros parâmetros, use valores para seu cenário. Forneça os seguintes valores para as variáveis de substituição:

   parâmetro	valor
   iothub_name	O nome do hub IoT onde esse ponto de extremidade está sendo criado.
   endpoint_name	Um nome único para o novo ponto de extremidade.
   storage_connection_string	A cadeia de conexão que copiaste do comando da conta de armazenamento.
   container_name	O nome do contentor na sua conta de armazenamento onde os dados são enviados.
   subscrição_de_armazenamento	ID de assinatura do armazenamento do Service Bus. Esse argumento pode ser deixado de lado se o armazenamento estiver na mesma assinatura que o hub IoT.
   grupo_armazenamento	Grupo de recursos de armazenamento do Service Bus. Esse argumento pode ser deixado de lado se o tópico estiver no mesmo grupo de recursos que o hub IoT.

   az iot hub message-endpoint create storage-container--hub-name {iothub_name} --endpoint-name {endpoint_name} --container {container_name} --endpoint-resource-group {storage_group} --connection-string "DefaultEndpointsProtocol={storage_connection_string}" --endpoint-subscription-id {storage_subscription} --resource-group {storage_group}
   

1. Use o comando az cosmosdb keys list para obter a cadeia de conexão da sua conta de banco de dados do Cosmos DB.

   az cosmosdb keys list --name my-cosmosdb-account --resource-group my-resource-group --type connection-strings
   

2. Copie a sua string de conexão do Cosmos DB a partir da saída.

3. Use o comando az iot hub message-endpoint create cosmosdb-container para criar o seu endpoint personalizado. Forneça os seguintes valores para as variáveis de substituição:

   parâmetro	valor
   iothub_name	O nome do hub IoT onde esse ponto de extremidade está sendo criado.
   endpoint_name	Um nome único para o novo ponto de extremidade.
   cosmosdb_connection_string	A cadeia de conexão que você copiou do comando de conta do Cosmos DB.
   container_name	O nome do contentor na sua conta Cosmos DB onde os dados são enviados.
   database_name	O nome da base de dados na tua conta Cosmos DB onde os dados são enviados.
   cosmosdb_subscription	ID de assinatura da conta de banco de dados do Cosmos DB. Esse argumento pode ser deixado de lado se o banco de dados estiver na mesma assinatura que o hub IoT.
   cosmosdb_group	Grupo de recursos da conta de banco de dados do Cosmos DB. Esse argumento pode ser deixado de fora se o banco de dados estiver no mesmo grupo de recursos que o hub IoT.

   az iot hub message-endpoint create cosmosdb-container --hub-name {iothub_name} --endpoint-name {endpoint_name} --connection-string "{cosmosdb_connection_string}" --container {container_name} --database-name {database_name} --resource-group my-resource-group --endpoint-account my-cosmosdb-account --container my-cosmosdb-database-container
   

   Nota

   Se estiver a usar identidades geridas em vez de uma string de ligação, use o comando az cosmosdb sql role assignment create para autenticar a sua identidade na conta do Cosmos DB.

   az cosmosdb sql role assignment create -a my-cosmosdb-account -g my-resource-group --scope '/' -n 'Cosmos DB Built-in Data Contributor' -p "IoT Hub System Assigned or User Assigned Identity"