az iot hub message-endpoint
Note
Essa referência faz parte da extensão azure-iot para a CLI do Azure (versão 2.67.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando az iot hub message-endpoint. Saiba mais sobre extensões.
Esse grupo de comandos está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Gerenciar pontos de extremidade personalizados de um Hub IoT.
Comandos
| Nome | Description | Tipo | Status |
|---|---|---|---|
| az iot hub message-endpoint create |
Adicione um ponto de extremidade a um Hub IoT. |
Extension | Preview |
| az iot hub message-endpoint create cosmosdb-container |
Adicione um ponto de extremidade de contêiner do Cosmos DB para um Hub IoT. |
Extension | Preview |
| az iot hub message-endpoint create eventhub |
Adicione um ponto de extremidade do Hub de Eventos para um Hub IoT. |
Extension | Preview |
| az iot hub message-endpoint create servicebus-queue |
Adicione um ponto de extremidade da Fila do Barramento de Serviço para um Hub IoT. |
Extension | Preview |
| az iot hub message-endpoint create servicebus-topic |
Adicione um ponto de extremidade de Tópico do Barramento de Serviço para um Hub IoT. |
Extension | Preview |
| az iot hub message-endpoint create storage-container |
Adicione um ponto de extremidade do Contêiner de Armazenamento para um Hub IoT. |
Extension | Preview |
| az iot hub message-endpoint delete |
Exclua todo o ponto de extremidade ou um ponto de extremidade específico de um Hub IoT. |
Extension | Preview |
| az iot hub message-endpoint list |
Obtenha informações sobre todos os pontos de extremidade de um Hub IoT. |
Extension | Preview |
| az iot hub message-endpoint show |
Obtenha informações sobre o ponto de extremidade mencionado para um Hub IoT. |
Extension | Preview |
| az iot hub message-endpoint update |
Atualize as propriedades de um ponto de extremidade existente para um Hub IoT. |
Extension | Preview |
| az iot hub message-endpoint update cosmosdb-container |
Atualize as propriedades de um ponto de extremidade de contêiner do Cosmos DB existente para um Hub IoT. |
Extension | Preview |
| az iot hub message-endpoint update eventhub |
Atualize as propriedades de um ponto de extremidade do Hub de Eventos existente para um Hub IoT. |
Extension | Preview |
| az iot hub message-endpoint update servicebus-queue |
Atualize as propriedades de um ponto de extremidade de Fila do Barramento de Serviço existente para um Hub IoT. |
Extension | Preview |
| az iot hub message-endpoint update servicebus-topic |
Atualize as propriedades de um ponto de extremidade de Tópico do Barramento de Serviço existente para um Hub IoT. |
Extension | Preview |
| az iot hub message-endpoint update storage-container |
Atualize as propriedades de um ponto de extremidade de Contêiner de Armazenamento existente para um Hub IoT. |
Extension | Preview |
az iot hub message-endpoint delete
O grupo de comandos 'iot hub message-endpoint' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Exclua todo o ponto de extremidade ou um ponto de extremidade específico de um Hub IoT.
Você deve excluir todas as rotas e enriquecimentos de mensagens para o ponto de extremidade antes de excluir o ponto de extremidade.
az iot hub message-endpoint delete [--en --endpoint --endpoint-name]
[--endpoint-type --type {cosmosdb-container, eventhub, servicebus-queue, servicebus-topic, storage-container}]
[--force]
[--hub-name]
[--ids]
[--resource-group]
[--subscription]
[--yes {false, true}]
Exemplos
Exclua um ponto de extremidade de um Hub IoT.
az iot hub message-endpoint delete -n {iothub_name} --endpoint-name {endpoint_name}
Exclua todos os pontos de extremidade do tipo "EventHub" de um Hub IoT.
az iot hub message-endpoint delete -n {iothub_name} --endpoint-type eventhub
Exclua todos os pontos de extremidade de um Hub IoT.
az iot hub message-endpoint delete -n {iothub_name}
Force a exclusão de um ponto de extremidade de um Hub IoT. Isso excluirá as rotas e os enriquecimentos de mensagens associados a esse ponto de extremidade.
az iot hub message-endpoint delete -n {iothub_name} --endpoint-name {endpoint_name} -f
Force a exclusão de todos os pontos de extremidade do tipo "EventHub" de um Hub IoT. Isso excluirá as rotas e os enriquecimentos de mensagens associados a esse ponto de extremidade.
az iot hub message-endpoint delete -n {iothub_name} --endpoint-type eventhub -f
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Nome do ponto de extremidade de roteamento.
Tipo do ponto de extremidade de roteamento.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | cosmosdb-container, eventhub, servicebus-queue, servicebus-topic, storage-container |
Force a exclusão dos pontos de extremidade e quaisquer rotas e enriquecimentos de mensagens associados.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Nome do Hub IoT.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Ignore as solicitações do usuário. Indica a aceitação da ação. Usado principalmente para cenários de automação. Padrão: false.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | false, true |
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az iot hub message-endpoint list
O grupo de comandos 'iot hub message-endpoint' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Obtenha informações sobre todos os pontos de extremidade de um Hub IoT.
Você também pode especificar sobre qual tipo de ponto de extremidade deseja obter informações.
az iot hub message-endpoint list [--endpoint-type --type {cosmosdb-container, eventhub, servicebus-queue, servicebus-topic, storage-container}]
[--hub-name]
[--ids]
[--resource-group]
[--subscription]
Exemplos
Obtenha todos os pontos de extremidade de um Hub IoT.
az iot hub message-endpoint list -n {iothub_name}
Obtenha todos os pontos de extremidade do tipo "EventHub" de um Hub IoT.
az iot hub message-endpoint list -n {iothub_name} --endpoint-type eventhub
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Tipo do ponto de extremidade de roteamento.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | cosmosdb-container, eventhub, servicebus-queue, servicebus-topic, storage-container |
Nome do Hub IoT.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az iot hub message-endpoint show
O grupo de comandos 'iot hub message-endpoint' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Obtenha informações sobre o ponto de extremidade mencionado para um Hub IoT.
az iot hub message-endpoint show --en --endpoint --endpoint-name
[--hub-name]
[--ids]
[--resource-group]
[--subscription]
Exemplos
Obtenha informações de um ponto de extremidade de um Hub IoT.
az iot hub message-endpoint show -n {iothub_name} --endpoint-name {endpoint_name}
Parâmetros Exigidos
Nome do ponto de extremidade de roteamento.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Nome do Hub IoT.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Resource Id Arguments |
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |