Help Center/ Object Storage Service/ SDK Reference/ iOS/ Quick Start/ General Examples of OBSClient
Updated on 2023-11-09 GMT+08:00

General Examples of OBSClient

If no error is generated when you call an API in an instance of the OBSClient class, the operation is successful. Otherwise, the operation fails. Sample code is as follows:

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.
OBSClient *client = [[OBSClient alloc] initWithConfiguration:conf];


// Create a request for listing objects.
OBSListBucketsRequest *request = [OBSListBucketsRequest new];

// List objects.
OBSBFTask *task = [client listBuckets:request completionHandler:^(OBSListBucketsResponse *response, NSError *error) {
    if(error){
        // Rectify the fault.
       
    }else{
        // Obtain the result.
        for(OBSBucket *bucket in response.bucketsList){
            NSLog(@"bucketname=%@",bucket.name);
        }
    }
}];
[task waitUntilFinished];
  • As an instance of OBSClient is declared as a local variable, when an OBSClient API is called, the waitUntilFinished operation must be performed on the request task to ensure that the instance of OBSClient is always valid during the request task execution. Otherwise, the network request may fail and the program may break down.