Data.Cloud.AmazonAPI.TAmazonStorageService.GetBucketXML
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());
Inhaltsverzeichnis
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ürOptionalParams
nil
angeben.ResponseInfo
: Optional. Enthält die Antwortinformationen.BucketRegion
: Optional. Die Region des Bucket, für das die Objekte ermittelt werden sollen. Vorgabe istamzrNotSpecified
, was bedeutet, dass diese Methode automatisch die Region des Bucket anhand des Namens des Bucket ermittelt.
Optionale Parameter
Parameter | Beschreibung |
---|---|
|
Legt das Begrenzungszeichen fest, mit dem ein Verzeichnis angegeben wird (häufig wird der Schrägstrich ('/') verwendet). |
|
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. |
|
Der Name eines Objekts, mit dem die Liste der Objekte beginnen soll. Das Ergebnis enthält Objekte, die nach dem Marker kommen. |
|
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.