Data.Cloud.AmazonAPI.TAmazonStorageService.CreateBucket
Delphi
function CreateBucket(const BucketName: string; BucketACL: TAmazonACLType = amzbaPrivate;
const BucketRegion: TAmazonRegion = amzrNotSpecified;
ResponseInfo: TCloudResponseInfo = nil): Boolean;
C++
bool __fastcall CreateBucket(const System::UnicodeString BucketName, TAmazonACLType BucketACL = (TAmazonACLType)(0x1), const System::UnicodeString BucketRegion = System::UnicodeString(), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0));
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | Data.Cloud.AmazonAPI.pas Data.Cloud.AmazonAPI.hpp |
Data.Cloud.AmazonAPI | TAmazonStorageService |
Beschreibung
Erstellt ein neues Bucket mit dem gegebenen Namen für den S3-Dienst.
Bucket-Namen müssen für den Amazon S3-Dienst (Amazon Simple Storage Service) eindeutig sein. Wenn jemand bereits einen gegebenen Bucket-Namen mit seinem Konto verwendet hat, können Sie kein Bucket mit demselben Namen erstellen.
Bucket-Namen unterliegen einigen Beschränkungen:
- Sie müssen mit einer Zahl oder einem Buchstaben beginnen.
- Sie können Punkte, Unterstriche und Bindestriche, Zahlen sowie Kleinbuchstaben enthalten.
- Sie müssen aus 3 bis 255 Zeichen bestehen (normalerweise sollten sie nicht länger als 63 Zeichen sein).
- Sie dürfen nicht als IP-Adresse formatiert werden (z.B. 192.168.0.1).
Wenn Sie zudem beim Erstellen des Buckets eine Region angeben, muss deren Name den folgenden Regeln entsprechen:
- Er darf keine Unterstriche enthalten.
- Er muss aus 3 bis 53 Zeichen bestehen.
- Er darf nicht mit einem Bindestrich enden.
- Er darf keine zwei aufeinanderfolgenden Punkte enthalten.
- Er darf keinen Bindestrich neben einem Punkt enthalten (z.B. my.-bucket).
Durch Aufruf dieser Methode können Sie die Zugriffskontrollliste des Buckets, die Region oder beides setzen. Außerdem können Sie eine Region wählen, um die Kosten zu reduzieren oder die Wartezeit zu optimieren. Wenn Sie z.B. in Europa sind, möchten Sie Buckets höchstwahrscheinlich in einer EU-Region erstellen.
Die folgende Tabelle gibt die Bedeutung der Parameter an:
| Parameter | Beschreibung |
|---|---|
|
|
Der Name des zu erstellenden Buckets. |
|
|
Der ACL-Wert, der beim Erstellen des Buckets verwendet werden soll. Der Vorgabewert ist |
|
|
Die Region, in der das Bucket erstellt werden soll. |
|
|
Die optionale Klasse zum Speichern der Antwortinformationen. |
Die Methode gibt True zurück, wenn das Erstellen erfolgreich war, ansonsten False.