Data.Cloud.AzureAPI.TAzureBlobService.SetBlobProperties

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function SetBlobProperties(ContainerName, BlobName: string; Properties: TStrings;  const LeaseId: string = ''; ResponseInfo: TCloudResponseInfo = nil): Boolean;

C++

bool __fastcall SetBlobProperties(System::UnicodeString ContainerName, System::UnicodeString BlobName, System::Classes::TStrings* Properties, const System::UnicodeString LeaseId = System::UnicodeString(), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0));

Propriétés

Type Visibilité  Source Unité  Parent
function public
Data.Cloud.AzureAPI.pas
Data.Cloud.AzureAPI.hpp
Data.Cloud.AzureAPI TAzureBlobService

Description

Définit les propriétés données sur le blob spécifié.

SetBlobProperties est utilisée pour définir les métadonnées pour un blob spécifié.

Le tableau suivant décrit les paramètres :

Paramètre Description

ContainerName

Le nom du conteneur dans lequel se trouve le blob.

BlobName

Le nom du blob pour lequel définir les propriétés.

Properties

Les propriétés à définir.

LeaseId

L'ID du bail, requis si le blob est verrouillé.

ResponseInfo

La classe optionnelle dans laquelle stocker les informations de la réponse.


Les propriétés supportées sont :

  • x-ms-blob-cache-control
  • x-ms-blob-content-type
  • x-ms-blob-content-md5
  • x-ms-blob-content-encoding
  • x-ms-blob-content-language

Pour les blobs de pages, les propriétés suivantes sont également supportées :

  • x-ms-blob-content-length
  • x-ms-sequence-number-action (max, update, incremen)
  • x-ms-blob-sequence-number (sauf si x-ms-sequence-number-action = increment).

Lors de l'émission d'une requête GetBlobProperties, les noms des propriétés diffèrent :

  • Cache-Control
  • Content-Type
  • Content-MD5
  • Content-Encoding
  • Content-Language

Les propriétés transmises reçoivent le préfixe x-ms-blob- si celui-ci manque. Toutes les autres propriétés seront ignorées.

LeaseId ne doit pas être une chaîne vide si le blob est verrouillé.

Avertissement : La méthode remplace le jeu complet de métadonnées existant actuellement sur le blob ; elle ne l'ajoute pas à celui-ci.

Remarque : La mise à jour des métadonnées d'un instantané n'est pas supportée.


La propriété x-ms-blob-content-length peut être définie pour modifier la valeur MaximumSize spécifiée lors de l'exécution de PutPageBlob.

La propriété x-ms-sequence-number-action peut avoir l'une des valeurs suivantes : max, update ou increment :

  • max : Utilise le plus grand entier, celui spécifié avec x-ms-blob-sequence-number ou celui déjà existant sur le serveur.
  • update : Remplace la valeur de x-ms-blob-sequence-number sur le serveur avec celle-ci.
  • increment : Incrémente par 1 la valeur de x-ms-blob-sequence-number du serveur. Ne spécifiez pas l'en-tête de x-ms-blob-sequence-number dans cette requête.

La méthode renvoie True si l'opération a réussi, et False sinon.


Voir aussi