Explore eventos de armazenamento de blobs do Azure no hub Fabric Real-Time (visualização)

Este artigo mostra como explorar eventos de armazenamento de blob do Azure no hub Fabric Real-Time. Os eventos de armazenamento de blob do Azure permitem que você receba notificações quando determinadas ações ocorrem em seus blobs. Por exemplo, você pode receber uma notificação quando um novo blob é criado ou um blob existente é modificado. Esses eventos podem ser usados para definir alertas sobre outras ações ou fluxos de trabalho, como atualizar um banco de dados ou enviar uma notificação. Este artigo fornece as propriedades e o esquema para eventos de armazenamento de blob do Azure.

Nota

Não há suporte para o consumo de eventos do Fabric e do Azure por meio do eventstream ou do Fabric Activator se a região de capacidade do eventstream ou do Activator estiver nas seguintes regiões: Índia Ocidental, Israel Central, Coreia Central, Qatar Central, Singapura, EAU Central, Espanha Central, Brasil Sudeste, EUA Central, Sul Central dos EUA, Oeste dos EUA 2, Oeste dos EUA 3.

Exibir página de detalhes de eventos de armazenamento de blob do Azure

1. No hub em tempo real, selecione Eventos do Azure no menu de navegação esquerdo.

2. Selecione Eventos de armazenamento de blob do Azure na lista.

   

3. Você deve ver a página de detalhes de eventos de armazenamento de blob do Azure.

   

Ações

Na parte superior da página de detalhes dos eventos de armazenamento de blob do Azure, você verá as duas ações a seguir.

• Criar fluxo de eventos - permite criar um fluxo de eventos com base em eventos do armazenamento de blobs do Azure selecionado.

• Definir alerta - permite definir um alerta quando uma operação é concluída em um artefato de armazenamento de blob do Azure. Por exemplo, você pode definir um alerta quando um blob é criado ou excluído.

  

Veja o que está a utilizar esta categoria

Esta seção mostra artefatos usando eventos do Armazenamento de Blob do Azure. Aqui estão as colunas e suas descrições mostradas na lista.

Column	Descrição
Name	Nome do artefato que está usando eventos do Armazenamento de Blob do Azure.
Type	Tipo de artefato – Ativador ou fluxo de eventos
Área de trabalho	Espaço de trabalho onde o artefato vive.
Origem	Nome da origem (conta de Armazenamento de Blob do Azure).

Perfil de eventos de armazenamento de blob do Azure

Tipos de evento

Nome de tipo de evento	Descrição
Microsoft.Storage.BlobCreated	Esse evento é ativado quando um novo blob é adicionado ou quando um blob existente é atualizado. O evento é acionado por clientes que usam as CreateFile operações e FlushWithClose , que podem ser encontradas na API REST do Azure Data Lake Storage Gen2.
Microsoft.Storage.BlobDeleted	Esse evento é ativado quando um blob é removido. Ele é acionado quando os clientes usam a DeleteFile operação que pode ser encontrada na API REST do Azure Data Lake Storage Gen2.
Microsoft.Storage.BlobRenomeado	Esse evento é ativado quando um blob sofre uma alteração de nome, especialmente quando os usuários empregam a RenameFile função encontrada na API REST do Azure Data Lake Storage Gen2.
Microsoft.Storage.BlobTierChanged	Esse evento é ativado quando a camada de acesso de blob é modificada por meio da SetBlobTier operação na API REST de Blob e é acionado assim que a alteração é totalmente processada.
Microsoft.Storage.AsyncOperationInitiated	Esse evento ocorre quando os dados são movidos ou copiados do arquivo morto para as camadas quente ou fria. Isso acontece quando os clientes usam a SetBlobTier API para mover um blob de arquivo para camadas quentes ou frias, ou quando os clientes usam a CopyBlob API para copiar dados de um blob de camada de arquivamento para um blob de camada quente ou frio.
Microsoft.Storage.DirectoryCreated	Esse evento é ativado quando um novo diretório é criado ou um cliente utiliza a CreateDirectory operação fornecida na API REST do Azure Data Lake Storage Gen2 para formar um novo diretório.
Microsoft.Storage.DirectoryRenomeado	Esse evento é ativado quando um diretório sofre uma alteração de nome, particularmente quando os clientes utilizam o recurso RenameDirectory na API REST do Azure Data Lake Storage Gen2.
Microsoft.Storage.DirectoryDeleted	Esse evento é ativado quando um diretório é removido, quando os clientes utilizam o DeleteDirectory recurso presente na API REST do Azure Data Lake Storage Gen2.
Microsoft.Storage.BlobInventoryPolicyCompleted	Esse evento é ativado quando a execução do inventário é concluída para uma política especificada como uma política de inventário. Ele também é ativado se a execução do inventário falhar devido a um erro do usuário antes de começar, como uma política incorreta ou um contêiner de destino ausente.
Microsoft.Storage.LifecyclePolicyConcluído	Esse evento refere-se à ativação de uma política de gerenciamento do ciclo de vida quando suas ações definidas são executadas.

