您想在下载对象时,设置下载对象的限制条件(对象 ETag 或对象修改时间),您可使用 TOS Harmony SDK 提供的限定条件下载功能,当对象信息满足您指定条件时才下载对象。本文介绍如何通过限定条件下载对象。
tos:GetObject
权限,具体操作,请参见权限配置指南。tos:GetObjectVersion
权限,具体操作,请见权限配置指南。参数 | 描述 |
---|---|
If-Match | 只有当传入的 |
If-None-Match | 只有当传入的 |
If-Modified-Since | 只有在对象自指定时间以来被修改过时才返回该对象,否则返回 |
If-Unmodified-Since | 只有在对象自指定时间以来未被修改过时才返回该对象,否则返回 |
以下代码限定只下载自 2024-02-22 18:33:00 以来被修改过的对象。
import { TosClient, TosClientError, TosServerError } from '@volcengine/tos_harmonyos_sdk'; // 创建客户端 const client = new TosClient({ accessKeyId: "Provide your ak", accessKeySecret: "Provide your sk", securityToken: 'Provide your securityToken', region: "Provide your region", // 填写 Bucket 所在地域。以华北2(北京)为例,"Provide your region" 填写为 cn-beijing。 endpoint: "Provide your endpoint", // 填写域名地址 }); function handleError(error: Error) { if (error instanceof TosClientError) { console.log('Client Err Msg:', error.message); console.log('Client Err Stack:', error.stack); } else if (error instanceof TosServerError) { console.log('Request ID:', error.requestId); console.log('Response Status Code:', error.statusCode); console.log('Response Header:', error.headers); console.log('Response Err Code:', error.code); console.log('Response Err Msg:', error.message); } else { console.log('unexpected exception, message: ', error); } } async function main() { const bucketName = 'node-sdk-test-bucket'; // 目标桶 const objectName = 'example_dir/example.txt'; // 目标对象 // 指定日期作为下载条件 const date = new Date('2024-02-22 18:33:00'); try { // 获取对象 const res = await client.getObject({ Bucket: bucketName, Key: objectName, IfModifiedSince: date, }); // 满足限定条件时,读取对象 res.Content.close(); } catch (error) { if (error instanceof TosServerError) { // IfModifiedSince 不满足时,返回 304 if (error.StatusCode === 304) { console.log('Object not modify, Request ID:', error.RequestId); } else { handleError(error as Error); } } } try { // 获取对象 const res = await client.getObject({ Bucket: bucketName, Key: objectName, IfUnmodifiedSince: date, }); res.Content.close(); } catch (error) { if (error instanceof TosServerError) { // IfUnmodifiedSince 不满足时,返回 412 if (error.StatusCode === 412) { console.log('Object modify, Request ID:', error.RequestId); } else { handleError(error as Error); } } } } main();
关于下载对象的 API 文档,请参见 GetObject。