更新时间:2024-05-08 GMT+08:00

复制对象

复制对象特性用来为OBS上已经存在的对象创建一个副本。

您可以通过copyObject来复制对象。复制对象时,可重新指定新对象的属性和设置对象权限,且支持条件复制。

简单复制

以下代码展示了如何进行简单复制:

static OBSClient *client;
NSString *endPoint = @"your-endpoint";
// 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全;本示例以ak和sk保存在环境变量中为例,运行本示例前请先在本地环境中设置环境变量AccessKeyID和SecretAccessKey。
// 您可以登录访问管理控制台获取访问密钥AK/SK,获取方式请参见https://support.huaweicloud.com/intl/zh-cn/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];
    
// 初始化身份验证
OBSStaticCredentialProvider *credentialProvider = [[OBSStaticCredentialProvider alloc] initWithAccessKey:AK secretKey:SK];
    
//初始化服务配置
OBSServiceConfiguration *conf = [[OBSServiceConfiguration alloc] initWithURLString:endPoint credentialProvider:credentialProvider];
    
// 初始化client
client = [[OBSClient alloc] initWithConfiguration:conf];
    
OBSCopyObjectRequest *request = [[OBSCopyObjectRequest alloc]initWithSrcBucketName:@"source-bucketname" srcObjectKey:@"objectname1" dstBucketName:@"destination-bucketname" dstObjectKey:@"objectname2"];
    
[client copyObject:request completionHandler:^(OBSCopyObjectResponse *response, NSError *error){
    NSLog(@"%@",response);
}] ;

重写对象属性

以下代码展示了如何在复制对象时重写对象属性:

static OBSClient *client;
NSString *endPoint = @"your-endpoint";
// 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全;本示例以ak和sk保存在环境变量中为例,运行本示例前请先在本地环境中设置环境变量AccessKeyID和SecretAccessKey。
// 您可以登录访问管理控制台获取访问密钥AK/SK,获取方式请参见https://support.huaweicloud.com/intl/zh-cn/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];
    
// 初始化身份验证
OBSStaticCredentialProvider *credentialProvider = [[OBSStaticCredentialProvider alloc] initWithAccessKey:AK secretKey:SK];
    
//初始化服务配置
OBSServiceConfiguration *conf = [[OBSServiceConfiguration alloc] initWithURLString:endPoint credentialProvider:credentialProvider];
    
// 初始化client
client = [[OBSClient alloc] initWithConfiguration:conf];
    
OBSCopyObjectRequest *request = [[OBSCopyObjectRequest alloc]initWithSrcBucketName:@"source-bucketname" srcObjectKey:@"objectname1" dstBucketName:@"destination-bucketname" dstObjectKey:@"objectname2"];
    
// 属性重写
request.dstObjectMetaDirective = OBSMetaDirectiveCopy;
    
request.dstObjectStorageClass = OBSStorageClassStandard;
    
request.dstObjectWebsiteRedirectLocation = @"URL";

request.customContentType = @"video/mp4";
    
    
[client copyObject:request completionHandler:^(OBSCopyObjectResponse *response, NSError *error){
    NSLog(@"%@",response);
}] ; 

限定条件复制

复制对象时,可以指定一个或多个限定条件,满足限定条件时则进行复制,否则抛出异常,复制对象失败。

您可以使用的限定条件如下:

参数

作用

OBS iOS SDK对应枚举值

Copy-Source-if-Match

如果源对象的ETag值与该参数值相同,则进行复制,否则抛出异常。

cpSrcIfETagMatch

Copy-Source-if-None-Match

如果源对象的ETag值与该参数值不相同,则进行复制,否则抛出异常。

cpSrcIfETagNoneMatch

Copy-Source-if-Modified-Since

如果源对象在指定的时间后有修改,则进行复制,否则抛出异常。

cpSrcIfModifiedSince

Copy-Source-if-Unmodified-Since

如果源对象在指定的时间后没有修改,则进行复制,否则抛出异常。。

cpSrcIfUnmodifiedSince

  • 源对象的ETag值是指源对象数据的MD5校验值。
  • 如果包含Copy-Source-if-Unmodified-Since并且不符合,或者包含Copy-Source-if-Match并且不符合,或者包含Copy-Source-if-Modified-Since并且不符合,或者包含Copy-Source-if-None-Match并且不符合,则复制失败。
  • Copy-Source-if-Modified-Since和Copy-Source-if-None-Match可以一起使用;Copy-Source-if-Unmodified-Since和Copy-Source-if-Match可以一起使用。

以下代码展示了如何进行限定条件复制:

static OBSClient *client;
NSString *endPoint = @"your-endpoint";
// 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全;本示例以ak和sk保存在环境变量中为例,运行本示例前请先在本地环境中设置环境变量AccessKeyID和SecretAccessKey。
// 您可以登录访问管理控制台获取访问密钥AK/SK,获取方式请参见https://support.huaweicloud.com/intl/zh-cn/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];
    
// 初始化身份验证
OBSStaticCredentialProvider *credentialProvider = [[OBSStaticCredentialProvider alloc] initWithAccessKey:AK secretKey:SK];
    
//初始化服务配置
OBSServiceConfiguration *conf = [[OBSServiceConfiguration alloc] initWithURLString:endPoint credentialProvider:credentialProvider];
    
// 初始化client
client = [[OBSClient alloc] initWithConfiguration:conf];
    
OBSCopyObjectRequest *request = [[OBSCopyObjectRequest alloc]initWithSrcBucketName:@"source-bucketname" srcObjectKey:@"objectname1" dstBucketName:@"destination-bucketname" dstObjectKey:@"objectname2"];
    
    
request.cpSrcIfETagNoneMatch = @"\"f807071206c05630b4d3c92aae4f4448\"";
    
request.cpSrcIfModifiedSince = @"Sunday, 06-Nov-94 08:49:37 GMT";
    
//request.cpSrcIfModifiedSince = [[OBSUtils      getDateFormatterRFC1123]dateFromString:@"Mon, 18 Dec 2017 03:50:49 GMT"];
    
[client copyObject:request completionHandler:^(OBSCopyObjectResponse *response, NSError *error){
    NSLog(@"%@",response);
}] ;

重写对象访问权限

以下代码展示了如何在复制对象时重写对象访问权限:

static OBSClient *client;
NSString *endPoint = @"your-endpoint";
// 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全;本示例以ak和sk保存在环境变量中为例,运行本示例前请先在本地环境中设置环境变量AccessKeyID和SecretAccessKey。
// 您可以登录访问管理控制台获取访问密钥AK/SK,获取方式请参见https://support.huaweicloud.com/intl/zh-cn/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];
    
// 初始化身份验证
OBSStaticCredentialProvider *credentialProvider = [[OBSStaticCredentialProvider alloc] initWithAccessKey:AK secretKey:SK];
    
//初始化服务配置
OBSServiceConfiguration *conf = [[OBSServiceConfiguration alloc] initWithURLString:endPoint credentialProvider:credentialProvider];
    
// 初始化client
client = [[OBSClient alloc] initWithConfiguration:conf];
    
OBSCopyObjectRequest *request = [[OBSCopyObjectRequest alloc]initWithSrcBucketName:@"source-bucketname" srcObjectKey:@"objectname1" dstBucketName:@"destination-bucketname" dstObjectKey:@"objectname2"];
    
// 设置权限为完全控制权限
request.dstObjectACLPolicy = OBSACLFull_Control;
[client copyObject:request completionHandler:^(OBSCopyObjectResponse *response, NSError *error){
    NSLog(@"%@",response);
}] ;