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; overload; deprecated 'Use overloaded method instead';
function SetBlobProperties(const AContainerName, ABlobName, ALeaseId: string;  const AProperties: array of TPair<string, string>; const AResponseInfo: TCloudResponseInfo): Boolean; overload;

C++

bool __fastcall SetBlobProperties _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (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))/* overload */;
bool __fastcall SetBlobProperties(const System::UnicodeString AContainerName, const System::UnicodeString ABlobName, const System::UnicodeString ALeaseId, const System::Generics::Collections::TPair__2<System::UnicodeString,System::UnicodeString> *AProperties, const int AProperties_High, Data::Cloud::Cloudapi::TCloudResponseInfo* const AResponseInfo)/* overload */;

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