Puede establecer el nivel de acceso de un blob de cualquiera de las maneras siguientes:
Estableciendo el nivel de acceso en línea predeterminado (frecuente o esporádico) para la cuenta de almacenamiento. Los blobs de la cuenta heredan este nivel de acceso a menos que invalide explícitamente la configuración de un blob individual.
Al establecer explícitamente el nivel de un blob en la carga. Puede crear un blob en el nivel de acceso frecuente, esporádico o de archivo.
Cambiando el nivel de un blob existente con una operación de Establecer nivel de blob. Normalmente, usaría esta operación para pasar de un nivel más frecuente a uno más esporádico.
Copiando un blob con una operación Copiar blob. Normalmente, usaría esta operación para pasar de un nivel más esporádico a uno más frecuente.
En este artículo se describe cómo administrar un blob en un nivel de acceso en línea. Para obtener más información sobre cómo mover un blob al nivel de archivo, consulte Archivado de un blob. Para más información sobre cómo rehidratar un blob desde el nivel de archivo, consulte Rehidratación de un blob archivado a un nivel en línea.
Establecimiento del nivel de acceso predeterminado de una cuenta de almacenamiento
La configuración predeterminada del nivel de acceso para una cuenta de almacenamiento de uso general v2 determina en qué nivel en línea se crea un nuevo blob de forma predeterminada. Puede establecer el nivel de acceso predeterminado para una cuenta de almacenamiento de uso general v2 en el momento de crear la cuenta o actualizando la configuración de una cuenta existente.
Al cambiar la configuración predeterminada del nivel de acceso para una cuenta de almacenamiento de uso general v2 existente, el cambio se aplica a todos los blobs de la cuenta para la que no se ha establecido explícitamente un nivel de acceso. Cambiar el nivel de acceso predeterminado puede tener un impacto en la facturación. Para obtener más información, consulte Configuración del nivel de acceso predeterminado de la cuenta.
Para establecer el nivel de acceso predeterminado para una cuenta de almacenamiento en el momento de la creación en Azure Portal, siga estos pasos:
Vaya a la página Cuentas de almacenamiento y seleccione el botón Crear.
Rellene la pestaña Datos básicos.
En la pestaña Opciones avanzadas, en Blob Storage, establezca el nivel de acceso en frecuente o esporádico. La configuración predeterminada es frecuente.
Seleccione Revisar y crear para validar la configuración y crear la cuenta de almacenamiento.
Para actualizar el nivel de acceso predeterminado para una cuenta de almacenamiento existente en Azure Portal, siga estos pasos:
Vaya a la cuenta de almacenamiento en Azure Portal.
En Configuración, seleccione Configuración.
Busque la configuración Nivel de acceso a blobs (valor predeterminado) y seleccione frecuente o esporádico. El valor predeterminado es frecuente si no ha configurado previamente esta propiedad.
Guarde los cambios.
Para cambiar la configuración predeterminada del nivel de acceso para una cuenta de almacenamiento con PowerShell, llame al comando Set-AzStorageAccount y especifique el nuevo nivel de acceso predeterminado.
Para cambiar la configuración predeterminada del nivel de acceso para una cuenta de almacenamiento con PowerShell, llame al comando Set-AzStorageAccount y especifique el nuevo nivel de acceso predeterminado.
# Change the storage account tier to cool
az storage account update \
--resource-group <resource-group> \
--name <storage-account> \
--access-tier Cool
N/D
Establecimiento del nivel de un blob en la carga
Al cargar un blob en Azure Storage, tiene dos opciones para establecer el nivel del blob en la carga:
Puede especificar explícitamente el nivel en el que se creará el blob. Esta configuración invalida el nivel de acceso predeterminado para la cuenta de almacenamiento. Puede establecer el nivel de un blob o un conjunto de blobs al cargarlos en frecuente, esporádico o de archivo.
Puede cargar un blob sin especificar un nivel. En este caso, el blob se creará en el nivel de acceso predeterminado especificado para la cuenta de almacenamiento (ya sea de frecuente o esporádico).
Si va a cargar un nuevo blob que usa un ámbito de cifrado, no puede cambiar el nivel de acceso de ese blob.
En las secciones siguientes se describe cómo especificar que un blob se cargue en el nivel frecuente o esporádico. Para más información sobre cómo archivar un blob al cargarlo, consulte Archive blobs on upload (Archivado de blobs al cargar).
Cargar un blob a un nivel en línea específico
Para crear un blob en el nivel frecuente o esporádico, especifíquelo al crear el blob. El nivel de acceso especificado en la carga invalida el nivel de acceso predeterminado para la cuenta de almacenamiento.
Para cargar un blob o un conjunto de blobs en un nivel específico desde Azure Portal, siga estos pasos:
Vaya al contenedor de destino.
Seleccione el botón Cargar.
Seleccione el archivo o los archivos que desea cargar.
Expanda la sección Opciones avanzadas y establezca el nivel de acceso en frecuente o esporádico.
Seleccione el botón Cargar.
Para cargar un blob o un conjunto de blobs en un nivel específico con PowerShell, llame al comando Set-AzStorageBlobContent como se muestra en el ejemplo a continuación. No olvide reemplazar los valores del marcador de posición entre corchetes con sus propios valores:
$rgName = <resource-group>
$storageAccount = <storage-account>
$containerName = <container>
# tier can be hot, cool, cold, or archive
$tier = <tier>
# Get context object
$ctx = New-AzStorageContext -StorageAccountName $storageAccount -UseConnectedAccount
# Create new container.
New-AzStorageContainer -Name $containerName -Context $ctx
# Upload a single file named blob1.txt to the cool tier.
Set-AzStorageBlobContent -Container $containerName `
-File "blob1.txt" `
-Blob "blob1.txt" `
-Context $ctx `
-StandardBlobTier Cool
# Upload the contents of a sample-blobs directory to the cool tier, recursively.
Get-ChildItem -Path "C:\sample-blobs" -File -Recurse |
Set-AzStorageBlobContent -Container $containerName `
-Context $ctx `
-StandardBlobTier $tier
Para cargar un blob en un nivel específico con CLI de Azure, llame al comando az storage blob upload como se muestra en el ejemplo a continuación. No olvide reemplazar los valores del marcador de posición entre corchetes con sus propios valores. Reemplace el <tier>marcador de posiciónhot por cool, cold o archive.
Para cargar un conjunto de blobs en un nivel específico con CLI de Azure, llame al comando az storage blob upload-batch como se muestra en el ejemplo a continuación. No olvide reemplazar los valores del marcador de posición entre corchetes con sus propios valores. Reemplace el <tier>marcador de posiciónhot por cool, cold o archive.
Para cargar un blob en un nivel específico mediante AzCopy, use el comando azcopy copy y establezca el parámetro --block-blob-tier en hot, cool o archive.
Nota:
En este ejemplo los argumentos de ruta de acceso se encierran entre comillas simples ('). Use comillas simples en todos los shells de comandos excepto en el shell de comandos de Windows (cmd.exe). Si usa un shell de comandos de Windows (cmd.exe), incluya los argumentos de la ruta de acceso entre comillas dobles ("") en lugar de comillas simples (''). En este ejemplo se excluye el token de SAS porque se supone que ha proporcionado las credenciales de autorización mediante Microsoft Entra ID. Consulte el artículo Introducción a AzCopy para información sobre las formas de proporcionar las credenciales de autorización para el servicio de almacenamiento.
Para cargar un conjunto de blobs en un nivel específico mediante AzCopy, consulte el directorio local o el contenido del directorio local y anexe --recursive=true al comando.
Las cuentas de almacenamiento tienen una configuración predeterminada del nivel de acceso que indica el nivel en línea en el que se crea un nuevo blob. La configuración predeterminada del nivel de acceso se puede establecer en frecuente o esporádico. El comportamiento de esta configuración es ligeramente diferente en función del tipo de cuenta de almacenamiento:
El nivel de acceso predeterminado de una nueva cuenta de almacenamiento v2 de uso general se establece en el nivel de acceso frecuente de manera predeterminada. Puede cambiar la configuración predeterminada del nivel de acceso al crear una cuenta de almacenamiento o después de crearla.
Al crear una cuenta heredada de Blob Storage, debe especificar la configuración de nivel de acceso predeterminada como frecuente o esporádico al crear una cuenta de almacenamiento. Puede cambiar la configuración predeterminada del nivel de acceso para una cuenta de almacenamiento después de crearla.
Un blob que no tiene un nivel asignado explícitamente infiere el nivel de la configuración predeterminada del nivel de acceso de la cuenta. Puede determinar si el nivel de acceso de un blob se deduce mediante Azure Portal, PowerShell o CLI de Azure.
Si el nivel de acceso de un blob se infiere de la configuración predeterminada del nivel de acceso de la cuenta, Azure Portal muestra el nivel de acceso como Frecuente (inferido) o Esporádico (inferido) .
Para determinar el nivel de acceso de un blob y si se deduce de Azure PowerShell, recupere el blob y compruebe sus propiedades AccessTier y AccessTierInferred.
$rgName = "<resource-group>"
$storageAccount = "<storage-account>"
$containerName = "<container>"
$blobName = "<blob>"
# Get the storage account context.
$ctx = New-AzStorageContext -StorageAccountName $storageAccount -UseConnectedAccount
# Get the blob from the service.
$blob = Get-AzStorageBlob -Context $ctx -Container $containerName -Blob $blobName
# Check the AccessTier and AccessTierInferred properties.
# If the access tier is inferred, that property returns true.
$blob.BlobProperties.AccessTier
$blob.BlobProperties.AccessTierInferred
Para determinar el nivel de acceso de un blob y si se deduce de la CLI de Azure, recupere el blob y compruebe sus propiedades blobTier y blobTierInferred.
Use PowerShell, la CLI de Azure, AzCopy v10 o una de las bibliotecas cliente de Azure Storage para mover un blob a otro nivel.
Cambio del nivel de un blob
Al cambiar el nivel de un blob, se mueve ese blob y todos sus datos al nivel de destino mediante una llamada a la operación Set Blob Tier (directamente o a través de una directiva de administración del ciclo de vida) o mediante el comando azcopy set-properties con AzCopy. Esta suele ser la mejor opción para cambiar un blob de un nivel más frecuente a uno más esporádico.
Para cambiar el nivel de un blob a un nivel más esporádico en Azure Portal, siga estos pasos:
Vaya al blob cuyo nivel desea cambiar.
Seleccione el blob y, a continuación, seleccione el botón Cambiar.
En el cuadro de diálogo Cambiar nivel, seleccione el nivel de destino.
Seleccione el botón Guardar.
Para cambiar el nivel de un blob a esporádico con PowerShell, use la propiedad BlobClient del blob para devolver una referencia de .NET al blob y, luego, llame al método SetAccessTier en esa referencia. No olvide reemplazar los valores de los marcadores de posición entre corchetes angulares por los suyos propios:
# Initialize these variables with your values.
$rgName = "<resource-group>"
$accountName = "<storage-account>"
$containerName = "<container>"
$blobName = "<blob>"
$tier = "<tier>"
# Get the storage account context
$ctx = (Get-AzStorageAccount `
-ResourceGroupName $rgName `
-Name $accountName).Context
# Change the blob's access tier.
$blob = Get-AzStorageBlob -Container $containerName -Blob $blobName -Context $ctx
$blob.BlobClient.SetAccessTier($tier, $null, "Standard")
Para cambiar el nivel de un blob a uno más esporádico con la CLI de Azure, llame al comando az storage blob set-tier. No olvide reemplazar los valores de los marcadores de posición entre corchetes angulares por los suyos propios:
Para cambiar el nivel de un blob a esporádico, use el comando azcopy set-properties y establezca el parámetro -block-blob-tier.
Importante
El uso de AzCopy para cambiar el nivel de acceso de un blob está actualmente en VERSIÓN PRELIMINAR.
Consulte Términos de uso complementarios para las versiones preliminares de Microsoft Azure para conocer los términos legales que se aplican a las características de Azure que se encuentran en la versión beta, en versión preliminar o que todavía no se han publicado para que estén disponibles con carácter general.
Nota
En este ejemplo los argumentos de ruta de acceso se encierran entre comillas simples ('). Use comillas simples en todos los shells de comandos excepto en el shell de comandos de Windows (cmd.exe). Si usa un shell de comandos de Windows (cmd.exe), incluya los argumentos de la ruta de acceso entre comillas dobles ("") en lugar de comillas simples (''). En este ejemplo se excluye el token de SAS porque se supone que ha proporcionado las credenciales de autorización mediante Microsoft Entra ID. Consulte el artículo Introducción a AzCopy para información sobre las formas de proporcionar las credenciales de autorización para el servicio de almacenamiento.
Para cambiar el nivel de acceso de todos los blobs de un directorio virtual, consulte el nombre del directorio virtual en lugar del nombre del blob y anexe --recursive=true al comando.
Mediante una llamada a la operación Copy Blob para copiar un blob de un nivel a otro. Cuando se copia un blob a un nivel diferente, se mueve ese blob y todos sus datos al nivel de destino. El blob de origen permanece en el nivel original y se crea uno nuevo en el nivel de destino. Se recomienda llamar a Copy Blob en la mayoría de los escenarios en los que se va a mover un blob a un nivel más frecuente, o se va a rehidratar un blob desde el nivel de archivo.
Para copiar un blob de esporádico a frecuente con PowerShell, llame al comando Start-AzStorageBlobCopy y especifique el nivel de destino. No olvide reemplazar los valores de los marcadores de posición entre corchetes angulares por los suyos propios:
# Initialize these variables with your values.
$rgName = "<resource-group>"
$accountName = "<storage-account>"
$srcContainerName = "<source-container>"
$destContainerName = "<dest-container>"
$srcBlobName = "<source-blob>"
$destBlobName = "<dest-blob>"
# Get the storage account context
$ctx = (Get-AzStorageAccount `
-ResourceGroupName $rgName `
-Name $accountName).Context
# Copy the source blob to a new destination blob in hot tier.
Start-AzStorageBlobCopy -SrcContainer $srcContainerName `
-SrcBlob $srcBlobName `
-DestContainer $destContainerName `
-DestBlob $destBlobName `
-StandardBlobTier Hot `
-Context $ctx
Para copiar un blob a un nivel más frecuente con la CLI de Azure, llame al comando az storage blob copy start y especifique el nivel de destino. No olvide reemplazar los valores de los marcadores de posición entre corchetes angulares por los suyos propios:
Para copiar un blob de esporádico a frecuente con AzCopy, use el comando azcopy copy y establezca el parámetro --block-blob-tier en hot.
Nota
En este ejemplo los argumentos de ruta de acceso se encierran entre comillas simples ('). Use comillas simples en todos los shells de comandos excepto en el shell de comandos de Windows (cmd.exe). Si usa un shell de comandos de Windows (cmd.exe), incluya los argumentos de la ruta de acceso entre comillas dobles ("") en lugar de comillas simples ('').
En este ejemplo se excluye el token de SAS porque se supone que ha proporcionado las credenciales de autorización mediante Microsoft Entra ID. Consulte el artículo Introducción a AzCopy para información sobre las formas de proporcionar las credenciales de autorización para el servicio de almacenamiento.
AzCopy no admite la copia desde un blob de origen en el nivel de archivo.
La operación de copia es sincrónica, por lo que cuando el comando devuelve un resultado, todos los archivos se han copiado.
Almacenamiento en niveles masivos
Para mover blobs a otro nivel de un contenedor o una carpeta, enumere blobs y llame a la operación Set Blob Tier en cada uno de ellos. En el ejemplo siguiente se muestra cómo realizar esta operación:
Cuando tenga que mover un gran número de blobs al nivel de archivo, use una operación por lotes para obtener un rendimiento óptimo. Una operación por lotes envía varias llamadas API al servicio con una única solicitud. Las operaciones secundarias admitidas por la operación Procesar bobs por lotes incluyen Eliminar blob y Establecer nivel del blob.
Nota:
La suboperación Establecer nivel de blob de la operación de Lote de blob aún no se admite en las cuentas que tienen un espacio de nombres jerárquico.
Para cambiar el nivel de acceso de los blobs con una operación por lotes, use una de las bibliotecas de cliente de Azure Storage. En el ejemplo de código siguiente se muestra cómo realizar una operación por lotes básica con la biblioteca cliente de .NET:
static async Task BulkArchiveContainerContents(string accountName, string containerName)
{
string containerUri = string.Format("https://{0}.blob.core.windows.net/{1}",
accountName,
containerName);
// Get container client, using Azure AD credentials.
BlobUriBuilder containerUriBuilder = new BlobUriBuilder(new Uri(containerUri));
BlobContainerClient blobContainerClient = new BlobContainerClient(containerUriBuilder.ToUri(),
new DefaultAzureCredential());
// Get URIs for blobs in this container and add to stack.
var uris = new Stack<Uri>();
await foreach (var item in blobContainerClient.GetBlobsAsync())
{
uris.Push(blobContainerClient.GetBlobClient(item.Name).Uri);
}
// Get the blob batch client.
BlobBatchClient blobBatchClient = blobContainerClient.GetBlobBatchClient();
try
{
// Perform the bulk operation to archive blobs.
await blobBatchClient.SetBlobsAccessTierAsync(blobUris: uris, accessTier: AccessTier.Archive);
}
catch (RequestFailedException e)
{
Console.WriteLine(e.Message);
}
}
Para obtener una aplicación de ejemplo detallada que muestra cómo cambiar los niveles con una operación por lotes, consulte AzBulkSetBlobTier.
