Event Hubs - List By Namespace

Referência

Service:: Event Hubs

API Version:: 2024-01-01

Obtém todos os Hubs de Eventos em um Namespace.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}/eventhubs?api-version=2024-01-01

With optional parameters:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}/eventhubs?api-version=2024-01-01&$skip={$skip}&$top={$top}

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
namespaceName	path	True	string	O nome do namespace Regex pattern: `^[a-zA-Z][a-zA-Z0-9-]{6,50}[a-zA-Z0-9]$`
resourceGroupName	path	True	string	Nome do grupo de recursos dentro da assinatura do azure.
subscriptionId	path	True	string	Credenciais de assinatura que identificam exclusivamente uma assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.
api-version	query	True	string	Versão da API do cliente.
$skip	query		integer	Skip só será usado se uma operação anterior retornar um resultado parcial. Se uma resposta anterior contiver um elemento nextLink, o valor do elemento nextLink incluirá um parâmetro skip que especifica um ponto de partida a ser usado para chamadas subsequentes.
$top	query		integer	Pode ser usado para limitar o número de resultados ao N usageDetails mais recente.

Respostas

Nome	Tipo	Description
200 OK	EventHubListResult	Recuperou com êxito a lista de Hubs de Eventos.
Other Status Codes	ErrorResponse	Resposta de erro do Eventhub que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

EventHubsListAll

Sample Request

HTTP

GET https://management.azure.com/subscriptions/e2f361f0-3b27-4503-a9cc-21cfba380093/resourceGroups/Default-NotificationHubs-AustraliaEast/providers/Microsoft.EventHub/namespaces/sdk-Namespace-5357/eventhubs?api-version=2024-01-01

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "/subscriptions/e2f361f0-3b27-4503-a9cc-21cfba380093/resourceGroups/Default-NotificationHubs-AustraliaEast/providers/Microsoft.EventHub/namespaces/sdk-Namespace-716/eventhubs/sdk-eventhub-10",
      "name": "sdk-eventhub-10",
      "type": "Microsoft.EventHub/Namespaces/EventHubs",
      "properties": {
        "messageRetentionInDays": 4,
        "partitionCount": 4,
        "status": "Active",
        "createdAt": "2017-06-28T02:45:55.877Z",
        "updatedAt": "2017-06-28T02:46:05.877Z",
        "partitionIds": [
          "0",
          "1",
          "2",
          "3"
        ],
        "captureDescription": {
          "enabled": true,
          "encoding": "Avro",
          "destination": {
            "name": "EventHubArchive.AzureBlockBlob",
            "properties": {
              "storageAccountResourceId": "/subscriptions/e2f361f0-3b27-4503-a9cc-21cfba380093/resourceGroups/Default-Storage-SouthCentralUS/providers/Microsoft.ClassicStorage/storageAccounts/arjunteststorage",
              "blobContainer": "container",
              "archiveNameFormat": "{Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}"
            }
          },
          "intervalInSeconds": 120,
          "sizeLimitInBytes": 10485763
        },
        "retentionDescription": {
          "cleanupPolicy": "Delete",
          "retentionTimeInHours": 96,
          "tombstoneRetentionTimeInHours": 1
        }
      }
    }
  ]
}

Definições

Nome	Description
CaptureDescription	Propriedades para configurar a descrição da captura para o eventhub
CaptureIdentity	Um valor que indica se a descrição da captura está habilitada.
CaptureIdentityType	Tipo de Identidade Gerenciada do Azure Active Directory.
CleanupPolicyRetentionDescription	Enumera os valores possíveis para a política de limpeza
createdByType	O tipo de identidade que criou o recurso.
Destination	Capturar detalhes de armazenamento para a descrição da captura
EncodingCaptureDescription	Enumera os valores possíveis para o formato de codificação da descrição da captura. Observação: 'AvroDeflate' será preterido na nova versão da API
EntityStatus	Enumera os valores possíveis para o status do Hub de Eventos.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	Os detalhes do erro.
ErrorResponse	A resposta de erro indica que o serviço hub de eventos não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro.
Eventhub	Item único na operação Listar ou Obter Hub de Eventos
EventHubListResult	O resultado da operação Listar EventHubs.
RetentionDescription	Propriedades para definir as configurações de retenção para o eventhub
systemData	Metadados relativos à criação e à última modificação do recurso.

CaptureDescription

Propriedades para configurar a descrição da captura para o eventhub

Nome	Tipo	Description
destination	Destination	Propriedades de Destino em que a captura será armazenada. (Conta de armazenamento, nomes de blob)
enabled	boolean	Um valor que indica se a descrição da captura está habilitada.
encoding	EncodingCaptureDescription	Enumera os valores possíveis para o formato de codificação da descrição da captura. Observação: 'AvroDeflate' será preterido na nova versão da API
intervalInSeconds	integer	A janela de tempo permite definir a frequência com que a captura para blobs do Azure ocorrerá, o valor deve estar entre 60 e 900 segundos
sizeLimitInBytes	integer	A janela de tamanho define a quantidade de dados compilados no Hub de Eventos antes de uma operação de captura, o valor deve estar entre 10485760 a 524288000 bytes
skipEmptyArchives	boolean	Um valor que indica se ignorar arquivos vazios

