设置自定义头部

最近更新时间:2024-11-06 09:45:32

我的收藏

简介

本文档主要介绍 SDK 如何在请求时携带自定义头部。

功能说明

COS 在上传对象时可以携带以 x-cos-meta- 开头的自定义头部,包括用户自定义元数据头部后缀和用户自定义元数据信息,这些头部将作为对象元数据保存。
如果您开通了万象服务,可以携带 Pic-Operations 头部,实现后台自动图片处理,详细的 API 说明请参考 数据万象持久化

示例代码

// 存储桶region可以在COS控制台指定存储桶的概览页查看 https://console.cloud.tencent.com/cos5/bucket/ ,关于地域的详情见 https://cloud.tencent.com/document/product/436/6224
let region = "ap-beijing"; // 您的存储桶地域
// 存储桶名称,由 bucketname-appid 组成,appid 必须填入,可以在 COS 控制台查看存储桶名称。 https://console.cloud.tencent.com/cos5/bucket
let bucket = "examplebucket-1250000000";
//对象在存储桶中的位置标识符,即称对象键
let cosPath = "exampleobject.txt";

let commonHeaderKey = "commonexamplekey"; // 自定义公共 Header 的键
let commonHeaderValue = "commonexamplevalue"; // 自定义公共 Header 的值
let requestHeaderKey = "requestexamplekey"; // 自定义请求 Header 的键
let requestHeaderValue = "requestexamplevalue"; // 自定义请求 Header 的值
// COS服务配置 let cosXmlServiceConfig = new CosXmlServiceConfig(region); // 给所有的请求添加公共的自定义 Header cosXmlServiceConfig.headers = new Map(); cosXmlServiceConfig.headers.set(commonHeaderKey, commonHeaderValue);
// 给单个请求添加自定义 Header,优先级比公共 Header 更高
let request = new HeadObjectRequest(bucket, cosPath);
request.addHeader(requestHeaderKey, requestHeaderValue);
// 实例化COS服务cosXmlBaseService let cosXmlBaseService = new CosXmlBaseService(context, cosXmlServiceConfig, credential); try { let result = await cosXmlBaseService.headObject(request) } catch (e) { // 异常处理 }