Définir un niveau d’objet blob

L’opération Set Blob Tier définit le niveau d’accès sur un objet blob. L’opération est autorisée sur un objet blob de pages dans un compte de stockage Premium et sur un objet blob de blocs dans un stockage d’objets blob ou un compte v2 à usage général. Le niveau d’un objet blob de pages Premium détermineP1P3P4/P2// la taille, les IOPS et la bande passante autorisées de l’objet blob. Le niveau d’un objet blob de blocs détermine le Hot//CoolArchive type de stockage. Cette opération ne met pas à jour l’ETag de l’objet blob.

Pour plus d’informations sur la hiérarchisation au niveau de l’objet blob de blocs , consultez niveaux de stockage chaud, froid et archive.

Requête

La demande Set Blob Tier peut être construite comme indiqué ci-dessous. HTTPS est recommandé. Remplacez myaccount par le nom de votre compte de stockage et myblob par le nom de l’objet blob pour lequel le niveau doit être modifié.

Méthode URI de demande Version HTTP
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tier HTTP/1.1

Paramètres URI

Les paramètres supplémentaires suivants peuvent être spécifiés dans l'URI de la demande.

Paramètre Description
snapshot facultatif. Le paramètre d’instantané est une valeur opaque DateTime qui, lorsqu’il est présent, spécifie l’instantané d’objet blob sur lequel définir le niveau. Pour plus d’informations sur l’utilisation des instantanés d’objets blob, consultez Création d’un instantané d’un objet blob
versionid Facultatif pour les versions 2019-12-12 et ultérieures. Le paramètre versionid est une valeur opaque DateTime qui, lorsqu’il est présent, spécifie la version de l’objet blob sur laquelle définir le niveau.
timeout facultatif. Le paramètre timeout est exprimé en secondes. Pour plus d’informations, consultez Définition des délais d’expiration pour les opérations du service Blob.

En-têtes de requête

Le tableau suivant décrit les en-têtes de demande obligatoires ou facultatifs.

En-tête de requête Description
Authorization Obligatoire. Spécifie le schéma d’autorisation, le nom du compte de stockage et la signature. Pour plus d’informations, consultez Autoriser les demandes à Stockage Azure.
Date ou x-ms-date Obligatoire. Spécifie la date/heure en temps universel coordonné (UTC) pour la requête. Pour plus d’informations, consultez Autoriser les demandes à Stockage Azure.
x-ms-access-tier Obligatoire. Indique le niveau à définir sur l’objet blob. Pour obtenir la liste des niveaux d’objets blob de pages Premium autorisés, consultez les Stockage Premium hautes performances et les disques managés pour les machines virtuelles. Pour le stockage d’objets blob ou le compte v2 à usage général, les valeurs valides sont HotArchive/Cool/. Pour plus d’informations sur la hiérarchisation au niveau du compte d’objets blob d’objets blob standard , consultez niveaux de stockage chaud, froid et archive.
x-ms-version Obligatoire pour toutes les demandes autorisées. Spécifie la version de l'opération à utiliser pour cette demande. Pour plus d’informations, consultez Contrôle de version des services de stockage Azure.
x-ms-client-request-id facultatif. Fournit une valeur opaque générée par le client avec une limite de caractères de 1 kB enregistrée dans les journaux d’analyse lorsque la journalisation d’analytique de stockage est activée. L’utilisation de cet en-tête est fortement recommandée pour la mise en corrélation des activités côté client avec les requêtes reçues par le serveur. Pour plus d’informations, consultez À propos de la journalisation Storage Analytics et de la journalisation Azure : utilisation des journaux pour suivre les demandes de stockage.
x-ms-rehydrate-priority facultatif. Indique la priorité avec laquelle réalimenter un objet blob archivé. Prise en charge sur la version 2019-02-02 et ultérieure pour les objets blob de blocs. Les valeurs valides sont High/Standard. La priorité peut être définie sur un objet blob une seule fois pour les versions antérieures à 2020-06-12 ; cet en-tête sera ignoré lors des demandes suivantes. Le paramètre de priorité par défaut est Standard.

À compter de la version 2020-06-12, la priorité de réhydratation peut être mise à jour une fois qu’elle a été définie précédemment. Le paramètre de Standard priorité peut être remplacé par l’appel de HighDéfinir le niveau d’objet blob avec cet en-tête défini High sur et sur x-ms-access-tier la même valeur que celle définie précédemment. Le paramètre de priorité ne peut pas être réduit de High à Standard.

