def copy(self, bucket, key, bucket_to, key_to, force='false'):
"""复制文件:
将指定资源复制为新命名资源，具体规格参考：
http://developer.qiniu.com/docs/v6/api/reference/rs/copy.html
Args:
bucket: 待操作资源所在空间
bucket_to: 目标资源空间名
key: 待操作资源文件名
key_to: 目标资源文件名
Returns:
一个dict变量，成功返回NULL，失败返回{"error": "<errMsg string>"}
一个ResponseInfo对象
"""
resource = entry(bucket, key)
to = entry(bucket_to, key_to)
return self.__rs_do('copy', resource, to, 'force/{0}'.format(force))
def move(self, bucket, key, bucket_to, key_to):
"""移动文件:
将资源从一个空间到另一个空间，具体规格参考：
http://developer.qiniu.com/docs/v6/api/reference/rs/move.html
Args:
bucket: 待操作资源所在空间
bucket_to: 目标资源空间名
key: 待操作资源文件名
key_to: 目标资源文件名
Returns:
一个dict变量，成功返回NULL，失败返回{"error": "<errMsg string>"}
一个ResponseInfo对象
"""
resource = entry(bucket, key)
to = entry(bucket_to, key_to)
return self.__rs_do('move', resource, to)
def change_type(self, bucket, key, storage_type):
"""修改文件的存储类型
修改文件的存储类型为普通存储或者是低频存储，参考文档：
https://developer.qiniu.com/kodo/api/3710/modify-the-file-type
Args:
bucket: 待操作资源所在空间
key: 待操作资源文件名
storage_type: 待操作资源存储类型，0为普通存储，1为低频存储
"""
resource = entry(bucket, key)
return self.__rs_do('chtype', resource, 'type/{0}'.format(storage_type))
def change_mime(self, bucket, key, mime):
"""修改文件mimeType:
主动修改指定资源的文件类型，具体规格参考：
http://developer.qiniu.com/docs/v6/api/reference/rs/chgm.html
Args:
bucket: 待操作资源所在空间
key: 待操作资源文件名
mime: 待操作文件目标mimeType
"""
resource = entry(bucket, key)
encode_mime = urlsafe_base64_encode(mime)
return self.__rs_do('chgm', resource, 'mime/{0}'.format(encode_mime))
def delete(self, bucket, key):
"""删除文件:
删除指定资源，具体规格参考：
http://developer.qiniu.com/docs/v6/api/reference/rs/delete.html
Args:
bucket: 待获取信息资源所在的空间
key: 待获取资源的文件名
Returns:
一个dict变量，成功返回NULL，失败返回{"error": "<errMsg string>"}
一个ResponseInfo对象
"""
resource = entry(bucket, key)
return self.__rs_do('delete', resource)
def prefetch(self, bucket, key):
"""镜像回源预取文件:
从镜像源站抓取资源到空间中，如果空间中已经存在，则覆盖该资源，具体规格参考
http://developer.qiniu.com/docs/v6/api/reference/rs/prefetch.html
Args:
bucket: 待获取资源所在的空间
key: 代获取资源文件名
Returns:
一个dict变量，成功返回NULL，失败返回{"error": "<errMsg string>"}
一个ResponseInfo对象
"""
resource = entry(bucket, key)
return self.__io_do(bucket, 'prefetch', resource)
def fetch(self, url, bucket, key=None):
"""抓取文件:
从指定URL抓取资源，并将该资源存储到指定空间中，具体规格参考：
http://developer.qiniu.com/docs/v6/api/reference/rs/fetch.html
Args:
url: 指定的URL
bucket: 目标资源空间
key: 目标资源文件名
Returns:
一个dict变量，成功返回NULL，失败返回{"error": "<errMsg string>"}
一个ResponseInfo对象
"""
resource = urlsafe_base64_encode(url)
to = entry(bucket, key)
return self.__io_do(bucket, 'fetch', resource, 'to/{0}'.format(to))
def delete_after_days(self, bucket, key, days):
"""更新文件生命周期
Returns:
一个dict变量，返回结果类似：
[
{ "code": <HttpCode int>, "data": <Data> },
{ "code": <HttpCode int> },
{ "code": <HttpCode int> },
{ "code": <HttpCode int> },
{ "code": <HttpCode int>, "data": { "error": "<ErrorMessage string>" } },
...
]
一个ResponseInfo对象
Args:
bucket: 目标资源空间
key: 目标资源文件名
days: 指定天数
"""
resource = entry(bucket, key)
return self.__rs_do('deleteAfterDays', resource, days)
def stat(self, bucket, key):
"""获取文件信息:
获取资源的元信息，但不返回文件内容，具体规格参考：
http://developer.qiniu.com/docs/v6/api/reference/rs/stat.html
Args:
bucket: 待获取信息资源所在的空间
key: 待获取资源的文件名
Returns:
一个dict变量，类似：
{
"fsize": 5122935,
"hash": "ljfockr0lOil_bZfyaI2ZY78HWoH",
"mimeType": "application/octet-stream",
"putTime": 13603956734587420
}
一个ResponseInfo对象
"""
resource = entry(bucket, key)
return self.__rs_do('stat', resource)
def _one_key_batch(operation, bucket, keys):
return [_build_op(operation, entry(bucket, key)) for key in keys]
def _three_key_batch(operation, bucket, keys):
return [
_build_op(operation, entry(bucket, k), f'freezeAfterDays/{v}')
for k, v in keys.items()
]
def _two_key_batch(operation, source_bucket, key_pairs, target_bucket):
if target_bucket is None:
target_bucket = source_bucket
return [_build_op(operation, entry(source_bucket, k), entry(target_bucket, v)) for k, v in key_pairs.items()]
def move(self, bucket, key, bucket_to, key_to):
resource = entry(bucket, key)
to = entry(bucket_to, key_to)
return self.__rs_do('move', resource, to)
def op_save(op, bucket, key):
return pipe_cmd(op, 'saveas/' + entry(bucket, key))
def op_save(op, bucket, key):
return pipe_cmd(op, 'saveas/' + entry(bucket, key))
def change_mime(self, bucket, key, mime):
resource = entry(bucket, key)
encode_mime = urlsafe_base64_encode(mime)
return self.__rs_do('chgm', resource, 'mime/{0}'.format(encode_mime))
def prefetch(self, bucket, key):
resource = entry(bucket, key)
return self.__io_do('prefetch', resource)
def fetch(self, url, bucket, key):
resource = urlsafe_base64_encode(url)
to = entry(bucket, key)
return self.__io_do('fetch', resource, 'to/{0}'.format(to))
def copy(self, bucket, key, bucket_to, key_to):
resource = entry(bucket, key)
to = entry(bucket_to, key_to)
return self.__rs_do('copy', resource, to)
def _one_key_batch(operation, bucket, keys):
return [_build_op(operation, entry(bucket, key)) for key in keys]
def _two_key_batch(operation, source_bucket, key_pairs, target_bucket, force='false'):
if target_bucket is None:
target_bucket = source_bucket
return [_build_op(operation, entry(source_bucket, k), entry(target_bucket, v), 'force/{0}'.format(force)) for k, v in key_pairs.items()]
def stat(self, bucket, key):
resource = entry(bucket, key)
return self.__rs_do('stat', resource)
def op_saveas(bucket, key):
return 'saveas/{0}'.format(entry(bucket, key))
def delete(self, bucket, key):
resource = entry(bucket, key)
return self.__rs_do('delete', resource)
