オブジェクトのタグを設定した後、オブジェクトのタグを照会できます。 タグを照会するオブジェクトを格納するバケットのバージョン管理が有効になっている場合、object Storage Service (OSS) はデフォルトでオブジェクトの現在のバージョンのタグを返します。 オブジェクトの指定されたバージョンのタグを照会するには、オブジェクトのバージョンIDを指定する必要があります。
オブジェクトのタグの照会
タグを照会するオブジェクトを格納するバケットのバージョン管理が有効になっていない場合は、要件に基づいてオブジェクトのタグを照会できます。 タグを照会するオブジェクトを格納するバケットのバージョン管理が有効になっている場合、OSSはデフォルトでオブジェクトの現在のバージョンのタグを返します。
次のサンプルコードは、examplebucketバケットのexampledirディレクトリにあるexampleobject.txtオブジェクトのタグを照会する方法の例を示しています。
const OSS = require('ali-OSS ')
const client = new OSS({
// バケットが配置されているリージョンを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、リージョンをoss-cn-Hangzhouに設定します。
リージョン: 'yourRegion' 、
// 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、環境変数OSS_ACCESS_KEY_IDとOSS_ACCESS_KEY_SECRETが設定されていることを確認してください。
accessKeyId: process.env.OSS_ACCESS_KEY_ID、
accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET、
// バケットの名前を指定します。 例: examplebucket.
bucket: 'examplebucket' 、});
// オブジェクトのフルパスを指定します。 例: exampledir/exampleobject.txt。 バケット名をフルパスに含めないでください。
constobjectName='exampledir/exampleobject.txt'
// オブジェクトのタグを照会します。
async関数getObjectTagging(objectName) {
try {
const result = await client.getObjectTagging(objectName);
console.log (結果);
} catch (e) {
console.log(e);
}
}
getObjectTagging(objectName)
オブジェクトの指定されたバージョンのタグを照会する
タグを照会するオブジェクトを格納するバケットのバージョン管理が有効になっている場合、オブジェクトのバージョンIDを指定して、指定したバージョンのオブジェクトのタグを照会できます。
次のサンプルコードは、examplebucketバケットのexampledirディレクトリにあるexampleobject.txtオブジェクトの指定されたバージョンのタグを照会する方法の例を示しています。
バージョンIDの取得方法の詳細については、「オブジェクトのリスト」をご参照ください。
const OSS = require('ali-OSS ')
const client = new OSS({
// バケットが配置されているリージョンを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、リージョンをoss-cn-Hangzhouに設定します。
リージョン: 'yourRegion' 、
// 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、環境変数OSS_ACCESS_KEY_IDとOSS_ACCESS_KEY_SECRETが設定されていることを確認してください。
accessKeyId: process.env.OSS_ACCESS_KEY_ID、
accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET、
// バケットの名前を指定します。 例: examplebucket.
bucket: 'examplebucket' 、});
// オブジェクトのフルパスを指定します。 例: exampledir/exampleobject.txt。 バケット名をフルパスに含めないでください。
const objectName='exampledir/exampleobject.txt'
// オブジェクトのバージョンIDを指定します。
const versionId='CAEQIRiBgMDqvPqA3BciIDJhMjE4MWZkN2ViYTRmYzJhZjkxMzk2YWM2NjJk ****'
// オブジェクトのタグを照会します。
async関数getObjectTagging(objectName) {
try {
const options = {
versionId
};
const result = await client.getObjectTagging(objectName、オプション);
console.log (結果);
} catch (e) {
console.log(e);
}
}
getObjectTagging(objectName)
参考資料
オブジェクトのタグのクエリに使用される完全なサンプルコードについては、GitHubをご覧ください。
オブジェクトのタグを照会するために呼び出すAPI操作の詳細については、「GetObjectTagging」をご参照ください。