Habilitación de los informes de inventario de blobs de Azure Storage

La característica de inventario de blobs de Azure Storage proporciona información general de los contenedores, blobs, instantáneas y versiones de blob dentro de una cuenta de almacenamiento. Use el informe de inventario para conocer diversos atributos de blobs y contenedores, como el tamaño total de los datos, la antigüedad, el estado de cifrado, la directiva de inmutabilidad y la suspensión legal, entre otros. El informe proporciona información general de los datos para los requisitos empresariales y de cumplimiento.

Para más información sobre los informes de inventario de blobs, consulte Inventario de blobs de Azure Storage.

Para habilitar los informes de inventario de blobs, agregue una directiva con una o más reglas a su cuenta de almacenamiento. Agregue, edite o quite una directiva mediante Azure Portal.

Habilitación de informes de inventario

Portal

1. Inicie sesión en Azure Portal para empezar a trabajar.

2. Busque la cuenta de almacenamiento y muestre la información general de la cuenta.

3. En Administración de datos, seleccione Inventario de blobs.

4. Seleccione Add your first inventory rule (Agregar la primera regla de inventario).

   Aparecerá la página Add a rule (Agregar una regla).

5. En la página Add a rule (Agregar una regla), asigne un nombre a la nueva regla.

6. Elija el contenedor que almacenará los informes de inventario.

7. En Object type to inventory (Tipo de objeto a inventario), seleccione si desea crear un informe para blobs o contenedores.

   Si selecciona Blob, en Blob subtype (Subtipo de blob), elija los tipos de blobs que desea incluir en el informe y si desea incluir versiones e instantáneas de blobs en el informe de inventario.

   Nota:

   La opción para incluir versiones de blob solo aparece para las cuentas que no tienen habilitada la característica de espacio de nombres jerárquico. Las versiones y las instantáneas deben estar habilitadas en la cuenta para guardar una nueva regla con la opción correspondiente habilitada.

8. Seleccione los campos que desea incluir en el informe y el formato de los informes.

9. Elija la frecuencia con la que desea generar informes.

10. Opcionalmente, agregue una coincidencia de prefijo para filtrar blobs en el informe de inventario.

11. Seleccione Guardar.

    

PowerShell

Puede agregar, editar o quitar una directiva mediante el módulo de Azure PowerShell.

1. Abra una ventana de comando de Windows PowerShell.

2. Asegúrese de que tiene el módulo más reciente de Azure PowerShell. Consulte Instalación del módulo de Azure PowerShell.

3. Inicie sesión en la suscripción a Azure con el comando Connect-AzAccount y siga las instrucciones de la pantalla.

   Connect-AzAccount
   

4. Si su identidad está asociada a más de una suscripción, establezca la suscripción activa.

   $context = Get-AzSubscription -SubscriptionId <subscription-id>
   Set-AzContext $context
   

   Reemplace el valor de marcador de posición <subscription-id> por el identificador de la suscripción.

5. Obtenga el contexto de la cuenta de almacenamiento que define la cuenta de almacenamiento que desea usar.

   $storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
   $ctx = $storageAccount.Context
   

   • Reemplace el marcador de posición <resource-group-name> por el nombre del grupo de recursos.

   • Reemplace el valor de marcador de posición <storage-account-name> por el nombre de la cuenta de almacenamiento.

