Data.Cloud.AzureAPI.TAzureBlobService.ListBlobsXML
Delphi
function ListBlobsXML(ContainerName: string; OptionalParams: TStrings = nil; ResponseInfo: TCloudResponseInfo = nil): string;
C++
System::UnicodeString __fastcall ListBlobsXML(System::UnicodeString ContainerName, System::Classes::TStrings* OptionalParams = (System::Classes::TStrings*)(0x0), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0));
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 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 |
---|---|
|
Le conteneur pour lequel obtenir les blobs, ou $root pour le conteneur racine. |
|
Les paires nom/valeur des paramètres optionnels. |
|
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.