Konsol

1. Masuk ke Konsol OSS.

2. Buka bucket sumber tempat Anda ingin menghasilkan inventory. Di panel navigasi kiri, pilih Data Management > Bucket Inventory.

3. Di halaman Bucket Inventory, klik Create Inventory.

4. Di panel Create Inventory, konfigurasikan parameter berikut.

   Parameter	Deskripsi
   Status	Pilih Start untuk mengaktifkan tugas inventory.
   Rule Name	Nama tugas inventory. Nama hanya boleh berisi huruf kecil, angka, dan tanda hubung (-). Nama tidak boleh diawali atau diakhiri dengan tanda hubung (-).
   Inventory Report Destination	Tujuan laporan inventory. Bucket tujuan harus berada di wilayah yang sama dan dimiliki oleh akun yang sama dengan bucket sumber. Untuk menyimpan laporan ke path exampledir1/ di bucket examplebucket, masukkan exampledir1/. Jika path yang ditentukan tidak ada di bucket, OSS akan membuatnya secara otomatis. Jika Anda mengosongkan kolom ini, laporan disimpan ke direktori root. Jika layanan OSS-HDFS diaktifkan untuk bucket, jangan mengatur direktori laporan inventory ke .dlsdata/. Hal ini mencegah gangguan pada layanan dan menghindari kontaminasi data.
   Inventory file scan scope	Cakupan objek yang dipindai. Scan entire bucket: memindai semua objek di bucket. Object Prefix: hanya memindai objek yang sesuai dengan awalan tertentu, seperti exampledir1/.
   Encryption Method	Metode enkripsi untuk laporan inventory. None: tanpa enkripsi. AES256: mengenkripsi laporan menggunakan AES256. KMS: mengenkripsi file inventory menggunakan kunci KMS. Anda dapat menggunakan kunci KMS yang dikelola OSS atau membuat kunci KMS di wilayah yang sama dengan bucket tujuan di konsol KMS. Menggunakan fitur kunci KMS akan dikenai biaya kecil untuk panggilan API kunci KMS. Untuk informasi harga lebih lanjut, lihat .
   Frequency	Frekuensi OSS menghasilkan laporan inventory. Anda dapat memilih Weekly, Daily, Monthly, atau One-time Export. Untuk bucket dengan lebih dari 10 miliar objek, pilih Weekly untuk mengurangi biaya dan beban pemindaian. Jadwal Monthly tidak didukung di semua wilayah. Untuk informasi lebih lanjut, lihat Kuota dan batasan.
   {mode, select, NOT_SPECIFY {Unspecified Date} SPECIFY {Specified Date} other{--}}	Saat Anda mengatur siklus ekspor ke Monthly, Anda dapat menentukan hari dalam sebulan untuk memulai tugas inventory. Nilainya harus berupa bilangan bulat dari 1 hingga 31. Jika Anda memilih {mode, select, NOT_SPECIFY {Unspecified Date} SPECIFY {Specified Date} other{--}}, OSS mengekspor inventory dengan interval tetap 30 hari secara default. Pemindaian pertama dimulai pada hari Anda mengonfigurasi aturan, dan inventory diekspor setiap 30 hari setelah itu. Jika Anda menentukan hari dari 1 hingga 28, tugas inventory dimulai pada hari tersebut setiap bulan. Jika Anda menentukan hari dari 29 hingga 31, tugas dimulai pada hari tersebut jika ada di bulan tersebut. Jika hari tersebut tidak ada, tugas dimulai pada hari terakhir bulan. Misalnya, jika Anda menentukan tanggal 31 setiap bulan, tugas inventory untuk April dimulai pada tanggal 30. Tanggal yang ditentukan adalah kapan tugas inventory dimulai, bukan kapan laporan dikirimkan. Pembuatan laporan adalah tugas asinkron, dan waktu penyelesaiannya bergantung pada jumlah objek di bucket. Pengiriman terjadi setelah tanggal yang ditentukan.
   Inventory format	Format file laporan inventory. Anda dapat memilih CSV atau Parquet. Format Parquet saat ini hanya didukung di wilayah UK (London).
   Optional Fields	Informasi objek yang akan disertakan dalam laporan. System Metadata: object size, storage class, Last Modified Date, ETag, TransitionTime, multipart upload status, Encryption Status, Object ACL, Object Type, CRC64, Last Accessed Time, dan Last Accessed Timestamp. Last Accessed Time dan Last Accessed Timestamp hanya dapat diekspor saat Access Tracking diaktifkan untuk bucket. Jika Access Tracking dinonaktifkan, nilai kedua bidang ini tidak lagi bermakna dan biasanya ditampilkan sebagai null. Custom Metadata: Number of Tags.
   Advanced Filtering	Jika Anda perlu memfilter file yang diekspor berdasarkan kondisi seperti ukuran file atau kelas penyimpanan, aktifkan sakelar Advanced Filtering. Opsi filter hanya didukung di wilayah China (Qingdao), China (Hohhot), dan Jerman (Frankfurt). Opsi filter yang didukung adalah sebagai berikut. Time Range: tanggal mulai dan akhir modifikasi terakhir untuk objek yang akan diekspor. Waktu akurat hingga detik. Object Size Range: ukuran minimum dan maksimum objek yang akan diekspor. Ukuran minimum dan maksimum harus lebih besar dari 0 B. Ukuran maksimum tidak boleh melebihi 48,8 TB. Storage Class: kelas penyimpanan objek yang akan diekspor. Anda dapat memilih untuk mengekspor objek dengan kelas penyimpanan Standard, Infrequent Access, Archive, Cold Archive, dan Deep Cold Archive.
   Object Versions	Jika versioning diaktifkan untuk bucket, pilih Current Version atau All Versions.

