腾讯云对象存储生成预签名链接

简介

Node.js SDK 提供获取对象 URL、获取请求预签名 URL 接口，详细操作请查看本文说明和示例。关于使用预签名 URL 上传的说明请参见 预签名授权上传， 使用预签名 URL 下载的说明请参见 预签名授权下载。说明建议用户使用临时密钥生成预签名，通过临时授权的方式进一步提高预签名上传、下载等请求的安全性。申请临时密钥时，请遵循 最小权限指引原则，防止泄露目标存储桶或对象之外的资源。申请临时密钥的 action 需添加 "name/cos:GetObject" 权限。如果您一定要使用永久密钥来生成预签名，建议永久密钥的权限范围仅限于上传或下载操作，以规避风险。

计算签名

COS XML API 的请求里，私有资源操作都需要鉴权凭证 Authorization，用于判断当前请求是否合法。鉴权凭证使用方式有两种：1. 放在 header 参数里使用，字段名：authorization。2. 放在 url 参数里使用，字段名：sign。COS.getAuthorization 方法用于计算鉴权凭证（Authorization），用以验证请求合法性的签名信息。注意该方法推荐只在前端调试时使用，项目上线不推荐使用前端计算签名的方法，有暴露密钥的风险。

使用示例

获取文件下载的鉴权凭证：

// SECRETID 和 SECRETKEY 请登录 https://console.cloud.tencent.com/cam/capi 进行查看和管理var COS = require('cos-nodejs-sdk-v5');var Authorization = COS.getAuthorization({  SecretId: process.env.SecretId, // 推荐使用环境变量获取；用户的 SecretId，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参见 https://cloud.tencent.com/document/product/598/37140  SecretKey: process.env.SecretKey, // 推荐使用环境变量获取；用户的 SecretKey，建议使用子账号密钥，授权遵循最小权限指引，降低使用风险。子账号密钥获取可参见 https://cloud.tencent.com/document/product/598/37140  Method: 'get',  Key: 'a.jpg',  Expires: 60,  Query: {},  Headers: {},});

参数说明

返回值说明

返回值是计算得到的鉴权凭证字符串 authorization。

获取请求预签名 URL

下载请求示例

示例一：获取不带签名 Object Url

var url = cos.getObjectUrl({  Bucket: 'examplebucket-1250000000', /* 填入您自己的存储桶，必须字段 */  Region: 'COS_REGION', /* 存储桶所在地域，例如 ap-beijing，必须字段 */  Key: '1.jpg', /* 存储在桶里的对象键（例如1.jpg，a/b/test.txt），支持中文，必须字段 */  Sign: false,});

示例二：获取带签名 Object Url

var url = cos.getObjectUrl({  Bucket: 'examplebucket-1250000000', /* 填入您自己的存储桶，必须字段 */  Region: 'COS_REGION', /* 存储桶所在地域，例如 ap-beijing，必须字段 */  Key: '头像.jpg', /* 存储在桶里的对象键（例如1.jpg，a/b/test.txt），支持中文，必须字段 */});

示例三：如果签名过程是异步获取，需要通过 callback 获取带签名 Url

cos.getObjectUrl(  {    Bucket: 'examplebucket-1250000000', /* 填入您自己的存储桶，必须字段 */    Region: 'COS_REGION', /* 存储桶所在地域，例如 ap-beijing，必须字段 */    Key: '头像.jpg', /* 存储在桶里的对象键（例如1.jpg，a/b/test.txt），支持中文，必须字段 */    Sign: false,  },  function (err, data) {    console.log(err || data.Url);  });

示例四：指定链接有效时间

cos.getObjectUrl(  {    Bucket: 'examplebucket-1250000000', /* 填入您自己的存储桶，必须字段 */    Region: 'COS_REGION', /* 存储桶所在地域，例如 ap-beijing，必须字段 */    Key: '头像.jpg', /* 存储在桶里的对象键（例如1.jpg，a/b/test.txt），支持中文，必须字段 */    Sign: true,    Expires: 3600, // 单位秒  },  function (err, data) {    console.log(err || data.Url);  });

示例五：获取文件 Url 并下载文件

var request = require('request');var fs = require('fs');cos.getObjectUrl(  {    Bucket: 'examplebucket-1250000000', /* 填入您自己的存储桶，必须字段 */    Region: 'COS_REGION', /* 存储桶所在地域，例如 ap-beijing，必须字段 */    Key: '头像.jpg', /* 存储在桶里的对象键（例如1.jpg，a/b/test.txt），支持中文，必须字段 */    Sign: true,  },  function (err, data) {    if (err) return console.log(err);    console.log(data.Url);    var req = request(data.Url, function (err, response, body) {      console.log(err || body);    });    var writeStream = fs.createWriteStream(__dirname + '/1.jpg');    req.pipe(writeStream);  });

示例六：生成预签名 URL，并在签名中携带 Query 和 Header

cos.getObjectUrl(  {    Bucket: 'examplebucket-1250000000', /* 填入您自己的存储桶，必须字段 */    Region: 'COS_REGION', /* 存储桶所在地域，例如 ap-beijing，必须字段 */    Key: '头像.jpg', /* 存储在桶里的对象键（例如1.jpg，a/b/test.txt），支持中文，必须字段 */    Sign: true,    /* 传入的请求参数需与实际请求相同，能够防止用户篡改此 HTTP 请求的参数 */    Query: {      'imageMogr2/thumbnail/200x/': '',    },    /* 传入的请求头部需包含在实际请求中，能够防止用户篡改签入此处的 HTTP 请求头部 */    Headers: {      host: 'xxx', /* 指定 host 访问，非指定的 host 访问会报错403 */    },  },  function (err, data) {    console.log(err || data.Url);  });

上传请求示例

示例一：获取预签名 Put Object 上传 Url

var request = require('request');var fs = require('fs');cos.getObjectUrl(  {    Bucket: 'examplebucket-1250000000', /* 填入您自己的存储桶，必须字段 */    Region: 'COS_REGION', /* 存储桶所在地域，例如 ap-beijing，必须字段 */    Key: '头像.jpg', /* 存储在桶里的对象键（例如1.jpg，a/b/test.txt），支持中文，必须字段 */    Method: 'PUT',    Sign: true,  },  function (err, data) {    if (err) return console.log(err);    console.log(data.Url);    var readStream = fs.createReadStream(__dirname + '/1.jpg');    var req = request(      {        method: 'PUT',        url: data.Url,      },      function (err, response, body) {        console.log(err || body);      }    );    readStream.pipe(req);  });

参数说明

返回值说明

返回值是一个字符串，两种情况：1. 如果签名计算可以同步计算（如：实例化传入了 SecretId 和 SecretKey），则默认返回带签名的 url。2. 否则返回不带签名的 url。

回调函数说明

function(err, data) { ... }

对象存储官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