Data.Cloud.AmazonAPI.TAmazonStorageService.CreateBucket
Delphi
function CreateBucket(const BucketName: string; BucketACL: TAmazonACLType = amzbaNotSpecified; BucketRegion: TAmazonRegion = amzrNotSpecified; ResponseInfo: TCloudResponseInfo = nil): Boolean;
C++
bool __fastcall CreateBucket(const System::UnicodeString BucketName, TAmazonACLType BucketACL = (TAmazonACLType)(0x0), TAmazonRegion BucketRegion = (TAmazonRegion)(0x0), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0));
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | Data.Cloud.AmazonAPI.pas Data.Cloud.AmazonAPI.hpp |
Data.Cloud.AmazonAPI | TAmazonStorageService |
Description
Crée un nouveau compartiment avec le nom donné sur le service S3.
Les noms des compartiments doivent être uniques pour le service Amazon S3 (Service de stockage simple Amazon). Cela signifie que, si quelqu'un d'autre a déjà utilisé un nom de compartiment donné pour son compte, vous ne pouvez pas créer un compartiment avec le même nom.
Les noms des compartiments ont certaines restrictions :
- Ils doivent commencer par un nombre ou une lettre.
- Ils peuvent contenir des points, des traits de soulignement et des tirets, des nombres et des lettres minuscules.
- Ils doivent être dans l'intervalle de 3 à 255 caractères (même si généralement ils ne doivent pas dépasser 63 caractères).
- Ils doivent être formatés comme une adresse IP (par exemple, 192.168.0.1).
De plus, si vous spécifiez une région lors de la création du compartiment, son nom doit suivre les règles suivantes :
- Il ne peut pas contenir des traits de soulignement.
- Il doit être dans l'intervalle de 3 à 63 caractères.
- Il ne peut pas se terminer par un tiret.
- Il ne peut pas contenir deux points adjacents.
- Il ne peut pas contenir un tiret à côté d'un point (par exemple, 'mon.-compartiment').
Vous pouvez définir la liste de contrôle d'accès du compartiment, la région du compartiment, ou des deux par cet appel. Aussi, vous pouvez choisir une région afin de réduire les coûts ou d'optimiser la latence. Par exemple, si vous êtes en Europe, vous voudrez probablement créer des compartiments dans la région UE.
Le tableau suivant illustre la signification des paramètres :
| Paramètre | Description |
|---|---|
|
|
Le nom du compartiment à créer. |
|
|
La valeur ACL à utiliser lors de la création du compartiment. |
|
|
La région dans laquelle créer le compartiment. |
|
|
La classe facultative où stocker les informations sur la réponse. |
La méthode renvoie True si la création a réussi, et False sinon.