Data.Cloud.AmazonAPI.TAmazonStorageService.GetBucketXML

• Übergeordnet: TAmazonStorageService

Delphi

function GetBucketXML(const BucketName: string; OptionalParams: TStrings;  ResponseInfo: TCloudResponseInfo = nil; const BucketRegion: TAmazonRegion = amzrNotSpecified): string;

C++

System::UnicodeString __fastcall GetBucketXML(const System::UnicodeString BucketName, System::Classes::TStrings* OptionalParams, Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0), const System::UnicodeString BucketRegion = System::UnicodeString());

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	public	Data.Cloud.AmazonAPI.pas Data.Cloud.AmazonAPI.hpp	Data.Cloud.AmazonAPI	TAmazonStorageService

Beschreibung

Gibt bestimmte oder alle Objekte eines gegebenen Bucket zurück.

GetBucketXML gibt die XML-Repräsentation der Objekte zurück.

GetBucketXML akzeptiert die folgenden Parameter:

• BucketName: Der Name des Bucket, für das die Objekte ermittelt werden sollen.
• OptionalParams: Eine Liste mit Strings, die optionale Parameter festlegen. Weitere Informationen finden Sie in der Tabelle #Optionale Parameter weiter unten. Sie können für OptionalParams nil angeben.
• ResponseInfo: Optional. Enthält die Antwortinformationen.
• BucketRegion: Optional. Die Region des Bucket, für das die Objekte ermittelt werden sollen. Vorgabe ist amzrNotSpecified, was bedeutet, dass diese Methode automatisch die Region des Bucket anhand des Namens des Bucket ermittelt.

Optionale Parameter

Parameter	Beschreibung
delimiter	Legt das Begrenzungszeichen fest, mit dem ein Verzeichnis angegeben wird (häufig wird der Schrägstrich ('/') verwendet).
Präfix	Schränkt die Antwort auf Objektnamen ein, die mit dem angegebenen Präfix beginnen. Sie können zum Beispiel ein Präfix verwenden, um Gruppen auf dieselbe Art und Weise zu erstellen, wie Sie einen Ordner in einem Dateisystem verwenden.
marker	Der Name eines Objekts, mit dem die Liste der Objekte beginnen soll. Das Ergebnis enthält Objekte, die nach dem Marker kommen.
max-keys	Die maximale Anzahl von im Ergebnis enthaltenen Objekten. Vorgabe ist 1000.

Antwort

Wenn mehr als 1000 Objekte verfügbar sind oder Sie den optionalen Parameter max-keys angeben, enthält die ResponseInfo einen IsTruncated-Schlüssel mit dem Wert True. Um eine andere Anforderung für die abgeschnittenen Objekte zu stellen, übergeben Sie den Wert der Eigenschaft Marker des zuletzt abgerufenen Objekts als optionalen Parameter marker im neuen Methodenaufruf.

Siehe auch

• Data.Cloud.AmazonAPI.TAmazonStorageService.GetBucket
• Data.Cloud.AmazonAPI.TAmazonStorageService.GetBucketACLXML
• Data.Cloud.AmazonAPI.TAmazonStorageService.GetBucketACL
• Data.Cloud.AmazonAPI.TAmazonBucketResult

• Data.Cloud.AmazonAPI.TAmazonStorageService.CreateBucket

• Data.Cloud.AmazonAPI.TAmazonRegion

• AWS Documentation - Amazon Simple Storage: GET Bucket (List Objects) (EN)

• System.Classes.TStrings