最近更新时间:2022-12-30 15:48:03
KS3标准低频存储用于保存不频繁访问但在需要时也要求快速访问的数据。
用户可以在上传文件过程中,通过HTTP头指定存储类型;相应的,在下载文件过程中我们会通过HTTP响应头指示文件的存储类型。
除此之外,在用户枚举文件时也会返回文件的存储类型信息。
用户上传过程中,可以通过设置 x-kss-storage-class
头来指定存储类型。
有效值为: STANDARD
或 STANDARD_IA
。
对于无效的存储类型,KS3会拒绝本次请求。
请求语法:
PUT /{ObjectKey} HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}
x-kss-storage-class: {StorageClass}
注意:
SDK示例代码:
PutObjectRequest request = new PutObjectRequest(bucketName, key, file);
request.setStorageClass(StorageClass.StandardInfrequentAccess);
PutObjectResult result = client.putObject(request); // 假设已经合理初始化Ks3Client
用户可以在表单域中通过设置 x-kss-storage-class
域来指定存储类型。
有效值为: STANDARD
或 STANDARD_IA
。
对于无效的存储类型,KS3会拒绝本次请求。
Java SDK不支持POST方式上传文件。
用户可以在初始化分块上传时通过 x-kss-storage-class
请求头设置文件的存储类型。
有效值为: STANDARD
或 STANDARD_IA
。
对于无效的存储类型,KS3会拒绝本次请求。
请求语法:
POST /{ObjectKey}?uploads HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}
x-kss-storage-class: {StorageClass}
注意:
SDK示例代码:
InitiateMultipartUploadRequest request = new InitiateMultipartUploadRequest(bucketName, key);
request.setStorageClass(StorageClass.StandardInfrequentAccess);
InitiateMultipartUploadResult result = client.initiateMultipartUpload(request); // 假设已经合理初始化Ks3Client
后续的所有分块上传操作(Upload Part、Complete、Abort)都不再接受 x-kss-storage-class
请求头。
对于复制文件,KS3支持重新指定存储类型。若不指定目的文件的存储类型,则按照目标存储的默认存储类型保存。
对于复制分块,KS3目前不支持重新指定存储类型。目的文件的存储类型必须与源文件存储类型一致。
对于复制分块,KS3会忽略 x-kss-storage-class
请求头。
如果源文件存储类型与目的文件存储类型不一致,会报错。提示 InvalidStorageClass
。
用户下载文件时,如果文件是低频存储文件,则在响应头中会出现 x-kss-storage-class
头;标准存储文件下载时没有这个响应头。
GetObjectRequest request = new GetObjectRequest(bucketName, key);
GetObjectResult result = client.getObject(request);
Ks3Object object = result.getObject();
object.getObjectContent();
Java SDK中,可以通过获取元信息来查看存储类型,示例代码如下:
HeadObjectRequest request = new HeadObjectRequest(bucketName, key);
HeadObjectResult result =client.headObject(request);
String storageClass = result.getObjectMetadata().getStorageClass();
对于标准存储文件,getStorageClass
返回 null
;对于标准低频存储文件,getStorageClass
返回 STANDARD_IA
;对于归档存储文件,getStorageClass
返回 ARCHIVE
。
用户获取某个Bucket下文件时,KS3会为每个文件返回其存储类型。
SDK示例代码:
ListObjectsRequest request = new ListObjectsRequest(bucketName);
ObjectListing listing = client.listObjects(request);
for (Ks3ObjectSummary summary : listing.getObjectSummaries()) {
String storageClas = summary.getStorageClass();
}
对于标准存储文件,getStorageClass
返回 STANDARD
;对于标准低频存储文件,getStorageClass
返回 STANDARD_IA
;对于归档存储文件,getStorageClass
返回 ARCHIVE
。
用户在查看当前bucket下所有的分块上传请求时,KS3会为每个分块上传返回其存储类型。
SDK示例代码:
ListMultipartUploadsRequest request = new ListMultipartUploadsRequest(bucketName);
ListMultipartUploadsResult result = client.listMultipartUploads(request);
for (MultiPartUploadInfo uploadInfo : result.getUploads()) {
String storageClass = uploadInfo.getStorageClass();
}
对于标准存储文件,getStorageClass
返回 STANDARD
;对于标准低频存储文件,getStorageClass
返回 STANDARD_IA
;对于归档存储文件,getStorageClass
返回 ARCHIVE
。
用户在列举某个分块上传已经上传的块时,KS3会返回当前这次分块上传的存储类型。
SDK示例代码:
ListPartsRequest reqest = new ListPartsRequest(bucketName, key, result.getUploadId());
ListPartsResult result = client.listParts(reqest);
String storageClass = result.getStorageClass();
对于标准存储文件,getStorageClass
返回 STANDARD
;对于标准低频存储文件,getStorageClass
返回 STANDARD_IA
;对于归档存储文件,getStorageClass
返回 ARCHIVE
。
纯净模式