com.ksyun.ks3.service

类 Ks3Client

java.lang.Object

com.ksyun.ks3.service.Ks3Client

所有已实现的接口:

Ks3

直接已知子类:

Ks3EncryptionClient

public class Ks3Client
extends Object
implements Ks3

字段概要

字段

限定符和类型	字段和说明
static Ks3Client	Ks3ClientForHZControl 已过时。 该客户端用于杭州(中国标准)bucket的除文件上传下载、分块上传以外的其他操作
static Ks3Client	Ks3ClientForHZStream 已过时。 该客户端用于杭州(中国标准)bucket的文件上传下载、分块上传
static Ks3Client	Ks3ClientForUS 已过时。 该客户端用于美国(圣克拉拉)bucket

构造器概要

构造器

构造器和说明
Ks3Client()
Ks3Client(Authorization auth)
Ks3Client(String accesskeyid, String accesskeysecret)
Ks3Client(String accesskeyid, String accesskeysecret, Ks3ClientConfig config)
Ks3Client(String accesskeyid, String accesskeysecret, String securityToken)
Ks3Client(String accesskeyid, String accesskeysecret, String securityToken, Ks3ClientConfig config)

方法概要

方法

限定符和类型	方法和说明
void	abortMultipartUpload(AbortMultipartUploadRequest request) Abort Multipart Upload
void	abortMultipartUpload(String bucketname, String objectkey, String uploadId) Abort Multipart Upload
AppendObjectResult	appendObject(AppendObjectRequest request) APPEND OBJECT
boolean	bucketExists(String bucketName)
void	clearObject(ClearObjectRequest request)
void	clearObject(String bucketName, String objectKey, String retentionId)
CompleteMultipartUploadResult	completeMultipartUpload(CompleteMultipartUploadRequest request) Complete Multipart Upload
CompleteMultipartUploadResult	completeMultipartUpload(ListPartsResult result) Complete Multipart Upload
CompleteMultipartUploadResult	completeMultipartUpload(String bucketname, String objectkey, String uploadId, List<PartETag> partETags) Complete Multipart Upload
CopyResult	copyObject(CopyObjectRequest request) Copy Object
CopyResult	copyObject(String destinationBucket, String destinationObject, String sourceBucket, String sourceKey) Copy Object
CopyResult	copyObject(String destinationBucket, String destinationObject, String sourceBucket, String sourceKey, AccessControlList accessControlList) Copy Object
CopyResult	copyObject(String destinationBucket, String destinationObject, String sourceBucket, String sourceKey, CannedAccessControlList cannedAcl) Copy Object
CopyResult	copyPart(CopyPartRequest request) Upload Part Copy
Bucket	createBucket(CreateBucketRequest request) PUT BUCKET
Bucket	createBucket(String bucketname) PUT BUCKET
void	deleteBucket(DeleteBucketRequest request) DELETE BUCKET
void	deleteBucket(String bucketname) DELETE BUCKET
void	deleteBucketCors(DeleteBucketCorsRequest request) DELETE Bucket cors
void	deleteBucketCors(String bucketname) DELETE Bucket cors
void	deleteBucketLifecycle(DeleteBucketLifecycleRequest request)
void	deleteBucketLifecycle(String bucket)
Ks3Result	deleteBucketMirror(DeleteBucketMirrorRequest request)
Ks3Result	deleteBucketMirror(String bucketName)
void	deleteBucketPolicy(DeleteBucketPolicyRequest request) 删除空间策略
void	deleteBucketPolicy(String bucketName) 删除空间策略
void	deleteBucketReplicationConfiguration(String bucketName) DEL Bucket crr
void	deleteObject(DeleteObjectRequest request) DELETE OBJECT
void	deleteObject(String bucketname, String key) DELETE OBJECT
void	deleteObjectTagging(DeleteObjectTaggingRequest request)
void	deleteObjectTagging(String bucketName, String objectName)
<X extends Ks3WebServiceResponse<Y>,Y> Y	execute(Ks3WebServiceRequest request, Class<X> clazz)
String	generatePresignedUrl(GeneratePresignedUrlRequest request) 生成外链
String	generatePresignedUrl(String bucket, String key, int expiration) 生成object的外链地址
String	generatePresignedUrl(String bucket, String key, int expiration, ResponseHeaderOverrides overrides) 生成object的外链地址
AdpTask	getAdpTask(GetAdpRequest request)
AdpTask	getAdpTask(String taskid)
AccessControlPolicy	getBucketACL(GetBucketACLRequest request) GET Bucket acl
AccessControlPolicy	getBucketACL(String bucketName) GET BUCKET acl
CannedAccessControlList	getBucketCannedACL(GetBucketACLRequest request) GET Bucket acl
CannedAccessControlList	getBucketCannedACL(String bucketName) GET BUCKET acl
BucketCorsConfiguration	getBucketCors(GetBucketCorsRequest request) GET Bucket cors
BucketCorsConfiguration	getBucketCors(String bucketname) GET Bucket cors
BucketLifecycleConfiguration	getBucketLifecycle(GetBucketLifecycleRequest request)
BucketLifecycleConfiguration	getBucketLifecycle(String bucket)
CreateBucketConfiguration.REGION	getBucketLoaction(GetBucketLocationRequest request) 已过时。
CreateBucketConfiguration.REGION	getBucketLoaction(String bucketName) 已过时。
CreateBucketConfiguration.REGION	getBucketLocation(GetBucketLocationRequest request) 已过时。
CreateBucketConfiguration.REGION	getBucketLocation(String bucketName) 已过时。
String	getBucketLocationName(GetBucketLocationRequest request)
String	getBucketLocationName(String bucketName)
BucketLoggingStatus	getBucketLogging(GetBucketLoggingRequest request) GET Bucket Logging
BucketLoggingStatus	getBucketLogging(String bucketName) GET Bucket Logging
BucketMirror	getBucketMirror(GetBucketMirrorRequest request)
BucketMirror	getBucketMirror(String bucketName)
GetBucketPolicyResult	getBucketPolicy(GetBucketPolicyRequest request) 获取空间策略，如果没有则报404 Not Found
GetBucketPolicyResult	getBucketPolicy(String bucketName) 获取空间策略，如果没有则报404 Not Found
ReplicationRule	getBucketReplicationConfiguration(String bucketName) GET Bucket crr
BucketRetentionConfiguration	getBucketRetention(String bucketName)
Ks3ClientConfig	getKs3config() 获取配置信息
GetObjectResult	getObject(GetObjectRequest request) GET OBJECT
GetObjectResult	getObject(String bucketName, String key) GET OBJECT
AccessControlPolicy	getObjectACL(GetObjectACLRequest request) Get Object acl
AccessControlPolicy	getObjectACL(String bucketName, String objectName) Get Object acl
CannedAccessControlList	getObjectCannedACL(GetObjectACLRequest request) Get Object acl
CannedAccessControlList	getObjectCannedACL(String bucketName, String ObjectName) Get Object acl
ObjectTagging	getObjectTagging(GetObjectTaggingRequest request)
ObjectTagging	getObjectTagging(String bucketName, String objectName)
HeadBucketResult	headBucket(HeadBucketRequest request) HEAD BUCKET
HeadBucketResult	headBucket(String bucketname) HEAD BUECKET
HeadObjectResult	headObject(HeadObjectRequest request) HEAD OBJECT
HeadObjectResult	headObject(String bucketname, String objectkey) HEAD OBJECT
InitiateMultipartUploadResult	initiateMultipartUpload(InitiateMultipartUploadRequest request) Initiate Multipart Upload
InitiateMultipartUploadResult	initiateMultipartUpload(String bucketname, String objectkey) Initiate Multipart Upload
List<Bucket>	listBuckets() GET SERVICE
List<Bucket>	listBuckets(ListBucketsRequest request) GET SERVICE
ListMultipartUploadsResult	listMultipartUploads(ListMultipartUploadsRequest request) List Multipart Uploads
ListMultipartUploadsResult	listMultipartUploads(String bucketName) List Multipart Uploads
ListMultipartUploadsResult	listMultipartUploads(String bucketName, String prefix) List Multipart Uploads
ListMultipartUploadsResult	listMultipartUploads(String bucketName, String prefix, String keyMarker, String uploadIdMarker) List Multipart Uploads
ObjectListing	listObjects(ListObjectsRequest request) GET BUCKET(LIST OBJECTS)
ObjectListing	listObjects(String bucketname) GET BUCKET(LIST OBJECTS)
ObjectListing	listObjects(String bucketname, String prefix) GET BUCKET(LIST OBJECTS)
ObjectListingV2	listObjectsV2(ListObjectsV2Request request)
ObjectListingV2	listObjectsV2(String bucketname)
ObjectListingV2	listObjectsV2(String bucketname, String prefix)
ListPartsResult	listParts(ListPartsRequest request) List Parts
ListPartsResult	listParts(String bucketname, String objectkey, String uploadId) List Parts
ListPartsResult	listParts(String bucketname, String objectkey, String uploadId, int maxParts) List Parts
ListPartsResult	listParts(String bucketname, String objectkey, String uploadId, int maxParts, int partNumberMarker) List Parts
RetentionObjectListing	listRetentionObjects(ListRetentionObjectsRequest request)
RetentionObjectListing	listRetentionObjects(String bucketName)
RetentionObjectListing	listRetentionObjects(String bucketName, String prefix)
void	makeDir(String bucketName, String dir) 新建文件夹
boolean	objectExists(String bucket, String key) 判断object是否存在
boolean	objectExists(String bucket, String key, SSECustomerKey sseKey)
PostObjectFormFields	postObject(PostPolicy policy)
PostObjectFormFields	postObject(String bucket, String filename, Map<String,String> postFormData, List<String> unknowValueFormFiled)
ProcessObjectResult	processObject(ProcessObjectRequest request)
ProcessObjectResult	processObject(String bucketName, String key, String process)
PutAdpResult	putAdpTask(PutAdpRequest request)
PutAdpResult	putAdpTask(String bucketName, String objectKey, List<Adp> adps)
PutAdpResult	putAdpTask(String bucketName, String objectKey, List<Adp> adps, String notifyURL)
void	putBucketACL(PutBucketACLRequest request) PUT Bucket acl
void	putBucketACL(String bucketName, AccessControlList accessControlList) PUT Bucket acl
void	putBucketACL(String bucketName, CannedAccessControlList CannedAcl) PUT Bucket acl
void	putBucketCors(PutBucketCorsRequest request) PUT Bucket cors
void	putBucketLifecycle(PutBucketLifecycleRequest request)
void	putBucketLifecycle(String bucket, BucketLifecycleConfiguration bucketLifecycleConfiguration)
void	putBucketLogging(PutBucketLoggingRequest request) PUT Bucket Logging
void	putBucketLogging(String bucketName, boolean enable, String targetBucket) PUT Bucket Logging
void	putBucketLogging(String bucketName, boolean enable, String targetBucket, String targetPrefix) PUT Bucket Logging
Ks3Result	putBucketMirror(PutBucketMirrorRequest request)
Ks3Result	putBucketMirror(String bucketName, BucketMirror bucketMirror)
void	putBucketPolicy(PutBucketPolicyRequest request) 设置空间策略
void	putBucketPolicy(String bucketName, String policyText) 设置空间策略
void	putBucketReplicationConfiguration(PutBucketReplicationConfigurationRequest request) PUT Bucket crr
void	putBucketReplicationConfiguration(String bucketName, ReplicationRule rule) PUT Bucket crr
void	putBucketRetention(PutBucketRetentionRequest request)
void	putBucketRetention(String bucketName, BucketRetentionConfiguration retentionConfiguration)
PutObjectResult	putObject(PutObjectRequest request) PUT OBJECT
PutObjectResult	putObject(String bucketname, String objectkey, File file) PUT OBJECT
PutObjectResult	putObject(String bucketName, String objectKey, File file, ObjectMetadata metadata)
PutObjectResult	putObject(String bucketName, String objectKey, InputStream inputstream)
PutObjectResult	putObject(String bucketname, String objectkey, InputStream inputstream, ObjectMetadata objectmeta) PUT OBJECT
PutObjectResult	putObject(String bucketname, String objectkey, String content) PUT Object
void	putObjectACL(PutObjectACLRequest request) PUT Object acl
void	putObjectACL(String bucketName, String objectName, AccessControlList accessControlList) PUT OBJECT ACL
void	putObjectACL(String bucketName, String objectName, CannedAccessControlList accessControlList) PUT OBJECT ACL
Ks3Result	putObjectFetch(PutObjectFetchRequest request)
Ks3Result	putObjectFetch(String bucketName, String objectKey, String sourceUrl)
void	putObjectTagging(PutObjectTaggingRequest request)
void	putObjectTagging(String bucketName, String objectName, ObjectTagging objectTagging)
void	recoverObject(RecoverObjectRequest request)
void	recoverObject(String bucketName, String objectKey)
void	recoverObject(String bucketName, String objectKey, String retentionId)
RestoreObjectResult	restoreObject(RestoreObjectRequest request)
RestoreObjectResult	restoreObject(String bucketName, String objectKey)
void	setAuth(Authorization auth) 设置accesskeyid accesskeysecret
void	setEndpoint(String endpoint) 设置服务地址 中国标准:kss.ksyun.com 中国cdn:kssws.ks-cdn.com 美国（圣克拉拉）:ks3-us-west-1.ksyun.com
void	setKs3config(Ks3ClientConfig ks3config) 设置配置信息
void	setPathAccessStyle(boolean pathStyle) 设置是否使用pathStyle
void	shutdown() 关闭client，释放资源
PartETag	uploadPart(UploadPartRequest request) Upload Part
Ks3Client	withAuth(Authorization auth) 设置accesskeyid accesskeysecret
Ks3Client	withEndpoint(String endpoint) 设置服务地址 中国标准:kss.ksyun.com 中国cdn:kssws.ks-cdn.com 美国（圣克拉拉）:ks3-us-west-1.ksyun.com
Ks3Client	withKs3config(Ks3ClientConfig ks3config) 设置配置信息
Ks3Client	withPathStyleAccess(boolean pathStyle) 设置是否使用pathStyle

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

