az iot hub message-endpoint update
Observação
Essa referência faz parte da extensão azure-iot para a CLI do Azure (versão 2.37.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az iot hub message-endpoint update . 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 suporte: https://aka.ms/CLI_refstatus
Atualize as propriedades de um ponto de extremidade existente para um Hub IoT.
Comandos
| Nome | Description | Tipo | Status |
|---|---|---|---|
| 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. |
Extensão | Versão Prévia |
| az iot hub message-endpoint update eventhub |
Atualize as propriedades de um ponto de extremidade existente do Hub de Eventos para um Hub IoT. |
Extensão | Versão Prévia |
| 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. |
Extensão | Versão Prévia |
| 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. |
Extensão | Versão Prévia |
| 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. |
Extensão | Versão Prévia |
az iot hub message-endpoint update cosmosdb-container
O grupo de comandos 'iot hub message-endpoint' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Atualize as propriedades de um ponto de extremidade de contêiner do Cosmos DB existente para um Hub IoT.
Se estiver atualizando o tipo de autenticação de um ponto de extremidade do Contêiner do Cosmos DB baseado em chave para um ponto de extremidade do Contêiner do Cosmos DB baseado em identidade, você deverá fornecer a identidade (via --identity) e o uri do ponto de extremidade (via --endpoint-uri). A chave primária antiga e a chave secundária serão anuladas.
Se estiver atualizando o tipo de autenticação de um ponto de extremidade do Contêiner do Cosmos DB baseado em identidade para um ponto de extremidade do Contêiner do Cosmos DB baseado em chave, você deverá fornecer a cadeia de conexão (via --connection-string), a chave primária (via --primary-key) ou a chave secundária (via --secondary-key).
O nome do contêiner do ponto de extremidade não pode ser alterado. Os nomes de conta só podem ser alterados se existirem contêineres com o mesmo nome em ambas as contas.
az iot hub message-endpoint update cosmosdb-container --en
--hub-name
[--connection-string]
[--database-name]
[--endpoint-resource-group]
[--endpoint-subscription-id]
[--endpoint-uri]
[--identity]
[--partition-key-name]
[--partition-key-template]
[--pk]
[--resource-group]
[--secondary-key]Exemplos
Atualize um ponto de extremidade do Contêiner do Cosmos DB baseado em chave ou identidade para um Hub IoT para usar uma nova cadeia de conexão especificada.
az iot hub message-endpoint update cosmosdb-container -n {iothub_name} --en {endpoint_name} --connection-string {connection_string}Atualize um ponto de extremidade de contêiner do Cosmos DB para um Hub IoT para usar uma chave primária e uma chave secundária especificadas.
az iot hub message-endpoint update cosmosdb-container -n {iothub_name} --en {endpoint_name} --pk {primary_key} --sk {secondary_key}Atualize um ponto de extremidade de contêiner do Cosmos DB para um Hub IoT para usar 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 update cosmosdb-container -n {iothub_name} --en {endpoint_name} --pkn {partition_key_name} --identity [system]Atualize um ponto de extremidade do Contêiner do Cosmos DB baseado em chave para um Hub IoT para usar a identidade atribuída pelo usuário (você pode omitir --endpoint-uri se o ponto de extremidade já for baseado em identidade).
az iot hub message-endpoint update cosmosdb-container -n {iothub_name} --en {endpoint_name} --identity {user_identity_resource_id} --endpoint-uri {endpoint_uri}Parâmetros Exigidos
Nome do ponto de extremidade de roteamento.
Nome do Hub IoT.
Parâmetros Opcionais
Cadeia de conexão do ponto de extremidade de roteamento.
O nome do banco de dados do cosmos DB na conta do cosmos DB.
Grupo de recursos do recurso Endpoint. Se não for fornecido, o grupo de recursos do Hub IoT será usado.
ID de assinatura do recurso Ponto de extremidade. Se não for fornecida, a assinatura do Hub IoT será usada.
O uri do recurso de ponto de extremidade.
Use uma identidade gerenciada atribuída pelo sistema ou pelo usuário para autenticação de ponto de extremidade. Use "[system]" para se referir à identidade atribuída pelo sistema ou a uma ID de recurso para se referir a uma identidade atribuída pelo usuário.
O nome da chave de partição associada a esse Contêiner SQL do Cosmos DB, se houver. Para limpar essa propriedade, defina-a como "".
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 assumirá como padrão {deviceid}-{YYYY}-{MM}. Para limpar essa propriedade, defina-a como "".
A chave primária da conta do cosmos DB.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
A chave secundária da conta do cosmos DB.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az iot hub message-endpoint update eventhub
O grupo de comandos 'iot hub message-endpoint' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Atualize as propriedades de um ponto de extremidade existente do Hub de Eventos para um Hub IoT.
Se estiver atualizando o tipo de autenticação de um ponto de extremidade do Hub de Eventos baseado em chave para um ponto de extremidade baseado em identidade, você deverá fornecer a identidade (via --identity), o uri do ponto de extremidade (via --endpoint-uri) e o caminho da entidade (via --entity-path). A cadeia de conexão antiga será anulada.
Se estiver atualizando o tipo de autenticação de um ponto de extremidade do Hub de Eventos baseado em identidade para um ponto de extremidade do Hub de Eventos baseado em chave, você deverá fornecer a cadeia de conexão (via --connection-string). O uri de ponto de extremidade antigo e o caminho da entidade serão anulados.
az iot hub message-endpoint update eventhub --en
--hub-name
[--connection-string]
[--endpoint-resource-group]
[--endpoint-subscription-id]
[--endpoint-uri]
[--entity-path]
[--identity]
[--resource-group]Exemplos
Atualize um ponto de extremidade do Hub de Eventos baseado em chave ou identidade para um Hub IoT para usar uma nova cadeia de conexão especificada.
az iot hub message-endpoint update eventhub -n {iothub_name} --en {endpoint_name} -c {connection_string}Atualize um ponto de extremidade do Hub de Eventos para um Hub IoT para usar a identidade atribuída ao sistema e um caminho de entidade diferente.
az iot hub message-endpoint update eventhub -n {iothub_name} --en {endpoint_name} --entity-path {entity_path} --identity [system]Atualize um ponto de extremidade do Hub de Eventos baseado em chave para um Hub IoT para usar a identidade atribuída pelo usuário (você pode omitir --endpoint-uri se o ponto de extremidade já for baseado em identidade).
az iot hub message-endpoint update eventhub -n {iothub_name} --en {endpoint_name} --identity {user_identity_resource_id} --endpoint-uri {endpoint_uri} --entity-path {entity_path}Parâmetros Exigidos
Nome do ponto de extremidade de roteamento.
Nome do Hub IoT.
Parâmetros Opcionais
Cadeia de conexão do ponto de extremidade de roteamento.
Grupo de recursos do recurso Endpoint. Se não for fornecido, o grupo de recursos do Hub IoT será usado.
ID de assinatura do recurso Ponto de extremidade. Se não for fornecida, a assinatura do Hub IoT será usada.
O uri do recurso de ponto de extremidade.
O caminho da entidade do recurso de ponto de extremidade.
Use uma identidade gerenciada atribuída pelo sistema ou pelo usuário para autenticação de ponto de extremidade. Use "[system]" para se referir à identidade atribuída pelo sistema ou a uma ID de recurso para se referir a uma identidade atribuída pelo usuário.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az iot hub message-endpoint update servicebus-queue
O grupo de comandos 'iot hub message-endpoint' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Atualize as propriedades de um ponto de extremidade de Fila do Barramento de Serviço existente para um Hub IoT.
Se estiver atualizando o tipo de autenticação de um ponto de extremidade da Fila do Barramento de Serviço baseado em chave para um ponto de extremidade da Fila do Barramento de Serviço baseado em identidade, você deverá fornecer a identidade (via --identity), o uri do ponto de extremidade (via --endpoint-uri) e o caminho da entidade (via --entity-path). A cadeia de conexão antiga será anulada.
Se estiver atualizando o tipo de autenticação de um ponto de extremidade da Fila do Barramento de Serviço baseado em identidade para um ponto de extremidade da Fila do Barramento de Serviço baseado em chave, você deverá fornecer a cadeia de conexão (via --connection-string). O uri de ponto de extremidade antigo e o caminho da entidade serão anulados.
az iot hub message-endpoint update servicebus-queue --en
--hub-name
[--connection-string]
[--endpoint-resource-group]
[--endpoint-subscription-id]
[--endpoint-uri]
[--entity-path]
[--identity]
[--resource-group]Exemplos
Atualize um ponto de extremidade da Fila do Barramento de Serviço baseado em chave ou identidade para um Hub IoT para usar uma nova cadeia de conexão especificada.
az iot hub message-endpoint update servicebus-queue -n {iothub_name} --en {endpoint_name} -c {connection_string}Atualize um ponto de extremidade da Fila do Barramento de Serviço para um Hub IoT para usar a identidade atribuída ao sistema e um caminho de entidade diferente.
az iot hub message-endpoint update servicebus-queue -n {iothub_name} --en {endpoint_name} --entity-path {entity_path} --identity [system]Atualize um ponto de extremidade da Fila do Barramento de Serviço baseado em chave para um Hub IoT para usar a identidade atribuída pelo usuário (você pode omitir --endpoint-uri se o ponto de extremidade já for baseado em identidade).
az iot hub message-endpoint update servicebus-queue -n {iothub_name} --en {endpoint_name} --identity {user_identity_resource_id} --endpoint-uri {endpoint_uri} --entity-path {entity_path}Parâmetros Exigidos
Nome do ponto de extremidade de roteamento.
Nome do Hub IoT.
Parâmetros Opcionais
Cadeia de conexão do ponto de extremidade de roteamento.
Grupo de recursos do recurso Endpoint. Se não for fornecido, o grupo de recursos do Hub IoT será usado.
ID de assinatura do recurso Ponto de extremidade. Se não for fornecida, a assinatura do Hub IoT será usada.
O uri do recurso de ponto de extremidade.
O caminho da entidade do recurso de ponto de extremidade.
Use uma identidade gerenciada atribuída pelo sistema ou pelo usuário para autenticação de ponto de extremidade. Use "[system]" para se referir à identidade atribuída pelo sistema ou a uma ID de recurso para se referir a uma identidade atribuída pelo usuário.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az iot hub message-endpoint update servicebus-topic
O grupo de comandos 'iot hub message-endpoint' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Atualize as propriedades de um ponto de extremidade de Tópico do Barramento de Serviço existente para um Hub IoT.
Se estiver atualizando o tipo de autenticação de um ponto de extremidade do Tópico do Barramento de Serviço baseado em chave para um ponto de extremidade do Service Bus baseado em identidade, você deverá fornecer a identidade (via --identity), o uri do ponto de extremidade (via --endpoint-uri) e o caminho da entidade (via --entity-path). A cadeia de conexão antiga será anulada.
Se estiver atualizando o tipo de autenticação de um ponto de extremidade do Tópico do Barramento de Serviço baseado em identidade para um ponto de extremidade do Tópico do Barramento de Serviço baseado em chave, você deverá fornecer a cadeia de conexão (via --connection-string). O uri de ponto de extremidade antigo e o caminho da entidade serão anulados.
az iot hub message-endpoint update servicebus-topic --en
--hub-name
[--connection-string]
[--endpoint-resource-group]
[--endpoint-subscription-id]
[--endpoint-uri]
[--entity-path]
[--identity]
[--resource-group]Exemplos
Atualize um ponto de extremidade de Tópico do Barramento de Serviço baseado em chave ou identidade para um Hub IoT para usar uma nova cadeia de conexão especificada.
az iot hub message-endpoint update servicebus-topic -n {iothub_name} --en {endpoint_name} -c {connection_string}Atualize um ponto de extremidade do Tópico do Barramento de Serviço para um Hub IoT para usar a identidade atribuída ao sistema e um caminho de entidade diferente.
az iot hub message-endpoint update servicebus-topic -n {iothub_name} --en {endpoint_name} --entity-path {entity_path} --identity [system]Atualize um ponto de extremidade de Tópico do Barramento de Serviço baseado em chave para um Hub IoT para usar a identidade atribuída pelo usuário (você pode omitir --endpoint-uri se o ponto de extremidade já for baseado em identidade).
az iot hub message-endpoint update servicebus-topic -n {iothub_name} --en {endpoint_name} --identity {user_identity_resource_id} --endpoint-uri {endpoint_uri} --entity-path {entity_path}Parâmetros Exigidos
Nome do ponto de extremidade de roteamento.
Nome do Hub IoT.
Parâmetros Opcionais
Cadeia de conexão do ponto de extremidade de roteamento.
Grupo de recursos do recurso Endpoint. Se não for fornecido, o grupo de recursos do Hub IoT será usado.
ID de assinatura do recurso Ponto de extremidade. Se não for fornecida, a assinatura do Hub IoT será usada.
O uri do recurso de ponto de extremidade.
O caminho da entidade do recurso de ponto de extremidade.
Use uma identidade gerenciada atribuída pelo sistema ou pelo usuário para autenticação de ponto de extremidade. Use "[system]" para se referir à identidade atribuída pelo sistema ou a uma ID de recurso para se referir a uma identidade atribuída pelo usuário.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
az iot hub message-endpoint update storage-container
O grupo de comandos 'iot hub message-endpoint' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus
Atualize as propriedades de um ponto de extremidade de Contêiner de Armazenamento existente para um Hub IoT.
Se estiver atualizando o tipo de autenticação de um ponto de extremidade do Contêiner de Armazenamento baseado em chave para um ponto de extremidade do Contêiner de Armazenamento baseado em identidade, você deverá fornecer a identidade (via --identity) e o uri do ponto de extremidade (via --endpoint-uri). A cadeia de conexão antiga será anulada.
Se estiver atualizando o tipo de autenticação de um ponto de extremidade do Contêiner de Armazenamento baseado em identidade para um ponto de extremidade do Contêiner de Armazenamento baseado em chave, você deverá fornecer a cadeia de conexão (via --connection-string).
O nome do contêiner e a codificação do ponto de extremidade não podem ser alterados. Os nomes de conta só podem ser alterados se existirem contêineres com o mesmo nome em ambas as contas.
az iot hub message-endpoint update storage-container --en
--hub-name
[--batch-frequency]
[--chunk-size]
[--connection-string]
[--endpoint-resource-group]
[--endpoint-subscription-id]
[--endpoint-uri]
[--ff]
[--identity]
[--resource-group]Exemplos
Atualize um ponto de extremidade de Contêiner de Armazenamento baseado em chave ou identidade para um Hub IoT para usar uma nova cadeia de conexão especificada.
az iot hub message-endpoint update storage-container -n {iothub_name} --en {endpoint_name} -c {connection_string}Atualize um ponto de extremidade do Contêiner de Armazenamento para um Hub IoT para usar a identidade atribuída ao sistema com a frequência de lote, o tamanho do bloco e o formato de nome de arquivo especificados.
az iot hub message-endpoint update storage-container -n {iothub_name} --en {endpoint_name} -b {batch_frequency} -w {chunk_size} --ff {file_format} --identity [system]Atualize um ponto de extremidade de Contêiner de Armazenamento baseado em chave para um Hub IoT para usar a identidade atribuída pelo usuário (você pode omitir --endpoint-uri se o ponto de extremidade já for baseado em identidade).
az iot hub message-endpoint update storage-container -n {iothub_name} --en {endpoint_name} --identity {user_identity_resource_id} --endpoint-uri {endpoint_uri}Parâmetros Exigidos
Nome do ponto de extremidade de roteamento.
Nome do Hub IoT.
Parâmetros Opcionais
Frequência de lote de solicitação 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.
Tamanho do bloco de solicitação em megabytes (MB). O tamanho máximo dos blobs, entre 10 e 500 MB.
Cadeia de conexão do ponto de extremidade de roteamento.
Grupo de recursos do recurso Endpoint. Se não for fornecido, o grupo de recursos do Hub IoT será usado.
ID de assinatura do recurso Ponto de extremidade. Se não for fornecida, a assinatura do Hub IoT será usada.
O uri do recurso de ponto de extremidade.
Formato de nome de arquivo para o blob. O formato de nome de arquivo deve conter os campos {iothub}, {partition}, {YYYY}, {MM}, {DD}, {HH} e {mm}. Todos os parâmetros são obrigatórios, mas podem ser reordenados com ou sem delimitadores.
Use uma identidade gerenciada atribuída pelo sistema ou pelo usuário para autenticação de ponto de extremidade. Use "[system]" para se referir à identidade atribuída pelo sistema ou a uma ID de recurso para se referir a uma identidade atribuída pelo usuário.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Globais
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar o detalhamento do log. Use --debug para logs de depuração completos.
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de