Konsol

1. OSS konsoluna giriş yapın.

2. Envanter oluşturmak istediğiniz kaynak pakete gidin. Sol gezinme bölmesinde Veri Yönetimi > Paket Envanteri'ni seçin.

3. Bucket Inventory sayfasında Create Inventory öğesine tıklayın.

4. Create Inventory panelinde aşağıdaki parametreleri yapılandırın.

   Parametre	Açıklama
   Durum	Envanter görevini etkinleştirmek için Start öğesini seçin.
   Rule Name	Envanter görevinin adı. Ad yalnızca küçük harfler, rakamlar ve tire (-) içerebilir. Tire (-) ile başlayamaz veya bitemez.
   Envanter Raporu Hedefi	Envanter raporlarının hedefi. Hedef paket, kaynak paketle aynı bölgede ve aynı hesaba ait olmalıdır. Raporu examplebucket paketindeki exampledir1/ yoluna kaydetmek için exampledir1/ girin. Belirtilen yol pakette yoksa OSS bunu otomatik olarak oluşturur. Bu alanı boş bırakırsanız rapor kök dizine kaydedilir. Bir paket için OSS-HDFS hizmeti etkinleştirildiyse envanter raporu dizinini .dlsdata/ olarak ayarlamayın. Bu, hizmete müdahaleyi önler ve veri kirliliğini engeller.
   Envanter dosyası tarama kapsamı	Taranacak nesne kapsamı. Tüm paketi tara: paketteki tüm nesneleri tarar. Object Prefix: yalnızca belirtilen önekle eşleşen nesneleri tarar, örneğin exampledir1/.
   Encryption Method	Envanter raporu için şifreleme yöntemi. Yok: şifreleme yok. AES256: AES256 kullanarak raporu şifreler. KMS: bir KMS anahtarı kullanarak envanter dosyasını şifreler. OSS tarafından yönetilen bir KMS anahtarı kullanabilir veya KMS konsolunda hedef paketle aynı bölgede bir KMS anahtarı oluşturabilirsiniz. KMS anahtarı özelliğini kullanmak, KMS anahtarı API çağrıları için küçük bir ücrete neden olur. Fiyatlandırma hakkında daha fazla bilgi için bkz. .
   Frequency	OSS'in envanter raporlarını oluşturma sıklığı. Weekly, Daily, Monthly veya One-time Export seçeneklerinden birini seçebilirsiniz. 10 milyardan fazla nesne içeren paketler için maliyetleri ve tarama yükünü azaltmak amacıyla Weekly seçeneğini belirleyin. Monthly zamanlaması tüm bölgelerde desteklenmez. Daha fazla bilgi için bkz. Kotalar ve sınırlamalar.
   {mode, select, NOT_SPECIFY {Unspecified Date} SPECIFY {Specified Date} other{--}}	Dışa aktarma döngüsünü Monthly olarak ayarladığınızda envanter görevinin başlayacağı ayın gününü belirtebilirsiniz. Değer 1 ile 31 arasında bir tamsayı olmalıdır. {mode, select, NOT_SPECIFY {Unspecified Date} SPECIFY {Specified Date} other{--}} seçeneğini belirlerseniz OSS varsayılan olarak sabit 30 günlük bir aralıkla envanteri dışa aktarır. İlk tarama kuralı yapılandırdığınız gün başlar ve bundan sonra envanter her 30 günde bir dışa aktarılır. 1 ile 28 arasındaki bir günü belirtirseniz envanter görevi her ay o gün başlar. 29 ile 31 arasındaki bir günü belirtirseniz görev, geçerli ayda o gün varsa o gün başlar. Gün yoksa görev ayın son gününde başlar. Örneğin, her ayın 31'ini belirtirseniz Nisan ayı için envanter görevi 30'unda başlar. Belirtilen tarih envanter görevinin başladığı tarihtir, raporun teslim edildiği tarih değildir. Rapor oluşturma asenkron bir görevdir ve tamamlanma süresi paketteki nesne sayısına bağlıdır. Teslimat belirtilen tarihten sonra gerçekleşir.
   Envanter formatı	Envanter raporunun dosya formatı. CSV veya Parquet seçeneklerinden birini seçebilirsiniz. Parquet formatı şu anda yalnızca İngiltere (Londra) bölgesinde desteklenmektedir.
   Optional Fields	Rapora dahil edilecek nesne bilgileri. Sistem Meta Verileri: object size, storage class, Last Modified Date, ETag, TransitionTime, multipart upload status, Encryption Status, Object ACL, Object Type, CRC64, Last Accessed Time ve Last Accessed Timestamp. Last Accessed Time ve Last Accessed Timestamp yalnızca paket için Access Tracking etkinleştirildiğinde dışa aktarılabilir. Access Tracking devre dışı bırakılırsa bu iki alanın değerleri artık anlamlı değildir ve genellikle null olarak görüntülenir. Özel Meta Veriler: Number of Tags.
   Advanced Filtering	Dosya boyutu veya depolama sınıfı gibi koşullara göre dışa aktarılan dosyaları filtrelemeniz gerekiyorsa Advanced Filtering anahtarını açın. Filtreleme seçenekleri yalnızca Çin (Qingdao), Çin (Hohhot) ve Almanya (Frankfurt) bölgelerinde desteklenir. Desteklenen filtreleme seçenekleri aşağıdaki gibidir. Time Range: dışa aktarılacak nesnelerin son değiştirilme tarihi için başlangıç ve bitiş tarihi. Zaman saniye düzeyinde hassastır. Object Size Range: dışa aktarılacak nesnelerin minimum ve maksimum boyutu. Minimum ve maksimum boyutlar 0 B'den büyük olmalıdır. Maksimum boyut 48,8 TB'yi aşamaz. Storage Class: dışa aktarılacak nesnelerin depolama sınıfları. Standart, Seyrek Erişim, Arşiv, Soğuk Arşiv ve Derin Soğuk Arşiv depolama sınıflarındaki nesneleri dışa aktarmayı seçebilirsiniz.
   Object Versions	Paket için sürüm oluşturma etkinleştirildiyse Current Version veya All Versions seçeneklerinden birini seçin.

