Creating a Bucket

Updated on 2023-03-21 GMT+08:00

View PDF

A bucket is a global namespace of OBS and is a data container. It functions as a root directory of a file system and can store objects. Sample code is as follows:

OBSCreateBucketRequest *request = [[OBSCreateBucketRequest alloc] initWithBucketName:@"bucketname"];
[client createBucket:request completionHandler:^(OBSCreateBucketResponse *response, NSError *error) {
    NSLog(response.location);
}];

NOTE:

Bucket names are globally unique. Ensure that the bucket you create is named differently from any other bucket.
A bucket name must comply with the following rules:
- Contains 3 to 63 characters, starts with a digit or letter, and supports only lowercase letters, digits, hyphens (-), and periods (.)
- Cannot be an IP address.
- Cannot start or end with a hyphen (-) or period (.).
- Cannot contain two consecutive periods (.), for example, my..bucket.
- Cannot contain periods (.) and hyphens (-) adjacent to each other, for example, my-.bucket or my.-bucket.
For more information, see Bucket Management.