Ks3ClientForHZStream

public static final Ks3Client Ks3ClientForHZStream

已过时。 该客户端用于杭州(中国标准)bucket的文件上传下载、分块上传

Ks3ClientForHZControl

public static final Ks3Client Ks3ClientForHZControl

已过时。 该客户端用于杭州(中国标准)bucket的除文件上传下载、分块上传以外的其他操作

Ks3ClientForUS

public static final Ks3Client Ks3ClientForUS

已过时。 该客户端用于美国(圣克拉拉)bucket

构造器详细资料

Ks3Client

public Ks3Client()

Ks3Client

public Ks3Client(Authorization auth)

Ks3Client

public Ks3Client(String accesskeyid,
         String accesskeysecret)

Ks3Client

public Ks3Client(String accesskeyid,
         String accesskeysecret,
         String securityToken)

Ks3Client

public Ks3Client(String accesskeyid,
         String accesskeysecret,
         Ks3ClientConfig config)

Ks3Client

public Ks3Client(String accesskeyid,
         String accesskeysecret,
         String securityToken,
         Ks3ClientConfig config)

方法详细资料

setAuth

public void setAuth(Authorization auth)

从接口复制的说明: Ks3

设置accesskeyid accesskeysecret

指定者:

setAuth 在接口中 Ks3

withAuth

public Ks3Client withAuth(Authorization auth)

从接口复制的说明: Ks3

设置accesskeyid accesskeysecret

指定者:

withAuth 在接口中 Ks3

setEndpoint

public void setEndpoint(String endpoint)

从接口复制的说明: Ks3

设置服务地址
中国标准:kss.ksyun.com
中国cdn:kssws.ks-cdn.com
美国（圣克拉拉）:ks3-us-west-1.ksyun.com

指定者:

setEndpoint 在接口中 Ks3

withEndpoint

public Ks3Client withEndpoint(String endpoint)

从接口复制的说明: Ks3

设置服务地址 中国标准:kss.ksyun.com
中国cdn:kssws.ks-cdn.com
美国（圣克拉拉）:ks3-us-west-1.ksyun.com

指定者:

withEndpoint 在接口中 Ks3

setPathAccessStyle

public void setPathAccessStyle(boolean pathStyle)

从接口复制的说明: Ks3

设置是否使用pathStyle

指定者:

setPathAccessStyle 在接口中 Ks3

withPathStyleAccess

public Ks3Client withPathStyleAccess(boolean pathStyle)

从接口复制的说明: Ks3

设置是否使用pathStyle

指定者:

withPathStyleAccess 在接口中 Ks3

getKs3config

public Ks3ClientConfig getKs3config()

从接口复制的说明: Ks3

获取配置信息

指定者:

getKs3config 在接口中 Ks3

返回:

Ks3ClientConfig

setKs3config

