Aliyun.Oss.Object (aliyun_oss v3.1.2)

Object operations - basic operations.

Other operations can be found in:

Summary

Types

error()

Functions

append_object(config, bucket, object, content, position, options \\ [])

AppendObject - uploads an object by appending the content of the object to an existing object.

clean_restored_object(config, bucket, object)

CleanRestoredObject

copy_object(config, arg1, arg2, options \\ [])

CopyObject - copies objects within a bucket or between buckets in the same region.

delete_multiple_objects(config, bucket, objects_or_xml_body, options \\ [])

DeleteMultipleObjects - deletes multiple objects from a bucket.

delete_object(config, bucket, object, options \\ [])

DeleteObject - deletes an object.

get_object(config, bucket, object, options \\ [])

GetObject - gets an object.

get_object_meta(config, bucket, object)

GetObjectMeta - gets the metadata of an object, including ETag, Size, and LastModified.

head_object(config, bucket, object, options \\ [])

HeadObject - gets the metadata of an object.

object_url(config, bucket, object, expires)

Creates a signed URL for accessing an object.

post_object(config, bucket, object, body, options)
put_object(config, bucket, object, body, options \\ [])

PutObject - uploads objects.

restore_object(config, bucket, object)

RestoreObject - restores an Archive object or a Cold Archive object.

select_object(config, bucket, object, select_request, options \\ [])

SelectObject - executes SQL statements to perform operations on an object and obtains the execution results.

select_object_meta(config, bucket, object, select_request, options \\ [])

CreateSelectObjectMeta - 获取目标文件总的行数，总的列数（对于 CSV 文件），以及 Splits 个数。

sign_post_policy(config, policy)

Signs Post Policy, and returns the encoded Post Policy and its signature.

signed_url(config, bucket, object, options \\ [])

Creates a signed URL for an object.

Types

error()

@type error() ::
  %Aliyun.Oss.Client.Error{
    body: String.t(),
    parsed_details: map(),
    status_code: integer()
  }
  | atom()

Functions

append_object(config, bucket, object, content, position, options \\ [])

@spec append_object(
  Aliyun.Oss.Config.t(),
  String.t(),
  String.t(),
  String.t(),
  integer(),
  map()
) ::
  {:error, error()} | {:ok, Aliyun.Oss.Client.Response.t()}

AppendObject - uploads an object by appending the content of the object to an existing object.

Examples

iex> Aliyun.Oss.Object.append_object(config, "some-bucket", "some-object", "CONTENT", 0)
{:ok, %Aliyun.Oss.Client.Response{
    data: "",
    headers: %{
      "connection" => ["keep-alive"],
      "content-length" => ["0"],
      "date" => ["Fri, 11 Jul 2025 02:46:19 GMT"],
      "etag" => [""AE9A6C899***********************""],
      "server" => ["AliyunOSS"],
      "x-oss-hash-crc64ecma" => ["178569**************"],
      "x-oss-next-append-position" => ["7"],
      "x-oss-request-id" => ["68707AFB****************"],
      "x-oss-server-time" => ["15"]
    }
  }
}

clean_restored_object(config, bucket, object)

@spec clean_restored_object(Aliyun.Oss.Config.t(), String.t(), String.t()) ::
  {:error, error()} | {:ok, Aliyun.Oss.Client.Response.t()}

CleanRestoredObject

Examples

iex> Aliyun.Oss.Object.clean_restored_object(config, "some-bucket", "some-object")
{:ok, %Aliyun.Oss.Client.Response{
    data: "",
    headers: %{
      "connection" => ["keep-alive"],
      "content-length" => ["0"],
      "date" => ["Fri, 11 Jul 2025 03:13:57 GMT"],
      "server" => ["AliyunOSS"],
      "x-oss-request-id" => ["68708175A***************"],
      "x-oss-server-time" => ["6"]
    }
  }
}

copy_object(config, arg1, arg2, options \\ [])

@spec copy_object(
  Aliyun.Oss.Config.t(),
  {String.t(), String.t()},
  {String.t(), String.t()},
  keyword()
) ::
  {:error, error()} | {:ok, Aliyun.Oss.Client.Response.t()}

CopyObject - copies objects within a bucket or between buckets in the same region.

Options

  • :headers - Defaults to %{}

Examples

