Data.Cloud.AmazonAPI.TAmazonStorageService.CreateBucket
Delphi
function CreateBucket(const BucketName: string; BucketACL: TAmazonACLType = amzbaPrivate; BucketRegion: TAmazonRegion = amzrNotSpecified; ResponseInfo: TCloudResponseInfo = nil): Boolean;
C++
bool __fastcall CreateBucket(const System::UnicodeString BucketName, TAmazonACLType BucketACL = (TAmazonACLType)(0x1), 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.
Il existe des restrictions aux noms de compartiment :
- Ils doivent commencer par un chiffre ou une lettre.
- Ils peuvent contenir des points, des traits de soulignement et des tirets, des chiffres et des lettres en minuscule.
- 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 ne doivent pas être formatés comme une adresse IP (par exemple, 192.168.0.1).
De plus, si vous spécifiez une région en créant le compartiment, son nom doit suivre les règles suivantes :
- Il ne peut pas contenir de traits de soulignement.
- Il doit avoir une longueur comprise entre 3 et 63 caractères.
- Il ne peut pas finir par un tiret.
- Il ne peut pas contenir deux points de suite.
- Il ne peut pas contenir de tiret à côté d'un point (par exemple, 'my.-bucket').
Vous pouvez définir la liste de contrôle d'accès du compartiment, la région, ou les deux, avec cet appel. Vous pouvez également 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 pour la région Union Européenne.
Le tableau suivant présente la signification des paramètres :
| Paramètre | Description |
|---|---|
|
|
Le nom du compartiment à créer. |
|
|
La valeur ACL à utiliser à la création du compartiment. La valeur par défaut est |
|
|
La région dans laquelle créer le compartiment. |
|
|
La classe facultative dans laquelle stocker les informations sur la réponse. |
La méthode renvoie True si la création a réussi, et False sinon.