Package com.qiniu.storage

Class BucketManager

  • public final class BucketManager
extends java.lang.Object
    主要涉及了空间资源管理及批量操作接口的实现，具体的接口规格可以参考 参考文档：资源管理

    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description
      static class  BucketManager.BatchOperations
      文件管理批量操作指令构建对象，单次 BatchOperations 的操作数最多为 1000（即 add 最多 1000 个），如果遇到超时，需要调小操作数量
      class  BucketManager.FileListIterator
      创建文件列表迭代器

    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      Response asyncFetch​(java.lang.String url, java.lang.String bucket, StringMap params)
      异步第三方资源抓取 从指定 URL 抓取资源，并将该资源存储到指定空间中。每次只抓取一个文件，抓取时可以指定保存空间名和最终资源名。 主要对于大文件进行抓取 https://developer.qiniu.com/kodo/api/4097/asynch-fetch
      Response asynFetch​(java.lang.String url, java.lang.String bucket, java.lang.String key)
      异步第三方资源抓取 从指定 URL 抓取资源，并将该资源存储到指定空间中。每次只抓取一个文件，抓取时可以指定保存空间名和最终资源名。 主要对于大文件进行抓取 https://developer.qiniu.com/kodo/api/4097/asynch-fetch
      Response asynFetch​(java.lang.String url, java.lang.String bucket, java.lang.String key, java.lang.String md5, java.lang.String etag, java.lang.String callbackurl, java.lang.String callbackbody, java.lang.String callbackbodytype, java.lang.String callbackhost, int fileType)
      异步第三方资源抓取 从指定 URL 抓取资源，并将该资源存储到指定空间中。每次只抓取一个文件，抓取时可以指定保存空间名和最终资源名。 https://developer.qiniu.com/kodo/api/4097/asynch-fetch 提供更多参数的抓取 可以对抓取文件进行校验 和自定义抓取回调地址等
      Response batch​(BucketManager.BatchOperations operations)
      批量文件管理请求
      java.lang.String[] buckets()
      获取账号下所有空间名称列表
      Response bucketsResponse()  
      Response changeHeaders​(java.lang.String bucket, java.lang.String key, java.util.Map<java.lang.String,​java.lang.String> headers)
      修改文件的元数据
      Response changeMime​(java.lang.String bucket, java.lang.String key, java.lang.String mime)
      修改文件的MimeType
      Response changeStatus​(java.lang.String bucket, java.lang.String key, int status)
      修改文件的状态（禁用或者正常）
      Response changeType​(java.lang.String bucket, java.lang.String key, StorageType type)
      修改文件的类型（普通存储或低频存储）
      Response checkAsynFetchid​(java.lang.String region, java.lang.String fetchWorkId)
      查询异步抓取任务
      Response copy​(java.lang.String fromBucket, java.lang.String fromFileKey, java.lang.String toBucket, java.lang.String toFileKey)
      复制文件，要求空间在同一账号下
      Response copy​(java.lang.String fromBucket, java.lang.String fromFileKey, java.lang.String toBucket, java.lang.String toFileKey, boolean force)
      复制文件，要求空间在同一账号下，可以设置force参数为true强行覆盖空间已有同名文件
      Response createBucket​(java.lang.String bucketName, java.lang.String region)
      创建空间
      BucketManager.FileListIterator createFileListIterator​(java.lang.String bucket, java.lang.String prefix)
      根据前缀获取文件列表的迭代器
      BucketManager.FileListIterator createFileListIterator​(java.lang.String bucket, java.lang.String prefix, int limit, java.lang.String delimiter)
      根据前缀获取文件列表的迭代器
      Response delete​(java.lang.String bucket, java.lang.String key)
      删除指定空间、文件名的文件
      Response deleteAfterDays​(java.lang.String bucket, java.lang.String key, int days)
      设置文件的存活时间
      Response deleteBucketEvent​(java.lang.String bucket, java.lang.String ruleName)
      删除事件通知规则
      Response deleteBucketLifecycleRule​(java.lang.String bucket, java.lang.String ruleName)
      删除特定存储空间上设定的规则
      java.lang.String[] domainList​(java.lang.String bucket)
      获取该空间下所有的domain
      Response domainListResponse​(java.lang.String bucket)  
      static java.lang.String encodedEntry​(java.lang.String bucket)
      EncodedEntryURI格式，用在不指定key值的情况下
      static java.lang.String encodedEntry​(java.lang.String bucket, java.lang.String key)
      EncodedEntryURI格式，其中 bucket+":"+key 称之为 entry
      FetchRet fetch​(java.lang.String url, java.lang.String bucket)
      抓取指定地址的文件，以指定名称保存在指定空间 要求指定url可访问，大文件不建议使用此接口抓取。可先下载再上传 如果不指定保存的文件名，那么以文件内容的 etag 作为文件名
      FetchRet fetch​(java.lang.String url, java.lang.String bucket, java.lang.String key)
      抓取指定地址的文件，以指定名称保存在指定空间 要求指定url可访问，大文件不建议使用此接口抓取。可先下载再上传
      Response fetchResponse​(java.lang.String url, java.lang.String bucket, java.lang.String key)  
      BucketEventRule[] getBucketEvents​(java.lang.String bucket)
      获取事件通知规则
      Response getBucketEventsResponse​(java.lang.String bucket)  
      BucketInfo getBucketInfo​(java.lang.String bucket)
      查询空间信息
      Response getBucketInfoResponse​(java.lang.String bucket)  
      BucketLifeCycleRule[] getBucketLifeCycleRule​(java.lang.String bucket)
      获取指定空间上设置的生命周期规则
      Response getBucketLifeCycleRuleResponse​(java.lang.String bucket)  
      BucketQuota getBucketQuota​(java.lang.String bucket)
      获取空间配额
      Response getBucketQuotaResponse​(java.lang.String bucket)  
      CorsRule[] getCorsRules​(java.lang.String bucket)
      获取 bucket的cors（跨域）规则
      Response getCorsRulesResponse​(java.lang.String bucket)  
      FileListing listFiles​(java.lang.String bucket, java.lang.String prefix, java.lang.String marker, int limit, java.lang.String delimiter)  
      FileListing listFilesV2​(java.lang.String bucket, java.lang.String prefix, java.lang.String marker, int limit, java.lang.String delimiter)  
      Response listV1​(java.lang.String bucket, java.lang.String prefix, java.lang.String marker, int limit, java.lang.String delimiter)
      列举空间文件 v1 接口，返回一个 response 对象。
      Response listV2​(java.lang.String bucket, java.lang.String prefix, java.lang.String marker, int limit, java.lang.String delimiter)
      列举空间文件 v2 接口，返回一个 response 对象。v2 接口可以避免由于大量删除导致的列举超时问题，返回的 response 对象中的 body 可以转换为 string stream 来处理。
      Response move​(java.lang.String fromBucket, java.lang.String fromFileKey, java.lang.String toBucket, java.lang.String toFileKey)
      移动文件。要求空间在同一账号下, 可以添加force参数为true强行移动文件。
      Response move​(java.lang.String fromBucket, java.lang.String fromFileKey, java.lang.String toBucket, java.lang.String toFileKey, boolean force)
      移动文件，要求空间在同一账号下
      Response prefetch​(java.lang.String bucket, java.lang.String key)
      对于设置了镜像存储的空间，从镜像源站抓取指定名称的资源并存储到该空间中 如果该空间中已存在该名称的资源，则会将镜像源站的资源覆盖空间中相同名称的资源
      Response putBucketAccessMode​(java.lang.String bucket, AclType acl)
      设置bucket私有属性，0公有空间，1私有空间
      Response putBucketAccessStyleMode​(java.lang.String bucket, AccessStyleMode mode)
      设置原图保护模式
      Response putBucketEvent​(java.lang.String bucket, BucketEventRule rule)
      增加事件通知规则
      Response putBucketLifecycleRule​(java.lang.String bucket, BucketLifeCycleRule rule)
      设置存储空间内文件的生命周期规则
      Response putBucketMaxAge​(java.lang.String bucket, long maxAge)
      设置 Bucket 的cache-control: max-age 属性
      Response putBucketQuota​(java.lang.String bucket, BucketQuota bucketQuota)
      设置空间配额，配置解释请参考BucketQuota
      Response putCorsRules​(java.lang.String bucket, CorsRule[] rules)
      设置 bucket 的 cors（跨域）规则
      Response putReferAntiLeech​(java.lang.String bucket, BucketReferAntiLeech antiLeech)
      设置空间 referer 防盗链
      Response rename​(java.lang.String bucket, java.lang.String oldFileKey, java.lang.String newFileKey)
      重命名空间中的文件
      Response rename​(java.lang.String bucket, java.lang.String oldFileKey, java.lang.String newFileKey, boolean force)
      重命名空间中的文件，可以设置force参数为true强行覆盖空间已有同名文件
      Response restoreArchive​(java.lang.String bucket, java.lang.String key, int freezeAfterDays)
      解冻归档存储 文档：https://developer.qiniu.com/kodo/api/6380/restore-archive
      Response setBucketAcl​(java.lang.String bucket, AclType acl)
      Deprecated.
      Response setImage​(java.lang.String bucket, java.lang.String srcSiteUrl)
      Deprecated.
      Response setImage​(java.lang.String bucket, java.lang.String srcSiteUrl, java.lang.String host)
      Deprecated.
      Response setIndexPage​(java.lang.String bucket, IndexPageType type)
      设置 Bucket noIndexPage 属性
      FileInfo stat​(java.lang.String bucket, java.lang.String fileKey)
      获取空间中文件的属性
      Response statResponse​(java.lang.String bucket, java.lang.String fileKey)  
      Response unsetImage​(java.lang.String bucket)
      Deprecated.
      Response updateBucketEvent​(java.lang.String bucket, BucketEventRule rule)
      更新事件通知规则
      Response updateBucketLifeCycleRule​(java.lang.String bucket, BucketLifeCycleRule rule)
      更新特定存储空间上的生命周期规则

      • Methods inherited from class java.lang.Object

        equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Constructor Detail

      • BucketManager

        public BucketManager​(Auth auth,
                     Configuration cfg)
        构建一个新的 BucketManager 对象
        Parameters:
        auth - Auth对象
        cfg - Configuration对象

      • BucketManager

        public BucketManager​(Auth auth,
                     Client client)

    • Method Detail

      • encodedEntry

        public static java.lang.String encodedEntry​(java.lang.String bucket,
                                            java.lang.String key)
        EncodedEntryURI格式，其中 bucket+":"+key 称之为 entry
        Parameters:
        bucket - 空间名
        key - 文件 key
        Returns:
        UrlSafeBase64.encodeToString(entry) 相关链接

      • encodedEntry

        public static java.lang.String encodedEntry​(java.lang.String bucket)
        EncodedEntryURI格式，用在不指定key值的情况下
        Parameters:
        bucket - 空间名称
        Returns:
        UrlSafeBase64.encodeToString(bucket) 相关链接

      • buckets

        public java.lang.String[] buckets()
                           throws QiniuException
        获取账号下所有空间名称列表
        Returns:
        空间名称列表
        Throws:
        QiniuException - 异常

      • createBucket

        public Response createBucket​(java.lang.String bucketName,
                             java.lang.String region)
                      throws QiniuException
        创建空间
        Parameters:
        bucketName - 空间名
        region - 区域信息
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • domainList

        public java.lang.String[] domainList​(java.lang.String bucket)
                              throws QiniuException
        获取该空间下所有的domain
        Parameters:
        bucket - 空间名
        Returns:
        该空间名下的 domain
        Throws:
        QiniuException - 异常

      • createFileListIterator

        public BucketManager.FileListIterator createFileListIterator​(java.lang.String bucket,
                                                             java.lang.String prefix)
        根据前缀获取文件列表的迭代器
        Parameters:
        bucket - 空间名
        prefix - 文件名前缀
        Returns:
        FileInfo迭代器

      • createFileListIterator

        public BucketManager.FileListIterator createFileListIterator​(java.lang.String bucket,
                                                             java.lang.String prefix,
                                                             int limit,
                                                             java.lang.String delimiter)
        根据前缀获取文件列表的迭代器
        Parameters:
        bucket - 空间名
        prefix - 文件名前缀
        limit - 每次迭代的长度限制，最大1000，推荐值 100
        delimiter - 指定目录分隔符，列出所有公共前缀（模拟列出目录效果）。缺省值为空字符串
        Returns:
        FileInfo迭代器

      • listV1

        public Response listV1​(java.lang.String bucket,
                       java.lang.String prefix,
                       java.lang.String marker,
                       int limit,
                       java.lang.String delimiter)
                throws QiniuException
        列举空间文件 v1 接口，返回一个 response 对象。
        Parameters:
        bucket - 空间名
        prefix - 文件名前缀
        marker - 上一次获取文件列表时返回的 marker
        limit - 每次迭代的长度限制，最大1000，推荐值 100
        delimiter - 指定目录分隔符，列出所有公共前缀（模拟列出目录效果）。缺省值为空字符串
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • listFiles

        public FileListing listFiles​(java.lang.String bucket,
                             java.lang.String prefix,
                             java.lang.String marker,
                             int limit,
                             java.lang.String delimiter)
                      throws QiniuException
        Throws:
        QiniuException

      • listV2

        public Response listV2​(java.lang.String bucket,
                       java.lang.String prefix,
                       java.lang.String marker,
                       int limit,
                       java.lang.String delimiter)
                throws QiniuException
        列举空间文件 v2 接口，返回一个 response 对象。v2 接口可以避免由于大量删除导致的列举超时问题，返回的 response 对象中的 body 可以转换为 string stream 来处理。
        Parameters:
        bucket - 空间名
        prefix - 文件名前缀
        marker - 上一次获取文件列表时返回的 marker
        limit - 每次迭代的长度限制，推荐值 1000
        delimiter - 指定目录分隔符，列出所有公共前缀（模拟列出目录效果）。缺省值为空字符串
        Returns:
        Response 返回一个 okhttp response 对象
        Throws:
        QiniuException - 异常

      • listFilesV2

        public FileListing listFilesV2​(java.lang.String bucket,
                               java.lang.String prefix,
                               java.lang.String marker,
                               int limit,
                               java.lang.String delimiter)
                        throws QiniuException
        Throws:
        QiniuException

      • stat

        public FileInfo stat​(java.lang.String bucket,
                     java.lang.String fileKey)
              throws QiniuException
        获取空间中文件的属性
        Parameters:
        bucket - 空间名称
        fileKey - 文件名称
        Returns:
        文件属性
        Throws:
        QiniuException - 异常 相关链接

      • delete

        public Response delete​(java.lang.String bucket,
                       java.lang.String key)
                throws QiniuException
        删除指定空间、文件名的文件
        Parameters:
        bucket - 空间名称
        key - 文件名称
        Returns:
        Response
        Throws:
        QiniuException - 异常 相关链接

      • changeMime

        public Response changeMime​(java.lang.String bucket,
                           java.lang.String key,
                           java.lang.String mime)
                    throws QiniuException
        修改文件的MimeType
        Parameters:
        bucket - 空间名称
        key - 文件名称
        mime - 文件的新MimeType
        Returns:
        Response
        Throws:
        QiniuException - 异常 相关链接

      • changeHeaders

        public Response changeHeaders​(java.lang.String bucket,
                              java.lang.String key,
                              java.util.Map<java.lang.String,​java.lang.String> headers)
                       throws QiniuException
        修改文件的元数据
        Parameters:
        bucket - 空间名称
        key - 文件名称
        headers - 需要修改的文件元数据
        Returns:
        Response
        Throws:
        QiniuException - 异常 相关链接

      • changeType

        public Response changeType​(java.lang.String bucket,
                           java.lang.String key,
                           StorageType type)
                    throws QiniuException
        修改文件的类型（普通存储或低频存储）
        Parameters:
        bucket - 空间名称
        key - 文件名称
        type - type=0 表示普通存储，type=1 表示低频存存储, type=2 表示归档存储, type=3 表示深度归档存储
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • restoreArchive

        public Response restoreArchive​(java.lang.String bucket,
                               java.lang.String key,
                               int freezeAfterDays)
                        throws QiniuException
        解冻归档存储 文档：https://developer.qiniu.com/kodo/api/6380/restore-archive
        Parameters:
        bucket - 空间名称
        key - 文件名称
        freezeAfterDays - 解冻有效时长，取值范围 1～7
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • changeStatus

        public Response changeStatus​(java.lang.String bucket,
                             java.lang.String key,
                             int status)
                      throws QiniuException
        修改文件的状态（禁用或者正常）
        Parameters:
        bucket - 空间名称
        key - 文件名称
        status - 0表示启用；1表示禁用。
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • rename

        public Response rename​(java.lang.String bucket,
                       java.lang.String oldFileKey,
                       java.lang.String newFileKey,
                       boolean force)
                throws QiniuException
        重命名空间中的文件，可以设置force参数为true强行覆盖空间已有同名文件
        Parameters:
        bucket - 空间名称
        oldFileKey - 文件名称
        newFileKey - 新文件名
        force - 强制覆盖空间中已有同名（和 newFileKey 相同）的文件
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • rename

        public Response rename​(java.lang.String bucket,
                       java.lang.String oldFileKey,
                       java.lang.String newFileKey)
                throws QiniuException
        重命名空间中的文件
        Parameters:
        bucket - 空间名称
        oldFileKey - 文件名称
        newFileKey - 新文件名
        Returns:
        Response
        Throws:
        QiniuException - 异常 相关链接

      • copy

        public Response copy​(java.lang.String fromBucket,
                     java.lang.String fromFileKey,
                     java.lang.String toBucket,
                     java.lang.String toFileKey,
                     boolean force)
              throws QiniuException
        复制文件，要求空间在同一账号下，可以设置force参数为true强行覆盖空间已有同名文件
        Parameters:
        fromBucket - 源空间名称
        fromFileKey - 源文件名称
        toBucket - 目的空间名称
        toFileKey - 目的文件名称
        force - 强制覆盖空间中已有同名（和 toFileKey 相同）的文件
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • copy

        public Response copy​(java.lang.String fromBucket,
                     java.lang.String fromFileKey,
                     java.lang.String toBucket,
                     java.lang.String toFileKey)
              throws QiniuException
        复制文件，要求空间在同一账号下
        Parameters:
        fromBucket - 源空间名称
        fromFileKey - 源文件名称
        toBucket - 目的空间名称
        toFileKey - 目的文件名称
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • move

        public Response move​(java.lang.String fromBucket,
                     java.lang.String fromFileKey,
                     java.lang.String toBucket,
                     java.lang.String toFileKey,
                     boolean force)
              throws QiniuException
        移动文件，要求空间在同一账号下
        Parameters:
        fromBucket - 源空间名称
        fromFileKey - 源文件名称
        toBucket - 目的空间名称
        toFileKey - 目的文件名称
        force - 强制覆盖空间中已有同名（和 toFileKey 相同）的文件
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • move

        public Response move​(java.lang.String fromBucket,
                     java.lang.String fromFileKey,
                     java.lang.String toBucket,
                     java.lang.String toFileKey)
              throws QiniuException
        移动文件。要求空间在同一账号下, 可以添加force参数为true强行移动文件。
        Parameters:
        fromBucket - 源空间名称
        fromFileKey - 源文件名称
        toBucket - 目的空间名称
        toFileKey - 目的文件名称
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • fetch

        public FetchRet fetch​(java.lang.String url,
                      java.lang.String bucket)
               throws QiniuException
        抓取指定地址的文件，以指定名称保存在指定空间 要求指定url可访问，大文件不建议使用此接口抓取。可先下载再上传 如果不指定保存的文件名，那么以文件内容的 etag 作为文件名
        Parameters:
        url - 待抓取的文件链接
        bucket - 文件抓取后保存的空间
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • fetch

        public FetchRet fetch​(java.lang.String url,
                      java.lang.String bucket,
                      java.lang.String key)
               throws QiniuException
        抓取指定地址的文件，以指定名称保存在指定空间 要求指定url可访问，大文件不建议使用此接口抓取。可先下载再上传
        Parameters:
        url - 待抓取的文件链接
        bucket - 文件抓取后保存的空间
        key - 文件抓取后保存的文件名
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • asynFetch

        public Response asynFetch​(java.lang.String url,
                          java.lang.String bucket,
                          java.lang.String key)
                   throws QiniuException
        异步第三方资源抓取 从指定 URL 抓取资源，并将该资源存储到指定空间中。每次只抓取一个文件，抓取时可以指定保存空间名和最终资源名。 主要对于大文件进行抓取 https://developer.qiniu.com/kodo/api/4097/asynch-fetch
        Parameters:
        url - 待抓取的文件链接，支持设置多个,以';'分隔
        bucket - 文件抓取后保存的空间
        key - 文件抓取后保存的文件名
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • asynFetch

        public Response asynFetch​(java.lang.String url,
                          java.lang.String bucket,
                          java.lang.String key,
                          java.lang.String md5,
                          java.lang.String etag,
                          java.lang.String callbackurl,
                          java.lang.String callbackbody,
                          java.lang.String callbackbodytype,
                          java.lang.String callbackhost,
                          int fileType)
                   throws QiniuException
        异步第三方资源抓取 从指定 URL 抓取资源，并将该资源存储到指定空间中。每次只抓取一个文件，抓取时可以指定保存空间名和最终资源名。 https://developer.qiniu.com/kodo/api/4097/asynch-fetch 提供更多参数的抓取 可以对抓取文件进行校验 和自定义抓取回调地址等
        Parameters:
        url - 待抓取的文件链接，支持设置多个,以';'分隔
        bucket - 文件抓取后保存的空间
        key - 文件抓取后保存的文件名
        md5 - 文件md5,传入以后会在存入存储时对文件做校验，校验失败则不存入指定空间
        etag - 文件etag,传入以后会在存入存储时对文件做校验，校验失败则不存入指定空间
        callbackurl - 回调URL，详细解释请参考上传策略中的callbackUrl
        callbackbody - 回调Body，如果callbackurl不为空则必须指定。与普通上传一致支持魔法变量，
        callbackbodytype - 回调Body内容类型,默认为"application/x-www-form-urlencoded"，
        callbackhost - 回调时使用的Host
        fileType - 存储文件类型 0:正常存储(默认),1:低频存储
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • asyncFetch

        public Response asyncFetch​(java.lang.String url,
                           java.lang.String bucket,
                           StringMap params)
                    throws QiniuException
        异步第三方资源抓取 从指定 URL 抓取资源，并将该资源存储到指定空间中。每次只抓取一个文件，抓取时可以指定保存空间名和最终资源名。 主要对于大文件进行抓取 https://developer.qiniu.com/kodo/api/4097/asynch-fetch
        Parameters:
        url - 待抓取的文件链接，支持设置多个,以';'分隔
        bucket - 文件抓取后保存的空间
        params - 其他参数
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • checkAsynFetchid

        public Response checkAsynFetchid​(java.lang.String region,
                                 java.lang.String fetchWorkId)
                          throws QiniuException
        查询异步抓取任务
        Parameters:
        region - 抓取任务所在bucket区域 华东 z0 华北 z1 华南 z2 北美 na0 东南亚 as0
        fetchWorkId - 抓取任务id
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • prefetch

        public Response prefetch​(java.lang.String bucket,
                         java.lang.String key)
                  throws QiniuException
        对于设置了镜像存储的空间，从镜像源站抓取指定名称的资源并存储到该空间中 如果该空间中已存在该名称的资源，则会将镜像源站的资源覆盖空间中相同名称的资源
        Parameters:
        bucket - 空间名称
        key - 文件名称
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • setImage

        @Deprecated
