文件元信息（Object Meta）包括 HTTP header 和自定义元信息，详情请参见开发指南中的文件元信息。

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

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

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

使用put、putStream和multipartUpload时，都可以通过指定meta参数来指定文件的元信息：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
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接口来更新文件元信息：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
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();