
# 设置桶多版本状态
您可以通过setBucketVersioning设置桶的多版本状态。OBS中的桶支持两种多版本状态：
| **多版本状态** | **说明**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | **OBS iOS SDK对应值**           |
|:---|:---|:---|
| 启用状态      | 1. 上传对象时，系统为每一个对象创建一个唯一版本号，上传同名的对象将不再覆盖旧的对象，而是创建新的不同版本号的同名对象。  2. 可以指定版本号下载对象，不指定版本号默认下载最新对象。  3. 删除对象时可以指定版本号删除，不带版本号删除对象仅产生一个带唯一版本号的删除标记，并不删除对象。  4. 列出桶内对象列表（OBSListObjectsRequest）时默认列出最新对象列表，可以指定列出桶内所有版本对象列表（OBSListObjectsVersionsRequest）。  5. 除了删除标记外，每个版本的对象存储均需计费   | OBSVersioningStatusEnabled   |
| 暂停状态      | 1. 旧的版本数据继续保留。  2. 上传对象时创建对象的版本号为null，上传同名的对象将覆盖原有同名的版本号为null的对象。  3. 可以指定版本号下载对象，不指定版本号默认下载最新对象。  4. 删除对象时可以指定版本号删除，不带版本号删除对象将产生一个版本号为null的删除标记，并删除版本号为null的对象。  5. 除了删除标记外，每个版本的对象存储均需计费。                                                                                                   | OBSVersioningStatusSuspended |
   
以下代码展示了如何设置桶的多版本状态：
```
static OBSClient *client;
NSString *endPoint = @"https://your-endpoint";
// 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量AccessKeyID和SecretAccessKey。
// 您可以登录访问管理控制台获取访问密钥AK/SK，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html
char* ak_env = getenv("AccessKeyID");
char* sk_env = getenv("SecretAccessKey");
if (ak_env == NULL || sk_env == NULL) {
    NSLog(@"Error: AccessKeyID or SecretAccessKey environment variable not set");
    return;
}
NSString *AK = [NSString stringWithUTF8String:ak_env];
NSString *SK = [NSString stringWithUTF8String:sk_env];
    
// 初始化身份验证
OBSStaticCredentialProvider *credentialProvider = [[OBSStaticCredentialProvider alloc] initWithAccessKey:AK secretKey:SK];
    
//初始化服务配置
OBSServiceConfiguration *conf = [[OBSServiceConfiguration alloc] initWithURLString:endPoint credentialProvider:credentialProvider];
    
// 初始化client
client = [[OBSClient alloc] initWithConfiguration:conf];
    
// 配置桶多版本
OBSBucketVersioningConfiguration *conf1 = [OBSBucketVersioningConfiguration new];
    
conf1.status = OBSVersioningStatusEnabled;
// 设置桶多版本
OBSSetBucketVersioningRequest *request = [[OBSSetBucketVersioningRequest alloc] initWithBucketName:@"bucketname" configuration: conf1];
[client setBucketVersioning:request completionHandler:^(OBSSetBucketVersioningResponse *response, NSError *error) {
    NSLog(@"%@",response);
}];
```
