Data.Cloud.AzureAPI.TAzureBlobService.ListBlobs

De RAD Studio API Documentation
Aller à : navigation, rechercher

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

ContainerName

Le conteneur pour lequel obtenir les blobs ou $root pour le conteneur racine.

NextMarker

Le jeton de continuation si tous les blobs n'ont pas été renvoyés.

OptionalParams

Les paires nom/valeur des paramètres facultatifs.

ResponseInfo

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.

Voir aussi