CaptureIdentity

Um valor que indica se a descrição da captura está habilitada.

Nome	Tipo	Description
type	CaptureIdentityType	Tipo de Identidade Gerenciada do Azure Active Directory.
userAssignedIdentity	string	ID do ARM da Identidade de Usuário Gerenciada. Essa propriedade é necessária se o tipo é UserAssignedIdentity. Se o tipo for SystemAssigned, a identidade atribuída pelo sistema associada ao namespace será usada.

CaptureIdentityType

Tipo de Identidade Gerenciada do Azure Active Directory.

Nome	Tipo	Description
SystemAssigned	string
UserAssigned	string

CleanupPolicyRetentionDescription

Enumera os valores possíveis para a política de limpeza

Nome	Tipo	Description
Compact	string
Delete	string

createdByType

O tipo de identidade que criou o recurso.

Nome	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

Destination

Capturar detalhes de armazenamento para a descrição da captura

Nome	Tipo	Description
identity	CaptureIdentity	Um valor que indica se a descrição da captura está habilitada.
name	string	Nome do destino de captura
properties.archiveNameFormat	string	Convenção de nomenclatura de blob para arquivo morto, por exemplo, {Namespace}/{EventHub}/{PartitionId}/{Year}/{Month}/{Day}/{Hour}/{Minute}/{Second}. Aqui, todos os parâmetros (Namespace, EventHub .. etc) são obrigatórios, independentemente da ordem
properties.blobContainer	string	Nome do contêiner de blob
properties.dataLakeAccountName	string	O nome do Azure Data Lake Store para os eventos capturados
properties.dataLakeFolderPath	string	O caminho da pasta de destino para os eventos capturados
properties.dataLakeSubscriptionId	string	ID da assinatura do Azure Data Lake Store
properties.storageAccountResourceId	string	ID do recurso da conta de armazenamento a ser usada para criar os blobs

EncodingCaptureDescription

Enumera os valores possíveis para o formato de codificação da descrição da captura. Observação: 'AvroDeflate' será preterido na nova versão da API

Nome	Tipo	Description
Avro	string
AvroDeflate	string

EntityStatus

Enumera os valores possíveis para o status do Hub de Eventos.

Nome	Tipo	Description
Active	string
Creating	string
Deleting	string
Disabled	string
ReceiveDisabled	string
Renaming	string
Restoring	string
SendDisabled	string
Unknown	string

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Os detalhes do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

A resposta de erro indica que o serviço hub de eventos não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro.

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

Eventhub

Item único na operação Listar ou Obter Hub de Eventos

Nome	Tipo	Description
id	string	ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	A localização geográfica em que o recurso reside
name	string	O nome do recurso
properties.captureDescription	CaptureDescription	Propriedades da descrição da captura
properties.createdAt	string	Hora exata em que o Hub de Eventos foi criado.
properties.messageRetentionInDays	integer	Número de dias para reter os eventos para este Hub de Eventos, o valor deve ser de 1 a 7 dias
properties.partitionCount	integer	Número de partições criadas para o Hub de Eventos, os valores permitidos são de 1 a 32 partições.
properties.partitionIds	string[]	Número atual de fragmentos no Hub de Eventos.
properties.retentionDescription	RetentionDescription	Configurações de retenção do Hub de Eventos
properties.status	EntityStatus	Enumera os valores possíveis para o status do Hub de Eventos.
properties.updatedAt	string	A hora exata em que a mensagem foi atualizada.
properties.userMetadata	string	Obtém e define metadados do usuário.
systemData	systemData	Os metadados do sistema relacionados a esse recurso.
type	string	Tipo do recurso. Por exemplo, "Microsoft.EventHub/Namespaces" ou "Microsoft.EventHub/Namespaces/EventHubs"

EventHubListResult

O resultado da operação Listar EventHubs.

Nome	Tipo	Description
nextLink	string	Link para o próximo conjunto de resultados. Não vazio se Value contiver uma lista incompleta de EventHubs.
value	Eventhub[]	Resultado da operação Listar EventHubs.

RetentionDescription

Propriedades para definir as configurações de retenção para o eventhub

Nome	Tipo	Description
cleanupPolicy	CleanupPolicyRetentionDescription	Enumera os valores possíveis para a política de limpeza
retentionTimeInHours	integer	Número de horas para reter os eventos para este Hub de Eventos. Esse valor só é usado quando cleanupPolicy é Delete. Se cleanupPolicy for Compact, o valor retornado dessa propriedade será Long.MaxValue
tombstoneRetentionTimeInHours	integer	Número de horas para manter os marcadores de marca de exclusão de um Hub de Eventos compactado. Esse valor só é usado quando cleanupPolicy é Compact. O consumidor deve concluir a leitura do marcador de marca de exclusão dentro dessa quantidade de tempo especificada se o consumidor começar a iniciar o deslocamento para garantir que obtenha uma instantâneo válida para a chave específica descrita pelo marcador de marca de exclusão dentro do Hub de Eventos compactado

systemData

Metadados relativos à criação e à última modificação do recurso.

Nome	Tipo	Description
createdAt	string	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string	O tipo de identidade que modificou o recurso pela última vez.
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.