public Response setImage​(java.lang.String bucket,
                         java.lang.String srcSiteUrl)
                  throws QiniuException
        Deprecated.
        设置空间的镜像源站
        Parameters:
        bucket - 空间名称
        srcSiteUrl - 镜像回源地址
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • setImage

        @Deprecated
public Response setImage​(java.lang.String bucket,
                         java.lang.String srcSiteUrl,
                         java.lang.String host)
                  throws QiniuException
        Deprecated.
        设置空间的镜像源站
        Parameters:
        bucket - 空间名称
        srcSiteUrl - 镜像回源地址
        host - 镜像回源Host
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • unsetImage

        @Deprecated
public Response unsetImage​(java.lang.String bucket)
                    throws QiniuException
        Deprecated.
        取消空间的镜像源站设置
        Parameters:
        bucket - 空间名称
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • deleteAfterDays

        public Response deleteAfterDays​(java.lang.String bucket,
                                java.lang.String key,
                                int days)
                         throws QiniuException
        设置文件的存活时间
        Parameters:
        bucket - 空间名称
        key - 文件名称
        days - 存活时间，单位：天
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • setIndexPage

        public Response setIndexPage​(java.lang.String bucket,
                             IndexPageType type)
                      throws QiniuException
        设置 Bucket noIndexPage 属性
        Parameters:
        bucket - 空间名
        type - type 为 0 表示启用 indexPage，为 1 表示不启用indexPage
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • getBucketInfo

        public BucketInfo getBucketInfo​(java.lang.String bucket)
                         throws QiniuException
        查询空间信息
        Parameters:
        bucket - 空间名
        Returns:
        bucket 信息
        Throws:
        QiniuException - 异常

      • putReferAntiLeech

        public Response putReferAntiLeech​(java.lang.String bucket,
                                  BucketReferAntiLeech antiLeech)
                           throws QiniuException
        设置空间 referer 防盗链
        Parameters:
        bucket - 空间名
        antiLeech - 空间 referer 防盗链信息
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • putBucketLifecycleRule

        public Response putBucketLifecycleRule​(java.lang.String bucket,
                                       BucketLifeCycleRule rule)
                                throws QiniuException
        设置存储空间内文件的生命周期规则
        Parameters:
        bucket - 空间名
        rule - 生命周期规则
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • deleteBucketLifecycleRule

        public Response deleteBucketLifecycleRule​(java.lang.String bucket,
                                          java.lang.String ruleName)
                                   throws QiniuException
        删除特定存储空间上设定的规则
        Parameters:
        bucket - 空间名
        ruleName - 规则名
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • updateBucketLifeCycleRule

        public Response updateBucketLifeCycleRule​(java.lang.String bucket,
                                          BucketLifeCycleRule rule)
                                   throws QiniuException
        更新特定存储空间上的生命周期规则
        Parameters:
        bucket - 空间名
        rule - 生命周期规则
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • getBucketLifeCycleRule

        public BucketLifeCycleRule[] getBucketLifeCycleRule​(java.lang.String bucket)
                                             throws QiniuException
        获取指定空间上设置的生命周期规则
        Parameters:
        bucket - 空间名
        Returns:
        生命周期规则
        Throws:
        QiniuException - 异常

      • deleteBucketEvent

        public Response deleteBucketEvent​(java.lang.String bucket,
                                  java.lang.String ruleName)
                           throws QiniuException
        删除事件通知规则
        Parameters:
        bucket - 空间名
        ruleName - 规则名
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • updateBucketEvent

        public Response updateBucketEvent​(java.lang.String bucket,
                                  BucketEventRule rule)
                           throws QiniuException
        更新事件通知规则
        Parameters:
        bucket - 空间名
        rule - 通知规则
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • getBucketEvents

        public BucketEventRule[] getBucketEvents​(java.lang.String bucket)
                                  throws QiniuException
        获取事件通知规则
        Parameters:
        bucket - 空间名
        Returns:
        事件通知
        Throws:
        QiniuException - 异常

      • putCorsRules

        public Response putCorsRules​(java.lang.String bucket,
                             CorsRule[] rules)
                      throws QiniuException
        设置 bucket 的 cors（跨域）规则
        Parameters:
        bucket - 空间名
        rules - 跨域）规则
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • getCorsRules

        public CorsRule[] getCorsRules​(java.lang.String bucket)
                        throws QiniuException
        获取 bucket的cors（跨域）规则
        Parameters:
        bucket - 空间名
        Returns:
        跨域规则
        Throws:
        QiniuException - 异常

      • putBucketAccessStyleMode

        public Response putBucketAccessStyleMode​(java.lang.String bucket,
                                         AccessStyleMode mode)
                                  throws QiniuException
        设置原图保护模式
        Parameters:
        bucket - 空间名
        mode - 原图保护模式，1表示开启原图保护，0表示关闭，默认为0
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • putBucketMaxAge

        public Response putBucketMaxAge​(java.lang.String bucket,
                                long maxAge)
                         throws QiniuException
        设置 Bucket 的cache-control: max-age 属性
        Parameters:
        bucket - 空间名
        maxAge - max-age，为 0 或者负数表示为默认值（31536000）
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • putBucketAccessMode

        public Response putBucketAccessMode​(java.lang.String bucket,
                                    AclType acl)
                             throws QiniuException
        设置bucket私有属性，0公有空间，1私有空间
        Parameters:
        bucket - 空间名
        acl - 私有属性
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • setBucketAcl

        @Deprecated
