Tüm Ürünler
Search
Belge Merkezi

Object Storage Service:Bucket tagging (Node.js SDK)

Son Güncelleme:Oct 01, 2026

Paket etiketleri, paketlerinizi sınıflandırmanıza ve yönetmenize olanak tanır. Örneğin, ListBucket işlemini çağırırken yalnızca belirli etiketlere sahip paketleri listeleyebilirsiniz.

Kullanım notları

  • Bu konuda Çin (Hangzhou) bölgesinin genel uç noktası kullanılmaktadır. Aynı bölgedeki diğer Alibaba Cloud hizmetlerinden OSS'e erişmek için dahili bir uç nokta kullanın. Desteklenen bölgeler ve uç noktalar hakkında ayrıntılı bilgi için bkz. Bölgeler ve uç noktalar.

  • Bu konuda erişim kimlik bilgileri ortam değişkenlerinden alınır. Daha fazla bilgi için bkz. Erişim kimlik bilgilerini yapılandırma.

  • Bu konuda bir OSS uç noktası kullanarak bir OSSClient örneği oluşturma işlemi gösterilmektedir. Özel bir alan adı kullanma veya Security Token Service (STS) kimlik bilgileriyle kimlik doğrulama gibi alternatif yapılandırmalar için bkz. İstemci yapılandırması.

  • Her pakette en fazla 20 etiket (anahtar-değer çifti) bulunabilir.

  • Etiket anahtarları ve değerleri UTF-8 kodlu olmalıdır.

  • Bir etiket anahtarı en fazla 64 karakter uzunluğunda olabilir, büyük/küçük harfe duyarlıdır ve boş bırakılamaz. Anahtar http://, https:// veya Aliyun (büyük/küçük harf duyarsız) ile başlayamaz.

  • Bir etiket değeri en fazla 128 karakter uzunluğunda olabilir ve boş bir dize olabilir.

Paket etiketlerini ayarlama

Aşağıdaki kod, bir paket için etiketlerin nasıl ayarlanacağını gösteren bir örnek sunar.

const OSS = require('ali-oss')

const client = new OSS({
  // Set region 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',
  // Obtain 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,
  // Set bucket to the name of your bucket.
  bucket: 'yourBucketName',
});

// Set bucket tags.
async function putBucketTags(bucketName, tag) {
  try {
    const result = await client.putBucketTags(bucketName, tag);
    console.log(result);
  } catch (e) {
    console.log(e);
  }
}

const tag = { a: '1', b: '2' };
putBucketTags('yourBucketName', tag)

Paket etiketlerini alma

Aşağıdaki kod, bir paketin etiketlerinin nasıl alınacağını gösteren bir örnek sunar.

const OSS = require('ali-oss')

const client = new OSS({
  // Set region 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',
  // Obtain 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,
  // Set bucket to the name of your bucket.
  bucket: 'yourBucketName',
});

// Get bucket tags.
async function getBucketTags(bucketName) {
  try {
    const result = await client.getBucketTags(bucketName);
    console.log(result);
  } catch (e) {
    console.log(e);
  }
}

getBucketTags('yourBucketName')

Belirtilen etiketlere sahip paketleri listeleme

Aşağıdaki kod, belirli bir etikete sahip paketlerin nasıl listeleneceğini gösteren bir örnek sunar:

const OSS = require('ali-oss')

const client = new OSS({
  // Set region 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',
  // Obtain 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,
  // Set bucket to the name of your bucket.
  bucket: 'yourBucketName',

});

// List buckets with specified tags.
async function listBucketTags() {
  try {
    const params = {
      // Add the tag-key and tag-value fields to the params parameter of the listBuckets operation.
      'tag-key': 'yourTagKey',
      'tag-value': 'yourTagValue'
    }
    const result = await client.listBuckets(params);
    console.log(result);
  } catch (err) {
    console.log(err);
  }
}

listBucketTags();

Paket etiketlerini silme

Aşağıdaki kod, bir paketin etiketlerinin nasıl silineceğini gösteren bir örnek sunar.

const OSS = require('ali-oss')

const client = new OSS({
  // Set region 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',
  // Obtain 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,
  // Set bucket to the name of your bucket.
  bucket: 'yourBucketName',

});

// Delete bucket tags.
async function deleteBucketTags(bucketName) {
  try {
    const result = await client.deleteBucketTags(bucketName);
    console.log(result);
  } catch (e) {
    console.log(e);
  }
}

deleteBucketTags('yourBucketName')

İlgili konular

  • Paket etiketleme için eksiksiz örnek kodu görmek üzere GitHub adresine bakın.

  • Paket etiketlerini ayarlamak için kullanılan API işlemi hakkında daha fazla bilgi için bkz. PutBucketTags.

  • Paket etiketlerini almak için kullanılan API işlemi hakkında daha fazla bilgi için bkz. GetBucketTags.

  • Paket etiketlerini silmek için kullanılan API işlemi hakkında daha fazla bilgi için bkz. DeleteBucketTags.