public void setKs3config(Ks3ClientConfig ks3config)

从接口复制的说明: Ks3

设置配置信息

指定者:

setKs3config 在接口中 Ks3

withKs3config

public Ks3Client withKs3config(Ks3ClientConfig ks3config)

从接口复制的说明: Ks3

设置配置信息

指定者:

withKs3config 在接口中 Ks3

listBuckets

public List<Bucket> listBuckets()
                         throws Ks3ClientException,
                                Ks3ServiceException

从接口复制的说明: Ks3

GET SERVICE

指定者:

listBuckets 在接口中 Ks3

返回:

Bucket

抛出:

Ks3ClientException

Ks3ServiceException -

列出当前用户下的所有bucket

listBuckets

public List<Bucket> listBuckets(ListBucketsRequest request)
                         throws Ks3ClientException,
                                Ks3ServiceException

从接口复制的说明: Ks3

GET SERVICE

指定者:

listBuckets 在接口中 Ks3

参数:

request - ListBucketsRequest

返回:

Bucket

抛出:

Ks3ClientException

Ks3ServiceException -

列出当前用户下的所有bucket

getBucketLoaction

@Deprecated
public CreateBucketConfiguration.REGION getBucketLoaction(String bucketName)
                                                   throws Ks3ClientException,
                                                          Ks3ServiceException

已过时。

指定者:

getBucketLoaction 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException

另请参阅:

getBucketLocation(java.lang.String)

getBucketLoaction

@Deprecated
public CreateBucketConfiguration.REGION getBucketLoaction(GetBucketLocationRequest request)
                                                   throws Ks3ClientException,
                                                          Ks3ServiceException

已过时。

指定者:

getBucketLoaction 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException

另请参阅:

getBucketLocation(java.lang.String)

getBucketLocation

@Deprecated
public CreateBucketConfiguration.REGION getBucketLocation(String bucketName)
                                                   throws Ks3ClientException,
                                                          Ks3ServiceException

已过时。

从接口复制的说明: Ks3

GET Bucket Location

指定者:

getBucketLocation 在接口中 Ks3

返回:

抛出:

Ks3ClientException

Ks3ServiceException -

获取bucket的存储地点

getBucketLocation

@Deprecated
public CreateBucketConfiguration.REGION getBucketLocation(GetBucketLocationRequest request)
                                                   throws Ks3ClientException,
                                                          Ks3ServiceException

已过时。

从接口复制的说明: Ks3

GET Bucket Location

指定者:

getBucketLocation 在接口中 Ks3

参数:

request - GetBucketLocationRequest

返回:

抛出:

Ks3ClientException

Ks3ServiceException -

获取bucket的存储地点

getBucketLocationName

public String getBucketLocationName(String bucketName)
                             throws Ks3ClientException,
                                    Ks3ServiceException

指定者:

getBucketLocationName 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException

getBucketLocationName

public String getBucketLocationName(GetBucketLocationRequest request)
                             throws Ks3ClientException,
                                    Ks3ServiceException

指定者:

getBucketLocationName 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException

putBucketReplicationConfiguration

public void putBucketReplicationConfiguration(String bucketName,
                                     ReplicationRule rule)
                                       throws Ks3ClientException,
                                              Ks3ServiceException

从接口复制的说明: Ks3

PUT Bucket crr

指定者:

putBucketReplicationConfiguration 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException -

设置bucket的跨区域复制

getBucketReplicationConfiguration

public ReplicationRule getBucketReplicationConfiguration(String bucketName)
                                                  throws Ks3ClientException,
                                                         Ks3ServiceException

从接口复制的说明: Ks3

GET Bucket crr

指定者:

getBucketReplicationConfiguration 在接口中 Ks3

返回:

抛出:

Ks3ClientException

Ks3ServiceException -

获取bucket的跨区域复制

deleteBucketReplicationConfiguration

public void deleteBucketReplicationConfiguration(String bucketName)
                                          throws Ks3ClientException,
                                                 Ks3ServiceException

从接口复制的说明: Ks3

DEL Bucket crr

指定者:

deleteBucketReplicationConfiguration 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException -

删除bucket的跨区域复制

putBucketReplicationConfiguration

public void putBucketReplicationConfiguration(PutBucketReplicationConfigurationRequest request)
                                       throws Ks3ClientException,
                                              Ks3ServiceException

从接口复制的说明: Ks3

PUT Bucket crr

指定者:

putBucketReplicationConfiguration 在接口中 Ks3

参数:

request - PutBucketReplicationConfigurationRequest

抛出:

Ks3ClientException

Ks3ServiceException -

设置bucket的跨区域复制

getBucketLogging

public BucketLoggingStatus getBucketLogging(String bucketName)
                                     throws Ks3ClientException,
                                            Ks3ServiceException

从接口复制的说明: Ks3

GET Bucket Logging

指定者:

getBucketLogging 在接口中 Ks3

返回:

BucketLoggingStatus

抛出:

Ks3ClientException

Ks3ServiceException -

获取bucket的日志配置

getBucketLogging

public BucketLoggingStatus getBucketLogging(GetBucketLoggingRequest request)
                                     throws Ks3ClientException,
                                            Ks3ServiceException

从接口复制的说明: Ks3

GET Bucket Logging

指定者:

getBucketLogging 在接口中 Ks3

参数:

request - GetBucketLoggingRequest

返回:

BucketLoggingStatus

抛出:

Ks3ClientException

Ks3ServiceException -

获取bucket的日志配置

putBucketLogging

public void putBucketLogging(String bucketName,
                    boolean enable,
                    String targetBucket)
                      throws Ks3ClientException,
                             Ks3ServiceException

从接口复制的说明: Ks3

PUT Bucket Logging

指定者:

putBucketLogging 在接口中 Ks3

enable - 是否开启

targetBucket - 存储日志的bucket

抛出:

Ks3ClientException

Ks3ServiceException -

配置bucket的日志

putBucketLogging

public void putBucketLogging(String bucketName,
                    boolean enable,
                    String targetBucket,
                    String targetPrefix)
                      throws Ks3ClientException,
                             Ks3ServiceException

从接口复制的说明: Ks3

PUT Bucket Logging

指定者:

putBucketLogging 在接口中 Ks3

enable - 是否开启

targetBucket - 存储日志的bucket

targetPrefix - 日志文件前缀

抛出:

Ks3ClientException

Ks3ServiceException -

配置 bucket的日志

putBucketLogging

public void putBucketLogging(PutBucketLoggingRequest request)
                      throws Ks3ClientException,
                             Ks3ServiceException

从接口复制的说明: Ks3

PUT Bucket Logging

指定者:

putBucketLogging 在接口中 Ks3

参数:

request - PutBucketLoggingRequest

抛出:

Ks3ClientException

Ks3ServiceException -

配置bucket的日志

getBucketACL

public AccessControlPolicy getBucketACL(String bucketName)
                                 throws Ks3ClientException,
                                        Ks3ServiceException

从接口复制的说明: Ks3

GET BUCKET acl

指定者:

getBucketACL 在接口中 Ks3

参数:

bucketName - bucket名称

返回:

AccessControlPolicy

抛出:

Ks3ClientException

Ks3ServiceException -

获取bucket的acl

getBucketCannedACL

public CannedAccessControlList getBucketCannedACL(String bucketName)
                                           throws Ks3ClientException,
                                                  Ks3ServiceException

从接口复制的说明: Ks3

GET BUCKET acl

指定者:

getBucketCannedACL 在接口中 Ks3

参数:

bucketName - bucket名称

返回:

CannedAccessControlList

抛出:

Ks3ClientException

Ks3ServiceException -

获取bucket的acl

getBucketCannedACL

public CannedAccessControlList getBucketCannedACL(GetBucketACLRequest request)
                                           throws Ks3ClientException,
                                                  Ks3ServiceException

从接口复制的说明: Ks3

GET Bucket acl

指定者:

getBucketCannedACL 在接口中 Ks3

参数:

request - GetBucketACLRequest

返回:

CannedAccessControlList

抛出:

Ks3ClientException

Ks3ServiceException -

获取bucket的acl

getBucketACL

public AccessControlPolicy getBucketACL(GetBucketACLRequest request)
                                 throws Ks3ClientException,
                                        Ks3ServiceException

从接口复制的说明: Ks3

GET Bucket acl

指定者:

getBucketACL 在接口中 Ks3

参数:

request - GetBucketACLRequest

返回:

AccessControlPolicy

抛出:

Ks3ClientException

Ks3ServiceException -