Esquemas

Um evento tem os seguintes dados de nível superior:

Propriedade	Type	Descrição	Exemplo
source	string	Caminho completo do recurso para a origem do evento. Este campo não pode ser gravado. O Event Grid fornece este valor.	/subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account
subject	string	Caminho definido pelo publicador para o assunto do evento.	/blobServices/default/containers/my-file-system/blobs/new-file.txt
type	string	Um dos tipos de eventos registados para esta origem de evento.	Microsoft.Storage.BlobCreated
time	string	A hora em que o evento é gerado com base na hora UTC do provedor.	2017-06-26T18:41:00.9584103Z
id	string	Identificador exclusivo do evento.	00000000-0000-0000-0000-000000000000
data	objeto	Dados de eventos de armazenamento de Blob.	{{Data object}}
specversion	string	Versão da especificação do esquema CloudEvents.	1.0
fabricsource	string	ID do fluxo de eventos Fabric para a origem de eventos do Armazenamento de Blobs do Azure.	/tenants/00000000-0000-0000-0000-000000000000/workspaces/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000000
fabricsubject	string	ID do link do evento para a fonte de eventos do Armazenamento de Blobs do Azure.	eventLinks/00000000-0000-0000-0000-000000000000

O data objeto tem as seguintes propriedades:

Propriedade	Type	Descrição	Exemplo
api	string	A operação que desencadeou o evento.	CreateFile
clientRequestId	string	Um ID de solicitação fornecido pelo cliente para a operação da API de armazenamento. Essa ID pode ser usada para correlacionar aos logs de diagnóstico do Armazenamento do Azure usando o client-request-id campo nos logs e pode ser fornecida em solicitações de cliente usando o x-ms-client-request-id cabeçalho. Consulte Formato de log.	00000000-0000-0000-0000-000000000000
requestId	string	ID de solicitação gerada pelo serviço para a operação da API de armazenamento. Pode ser usado para correlacionar aos logs de diagnóstico do Armazenamento do Azure usando o request-id-header campo nos logs e é retornado ao iniciar a x-ms-request-id chamada de API no cabeçalho. Consulte Formato de log.	00000000-0000-0000-0000-000000000000
eTag	string	O valor que você pode usar para executar operações condicionalmente.	\"0x8D4BCC2E4835CD0\"
contentType	string	O tipo de conteúdo especificado para o blob.	text/plain
contentLength	integer	O tamanho do blob em bytes.	0
blobType	string	O tipo de blob. Os valores válidos são ou BlockBlobPageBlob.	BlockBlob
contentOffset	Número	O deslocamento em bytes de uma operação de gravação feita no ponto em que o aplicativo que aciona eventos concluiu a gravação no arquivo. Aparece apenas para eventos acionados em contas de armazenamento de blob que têm um namespace hierárquico.	0
destinationUrl	string	A url do arquivo que existirá após a conclusão da operação. Por exemplo, se um arquivo for renomeado, a propriedade destinationUrl conterá a url do novo nome de arquivo. Aparece apenas para eventos acionados em contas de armazenamento de blob que têm um namespace hierárquico.	https://my-storage-account.dfs.core.windows.net/my-file-system/new-file.txt
sourceUrl	string	A url do arquivo que existe antes da operação ser feita. Por exemplo, se um arquivo for renomeado, o sourceUrl conterá a url do nome do arquivo original antes da operação de renomeação. Aparece apenas para eventos acionados em contas de armazenamento de blob que têm um namespace hierárquico.	https://my-storage-account.dfs.core.windows.net/my-file-system/my-original-directory
url	string	O caminho para o blob. Se o cliente usa uma API REST de Blob, a url tem esta estrutura: <storage-account-name>.blob.core.windows.net\<container-name>\<file-name>. Se o cliente usar uma API REST de armazenamento Data Lake, a url terá esta estrutura: <storage-account-name>.dfs.core.windows.net/<file-system-name>/<file-name>.	https://myaccount.blob.core.windows.net/container01/file.txt
recursive	string	True para executar a operação em todos os diretórios filho; caso contrário, False. Aparece apenas para eventos acionados em contas de armazenamento de blob que têm um namespace hierárquico.	true
sequencer	string	Um valor de cadeia de caracteres opaco que representa a sequência lógica de eventos para qualquer nome de blob específico. Os usuários podem usar a comparação de cadeia de caracteres padrão para entender a sequência relativa de dois eventos no mesmo nome de blob.	00000000000004420000000000028963
identity	string	Um valor de cadeia de caracteres que representa a identidade associada ao evento. Para Secure File Transfer Protocol (SFTP), o valor é o nome de usuário local.	localuser
storageDiagnostics	objeto	Dados de diagnóstico ocasionalmente incluídos pelo serviço de Armazenamento do Azure. Quando presente, os consumidores do evento devem ignorá-lo.	{{Storage diagnostic object}}

Conteúdos relacionados

• Explore eventos de item do espaço de trabalho do Fabric