Cette opération prend également en charge l’utilisation d’en-têtes conditionnels pour hiérarchiser l’objet blob uniquement si une condition spécifiée est remplie. Pour plus d’informations, consultez Spécification des en-têtes conditionnels pour les opérations du service Blob.

Corps de la demande

Aucun.

response

La réponse inclut un code d'état HTTP et un ensemble d'en-têtes de réponse.

Code d’état

Une opération réussie retourne le code d’état 200 (OK) si le nouveau niveau prend effet immédiatement, ou le code d’état 202 (accepté) si la transition vers le nouveau niveau est en attente. Pour l’opération d’objet blob de pages de compte Premium, retourne le code d’état 200 (OK). Pour les objets blob de blocs, le tableau ci-dessous décrit les codes d’état HTTP retournés en fonction du niveau actuel et du niveau demandé de l’objet blob :

Niveau Définir sur le niveau chaud Définir le niveau froid Définir sur le niveau Archive
Objet blob dans le niveau chaud 200 200 200
Objet blob dans le niveau froid 200 200 200
Objet blob dans le niveau Archive 202 202 200
Objet blob dans le niveau Archive, réhydratage à chaud 202 409 409
Objet blob dans le niveau Archive, réhydratage à froid 409 202 409

Pour plus d’informations sur les codes d’état, consultez Les codes d’état et d’erreur.

En-têtes de réponse

La réponse de cette opération inclut les en-têtes ci-dessous. La réponse peut aussi inclure des en-têtes HTTP standard supplémentaires. Tous les en-têtes standard sont conformes à la spécification du protocole HTTP/1.1.

En-tête de réponse Description
x-ms-request-id Cet en-tête identifie de façon unique la demande qui a été effectuée et peut être utilisé pour résoudre les problèmes de la demande. Pour plus d’informations, consultez Résolution des problèmes liés aux opérations d’API.
x-ms-version Indique la version du service BLOB utilisée pour exécuter la demande. Cet en-tête est retourné pour les demandes effectuées sur la version 2009-09-19 et les versions ultérieures.
x-ms-client-request-id Cet en-tête peut être utilisé pour résoudre les demandes et les réponses correspondantes. La valeur de cet en-tête est égale à la valeur de l’en-tête x-ms-client-request-id s’il est présent dans la requête et que la valeur est au maximum de 1024 caractères ASCII visibles. Si l’en-tête x-ms-client-request-id n’est pas présent dans la requête, cet en-tête ne sera pas présent dans la réponse.

Autorisation

Cette opération ne peut être appelée que par le propriétaire du compte de stockage et par toute personne disposant d’une signature d’accès partagé qui a l’autorisation d’écrire dans cet objet blob ou son conteneur.

Notes

La définition du niveau d’un objet blob pour les objets blob de pages dans les comptes Premium a les restrictions suivantes :

La définition du niveau de l’objet blob de blocs sur un compte de stockage d’objets blob ou de compte v2 à usage général a les restrictions suivantes :

  • La définition du niveau sur un instantané est autorisée à partir de REST version 2019-12-12.
  • Les instantanés hiérarchisé à archive ne peuvent pas être réhydratés dans l’instantané. C’est-à-dire que l’instantané ne peut pas être renvoyé au niveau Chaud/Froid. Seul le moyen de récupérer les données à partir d’un instantané ou d’une version archivé consiste à copier celui-ci dans un nouvel objet blob.
  • Si la version est un objet blob racine, cela peut être réhydraté vers Chaud ou Froid.
  • Les instantanés ou les versions dans l’état archivé ne sont pas autorisés à être promus vers la racine.
  • Lorsque le contrôle de version est activé, la suppression de l’objet blob racine lorsqu’il est en attente de réhydraté entraîne l’annulation de la réhydraté et la version est en état archivé.
  • Si un objet blob est remplacé lorsqu’il est en attente et supprimé de manière réversible, il entraîne l’annulation de la réhydraté et la version ou la capture instantanée supprimée réversible est dans l’état archivé.

La liste des niveaux pris en charge n’est pas limitée par la version de la demande et de nouveaux niveaux peuvent être ajoutés à l’avenir.

Notes

Pour plus d’informations sur la hiérarchisation au niveau des objets blob de blocs, consultez niveaux de stockage chaud, froid et archive.

Voir aussi

Autoriser les demandes dans stockage Azure
Codes d’état et d’erreur
Codes d’erreur de service BLOB
Définition de délais d'expiration pour les opérations du service BLOB