获取bucket的acl

putBucketACL

public void putBucketACL(String bucketName,
                AccessControlList accessControlList)
                  throws Ks3ClientException,
                         Ks3ServiceException

从接口复制的说明: Ks3

PUT Bucket acl

指定者:

putBucketACL 在接口中 Ks3

参数:

bucketName - bucket名称

accessControlList - AccessControlList

抛出:

Ks3ClientException

Ks3ServiceException -

编辑bucket的acl

putBucketACL

public void putBucketACL(PutBucketACLRequest request)
                  throws Ks3ClientException,
                         Ks3ServiceException

从接口复制的说明: Ks3

PUT Bucket acl

指定者:

putBucketACL 在接口中 Ks3

参数:

request - PutBucketACLRequest

抛出:

Ks3ClientException

Ks3ServiceException -

编辑bucket的acl

putObjectACL

public void putObjectACL(String bucketName,
                String objectName,
                AccessControlList accessControlList)
                  throws Ks3ClientException,
                         Ks3ServiceException

从接口复制的说明: Ks3

PUT OBJECT ACL

指定者:

putObjectACL 在接口中 Ks3

参数:

bucketName - bucket名称

objectName - object名称

accessControlList - AccessControlList

抛出:

Ks3ClientException

Ks3ServiceException -

编辑object的acl

putObjectACL

public void putObjectACL(PutObjectACLRequest request)
                  throws Ks3ClientException,
                         Ks3ServiceException

从接口复制的说明: Ks3

PUT Object acl

指定者:

putObjectACL 在接口中 Ks3

参数:

request - PutObjectACLRequest

抛出:

Ks3ClientException

Ks3ServiceException -

编辑object的acl

getObjectACL

public AccessControlPolicy getObjectACL(String bucketName,
                               String objectName)
                                 throws Ks3ClientException,
                                        Ks3ServiceException

从接口复制的说明: Ks3

Get Object acl

指定者:

getObjectACL 在接口中 Ks3

参数:

bucketName - bucket名称

objectName - object名称

返回:

AccessControlPolicy

抛出:

Ks3ClientException

Ks3ServiceException -

获取object的acl

getObjectCannedACL

public CannedAccessControlList getObjectCannedACL(String bucketName,
                                         String ObjectName)
                                           throws Ks3ClientException,
                                                  Ks3ServiceException

从接口复制的说明: Ks3

Get Object acl

指定者:

getObjectCannedACL 在接口中 Ks3

参数:

bucketName - bucket名称

ObjectName - object名称

返回:

CannedAccessControlList

抛出:

Ks3ClientException

Ks3ServiceException -

获取object的acl

getObjectCannedACL

public CannedAccessControlList getObjectCannedACL(GetObjectACLRequest request)
                                           throws Ks3ClientException,
                                                  Ks3ServiceException

从接口复制的说明: Ks3

Get Object acl

指定者:

getObjectCannedACL 在接口中 Ks3

参数:

request - GetObjectACLRequest

返回:

CannedAccessControlList

抛出:

Ks3ClientException

Ks3ServiceException -

获取object的acl

getObjectACL

public AccessControlPolicy getObjectACL(GetObjectACLRequest request)
                                 throws Ks3ClientException,
                                        Ks3ServiceException

从接口复制的说明: Ks3

Get Object acl

指定者:

getObjectACL 在接口中 Ks3

参数:

request - GetObjectACLRequest

返回:

AccessControlPolicy

抛出:

Ks3ClientException

Ks3ServiceException -

获取object的acl

createBucket

public Bucket createBucket(String bucketname)
                    throws Ks3ClientException,
                           Ks3ServiceException

从接口复制的说明: Ks3

PUT BUCKET

指定者:

createBucket 在接口中 Ks3

参数:

bucketname - bucket名称

Bucket是存放Object的容器，所有的Object都必须存放在特定的Bucket中。 ，每个Bucket中可以存放无限多个Object。Bucket不能嵌套，每个Bucket中只能存放Object， 不能再存放Bucket ，Bucket下的Object是一个平级的结构。

Bucket的名称全局唯一且命名规则与DNS命名规则相同：

• 长度3-63，
• 不包含大写字母，不包含[‘ ’,\t,\r,\n]，不包含连续的’.’
• ，’.’和’-’在bucket名称中不能相连，
• 仅可包含. - 数字 小写字母，
• 不以’.’或’-’结尾

返回:

Bucket

抛出:

Ks3ClientException

Ks3ServiceException -

创建bucket，权限默认是私有的，存储地点为杭州

createBucket

public Bucket createBucket(CreateBucketRequest request)
                    throws Ks3ClientException,
                           Ks3ServiceException

从接口复制的说明: Ks3

PUT BUCKET

指定者:

createBucket 在接口中 Ks3

参数:

request - CreateBucketRequest

返回:

Bucket

抛出:

Ks3ClientException

Ks3ServiceException -

创建bucket，权限默认是私有的，存储地点为杭州

makeDir

public void makeDir(String bucketName,
           String dir)
             throws Ks3ClientException,
                    Ks3ServiceException

从接口复制的说明: Ks3

新建文件夹

指定者:

makeDir 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException

deleteBucket

public void deleteBucket(String bucketname)
                  throws Ks3ClientException,
                         Ks3ServiceException

从接口复制的说明: Ks3

DELETE BUCKET

指定者:

deleteBucket 在接口中 Ks3

参数:

bucketname - bucket名称

抛出:

Ks3ClientException

Ks3ServiceException -

删除bucket，bucket中内容为空时可以删除成功

注意这个操作是不能回退的

deleteBucket

public void deleteBucket(DeleteBucketRequest request)
                  throws Ks3ClientException,
                         Ks3ServiceException

从接口复制的说明: Ks3

DELETE BUCKET

指定者:

deleteBucket 在接口中 Ks3

参数:

request - DeleteBucketRequest

抛出:

Ks3ClientException

Ks3ServiceException -

删除bucket，bucket中内容为空时可以删除成功

注意这个操作是不能回退的

listObjects

public ObjectListing listObjects(String bucketname)
                          throws Ks3ClientException,
                                 Ks3ServiceException

从接口复制的说明: Ks3

GET BUCKET(LIST OBJECTS)

指定者:

listObjects 在接口中 Ks3

参数:

bucketname - bucket名称

返回:

ObjectListing

抛出:

Ks3ClientException

Ks3ServiceException -

列出bucket下满足条件的object

delimiter使用默认的/

返回的最大数(max-keys)使用默认的1000

listObjects

public ObjectListing listObjects(String bucketname,
                        String prefix)
                          throws Ks3ClientException,
                                 Ks3ServiceException

从接口复制的说明: Ks3

GET BUCKET(LIST OBJECTS)

指定者:

listObjects 在接口中 Ks3

参数:

bucketname - bucket名称

prefix - 前缀

返回:

ObjectListing

抛出:

Ks3ClientException

Ks3ServiceException -

列出bucket下满足条件的object

delimiter使用默认的/

返回的最大数(max-keys)使用默认的1000

listObjects

public ObjectListing listObjects(ListObjectsRequest request)
                          throws Ks3ClientException,
                                 Ks3ServiceException

从接口复制的说明: Ks3

GET BUCKET(LIST OBJECTS)

指定者:

listObjects 在接口中 Ks3

参数:

request - ListObjectsRequest

返回:

ObjectListing

抛出:

Ks3ClientException

Ks3ServiceException -

列出bucket下满足条件的object

listObjectsV2

public ObjectListingV2 listObjectsV2(String bucketname)
                              throws Ks3ClientException,
                                     Ks3ServiceException

指定者:

listObjectsV2 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException

listObjectsV2

public ObjectListingV2 listObjectsV2(String bucketname,
                            String prefix)
                              throws Ks3ClientException,
                                     Ks3ServiceException

指定者:

listObjectsV2 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException

listObjectsV2

public ObjectListingV2 listObjectsV2(ListObjectsV2Request request)
                              throws Ks3ClientException,
                                     Ks3ServiceException

指定者:

listObjectsV2 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException

deleteObject

public void deleteObject(String bucketname,
                String key)
                  throws Ks3ClientException,
                         Ks3ServiceException

从接口复制的说明: Ks3

DELETE OBJECT

指定者:

deleteObject 在接口中 Ks3

参数:

bucketname - bucket名称

key - object的key(即名称)

抛出:

Ks3ClientException

Ks3ServiceException -

删除指定的object

deleteObject

public void deleteObject(DeleteObjectRequest request)
                  throws Ks3ClientException,
                         Ks3ServiceException

