Method: COS::API#stat

Defined in:

lib/cos/api.rb

#stat(path, options = {}) ⇒ Object

目录/文件信息查询

Parameters:

• 资源路径, 如: 目录‘path1/’, 文件‘path1/file’

• (defaults to: {})

Options Hash (options):

• :bucket (String) —

  bucket名称

Returns:

• Hash

  • :name [String] 目录名/文件名

  • :biz_attr [String] 目录/文件属性，业务端维护

  • :filesize [Integer] 文件大小(当类型为文件时返回)

  • :filelen [Integer] 文件已传输大小(通过与filesize对比可知文件传输进度,当类型为文件时返回)

  • :sha [String] 文件sha1(当类型为文件时返回)

  • :ctime [String] 创建时间(Unix时间戳)

  • :mtime [String] 修改时间(Unix时间戳)

  • :access_url [String] 生成的资源可访问的url(当类型为文件时返回)

Raises:

• 服务端异常返回

See Also:

• {http://www.qcloud.com/wiki/%E7%9B%AE%E5%BD%95/%E6%96%87%E4%BB%B6%E4%BF%A1%E6%81%AF_%E6%9F%A5%E8%AF%A2}

# File 'lib/cos/api.rb', line 231

def stat(path, options = {})
  bucket        = config.get_bucket(options[:bucket])
  sign          = http.signature.multiple(bucket)
  resource_path = Util.get_resource_path_or_file(config.app_id, bucket, path)

  http.get(resource_path, {params: {op: 'stat'}}, sign)
end