Data.Cloud.AmazonAPI.TAmazonStorageService.GetObject
Delphi
function GetObject(const BucketName, ObjectName: string; OptionalParams: TAmazonGetObjectOptionals;
ObjectStream: TStream; ResponseInfo: TCloudResponseInfo = nil;
const BucketRegion: TAmazonRegion = amzrNotSpecified): Boolean; overload;
function GetObject(const BucketName, ObjectName: string;
ObjectStream: TStream; ResponseInfo: TCloudResponseInfo = nil;
const BucketRegion: TAmazonRegion = amzrNotSpecified): Boolean; overload;
C++
bool __fastcall GetObject(const System::UnicodeString BucketName, const System::UnicodeString ObjectName, const TAmazonGetObjectOptionals &OptionalParams, System::Classes::TStream* ObjectStream, Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0), const System::UnicodeString BucketRegion = System::UnicodeString())/* overload */;
bool __fastcall GetObject(const System::UnicodeString BucketName, const System::UnicodeString ObjectName, System::Classes::TStream* ObjectStream, Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0), const System::UnicodeString BucketRegion = System::UnicodeString())/* overload */;
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | Data.Cloud.AmazonAPI.pas Data.Cloud.AmazonAPI.hpp |
Data.Cloud.AmazonAPI | TAmazonStorageService |
Beschreibung
Schreibt den Stream für das angegebene Objekt oder gibt nil zurück.
Es gibt zwei überladene GetObject-Methoden. Zum Steuern der Anforderung verwenden Sie die erste überladene Methode mit dem Parameter OptionalParams.
Wenn die Anforderung mit dem Fehler 404 (File Not Found) fehlschlägt, dann wurde das angeforderte Objekt möglicherweise gelöscht. Wenn Sie eine ResponseInfo-Instanz bereitstellen, können Sie überprüfen, ob das Objekt gelöscht wurde. Zu diesem Zweck überprüfen Sie, ob es einen Antwort-Header x-amz-delete-marker gibt und dessen Wert auf True gesetzt ist.
Die Methode gibt den Stream des Objekts oder nil zurück.
Die folgende Tabelle gibt die Bedeutung der Parameter an:
| Parameter | Beschreibung |
|---|---|
|
|
Der Name des Buckets, in dem sich das Objekt befindet. |
|
|
Der Name des Objekts, das ermittelt werden soll. |
|
|
Die optionalen Parameter oder Header, die in der Anforderung verwendet werden sollen. |
|
|
Der Stream, in den geschrieben werden soll. Dieser darf nicht nil sein. |
|
|
Die optionale Klasse zum Speichern von Antwortinformationen. |
Siehe auch
- Data.Cloud.AmazonAPI.TAmazonGetObjectOptionals
- System.Classes.TStream
- Data.Cloud.AmazonAPI.TAmazonStorageService.CopyObject
- Data.Cloud.AmazonAPI.TAmazonStorageService.UploadObject
- Data.Cloud.AmazonAPI.TAmazonStorageService.GetObjectACL
- Data.Cloud.AmazonAPI.TAmazonStorageService.DeleteObject
- Introduction to Amazon S3 (amazonwebservices.com) (EN)