Data.Cloud.AzureAPI.TAzureBlobService.ListBlobsXML

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function ListBlobsXML(ContainerName: string; OptionalParams: TStrings = nil;  ResponseInfo: TCloudResponseInfo = nil): string; overload; deprecated 'Use overloaded method instead';

C++

System::UnicodeString __fastcall ListBlobsXML _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 */;

Eigenschaften

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


Beschreibung

Warnung: ListBlobsXML ist veraltet.


Gibt die XML-Repräsentation der Blob-Liste für den angegebenen Container zurück.

Mit ListBlobsXML wird XML-Repräsentation der Liste der Blobs eines Containers zurückgegeben.

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

OptionalParams

Die Namens-/Wertepaare des optionalen Parameters

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 verwenden.

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