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

1. Criar um namespace de Hubs de Eventos e um hub de eventos. Para obter mais informações, confira Início Rápido: criar um hub de eventos usando a CLI do Azure.

2. Crie uma regra de autorização que será usada para conceder permissão ao Hub IoT para enviar dados para o hub de eventos.

   Dica

   O valor name do parâmetro RootManageSharedAccessKey é o nome padrão que permite gerenciar, enviar, ouvir declarações (acesso). Se desejar restringir as declarações, dê ao parâmetro name seu próprio nome exclusivo e inclua o sinalizador --rights seguido de 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 o acesso aos Hubs de Eventos do Azure.

1. Criar um namespace do Barramento de Serviço e da fila. Para obter mais informações, confira Usar a CLI do Azure para criar um namespace e uma fila do Barramento de Serviço.

2. Crie uma regra de autorização que irá conceder permissão ao Hub IoT para enviar dados para a fila. Para name, use um valor exclusivo para a 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, confira az servicebus queue authorization-rule create.

Crie um namespace, um tópico e uma assinatura para o Barramento de Serviço. Para obter mais informações, confira Usar a CLI do Azure para criar um tópico do Barramento de Serviço e assinaturas para o tópico.

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

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 do SQL e um contêiner do Cosmos DB. Para saber mais, confira Criar uma conta do Azure Cosmos DB for NoSQL.

Para criar um ponto de extremidade dos Hubs de Eventos, use a regra de autorização que você 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 valores a seguir para os parâmetros de espaço reservado:

   parâmetro	value
   eventhub_group	Grupo de recursos do hub de eventos.
   eventhub_namespace	Nome do namespace dos 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 será 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 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 seu ponto de extremidade personalizado. Forneça os valores a seguir para os parâmetros de espaço reservado:

   parâmetro	value
   iothub_name	O nome do hub IoT em que esse ponto de extremidade está sendo criado.
   endpoint_name	Um nome exclusivo para o novo ponto de extremidade.
   eventhub_subscription	ID da assinatura do hub de eventos. Esse argumento poderá ser deixado de fora se o hub de eventos estiver na mesma assinatura que o Hub IoT.
   eventhub_group	Grupo de recursos do hub de eventos. Esse argumento poderá ser deixado de fora se o hub de eventos estiver no mesmo grupo de recursos que o Hub IoT.
   eventhub_connection_string	A cadeia de conexão que você copiou 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 da fila do Barramento de Serviço, 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 sua cadeia de conexão da fila do Barramento de Serviço. Forneça os valores a seguir para os parâmetros de espaço reservado:

   parâmetro	value
   queue_group	Grupo de recursos da fila do Barramento de Serviço.
   queue_namespace	Nome do namespace da fila do Barramento de Serviço.
   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 será 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 sua cadeia de conexão da fila do Barramento de Serviço a partir da saída.

3. Use o comando az iot hub message-endpoint create servicebus-queue para criar seu ponto de extremidade personalizado. Forneça os valores a seguir para os parâmetros de espaço reservado:

   parâmetro	value
   iothub_name	O nome do hub IoT em que esse ponto de extremidade está sendo criado.
   endpoint_name	Um nome exclusivo para o novo ponto de extremidade.
   queue_connection_string	A cadeia de conexão que você copiou da regra de autorização da fila do Barramento de Serviço.
   queue_subscription	ID da assinatura da fila do Barramento de Serviço. Esse argumento poderá ser deixado de fora se a fila estiver na mesma assinatura que o Hub IoT.
   queue_group	Grupo de recursos da fila do Barramento de Serviço. Esse argumento poderá 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 a az servicebus topic authorization-rule keys list para obter sua cadeia de conexão do tópico do Barramento de Serviço. O nome padrão da regra de autorização que vem com um novo namespace é RootManageSharedAccessKey. Forneça os valores a seguir para os parâmetros de espaço reservado:

   parâmetro	value
   topic_group	Grupo de recursos do tópico do Barramento de Serviço.
   topic_namespace	Nome do namespace do tópico do Barramento de Serviço.
   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 sua cadeia de conexão do tópico do Barramento de Serviço a partir da saída.

3. Use o comando az iot hub message-endpoint create servicebus-topic para criar seu ponto de extremidade personalizado. Forneça os valores a seguir para os parâmetros de espaço reservado:

   parâmetro	value
   iothub_name	O nome do hub IoT em que esse ponto de extremidade está sendo criado.
   endpoint_name	Um nome exclusivo para o novo ponto de extremidade.
   topic_connection_string	A cadeia de conexão que você copiou da regra de autorização do tópico do Barramento de Serviço.
   topic_subscription	ID da assinatura do tópico do Barramento de Serviço. Esse argumento poderá ser deixado de fora se o tópico estiver na mesma assinatura que o Hub IoT.
   topic_group	Grupo de recursos do tópico do Barramento de Serviço. Esse argumento poderá ser deixado de fora 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. Use o comando az storage account show-connection-string para obter a cadeia de conexão do seu recurso de Armazenamento do Microsoft Azure para criar um ponto de extremidade. Forneça os valores a seguir para os parâmetros de espaço reservado:

   parâmetro	value
   storage_group	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 sua cadeia de conexão da conta de armazenamento a partir da saída.

3. Use o comando az iot hub message-endpoint create storage-container para criar um novo ponto de extremidade do Armazenamento do Microsoft Azure. Para todos os outros parâmetros, use os valores para seu cenário. Forneça os valores a seguir para os parâmetros de espaço reservado:

   parâmetro	value
   iothub_name	O nome do hub IoT em que esse ponto de extremidade está sendo criado.
   endpoint_name	Um nome exclusivo para o novo ponto de extremidade.
   storage_connection_string	A cadeia de conexão que você copiou do comando da conta de armazenamento.
   container_name	O nome do contêiner em sua conta de armazenamento para onde os dados serão enviados.
   storage_subscription	ID da assinatura de armazenamento do Barramento de Serviço. Esse argumento poderá ser deixado de fora se o armazenamento estiver na mesma assinatura que o Hub IoT.
   storage_group	Grupo de recursos do armazenamento do Barramento de Serviço. Esse argumento poderá ser deixado de fora 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 sua cadeia 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 seu ponto de extremidade personalizado. Forneça os valores a seguir para os parâmetros de espaço reservado:

   parâmetro	value
   iothub_name	O nome do hub IoT em que esse ponto de extremidade está sendo criado.
   endpoint_name	Um nome exclusivo para o novo ponto de extremidade.
   cosmosdb_connection_string	A cadeia de conexão que você copiou do comando da conta do Cosmos DB.
   container_name	O nome do contêiner em sua conta do Cosmos DB para onde os dados serão enviados.
   database_name	O nome do banco de dados em sua conta do Cosmos DB para onde os dados serão enviados.
   cosmosdb_subscription	ID da assinatura da conta de banco de dados do Cosmos DB. Esse argumento poderá ser deixado de fora 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 poderá 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
   

   Observação

   Se você estiver usando identidades gerenciadas em vez da cadeia de conexão, use o comando az cosmosdb sql role assignment create para autenticar sua identidade na conta do CosmosDB.

   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"