github.com/qiniu/go-sdk/v7@v7.27.0/storagev2/apis/doc.go (about)

     1  // Package apis 提供七牛云对象存储的低级类型化 API 客户端。
     2  //
     3  // 本包代码由 api-generator 自动生成，请勿直接修改。
     4  //
     5  // [Storage] 提供了所有存储 API 的类型化方法，每个方法对应一个 API 接口，
     6  // 使用独立的 Request/Response 结构体。推荐使用 storagev2/uploader、
     7  // storagev2/downloader、storagev2/objects 等高级包，
     8  // 仅在需要直接调用底层 API 时使用本包。
     9  //
    10  // # 创建客户端
    11  //
    12  //	storage := apis.NewStorage(&http_client.Options{Credentials: cred})
    13  //
    14  // # 调用 API
    15  //
    16  // 所有方法遵循统一签名：Method(ctx, request, options) (response, error)
    17  //
    18  //	// 查询对象信息
    19  //	resp, err := storage.StatObject(ctx, &apis.StatObjectRequest{
    20  //	    Entry: "my-bucket:my-file.txt",
    21  //	}, nil)
    22  //
    23  //	// 获取存储空间列表
    24  //	resp, err := storage.GetBuckets(ctx, &apis.GetBucketsRequest{}, nil)
    25  //
    26  // # 主要 API 分类
    27  //
    28  //   - 对象操作: StatObject, DeleteObject, CopyObject, MoveObject, BatchOps
    29  //   - 存储空间: CreateBucket, DeleteBucket, GetBucketInfo, GetBuckets
    30  //   - 上传: ResumableUploadV1*, ResumableUploadV2*
    31  //   - 列举: GetObjects, GetObjectsV2
    32  //   - 生命周期: ModifyObjectLifeCycle, DeleteObjectAfterDays, SetObjectFileType
    33  //   - 归档: RestoreArchivedObject
    34  //   - 异步抓取: AsyncFetchObject, GetAsyncFetchTask
    35  //   - 区域查询: GetRegions, QueryBucketV2, QueryBucketV4
    36  //   - 域名: GetBucketDomains, GetBucketDomainsV3
    37  //   - 规则/事件: AddBucketRules, AddBucketEventRule 等
    38  //   - CORS/标签/防盗链: SetBucketCorsRules, SetBucketTaggings, SetBucketReferAntiLeech
    39  package apis