Activer et gérer le contrôle de version des objets blob

Article
08/03/2023

Vous pouvez activer le contrôle de version du stockage d’objets blob pour gérer automatiquement les versions précédentes d’un objet blob lorsqu’il est modifié ou supprimé. Lorsque le contrôle de version est activé, vous pouvez alors restaurer une version antérieure d’un objet blob pour récupérer vos données si celles-ci ont été modifiées ou supprimées par erreur.

Cet article explique comment activer ou désactiver le contrôle de version des blobs pour le compte de stockage à l’aide du portail Azure ou d’un modèle de Resource Manager. Pour en savoir plus sur le contrôle de version des blobs, consultez Contrôle de version des objets blob.

Activer la gestion des versions des objets blob

Vous pouvez activer le contrôle de version blob à partir du portail Azure, de PowerShell, d’Azure CLI ou d’un modèle Azure Resource Manager.

Pour activer le contrôle de version des objets blob d’un compte de stockage dans le portail Azure :

Accédez à votre compte de stockage dans le portail.
Sous Gestion des données, sélectionnez Protection des données.
Dans la section Suivi, sélectionnez Activer le contrôle de version pour les objets blob, puis choisissez de conserver toutes les versions ou de les supprimer après un certain temps.

Important

Si vous définissez l’option Supprimer les versions après, une règle est automatiquement ajoutée à la stratégie de gestion de cycle de vie du compte de stockage. Une fois cette règle ajoutée, l’option Supprimer les versions après n’apparaît plus dans la page Configuration de protection des données.

Vous pouvez faire réapparaître cette option dans la page Protection des données en supprimant la règle. Si votre stratégie de gestion de cycle de vie contient d’autres règles qui suppriment des versions, vous devez également supprimer ces règles avant que l’option Supprimer les versions après puisse réapparaître.

Pour activer le contrôle de version des objets blob d’un compte de stockage avec PowerShell, commencez par installer le module Az.Storage version 2.3.0 ou une version ultérieure. Appelez ensuite la commande Update-AzStorageBlobServiceProperty pour activer le contrôle de version, comme indiqué dans l’exemple suivant. N’oubliez pas de remplacer les valeurs entre crochets par vos propres valeurs :

# Set resource group and account variables.
$rgName = "<resource-group>"
$accountName = "<storage-account>"

# Enable versioning.
Update-AzStorageBlobServiceProperty -ResourceGroupName $rgName `
    -StorageAccountName $accountName `
    -IsVersioningEnabled $true

Pour activer le contrôle de version des objets blob d’un compte de stockage avec Azure CLI, commencez par installer Azure CLI version 2.2.0 ou une version ultérieure. Appelez ensuite la commande az storage account blob-service-properties update pour activer le contrôle de version, comme illustré dans l’exemple suivant. N’oubliez pas de remplacer les valeurs entre crochets par vos propres valeurs :

az storage account blob-service-properties update \
    --resource-group <resource_group> \
    --account-name <storage-account> \
    --enable-versioning true

Pour activer le contrôle de version des objets blob avec un modèle, créez un modèle avec la propriété IsVersioningEnabled sur true. Les étapes suivantes montrent comment créer un modèle dans le Portail Azure.

Dans le Portail Azure, choisissez Créer une ressource.
Dans Rechercher sur la Place de marché, tapez déploiement de modèle, puis appuyez sur Entrée.
Choisissez Template deployment, Créer, puis Créer votre propre modèle dans l’éditeur.
Dans l’éditeur de modèle, collez le code JSON suivant. Remplacez la valeur d’espace réservé <accountName> par le nom de votre compte de stockage.
Enregistrez le modèle.

Spécifiez le groupe de ressources du compte, puis choisissez le bouton Acheter pour déployer le modèle et activer le contrôle de version des objets blob.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {},
    "variables": {},
    "resources": [
        {
            "type": "Microsoft.Storage/storageAccounts/blobServices",
            "apiVersion": "2019-06-01",
            "name": "<accountName>/default",
            "properties": {
                "IsVersioningEnabled": true
            }
        }
    ]
}

Pour plus d’informations sur le déploiement de ressources à l’aide de modèles dans le Portail Azure, consultez Déployer des ressources avec le Portail Azure.

Répertorier les versions de blob

Pour afficher les versions d’un blob, utilisez le Portail Azure, PowerShell ou Azure CLI. Vous pouvez également répertorier les versions d’un blob à l’aide de l’un des SDK de stockage Blob.

Pour répertorier les versions d’un blob dans le Portail Azure :

Accédez à votre compte de stockage dans le portail, puis accédez au conteneur qui contient votre blob.
Sélectionnez le blob pour lequel vous souhaitez répertorier les versions.
Sélectionnez l’onglet Versions pour afficher les versions du blob.
Activez le bouton Afficher les versions supprimées pour afficher les versions supprimées de manière réversible. Si la suppression réversible d’objets blob est activée pour le compte de stockage, toutes les versions supprimées de manière réversible qui se trouvent toujours dans l’intervalle de rétention de suppression réversible s’affichent alors dans la liste.

Pour répertorier les versions d’un blob avec PowerShell, appelez la commande Get-AzStorageBlob avec le paramètre -IncludeVersion :

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

$blobs = Get-AzStorageBlob -Container $container -Prefix "ab" -IncludeVersion -Context $ctx

foreach($blob in $blobs)
{
    Write-Host $blob.Name
    Write-Host $blob.VersionId
    Write-Host $blob.IsLatestVersion
}

Pour répertorier les versions d’un blob avec Azure CLI, appelez la commande az storage blob directory list avec le paramètre--include v :

storageAccount="<storage-account>"
containerName="<container-name>"

az storage blob list \
    --container-name $containerName \
    --prefix "ab" \
    --query "[[].name, [].versionId]" \
    --account-name $storageAccount \
    --include v \
    --auth-mode login \
    --output tsv

Activer et gérer le contrôle de version des objets blob

Activer la gestion des versions des objets blob

Répertorier les versions de blob

Étapes suivantes

Ressources supplémentaires