Object Storage Service:Initialization (Browser.js SDK)

accessKeyId {String}: İsteklerinizi kimlik doğrulamak için kullanılan AccessKey ID.

accessKeySecret {String}: İsteklerinizi kimlik doğrulamak için kullanılan AccessKey Secret.

[stsToken] {String}: Geçici yetkilendirme için kullanılan Security Token Service belirteci.

[refreshSTSToken] {Function}: STS belirtecinin süresi dolduğunda stsToken, accessKeyId ve accessKeySecret değerlerini otomatik olarak ayarlayan bir işlev. Bu işlev, stsToken, accessKeyId ve accessKeySecret içeren bir nesne döndürmelidir.

[refreshSTSTokenInterval] {number}: Milisaniye cinsinden Security Token Service belirteci yenileme aralığı. Bu değer, STS belirtecinin sona erme süresinden daha az olmalıdır. Varsayılan değer 300.000 milisaniyedir (5 dakika).

[bucket] {String}: Erişmek istediğiniz varsayılan paket. Paket yoksa putBucket() işlemine çağrı yaparak paketi oluşturabilirsiniz.

[endpoint] {String}: OSS bölgesine özel alan adı. Bu parametrenin önceliği region parametresinden daha yüksektir. Bu parametreyi gerektiği şekilde bir genel uç nokta, aynı bölgedeki dahili uç nokta veya hızlandırılmış bir alan adına ayarlayabilirsiniz. Daha fazla bilgi için uç noktalar listesine bakın.

[region] {String}: Paketin bulunduğu bölge. Varsayılan değer oss-cn-hangzhou'dur. oss-cn-hangzhou veya oss-cn-beijing gibi belirli bir bölge değeri kullanın. Çin anakarasındaki Anywhere Buckets'a erişmek için bu parametreyi rg-china-mainland olarak da ayarlayabilirsiniz; ancak daha hassas bölgesel yönlendirme için belirli bir bölge değeri tercih edilir.

[internal] {Boolean}: OSS'e Alibaba Cloud dahili ağı üzerinden erişilip erişilmeyeceğini belirtir. Varsayılan değer false'tur. Sunucunuz da Alibaba Cloud üzerinde çalışıyorsa veri aktarım maliyetlerini azaltmak için bu parametreyi true olarak ayarlayın.

[secure] {Boolean}: OSS istemcisinin HTTPS (secure: true) veya HTTP (secure: false) protokolünü kullanıp kullanmadığını belirtir.

[timeout] {String|Number}: Tüm işlemler için saniye cinsinden zaman aşımı süresi. Varsayılan değer 60'tır.

[cname] {Boolean}: OSS'e erişmek için özel bir alan adının kullanılıp kullanılmayacağını belirtir. Varsayılan değer false'tur. Bu parametreyi true olarak ayarlarsanız endpoint alanında özel alan adını belirtmeniz gerekir.

[isRequestPay] {Boolean}: Paket için İstekte Öde özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Varsayılan değer false'tur. Bu parametreyi true olarak ayarlarsanız 'x-oss-request-payer': 'requester' üst bilgisi OSS sunucusuna gönderilir.

[useFetch] {Boolean}: Bu parametre yalnızca tarayıcı ortamında etkili olur. Varsayılan değer false'tur. Bu parametreyi true olarak ayarlarsanız nesneler fetch yöntemi kullanılarak yüklenir. Aksi takdirde XMLHttpRequest kullanılır.

[retryMax] {Number}: Ağ hatası veya zaman aşımı nedeniyle başarısız olan bir istek için maksimum yeniden deneme sayısı. putStream işlemleri için yeniden deneme desteklenmez.

[authorizationV4] {Boolean}: V4 imzasının kullanılıp kullanılmayacağını belirtir. Varsayılan değer false'tur.

Temel kullanım

const OSS = require('ali-oss');

const store = new OSS({
  region: 'yourRegion',
  authorizationV4: true,
  accessKeyId: 'your access key',
  accessKeySecret: 'your access secret',
  stsToken: 'yourSecurityToken',
  bucket: 'your bucket name',
});

Hızlandırılmış uç nokta kullanın

const OSS = require('ali-oss');

const store = new OSS({
  region: 'yourRegion',
  authorizationV4: true,
  accessKeyId: 'your access key',
  accessKeySecret: 'your access secret',
  stsToken: 'yourSecurityToken',
  bucket: 'your bucket name',
  endpoint: 'oss-accelerate.aliyuncs.com',
});

Özel bir erişim yöntemi kullanın

const OSS = require('ali-oss');

const store = new OSS({
  region: 'yourRegion',
  authorizationV4: true,
  stsToken: 'yourSecurityToken',
  accessKeyId: 'your access key',
  accessKeySecret: 'your access secret',
  cname: true,
  endpoint: 'your custome domain',
});

STS belirteci kullanarak erişin

const OSS = require('ali-oss');

const store = new OSS({
  region: 'yourRegion',
  authorizationV4: true,
  accessKeyId: 'your STS key',
  accessKeySecret: 'your STS secret',
  stsToken: 'your STS token',
  refreshSTSToken: async () => {
    const info = await fetch('you sts server');
    return {
      accessKeyId: info.accessKeyId,
      accessKeySecret: info.accessKeySecret,
      stsToken: info.stsToken,
    };
  },
  refreshSTSTokenInterval: 300000,
});

Akış kullanarak bir isteği yeniden deneyin

for (let i = 0; i <= store.options.retryMax; i++) {
  try {
    const result = await store.putStream('<example-object>', fs.createReadStream('<example-path>'));
    console.log(result);
    break; // break if success
  } catch (e) {
    console.log(e);
  }
}

V4 imzası ve isteğe bağlı additionalHeaders seçeneğini kullanın

const OSS = require('ali-oss');

const store = new OSS({
  accessKeyId: 'your access key',
  accessKeySecret: 'your access secret',
  bucket: 'your bucket name',
  region: 'oss-cn-hangzhou',
  authorizationV4: true ,
  stsToken: 'yourSecurityToken',
});

try {
  const bucketInfo = await store.getBucketInfo('your bucket name');
  console.log(bucketInfo);
} catch (e) {
  console.log(e);
}

try {
  const putObjectResult = await store.put('your bucket name', 'your object name', {
    headers: {
      // The headers of this request
      header1: 'value1',
      header2: 'value2',
    },
    // The keys of the request headers to include in the V4 signature calculation. Ensure that these additional headers are included in the request headers.
    additionalHeaders: ['additional header1', 'additional header2'],
  });
  console.log(putObjectResult);
} catch (e) {
  console.log(e);
}