对象存储服务 OBS-分段上传:列举分段上传任务

时间:2025-02-12 14:57:57

列举分段上传任务

您可以通过ObsClient.ListMultipartUploads列举分段上传任务。列举分段上传任务可设置的参数如下:

参数

作用

OBS .NET SDK对应属性

BucketName

桶名。

ListMultipartUploadsRequest.BucketName

Prefix

限定返回的分段上传任务中的对象名必须带有prefix前缀。

ListMultipartUploadsRequest.Prefix

Delimiter

用于对分段上传任务中的对象名进行分组的字符。对于对象名中包含Delimiter的任务,其对象名(如果请求中指定了Prefix,则此处的对象名需要去掉Prefix)中从首字符至第一个Delimiter之间的字符串将作为一个分组并作为CommonPrefix返回。

ListMultipartUploadsRequest.Delimiter

MaxUploads

列举分段上传任务的最大数目,取值范围为1~1000,当超出范围时,按照默认的1000进行处理。

ListMultipartUploadsRequest.MaxUploads

KeyMarker

表示列举时返回指定的keyMarker之后的分段上传任务。

ListMultipartUploadsRequest.KeyMarker

UploadIdMarker

只有与KeyMarker参数一起使用时才有意义,用于指定返回结果的起始位置,即列举时返回指定KeyMarker的UploadIdMarker之后的分段上传任务。

ListMultipartUploadsRequest.UploadIdMarker

  • 简单列举分段上传任务
// 初始化配置参数ObsConfig config = new ObsConfig();config.Endpoint = "https://your-endpoint";// 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全;本示例以ak和sk保存在环境变量中为例,运行本示例前请先在本地环境中设置环境变量AccessKeyID和SecretAccessKey。// 您可以登录访问管理控制台获取访问密钥AK/SK,获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.htmlstring accessKey= Environment.GetEnvironmentVariable("AccessKeyID", EnvironmentVariableTarget.Machine);string secretKey= Environment.GetEnvironmentVariable("SecretAccessKey", EnvironmentVariableTarget.Machine);// 创建ObsClient实例ObsClient client = new ObsClient(accessKey, secretKey, config);//简单列举分段上传任务try{    ListMultipartUploadsRequest listMultipartUploadsRequest = new ListMultipartUploadsRequest();    listMultipartUploadsRequest.BucketName = "bucketname";    ListMultipartUploadsResponse listMultipartUploadsResponse = client.ListMultipartUploads(listMultipartUploadsRequest);    Console.WriteLine("ListMultipartUploadsResponse status code: " + listMultipartUploadsResponse.StatusCode);    foreach (MultipartUpload upload in listMultipartUploadsResponse.MultipartUploads)    {        Console.WriteLine("ObjectKey {0}: " , upload.ObjectKey);        Console.WriteLine("Initiated {0}: " , upload.Initiated);        Console.WriteLine("\n");    }}catch (ObsException ex){    Console.WriteLine("ErrorCode: {0}", ex.ErrorCode);    Console.WriteLine("ErrorMessage: {0}", ex.ErrorMessage);}
  • 列举分段上传任务至多返回1000个任务信息,如果指定的桶包含的分段上传任务数量大于1000,则ListMultipartUploadsResponse.isTruncated为true表明本次没有返回全部结果,并可通过ListMultipartUploadsResponse.NextKeyMarker和ListMultipartUploadsResponse.NextUploadIdMarker获取下次列举的起点。
  • 如果想获取指定桶包含的所有分段上传任务,可以采用分页列举的方式。
  • 分页列举全部分段上传任务
// 初始化配置参数ObsConfig config = new ObsConfig();config.Endpoint = "https://your-endpoint";// 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全;本示例以ak和sk保存在环境变量中为例,运行本示例前请先在本地环境中设置环境变量AccessKeyID和SecretAccessKey。// 您可以登录访问管理控制台获取访问密钥AK/SK,获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.htmlstring accessKey= Environment.GetEnvironmentVariable("AccessKeyID", EnvironmentVariableTarget.Machine);string secretKey= Environment.GetEnvironmentVariable("SecretAccessKey", EnvironmentVariableTarget.Machine);// 创建ObsClient实例ObsClient client = new ObsClient(accessKey, secretKey, config);//列举全部分段上传任务try{    ListMultipartUploadsRequest request = new ListMultipartUploadsRequest();    request.BucketName = "bucketname";    ListMultipartUploadsResponse response;    do    {        response = client.ListMultipartUploads(request);        Console.WriteLine("ListMultipartUploadsResponse status code: " + response.StatusCode);        foreach (MultipartUpload upload in response.MultipartUploads)        {            Console.WriteLine("ObjectKey {0}: " , upload.ObjectKey);            Console.WriteLine("Initiated {0}: " , upload.Initiated);            Console.WriteLine("\n");        }        request.KeyMarker = response.NextKeyMarker;        request.UploadIdMarker = response.NextUploadIdMarker;    }    while (response.IsTruncated);}catch (ObsException ex){    Console.WriteLine("ErrorCode: {0}", ex.ErrorCode);    Console.WriteLine("ErrorMessage: {0}", ex.ErrorMessage);}
support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0408.html