public Response setBucketAcl​(java.lang.String bucket,
                             AclType acl)
                      throws QiniuException
        Deprecated.
        设置 bucket 私有属性，0: 公有空间，1: 私有空间
        推荐使用putBucketAccessMode
        Parameters:
        bucket - 空间名
        acl - 私有属性
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • putBucketQuota

        public Response putBucketQuota​(java.lang.String bucket,
                               BucketQuota bucketQuota)
                        throws QiniuException
        设置空间配额，配置解释请参考BucketQuota
        Parameters:
        bucket - 空间名
        bucketQuota - 空间配额
        Returns:
        Response
        Throws:
        QiniuException - 异常

      • getBucketQuota

        public BucketQuota getBucketQuota​(java.lang.String bucket)
                           throws QiniuException
        获取空间配额
        Parameters:
        bucket - 空间名
        Returns:
        BucketQuota
        Throws:
        QiniuException - 异常

      • batch

        public Response batch​(BucketManager.BatchOperations operations)
               throws QiniuException
        批量文件管理请求

        如果遇到超时比较多，可减小单次 batch 操作的数量，或者在创建 BucketManager 时尝试增加超时时间； 增加超时时间的具体方式如下： Configuration cfg = new Configuration(); cfg.readTimeout = 120; BucketManager bucketManager = new BucketManager(auth, cfg);

        如果 BucketManager 定义了 Client ，可以指定 Client 的超时时间。

        Parameters:
        operations - batch 操作信息
        Returns:
        Response
        Throws:
        QiniuException - 异常