Após configurar as etiquetas de um objeto, você pode consultá-las. Se o versionamento estiver ativado no bucket que armazena o objeto cujas etiquetas deseja consultar, o Object Storage Service (OSS) retorna, por padrão, as etiquetas da versão atual do objeto. Para consultar as etiquetas de uma versão específica, especifique o ID da versão do objeto.
Obter informações de etiquetas de objeto
Caso o versionamento não esteja ativado no bucket que armazena o objeto cujas etiquetas deseja consultar, você pode consultar as etiquetas do objeto de acordo com os seus requisitos. Se o versionamento estiver ativado no bucket, o OSS retorna, por padrão, as etiquetas da versão atual do objeto.
O código de exemplo a seguir mostra como consultar as etiquetas do objeto exampleobject.txt no diretório exampledir do bucket examplebucket:
const OSS = require('ali-oss')
const client = new OSS({
// Set yourRegion to the region where the bucket is located. For example, if the bucket is in the China (Hangzhou) region, set Region to oss-cn-hangzhou.
region: 'yourRegion',
// Get access credentials from environment variables. Before you run this code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
accessKeyId: process.env.OSS_ACCESS_KEY_ID,
accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
authorizationV4: true,
// Specify the bucket name. For example, examplebucket.
bucket: 'examplebucket',
});
// Specify the full path of the object. For example, exampledir/exampleobject.txt. The full path of the object cannot contain the bucket name.
constobjectName='exampledir/exampleobject.txt'
// Get the tag information of the object.
async function getObjectTagging(objectName) {
try {
const result = await client.getObjectTagging(objectName);
console.log(result);
} catch (e) {
console.log(e);
}
}
getObjectTagging(objectName)
Obter informações de etiquetas de uma versão específica de um objeto
Se o versionamento estiver ativado no bucket que armazena o objeto cujas etiquetas deseja consultar, você poderá consultar as etiquetas de uma versão específica do objeto especificando o ID da versão.
O código de exemplo a seguir mostra como consultar as etiquetas de uma versão específica do objeto exampleobject.txt no diretório exampledir do bucket examplebucket:
Para mais informações sobre como obter um ID de versão, consulte List objects (Node.js SDK).
const OSS = require('ali-oss')
const client = new OSS({
// Set yourRegion to the region where the bucket is located. For example, if the bucket is in the China (Hangzhou) region, set Region to oss-cn-hangzhou.
region: 'yourRegion',
// Get access credentials from environment variables. Before you run this code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
accessKeyId: process.env.OSS_ACCESS_KEY_ID,
accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
authorizationV4: true,
// Specify the bucket name. For example, examplebucket.
bucket: 'examplebucket',
});
// Specify the full path of the object. For example, exampledir/exampleobject.txt. The full path of the object cannot contain the bucket name.
const objectName='exampledir/exampleobject.txt'
// Specify the version ID of the object.
const versionId='CAEQIRiBgMDqvPqA3BciIDJhMjE4MWZkN2ViYTRmYzJhZjkxMzk2YWM2NjJk****'
// Get the tag information of the object.
async function getObjectTagging(objectName) {
try {
const options = {
versionId
};
const result = await client.getObjectTagging(objectName, options);
console.log(result);
} catch (e) {
console.log(e);
}
}
getObjectTagging(objectName)
Referências
Para obter o código de exemplo completo para obter etiquetas de objeto, consulte GitHub.
Para mais informações sobre a operação da API para obter etiquetas de objeto, consulte GetObjectTagging.