Data.Cloud.AzureAPI.TAzureBlobService.PutBlockBlob

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function PutBlockBlob(ContainerName, BlobName: string; Content: TArray<Byte>;  LeaseId: string = ''; OptionalHeaders: TStrings = nil; Metadata: TStrings = nil; ResponseInfo: TCloudResponseInfo = nil): Boolean;

C++

bool __fastcall PutBlockBlob(System::UnicodeString ContainerName, System::UnicodeString BlobName, System::DynamicArray<System::Byte> Content, System::UnicodeString LeaseId = System::UnicodeString(), System::Classes::TStrings* OptionalHeaders = (System::Classes::TStrings*)(0x0), System::Classes::TStrings* Metadata = (System::Classes::TStrings*)(0x0), 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

Crée un nouveau blob de blocs ou met à jour un blob de blocs existant du conteneur donné.

PutBlockBlob est utilisée pour créer ou remplacer un blob de blocs existant du conteneur donné.

Le tableau suivant décrit les paramètres :

Paramètre Description

ContainerName

Le nom du conteneur du blob.

BlobName

Le nom du blob.

Content

Le contenu à définir dans le blob.

LeaseId

L'ID du bail optionnel.

OptionalHeaders

Les en-têtes optionnels.

Metadata

Les métadonnées à définir sur le blob.

ResponseInfo

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

Si un blob de blocs avec le nom donné (du conteneur spécifié) existe déjà, son contenu sera remplacé par les données de cet appel.

Notez que LeaseId doit être défini en tant que chaîne vide, sauf si un blob avec le nom donné existe déjà et est actuellement verrouillé.

Le paramètre OptionalHeaders peut être défini sur la requête. Ces en-têtes optionnels sont :

  • Content-Type (ou x-ms-blob-content-type)
  • Content-Encoding (ou x-ms-blob-content-encoding)
  • Content-Language (ou x-ms-blob-content-language)
  • Content-MD5 (ou x-ms-blob-content-md5)
  • Cache-Control (ou x-ms-blob-cache-control)
  • If-Modified-Since
  • If-Unmodified-Since
  • If-Match (Compare la valeur de la balise d'entité de la ressource (Etag) à la valeur de cet en-tête)
  • If-None-Match (Compare la valeur Etag de la ressource à la valeur de cet en-tête)

Les noms des métadonnées optionnelles doivent commencer par 'x-ms-meta-'. Sinon, ce préfixe va être ajouté.

La longueur de contenu (Content-Length) maximale autorisée d'un blob de blocs est de 64 Mo. En cas de valeur supérieure, vous devez le télécharger en tant que blocs.

La méthode renvoie True si la création/le remplacement a réussi, et False sinon.

Voir aussi