Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
O Servidor MCP do Azure permite gerenciar recursos dos Hubs de Eventos do Azure com prompts de linguagem natural. Você não precisa se lembrar da sintaxe de comando específica.
Os Hubs de Eventos do Azure são um serviço nativo de streaming de dados na nuvem que transmite milhões de eventos por segundo, com baixa latência, de qualquer origem para qualquer destino. Os Hubs de Eventos são compatíveis com o Apache Kafka e permitem executar cargas de trabalho Kafka existentes sem alterações de código.
Observação
Parâmetros da ferramenta: as ferramentas do Servidor MCP do Azure definem parâmetros para os dados de que precisam para concluir tarefas. Alguns desses parâmetros são específicos para cada ferramenta e estão documentados abaixo. Outros parâmetros são globais e compartilhados por todas as ferramentas. Para obter mais informações, consulte Parâmetros da ferramenta.
Hub de Eventos: Excluir grupo de consumidores
Exclua um grupo de consumidores do Hub de Eventos especificado.
Exemplos de prompts incluem:
- Eliminar grupo de consumidores específico: "Eliminar grupo de consumidores 'analytics-group' do Event Hub 'orders-hub' no namespace 'eventhub-prod' no grupo de recursos 'meu-grupo-recurso'"
- Remover grupo de consumidores: "Remover o grupo de consumidores 'monitorização-consumidores' do meu Event Hub 'eventos-telemetria' no namespace 'prod-eventhubs' no grupo de recursos 'meu-grupo-recurso'"
- Limpar grupo de consumidores: "Eliminar o grupo de consumidores 'test-group' do Event Hub 'user-events' no namespace 'development-eventhubs' no grupo de recursos 'meu-grupo-recurso'"
| Parâmetro | Obrigatório ou opcional | Description |
|---|---|---|
| Grupo de recursos | Obrigatório | O nome do grupo de recursos do Azure. Este é um contêiner lógico para recursos do Azure. |
| Espaço de nomes | Obrigatório | O nome do namespace dos Hubs de Eventos. |
| Hub de eventos | Obrigatório | O nome do Hub de Eventos dentro do namespace. |
| Grupo de consumidores | Obrigatório | O nome do grupo de consumidores dentro do Hub de Eventos. |
Dicas de anotação da ferramenta:
Destrutiva: ✅ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Obrigatório: ❌
Hub de Eventos: Obter grupo de consumidores
Obtenha grupos de consumidores dos Hubs de Eventos do Azure. Esta ferramenta pode:
- Listar todos os grupos de consumidores em um Hub de Eventos
- Obter um único grupo de consumidores por nome
O hub de eventos e os parâmetros de namespace são necessários para get e list. Você só precisa do parâmetro de grupo de consumidores ao obter um grupo de consumidores específico.
Exemplos de prompts incluem:
- Liste todos os grupos de consumidores: "Liste todos os grupos de consumidores no Event Hub 'orders-hub' no namespace 'eventhub-prod' no grupo de recursos 'my-resource-group'"
- Obtenha grupo de consumidores específico: "Obtenha detalhes do grupo de consumidores 'analytics-group' do Event Hub 'orders-hub' no namespace 'eventhub-prod' no grupo de recursos 'my-resource-group'"
- Mostrar informação do grupo de consumidores: "Mostre-me o grupo de consumidores de monitorização 'monitorização' do Event Hub 'telemetry-events' no namespace 'prod-eventhubs' no grupo de recursos 'meu-grupo-de recursos'"
| Parâmetro | Obrigatório ou opcional | Description |
|---|---|---|
| Grupo de recursos | Obrigatório | O nome do grupo de recursos do Azure. Este é um contêiner lógico para recursos do Azure. |
| Espaço de nomes | Obrigatório | O nome do namespace dos Hubs de Eventos. |
| Hub de eventos | Obrigatório | O nome do Hub de Eventos dentro do namespace. |
| Grupo de consumidores | Opcional | O nome do grupo de consumidores dentro do Hub de Eventos. |
Dicas de anotação da ferramenta:
Destrutiva: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Obrigatório: ❌
Hub de Eventos: Criar ou atualizar grupo de consumidores
Crie ou atualize um grupo de consumidores dentro do Hub de Eventos especificado. A ferramenta cria um novo grupo de consumidores ou atualiza um existente.
Exemplos de prompts incluem:
- Criar um novo grupo de consumidores: "Criar um novo grupo de consumidores 'analytics-group' no Event Hub 'orders-hub' no namespace 'eventhub-prod' no grupo de recursos 'my-resource-group'"
- Atualize o grupo de consumidores existente: "Atualize o grupo de consumidores 'analytics-group' no Event Hub 'orders-hub' no namespace 'eventhub-prod' no grupo de recursos 'my-resource-group' com metadados de utilizadores 'Atualizados para análise do quarto trimestre'"
- Configurar grupo de consumidores: "Criar um grupo de consumidores de monitorização 'monitorização' no Event Hub 'telemetry-events' no namespace 'prod-eventhubs' no grupo de recursos 'meu-grupo-de recursos'"
| Parâmetro | Obrigatório ou opcional | Description |
|---|---|---|
| Grupo de recursos | Obrigatório | O nome do grupo de recursos do Azure. Este é um contêiner lógico para recursos do Azure. |
| Espaço de nomes | Obrigatório | O nome do namespace dos Hubs de Eventos. |
| Hub de eventos | Obrigatório | O nome do Hub de Eventos dentro do namespace. |
| Grupo de consumidores | Obrigatório | O nome do grupo de consumidores dentro do Hub de Eventos. |
| Metadados do utilizador | Opcional | Metadados do usuário para o grupo de consumidores. |
Dicas de anotação da ferramenta:
Destrutiva: ✅ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Obrigatório: ❌
Hub de Eventos: Excluir Hub de Eventos
Exclua um hub de eventos de um namespace de Hubs de Eventos do Azure. Essa ação exclui permanentemente todas as mensagens e grupos de consumidores no Hub de Eventos.
Exemplos de prompts incluem:
- Eliminar o Event Hub específico: "Eliminar o Event Hub 'orders-hub' do namespace 'eventhub-prod' no grupo de recursos 'my-resource-group'"
- Remover o Event Hub: "Remover o 'eventos-telemetria' do Event Hub do meu espaço de nomes 'prod-eventhubs' no grupo de recursos 'meu-grupo-de-recursos'"
- Limpar o Event Hub: "Eliminar os 'test-events' do Event Hub do namespace 'dev-eventhubs' no grupo de recursos 'my-resource-group'"
| Parâmetro | Obrigatório ou opcional | Description |
|---|---|---|
| Grupo de recursos | Obrigatório | O nome do grupo de recursos do Azure. Este é um contêiner lógico para recursos do Azure. |
| Espaço de nomes | Obrigatório | O nome do namespace dos Hubs de Eventos. |
| Hub de eventos | Obrigatório | O nome do Hub de Eventos dentro do namespace. |
Dicas de anotação da ferramenta:
Destrutiva: ✅ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Obrigatório: ❌
Hub de Eventos: Obter o Hub de Eventos
Obtenha hubs de eventos de um namespace do Azure. Esta ferramenta:
- Listar todos os hubs de eventos em um namespace
- Obter um único hub de eventos por nome
Quando você recupera um único hub de eventos ou lista vários hubs de eventos, o comando retorna informações detalhadas para todos os hubs de eventos, incluindo contagem de partições, configurações e metadados.
Exemplos de prompts incluem:
- Liste todos os Centros de Eventos: "Liste todos os Centros de Eventos no meu espaço de nomes 'prod-eventhubs' no grupo de recursos 'meu-grupo-de recursos'"
- Obtenha o Event Hub específico: "Obtenha os detalhes do meu Event Hub 'orders-hub' no namespace 'eventhub-prod' no grupo de recursos 'my-resource-group'"
- Mostrar informações do Event Hub: "Mostre-me os 'eventos-telemetria' do Event Hub do namespace 'monitoring-hubs' no grupo de recursos 'meu-grupo-de recursos'"
| Parâmetro | Obrigatório ou opcional | Description |
|---|---|---|
| Grupo de recursos | Obrigatório | O nome do grupo de recursos do Azure. Este é um contêiner lógico para recursos do Azure. |
| Espaço de nomes | Obrigatório | O nome do namespace dos Hubs de Eventos. |
| Hub de eventos | Opcional | O nome do Hub de Eventos dentro do namespace. |
Dicas de anotação da ferramenta:
Destrutiva: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Obrigatório: ❌
Hub de Eventos: Criar ou atualizar o Hub de Eventos
Crie ou atualize um Hub de Eventos dentro de um namespace de Hubs de Eventos do Azure. Este comando:
- Cria um novo Hub de Eventos se ele não existir
- Atualiza a configuração de um Hub de Eventos existente
Você pode configurar estas propriedades:
- Contagem de partições (número de partições para processamento paralelo)
- Tempo de retenção de mensagens (quanto tempo as mensagens são retidas, em horas)
Algumas propriedades, como a contagem de partições, não podem ser alteradas após a criação. Esta é uma operação potencialmente de longa duração que aguarda a conclusão.
Exemplos de prompts incluem:
- Criar novo Event Hub: "Criar um novo event hub 'orders-hub' no meu namespace 'production-eventhubs' no grupo de recursos 'my-resource-group'"
- Atualize o Event Hub existente: "Atualize o meu event hub 'telemetry-events' no meu namespace 'monitoring-hubs' no grupo de recursos 'my-resource-group'"
- Criar com configuração: "Criar event hub 'user-activity' no namespace 'analytics-hubs' no grupo de recursos 'my-resource-group' com 4 partições e retenção de mensagens de 24 horas"
| Parâmetro | Obrigatório ou opcional | Description |
|---|---|---|
| Grupo de recursos | Obrigatório | O nome do grupo de recursos do Azure. Este é um contêiner lógico para recursos do Azure. |
| Espaço de nomes | Obrigatório | O nome do namespace dos Hubs de Eventos. Deve ser usado com o parâmetro resource group. |
| Hub de eventos | Obrigatório | O nome do Hub de Eventos dentro do namespace. |
| Contagem de partições | Opcional | O número de partições para o Hub de Eventos. Deve estar entre 1 e 32 (ou superior com base na camada de namespace). |
| Retenção de mensagens em horas | Opcional | O tempo de retenção de mensagens em horas. Mínimo é 1 hora, máximo depende da camada de namespace. |
| Situação | Opcional | O status do Hub de Eventos (como Active, Disabled). O status pode ser somente leitura em algumas operações. |
Dicas de anotação da ferramenta:
Destrutiva: ✅ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Obrigatório: ❌
Namespace: Excluir namespace
Exclua um namespace de Hubs de Eventos. Essa operação é irreversível e exclui permanentemente todos os hubs de eventos, grupos de consumidores e configurações dentro do namespace.
Exemplos de prompts incluem:
- Eliminar espaço de nomes específico: "Eliminar o espaço de nomes do hub de eventos 'eventhub-prod' no grupo de recursos 'meu-grupo-de recursos'"
- Remover namespace: "Remover o namespace dos Event Hubs 'test-eventhubs' no grupo de recursos 'my-resource-group'"
- Limpar o namespace: "Eliminar permanentemente o namespace 'dev-eventhubs' no grupo de recursos 'my-resource-group'"
| Parâmetro | Obrigatório ou opcional | Description |
|---|---|---|
| Grupo de recursos | Obrigatório | O nome do grupo de recursos do Azure. Este é um contêiner lógico para recursos do Azure. |
| Espaço de nomes | Obrigatório | O nome do namespace dos Hubs de Eventos. |
Dicas de anotação da ferramenta:
Destrutiva: ✅ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Obrigatório: ❌
Namespace: Obter namespace
Obtenha namespaces de Hubs de Eventos do Azure. O comportamento depende de quais parâmetros você fornece. Quando você recupera um único namespace, a ferramenta retorna informações detalhadas, incluindo SKU, configurações e metadados. Quando você lista namespaces, a ferramenta retorna as mesmas informações detalhadas para todos os namespaces no escopo especificado.
Exemplos de prompts incluem:
- Listar todos os namespaces: "Listar todos os namespaces do hub de eventos na minha assinatura"
- Obtenha espaço de nomes específico: "Obtenha os detalhes do meu espaço de nomes 'eventhub-prod' no meu grupo de recursos 'meu-grupo-de recursos'"
- Mostrar informação do namespace: "Mostre-me o namespace 'monitoring-hubs' nos detalhes do grupo de recursos 'meu-grupo-de recursos'"
| Parâmetro | Obrigatório ou opcional | Description |
|---|---|---|
| Grupo de recursos | Opcional | O nome do grupo de recursos do Azure. Quando omitido, o sistema lista todos os namespaces na assinatura. Quando fornecido sem namespace, o sistema lista todos os namespaces no grupo de recursos. Necessário ao obter um namespace específico. |
| Espaço de nomes | Opcional | O nome do namespace Hubs de Eventos a ser recuperado. Quando fornecido, retorna informações detalhadas para o namespace específico (requer grupo de recursos). Quando omitido, retorna uma lista de namespaces. |
Dicas de anotação da ferramenta:
Destrutiva: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Obrigatório: ❌
Namespace: Criar ou atualizar namespace
Crie ou atualize um namespace dentro do grupo de recursos especificado. Esta ferramenta cria um novo namespace ou atualiza um existente. A ferramenta pode modificar configurações existentes e é considerada destrutiva. Esta ferramenta pode demorar muito tempo.
Ao atualizar um namespace existente, forneça apenas as propriedades que você deseja alterar. As propriedades não especificadas mantêm seus valores existentes. Você deve fornecer pelo menos uma propriedade de atualização.
Os cenários de atualização comuns incluem:
- Aumente ou diminua a escala alterando a camada ou a capacidade de SKU
- Ativar ou desativar a auto-insuflação e definir as unidades de rendimento máximo
- Ativar ou desativar o suporte a Kafka
- Modificar tags para gerenciamento de recursos
- Ativar ou desativar redundância de zona (apenas SKU Premium)
Exemplos de prompts incluem:
- Criar novo espaço de nomes: "Criar um novo espaço de nomes Event Hubs 'production-events' no grupo de recursos 'my-resource-group' no Leste dos EUA"
- Atualizar a capacidade do namespace: "Atualizar o meu namespace 'eventhub-prod' no grupo de recursos 'my-resource-group' para aumentar a capacidade para 10 unidades de throughput"
- Ativar o suporte Kafka: "Ativar Kafka no meu espaço de nomes Event Hubs 'monitoring-hubs' no grupo de recursos 'meu-grupo-de recursos'"
| Parâmetro | Obrigatório ou opcional | Description |
|---|---|---|
| Grupo de recursos | Obrigatório | O nome do grupo de recursos do Azure. Este é um contêiner lógico para recursos do Azure. |
| Espaço de nomes | Obrigatório | O nome do namespace dos Hubs de Eventos. |
| Localização | Opcional | A região do Azure onde o namespace está localizado (por exemplo, eastuswestus2, ). |
| Nome da SKU | Opcional | O nome SKU para o namespace. Valores válidos: Basic, Standard, Premium. |
| Nível de SKU | Opcional | A camada de SKU para o namespace. Valores válidos: Basic, Standard, Premium. |
| Capacidade de SKU | Opcional | A capacidade de SKU (unidades de taxa de transferência) para o namespace. O intervalo válido depende do SKU. |
| A insuflação automática está ativada | Opcional | Habilite ou desabilite a inflação automática para o namespace. |
| Unidades de rendimento máximo | Opcional | As unidades de taxa de transferência máxima quando a auto-inflação está ativada. |
| Kafka habilitado | Opcional | Habilite ou desabilite o Kafka para o namespace. |
| Zona redundante | Opcional | Habilite ou desabilite a redundância de zona para o namespace. |
| Etiquetas | Opcional | Tags para o namespace no formato JSON (por exemplo, {"key1":"value1","key2":"value2"}). |
Dicas de anotação da ferramenta:
Destrutiva: ✅ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Obrigatório: ❌