Data.Cloud.AmazonAPI.TAmazonStorageService.CreateBucket

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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

BucketName

Der Name des zu erstellenden Buckets.

BucketACL

Der ACL-Wert, der beim Erstellen des Buckets verwendet werden soll. Der Vorgabewert ist amzbaPrivate.

BucketRegion

Die Region, in der das Bucket erstellt werden soll.

ResponseInfo

Die optionale Klasse zum Speichern der Antwortinformationen.

Die Methode gibt True zurück, wenn das Erstellen erfolgreich war, ansonsten False.

Siehe auch