Help Center/ Object Storage Service/ SDK Reference/ iOS/ Bucket Management/ Setting or Obtaining a Bucket Quota
Updated on 2023-11-09 GMT+08:00

Setting or Obtaining a Bucket Quota

Setting a Bucket Quota

You can call setBucketQuota to set the bucket quota. Sample code is as follows:

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];
    
// Set the bucket quota.
OBSQuota *quota = [[OBSQuota alloc] initWithQuotaNumber:[NSNumber numberWithLongLong:1024*1024*1024]];
    
OBSSetBucketQuotaRequest *request = [[OBSSetBucketQuotaRequest alloc] initWithBucketName:@"bucketname" quota:quota];
[client setBucketQuota:request completionHandler:^(OBSSetBucketQuotaResponse *response, NSError *error) {
    NSLog(@"%@",response.statusCode);
}];

A bucket quota must be a non-negative integer expressed in bytes. The maximum value is 263 - 1.

Obtaining a Bucket Quota

You can call getBucketQuota to obtain a bucket quota. Sample code is as follows:

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];
    
// Obtain the bucket quota.
OBSGetBucketQuotaRequest *request = [[OBSGetBucketQuotaRequest alloc]initWithBucketName:@"bucketname"];
    
[client getBucketQuota:request completionHandler:^(OBSGetBucketQuotaResponse *response, NSError *error){
    NSLog(@"%@",response.quota);
}];