6. Cree reglas de inventario con el comando New-AzStorageBlobInventoryPolicyRule. Cada regla enumera los campos de informe. Para obtener una lista completa de los campos de informe, consulte Inventario de blobs de Azure Storage.

    $containerName = "my-container"
   
    $rule1 = New-AzStorageBlobInventoryPolicyRule -Name Test1 -Destination $containerName -Disabled -Format Csv -Schedule Daily -PrefixMatch con1,con2 `
                -ContainerSchemaField Name,Metadata,PublicAccess,Last-modified,LeaseStatus,LeaseState,LeaseDuration,HasImmutabilityPolicy,HasLegalHold
   
    $rule2 = New-AzStorageBlobInventoryPolicyRule -Name test2 -Destination $containerName -Format Parquet -Schedule Weekly  -BlobType blockBlob,appendBlob -PrefixMatch aaa,bbb `
                -BlobSchemaField name,Last-Modified,Metadata,LastAccessTime
   
    $rule3 = New-AzStorageBlobInventoryPolicyRule -Name Test3 -Destination $containerName -Format Parquet -Schedule Weekly -IncludeBlobVersion -IncludeSnapshot -BlobType blockBlob,appendBlob -PrefixMatch aaa,bbb `
                -BlobSchemaField name,Creation-Time,Last-Modified,Content-Length,Content-MD5,BlobType,AccessTier,AccessTierChangeTime,Expiry-Time,hdi_isfolder,Owner,Group,Permissions,Acl,Metadata,LastAccessTime
   
    $rule4 = New-AzStorageBlobInventoryPolicyRule -Name test4 -Destination $containerName -Format Csv -Schedule Weekly -BlobType blockBlob -BlobSchemaField Name,BlobType,Content-Length,Creation-Time
   
   

7. Utilice el comando Set-AzStorageBlobInventoryPolicy para crear una directiva de inventario de blobs. Pase reglas a este comando mediante el parámetro -Rule.

   $policy = Set-AzStorageBlobInventoryPolicy -StorageAccount $storageAccount -Rule $rule1,$rule2,$rule3,$rule4  
   

CLI de Azure

Puede agregar, editar o eliminar una directiva mediante la CLI de Azure.

1. En primer lugar, abra Azure Cloud Shell o, si ha instalado la CLI de Azure localmente, abra una aplicación de consola de comandos como Windows PowerShell.

2. Si su identidad está asociada a más de una suscripción, establezca la suscripción activa.

      az account set --subscription <subscription-id>
   

   Reemplace el valor de marcador de posición <subscription-id> por el identificador de la suscripción.

3. Defina las reglas de la directiva en un documento JSON. A continuación se muestra el contenido de un archivo JSON de ejemplo denominado policy.json.

   {
   "enabled": true,
   "type": "Inventory",
   "rules": [
     {
       "enabled": true,
       "name": "inventoryPolicyRule2",
       "destination": "mycontainer",
       "definition": {
         "filters": {
           "blobTypes": [
             "blockBlob"
           ],
           "prefixMatch": [
             "inventoryprefix1",
             "inventoryprefix2"
           ],
           "includeSnapshots": true,
           "includeBlobVersions": true
         },
         "format": "Csv",
         "schedule": "Daily",
         "objectType": "Blob",
         "schemaFields": [
           "Name",
           "Creation-Time",
           "Last-Modified",
           "Content-Length",
           "Content-MD5",
           "BlobType",
           "AccessTier",
           "AccessTierChangeTime",
           "Snapshot",
           "VersionId",
           "IsCurrentVersion",
           "Metadata"
         ]
       }
     }
    ]
   }
   
   

4. Cree una directiva de inventario de blobs mediante el comando az storage account blob-inventory-policy create. Proporcione el nombre del documento JSON mediante el parámetro --policy.

   az storage account blob-inventory-policy create -g myresourcegroup --account-name mystorageaccount --policy @policy.json
   

Deshabilitar informes de inventario

Aunque puede deshabilitar informes individuales, también puede evitar que se ejecute el inventario de blobs.

1. Inicie sesión en Azure Portal.

2. Busque la cuenta de almacenamiento y muestre la información general de la cuenta.

3. En Administración de datos, seleccione Inventario de blobs.

4. Seleccione Configuración del inventario de blobs y, en el panel Configuración del inventario de blobs, desactive la casilla Habilitar inventario de blobs y luego seleccione Guardar.

   

   Al desactivar la casilla Habilitar inventario de blobs, se suspenden todas las ejecuciones de inventario de blobs. Puede activar esta casilla más adelante si desea reanudar las ejecuciones de inventario.

Suscripción al evento completado de la directiva de inventario de blobs

Puede suscribirse al evento completado del inventario de blobs para recibir información sobre el resultado de las ejecuciones de inventario. Este evento se desencadena cuando se completa la ejecución del inventario para una regla definida por una directiva de inventario. Este evento también tiene lugar si se produce un error de usuario en la ejecución del inventario antes de que se inicie el proceso. Por ejemplo, el evento se desencadenará en caso de que la directiva no sea válida o si se produce un error debido a la ausencia de un contenedor de destino.

1. Inicie sesión en Azure Portal.

2. Busque la cuenta de almacenamiento y muestre la información general de la cuenta.

3. En el menú de la izquierda, seleccione Eventos.

4. Seleccione + Suscripción de eventos.

   Aparecerá la página Crear suscripción a eventos.

5. En la página Crear suscripción a eventos, asigne un nombre a su suscripción a eventos y utilice el esquema predeterminado, esquema de Event Grid.

6. En TIPOS DE EVENTOS, elija Inventario de Blob Completado.

7. En DETALLES DEL PUNTO DE CONEXIÓN, elija Cola de almacenamiento como Tipo de punto de conexión y seleccione Configurar un punto de conexión.

8. En la página Colas, elija la suscripción, la cuenta de almacenamiento y cree una nueva cola. Asigne un nombre a la cola y haga clic en Crear.

9. Opcionalmente, seleccione la pestaña Filtros si desea filtrar el asunto del evento o sus atributos.

10. Opcionalmente, seleccione la pestaña Características adicionales si desea habilitar los mensajes fallidos, las directivas de reintento y establecer el tiempo de caducidad de la suscripción a eventos.

11. Opcionalmente, seleccione la pestaña Propiedades de entrega para establecer el período de vida de los mensajes de la cola de almacenamiento.

12. Seleccione Crear

Para ver los mensajes de cola entregados

1. Busque la cuenta de almacenamiento y muestre la información general de la cuenta.

2. En Almacenamiento de datos, seleccione Colas y abra la cola recién creada utilizada para configurar el punto de conexión para acceder a los mensajes.

3. Seleccione el mensaje para el tiempo de ejecución de inventario deseado para acceder a las propiedades del mensaje y revisar el cuerpo del mensaje para conocer el estado del evento.

Para más métodos sobre cómo suscribirse a eventos de Blob Storage, consulte Azure Blob Storage como origen de Event Grid: Azure Event Grid | Microsoft Learn

Habilitar el seguimiento de hora de acceso opcionalmente

Puede optar por habilitar el seguimiento del tiempo de acceso a blobs. Cuando se habilita el seguimiento del tiempo de acceso, los informes de inventario incluirán el campo LastAccessTime en función de la hora a la que se accedió por última vez al blob con una operación de lectura o escritura. Para reducir el efecto en la latencia del acceso de lectura, solo la primera lectura de las últimas 24 horas actualiza la hora del último acceso. Las lecturas posteriores en el mismo período de 24 horas no la actualizan. Si se modifica un blob entre lecturas, la hora del último acceso es la más reciente de los dos valores.

Portal

Haga lo siguiente para habilitar el seguimiento de la hora del último acceso con Azure Portal:

1. Inicie sesión en Azure Portal.

2. Busque la cuenta de almacenamiento y muestre la información general de la cuenta.

3. En Administración de datos, seleccione Inventario de blobs.

4. Seleccione Configuración del inventario de blobs y en el panel Configuración del inventario de blobs, active la casilla Habilitar el último seguimiento de acceso.

   

PowerShell

Para habilitar el seguimiento de la hora del último acceso con PowerShell, llame al comando Enable-AzStorageBlobLastAccessTimeTracking, como se muestra en el siguiente ejemplo. No olvide reemplazar los valores del marcador de posición entre corchetes angulares por sus propios valores:

# Initialize these variables with your values.
$rgName = "<resource-group>"
$accountName = "<storage-account>"

Enable-AzStorageBlobLastAccessTimeTracking  -ResourceGroupName $rgName `
    -StorageAccountName $accountName `
    -PassThru

CLI de Azure

Para habilitar el seguimiento de la hora del último acceso con la CLI de Azure, llame al comando az storage account blob-service-properties update, como se muestra en el siguiente ejemplo. No olvide reemplazar los valores del marcador de posición entre corchetes angulares por sus propios valores:

az storage account blob-service-properties update \
    --resource-group <resource-group> \
    --account-name <storage-account> \
    --enable-last-access-tracking true

Pasos siguientes

• Cálculo del recuento y el tamaño total de los blobs por contenedor
• Tutorial: Análisis de informes de inventario de blobs
• Administración del ciclo de vida de Azure Blob Storage