从接口复制的说明: Ks3

DELETE OBJECT

指定者:

deleteObject 在接口中 Ks3

参数:

request - DeleteObjectRequest

抛出:

Ks3ClientException

Ks3ServiceException -

删除指定的object

getObject

public GetObjectResult getObject(String bucketName,
                        String key)
                          throws Ks3ClientException,
                                 Ks3ServiceException

从接口复制的说明: Ks3

GET OBJECT

指定者:

getObject 在接口中 Ks3

参数:

bucketName - bucket名称

key - object的key(即名称)

返回:

GetObjectResult

抛出:

Ks3ClientException

Ks3ServiceException -

获取指定的object

getObject

public GetObjectResult getObject(GetObjectRequest request)
                          throws Ks3ClientException,
                                 Ks3ServiceException

从接口复制的说明: Ks3

GET OBJECT

指定者:

getObject 在接口中 Ks3

参数:

request - GetObjectRequest

返回:

GetObjectResult

抛出:

Ks3ClientException

Ks3ServiceException -

获取指定的object

generatePresignedUrl

public String generatePresignedUrl(String bucket,
                          String key,
                          int expiration)
                            throws Ks3ClientException

从接口复制的说明: Ks3

生成object的外链地址

指定者:

generatePresignedUrl 在接口中 Ks3

expiration - 外链地址过期时间，单位秒

返回:

抛出:

Ks3ClientException

generatePresignedUrl

public String generatePresignedUrl(String bucket,
                          String key,
                          int expiration,
                          ResponseHeaderOverrides overrides)
                            throws Ks3ClientException

从接口复制的说明: Ks3

生成object的外链地址

指定者:

generatePresignedUrl 在接口中 Ks3

expiration - 外链地址过期时间，单位秒

overrides - 修改返回的headers

返回:

抛出:

Ks3ClientException

generatePresignedUrl

public String generatePresignedUrl(GeneratePresignedUrlRequest request)
                            throws Ks3ClientException

从接口复制的说明: Ks3

生成外链

指定者:

generatePresignedUrl 在接口中 Ks3

参数:

request - GeneratePresignedUrlRequest

返回:

抛出:

Ks3ClientException

headBucket

public HeadBucketResult headBucket(String bucketname)
                            throws Ks3ClientException,
                                   Ks3ServiceException

从接口复制的说明: Ks3

HEAD BUECKET

指定者:

headBucket 在接口中 Ks3

参数:

bucketname - bucket名称

返回:

status code and headersHeadBucketResult

抛出:

Ks3ClientException

Ks3ServiceException -

返回headers

headBucket

public HeadBucketResult headBucket(HeadBucketRequest request)
                            throws Ks3ClientException,
                                   Ks3ServiceException

从接口复制的说明: Ks3

HEAD BUCKET

指定者:

headBucket 在接口中 Ks3

参数:

request - HeadBucketRequest

返回:

status code and headersHeadBucketResult

抛出:

Ks3ClientException

Ks3ServiceException -

返回headers

bucketExists

public boolean bucketExists(String bucketName)
                     throws Ks3ClientException

指定者:

bucketExists 在接口中 Ks3

参数:

bucketName - bucket名称

返回:

如果bucket存在则为true

抛出:

Ks3ClientException -

判断bucket是否存在,bucket存在但不属于当前用户也会返回true

putObject

public PutObjectResult putObject(String bucketname,
                        String objectkey,
                        File file)
                          throws Ks3ClientException,
                                 Ks3ServiceException

从接口复制的说明: Ks3

PUT OBJECT

指定者:

putObject 在接口中 Ks3

参数:

bucketname - bucket名称

objectkey - object的key(即名称,编码后的长度不得超过1024个字节。)

file - 要上传的文件

返回:

PutObjectResult

抛出:

Ks3ClientException

Ks3ServiceException -

上传object

putObject

public PutObjectResult putObject(String bucketName,
                        String objectKey,
                        File file,
                        ObjectMetadata metadata)
                          throws Ks3ClientException,
                                 Ks3ServiceException

指定者:

putObject 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException

putObject

public PutObjectResult putObject(String bucketName,
                        String objectKey,
                        InputStream inputstream)
                          throws Ks3ClientException,
                                 Ks3ServiceException

指定者:

putObject 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException

putObject

public PutObjectResult putObject(String bucketname,
                        String objectkey,
                        InputStream inputstream,
                        ObjectMetadata objectmeta)
                          throws Ks3ClientException,
                                 Ks3ServiceException

从接口复制的说明: Ks3

PUT OBJECT

指定者:

putObject 在接口中 Ks3

参数:

bucketname - bucket名称

objectkey - object的key(即名称,编码后的长度不得超过1024个字节。)

inputstream - 数据流

objectmeta - object元数据ObjectMetadata

返回:

PutObjectResult

抛出:

Ks3ClientException

Ks3ServiceException -

使用时请尽量在metadata中提供content -length,否则有可能导致jvm内存溢出。可以在metadata中指定contentMD5

上传object

putObject

public PutObjectResult putObject(String bucketname,
                        String objectkey,
                        String content)
                          throws Ks3ClientException,
                                 Ks3ServiceException

从接口复制的说明: Ks3

PUT Object

指定者:

putObject 在接口中 Ks3

参数:

bucketname - bucket名称

content - 要上传的内容

返回:

抛出:

Ks3ClientException

Ks3ServiceException -

将一个字符串作为内容上传

putObject

public PutObjectResult putObject(PutObjectRequest request)
                          throws Ks3ClientException,
                                 Ks3ServiceException

从接口复制的说明: Ks3

PUT OBJECT

指定者:

putObject 在接口中 Ks3

参数:

request - PutObjectRequest

返回:

PutObjectResult

抛出:

Ks3ClientException

Ks3ServiceException -

上传object

appendObject

public AppendObjectResult appendObject(AppendObjectRequest request)
                                throws Ks3ClientException,
                                       Ks3ServiceException

从接口复制的说明: Ks3

APPEND OBJECT

指定者:

appendObject 在接口中 Ks3

参数:

request - AppendObjectRequest

返回:

AppendObjectResult

抛出:

Ks3ClientException - 客户端异常

Ks3ServiceException - 服务异常

copyObject

public CopyResult copyObject(String destinationBucket,
                    String destinationObject,
                    String sourceBucket,
                    String sourceKey)
                      throws Ks3ClientException,
                             Ks3ServiceException

从接口复制的说明: Ks3

Copy Object

指定者:

copyObject 在接口中 Ks3

参数:

destinationBucket - 目标bucket

destinationObject - 目标object key

sourceBucket - 数据源bucket

sourceKey - 数据源object key

返回:

CopyResult

抛出:

Ks3ClientException

Ks3ServiceException -

将指定的object复制到目标地点

copyObject

public CopyResult copyObject(String destinationBucket,
                    String destinationObject,
                    String sourceBucket,
                    String sourceKey,
                    CannedAccessControlList cannedAcl)
                      throws Ks3ClientException,
                             Ks3ServiceException

从接口复制的说明: Ks3

Copy Object

指定者:

copyObject 在接口中 Ks3

参数:

destinationBucket - 目标bucket

destinationObject - 目标object key

sourceBucket - 数据源bucket

sourceKey - 数据源object key

cannedAcl - CannedAccessControlList

返回:

CopyResult

抛出:

Ks3ClientException

Ks3ServiceException -

将指定的object复制到目标地点

copyObject

public CopyResult copyObject(String destinationBucket,
                    String destinationObject,
                    String sourceBucket,
                    String sourceKey,
                    AccessControlList accessControlList)
                      throws Ks3ClientException,
                             Ks3ServiceException

从接口复制的说明: Ks3

Copy Object

指定者:

copyObject 在接口中 Ks3

参数:

destinationBucket - 目标bucket

destinationObject - 目标object key

sourceBucket - 数据源bucket

sourceKey - 数据源object key

accessControlList - AccessControlList

返回:

CopyResult

抛出:

Ks3ClientException

Ks3ServiceException -

将指定的object复制到目标地点

copyObject

public CopyResult copyObject(CopyObjectRequest request)
                      throws Ks3ClientException,
                             Ks3ServiceException

从接口复制的说明: Ks3

Copy Object

指定者:

copyObject 在接口中 Ks3

参数:

request - CopyObjectRequest

返回:

CopyResult

抛出:

Ks3ClientException

Ks3ServiceException -

将指定的object复制到目标地点，将复制源object的元数据、acl等信息

headObject

