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; overload; deprecated 'Use overloaded method instead';
function PutBlockBlob(const AContainerName, ABlobName, ALeaseID: string; const AContent: TArray<Byte>;  const AOptionalHeaders, AMetadata: array of TPair<string, string>; const AResponseInfo: TCloudResponseInfo): Boolean; overload;

C++

bool __fastcall PutBlockBlob _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (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))/* overload */;
bool __fastcall PutBlockBlob(const System::UnicodeString AContainerName, const System::UnicodeString ABlobName, const System::UnicodeString ALeaseID, const System::DynamicArray<System::Byte> AContent, const System::Generics::Collections::TPair__2<System::UnicodeString,System::UnicodeString> *AOptionalHeaders, const int AOptionalHeaders_High, const System::Generics::Collections::TPair__2<System::UnicodeString,System::UnicodeString> *AMetadata, const int AMetadata_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

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