Data.Cloud.AmazonAPI.TAmazonStorageService.GetBucket

• Übergeordnet: TAmazonStorageService

Delphi

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

C++

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

Eigenschaften

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

Beschreibung

Gibt einige oder alle Objekte eines Bucket zurück.

GetBucket gibt ein TAmazonBucketResult-Objekt zurück, das die Objekte enthält.

GetBucket 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 #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 soll. 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 wenn 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.GetBucketXML
• 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