Data.Cloud.AzureAPI.TAzureBlobService.ListBlobs
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 */;
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
function | public | Data.Cloud.AzureAPI.pas Data.Cloud.AzureAPI.hpp |
Data.Cloud.AzureAPI | TAzureBlobService |
Description
Renvoie la liste de blobs pour le conteneur donné.
ListBlobs est utilisée pour renvoyer la liste des blobs du conteneur.
Il existe deux méthodes ListBlobs surchargées. Le tableau suivant décrit les paramètres :
Paramètre | Description |
---|---|
|
Le conteneur pour lequel obtenir les blobs ou $root pour le conteneur racine. |
|
Le jeton de continuation si tous les blobs n'ont pas été renvoyés. |
|
Les paires nom/valeur des paramètres facultatifs. |
|
La classe facultative dans laquelle stocker les informations sur la réponse. |
Les paramètres facultatifs suivants sont pris en charge : prefix
, delimiter
, marker
, maxresults
, include={snapshots,metadata,uncommittedblobs}
.
Si prefix
est spécifié, seulement les blobs dont les noms commencent par le préfixe spécifié sont affichés.
Si delimiter
est spécifié, tout blob dont le nom contient la chaîne délimiteur après la chaîne de préfixe sera groupé dans un noeud 'BlobPrefix', selon le cas. Le regroupement fournit une façon d'afficher les blobs avec une structure de répertoires virtuelle, où vous pouvez prendre les valeurs des noeuds de noms de 'BlobPrefix' renvoyés et les utiliser en tant que valeurs de préfixe pour les appels ultérieurs.
Si marker
est spécifié, il est utilisé en tant que jeton de continuation pour récupérer davantage de blobs du point où une invocation antérieure s'est arrêtée quand elle n'a pas pu renvoyer tous les blobs.
Si maxresults
est spécifié, il est traité comme un entier représentant le nombre maximal de blobs à renvoyer. Le nombre par défaut (et maximal) est 5000. S'il existe davantage de blobs qu'autorisé par maxresults
, la valeur NextMarker
du XML sera remplie, et vous pouvez l'utiliser en tant que valeur de marker
lors d'un appel futur.
Si include
est spécifié, il peut avoir une chaîne de valeurs séparées par des virgules (CSV) d'une ou de plusieurs des valeurs suivantes :
snapshots
— inclure dans la réponse des instantanés de blob (du plus ancien au plus récent).metadata
— inclure dans la réponse les métadonnées de chaque blob.uncommittedblobs
— inclure dans la réponse des blobs avec des sections non validées.
Avertissement : Notez que les blobs sous le conteneur $root ne peuvent pas contenir de barre oblique dans leur nom.