public HeadObjectResult headObject(String bucketname,
                          String objectkey)
                            throws Ks3ClientException,
                                   Ks3ServiceException

从接口复制的说明: Ks3

HEAD OBJECT

指定者:

headObject 在接口中 Ks3

参数:

bucketname - bucket名称

objectkey - object的key(即object名称)

返回:

HeadObjectResult

抛出:

Ks3ClientException

Ks3ServiceException -

获取object的元数据、etag、上次修改时间

headObject

public HeadObjectResult headObject(HeadObjectRequest request)
                            throws Ks3ClientException,
                                   Ks3ServiceException

从接口复制的说明: Ks3

HEAD OBJECT

指定者:

headObject 在接口中 Ks3

参数:

request - HeadObjectRequest

返回:

HeadObjectResult

抛出:

Ks3ClientException

Ks3ServiceException -

获取object的元数据、etag、上次修改时间

objectExists

public boolean objectExists(String bucket,
                   String key)

从接口复制的说明: Ks3

判断object是否存在

指定者:

objectExists 在接口中 Ks3

返回:

boolean

objectExists

public boolean objectExists(String bucket,
                   String key,
                   SSECustomerKey sseKey)

initiateMultipartUpload

public InitiateMultipartUploadResult initiateMultipartUpload(String bucketname,
                                                    String objectkey)
                                                      throws Ks3ClientException,
                                                             Ks3ServiceException

从接口复制的说明: Ks3

Initiate Multipart Upload

指定者:

initiateMultipartUpload 在接口中 Ks3

参数:

bucketname - bucket名称

objectkey - object的key(即object名称)

返回:

InitiateMultipartUploadResult

抛出:

Ks3ClientException

Ks3ServiceException -

初始化分块上传

initiateMultipartUpload

public InitiateMultipartUploadResult initiateMultipartUpload(InitiateMultipartUploadRequest request)
                                                      throws Ks3ClientException,
                                                             Ks3ServiceException

从接口复制的说明: Ks3

Initiate Multipart Upload

指定者:

initiateMultipartUpload 在接口中 Ks3

参数:

request - InitiateMultipartUploadRequest

返回:

InitiateMultipartUploadResult

抛出:

Ks3ClientException

Ks3ServiceException -

初始化分块上传

uploadPart

public PartETag uploadPart(UploadPartRequest request)
                    throws Ks3ClientException,
                           Ks3ServiceException

从接口复制的说明: Ks3

Upload Part

指定者:

uploadPart 在接口中 Ks3

参数:

request - UploadPartRequest

返回:

PartETag

抛出:

Ks3ClientException

Ks3ServiceException -

分块上传文件

copyPart

public CopyResult copyPart(CopyPartRequest request)
                    throws Ks3ClientException,
                           Ks3ServiceException

从接口复制的说明: Ks3

Upload Part Copy

指定者:

copyPart 在接口中 Ks3

参数:

request - CopyPartRequest

返回:

CopyResult

抛出:

Ks3ClientException

Ks3ServiceException -

分块上传时使用copy

completeMultipartUpload

public CompleteMultipartUploadResult completeMultipartUpload(String bucketname,
                                                    String objectkey,
                                                    String uploadId,
                                                    List<PartETag> partETags)
                                                      throws Ks3ClientException,
                                                             Ks3ServiceException

从接口复制的说明: Ks3

Complete Multipart Upload

指定者:

completeMultipartUpload 在接口中 Ks3

参数:

bucketname - bucket名称

objectkey - object的key(即名称)

uploadId - 通过初始化分块上传获取到的uploadId

partETags -

public PartETag uploadPart(UploadPartRequest request)throws Ks3ClientException, Ks3ServiceException;

获取到的结果PartETag

返回:

CompleteMultipartUploadResult

抛出:

Ks3ClientException

Ks3ServiceException -

完成分块上传，使ks3服务器将之前上传的小块合并成一个object

completeMultipartUpload

public CompleteMultipartUploadResult completeMultipartUpload(ListPartsResult result)
                                                      throws Ks3ClientException,
                                                             Ks3ServiceException

从接口复制的说明: Ks3

Complete Multipart Upload

指定者:

completeMultipartUpload 在接口中 Ks3

参数:

result - ListPartsResultListParts操作的返回值

抛出:

Ks3ClientException

Ks3ServiceException -

完成分块上传，使ks3服务器将之前上传的小块合并成一个object

completeMultipartUpload

public CompleteMultipartUploadResult completeMultipartUpload(CompleteMultipartUploadRequest request)
                                                      throws Ks3ClientException,
                                                             Ks3ServiceException

从接口复制的说明: Ks3

Complete Multipart Upload

指定者:

completeMultipartUpload 在接口中 Ks3

参数:

request - CompleteMultipartUploadRequest

返回:

CompleteMultipartUploadResult

抛出:

Ks3ClientException

Ks3ServiceException -

完成分块上传，使ks3服务器将之前上传的小块合并成一个object

abortMultipartUpload

public void abortMultipartUpload(String bucketname,
                        String objectkey,
                        String uploadId)
                          throws Ks3ClientException,
                                 Ks3ServiceException

从接口复制的说明: Ks3

Abort Multipart Upload

指定者:

abortMultipartUpload 在接口中 Ks3

参数:

bucketname - bucket名称

objectkey - object的key(即object的名称)

uploadId - 通过初始化分块上传获取到的uploadId

抛出:

Ks3ClientException

Ks3ServiceException -

中止分块上传

abortMultipartUpload

public void abortMultipartUpload(AbortMultipartUploadRequest request)
                          throws Ks3ClientException,
                                 Ks3ServiceException

从接口复制的说明: Ks3

Abort Multipart Upload

指定者:

abortMultipartUpload 在接口中 Ks3

参数:

request - AbortMultipartUploadRequest

抛出:

Ks3ClientException

Ks3ServiceException -

中止分块上传

listParts

public ListPartsResult listParts(String bucketname,
                        String objectkey,
                        String uploadId)
                          throws Ks3ClientException,
                                 Ks3ServiceException

从接口复制的说明: Ks3

List Parts

指定者:

listParts 在接口中 Ks3

参数:

bucketname - bucket名称

objectkey - object的key(即object的名称)

uploadId - 通过初始化分块上传获取到的uploadId

返回:

ListPartsResult

抛出:

Ks3ClientException

Ks3ServiceException -

列出该uploadid下已经上传成功的块

listParts

public ListPartsResult listParts(String bucketname,
                        String objectkey,
                        String uploadId,
                        int maxParts)
                          throws Ks3ClientException,
                                 Ks3ServiceException

从接口复制的说明: Ks3

List Parts

指定者:

listParts 在接口中 Ks3

参数:

bucketname - bucket名称

objectkey - object的key(即object的名称)

uploadId - 通过初始化分块上传获取到的uploadId

maxParts - 列出的最大结果数

返回:

ListPartsResult

抛出:

Ks3ClientException

Ks3ServiceException -

列出该uploadid下已经上传成功的块

listParts

public ListPartsResult listParts(String bucketname,
                        String objectkey,
                        String uploadId,
                        int maxParts,
                        int partNumberMarker)
                          throws Ks3ClientException,
                                 Ks3ServiceException

从接口复制的说明: Ks3

List Parts

指定者:

listParts 在接口中 Ks3

参数:

bucketname - bucket名称

objectkey - object的key(即object的名称)

uploadId - 通过初始化分块上传获取到的uploadId

maxParts - 列出的最大结果数

partNumberMarker - partnumber游标，即从第partNumberMarker开始罗列

返回:

ListPartsResult

抛出:

Ks3ClientException

Ks3ServiceException -

列出该uploadid下已经上传成功的块

listParts

public ListPartsResult listParts(ListPartsRequest request)
                          throws Ks3ClientException,
                                 Ks3ServiceException

从接口复制的说明: Ks3

List Parts

指定者:

listParts 在接口中 Ks3

参数:

request - ListPartsRequest

返回:

ListPartsResult

抛出:

Ks3ClientException

Ks3ServiceException -

列出该uploadid下已经上传成功的块

putObjectACL

public void putObjectACL(String bucketName,
                String objectName,
                CannedAccessControlList accessControlList)
                  throws Ks3ClientException,
                         Ks3ServiceException

从接口复制的说明: Ks3

PUT OBJECT ACL

指定者:

putObjectACL 在接口中 Ks3

参数:

bucketName - bucket名称

objectName - object名称

accessControlList - CannedAccessControlList

抛出:

Ks3ClientException

Ks3ServiceException -