iex> Aliyun.Oss.Object.copy_object(config, {"source-bucket", "source-object"}, {"target-bucket", "target-object"})
{:ok, %Aliyun.Oss.Client.Response{
    data: %{
      "CopyObjectResult" => %{
        "ETag" => ""D2D5****************************"",
        "LastModified" => "2025-02-27T09:21:13.000Z"
      }
    },
    headers: %{
      "connection" => ["keep-alive"],
      "content-type" => ["application/xml"],
      "date" => ["Fri, 11 Jul 2025 02:35:21 GMT"],
      "etag" => [""A65CF7B9************************""],
      "server" => ["AliyunOSS"],
      "x-oss-copied-size" => ["20"],
      "x-oss-hash-crc64ecma" => ["16211***************"],
      "x-oss-ia-retrieve-flow-type" => ["0"],
      "x-oss-request-id" => ["68707869D***************"],
      "x-oss-server-time" => ["71"],
      "x-oss-version-id" => ["null"]
    }
  }
}

delete_multiple_objects(config, bucket, objects_or_xml_body, options \\ [])

@spec delete_multiple_objects(
  Aliyun.Oss.Config.t(),
  String.t(),
  [String.t()] | String.t(),
  keyword()
) ::
  {:error, error()} | {:ok, Aliyun.Oss.Client.Response.t()}

DeleteMultipleObjects - deletes multiple objects from a bucket.

Options

  • :encoding_type - Accept value: :url
  • :quiet - Set true to enable the quiet mode, default is false. This option will be ignored if you pass the raw xml body as the 3rd argument.

Examples

iex> Aliyun.Oss.Object.delete_multiple_objects(config, "some-bucket", ["object1", "object2"])
{:ok, %Aliyun.Oss.Client.Response{
    data: %{
      "DeleteResult" => %{
        "Deleted" => [
          %{"Key" => "object1"},
          %{"Key" => "object2"}
        ]
      }
    },
    headers: %{
      "connection" => ["keep-alive"],
      "content-type" => ["application/xml"],
      ...
    }
  }
}
iex> xml_body = ~S[
<?xml version="1.0" encoding="UTF-8"?>
<Delete>
  <Quiet>false</Quiet>
  <Object>
    <Key>multipart.data</Key>
    <VersionId>CAEQNRiBgIDyz.6C0BYiIGQ2NWEwNmVhNTA3ZTQ3MzM5ODliYjM1ZTdjYjA4****</VersionId>
  </Object>
</Delete>
]
iex> Aliyun.Oss.Object.delete_multiple_objects(config, "some-bucket", xml_body)
{:ok, %Aliyun.Oss.Client.Response{
    data: %{
      "DeleteResult" => %{
        "Deleted" => [
          %{
            "Key" => "multipart.data",
            "VersionId" => "CAEQNRiBgIDyz.6C0BYiIGQ2NWEwNmVhNTA3ZTQ3MzM5ODliYjM1ZTdjYjA4****"
          },
        ]
      }
    },
    headers: %{
      "connection" => ["keep-alive"],
      "content-type" => ["application/xml"],
      ...
    }
  }
}

delete_object(config, bucket, object, options \\ [])

DeleteObject - deletes an object.

Options

  • :query_params - Defaults to %{}
  • :headers - Defaults to %{}

Examples

iex> Aliyun.Oss.Object.delete_object(config, "some-bucket", "some-object")
{:ok, %Aliyun.Oss.Client.Response{
    data: "",
    headers: %{
      "connection" => ["keep-alive"],
      "content-length" => ["0"],
      ...
    }
  }
}

get_object(config, bucket, object, options \\ [])

@spec get_object(Aliyun.Oss.Config.t(), String.t(), String.t(), keyword()) ::
  {:error, error()} | {:ok, Aliyun.Oss.Client.Response.t()}

GetObject - gets an object.

Options

  • :query_params - Defaults to %{}
  • :headers - Defaults to %{}

Examples