5. I acknowledge and agree to grant the Alibaba Cloud OSS service permission to access resources in this bucket. onay kutusunu işaretleyin ve ardından OK öğesine tıklayın. Yeni envanter kuralı, Start durumuyla Bucket Inventory sayfasında görünür. Pakette çok sayıda nesne varsa envanter dosyasının oluşturulması biraz zaman alabilir. Dosyanın hazır olup olmadığını nasıl kontrol edeceğinizi öğrenmek için bkz. Bir envanter dosyasının oluşturulup oluşturulmadığını nasıl belirlerim?.

SDK

Aşağıdaki örnek kod, farklı dillerdeki OSS SDK'larını kullanarak bir envanter kuralının nasıl yapılandırılacağını gösterir.

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 { // In this example, the endpoint of the China (Hangzhou) region is used. Specify your actual endpoint. String endpoint = "https://oss-cn-hangzhou.aliyuncs.com"; // Obtain access credentials from environment variables. Before you run the sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured. EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider(); // Specify the name of the bucket. Example: examplebucket. String bucketName = "examplebucket"; // Specify the name of the bucket in which you want to store the generated inventory lists. String destBucketName ="yourDestinationBucketName"; // Specify the account ID granted by the bucket owner. String accountId ="yourDestinationBucketAccountId"; // Specify the name of the RAM role that is granted the permissions to read all objects in the bucket for which you want to configure the inventory and the permissions to write data to the bucket in which you want to store the generated inventory lists. String roleArn ="yourDestinationBucketRoleArn"; // Specify the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the region to cn-hangzhou. String region = "cn-hangzhou"; // Create an OSS Client instance. // Call the shutdown method to release associated resources when the OSS Client is no longer in use. ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration(); clientBuilderConfiguration.setSignatureVersion(SignVersion.V4); OSS ossClient = OSSClientBuilder.create() .endpoint(endpoint) .credentialsProvider(credentialsProvider) .clientConfiguration(clientBuilderConfiguration) .region(region) .build(); try { // Create an inventory. InventoryConfiguration inventoryConfiguration = new InventoryConfiguration(); // Specify the inventory name. String inventoryId = "testid"; inventoryConfiguration.setInventoryId(inventoryId); // Specify the object attributes that are included in inventory lists. 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); // Specify whether to generate inventory lists on a daily or weekly basis. The following code provides an example on how to generate the inventory lists on a weekly basis. Weekly indicates that the inventory lists are generated once a week and Daily indicates that the inventory lists are generated once a day. inventoryConfiguration.setSchedule(new InventorySchedule().withFrequency(InventoryFrequency.Weekly)); // Specify that the inventory lists include only the current version of objects. If you set the InventoryIncludedObjectVersions parameter to All, all versions of objects are included in the inventory lists. This configuration takes effect only when you enable versioning for the bucket. inventoryConfiguration.setIncludedObjectVersions(InventoryIncludedObjectVersions.Current); // Specify whether the inventory is enabled. Valid values: true and false. Set the value to true to enable the inventory. Set the value to false to disable the inventory. inventoryConfiguration.setEnabled(true); // Specify the rule used to filter the objects to include in the inventory lists. The following code provides an example on how to filter the objects by prefix. InventoryFilter inventoryFilter = new InventoryFilter().withPrefix("obj-prefix"); inventoryConfiguration.setInventoryFilter(inventoryFilter); // Specify the destination bucket in which you want to store the generated inventory lists. InventoryOSSBucketDestination ossInvDest = new InventoryOSSBucketDestination(); // Specify the prefix of the path in which you want to store the generated inventory lists. ossInvDest.setPrefix("destination-prefix"); // Specify the format of the inventory lists. ossInvDest.setFormat(InventoryFormat.CSV); // Specify the ID of the account to which the destination bucket belongs. ossInvDest.setAccountId(accountId); // Specify the role ARN of the destination bucket. ossInvDest.setRoleArn(roleArn); // Specify the name of the destination bucket. ossInvDest.setBucket(destBucketName); // The following code provides an example on how to encrypt the inventory lists by using customer master keys (CMKs) hosted in Key Management System (KMS). // InventoryEncryption inventoryEncryption = new InventoryEncryption(); // InventoryServerSideEncryptionKMS serverSideKmsEncryption = new InventoryServerSideEncryptionKMS().withKeyId("test-kms-id"); // inventoryEncryption.setServerSideKmsEncryption(serverSideKmsEncryption); // ossInvDest.setEncryption(inventoryEncryption); // The following code provides an example on how to encrypt the inventory lists on the OSS server. // InventoryEncryption inventoryEncryption = new InventoryEncryption(); // inventoryEncryption.setServerSideOssEncryption(new InventoryServerSideEncryptionOSS()); // ossInvDest.setEncryption(inventoryEncryption); // Specify the destination for the generated inventory lists. InventoryDestination destination = new InventoryDestination(); destination.setOssBucketDestination(ossInvDest); inventoryConfiguration.setDestination(destination); // Configure the inventory for the bucket. ossClient.setBucketInventoryConfiguration(bucketName, inventoryConfiguration); } catch (OSSException oe) { System.out.println("Caught an OSSException, which means your request made it to OSS, " + "but was rejected with an error response for some reason."); System.out.println("Error Message:" + oe.getErrorMessage()); System.out.println("Error Code:" + oe.getErrorCode()); System.out.println("Request ID:" + oe.getRequestId()); System.out.println("Host ID:" + oe.getHostId()); } catch (ClientException ce) { System.out.println("Caught an ClientException, which means the client encountered " + "a serious internal problem while trying to communicate with OSS, " + "such as not being able to access the network."); System.out.println("Error Message:" + ce.getMessage()); } finally { if (ossClient != null) { ossClient.shutdown(); } } } }

public class Demo {

public static void main(String[] args) throws Exception {
    // In this example, the endpoint of the China (Hangzhou) region is used. Specify your actual endpoint. 
    String endpoint = </span>

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

const client = new OSS({
  // The region where the bucket is located. Replace yourregion with the actual region. For example, if the bucket is in the China (Hangzhou) region, set this parameter to oss-cn-hangzhou.
  region: 'yourregion',
  // Obtain access credentials from environment variables. Before you run this sample code, make sure that you have configured the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables.
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  // The bucket name.
  bucket: 'yourbucketname'
});

const inventory = {
  // The ID of the inventory configuration.
  id: 'default', 
  // Specifies whether to enable the inventory. Valid values: true and false.
  isEnabled: true, 
  // (Optional) The inventory filter. Specify a prefix for the objects to be inventoried.
  prefix: 'ttt',
  OSSBucketDestination: {
    // The format of the inventory report.
    format: 'CSV',
    // The account ID of the owner of the destination bucket.
    accountId: '<Your AccountId>', 
    // The name of the role for the destination bucket.
    rolename: 'AliyunOSSRole',
    // The name of the destination bucket.
    bucket: '<Your BucketName>',
    // (Optional) A prefix for the path where the inventory report is stored.
    prefix: '<Your Prefix>',
    // If you want to use server-side encryption with OSS-managed keys to encrypt the inventory report, see the following code.
    //encryption: {'SSE-OSS': ''},
    // If you want to use server-side encryption with KMS keys (SSE-KMS) to encrypt the inventory report, see the following code.
    //encryption: {
    //  'SSE-KMS': {
    //    keyId: 'test-kms-id',
    //  },
    //},
  },
  // The inventory generation schedule. Valid values: Daily and Weekly.
  frequency: 'Daily', 
  // The object versions to include in the inventory. In this example, all versions of objects are included. If you set this parameter to Current, only the current version of objects is included.
  includedObjectVersions: 'All', 
  optionalFields: {
    // (Optional) The object attributes to include in the inventory report.
    field: ["Size", "LastModifiedDate", "ETag", "StorageClass", "IsMultipartUploaded", "EncryptionStatus"]
  },
}

async function putInventory(){
  // The name of the bucket for which to add the inventory configuration.
  const bucket = '<Your BucketName>'; 
        try {
    await client.putBucketInventory(bucket, inventory);
    console.log('The inventory configuration was added.')
  } catch(err) {
    console.log('Failed to add the inventory configuration: ', err);
  }
}

putInventory()

import argparse import alibabacloud_oss_v2 as oss # Create a command line parameter parser and describe the purpose of the script. The example describes how to create an inventory for a bucket. parser = argparse.ArgumentParser(description="put bucket inventory sample") # Specify the command line parameters, including the required region, bucket name, endpoint, user ID, Alibaba Cloud Resource Name (ARN) of the RAM role, and inventory name. parser.add_argument('--region', help='The region in which the bucket is located.', required=True) parser.add_argument('--bucket', help='The name of the bucket.', required=True) parser.add_argument('--endpoint', help='The domain names that other services can use to access OSS') parser.add_argument('--user_id', help='User account ID.', required=True) parser.add_argument('--arn', help='The Alibaba Cloud Resource Name (ARN) of the role that has the permissions to read all objects from the source bucket and write objects to the destination bucket. Format: acs:ram::uid:role/rolename.', required=True) parser.add_argument('--inventory_id', help='The name of the inventory.', required=True) def main(): # Parse the command line parameters to obtain the values specified by the user. args = parser.parse_args() # Obtain access credentials from environment variables for authentication. credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider() # Use the default configurations of the SDK to create a configuration object and specify the credential provider. cfg = oss.config.load_default() cfg.credentials_provider = credentials_provider # Specify the region attribute of the configuration object based on the command line parameters specified by the user. cfg.region = args.region # If a custom endpoint is provided, modify the endpoint parameter in the configuration object. if args.endpoint is not None: cfg.endpoint = args.endpoint # Use the preceding configurations to initialize the OSSClient instance and allow the instance to interact with OSS. client = oss.Client(cfg) # Send a request to create an inventory for a bucket. result = client.put_bucket_inventory(oss.PutBucketInventoryRequest( bucket=args.bucket, # The name of the bucket. inventory_id=args.inventory_id, # The ID of the inventory. inventory_configuration=oss.InventoryConfiguration( included_object_versions='All', # Specify that inventory lists include all versions of objects. optional_fields=oss.OptionalFields( fields=[ # The optional fields, such as the size and last modified time of objects. oss.InventoryOptionalFieldType.SIZE, oss.InventoryOptionalFieldType.LAST_MODIFIED_DATE, ], ), id=args.inventory_id, # The ID of the inventory. is_enabled=True, # Specify whether to enable the inventory feature for the bucket. In this example, the inventory feature is enabled. destination=oss.InventoryDestination( oss_bucket_destination=oss.InventoryOSSBucketDestination( format=oss. InventoryFormatType.CSV, # Specify that the output format of the inventory lists is CSV. account_id=args.user_id, # The account ID of the user. role_arn=args.arn, # The ARN of the RAM role, which has the permissions to read the objects in the source bucket and write objects to the destination bucket. bucket=f'acs:oss:::{args.bucket}', # The name of the destination bucket. prefix='aaa', # Specify the prefix contained in the names of the objects that you want to include in inventory lists. ), ), schedule=oss.InventorySchedule( frequency=oss. InventoryFrequencyType.DAILY, # Specify whether to generate inventory lists on a daily or weekly basis. In this example, inventory lists are generated on a daily basis. ), filter=oss.InventoryFilter( lower_size_bound=1024, # Specify the minimum size of the object that you want to include in inventory lists. Unit: bytes. upper_size_bound=1048576, # Specify the maximum size of the object that you want to include in inventory lists. Unit: bytes. storage_class='ColdArchive', # # Specify the storage classes of objects that you want to include in inventory lists. prefix='aaa', # Specify the prefix that is used to filter inventories. last_modify_begin_time_stamp=1637883649, # Specify the beginning of the time range during which the object was last modified. last_modify_end_time_stamp=1638347592, # Specify the end of the time range during which the object was last modified. ), ), )) # Display the HTTP status code of the operation and request ID to check the request status. print(f'status code: {result.status_code},' f' request id: {result.request_id},' ) # Call the main function to start the processing logic when the script is directly run. if __name__ == "__main__": main() # Specify the entry points in the functions of the script. The control program flow starts here.

Komut satırı parametre ayrıştırıcısı oluşturma ve betiğin amacını açıklama. Örnek, bir paket için envanterin nasıl oluşturulacağını gösterir.

parser = argparse.ArgumentParser(description= using Aliyun.OSS; using Aliyun.OSS.Common; // Specify the endpoint of the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the endpoint to https://oss-cn-hangzhou.aliyuncs.com. var endpoint = "yourEndpoint"; // Obtain access credentials from environment variables. Before you run the sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured. var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID"); var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET"); // Specify the name of the bucket. var bucketName = "examplebucket"; // Specify the account ID granted by the bucket owner. var accountId ="yourDestinationBucketAccountId"; // Specify the name of the RAM role that is granted the permissions to read all objects in the bucket for which you want to configure the inventory and the permissions to write data to the bucket in which you want to store the generated inventory lists. var roleArn ="yourDestinationBucketRoleArn"; // Specify the name of the bucket in which you want to store the generated inventory lists. var destBucketName ="yourDestinationBucketName"; // Specify the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the region to cn-hangzhou. const string region = "cn-hangzhou"; // Create a ClientConfiguration instance and modify the default parameters based on your requirements. var conf = new ClientConfiguration(); // Use the signature algorithm V4. conf.SignatureVersion = SignatureVersion.V4; // Create an OSSClient instance. var client = new OssClient(endpoint, accessKeyId, accessKeySecret, conf); client.SetRegion(region); try { // Create an inventory for the bucket. var config = new InventoryConfiguration(); // Specify the name of the inventory. config.Id = "report1"; // Specify whether to enable the inventory for the bucket. Valid values: true and false. If this parameter is set to true, the inventory is enabled. config.IsEnabled = true; // Specify the rule that is used to filter the objects included in inventory lists. The following code provides an example on how to filter the objects by prefix. config.Filter = new InventoryFilter("filterPrefix"); // Configure the bucket in which you want to store the generated inventory lists. config.Destination = new InventoryDestination(); config.Destination.OSSBucketDestination = new InventoryOSSBucketDestination(); // Specify the format of the inventory lists. config.Destination.OSSBucketDestination.Format = InventoryFormat.CSV; // Specify the ID of the account to which the destination bucket belongs. config.Destination.OSSBucketDestination.AccountId = accountId; // Specify the Alibaba Cloud Resource Name (ARN) of the RAM role that is used to access the destination bucket. config.Destination.OSSBucketDestination.RoleArn = roleArn; // Specify the name of the bucket in which you want to store the generated inventory lists. config.Destination.OSSBucketDestination.Bucket = destBucketName; // Specify the prefix of the path in which you want to store the generated inventory lists. config.Destination.OSSBucketDestination.Prefix = "prefix1"; // Specify whether to generate the inventory lists on a daily or weekly basis. The following code provides an example on how to generate the inventory lists on a weekly basis. A value of Weekly indicates that the inventory lists are generated on a weekly basis. A value of Daily indicates that the inventory lists are generated on a daily basis. config.Schedule = new InventorySchedule(InventoryFrequency.Daily); // Specify that the inventory lists include only the current versions of objects. If you set the InventoryIncludedObjectVersions parameter to All, all versions of objects are included in the inventory lists. This configuration takes effect only when versioning is enabled for the bucket. config.IncludedObjectVersions = InventoryIncludedObjectVersions.All; // Specify the object attributes that are included in the inventory lists. 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 succeeded", bucketName); } catch (OssException ex) { Console.WriteLine("Failed with error code: {0}; Error info: {1}. \nRequestID:{2}\tHostID:{3}", ex.ErrorCode, ex.Message, ex.RequestId, ex.HostId); }

// Specify the endpoint of the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the endpoint to https://oss-cn-hangzhou.aliyuncs.com. var endpoint = #include <alibabacloud/oss/OssClient.h> using namespace AlibabaCloud::OSS; int main(void) { / Initialize information about the account that is used to access OSS. / / Specify the endpoint of the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the endpoint to https://oss-cn-hangzhou.aliyuncs.com. / std::string Endpoint = "yourEndpoint"; / Specify the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the region to cn-hangzhou. / std::string Region = "yourRegion"; / Specify the name of the bucket. Example: examplebucket. / std::string BucketName = "examplebucket"; / Initialize resources, such as network resources. / InitializeSdk(); ClientConfiguration conf; conf.signatureVersion = SignatureVersionType::V4; / Obtain access credentials from environment variables. Before you run the sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured. / auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>(); OssClient client(Endpoint, credentialsProvider, conf); client.SetRegion(Region); InventoryConfiguration inventoryConf; / Specify the name of the inventory. The name must be globally unique in the current bucket. / inventoryConf.setId("inventoryId"); / Specify whether to enable inventory for the bucket. Valid values: true and false. / inventoryConf.setIsEnabled(true); / (Optional) Specify the prefix in the names of the objects. After you specify the prefix, information about the objects whose names contain the prefix is included in the inventory lists. / inventoryConf.setFilter(InventoryFilter("objectPrefix")); InventoryOSSBucketDestination dest; / Specify the format of the exported inventory lists. / dest.setFormat(InventoryFormat::CSV); / Specify the ID of the Alibaba Cloud account to which the bucket owner grants the permissions to perform the operation. / dest.setAccountId("10988548"); / Specify the name of the RAM role to which the bucket owner grants permissions to perform the operation. / dest.setRoleArn("acs:ram::10988548:role/inventory-test"); / Specify the bucket in which you want to store the generated inventory lists. / dest.setBucket("yourDstBucketName"); / Specify the prefix of the path in which you want to store the generated inventory lists. / dest.setPrefix("yourPrefix"); / (Optional) Specify the method that is used to encrypt inventory lists. Valid values: SSEOSS and SSEKMS. / //dest.setEncryption(InventoryEncryption(InventorySSEOSS())); //dest.setEncryption(InventoryEncryption(InventorySSEKMS("yourKmskeyId"))); inventoryConf.setDestination(dest); / Specify the time interval at which inventory lists are exported. Valid values: Daily and Weekly. / inventoryConf.setSchedule(InventoryFrequency::Daily); / Specify whether to include all versions of objects or only the current versions of objects in the inventory lists. Valid values: All and Current. / inventoryConf.setIncludedObjectVersions(InventoryIncludedObjectVersions::All); / (Optional) Specify the fields that are included in inventory lists based on your requirements. / InventoryOptionalFields field { InventoryOptionalField::Size, InventoryOptionalField::LastModifiedDate, InventoryOptionalField::ETag, InventoryOptionalField::StorageClass, InventoryOptionalField::IsMultipartUploaded, InventoryOptionalField::EncryptionStatus }; inventoryConf.setOptionalFields(field); / Configure the inventory. / auto outcome = client.SetBucketInventoryConfiguration( SetBucketInventoryConfigurationRequest(BucketName, inventoryConf)); if (!outcome.isSuccess()) { / Handle exceptions. / std::cout << "Set Bucket Inventory fail" << ",code:" << outcome.error().Code() << ",message:" << outcome.error().Message() << ",requestId:" << outcome.error().RequestId() << std::endl; return -1; } / Release resources, such as network resources. / ShutdownSdk(); return 0; }

int main(void) { / Initialize information about the account that is used to access OSS. /

/* Specify the endpoint of the region in which the bucket is located. For example, if the bucket is located in the China (Hangzhou) region, set the endpoint to 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" ) // Define global variables. var ( region string // The region in which the bucket is located. bucketName string // The name of the bucket. ) // Specify the init function used to initialize command line parameters. func init() { flag.StringVar(&region, "region", "", "The region in which the bucket is located.") flag.StringVar(&bucketName, "bucket", "", "The name of the bucket.") } func main() { // Parse command line parameters. flag.Parse() var ( accountId = "account id of the bucket" // Specify the ID of the Alibaba Cloud account to which the bucket owner grants permissions to perform the operation. Example: 109885487000**. inventoryId = "inventory id" // The name of the inventory. The name must be globally unique in the bucket. ) // Check whether the name of the bucket is specified. if len(bucketName) == 0 { flag.PrintDefaults() log.Fatalf("invalid parameters, bucket name required") } // Check whether the region is specified. if len(region) == 0 { flag.PrintDefaults() log.Fatalf("invalid parameters, region required") } // Load the default configurations and specify the credential provider and region. cfg := oss.LoadDefaultConfig(). WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()). WithRegion(region) // Create an OSS client. client := oss.NewClient(cfg) // Create a request to configure an inventory for the bucket. putRequest := &oss.PutBucketInventoryRequest{ Bucket: oss.Ptr(bucketName), // The name of the bucket. InventoryId: oss.Ptr(inventoryId), // The name of the inventory specified by the user. InventoryConfiguration: &oss.InventoryConfiguration{ Id: oss.Ptr(inventoryId), // The name of the inventory specified by the user. IsEnabled: oss.Ptr(true), // Enable the inventory. Filter: &oss.InventoryFilter{ Prefix: oss.Ptr("filterPrefix"), // Specify the rule that is used to filter the objects included in inventories. LastModifyBeginTimeStamp: oss.Ptr(int64(1637883649)), // The timestamp that specifies the start time of the last modification. LastModifyEndTimeStamp: oss.Ptr(int64(1638347592)), // The timestamp that specifies the end time of the last modification. LowerSizeBound: oss.Ptr(int64(1024)), // The lower size limit of files (unit: bytes). UpperSizeBound: oss.Ptr(int64(1048576)), // The upper size limit of files (unit: bytes). StorageClass: oss.Ptr("Standard,IA"), // The storage class. }, Destination: &oss.InventoryDestination{ OSSBucketDestination: &oss.InventoryOSSBucketDestination{ Format: oss.InventoryFormatCSV, // The format of the exported inventory lists. AccountId: oss.Ptr(accountId), // Specify the ID of the account that is granted permissions by the bucket owner to perform the operation. Example: 109885487000. RoleArn: oss.Ptr("acs:ram::" + accountId + ":role/AliyunOSSRole"), // Specify the name of the RAM role that is granted permissions by the bucket owner to perform the operation. Example: acs:ram::109885487000**:role/ram-test. Bucket: oss.Ptr("acs:oss:::" + bucketName), // Specify the name of the bucket in which you want to store the generated inventory lists. Prefix: oss.Ptr("export/"), // Specify the prefix of the path in which you want to store the generated inventory lists. }, }, Schedule: &oss.InventorySchedule{ Frequency: oss.InventoryFrequencyDaily, // The frequency at which the inventory list is exported (daily). }, IncludedObjectVersions: oss.Ptr("All"), // Specify whether to include all versions of objects or only the current versions of objects in the inventory list. }, } // Execute the request. putResult, err := client.PutBucketInventory(context.TODO(), putRequest) if err != nil { log.Fatalf("failed to put bucket inventory %v", err) } // Display the result. log.Printf("put bucket inventory result:%#v\n", putResult) }

import (

Örnek kod çalıştıktan sonra envanter kuralının konsolun Bucket Inventory sayfasında göründüğünü doğrulayın veya kuralı sorgulamak için GetBucketInventory API işlemini çağırın.

ossutil

Aşağıdaki içeriğe sahip inventory-configuration.xml adlı bir dosya oluşturun:

<?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>

Aşağıdaki komutu çalıştırın:

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

Komut çalıştıktan sonra envanter kuralının konsolun Bucket Inventory sayfasında göründüğünü doğrulayın.

API

Bir envanter kuralını yapılandırmak veya değiştirmek için PutBucketInventory işlemini çağırın. Bu yöntem, HTTP isteğini manuel olarak oluşturmanızı ve imza hesaplamasını gerektirdiğinden yüksek derecede özelleştirilmiş senaryolar için uygundur. İstek başarılı olduktan sonra envanter kuralını sorgulamak için GetBucketInventory işlemini çağırabilirsiniz.

Konsol

1. OSS konsoluna giriş yapın.

2. Envanter oluşturmak istediğiniz kaynak pakete gidin. Sol gezinme bölmesinde Veri Yönetimi > Paket Envanteri'ni seçin.

3. Bucket Inventory sayfasında Create Inventory öğesine tıklayın.

4. Create Inventory panelinde Basic Settings parametrelerini yapılandırın.

   Parametre	Açıklama
   Status	Artımlı envanter görevinin durumu. Start öğesini seçin.
   Rule Name	Envanter görevinin adı. Ad yalnızca küçük harfler, rakamlar ve tire (-) içerebilir ve tire (-) ile başlayamaz veya bitemez.
   Inventory Report Destination	Envanter raporunun depolandığı yol. Kaynak paket ve hedef paket aynı hesaba ait olmalı ve aynı bölgede bulunmalıdır. Raporu examplebucket paketindeki exampledir1 yoluna kaydetmek için exampledir1/ girin. Belirtilen yol pakette yoksa OSS yolu otomatik olarak oluşturur. Hedef yol önekinin uzunluğu 128 karakteri aşamaz. Bu alanı boş bırakırsanız rapor kök dizine kaydedilir. OSS-HDFS hizmetine kesinti gelmesini veya veri bozulması riskini önlemek için OSS-HDFS hizmeti etkinleştirilmiş bir paket için envanter raporu kuralı yapılandırırken envanter raporu dizinini .dlsdata/ olarak ayarlamayın.
   Scan Scope	{status, select, BUCKET{Scan Entire Bucket} BUCKET_PATH{Match by Prefix} other{--}}: paketteki tüm nesneleri tarar. Object Prefix: yalnızca belirtilen bir önekle eşleşen nesneleri tarar, örneğin exampledir1/.

5. Track and Generate Incremental Metadata Updates bölümünde Get Incremental Metadata Updates anahtarını açın ve ardından dışa aktarmak istediğiniz Metadata Fields öğelerini seçin.

   Parametre

   Açıklama

   Metadata Fields

   Dışa aktarmak istediğiniz nesne bilgileri. Olay Meta Verileri: {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 ve {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}}. Sistem Meta Verileri: {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}}, nesne türü, nesne ACL, CRC64 ve {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. I acknowledge and agree to grant the Alibaba Cloud OSS service permission to access resources in this bucket. onay kutusunu işaretleyin ve ardından OK öğesine tıklayın. Yeni envanter kuralı, Start durumuyla Bucket Inventory sayfasında görünür.

Ossutil

incremental-inventory.xml adlı bir dosya oluşturun. Tam envanter yapılandırmasından temel fark, <IncrementalInventory> bölümünün eklenmesidir.

<?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>

<IncrementalInventory> bölümünde <Frequency> artımlı envanter dosyalarının dışa aktarma aralığını belirtir. Bu örnekte 600 değeri, artımlı envanterlerin oluşturulduğu yaklaşık 10 dakikalık aralığa karşılık gelir.

Aşağıdaki komutu çalıştırın:

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

Komut çalıştıktan sonra envanter kuralının konsolun Bucket Inventory sayfasında göründüğünü doğrulayın.

API

Bir envanter kuralını yapılandırmak veya değiştirmek için PutBucketInventory API işlemini çağırın. Bu yöntem, yüksek derecede özelleştirilmiş senaryolar için idealdir ancak HTTP isteğini manuel olarak oluşturmanızı ve imzalamanızı gerektirir. İstek başarılı olduktan sonra envanter kuralını sorgulamak için GetBucketInventory işlemini çağırabilirsiniz.