5. Pilih Saya mengetahui dan setuju untuk memberikan izin kepada layanan Alibaba Cloud OSS untuk mengakses sumber daya di bucket ini., lalu klik OK.

   Aturan inventory baru muncul di halaman Bucket Inventory dengan status Start. Menghasilkan file inventory mungkin memerlukan waktu jika bucket berisi banyak objek. Untuk mengetahui cara memeriksa apakah file sudah siap, lihat Bagaimana cara mengetahui apakah file inventory telah dihasilkan?.

SDK

Kode contoh berikut menunjukkan cara mengonfigurasi aturan inventory menggunakan SDK OSS untuk berbagai bahasa.

import com.aliyun.oss.*;
import com.aliyun.oss.common.auth.*;
import com.aliyun.oss.common.comm.SignVersion;
import com.aliyun.oss.model.*;
import java.util.ArrayList;
import java.util.List;

public class Demo {

    public static void main(String[] args) throws Exception {
        // Dalam contoh ini, endpoint wilayah China (Hangzhou) digunakan. Tentukan endpoint aktual Anda. 
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode contoh, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah dikonfigurasi. 
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // Tentukan nama bucket. Contoh: examplebucket. 
        String bucketName = "examplebucket";
        // Tentukan nama bucket tempat Anda ingin menyimpan daftar inventory yang dihasilkan. 
        String destBucketName ="yourDestinationBucketName";
        // Tentukan ID akun yang diberikan oleh pemilik bucket. 
        String accountId ="yourDestinationBucketAccountId";
        // Tentukan nama peran RAM yang diberikan izin untuk membaca semua objek di bucket tempat Anda ingin mengonfigurasi inventory dan izin untuk menulis data ke bucket tempat Anda ingin menyimpan daftar inventory yang dihasilkan. 
        String roleArn ="yourDestinationBucketRoleArn";
        // Tentukan wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), atur wilayah ke cn-hangzhou.
        String region = "cn-hangzhou";

        // Buat instans OSS Client. 
        // Panggil metode shutdown untuk melepaskan resource terkait saat OSS Client tidak lagi digunakan.
        ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
        clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);        
        OSS ossClient = OSSClientBuilder.create()
        .endpoint(endpoint)
        .credentialsProvider(credentialsProvider)
        .clientConfiguration(clientBuilderConfiguration)
        .region(region)               
        .build();

