Data.Cloud.AzureAPI.TAzureBlobService.ListBlobsXML

De RAD Studio API Documentation
Aller à : navigation, rechercher

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 */;

Propriétés

Type Visibilité  Source Unité  Parent
function public
Data.Cloud.AzureAPI.pas
Data.Cloud.AzureAPI.hpp
Data.Cloud.AzureAPI TAzureBlobService

Description

Avertissement : ListBlobsXML est obsolète.

Renvoie la liste des blobs pour le conteneur donné en représentation XML.

ListBlobsXML est utilisée pour renvoyer la représentation XML des blobs du conteneur.

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.

OptionalParams

Les paires nom/valeur des paramètres optionnels.

ResponseInfo

La classe optionnelle dans laquelle stocker les informations de la réponse.

Les paramètres optionnels suivants sont pris en charge : prefix, delimiter, marker, par, 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 plus 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 plus de blobs que ne le permet maxresults, NextMarker du XML sera rempli, 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 le nom des blobs sous le conteneur $root ne peut pas contenir de barre oblique.

Voir aussi