Use the put-bucket-inventory command to configure inventories - Object Storage Service

Kullanım notları

Yalnızca paket sahibi ve oss:PutBucketInventory iznine sahip RAM kullanıcıları bir paket için envanter yapılandırabilir.
Envanter yapılandırmadan önce, envanteri yapılandırmak istediğiniz paketteki tüm nesnelere erişim yetkisi olan ve envanter listelerini depolamak istediğiniz pakete veri yazma yetkisine sahip bir RAM rolünüzün bulunduğundan emin olun. Paket envanteri özelliğini ilk kez kullanıyorsanız, Object Storage Service (OSS) konsolunda bir envanter yapılandırmanızı öneririz. Envanteri yapılandırdıktan sonra, OSS kaynaklarında tüm işlemleri gerçekleştirmek için gerekli izinlere sahip RAM rolünü elde edebilirsiniz. Envanter yapılandırmak için gereken RAM rolünün izinleri hakkında daha fazla bilgi için bkz. Paket envanteri.
Bir paket için en fazla 1.000 envanter yapılandırabilirsiniz.
Envanter listelerini depolamak istediğiniz paket, envanter yapılandırmak istediğiniz paketle aynı bölgede olmalıdır.

Komut sözdizimi

ossutil api put-bucket-inventory --bucket value --inventory-id value --inventory-configuration value [flags]

Parametre	Tür	Açıklama
--bucket	dize	Paketin adı.
--inventory-configuration	dize	Envanterin yapılandırma bilgilerini depolayan konteyner.
--inventory-id	dize	Envanterin kimliği.

Not

put-bucket-inventory komutu, PutBucketInventory API işlemine eşdeğerdir. API işlemi hakkında daha fazla bilgi için bkz. PutBucketInventory.

--inventory-configuration

--inventory-configuration parametresi XML ve JSON biçimlerini destekler. Parametrenin değeri "file://" ile başlıyorsa yapılandırmalar belirtilen dosyadan yüklenir.

XML biçimi:

<InventoryConfiguration>
  <Id>string</Id>
  <IsEnabled>boolean</IsEnabled>
  <Destination>
    <OSSBucketDestination>
      <Bucket>string</Bucket>
      <Prefix>string</Prefix>
      <Encryption>
        <SSE-OSS>
        </SSE-OSS>
        <SSE-KMS>
          <KeyId>string</KeyId>
        </SSE-KMS>
      </Encryption>
      <Format>string</Format>
      <AccountId>string</AccountId>
      <RoleArn>string</RoleArn>
    </OSSBucketDestination>
  </Destination>
  <Schedule>
    <Frequency>string</Frequency>
  </Schedule>
  <Filter>
    <Prefix>string</Prefix>
  </Filter>
  <IncludedObjectVersions>string</IncludedObjectVersions>
  <OptionalFields>
    <Field>string</Field>
    ...
  </OptionalFields>
</InventoryConfiguration>

JSON biçimi:

[
  {
    "IsEnabled": boolean,
    "Destination": {
      "OSSBucketDestination": {
        "Format": "string",
        "AccountId": "string",
        "RoleArn": "string",
        "Bucket": "string",
        "Prefix": "string",
        "Encryption": {
          "SSE-OSS": {
          
          },
          "SSE-KMS": {
            "KeyId": "string"
          }
        }
      }
    },
    "Schedule": {
      "Frequency": "string"
    },
    "Filter": {
      "Prefix": "string"
    },
    "IncludedObjectVersions": "string",
    "OptionalFields": {
      "Field": [
        "string",
        ...
      ]
    },
    "Id": "string"
  },
  ...
]

Not

Desteklenen genel komut satırı seçenekleri hakkında daha fazla bilgi için bkz. Komut satırı seçenekleri.

Örnekler

examplebucket adlı bir paket için report1 adlı bir envanter yapılandırın.

XML yapılandırma dosyası kullanın (bu örnekte inventory-configuration.xml)

<?xml version="1.0" encoding="UTF-8"?>
<InventoryConfiguration>
  <Id>report1</Id>
    <IsEnabled>true</IsEnabled>
  <Filter>
    <Prefix>Pics/</Prefix>
    <LastModifyBeginTimeStamp>1637883649</LastModifyBeginTimeStamp>
    <LastModifyEndTimeStamp>1638347592</LastModifyEndTimeStamp>
    <LowerSizeBound>1024</LowerSizeBound>
    <UpperSizeBound>1048576</UpperSizeBound>
    <StorageClass>Standard,IA</StorageClass>
  </Filter>
  <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>

Örnek komut:

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

JSON yapılandırma dosyası kullanın (bu örnekte inventory-configuration.json)

{
  "Id": "report1",
  "IsEnabled": "true",
  "Filter": {
    "Prefix": "Pics/",
    "LastModifyBeginTimeStamp": "1637883649",
    "LastModifyEndTimeStamp": "1638347592",
    "LowerSizeBound": "1024",
    "UpperSizeBound": "1048576",
    "StorageClass": "Standard,IA"
  },
  "Destination": {
    "OSSBucketDestination": {
      "Format": "CSV",
      "AccountId": "100000000000000",
      "RoleArn": "acs:ram::100000000000000:role/AliyunOSSRole",
      "Bucket": "acs:oss:::destbucket",
      "Prefix": "prefix1/",
      "Encryption": {
        "SSE-KMS": {
          "KeyId": "keyId"
    	 }
      }
    }
  },
  "Schedule": {
    "Frequency": "Daily"
  },
  "IncludedObjectVersions": "All",
  "OptionalFields": {
    "Field": [
      "Size",
      "LastModifiedDate",
      "ETag",
      "StorageClass",
      "IsMultipartUploaded",
      "EncryptionStatus"
      ]
    }
}

Örnek komut:

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

Komut satırında JSON parametreleri kullanın

ossutil api put-bucket-inventory --bucket examplebucket --inventory-id report1 --inventory-configuration "{\"Id\":\"report1\",\"IsEnabled\":\"true\",\"Filter\":{\"Prefix\":\"Pics/\",\"LastModifyBeginTimeStamp\":\"1637883649\",\"LastModifyEndTimeStamp\":\"1638347592\",\"LowerSizeBound\":\"1024\",\"UpperSizeBound\":\"1048576\",\"StorageClass\":\"Standard,IA\"},\"Destination\":{\"OSSBucketDestination\":{\"Format\":\"CSV\",\"AccountId\":\"100000000000000\",\"RoleArn\":\"acs:ram::100000000000000:role/AliyunOSSRole\",\"Bucket\":\"acs:oss:::destbucket\",\"Prefix\":\"prefix1/\",\"Encryption\":{\"SSE-KMS\":{\"KeyId\":\"keyId\"}}}},\"Schedule\":{\"Frequency\":\"Daily\"},\"IncludedObjectVersions\":\"All\",\"OptionalFields\":{\"Field\":[\"Size\",\"LastModifiedDate\",\"ETag\",\"StorageClass\",\"IsMultipartUploaded\",\"EncryptionStatus\"]}}"