Object Storage Service:Inisialisasi (Browser.js SDK)

accessKeyId {String}: ID AccessKey yang digunakan untuk mengotentikasi permintaan Anda.

accessKeySecret {String}: Rahasia AccessKey yang digunakan untuk mengotentikasi permintaan Anda.

[stsToken] {String}: Token Layanan Token Keamanan yang digunakan untuk otorisasi sementara.

[refreshSTSToken] {Function}: Fungsi yang secara otomatis memperbarui stsToken, accessKeyId, dan accessKeySecret ketika token STS kedaluwarsa. Fungsi ini harus mengembalikan objek yang berisi stsToken, accessKeyId, dan accessKeySecret.

[refreshSTSTokenInterval] {Number}: Interval penyegaran token Layanan Token Keamanan dalam milidetik. Nilai ini harus lebih kecil dari periode kedaluwarsa token STS. Nilai default adalah 300.000 milidetik (5 menit).

[bucket] {String}: Bucket default yang ingin Anda akses. Jika bucket belum ada, Anda dapat memanggil operasi putBucket() untuk membuatnya.

[endpoint] {String}: Nama domain spesifik wilayah OSS. Parameter ini memiliki prioritas lebih tinggi daripada parameter region. Anda dapat menyetel parameter ini ke Titik akhir publik, titik akhir internal dalam wilayah yang sama, atau nama domain yang dipercepat sesuai kebutuhan. Untuk informasi selengkapnya, lihat daftar titik akhir.

[region] {String}: Wilayah tempat bucket berada. Nilai default adalah oss-cn-hangzhou. Gunakan nilai wilayah tertentu, seperti oss-cn-hangzhou atau oss-cn-beijing. Anda juga dapat menyetel parameter ini ke rg-china-mainland untuk mengakses Bucket Tanpa Atribut Wilayah di Tiongkok daratan, tetapi nilai wilayah tertentu lebih disarankan untuk routing regional yang lebih tepat.

[internal] {Boolean}: Menentukan apakah akses ke OSS dilakukan melalui jaringan internal Alibaba Cloud. Nilai default adalah false. Jika server Anda juga berjalan di Alibaba Cloud, setel parameter ini ke true untuk mengurangi biaya transfer data.

[secure] {Boolean}: Menentukan apakah klien OSS menggunakan protokol HTTPS (secure: true) atau HTTP (secure: false).

[timeout] {String|Number}: Periode timeout untuk semua operasi, dalam detik. Nilai default adalah 60.

[cname] {Boolean}: Menentukan apakah akan menggunakan nama domain kustom untuk mengakses OSS. Nilai default adalah false. Jika Anda menyetel parameter ini ke true, Anda harus menentukan nama domain kustom di bidang endpoint.

[isRequestPay] {Boolean}: Menentukan apakah akan mengaktifkan fitur Requester Pays untuk bucket. Nilai default adalah false. Jika Anda menyetel parameter ini ke true, header 'x-oss-request-payer': 'requester' dikirim ke server OSS.

[useFetch] {Boolean}: Parameter ini hanya berlaku di lingkungan browser. Nilai default adalah false. Jika Anda menyetel parameter ini ke true, objek diunggah menggunakan metode fetch. Jika tidak, XMLHttpRequest yang digunakan.

[retryMax] {Number}: Jumlah maksimum percobaan ulang untuk permintaan yang gagal karena error jaringan atau timeout. Percobaan ulang tidak didukung untuk operasi putStream.

[authorizationV4] {Boolean}: Menentukan apakah akan menggunakan signature V4. Nilai default adalah false.

Penggunaan dasar

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',
});

Gunakan titik akhir yang dipercepat

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',
});

Gunakan metode akses kustom

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',
});

Akses menggunakan token STS

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,
});

Coba ulang permintaan menggunakan aliran

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; // keluar jika berhasil
  } catch (e) {
    console.log(e);
  }
}

Gunakan signature V4 dan opsi tambahan additionalHeaders

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: {
      // Header permintaan ini
      header1: 'value1',
      header2: 'value2',
    },
    // Kunci header permintaan yang disertakan dalam perhitungan tanda tangan V4. Pastikan header tambahan ini termasuk dalam header permintaan.
    additionalHeaders: ['additional header1', 'additional header2'],
  });
  console.log(putObjectResult);
} catch (e) {
  console.log(e);
}