文件元信息(Object Meta)包括 HTTP header 和自定义元信息,详情请参见开发指南中的文件元信息

向OSS上传文件时,您可以指定文件的一些属性信息,称为“元信息”。 这些元信息在上传时与文件一起存储,在下载时与文件一起返回。

文件元信息会附在HTTP请求头部,而HTTP协议规定请求头部不能包含复杂字符,所以元信息只能是简单的ASCII可见字符且不能包含换行。

说明 所有元信息的总大小不能超过 8KB。

使用putputStreammultipartUpload时,都可以通过指定meta参数来指定文件的元信息:

let OSS = require('ali-oss')

let client = new OSS({
  region: '<Your region>',
  accessKeyId: '<Your AccessKeyId>',
  accessKeySecret: '<Your AccessKeySecret>',
  bucket: '<Your bucket name>',
});

async function put () {
  try {
    let result = await client.put('object-name', 'local-file', {
    meta: {
      year: 2016,
      people: 'mary'
    }
  });
  console.log(result);
  } catch (e) {
    console.log(e);
  }
}

put();
        

您还可以通过putMeta接口来更新文件元信息:

let OSS = require('ali-oss')

let client = new OSS({
  region: '<Your region>',
  accessKeyId: '<Your AccessKeyId>',
  accessKeySecret: '<Your AccessKeySecret>',
  bucket: '<Your bucket name>',
});

async function putMeta () {
  try {
    let result = await client.putMeta('object-name', {
    meta: {
      year: 2015,
      people: 'mary'
    }
  });
  console.log(result);
  } catch (e) {
    console.log(e);
  }
}

putMeta();