TosClient 在向服务端发起请求时，默认会对请求 header 里包含签名。SDK 也支持构造带签名的 URL，您可直接用该 URL 发起 HTTP 请求，也可以将该 URL 共享给第三方实现访问授权。本文以使用预签名的 URL 上传对象和下载对象为例，如果您有其他需求，您可以参考本文设置。
生成用于上传的预签名 URL 示例。
#include "TosClientV2.h" using namespace VolcengineTos; int main(void) { // 初始化 TOS 账号信息 // Your Region 填写 Bucket 所在 Region std::string region = "Your Region"; std::string accessKey = std::getenv("TOS_ACCESS_KEY"); std::string secretKey = std::getenv("TOS_SECRET_KEY"); // 填写 Bucket 名称，例如 examplebucket std::string bucketName = "examplebucket"; // 填写 Object 完整路径，完整路径中请不要包含 Bucket 的名称，例如 exampledir/exampleobject.txt 对象 std::string objectName = "exampledir/exampleobject.txt"; // 初始化网络等资源 InitializeClient(); // 创建交互的 client TosClientV2 client(region, accessKey, secretKey); // 设置预签名 URL 有效时间，单位：秒， int64_t expires = 86400; // 生成预签名 URL PreSignedURLInput input(HttpMethodType::Put,bucketName,objectName,expires); // 设置自定义endpoint // input.setAlternativeEndpoint("Your Alternative Endpoint"); input.set auto output = client.preSignedURL(input); if(!output.isSuccess()){ // 异常处理 std::cout << "GeneratePreSignedUrl failed." << output.error().String() << std::endl; // 释放网络等资源 CloseClient(); return -1; } std::cout << "GeneratePreSignedUrl Success, Gen Url:"<< output.result().getSignUrl() << std::endl; // 释放网络等资源 CloseClient(); return 0; } // 生成的 url 示例 // http://examplebucket.{endpoint/host}/exampledir/exampleobject.txt?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential={xxx}/{date}/{region}/tos/request&X-Tos-Date=20220922T103306Z&X-Tos-Expires=86400&X-Tos-Signature={yyy}&X-Tos-SignedHeaders=host
生成用于下载的预签名 URL 示例。
#include "TosClientV2.h" using namespace VolcengineTos; int main(void) { // 初始化 TOS 账号信息 // Your Region 填写 Bucket 所在 Region std::string region = "Your Region"; std::string accessKey = std::getenv("TOS_ACCESS_KEY"); std::string secretKey = std::getenv("TOS_SECRET_KEY"); // 填写 Bucket 名称，例如 examplebucket std::string bucketName = "examplebucket"; // 填写 Object 完整路径，完整路径中请不要包含 Bucket 的名称，例如 exampledir/exampleobject.txt 对象 std::string objectName = "exampledir/exampleobject.txt"; // 初始化网络等资源 InitializeClient(); // 创建交互的 client TosClientV2 client(region, accessKey, secretKey); // 设置预签名 URL 有效时间，单位：秒， int64_t expires = 86400; // 生成预签名 URL PreSignedURLInput input(HttpMethodType::Get,bucketName,objectName,expires); auto output = client.preSignedURL(input); if(!output.isSuccess()){ // 异常处理 std::cout << "GeneratePreSignedUrl failed." << output.error().String() << std::endl; // 释放网络等资源 CloseClient(); return -1; } std::cout << "GeneratePreSignedUrl Success, Gen Url:"<< output.result().getSignUrl() << std::endl; // 释放网络等资源 CloseClient(); return 0; } // 生成的 url 示例 // http://examplebucket.{endpoint/host}/exampledir/exampleobject.txt?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential={xxx}/{date}/{region}/tos/request&X-Tos-Date=20220922T103306Z&X-Tos-Expires=86400&X-Tos-Signature={yyy}&X-Tos-SignedHeaders=host
关于 URL 包含签名的详细信息，请参见 URL 中包含签名。