Partilhar via


az iot hub message-endpoint create

Nota

Essa referência faz parte da extensão azure-iot para a CLI do Azure (versão 2.46.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az iot hub message-endpoint create . Saiba mais sobre extensões.

O grupo de comandos 'iot hub message-endpoint' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Adicione um ponto de extremidade a um Hub IoT.

Comandos

Name Description Tipo Status
az iot hub message-endpoint create cosmosdb-container

Adicione um ponto de extremidade de contêiner do Cosmos DB para um Hub IoT.

Extensão Pré-visualizar
az iot hub message-endpoint create eventhub

Adicione um ponto de extremidade do Hub de Eventos para um Hub IoT.

Extensão Pré-visualizar
az iot hub message-endpoint create servicebus-queue

Adicione um ponto de extremidade da Fila do Service Bus para um Hub IoT.

Extensão Pré-visualizar
az iot hub message-endpoint create servicebus-topic

Adicione um ponto de extremidade de Tópico do Service Bus para um Hub IoT.

Extensão Pré-visualizar
az iot hub message-endpoint create storage-container

Adicione um ponto de extremidade de contêiner de armazenamento para um Hub IoT.

Extensão Pré-visualizar

az iot hub message-endpoint create cosmosdb-container

Pré-visualizar

O grupo de comandos 'iot hub message-endpoint' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Adicione um ponto de extremidade de contêiner do Cosmos DB para um Hub IoT.

az iot hub message-endpoint create cosmosdb-container --container
                                                      --database-name
                                                      --en
                                                      --hub-name
                                                      [--connection-string]
                                                      [--endpoint-account]
                                                      [--endpoint-resource-group]
                                                      [--endpoint-subscription-id]
                                                      [--endpoint-uri]
                                                      [--identity]
                                                      [--partition-key-name]
                                                      [--partition-key-template]
                                                      [--pk]
                                                      [--resource-group]
                                                      [--secondary-key]

Exemplos

Crie um ponto de extremidade de contêiner do Cosmos DB baseado em chave para um Hub IoT.

az iot hub message-endpoint create cosmosdb-container -n {iothub_name} --en {endpoint_name} --container {container} --db {database} --endpoint-account {account_name}

Crie um ponto de extremidade de contêiner do Cosmos DB para um Hub IoT usando uma cadeia de conexão.

az iot hub message-endpoint create cosmosdb-container -n {iothub_name} --en {endpoint_name} -c {connection_string} --container {container} --db {database}

Crie um ponto de extremidade de contêiner do Cosmos DB para um Hub IoT usando a chave primária especificada e o uri do ponto de extremidade.

az iot hub message-endpoint create cosmosdb-container -n {iothub_name} --en {endpoint_name} --pk {primary_key} --endpoint-uri {endpoint_uri} --container {container} --db {database}

Crie um ponto de extremidade de contêiner do Cosmos DB para um Hub IoT usando a identidade atribuída ao sistema e um nome de chave de partição. O modelo de chave de partição será o padrão.

az iot hub message-endpoint create cosmosdb-container -n {iothub_name} --en {endpoint_name} --endpoint-uri {endpoint_uri} --container {container} --db {database} --pkn {partition_key_name} --identity [system]

Crie um ponto de extremidade de contêiner do Cosmos DB para um Hub IoT usando a identidade atribuída pelo usuário, o nome da chave de partição e o modelo de chave de partição.

az iot hub message-endpoint create cosmosdb-container -n {iothub_name} --en {endpoint_name} --endpoint-uri {endpoint_uri} --container {container} --db {database} --pkn {partition_key_name} --pkt {partition_key_template} --identity {user_identity_resource_id}

Parâmetros Obrigatórios

--container --container-name

O nome do contêiner SQL do Cosmos DB no banco de dados do cosmos DB.

--database-name --db

O nome do banco de dados do cosmos DB na conta do cosmos DB.

--en --endpoint --endpoint-name

Nome do ponto de extremidade de roteamento.

--hub-name -n

Nome do Hub IoT.

Parâmetros Opcionais

--connection-string -c

Cadeia de conexão do ponto de extremidade de roteamento.

--endpoint-account

O nome da conta para o recurso de ponto de extremidade.

--endpoint-resource-group --erg -r

Grupo de recursos do recurso Endpoint resoure. Se não for fornecido, o grupo de recursos do Hub IoT será usado.

--endpoint-subscription-id -s

ID de assinatura do recurso Endpoint. Se não for fornecida, a assinatura do Hub IoT será usada.

--endpoint-uri

O uri do recurso de ponto de extremidade.

--identity

Use uma identidade gerenciada atribuída pelo sistema ou pelo usuário para autenticação de ponto de extremidade. Use "[sistema]" para se referir à identidade atribuída ao sistema ou a um ID de recurso para se referir a uma identidade atribuída pelo usuário.

--partition-key-name --pkn

O nome da chave de partição associada a este contêiner SQL do Cosmos DB, se existir.

--partition-key-template --pkt

O modelo para gerar um valor de chave de partição sintética para uso com este contêiner SQL do Cosmos DB. O modelo deve incluir pelo menos um dos seguintes espaços reservados: {iothub}, {deviceid}, {DD}, {MM} e {YYYY}. Qualquer espaço reservado pode ser especificado no máximo uma vez, mas os componentes de ordem e não espaço reservado são arbitrários. Se o nome da chave de partição for fornecido, o modelo de chave de partição assume como padrão {deviceid}-{YYYY}-{MM}.

--pk --primary-key

A chave primária da conta do cosmos DB.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--secondary-key --sk

A chave secundária da conta do cosmos DB.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az iot hub message-endpoint create eventhub

Pré-visualizar

O grupo de comandos 'iot hub message-endpoint' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Adicione um ponto de extremidade do Hub de Eventos para um Hub IoT.

az iot hub message-endpoint create eventhub --en
                                            --hub-name
                                            [--connection-string]
                                            [--endpoint-namespace-name]
                                            [--endpoint-policy-name]
                                            [--endpoint-resource-group]
                                            [--endpoint-subscription-id]
                                            [--endpoint-uri]
                                            [--entity-path]
                                            [--identity]
                                            [--resource-group]

Exemplos

Crie um ponto de extremidade do Hub de Eventos baseado em chave para um Hub IoT.

az iot hub message-endpoint create eventhub -n {iothub_name} --en {endpoint_name} --namespace {namespace_name} --entity-path {entity_path} --policy {policy_name}

Crie um ponto de extremidade do Hub de Eventos para um Hub IoT usando uma cadeia de conexão. O uri do ponto de extremidade e o caminho da entidade são omitidos.

az iot hub message-endpoint create eventhub -n {iothub_name} --en {endpoint_name} -c {connection_string}

Crie um ponto de extremidade do Hub de Eventos para um Hub IoT usando a identidade atribuída pelo sistema. O ponto de extremidade e o caminho da entidade devem ser especificados.

az iot hub message-endpoint create eventhub -n {iothub_name} --en {endpoint_name} --endpoint-uri {endpoint_uri} --entity-path {entity_path} --identity [system]

Crie um ponto de extremidade do Hub de Eventos para um Hub IoT usando a identidade atribuída pelo usuário. O ponto de extremidade e o caminho da entidade devem ser especificados.

az iot hub message-endpoint create eventhub -n {iothub_name} --en {endpoint_name} --endpoint-uri {endpoint_uri} --entity-path {entity_path} --identity {user_identity_resource_id}

Parâmetros Obrigatórios

--en --endpoint --endpoint-name

Nome do ponto de extremidade de roteamento.

--hub-name -n

Nome do Hub IoT.

Parâmetros Opcionais

--connection-string -c

Cadeia de conexão do ponto de extremidade de roteamento.

--endpoint-namespace-name --namespace

O nome do namespace para o recurso de ponto de extremidade.

--endpoint-policy-name --policy

O nome da política para recuperação de cadeia de conexão.

--endpoint-resource-group --erg -r

Grupo de recursos do recurso Endpoint resoure. Se não for fornecido, o grupo de recursos do Hub IoT será usado.

--endpoint-subscription-id -s

ID de assinatura do recurso Endpoint. Se não for fornecida, a assinatura do Hub IoT será usada.

--endpoint-uri

O uri do recurso de ponto de extremidade.

--entity-path

O caminho da entidade do recurso de ponto de extremidade.

--identity

Use uma identidade gerenciada atribuída pelo sistema ou pelo usuário para autenticação de ponto de extremidade. Use "[sistema]" para se referir à identidade atribuída ao sistema ou a um ID de recurso para se referir a uma identidade atribuída pelo usuário.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az iot hub message-endpoint create servicebus-queue

Pré-visualizar

O grupo de comandos 'iot hub message-endpoint' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Adicione um ponto de extremidade da Fila do Service Bus para um Hub IoT.

az iot hub message-endpoint create servicebus-queue --en
                                                    --hub-name
                                                    [--connection-string]
                                                    [--endpoint-namespace-name]
                                                    [--endpoint-policy-name]
                                                    [--endpoint-resource-group]
                                                    [--endpoint-subscription-id]
                                                    [--endpoint-uri]
                                                    [--entity-path]
                                                    [--identity]
                                                    [--resource-group]

Exemplos

Crie um ponto de extremidade de fila do Service Bus baseado em chave para um Hub IoT.

az iot hub message-endpoint create servicebus-queue -n {iothub_name} --en {endpoint_name} --namespace {namespace_name} --entity-path {entity_path} --policy {policy_name}

Crie um ponto de extremidade da Fila do Service Bus para um Hub IoT usando uma cadeia de conexão. O uri do ponto de extremidade e o caminho da entidade são omitidos.

az iot hub message-endpoint create servicebus-queue -n {iothub_name} --en {endpoint_name} -c {connection_string}

Crie um ponto de extremidade da Fila do Barramento de Serviço para um Hub IoT usando a identidade atribuída ao sistema. O ponto de extremidade e o caminho da entidade devem ser especificados.

az iot hub message-endpoint create servicebus-queue -n {iothub_name} --en {endpoint_name} --endpoint-uri {endpoint_uri} --entity-path {entity_path} --identity [system]

Crie um ponto de extremidade da Fila do Service Bus para um Hub IoT usando a identidade atribuída pelo usuário. O ponto de extremidade e o caminho da entidade devem ser especificados.

az iot hub message-endpoint create servicebus-queue -n {iothub_name} --en {endpoint_name} --endpoint-uri {endpoint_uri} --entity-path {entity_path} --identity {user_identity_resource_id}

Parâmetros Obrigatórios

--en --endpoint --endpoint-name

Nome do ponto de extremidade de roteamento.

--hub-name -n

Nome do Hub IoT.

Parâmetros Opcionais

--connection-string -c

Cadeia de conexão do ponto de extremidade de roteamento.

--endpoint-namespace-name --namespace

O nome do namespace para o recurso de ponto de extremidade.

--endpoint-policy-name --policy

O nome da política para recuperação de cadeia de conexão.

--endpoint-resource-group --erg -r

Grupo de recursos do recurso Endpoint resoure. Se não for fornecido, o grupo de recursos do Hub IoT será usado.

--endpoint-subscription-id -s

ID de assinatura do recurso Endpoint. Se não for fornecida, a assinatura do Hub IoT será usada.

--endpoint-uri

O uri do recurso de ponto de extremidade.

--entity-path

O caminho da entidade do recurso de ponto de extremidade.

--identity

Use uma identidade gerenciada atribuída pelo sistema ou pelo usuário para autenticação de ponto de extremidade. Use "[sistema]" para se referir à identidade atribuída ao sistema ou a um ID de recurso para se referir a uma identidade atribuída pelo usuário.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az iot hub message-endpoint create servicebus-topic

Pré-visualizar

O grupo de comandos 'iot hub message-endpoint' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Adicione um ponto de extremidade de Tópico do Service Bus para um Hub IoT.

az iot hub message-endpoint create servicebus-topic --en
                                                    --hub-name
                                                    [--connection-string]
                                                    [--endpoint-namespace-name]
                                                    [--endpoint-policy-name]
                                                    [--endpoint-resource-group]
                                                    [--endpoint-subscription-id]
                                                    [--endpoint-uri]
                                                    [--entity-path]
                                                    [--identity]
                                                    [--resource-group]

Exemplos

Crie um ponto de extremidade de Tópico do Service Bus baseado em chave para um Hub IoT.

az iot hub message-endpoint create servicebus-topic -n {iothub_name} --en {endpoint_name} --namespace {namespace_name} --entity-path {entity_path} --policy {policy_name}

Crie um ponto de extremidade de Tópico do Service Bus para um Hub IoT usando uma cadeia de conexão. O uri do ponto de extremidade e o caminho da entidade são omitidos.

az iot hub message-endpoint create servicebus-topic -n {iothub_name} --en {endpoint_name} -c {connection_string}

Crie um ponto de extremidade de Tópico do Service Bus para um Hub IoT usando a identidade atribuída pelo sistema. O ponto de extremidade e o caminho da entidade devem ser especificados.

az iot hub message-endpoint create servicebus-topic -n {iothub_name} --en {endpoint_name} --endpoint-uri {endpoint_uri} --entity-path {entity_path} --identity [system]

Crie um ponto de extremidade de Tópico do Service Bus para um Hub IoT usando a identidade atribuída pelo usuário. O ponto de extremidade e o caminho da entidade devem ser especificados.

az iot hub message-endpoint create servicebus-topic -n {iothub_name} --en {endpoint_name} --endpoint-uri {endpoint_uri} --entity-path {entity_path} --identity {user_identity_resource_id}

Parâmetros Obrigatórios

--en --endpoint --endpoint-name

Nome do ponto de extremidade de roteamento.

--hub-name -n

Nome do Hub IoT.

Parâmetros Opcionais

--connection-string -c

Cadeia de conexão do ponto de extremidade de roteamento.

--endpoint-namespace-name --namespace

O nome do namespace para o recurso de ponto de extremidade.

--endpoint-policy-name --policy

O nome da política para recuperação de cadeia de conexão.

--endpoint-resource-group --erg -r

Grupo de recursos do recurso Endpoint resoure. Se não for fornecido, o grupo de recursos do Hub IoT será usado.

--endpoint-subscription-id -s

ID de assinatura do recurso Endpoint. Se não for fornecida, a assinatura do Hub IoT será usada.

--endpoint-uri

O uri do recurso de ponto de extremidade.

--entity-path

O caminho da entidade do recurso de ponto de extremidade.

--identity

Use uma identidade gerenciada atribuída pelo sistema ou pelo usuário para autenticação de ponto de extremidade. Use "[sistema]" para se referir à identidade atribuída ao sistema ou a um ID de recurso para se referir a uma identidade atribuída pelo usuário.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az iot hub message-endpoint create storage-container

Pré-visualizar

O grupo de comandos 'iot hub message-endpoint' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Adicione um ponto de extremidade de contêiner de armazenamento para um Hub IoT.

az iot hub message-endpoint create storage-container --container
                                                     --en
                                                     --hub-name
                                                     [--batch-frequency]
                                                     [--chunk-size]
                                                     [--connection-string]
                                                     [--encoding {avro, json}]
                                                     [--endpoint-account]
                                                     [--endpoint-resource-group]
                                                     [--endpoint-subscription-id]
                                                     [--endpoint-uri]
                                                     [--ff]
                                                     [--identity]
                                                     [--resource-group]

Exemplos

Crie um ponto de extremidade de contêiner de armazenamento baseado em chave para um Hub IoT.

az iot hub message-endpoint create storage-container -n {iothub_name} --en {endpoint_name} --container {container_name} --endpoint-account {account_name}

Crie um ponto de extremidade de contêiner de armazenamento para um Hub IoT usando uma cadeia de conexão. O uri do ponto de extremidade é omitido.

az iot hub message-endpoint create storage-container -n {iothub_name} --en {endpoint_name} -c {connection_string} --container {container_name}

Crie um ponto de extremidade de Contêiner de Armazenamento para um Hub IoT usando a identidade atribuída ao sistema com a frequência de lote, tamanho de bloco e formato de nome de arquivo fornecidos. O ponto de extremidade deve ser especificado.

az iot hub message-endpoint create storage-container -n {iothub_name} --en {endpoint_name} --endpoint-uri {endpoint_uri} --container {container_name} -b {batch_frequency} -w {chunk_size} --ff {file_format} --identity [system]

Crie um ponto de extremidade de contêiner de armazenamento para um Hub IoT usando a identidade atribuída pelo usuário com codificação json. O ponto de extremidade deve ser especificado.

az iot hub message-endpoint create storage-container -n {iothub_name} --en {endpoint_name} --endpoint-uri {endpoint_uri} --container {container_name} --encoding json --identity {user_identity_resource_id}

Parâmetros Obrigatórios

--container --container-name

Nome do recipiente de armazenamento.

--en --endpoint --endpoint-name

Nome do ponto de extremidade de roteamento.

--hub-name -n

Nome do Hub IoT.

Parâmetros Opcionais

--batch-frequency -b

Solicite a frequência do lote em segundos. A quantidade máxima de tempo que pode decorrer antes que os dados sejam gravados em um blob, entre 60 e 720 segundos.

Default value: 300
--chunk-size -w

Solicite o tamanho do bloco em megabytes (MB). O tamanho máximo dos blobs, entre 10 e 500 MB.

Default value: 300
--connection-string -c

Cadeia de conexão do ponto de extremidade de roteamento.

--encoding

Formato de codificação para o contêiner.

Valores aceites: avro, json
Default value: avro
--endpoint-account

O nome da conta para o recurso de ponto de extremidade.

--endpoint-resource-group --erg -r

Grupo de recursos do recurso Endpoint resoure. Se não for fornecido, o grupo de recursos do Hub IoT será usado.

--endpoint-subscription-id -s

ID de assinatura do recurso Endpoint. Se não for fornecida, a assinatura do Hub IoT será usada.

--endpoint-uri

O uri do recurso de ponto de extremidade.

--ff --file-name-format

Formato de nome de arquivo para o blob. O formato de nome de arquivo deve conter campos {iothub}, {partition}, {AAAA}, {MM}, {DD}, {HH} e {mm}. Todos os parâmetros são obrigatórios, mas podem ser reordenados com ou sem delimitadores.

Default value: {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}
--identity

Use uma identidade gerenciada atribuída pelo sistema ou pelo usuário para autenticação de ponto de extremidade. Use "[sistema]" para se referir à identidade atribuída ao sistema ou a um ID de recurso para se referir a uma identidade atribuída pelo usuário.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.