        try {
            // Buat inventory. 
            InventoryConfiguration inventoryConfiguration = new InventoryConfiguration();

            // Tentukan nama inventory. 
            String inventoryId = "testid";
            inventoryConfiguration.setInventoryId(inventoryId);

            // Tentukan atribut objek yang disertakan dalam daftar inventory. 
            List<String> fields = new ArrayList<String>();
            fields.add(InventoryOptionalFields.Size);
            fields.add(InventoryOptionalFields.LastModifiedDate);
            fields.add(InventoryOptionalFields.IsMultipartUploaded);
            fields.add(InventoryOptionalFields.StorageClass);
            fields.add(InventoryOptionalFields.ETag);
            fields.add(InventoryOptionalFields.EncryptionStatus);
            inventoryConfiguration.setOptionalFields(fields);

            // Tentukan apakah daftar inventory dihasilkan setiap hari atau setiap minggu. Kode berikut memberikan contoh cara menghasilkan daftar inventory setiap minggu. Weekly menunjukkan bahwa daftar inventory dihasilkan sekali seminggu dan Daily menunjukkan bahwa daftar inventory dihasilkan sekali sehari. 
            inventoryConfiguration.setSchedule(new InventorySchedule().withFrequency(InventoryFrequency.Weekly));

            // Tentukan bahwa daftar inventory hanya menyertakan versi terkini objek. Jika Anda mengatur parameter InventoryIncludedObjectVersions ke All, semua versi objek disertakan dalam daftar inventory. Konfigurasi ini hanya berlaku saat Anda mengaktifkan versioning untuk bucket. 
            inventoryConfiguration.setIncludedObjectVersions(InventoryIncludedObjectVersions.Current);

            // Tentukan apakah inventory diaktifkan. Nilai yang valid: true dan false. Atur nilai ke true untuk mengaktifkan inventory. Atur nilai ke false untuk menonaktifkan inventory. 
            inventoryConfiguration.setEnabled(true);

            // Tentukan aturan yang digunakan untuk memfilter objek yang disertakan dalam daftar inventory. Kode berikut memberikan contoh cara memfilter objek berdasarkan awalan. 
            InventoryFilter inventoryFilter = new InventoryFilter().withPrefix("obj-prefix");
            inventoryConfiguration.setInventoryFilter(inventoryFilter);

            // Tentukan bucket tujuan tempat Anda ingin menyimpan daftar inventory yang dihasilkan. 
            InventoryOSSBucketDestination ossInvDest = new InventoryOSSBucketDestination();
            // Tentukan awalan path tempat Anda ingin menyimpan daftar inventory yang dihasilkan. 
            ossInvDest.setPrefix("destination-prefix");
            // Tentukan format daftar inventory. 
            ossInvDest.setFormat(InventoryFormat.CSV);
            // Tentukan ID akun pemilik bucket tujuan. 
            ossInvDest.setAccountId(accountId);
            // Tentukan ARN peran bucket tujuan. 
            ossInvDest.setRoleArn(roleArn);
            // Tentukan nama bucket tujuan. 
            ossInvDest.setBucket(destBucketName);

            // Kode berikut memberikan contoh cara mengenkripsi daftar inventory menggunakan customer master key (CMK) yang dihosting di Key Management System (KMS). 
            // InventoryEncryption inventoryEncryption = new InventoryEncryption();
            // InventoryServerSideEncryptionKMS serverSideKmsEncryption = new InventoryServerSideEncryptionKMS().withKeyId("test-kms-id");
            // inventoryEncryption.setServerSideKmsEncryption(serverSideKmsEncryption);
            // ossInvDest.setEncryption(inventoryEncryption);

            // Kode berikut memberikan contoh cara mengenkripsi daftar inventory di server OSS. 
            // InventoryEncryption inventoryEncryption = new InventoryEncryption();
            // inventoryEncryption.setServerSideOssEncryption(new InventoryServerSideEncryptionOSS());
            // ossInvDest.setEncryption(inventoryEncryption);

            // Tentukan tujuan untuk daftar inventory yang dihasilkan. 
            InventoryDestination destination = new InventoryDestination();
            destination.setOssBucketDestination(ossInvDest);
            inventoryConfiguration.setDestination(destination);

            // Konfigurasikan inventory untuk bucket. 
            ossClient.setBucketInventoryConfiguration(bucketName, inventoryConfiguration);
        } catch (OSSException oe) {
            System.out.println("Terjadi OSSException, yang berarti permintaan Anda sampai ke OSS, "
                    + "tetapi ditolak dengan tanggapan kesalahan karena suatu alasan.");
            System.out.println("Pesan Kesalahan:" + oe.getErrorMessage());
            System.out.println("Kode Kesalahan:" + oe.getErrorCode());
            System.out.println("ID Permintaan:" + oe.getRequestId());
            System.out.println("ID Host:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Terjadi ClientException, yang berarti klien mengalami "
                    + "masalah internal serius saat mencoba berkomunikasi dengan OSS, "
                    + "seperti tidak dapat mengakses jaringan.");
            System.out.println("Pesan Kesalahan:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
    }
}

public class Demo {

public static void main(String[] args) throws Exception {
    // Dalam contoh ini, endpoint wilayah China (Hangzhou) digunakan. Tentukan endpoint aktual Anda. 
    String endpoint = </span>

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

const client = new OSS({
  // Wilayah tempat bucket berada. Ganti yourregion dengan wilayah aktual. Misalnya, jika bucket berada di wilayah China (Hangzhou), atur parameter ini ke oss-cn-hangzhou.
  region: 'yourregion',
  // Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode contoh ini, pastikan Anda telah mengonfigurasi variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET.
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  // Nama bucket.
  bucket: 'yourbucketname'
});

const inventory = {
  // ID konfigurasi inventory.
  id: 'default', 
  // Menentukan apakah inventory diaktifkan. Nilai yang valid: true dan false.
  isEnabled: true, 
  // (Opsional) Filter inventory. Tentukan awalan untuk objek yang akan diinventarisasi.
  prefix: 'ttt',
  OSSBucketDestination: {
    // Format laporan inventory.
    format: 'CSV',
    // ID akun pemilik bucket tujuan.
    accountId: '<Your AccountId>', 
    // Nama peran untuk bucket tujuan.
    rolename: 'AliyunOSSRole',
    // Nama bucket tujuan.
    bucket: '<Your BucketName>',
    // (Opsional) Awalan untuk path tempat laporan inventory disimpan.
    prefix: '<Your Prefix>',
    // Jika Anda ingin menggunakan enkripsi sisi server dengan kunci yang dikelola OSS untuk mengenkripsi laporan inventory, lihat kode berikut.
    //encryption: {'SSE-OSS': ''},
    // Jika Anda ingin menggunakan enkripsi sisi server dengan kunci KMS (SSE-KMS) untuk mengenkripsi laporan inventory, lihat kode berikut.
    //encryption: {
    //  'SSE-KMS': {
    //    keyId: 'test-kms-id',
    //  },
    //},
  },
  // Jadwal pembuatan inventory. Nilai yang valid: Daily dan Weekly.
  frequency: 'Daily', 
  // Versi objek yang disertakan dalam inventory. Dalam contoh ini, semua versi objek disertakan. Jika Anda mengatur parameter ini ke Current, hanya versi terkini objek yang disertakan.
  includedObjectVersions: 'All', 
  optionalFields: {
    // (Opsional) Atribut objek yang disertakan dalam laporan inventory.
    field: ["Size", "LastModifiedDate", "ETag", "StorageClass", "IsMultipartUploaded", "EncryptionStatus"]
  },
}

async function putInventory(){
  // Nama bucket tempat menambahkan konfigurasi inventory.
  const bucket = '<Your BucketName>'; 
        try {
    await client.putBucketInventory(bucket, inventory);
    console.log('Konfigurasi inventory telah ditambahkan.')
  } catch(err) {
    console.log('Gagal menambahkan konfigurasi inventory: ', err);
  }
}

putInventory()

import argparse
import alibabacloud_oss_v2 as oss

# Buat parser parameter baris perintah dan jelaskan tujuan skrip. Contoh ini menjelaskan cara membuat inventory untuk bucket.
parser = argparse.ArgumentParser(description="put bucket inventory sample")

# Tentukan parameter baris perintah, termasuk wilayah, nama bucket, endpoint, ID pengguna, Nama Sumber Daya Alibaba Cloud (ARN) peran RAM, dan nama inventory yang diperlukan.
parser.add_argument('--region', help='Wilayah tempat bucket berada.', required=True)
parser.add_argument('--bucket', help='Nama bucket.', required=True)
parser.add_argument('--endpoint', help='Nama domain yang dapat digunakan layanan lain untuk mengakses OSS')
parser.add_argument('--user_id', help='ID akun pengguna.', required=True)
parser.add_argument('--arn', help='Nama Sumber Daya Alibaba Cloud (ARN) peran yang memiliki izin untuk membaca semua objek dari bucket sumber dan menulis objek ke bucket tujuan. Format: `acs:ram::uid:role/rolename`.', required=True)
parser.add_argument('--inventory_id', help='Nama inventory.', required=True)

def main():
    # Uraikan parameter baris perintah untuk mendapatkan nilai yang ditentukan pengguna.
    args = parser.parse_args()

    # Dapatkan kredensial akses dari variabel lingkungan untuk autentikasi.
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # Gunakan konfigurasi default SDK untuk membuat objek konfigurasi dan tentukan penyedia kredensial.
    cfg = oss.config.load_default()
    cfg.credentials_provider = credentials_provider

    # Tentukan atribut wilayah objek konfigurasi berdasarkan parameter baris perintah yang ditentukan pengguna.
    cfg.region = args.region

    # Jika endpoint kustom disediakan, ubah parameter endpoint dalam objek konfigurasi.
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # Gunakan konfigurasi di atas untuk menginisialisasi instans OSSClient dan memungkinkan instans berinteraksi dengan OSS.
    client = oss.Client(cfg)

    # Kirim permintaan untuk membuat inventory untuk bucket.
    result = client.put_bucket_inventory(oss.PutBucketInventoryRequest(
            bucket=args.bucket, # Nama bucket.
            inventory_id=args.inventory_id, # ID inventory.
            inventory_configuration=oss.InventoryConfiguration(
                included_object_versions='All', # Tentukan bahwa daftar inventory menyertakan semua versi objek.
                optional_fields=oss.OptionalFields(
                    fields=[ # Bidang opsional, seperti ukuran dan waktu modifikasi terakhir objek.
                        oss.InventoryOptionalFieldType.SIZE,
                        oss.InventoryOptionalFieldType.LAST_MODIFIED_DATE,
                    ],
                ),
                id=args.inventory_id, # ID inventory.
                is_enabled=True, # Tentukan apakah fitur inventory diaktifkan untuk bucket. Dalam contoh ini, fitur inventory diaktifkan.
                destination=oss.InventoryDestination(
                    oss_bucket_destination=oss.InventoryOSSBucketDestination(
                        format=oss. InventoryFormatType.CSV, # Tentukan bahwa format output daftar inventory adalah CSV.
                        account_id=args.user_id, # ID akun pengguna.
                        role_arn=args.arn, # ARN peran RAM, yang memiliki izin untuk membaca objek di bucket sumber dan menulis objek ke bucket tujuan.
                        bucket=f'acs:oss:::{args.bucket}', # Nama bucket tujuan.
                        prefix='aaa', # Tentukan awalan yang terdapat dalam nama objek yang ingin Anda sertakan dalam daftar inventory.
                    ),
                ),
                schedule=oss.InventorySchedule(
                    frequency=oss. InventoryFrequencyType.DAILY, # Tentukan apakah daftar inventory dihasilkan setiap hari atau setiap minggu. Dalam contoh ini, daftar inventory dihasilkan setiap hari.
                ),
                filter=oss.InventoryFilter(
                    lower_size_bound=1024, # Tentukan ukuran minimum objek yang ingin Anda sertakan dalam daftar inventory. Satuan: byte.
                    upper_size_bound=1048576, # Tentukan ukuran maksimum objek yang ingin Anda sertakan dalam daftar inventory. Satuan: byte.
                    storage_class='ColdArchive', # # Tentukan kelas penyimpanan objek yang ingin Anda sertakan dalam daftar inventory.
                    prefix='aaa', # Tentukan awalan yang digunakan untuk memfilter inventory.
                    last_modify_begin_time_stamp=1637883649, # Tentukan awal rentang waktu saat objek terakhir dimodifikasi.
                    last_modify_end_time_stamp=1638347592, # Tentukan akhir rentang waktu saat objek terakhir dimodifikasi.
                ),
            ),
    ))

    # Tampilkan kode status HTTP operasi dan ID permintaan untuk memeriksa status permintaan.
    print(f'status code: {result.status_code},'
          f' request id: {result.request_id},'
    )

# Panggil fungsi utama untuk memulai logika pemrosesan saat skrip dijalankan langsung.
if __name__ == "__main__":
    main() # Tentukan titik masuk dalam fungsi skrip. Alur program kontrol dimulai di sini.

Buat parser parameter baris perintah dan jelaskan tujuan skrip. Contoh ini menjelaskan cara membuat inventory untuk bucket.

parser = argparse.ArgumentParser(description=

using Aliyun.OSS;
using Aliyun.OSS.Common;

// Tentukan endpoint wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), atur endpoint ke https://oss-cn-hangzhou.aliyuncs.com. 
var endpoint = "yourEndpoint";
// Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode contoh, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah dikonfigurasi. 
var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID");
var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET");
// Tentukan nama bucket. 
var bucketName = "examplebucket";
// Tentukan ID akun yang diberikan oleh pemilik bucket. 
var accountId ="yourDestinationBucketAccountId";
// Tentukan nama peran RAM yang diberikan izin untuk membaca semua objek di bucket tempat Anda ingin mengonfigurasi inventory dan izin untuk menulis data ke bucket tempat Anda ingin menyimpan daftar inventory yang dihasilkan. 
var roleArn ="yourDestinationBucketRoleArn";
// Tentukan nama bucket tempat Anda ingin menyimpan daftar inventory yang dihasilkan. 
var destBucketName ="yourDestinationBucketName";
// Tentukan wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), atur wilayah ke cn-hangzhou.
const string region = "cn-hangzhou";

// Buat instans ClientConfiguration dan ubah parameter default berdasarkan kebutuhan Anda.
var conf = new ClientConfiguration();

// Gunakan algoritma signature V4.
conf.SignatureVersion = SignatureVersion.V4;

// Buat instans OssClient.
var client = new OssClient(endpoint, accessKeyId, accessKeySecret, conf);
client.SetRegion(region);
try
{
    // Buat inventory untuk bucket. 
    var config = new InventoryConfiguration();
    // Tentukan nama inventory. 
    config.Id = "report1";
    // Tentukan apakah inventory diaktifkan untuk bucket. Nilai yang valid: true dan false. Jika parameter ini diatur ke true, inventory diaktifkan. 
    config.IsEnabled = true;
    // Tentukan aturan yang digunakan untuk memfilter objek yang disertakan dalam daftar inventory. Kode berikut memberikan contoh cara memfilter objek berdasarkan awalan. 
    config.Filter = new InventoryFilter("filterPrefix");
    // Konfigurasikan bucket tempat Anda ingin menyimpan daftar inventory yang dihasilkan. 
    config.Destination = new InventoryDestination();
    config.Destination.OSSBucketDestination = new InventoryOSSBucketDestination();
    // Tentukan format daftar inventory. 
    config.Destination.OSSBucketDestination.Format = InventoryFormat.CSV;
    // Tentukan ID akun pemilik bucket tujuan. 
    config.Destination.OSSBucketDestination.AccountId = accountId;
    // Tentukan Nama Sumber Daya Alibaba Cloud (ARN) peran RAM yang digunakan untuk mengakses bucket tujuan. 
    config.Destination.OSSBucketDestination.RoleArn = roleArn;
    // Tentukan nama bucket tempat Anda ingin menyimpan daftar inventory yang dihasilkan. 
    config.Destination.OSSBucketDestination.Bucket = destBucketName;
    // Tentukan awalan path tempat Anda ingin menyimpan daftar inventory yang dihasilkan. 
    config.Destination.OSSBucketDestination.Prefix = "prefix1";
    
    // Tentukan apakah daftar inventory dihasilkan setiap hari atau setiap minggu. Kode berikut memberikan contoh cara menghasilkan daftar inventory setiap minggu. Nilai Weekly menunjukkan bahwa daftar inventory dihasilkan setiap minggu. Nilai Daily menunjukkan bahwa daftar inventory dihasilkan setiap hari. 
    config.Schedule = new InventorySchedule(InventoryFrequency.Daily);
    // Tentukan bahwa daftar inventory hanya menyertakan versi terkini objek. Jika Anda mengatur parameter InventoryIncludedObjectVersions ke All, semua versi objek disertakan dalam daftar inventory. Konfigurasi ini hanya berlaku saat versioning diaktifkan untuk bucket. 
    config.IncludedObjectVersions = InventoryIncludedObjectVersions.All;
    
    // Tentukan atribut objek yang disertakan dalam daftar inventory. 
    config.OptionalFields.Add(InventoryOptionalField.Size);
    config.OptionalFields.Add(InventoryOptionalField.LastModifiedDate);
    config.OptionalFields.Add(InventoryOptionalField.StorageClass);
    config.OptionalFields.Add(InventoryOptionalField.IsMultipartUploaded);
    config.OptionalFields.Add(InventoryOptionalField.EncryptionStatus);
    config.OptionalFields.Add(InventoryOptionalField.ETag);
    var req = new SetBucketInventoryConfigurationRequest(bucketName, config);
    client.SetBucketInventoryConfiguration(req);
    Console.WriteLine("Set bucket:{0} InventoryConfiguration berhasil", bucketName);
}
catch (OssException ex)
{
    Console.WriteLine("Gagal dengan kode kesalahan: {0}; Info kesalahan: {1}. \nID Permintaan:{2}\tID Host:{3}",
        ex.ErrorCode, ex.Message, ex.RequestId, ex.HostId);
}

// Tentukan endpoint wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), atur endpoint ke https://oss-cn-hangzhou.aliyuncs.com. var endpoint =

#include <alibabacloud/oss/OssClient.h>
using namespace AlibabaCloud::OSS;

int main(void)
{
    /* Inisialisasi informasi akun yang digunakan untuk mengakses OSS. */
            
    /* Tentukan endpoint wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), atur endpoint ke https://oss-cn-hangzhou.aliyuncs.com. */
    std::string Endpoint = "yourEndpoint";
    /* Tentukan wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), atur wilayah ke cn-hangzhou. */
    std::string Region = "yourRegion";
    /* Tentukan nama bucket. Contoh: examplebucket. */
    std::string BucketName = "examplebucket";

    /* Inisialisasi resource, seperti resource jaringan. */
    InitializeSdk();

    ClientConfiguration conf;
    conf.signatureVersion = SignatureVersionType::V4;
    /* Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode contoh, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah dikonfigurasi. */
    auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
    OssClient client(Endpoint, credentialsProvider, conf);
    client.SetRegion(Region);

    InventoryConfiguration inventoryConf;
    /* Tentukan nama inventory. Nama harus unik secara global di bucket saat ini. */
    inventoryConf.setId("inventoryId");

    /* Tentukan apakah inventory diaktifkan untuk bucket. Nilai yang valid: true dan false. */
    inventoryConf.setIsEnabled(true);

    /* (Opsional) Tentukan awalan dalam nama objek. Setelah Anda menentukan awalan, informasi tentang objek yang namanya mengandung awalan tersebut disertakan dalam daftar inventory. */
    inventoryConf.setFilter(InventoryFilter("objectPrefix"));

    InventoryOSSBucketDestination dest;
    /* Tentukan format daftar inventory yang diekspor. */
    dest.setFormat(InventoryFormat::CSV);
    /* Tentukan ID akun Alibaba Cloud yang diberikan izin oleh pemilik bucket untuk melakukan operasi. */
    dest.setAccountId("10988548********");
    /* Tentukan nama peran RAM yang diberikan izin oleh pemilik bucket untuk melakukan operasi. */
    dest.setRoleArn("acs:ram::10988548********:role/inventory-test");
    /* Tentukan bucket tempat Anda ingin menyimpan daftar inventory yang dihasilkan. */
    dest.setBucket("yourDstBucketName");
    /* Tentukan awalan path tempat Anda ingin menyimpan daftar inventory yang dihasilkan. */
    dest.setPrefix("yourPrefix");
    /* (Opsional) Tentukan metode yang digunakan untuk mengenkripsi daftar inventory. Nilai yang valid: SSEOSS dan SSEKMS. */
    //dest.setEncryption(InventoryEncryption(InventorySSEOSS()));
    //dest.setEncryption(InventoryEncryption(InventorySSEKMS("yourKmskeyId")));
    inventoryConf.setDestination(dest);

    /* Tentukan interval waktu ekspor daftar inventory. Nilai yang valid: Daily dan Weekly. */
    inventoryConf.setSchedule(InventoryFrequency::Daily);

    /* Tentukan apakah menyertakan semua versi objek atau hanya versi terkini objek dalam daftar inventory. Nilai yang valid: All dan Current. */
    inventoryConf.setIncludedObjectVersions(InventoryIncludedObjectVersions::All);

    /* (Opsional) Tentukan bidang yang disertakan dalam daftar inventory berdasarkan kebutuhan Anda. */
    InventoryOptionalFields field { 
        InventoryOptionalField::Size, InventoryOptionalField::LastModifiedDate, 
        InventoryOptionalField::ETag, InventoryOptionalField::StorageClass, 
        InventoryOptionalField::IsMultipartUploaded, InventoryOptionalField::EncryptionStatus
    };
    inventoryConf.setOptionalFields(field);

    /* Konfigurasikan inventory. */
    auto outcome = client.SetBucketInventoryConfiguration(
        SetBucketInventoryConfigurationRequest(BucketName, inventoryConf));

    if (!outcome.isSuccess()) {
        /* Tangani pengecualian. */
        std::cout << "Set Bucket Inventory gagal" <<
        ",kode:" << outcome.error().Code() <<
        ",pesan:" << outcome.error().Message() <<
        ",requestId:" << outcome.error().RequestId() << std::endl;
        return -1;
    }

    /* Lepaskan resource, seperti resource jaringan. */
    ShutdownSdk();
    return 0;
}

int main(void) { / Inisialisasi informasi akun yang digunakan untuk mengakses OSS. /

/* Tentukan endpoint wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), atur endpoint ke https://oss-cn-hangzhou.aliyuncs.com. */
std::string Endpoint = </span>

package main

import (
	"context"
	"flag"
	"log"

	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
)

// Definisikan variabel global.
var (
	region     string // Wilayah tempat bucket berada.
	bucketName string // Nama bucket.
)

// Tentukan fungsi init yang digunakan untuk menginisialisasi parameter baris perintah.
func init() {
	flag.StringVar(&region, "region", "", "Wilayah tempat bucket berada.")
	flag.StringVar(&bucketName, "bucket", "", "Nama bucket.")
}

func main() {
	// Uraikan parameter baris perintah.
	flag.Parse()

	var (
		accountId   = "account id of the bucket" // Tentukan ID akun Alibaba Cloud yang diberikan izin oleh pemilik bucket untuk melakukan operasi. Contoh: 109885487000****.
		inventoryId = "inventory id"             // Nama inventory. Nama harus unik secara global di bucket.
	)

	// Periksa apakah nama bucket ditentukan.
	if len(bucketName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("parameter tidak valid, nama bucket diperlukan")
	}

	// Periksa apakah wilayah ditentukan.
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("parameter tidak valid, wilayah diperlukan")
	}

	// Muat konfigurasi default dan tentukan penyedia kredensial dan wilayah.
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region)

	// Buat klien OSS.
	client := oss.NewClient(cfg)

	// Buat permintaan untuk mengonfigurasi inventory untuk bucket.
	putRequest := &oss.PutBucketInventoryRequest{
		Bucket:      oss.Ptr(bucketName),  // Nama bucket.
		InventoryId: oss.Ptr(inventoryId), // Nama inventory yang ditentukan pengguna.
		InventoryConfiguration: &oss.InventoryConfiguration{
			Id:        oss.Ptr(inventoryId), // Nama inventory yang ditentukan pengguna.
			IsEnabled: oss.Ptr(true),        // Aktifkan inventory.
			Filter: &oss.InventoryFilter{
				Prefix:                   oss.Ptr("filterPrefix"),    // Tentukan aturan yang digunakan untuk memfilter objek yang disertakan dalam inventory.
				LastModifyBeginTimeStamp: oss.Ptr(int64(1637883649)), // Timestamp yang menentukan waktu mulai modifikasi terakhir.
				LastModifyEndTimeStamp:   oss.Ptr(int64(1638347592)), // Timestamp yang menentukan waktu akhir modifikasi terakhir.
				LowerSizeBound:           oss.Ptr(int64(1024)),       // Batas ukuran file bawah (satuan: byte).
				UpperSizeBound:           oss.Ptr(int64(1048576)),    // Batas ukuran file atas (satuan: byte).
				StorageClass:             oss.Ptr("Standard,IA"),     // Kelas penyimpanan.
			},
			Destination: &oss.InventoryDestination{
				OSSBucketDestination: &oss.InventoryOSSBucketDestination{
					Format:    oss.InventoryFormatCSV,                                   // Format daftar inventory yang diekspor.
					AccountId: oss.Ptr(accountId),                                       // Tentukan ID akun yang diberikan izin oleh pemilik bucket untuk melakukan operasi. Contoh: 109885487000****.
					RoleArn:   oss.Ptr("acs:ram::" + accountId + ":role/AliyunOSSRole"), // Tentukan nama peran RAM yang diberikan izin oleh pemilik bucket untuk melakukan operasi. Contoh: acs:ram::109885487000****:role/ram-test.
					Bucket:    oss.Ptr("acs:oss:::" + bucketName),                       // Tentukan nama bucket tempat Anda ingin menyimpan daftar inventory yang dihasilkan.
					Prefix:    oss.Ptr("export/"),                                       // Tentukan awalan path tempat Anda ingin menyimpan daftar inventory yang dihasilkan.
				},
			},
			Schedule: &oss.InventorySchedule{
				Frequency: oss.InventoryFrequencyDaily, // Frekuensi ekspor daftar inventory (harian).
			},
			IncludedObjectVersions: oss.Ptr("All"), // Tentukan apakah menyertakan semua versi objek atau hanya versi terkini objek dalam daftar inventory.
		},
	}

	// Jalankan permintaan.
	putResult, err := client.PutBucketInventory(context.TODO(), putRequest)
	if err != nil {
		log.Fatalf("gagal menyetel inventory bucket %v", err)
	}

	// Tampilkan hasilnya.
	log.Printf("hasil setel inventory bucket:%#v\n", putResult)
}

import (

Setelah kode contoh dijalankan, verifikasi bahwa aturan inventory muncul di halaman Bucket Inventory konsol, atau panggil operasi API GetBucketInventory untuk mengkueri aturan tersebut.

ossutil

Buat file bernama inventory-configuration.xml dengan konten berikut:

<?xml version="1.0" encoding="UTF-8"?>
<InventoryConfiguration>
  <Id>report1</Id>
    <IsEnabled>true</IsEnabled>
  <Destination>
    <OSSBucketDestination>
      <Format>CSV</Format>
      <AccountId>100000000000000</AccountId>
      <RoleArn>acs:ram::100000000000000:role/AliyunOSSRole</RoleArn>
      <Bucket>acs:oss:::destbucket</Bucket>
      <Prefix>prefix1/</Prefix>
      <Encryption>
        <SSE-KMS>
          <KeyId>keyId</KeyId>
        </SSE-KMS>
      </Encryption>
    </OSSBucketDestination>
  </Destination>
  <Schedule>
    <Frequency>Daily</Frequency>
  </Schedule>
    <IncludedObjectVersions>All</IncludedObjectVersions>
  <OptionalFields>
    <Field>Size</Field>
    <Field>LastModifiedDate</Field>
    <Field>ETag</Field>
    <Field>StorageClass</Field>
    <Field>IsMultipartUploaded</Field>
    <Field>EncryptionStatus</Field>
  </OptionalFields>
</InventoryConfiguration>

Jalankan perintah berikut:

ossutil api put-bucket-inventory --bucket examplebucket --inventory-id report1 --inventory-configuration file://inventory-configuration.xml

Setelah perintah dijalankan, verifikasi bahwa aturan inventory muncul di halaman Bucket Inventory konsol.

API

Panggil operasi PutBucketInventory untuk mengonfigurasi atau memodifikasi aturan inventory. Metode ini mengharuskan Anda membuat permintaan HTTP dan menghitung signature secara manual, sehingga cocok untuk skenario yang sangat kustom. Setelah permintaan berhasil, Anda dapat memanggil operasi GetBucketInventory untuk mengkueri aturan inventory.

Konsol

1. Masuk ke Konsol OSS.

2. Buka bucket sumber tempat Anda ingin menghasilkan inventory. Di panel navigasi kiri, pilih Data Management > Bucket Inventory.

3. Di halaman Bucket Inventory, klik Create Inventory.

4. Di panel Create Inventory, konfigurasikan parameter Basic Settings.

   Parameter	Deskripsi
   Status	Status tugas inventory inkremental. Pilih Start.
   Rule Name	Nama tugas inventory. Nama hanya boleh berisi huruf kecil, angka, dan tanda hubung (-) dan tidak boleh diawali atau diakhiri dengan tanda hubung (-).
   Inventory Report Destination	Path tempat laporan inventory disimpan. Bucket sumber dan bucket tujuan harus dimiliki oleh akun yang sama dan berada di wilayah yang sama. Untuk menyimpan laporan ke path exampledir1 di bucket examplebucket, masukkan exampledir1/. Jika path yang ditentukan tidak ada di bucket, OSS secara otomatis membuat path tersebut. Panjang awalan path tujuan tidak boleh melebihi 128 karakter. Jika Anda mengosongkan kolom ini, laporan disimpan ke direktori root. Untuk mencegah gangguan pada layanan OSS-HDFS atau risiko korupsi data, jangan mengatur direktori laporan inventory ke .dlsdata/ saat mengonfigurasi aturan laporan inventory untuk bucket yang telah mengaktifkan layanan OSS-HDFS.
   Scan Scope	{status, select, BUCKET{Scan Entire Bucket} BUCKET_PATH{Match by Prefix} other{--}}: memindai semua objek di bucket. Object Prefix: hanya memindai objek yang sesuai dengan awalan tertentu, seperti exampledir1/.

5. Di bagian Track and Generate Incremental Metadata Updates, aktifkan Get Incremental Metadata Updates, lalu pilih Metadata Fields yang ingin Anda ekspor.

   Parameter

   Deskripsi

   Metadata Fields

   Informasi objek yang ingin Anda ekspor. Event Metadata: {type, select, SEQUENCE_NUMBER{Serial Number} RECORD_TYPE{Event Type} RECORD_TIMESTAMP{Timestamp} REQUESTER{User ID} REQUEST_ID{Request ID} SOURCE_IP{Source IP} other{type}}, {type, select, SEQUENCE_NUMBER{Serial Number} RECORD_TYPE{Event Type} RECORD_TIMESTAMP{Timestamp} REQUESTER{User ID} REQUEST_ID{Request ID} SOURCE_IP{Source IP} other{type}}, {type, select, SEQUENCE_NUMBER{Serial Number} RECORD_TYPE{Event Type} RECORD_TIMESTAMP{Timestamp} REQUESTER{User ID} REQUEST_ID{Request ID} SOURCE_IP{Source IP} other{type}}, {type, select, SEQUENCE_NUMBER{Serial Number} RECORD_TYPE{Event Type} RECORD_TIMESTAMP{Timestamp} REQUESTER{User ID} REQUEST_ID{Request ID} SOURCE_IP{Source IP} other{type}}, Request ID, dan {type, select, SEQUENCE_NUMBER{Serial Number} RECORD_TYPE{Event Type} RECORD_TIMESTAMP{Timestamp} REQUESTER{User ID} REQUEST_ID{Request ID} SOURCE_IP{Source IP} other{type}}. System Metadata: {type, select, SIZE{Object Size} STORAGE_CLASS{Storage Class} LAST_MODIFIED_DATE{Last Modified Date} ETAG{ETag} IS_MULTIPART_UPLOADED{Multipart Upload Status} ENCRYPTION_STATUS{Encryption Status} OBJECT_ACL{Object ACL} OBJECT_TYPE{File Type} CRC64{CRC64} USER_META_COUNT{User-Defined Metadata Count} TAGGING_COUNT{Tag Count} KMS_KEY_ARN{SSE-KMS Master Key} IS_SSE_KMS_ENABLED{SSE-KMS Encryption Status} other{type}}, {type, select, SIZE{Object Size} STORAGE_CLASS{Storage Class} LAST_MODIFIED_DATE{Last Modified Date} ETAG{ETag} IS_MULTIPART_UPLOADED{Multipart Upload Status} ENCRYPTION_STATUS{Encryption Status} OBJECT_ACL{Object ACL} OBJECT_TYPE{File Type} CRC64{CRC64} USER_META_COUNT{User-Defined Metadata Count} TAGGING_COUNT{Tag Count} KMS_KEY_ARN{SSE-KMS Master Key} IS_SSE_KMS_ENABLED{SSE-KMS Encryption Status} other{type}}, {type, select, SIZE{Object Size} STORAGE_CLASS{Storage Class} LAST_MODIFIED_DATE{Last Modified Date} ETAG{ETag} IS_MULTIPART_UPLOADED{Multipart Upload Status} ENCRYPTION_STATUS{Encryption Status} OBJECT_ACL{Object ACL} OBJECT_TYPE{File Type} CRC64{CRC64} USER_META_COUNT{User-Defined Metadata Count} TAGGING_COUNT{Tag Count} KMS_KEY_ARN{SSE-KMS Master Key} IS_SSE_KMS_ENABLED{SSE-KMS Encryption Status} other{type}}, ETag, {type, select, SIZE{Object Size} STORAGE_CLASS{Storage Class} LAST_MODIFIED_DATE{Last Modified Date} ETAG{ETag} IS_MULTIPART_UPLOADED{Multipart Upload Status} ENCRYPTION_STATUS{Encryption Status} OBJECT_ACL{Object ACL} OBJECT_TYPE{File Type} CRC64{CRC64} USER_META_COUNT{User-Defined Metadata Count} TAGGING_COUNT{Tag Count} KMS_KEY_ARN{SSE-KMS Master Key} IS_SSE_KMS_ENABLED{SSE-KMS Encryption Status} other{type}}, object type, object ACL, CRC64, dan {type, select, SIZE{Object Size} STORAGE_CLASS{Storage Class} LAST_MODIFIED_DATE{Last Modified Date} ETAG{ETag} IS_MULTIPART_UPLOADED{Multipart Upload Status} ENCRYPTION_STATUS{Encryption Status} OBJECT_ACL{Object ACL} OBJECT_TYPE{File Type} CRC64{CRC64} USER_META_COUNT{User-Defined Metadata Count} TAGGING_COUNT{Tag Count} KMS_KEY_ARN{SSE-KMS Master Key} IS_SSE_KMS_ENABLED{SSE-KMS Encryption Status} other{type}}.

6. Pilih I acknowledge and agree to grant the Alibaba Cloud OSS service permission to access resources in this bucket., lalu klik OK.

   Aturan inventory baru muncul di halaman Bucket Inventory dengan status Start.

Ossutil

Buat file bernama incremental-inventory.xml. Perbedaan utama dari konfigurasi inventory lengkap adalah penambahan bagian <IncrementalInventory>.

<?xml version="1.0" encoding="UTF-8"?>
<InventoryConfiguration>
    <Id>report-1</Id>
    <IsEnabled>true</IsEnabled>
    <Filter>
      <Prefix>test</Prefix>
    </Filter>
    <Destination>
      <OSSBucketDestination>
        <Format>CSV</Format>
        <AccountId>12xxxxxx29</AccountId>
        <RoleArn>acs:ram::12xxxxxx29:role/AliyunOSSRole</RoleArn>
        <Bucket>acs:oss:::test-inc-bi-bj</Bucket>
        <Prefix>Report-1</Prefix>
      </OSSBucketDestination>
    </Destination>
    <Schedule>
      <Frequency>Weekly</Frequency>
    </Schedule>
    <IncludedObjectVersions>All</IncludedObjectVersions>
    <OptionalFields>
      <Field>Size</Field>
      <Field>LastModifiedDate</Field>
      <Field>ETag</Field>
      <Field>StorageClass</Field>
    </OptionalFields>
    <IncrementalInventory>
      <IsEnabled>true</IsEnabled>
      <Schedule>
        <Frequency>600</Frequency>
      </Schedule>
      <OptionalFields>
        <Field>SequenceNumber</Field>
        <Field>RecordType</Field>
        <Field>RecordTimestamp</Field>
        <Field>Requester</Field>
        <Field>RequestId</Field>
        <Field>SourceIp</Field>
        <Field>Size</Field>
        <Field>StorageClass</Field>
        <Field>LastModifiedDate</Field>
        <Field>ETag</Field>
        <Field>IsMultipartUploaded</Field>
        <Field>ObjectType</Field>
        <Field>ObjectAcl</Field>
        <Field>CRC64</Field>
        <Field>EncryptionStatus</Field>
      </OptionalFields>
    </IncrementalInventory>
  </InventoryConfiguration>

Di bagian <IncrementalInventory>, <Frequency> menentukan interval ekspor file inventory inkremental. Dalam contoh ini, nilai 600 sesuai dengan interval sekitar 10 menit saat inventory inkremental dihasilkan.

Jalankan perintah berikut:

ossutil api put-bucket-inventory --bucket examplebucket --inventory-id report-1 --inventory-configuration file://incremental-inventory.xml

Setelah perintah dijalankan, verifikasi bahwa aturan inventory muncul di halaman Bucket Inventory konsol.

API

Untuk mengonfigurasi atau memodifikasi aturan inventory, panggil operasi API PutBucketInventory. Metode ini ideal untuk skenario yang sangat kustom tetapi mengharuskan Anda membuat dan menandatangani permintaan HTTP secara manual. Setelah permintaan berhasil, Anda dapat memanggil operasi GetBucketInventory untuk mengkueri aturan inventory.