编辑object的acl

putBucketACL

public void putBucketACL(String bucketName,
                CannedAccessControlList CannedAcl)
                  throws Ks3ClientException,
                         Ks3ServiceException

从接口复制的说明: Ks3

PUT Bucket acl

指定者:

putBucketACL 在接口中 Ks3

参数:

bucketName - bucket名称

CannedAcl - CannedAccessControlList

抛出:

Ks3ClientException

Ks3ServiceException -

编辑bucket的acl

listMultipartUploads

public ListMultipartUploadsResult listMultipartUploads(String bucketName)
                                                throws Ks3ClientException,
                                                       Ks3ServiceException

从接口复制的说明: Ks3

List Multipart Uploads

指定者:

listMultipartUploads 在接口中 Ks3

返回:

ListMultipartUploadsResult

抛出:

Ks3ClientException

Ks3ServiceException

listMultipartUploads

public ListMultipartUploadsResult listMultipartUploads(String bucketName,
                                              String prefix)
                                                throws Ks3ClientException,
                                                       Ks3ServiceException

从接口复制的说明: Ks3

List Multipart Uploads

指定者:

listMultipartUploads 在接口中 Ks3

prefix - object key前缀

返回:

ListMultipartUploadsResult

抛出:

Ks3ClientException

Ks3ServiceException

listMultipartUploads

public ListMultipartUploadsResult listMultipartUploads(String bucketName,
                                              String prefix,
                                              String keyMarker,
                                              String uploadIdMarker)
                                                throws Ks3ClientException,
                                                       Ks3ServiceException

从接口复制的说明: Ks3

List Multipart Uploads

指定者:

listMultipartUploads 在接口中 Ks3

prefix - object key前缀

uploadIdMarker -

keyMarker为空，uploadIdMarker不为空

无意义

keyMarker不为空，uploadIdMarker不为空

列出分块上传object key为keyMarker，且upload id 大于uploadIdMarker的块

keyMarker不为空，uploadIdMarker为空

列出分块上传object key大于keyMarker的块

返回:

ListMultipartUploadsResult

抛出:

Ks3ClientException

Ks3ServiceException

listMultipartUploads

public ListMultipartUploadsResult listMultipartUploads(ListMultipartUploadsRequest request)
                                                throws Ks3ClientException,
                                                       Ks3ServiceException

从接口复制的说明: Ks3

List Multipart Uploads

指定者:

listMultipartUploads 在接口中 Ks3

参数:

request - ListMultipartUploadsRequest

返回:

ListMultipartUploadsResult

抛出:

Ks3ClientException

Ks3ServiceException

putBucketCors

public void putBucketCors(PutBucketCorsRequest request)
                   throws Ks3ClientException,
                          Ks3ServiceException

从接口复制的说明: Ks3

PUT Bucket cors

指定者:

putBucketCors 在接口中 Ks3

参数:

request - PutBucketCorsRequest

抛出:

Ks3ClientException

Ks3ServiceException

getBucketCors

public BucketCorsConfiguration getBucketCors(String bucketname)
                                      throws Ks3ClientException,
                                             Ks3ServiceException

从接口复制的说明: Ks3

GET Bucket cors

指定者:

getBucketCors 在接口中 Ks3

返回:

抛出:

Ks3ClientException

Ks3ServiceException -

获取bucket的跨域资源共享配置

getBucketCors

public BucketCorsConfiguration getBucketCors(GetBucketCorsRequest request)
                                      throws Ks3ClientException,
                                             Ks3ServiceException

从接口复制的说明: Ks3

GET Bucket cors

指定者:

getBucketCors 在接口中 Ks3

参数:

request - GetBucketCorsRequest

返回:

抛出:

Ks3ClientException

Ks3ServiceException -

获取bucket的跨域资源共享配置

deleteBucketCors

public void deleteBucketCors(String bucketname)
                      throws Ks3ClientException,
                             Ks3ServiceException

从接口复制的说明: Ks3

DELETE Bucket cors

指定者:

deleteBucketCors 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException -

删除bucket的跨域资源共享配置

deleteBucketCors

public void deleteBucketCors(DeleteBucketCorsRequest request)
                      throws Ks3ClientException,
                             Ks3ServiceException

从接口复制的说明: Ks3

DELETE Bucket cors

指定者:

deleteBucketCors 在接口中 Ks3

参数:

request - DeleteBucketCorsRequest

抛出:

Ks3ClientException

Ks3ServiceException -

删除bucket的跨域资源共享配置

execute

public <X extends Ks3WebServiceResponse<Y>,Y> Y execute(Ks3WebServiceRequest request,
                                               Class<X> clazz)
          throws Ks3ClientException,
                 Ks3ServiceException

指定者:

execute 在接口中 Ks3

参数:

request - Class<? extends Ks3WebServiceRequest>

clazz - Class<? extends Ks3WebServiceResponse>

返回:

抛出:

Ks3ClientException

Ks3ServiceException

postObject

public PostObjectFormFields postObject(PostPolicy policy)
                                throws Ks3ClientException

指定者:

postObject 在接口中 Ks3

返回:

PostObjectFormFields

抛出:

Ks3ClientException -

通过自定义policy规则获取post object时表单中的Signature、KSSAccessKeyId、policy三项的值

postObject

public PostObjectFormFields postObject(String bucket,
                              String filename,
                              Map<String,String> postFormData,
                              List<String> unknowValueFormFiled)
                                throws Ks3ClientException

指定者:

postObject 在接口中 Ks3

参数:

bucket - 目标bucket

filename - 要上传的文件名称,当postFormData中没有使用${filename}时可以不提供

postFormData - 可以确定值得表单项

unknowValueFormFiled - 无法确定值得表单项

返回:

PostObjectFormFields

抛出:

Ks3ClientException -

通过bucket和表单中的除 Signature、KSSAccessKeyId、policy外的所有表单项 获取post object时表单中的Signature、KSSAccessKeyId、policy三项的值

由此方法生成的签名只能适用于本次请求，matchingType全部使用eq或通配

putAdpTask

public PutAdpResult putAdpTask(String bucketName,
                      String objectKey,
                      List<Adp> adps)
                        throws Ks3ClientException,
                               Ks3ServiceException

指定者:

putAdpTask 在接口中 Ks3

参数:

bucketName - 要处理的数据所在的bucket

objectKey - 要处理的数据的key

adps - 一系列的操作指令Adp

返回:

PutAdpResult PutAdpResult

抛出:

Ks3ClientException

Ks3ServiceException -

添加数据处理任务

putAdpTask

public PutAdpResult putAdpTask(String bucketName,
                      String objectKey,
                      List<Adp> adps,
                      String notifyURL)
                        throws Ks3ClientException,
                               Ks3ServiceException

指定者:

putAdpTask 在接口中 Ks3

参数:

bucketName - 要处理的数据所在的bucket

objectKey - 要处理的数据的key

adps - 一系列的操作指令Adp

notifyURL - 处理完成后KS3将调用该url,以通知用户

返回:

PutAdpResult PutAdpResult

抛出:

Ks3ClientException

Ks3ServiceException -

添加数据处理任务

putAdpTask

public PutAdpResult putAdpTask(PutAdpRequest request)
                        throws Ks3ClientException,
                               Ks3ServiceException

指定者:

putAdpTask 在接口中 Ks3

参数:

request - PutAdpRequest

返回:

PutAdpResult PutAdpResult

抛出:

Ks3ClientException

Ks3ServiceException -

添加数据处理任务

getAdpTask

public AdpTask getAdpTask(String taskid)
                   throws Ks3ClientException,
                          Ks3ServiceException

指定者:

getAdpTask 在接口中 Ks3

参数:

taskid - 由putpfop，postobject，putobject，complete_mutipart_upload返回的taskid

返回:

AdpTask

抛出:

Ks3ClientException

Ks3ServiceException -

查询数据处理任务的状态

getAdpTask

public AdpTask getAdpTask(GetAdpRequest request)
                   throws Ks3ClientException,
                          Ks3ServiceException

指定者:

getAdpTask 在接口中 Ks3

参数:

request - GetAdpRequest

返回:

AdpTask

抛出:

Ks3ClientException

Ks3ServiceException -

查询数据处理任务的状态

putBucketLifecycle

public void putBucketLifecycle(PutBucketLifecycleRequest request)
                        throws Ks3ClientException,
                               Ks3ServiceException

指定者:

putBucketLifecycle 在接口中 Ks3

参数:

request - PutBucketLifecycleRequest

抛出:

Ks3ClientException

