QCloudHeadObjectRequest.h 5.0 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071
  1. //
  2. // HeadObject.h
  3. // HeadObject
  4. //
  5. // Created by tencent
  6. // Copyright (c) 2015年 tencent. All rights reserved.
  7. //
  8. // ██████╗ ██████╗██╗ ██████╗ ██╗ ██╗██████╗ ████████╗███████╗██████╗ ███╗ ███╗██╗███╗ ██╗ █████╗ ██╗ ██╗ █████╗ ██████╗
  9. // ██╔═══██╗██╔════╝██║ ██╔═══██╗██║ ██║██╔══██╗ ╚══██╔══╝██╔════╝██╔══██╗████╗ ████║██║████╗ ██║██╔══██╗██║ ██║ ██╔══██╗██╔══██╗
  10. // ██║ ██║██║ ██║ ██║ ██║██║ ██║██║ ██║ ██║ █████╗ ██████╔╝██╔████╔██║██║██╔██╗ ██║███████║██║ ██║ ███████║██████╔╝
  11. // ██║▄▄ ██║██║ ██║ ██║ ██║██║ ██║██║ ██║ ██║ ██╔══╝ ██╔══██╗██║╚██╔╝██║██║██║╚██╗██║██╔══██║██║ ██║ ██╔══██║██╔══██╗
  12. // ╚██████╔╝╚██████╗███████╗╚██████╔╝╚██████╔╝██████╔╝ ██║ ███████╗██║ ██║██║ ╚═╝ ██║██║██║ ╚████║██║ ██║███████╗ ███████╗██║ ██║██████╔╝
  13. // ╚══▀▀═╝ ╚═════╝╚══════╝ ╚═════╝ ╚═════╝ ╚═════╝ ╚═╝ ╚══════╝╚═╝ ╚═╝╚═╝ ╚═╝╚═╝╚═╝ ╚═══╝╚═╝ ╚═╝╚══════╝ ╚══════╝╚═╝ ╚═╝╚═════╝
  14. //
  15. //
  16. // _ __ _ _
  17. // (_) / _| | | | |
  18. // ___ ___ _ ____ ___ ___ ___ | |_ ___ _ __ __| | _____ _____| | ___ _ __ ___ _ __ ___
  19. // / __|/ _ \ '__\ \ / / |/ __/ _ \ | _/ _ \| '__| / _` |/ _ \ \ / / _ \ |/ _ \| '_ \ / _ \ '__/ __|
  20. // \__ \ __/ | \ V /| | (_| __/ | || (_) | | | (_| | __/\ V / __/ | (_) | |_) | __/ | \__
  21. // |___/\___|_| \_/ |_|\___\___| |_| \___/|_| \__,_|\___| \_/ \___|_|\___/| .__/ \___|_| |___/
  22. // ______ ______ ______ ______ ______ ______ ______ ______ | |
  23. // |______|______|______|______|______|______|______|______| |_|
  24. //
  25. #import <Foundation/Foundation.h>
  26. #import <QCloudCore/QCloudCore.h>
  27. NS_ASSUME_NONNULL_BEGIN
  28. /**
  29. 获取 COS 对象的元数据信息(meta data)的方法.
  30. 获取 COS 对象的元数据信息,需要与 Get 的权限一致.且请求是不返回消息体的.若请求中需要设置If-Modified-Since 头部,则统一采用 GMT(RFC822) 时间格式,例如:Tue, 22 Oct 2017 01:35:21 GMT.如果对象不存在,则 返回404.
  31. 关于获取 COS 对象的元数据信息接口的具体描述,请查看https://cloud.tencent.com/document/product/436/7745.
  32. cos iOS SDK 中获取 COS 对象的元数据信息的方法具体步骤如下:
  33. 1. 实例化 QCloudHeadObjectRequest,填入需要的参数。
  34. 2. 调用 QCloudCOSXMLService 对象中的 HeadObject 方法发出请求。
  35. 3. 从回调的 finishBlock 中的获取具体内容。
  36. 示例:
  37. @code
  38. QCloudHeadObjectRequest* headerRequest = [QCloudHeadObjectRequest new];
  39. headerRequest.bucket = @"bucketName"; //存储桶名称(cos v5 的 bucket格式为:xxx-appid, 如 test-1253960454)
  40. headerRequest.object = @"objectName";
  41. __block id resultError;
  42. [headerRequest setFinishBlock:^(NSDictionary* result, NSError *error) {
  43. resultError = error;
  44. }];
  45. [[QCloudCOSXMLService defaultCOSXML] HeadObject:headerRequest];
  46. @endcode
  47. */
  48. @interface QCloudHeadObjectRequest : QCloudBizHTTPRequest
  49. /**
  50. 对象的key
  51. */
  52. @property (strong, nonatomic) NSString *object;
  53. /**
  54. 存储桶名
  55. */
  56. @property (strong, nonatomic) NSString *bucket;
  57. @property (strong, nonatomic) NSString *ifModifiedSince;
  58. @end
  59. NS_ASSUME_NONNULL_END