Data.Cloud.AzureAPI.TAzureBlobService.PutBlock

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function PutBlock(ContainerName, BlobName: string; const BlockId: string; Content: TArray<Byte>;  const ContentMD5: string = ''; const LeaseId: string = ''; ResponseInfo: TCloudResponseInfo = nil): Boolean;

C++

bool __fastcall PutBlock(System::UnicodeString ContainerName, System::UnicodeString BlobName, const System::UnicodeString BlockId, System::DynamicArray<System::Byte> Content, const System::UnicodeString ContentMD5 = System::UnicodeString(), 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

Crée un nouveau bloc à valider comme partie d'un blob.

PutBlock crée un nouveau bloc à valider comme partie d'un blob.


La taille d'un bloc peut avoir jusqu'à 4 Mo. BlockId doit être une chaîne codée en base 64, qui est inférieure ou égale à la taille de 64 octets avant son encodage.

Pour un blob donné, tous les identifiants de blocs doivent avoir la même taille. Après avoir téléchargé un ensemble de blocs, vous pouvez créer ou mettre à jour le blob sur le serveur depuis cet ensemble, par l'appel de PutBlockList. Dans l'intervalle, le blob ne contient pas ce bloc en tant que partie de son contenu. Si vous appelez PutBlock sur un blob qui n'existe pas encore, un nouveau blob de blocs non validé est créé avec une taille de contenu de 0.

Si vous appelez PutBlock en utilisant un BlockId d'un bloc non validé existant, le contenu sera remplacé.

Si PutBlockList n'est pas appelée dans un délai d'une semaine, tous les blocs non validés sont supprimés. Après avoir appelé PutBlockList, tous les blocs non validés non inclus dans la liste sont supprimés.

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 télécharger le bloc.

BlockId

L'identificateur qui identifie de façon unique le bloc.

Content

Le contenu du bloc en octets.

ContentMD5

Un hachage MD5 optionnel du contenu, à des fins de vérification.

LeaseId

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

ResponseInfo

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


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

Voir aussi