Ks3ServiceException -

增加生命周期配置

getBucketLifecycle

public BucketLifecycleConfiguration getBucketLifecycle(String bucket)

指定者:

getBucketLifecycle 在接口中 Ks3

返回:

BucketLifecycleConfiguration

deleteBucketLifecycle

public void deleteBucketLifecycle(String bucket)

指定者:

deleteBucketLifecycle 在接口中 Ks3

putBucketLifecycle

public void putBucketLifecycle(String bucket,
                      BucketLifecycleConfiguration bucketLifecycleConfiguration)

指定者:

putBucketLifecycle 在接口中 Ks3

bucketLifecycleConfiguration - BucketLifecycleConfiguration

getBucketLifecycle

public BucketLifecycleConfiguration getBucketLifecycle(GetBucketLifecycleRequest request)

指定者:

getBucketLifecycle 在接口中 Ks3

参数:

request - 请求体

返回:

BucketLifecycleConfiguration

deleteBucketLifecycle

public void deleteBucketLifecycle(DeleteBucketLifecycleRequest request)

指定者:

deleteBucketLifecycle 在接口中 Ks3

参数:

request - DeleteBucketLifecycleRequest

putObjectFetch

public Ks3Result putObjectFetch(String bucketName,
                       String objectKey,
                       String sourceUrl)

指定者:

putObjectFetch 在接口中 Ks3

putObjectFetch

public Ks3Result putObjectFetch(PutObjectFetchRequest request)

指定者:

putObjectFetch 在接口中 Ks3

参数:

request - PutObjectFetchRequest

restoreObject

public RestoreObjectResult restoreObject(String bucketName,
                                String objectKey)

指定者:

restoreObject 在接口中 Ks3

restoreObject

public RestoreObjectResult restoreObject(RestoreObjectRequest request)

指定者:

restoreObject 在接口中 Ks3

getBucketMirror

public BucketMirror getBucketMirror(GetBucketMirrorRequest request)

指定者:

getBucketMirror 在接口中 Ks3

getBucketMirror

public BucketMirror getBucketMirror(String bucketName)

指定者:

getBucketMirror 在接口中 Ks3

putBucketMirror

public Ks3Result putBucketMirror(PutBucketMirrorRequest request)

指定者:

putBucketMirror 在接口中 Ks3

putBucketMirror

public Ks3Result putBucketMirror(String bucketName,
                        BucketMirror bucketMirror)

指定者:

putBucketMirror 在接口中 Ks3

deleteBucketMirror

public Ks3Result deleteBucketMirror(DeleteBucketMirrorRequest request)

指定者:

deleteBucketMirror 在接口中 Ks3

deleteBucketMirror

public Ks3Result deleteBucketMirror(String bucketName)

指定者:

deleteBucketMirror 在接口中 Ks3

putObjectTagging

public void putObjectTagging(String bucketName,
                    String objectName,
                    ObjectTagging objectTagging)

指定者:

putObjectTagging 在接口中 Ks3

putObjectTagging

public void putObjectTagging(PutObjectTaggingRequest request)

指定者:

putObjectTagging 在接口中 Ks3

getObjectTagging

public ObjectTagging getObjectTagging(String bucketName,
                             String objectName)

指定者:

getObjectTagging 在接口中 Ks3

getObjectTagging

public ObjectTagging getObjectTagging(GetObjectTaggingRequest request)

指定者:

getObjectTagging 在接口中 Ks3

deleteObjectTagging

public void deleteObjectTagging(String bucketName,
                       String objectName)

指定者:

deleteObjectTagging 在接口中 Ks3

deleteObjectTagging

public void deleteObjectTagging(DeleteObjectTaggingRequest request)

指定者:

deleteObjectTagging 在接口中 Ks3

putBucketPolicy

public void putBucketPolicy(String bucketName,
                   String policyText)
                     throws Ks3ClientException

从接口复制的说明: Ks3

设置空间策略

指定者:

putBucketPolicy 在接口中 Ks3

参数:

bucketName - 桶名

policyText - 策略

抛出:

Ks3ClientException - exception

putBucketPolicy

public void putBucketPolicy(PutBucketPolicyRequest request)
                     throws Ks3ClientException

从接口复制的说明: Ks3

设置空间策略

指定者:

putBucketPolicy 在接口中 Ks3

参数:

request - 设置空间策略请求

抛出:

Ks3ClientException - exception

getBucketPolicy

public GetBucketPolicyResult getBucketPolicy(String bucketName)
                                      throws Ks3ClientException

从接口复制的说明: Ks3

获取空间策略，如果没有则报404 Not Found

指定者:

getBucketPolicy 在接口中 Ks3

参数:

bucketName - 空间名称

返回:

空间策略

抛出:

Ks3ClientException - exception

getBucketPolicy

public GetBucketPolicyResult getBucketPolicy(GetBucketPolicyRequest request)
                                      throws Ks3ClientException

从接口复制的说明: Ks3

获取空间策略，如果没有则报404 Not Found

指定者:

getBucketPolicy 在接口中 Ks3

参数:

request - 获取空间策略请求

返回:

空间策略

抛出:

Ks3ClientException - exception

deleteBucketPolicy

public void deleteBucketPolicy(String bucketName)
                        throws Ks3ClientException

从接口复制的说明: Ks3

删除空间策略

指定者:

deleteBucketPolicy 在接口中 Ks3

参数:

bucketName - 空间名称

抛出:

Ks3ClientException - exception

deleteBucketPolicy

public void deleteBucketPolicy(DeleteBucketPolicyRequest request)
                        throws Ks3ClientException

从接口复制的说明: Ks3

删除空间策略

指定者:

deleteBucketPolicy 在接口中 Ks3

参数:

request - 删除空间策略请求

抛出:

Ks3ClientException - exception

recoverObject

public void recoverObject(String bucketName,
                 String objectKey)
                   throws Ks3ClientException,
                          Ks3ServiceException

指定者:

recoverObject 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException

recoverObject

public void recoverObject(String bucketName,
                 String objectKey,
                 String retentionId)
                   throws Ks3ClientException,
                          Ks3ServiceException

指定者:

recoverObject 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException

recoverObject

public void recoverObject(RecoverObjectRequest request)
                   throws Ks3ClientException,
                          Ks3ServiceException

指定者:

recoverObject 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException

clearObject

public void clearObject(String bucketName,
               String objectKey,
               String retentionId)
                 throws Ks3ClientException,
                        Ks3ServiceException

指定者:

clearObject 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException

clearObject

public void clearObject(ClearObjectRequest request)
                 throws Ks3ClientException,
                        Ks3ServiceException

指定者:

clearObject 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException

getBucketRetention

public BucketRetentionConfiguration getBucketRetention(String bucketName)
                                                throws Ks3ClientException,
                                                       Ks3ServiceException

指定者:

getBucketRetention 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException

putBucketRetention

public void putBucketRetention(String bucketName,
                      BucketRetentionConfiguration retentionConfiguration)
                        throws Ks3ClientException,
                               Ks3ServiceException

指定者:

putBucketRetention 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException

putBucketRetention

public void putBucketRetention(PutBucketRetentionRequest request)
                        throws Ks3ClientException,
                               Ks3ServiceException

指定者:

putBucketRetention 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException

listRetentionObjects

public RetentionObjectListing listRetentionObjects(String bucketName)
                                            throws Ks3ClientException,
                                                   Ks3ServiceException

指定者:

listRetentionObjects 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException

listRetentionObjects

public RetentionObjectListing listRetentionObjects(String bucketName,
                                          String prefix)
                                            throws Ks3ClientException,
                                                   Ks3ServiceException

指定者:

listRetentionObjects 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException

listRetentionObjects

public RetentionObjectListing listRetentionObjects(ListRetentionObjectsRequest request)
                                            throws Ks3ClientException,
                                                   Ks3ServiceException

指定者:

listRetentionObjects 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException

processObject

public ProcessObjectResult processObject(String bucketName,
                                String key,
                                String process)
                                  throws Ks3ClientException,
                                         Ks3ServiceException

指定者:

processObject 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException

processObject

public ProcessObjectResult processObject(ProcessObjectRequest request)
                                  throws Ks3ClientException,
                                         Ks3ServiceException

指定者:

processObject 在接口中 Ks3

抛出:

Ks3ClientException

Ks3ServiceException

shutdown

public void shutdown()

从接口复制的说明: Ks3

关闭client，释放资源

指定者:

shutdown 在接口中 Ks3