iex> Aliyun.Oss.Object.get_object(config, "some-bucket", "some-object")
{:ok, %Aliyun.Oss.Client.Response{
    data: <<208, 207, 17, 224, 161, 177, 26, 225, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
      0, 0, 0, 62, 0, 3, 0, 254, 255, 9, 0, 6, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 18,
      0, 0, 0, ...>>,
    headers: %{
      "accept-ranges" => ["bytes"],
      "connection" => ["keep-alive"],
      "content-md5" => ["wpqajJtzJSpf8lOY/W4Hqg=="],
      "content-type" => ["text/plain"],
      "date" => ["Fri, 04 Jul 2025 05:45:44 GMT"],
      "etag" => [""C29000000000000000000000000000AA""],
      "last-modified" => ["Fri, 15 Jan 2021 09:16:13 GMT"],
      "server" => ["AliyunOSS"],
      "x-oss-hash-crc64ecma" => ["587015626014620604"],
      "x-oss-object-type" => ["Normal"],
      "x-oss-request-id" => ["6860000000000000000000A3"],
      "x-oss-server-time" => ["41"],
      "x-oss-storage-class" => ["Standard"],
      "x-oss-version-id" => ["null"]
    }
  }
}
iex> Aliyun.Oss.Object.get_object(config, "some-bucket", "some-object", headers: %{}, query_params: %{"response-cache-control" => "no-cache"})
{:ok, %Aliyun.Oss.Client.Response{
    data: <<208, 207, 17, 224, 161, 177, 26, 225, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
      0, 0, 0, 62, 0, 3, 0, 254, 255, 9, 0, 6, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 18,
      0, 0, 0, ...>>,
    headers: %{
      "accept-ranges" => ["bytes"],
      "cache-control" => ["no-cache],
      "connection" => ["keep-alive"],
      "content-md5" => ["wpqajJtzJSpf8lOY/W4Hqg=="],
      "content-type" => ["text/plain"],
      "date" => ["Fri, 04 Jul 2025 05:45:44 GMT"],
      "etag" => [""C29000000000000000000000000000AA""],
      "last-modified" => ["Fri, 15 Jan 2021 09:16:13 GMT"],
      "server" => ["AliyunOSS"],
      "x-oss-hash-crc64ecma" => ["587015626014620604"],
      "x-oss-object-type" => ["Normal"],
      "x-oss-request-id" => ["6860000000000000000000A3"],
      "x-oss-server-time" => ["41"],
      "x-oss-storage-class" => ["Standard"],
      "x-oss-version-id" => ["null"]
    }
  }
}
iex> Aliyun.Oss.Object.get_object(config, "some-bucket", "some-object", headers: %{"range" => "bytes=0-2"}, query_params: %{"response-cache-control" => "no-cache"})
{:ok, %Aliyun.Oss.Client.Response{
    data: "abc",
    headers: %{
      "accept-ranges" => ["bytes"],
      "cache-control" => ["no-cache],
      "connection" => ["keep-alive"],
      "content-md5" => ["wpqajJtzJSpf8lOY/W4Hqg=="],
      "content-type" => ["text/plain"],
      "date" => ["Fri, 04 Jul 2025 05:45:44 GMT"],
      "etag" => [""C29000000000000000000000000000AA""],
      "last-modified" => ["Fri, 15 Jan 2021 09:16:13 GMT"],
      "server" => ["AliyunOSS"],
      "x-oss-hash-crc64ecma" => ["587015626014620604"],
      "x-oss-object-type" => ["Normal"],
      "x-oss-request-id" => ["6860000000000000000000A3"],
      "x-oss-server-time" => ["41"],
      "x-oss-storage-class" => ["Standard"],
      "x-oss-version-id" => ["null"]
    }
  }
}

get_object_meta(config, bucket, object)

@spec get_object_meta(Aliyun.Oss.Config.t(), String.t(), String.t()) ::
  {:error, error()} | {:ok, Aliyun.Oss.Client.Response.t()}

GetObjectMeta - gets the metadata of an object, including ETag, Size, and LastModified.

The content of the object is not returned.

Examples

iex> Aliyun.Oss.Object.get_object_meta(config, "some-bucket", "some-object")
{:ok,
%Aliyun.Oss.Client.Response{
  data: "",
  headers: %{
    "connection" => ["keep-alive"],
    "content-length" => ["19"],
    "date" => ["Fri, 04 Jul 2025 03:16:45 GMT"],
    "etag" => [""D4100000000000000000000000000000""],
    "last-modified" => ["Fri, 15 Jan 2021 09:16:13 GMT"],
    "server" => ["AliyunOSS"],
    "x-oss-hash-crc64ecma" => ["587015626014620604"],
    "x-oss-request-id" => ["680000000000000000000F52"],
    "x-oss-server-time" => ["39"],
    "x-oss-version-id" => ["null"]
  }
}}

head_object(config, bucket, object, options \\ [])

@spec head_object(Aliyun.Oss.Config.t(), String.t(), String.t(), keyword()) ::
  {:error, error()} | {:ok, Aliyun.Oss.Client.Response.t()}

HeadObject - gets the metadata of an object.

The content of the object is not returned.

Options

  • :headers - Defaults to %{}

Examples

iex> Aliyun.Oss.Object.head_object(config, "some-bucket", "some-object")
{:ok,
%Aliyun.Oss.Client.Response{
  data: "",
  headers: %{
    "accept-ranges" => ["bytes"],
    "connection" => ["keep-alive"],
    "content-length" => ["19"],
    "content-md5" => ["wpqajJtzJSpf8lOY/W4Hqg=="],
    "content-type" => ["text/plain"],
    "date" => ["Fri, 04 Jul 2025 03:10:24 GMT"],
    "etag" => [""D4100000000000000000000000000000""],
    "last-modified" => ["Fri, 15 Jan 2021 09:16:13 GMT"],
    "server" => ["AliyunOSS"],
    "x-oss-hash-crc64ecma" => ["587015626014620604"],
    "x-oss-object-type" => ["Normal"],
    "x-oss-request-id" => ["680000000000000000000CE1"],
    "x-oss-server-time" => ["24"],
    "x-oss-storage-class" => ["Standard"],
    "x-oss-version-id" => ["null"]
  }
}}

iex> Aliyun.Oss.Object.head_object(config, "some-bucket", "unknown-object")
{:error, %Aliyun.Oss.Client.Error{status_code: 404, body: "", parsed_details: nil}}

object_url(config, bucket, object, expires)

@spec object_url(Aliyun.Oss.Config.t(), String.t(), String.t(), integer()) ::
  String.t()

Creates a signed URL for accessing an object.

Examples

iex> expires = 3600
iex> Aliyun.Oss.Object.object_url(config, "some-bucket", "some-object", expires)
"http://some-bucket.oss-cn-hangzhou.aliyuncs.com/oss-api.pdf?OSSAccessKeyId=nz2pc56s936**9l&Expires=1141889120&Signature=vjbyPxybdZaNmGa%2ByT272YEAiv4%3D"

post_object(config, bucket, object, body, options)

@spec post_object(
  Aliyun.Oss.Config.t(),
  String.t(),
  String.t(),
  String.t(),
  keyword()
) ::
  {:error, error()} | {:ok, Aliyun.Oss.Client.Response.t()}

put_object(config, bucket, object, body, options \\ [])

@spec put_object(Aliyun.Oss.Config.t(), String.t(), String.t(), String.t(), keyword()) ::
  {:error, error()} | {:ok, Aliyun.Oss.Client.Response.t()}

PutObject - uploads objects.

Options

  • :query_params - Defaults to %{}
  • :headers - Defaults to %{}

Examples

iex> Aliyun.Oss.Object.put_object(config, "some-bucket", "some-object", "CONTENT")
{:ok, %Aliyun.Oss.Client.Response{
    data: "",
    headers: %{
      "connection" => ["keep-alive"],
      "content-length" => ["0"],
      "content-md5" => ["plz3uTkI****************"],
      "date" => ["Fri, 11 Jul 2025 02:30:40 GMT"],
      "etag" => [""A65CF7B93908B3A*****************""],
      "server" => ["AliyunOSS"],
      "x-oss-hash-crc64ecma" => ["162113910***********"],
      "x-oss-request-id" => ["687077508A8E************"],
      "x-oss-server-time" => ["107"]
    }
  }
}

restore_object(config, bucket, object)

@spec restore_object(Aliyun.Oss.Config.t(), String.t(), String.t()) ::
  {:error, error()} | {:ok, Aliyun.Oss.Client.Response.t()}

RestoreObject - restores an Archive object or a Cold Archive object.

Examples

iex> Aliyun.Oss.Object.restore_object(config, "some-bucket", "some-object")
{:ok, %Aliyun.Oss.Client.Response{
    data: "",
    headers: %{
      "connection" => ["keep-alive"],
      "content-length" => ["0"],
      "date" => ["Fri, 11 Jul 2025 03:13:57 GMT"],
      "server" => ["AliyunOSS"],
      "x-oss-request-id" => ["68708175A***************"],
      "x-oss-server-time" => ["6"]
    }
  }
}

select_object(config, bucket, object, select_request, options \\ [])

@spec select_object(
  Aliyun.Oss.Config.t(),
  String.t(),
  String.t(),
  String.t() | map(),
  keyword()
) ::
  {:error, error()} | {:ok, Aliyun.Oss.Client.Response.t()}

SelectObject - executes SQL statements to perform operations on an object and obtains the execution results.

Options

  • :format - specifies the request syntax:
    • available values: :json, :csv
    • default value: :csv

Examples

iex> select_request = %{
  "SelectRequest" => %{
    "Expression" => "c2VsZWN0ICogZnJvbSBvc3NvYmplY3Q=",
    "InputSerialization" => %{"JSON" => %{"Type" => "DOCUMENT"}},
    "OutputSerialization" => %{"JSON" => %{"RecordDelimiter" => "LA=="}}
  }
}
iex> Aliyun.Oss.Object.select_object(config, "some-bucket", "file.json", select_request, format: :json)
{:ok, %Aliyun.Oss.Client.Response{
    data: %{"contacts" => [...]},
    headers: %{
      "accept-ranges" => ["bytes"],
      "connection" => ["keep-alive"],
      ...
    }
  }
}
iex> select_request = ~S[
  <SelectRequest>
      <Expression>c2VsZWN0ICogZnJvbSBvc3NvYmplY3Q=</Expression>
      <InputSerialization>
      <JSON>
          <Type>DOCUMENT</Type>
      </JSON>
      </InputSerialization>
      <OutputSerialization>
      <JSON>
          <RecordDelimiter>LA==</RecordDelimiter>
      </JSON>
      </OutputSerialization>
  </SelectRequest>
]
iex> Aliyun.Oss.Object.select_object(config, "some-bucket", "file.json", select_request, format: :json)
{:ok, %Aliyun.Oss.Client.Response{
    data: %{"contacts" => [...]},
    headers: %{
      "accept-ranges" => ["bytes"],
      "connection" => ["keep-alive"],
      ...
    }
  }
}
iex> select_request = %{
  "SelectRequest" => %{"Expression" => "c2VsZWN0ICogZnJvbSBvc3NvYmplY3Q="}
}
iex> Aliyun.Oss.Object.select_object(config, "some-bucket", "file.csv", select_request, format: :csv)
{:ok, %Aliyun.Oss.Client.Response{
    data: "...",
    headers: %{
      "accept-ranges" => ["bytes"],
      "connection" => ["keep-alive"],
      ...
    }
  }
}
iex> select_request = ~S[
  <SelectRequest>
    <Expression>c2VsZWN0ICogZnJvbSBvc3NvYmplY3Q=</Expression>
  </SelectRequest>
]
iex> Aliyun.Oss.Object.select_object(config, "some-bucket", "file.csv", select_request, format: :csv)
{:ok, %Aliyun.Oss.Client.Response{
    data: "...",
    headers: %{
      "accept-ranges" => ["bytes"],
      "connection" => ["keep-alive"],
      ...
    }
  }
}

select_object_meta(config, bucket, object, select_request, options \\ [])

@spec select_object_meta(
  Aliyun.Oss.Config.t(),
  String.t(),
  String.t(),
  String.t() | map(),
  keyword()
) ::
  {:error, error()} | {:ok, Aliyun.Oss.Client.Response.t()}

CreateSelectObjectMeta - 获取目标文件总的行数，总的列数（对于 CSV 文件），以及 Splits 个数。

如果该信息不存在，则会扫描整个文件，分析并记录下 CSV 文件的上述信息。重复调用则会保存上述信息而不必重新扫描整个文件。

TODO: fix the doc

Options

  • :format - specifies the request syntax:
    • available values: :json, :csv
    • default value: :csv

Examples

iex> select_request = %{
  "JsonMetaRequest" => %{
    "InputSerialization" => %{"JSON" => %{"Type" => "LINES"}},
    "OverwriteIfExisting" => "false"
  }
}
iex> Aliyun.Oss.Object.select_object_meta(config, "some-bucket", "some-object", select_request, format: :json)
{:ok, %Aliyun.Oss.Client.Response{
    data: <<208, 207, 17, 224, 161, 177, 26, 225, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
      0, 0, 0, 62, 0, 3, 0, 254, 255, 9, 0, 6, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 18,
      0, 0, 0, ...>>,
    headers: %{
      "accept-ranges" => ["bytes"],
      "connection" => ["keep-alive"],
      ...
    }
  }
}
iex> select_request = ~S[
  <?xml version="1.0"?>
  <JsonMetaRequest>
      <InputSerialization>
          <JSON>
              <Type>LINES</Type>
          </JSON>
      </InputSerialization>
      <OverwriteIfExisting>false</OverwriteIfExisting>
  </JsonMetaRequest>
]
iex> Aliyun.Oss.Object.select_object_meta(config, "some-bucket", "some-object", select_request, format: :json)
{:ok, %Aliyun.Oss.Client.Response{
    data: <<208, 207, 17, 224, 161, 177, 26, 225, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
      0, 0, 0, 62, 0, 3, 0, 254, 255, 9, 0, 6, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 18,
      0, 0, 0, ...>>,
    headers: %{
      "accept-ranges" => ["bytes"],
      "connection" => ["keep-alive"],
      ...
    }
  }
}

sign_post_policy(config, policy)

@spec sign_post_policy(Aliyun.Oss.Config.t(), map()) :: %{
  policy: String.t(),
  signature: String.t()
}

Signs Post Policy, and returns the encoded Post Policy and its signature.

Examples

iex> policy = %{
...>  "conditions" => [
...>    ["content-length-range", 0, 10485760],
...>    %{"bucket" => "ahaha"},
...>    %{"A" => "a"},
...>    %{"key" => "ABC"}
...>  ],
...>  "expiration" => "2013-12-01T12:00:00Z"
...>}
iex> Aliyun.Oss.Object.sign_post_policy(config, policy)
%{
  policy: "eyJjb25kaXRpb25zIjpbWyJjb250ZW50LWxlbmd0aC1yYW5nZSIsMCwxMDQ4NTc2MF0seyJidWNrZXQiOiJhaGFoYSJ9LHsiQSI6ImEifSx7ImtleSI6IkFCQyJ9XSwiZXhwaXJhdGlvbiI6IjIwMTMtMTItMDFUMTI6MDA6MDBaIn0=",
  signature: "d9ea2e7088a5a7189d2d1a84aa872a00b7078877ffbd4a24b8897c23f16bc1db"
}

signed_url(config, bucket, object, options \\ [])

@spec signed_url(Aliyun.Oss.Config.t(), String.t(), String.t(), keyword()) ::
  String.t()

Creates a signed URL for an object.

Options

  • :query_params - Defaults to %{}
  • :headers - Defaults to %{}
  • :method - HTTP method to use for the signed URL, defaults to :get, accept values: :get, :put, :post, :delete, :head
  • :expires - number of seconds until the signed URL expires, defaults to 3600 seconds (1 hour)

Examples

iex> expires = 3600
iex> Aliyun.Oss.Object.signed_url(config, "some-bucket", "some-object", expires: expires, method: :get)
"https://some-bucket.oss-cn-hangzhou.aliyuncs.com/oss-api.pdf?x-oss-credential=LT**************%2F20250701%2Fcn-hangzhou%2Foss%2Faliyun_v4_request&x-oss-date=20250701T070913Z&x-oss-expires=3600&x-oss-signature=2f64d***********************************************************&x-oss-signature-version=OSS4-HMAC-SHA256"
iex> Aliyun.Oss.Object.signed_url(config, "some-bucket", "some-object", expires: expires, method: :put, headers: %{"Content-Type" => "text/plain"})
"https://some-bucket.oss-cn-hangzhou.aliyuncs.com/oss-api.pdf?x-oss-credential=LT**************%2F20250701%2Fcn-hangzhou%2Foss%2Faliyun_v4_request&x-oss-date=20250701T070944Z&x-oss-expires=3600&x-oss-signature=2a6e************************************************************&x-oss-signature-version=OSS4-HMAC-SHA256"