Data.Cloud.AzureAPI.TAzureBlobService.ListBlobs

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function ListBlobs(ContainerName: string; OptionalParams: TStrings = nil;  ResponseInfo: TCloudResponseInfo = nil): TList<TAzureBlob>; overload; deprecated 'Use overloaded method instead';
function ListBlobs(ContainerName: string; out NextMarker: string; OptionalParams: TStrings = nil;  ResponseInfo: TCloudResponseInfo = nil): TList<TAzureBlob>; overload; deprecated 'Use overloaded method instead';
function ListBlobs(const AContainerName: string; const APrefix: string; const ADelimiter: string;  const AMarker: string; AMaxResult: Integer; ADatasets: TAzureBlobDatasets; out ANextMarker: string; out ABlobPrefix: TArray<string>; out AResponseXML: string; const AResponseInfo: TCloudResponseInfo): TArray<TAzureBlobItem>; overload;

C++

System::Generics::Collections::TList__1<TAzureBlob*>* __fastcall ListBlobs _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, System::Classes::TStrings* OptionalParams = (System::Classes::TStrings*)(0x0), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
System::Generics::Collections::TList__1<TAzureBlob*>* __fastcall ListBlobs _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, /* out */ System::UnicodeString &NextMarker, System::Classes::TStrings* OptionalParams = (System::Classes::TStrings*)(0x0), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
System::DynamicArray<TAzureBlobItem> __fastcall ListBlobs(const System::UnicodeString AContainerName, const System::UnicodeString APrefix, const System::UnicodeString ADelimiter, const System::UnicodeString AMarker, int AMaxResult, TAzureBlobDatasets ADatasets, /* out */ System::UnicodeString &ANextMarker, /* out */ System::DynamicArray<System::UnicodeString> &ABlobPrefix, /* out */ System::UnicodeString &AResponseXML, Data::Cloud::Cloudapi::TCloudResponseInfo* const AResponseInfo)/* overload */;

Eigenschaften

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


Beschreibung

Gibt die Blob-Liste für den angegebenen Container zurück.

Mit ListBlobs wird die Liste der Blobs eines Containers zurückgegeben.

Es gibt zwei überladene Methoden ListBlobs. Die folgende Tabelle beschreibt die Parameter:

Parameter Beschreibung

ContainerName

Der Container, für den die Blobs ermittelt werden sollen oder $root für den Stamm-Container

NextMarker

Das Fortsetzungstoken, wenn nicht alle Blobs zurückgegeben wurden

OptionalParams

Die Namens-/Wertepaare der optionalen Parameter

ResponseInfo

Die optionale Klasse zum Speichern der Antwortinformationen

Folgende optionale Parameter werden unterstützt: prefix, delimiter, marker, maxresults, include={snapshots,metadata,uncommittedblobs}.

Wenn der Parameter prefix angegeben ist, werden nur die Blobs angezeigt, deren Namen mit dem angegebenen Präfix beginnen.

Wenn der Parameter delimiter angegeben ist, werden alle Blobs, deren Namen (nach dem Präfix-String) den Begrenzungsstring enthalten, in einen entsprechenden 'BlobPrefix'-Knoten unterteilt. Die Gruppierung stellt die Möglichkeit bereit, die Blobs in einer virtuellen Verzeichnisstruktur anzuzeigen, wobei Sie die Werte der zurückgegebenen 'BlobPrefix'-Namensknoten übernehmen und als Präfixwerte für nachfolgende Aufrufe verwenden können.

Wenn der Parameter marker angegeben ist, wird sein Wert als Fortsetzungstoken zum Abrufen weiterer Blobs ab der Position verwendet, an der ein vorheriger Aufruf beendet wurde, weil nicht alle Blobs zurückgegeben werden konnten.

Wenn der Parameter maxresults angegeben ist, wird sein Wert als Integer behandelt, der die maximale Anzahl der zurückzugebenden Blobs angibt. Der Vorgabewert (und die maximale Anzahl) ist 5000. Wenn mehr Blobs vorhanden sind, als maxresults zulässt, wird der Parameter NextMarker im XML-String gefüllt. Dieser Wert kann als Wert für marker in einem künftigen Aufruf verwendet werden.

Wenn der Parameter include angegeben ist, kann er einen String mit durch Komma getrennten Werten (CSV) enthalten, die sich auf eine oder mehrere der folgenden Angaben beziehen:

  • snapshots – Blob-Snapshots werden in die Antwort einbezogen (beginnend mit den ältesten bis zu den neuesten).
  • metadata – die Metadaten jedes Blobs werden in die Antwort einbezogen.
  • uncommittedblobs – Blobs mit nicht übergebenen Abschnitten werden in die Antwort einbezogen.

Warnung: Die Namen der Blobs im Stamm-Container ($root) dürfen keinen Schrägstrich enthalten.

Siehe auch