Help Center> Object Storage Service> iOS> Versioning Management> Setting Versioning Status for a Bucket
Updated on 2023-11-09 GMT+08:00

Setting Versioning Status for a Bucket

You can call setBucketVersioning to set the versioning status for a bucket. OBS supports two versioning statuses.

Versioning Status

Description

Value in OBS iOS SDK

Enabled

  1. OBS creates a unique version ID for each uploaded object. Namesake objects are not overwritten and are distinguished by their own version IDs.
  2. Objects can be downloaded by specifying the version ID. By default, the latest object is downloaded if no version ID is specified.
  3. Objects can be deleted by specifying the version ID. If an object is deleted with no version ID specified, the object will generate a delete marker with a unique version ID but is not physically deleted.
  4. Objects of the latest version in a bucket are returned by default after OBSListObjectsRequest is called. You can call OBSListObjectsVersionsRequest to list a bucket's objects with all version IDs.
  5. Except for delete markers, storage space occupied by objects with all version IDs is billed.

OBSVersioningStatusEnabled

Suspended

  1. Existing objects with version IDs are not affected.
  2. OBS creates version ID null to an uploaded object and the object will be overwritten after a namesake one is uploaded.
  3. Objects can be downloaded by specifying the version ID. By default, the latest object is downloaded if no version ID is specified.
  4. Objects can be deleted by version ID. If an object is deleted with no version ID specified, the object is only attached with a deletion mark and version ID null. Objects with version ID null are physically deleted.
  5. Except for delete markers, storage space occupied by objects with all version IDs is billed.

OBSVersioningStatusSuspended

Sample code:

static OBSClient *client;
NSString *endPoint = @"your-endpoint";
// Hard-coded or plaintext AK/SK are risky. For security purposes, encrypt your AK/SK and store them in the configuration file or environment variables. In this example, the AK/SK are stored in environment variables for identity authentication. Before running this example, configure environment variables AccessKeyID and SecretAccessKey.
// Obtain an AK/SK pair on the management console. For details, see https://support.huaweicloud.com/intl/en-us/usermanual-ca/ca_01_0003.html.
char* ak_env = getenv("AccessKeyID");
char* sk_env = getenv("SecretAccessKey");
NSString *AK = [NSString stringWithUTF8String:ak_env];
NSString *SK = [NSString stringWithUTF8String:sk_env];
    
// Initialize identity authentication.
OBSStaticCredentialProvider *credentialProvider = [[OBSStaticCredentialProvider alloc] initWithAccessKey:AK secretKey:SK];
    
//Initialize service configuration.
OBSServiceConfiguration *conf = [[OBSServiceConfiguration alloc] initWithURLString:endPoint credentialProvider:credentialProvider];
    
// Initialize an instance of OBSClient.
client = [[OBSClient alloc] initWithConfiguration:conf];
    
// Enable versioning for a bucket.
OBSBucketVersioningConfiguration *conf1 = [OBSBucketVersioningConfiguration new];
    
conf1.status = OBSVersioningStatusEnabled;
// Configure versioning.
OBSSetBucketVersioningRequest *request = [[OBSSetBucketVersioningRequest alloc] initWithBucketName:@"bucketname" configuration: conf];
[client setBucketVersioning:request completionHandler:^(OBSSetBucketVersioningResponse *response, NSError *error) {
    NSLog(@"%@",response);
}];