tencent_cloud_cos v0.1.1

View Source COS.Bucket (tencent_cloud_cos v0.1.1)

存储桶（Bucket）是对象的载体，可理解为存放对象的“容器”，且该“容器”无容量上限。

腾讯云文档

Link to this section Summary

Functions

delete(host, opts \\ [])

删除存储桶 - 腾讯云文档

head(host, opts \\ [])

检索存储桶 - 腾讯云文档

list_objects(host, opts \\ [])

查询对象列表 - 腾讯云文档

list_objects_with_versions(host, opts \\ [])

查询对象历史版本列表 - 腾讯云文档

put(host, opts \\ [])

创建存储桶 - 腾讯云文档

Link to this section Functions

Link to this function

delete(host, opts \\ [])

View Source 
@spec delete(host :: binary(), opts :: [{:tesla_opts, Tesla.Env.opts()}]) ::
  Tesla.Env.t()

删除存储桶 - 腾讯云文档

Link to this function

head(host, opts \\ [])

View Source 
@spec head(host :: binary(), opts :: [{:tesla_opts, Tesla.Env.opts()}]) ::
  Tesla.Env.t()

检索存储桶 - 腾讯云文档

确认该存储桶是否存在，是否有权限访问。有以下几种情况：

  • 存储桶存在且有读取权限，返回 HTTP 状态码为200。
  • 无存储桶读取权限，返回 HTTP 状态码为403。
  • 存储桶不存在，返回 HTTP 状态码为404。
Link to this function

list_objects(host, opts \\ [])

View Source 
@spec list_objects(
  host :: binary(),
  opts :: [
    query: %{
      optional(:prefix) => binary(),
      optional(:delimiter) => binary(),
      optional(:marker) => binary(),
      optional(:encoding_type) => binary(),
      optional(:max_keys) => pos_integer()
    },
    tesla_opts: Tesla.Env.opts()
  ]
) :: Tesla.Env.t()

查询对象列表 - 腾讯云文档

Link to this function

list_objects_with_versions(host, opts \\ [])

View Source 
@spec list_objects_with_versions(
  host :: binary(),
  opts :: [
    query: %{
      optional(:prefix) => binary(),
      optional(:delimiter) => binary(),
      optional(:encoding_type) => binary(),
      optional(:max_keys) => pos_integer(),
      optional(:key_maker) => binary(),
      optional(:version_id_marker) => binary()
    },
    tesla_opts: Tesla.Env.opts()
  ]
) :: Tesla.Env.t()

查询对象历史版本列表 - 腾讯云文档

Link to this function

put(host, opts \\ [])

View Source 
@spec put(
  host :: binary(),
  opts :: [
    body: %{bucket_a_z_config: binary()} | nil,
    headers: Tesla.Env.headers(),
    tesla_opts: Tesla.Env.opts()
  ]
) :: Tesla.Env.t()

创建存储桶 - 腾讯云文档

示例

 示例 

iex> COS.Bucket.put("https://bucket-1250000000.cos.ap-beijing.myqcloud.com")
{:ok, %Tesla.Env{
  body: "",
  headers: [
    {"server", "tencent-cos"},
    {"data", "Tue, 29 Mar 2022 16:39:58 GMT"},
    ...
  ],
  ...
}}

# 创建多 AZ 存储桶
COS.Bucket.put(
  "https://bucket-1250000000.cos.ap-beijing.myqcloud.com",
  body: %{bucket_a_z_config: "MAZ"}
)