Data.Cloud.AzureAPI.TAzureBlobService.PutBlockBlob

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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));

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
Data.Cloud.AzureAPI.pas
Data.Cloud.AzureAPI.hpp
Data.Cloud.AzureAPI TAzureBlobService


Beschreibung

Erstellt im angegebenen Container ein neues Block-Blob oder aktualisiert ein bereits vorhandenes Block-Blob.

Mit PutBlockBlob wird im angegebenen Container ein Block-Blob erstellt oder ein bereits vorhandenes Block-Blob ersetzt.

Die folgende Tabelle beschreibt die Parameter:

Parameter Beschreibung

ContainerName

Der Name des Blob-Containers

BlobName

Der Name des Blobs

Content

Der Inhalt, der im Blob gesetzt werden soll

LeaseId

Die optionale Leasing-ID

OptionalHeaders

Die optionalen Header

Metadata

Die Metadaten, die im Blob gesetzt werden sollen

ResponseInfo

Die optionale Klasse zum Speichern der Antwortinformationen

Wenn ein Blob mit dem gegebenen Namen (im angegebenen Container) bereits vorhanden ist, wird sein Inhalt mit den Daten aus diesem Aufruf ersetzt.

LeaseId sollte als leerer String gesetzt werden, außer wenn ein Blob mit dem angegebenen Namen bereits vorhanden und aktuell gesperrt ist.

Der Parameter OptionalHeaders kann in der Anforderung gesetzt werden. Solche optionale Header sind:

  • Content-Type (oder x-ms-blob-content-type)
  • Content-Encoding (oder x-ms-blob-content-encoding)
  • Content-Language (oder x-ms-blob-content-language)
  • Content-MD5 (oder x-ms-blob-content-md5)
  • Cache-Control (oder x-ms-blob-cache-control)
  • If-Modified-Since
  • If-Unmodified-Since
  • If-None-Match (Vergleicht den Wert des Entitäts-Tag (Etag) der Ressource mit dem Wert dieses Headers)
  • If-None-Match (Vergleicht den Etag-Wert der Ressource mit dem Wert dieses Headers)

Die Namen der optionalen Metadaten sollten mit 'x-ms-meta-' beginnen. Wenn nicht, wird dieses Präfix hinzugefügt.

Die maximale zulässige Inhaltslänge eines Block-Blobs ist 64 MB. Wenn größer, müssen Sie sie als Blöcke hochladen.

Die Methode gibt True zurück, wenn das Erstellen/Ersetzen erfolgreich war, ansonsten False.

Siehe auch