QCloudGetBucketLocationRequest.h 5.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869
  1. //
  2. // GetBucketLocation.h
  3. // GetBucketLocation
  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. #import "QCloudBucketLocationConstraint.h"
  28. NS_ASSUME_NONNULL_BEGIN
  29. /**
  30. 获取存储桶(Bucket) 所在的地域信息的方法.
  31. 在创建 Bucket 时,需要指定所属该 Bucket 所属地域信息.
  32. COS 支持的地域信息,可查看https://cloud.tencent.com/document/product/436/6224.
  33. 关于获取 Bucket 所在的地域信息接口的具体描述,请查看https://cloud.tencent.com/document/product/436/8275.
  34. cos iOS SDK 中获取 Bucket 所在的地域信息的方法具体步骤如下:
  35. 1. 实例化 QCloudGetBucketLocationRequest,填入需要的参数。
  36. 2. 调用 QCloudCOSXMLService 对象中的 GetBucketLocation 方法发出请求。
  37. 3. 从回调的 finishBlock 中的 QCloudBucketLocationConstraint 获取具体内容。
  38. 示例:
  39. @code
  40. QCloudGetBucketLocationRequest* locationReq = [QCloudGetBucketLocationRequest new];
  41. locationReq.bucket = @"bucketName";//存储桶名称(cos v5 的 bucket格式为:xxx-appid, 如 test-1253960454)
  42. __block QCloudBucketLocationConstraint* location;
  43. [locationReq setFinishBlock:^(QCloudBucketLocationConstraint * _Nonnull result, NSError * _Nonnull error) {
  44. location = result;
  45. }];
  46. [[QCloudCOSXMLService defaultCOSXML] GetBucketLocation:locationReq];
  47. @endcode
  48. */
  49. @interface QCloudGetBucketLocationRequest : QCloudBizHTTPRequest
  50. /**p
  51. 存储桶名
  52. */
  53. @property (strong, nonatomic) NSString *bucket;
  54. - (void) setFinishBlock:(void (^)(QCloudBucketLocationConstraint* result, NSError * error))QCloudRequestFinishBlock;
  55. @end
  56. NS_ASSUME_NONNULL_END