tencent cloud

Cloud Object Storage

インベントリ - inventory

PDF
フォーカスモード
フォントサイズ
最終更新日: 2025-10-28 16:07:42
inventory コマンドは、インベントリの設定、照会、削除、一覧表示、および1回限りのインベントリの開始に使用します。
注意:
インベントリを照会する場合、ポリシー許可を設定する際に、actionをcos:GetBucketInventoryに設定する必要があります。
インベントリを設定する場合、ポリシー許可を設定する際に、actionをcos:PutBucketInventoryに設定する必要があります。
インベントリを削除する場合、ポリシー許可を設定する際に、actionをcos:DeleteBucketInventoryに設定する必要があります。
インベントリを一覧表示する場合、ポリシー許可を設定する際に、actionをcos:GetBucketInventoryに設定する必要があります。
1回限りのインベントリを開始する場合、ポリシー許可を設定する際に、actionをcos:PostBucketInventoryに設定する必要があります。
その他の権限付与については、CAM対応APIをご参照ください。

コマンド形式

./coscli inventory --method [method] cos://<bucket-name>
inventoryコマンドには、以下のパラメータが含まれます。
パラメータ形式
パラメータ用途
cos://<bucket-name>
アクセスしたいバケットを指定します。パラメータ設定で設定したバケットエイリアス、またはバケット名でアクセスできます。バケット名でアクセスする場合は、追加でendpoint flagを指定する必要があります。
バケットエイリアスでアクセス:cos://example-alias
バケット名でアクセス:cos://examplebucket-1250000000
inventory コマンドには、以下のオプションflagが含まれます。
flag(短縮形)
flag(完全形)
flag(使用)
-h
--help
コマンドの具体的な使用方法
なし
--method
実行する操作を指定します。put(バケットインベントリ設定)、get(バケットインベントリ照会)、delete(バケットインベントリ削除)、list(バケットインベントリ一覧表示)、post(1回限りのインベントリ開始)が含まれます。
なし
--task-id
インベントリタスクID
なし
--configuration
インベントリ設定(JSON形式、XML形式、または直接ファイルパスを指定できます。例:/data/configuration.txt は file:///data/configuration.txt と指定する必要があります)
説明:
このコマンドのその他の共通オプション(バケットの切り替え、ユーザーアカウントの切り替えなど)については、共通オプションドキュメントをご参照ください。

バケットインベントリの設定

操作例

バケットエイリアスがexample-aliasのインベントリを設定します。コマンドは以下の通りです(具体的な形式については、バケットインベントリの設定をご参照ください)。
./coscli inventory --method put cos://example-alias --task-id list4 --configuration "<InventoryConfiguration>...</InventoryConfiguration>"

バケットインベントリの照会

操作例

バケットエイリアスがexample-aliasのlist4インベントリタスクを照会します。
./coscli inventory --method get cos://example-alias --task-id list4
以下の結果が出力されます。
SECTION | KEY | VALUE
------------------+-------------------+------------------------------------------------
Basic | ID | list4
+ +-------------------+-----------------------------------------------+
| Enabled | false
+ +-------------------+-----------------------------------------------+
| Included Versions | All
+-----------------+-------------------+-----------------------------------------------+
| |
+-----------------+-------------------+-----------------------------------------------+
Schedule | Frequency | Weekly
+-----------------+-------------------+-----------------------------------------------+
| |
+-----------------+-------------------+-----------------------------------------------+
Destination | Bucket | qcs::cos:ap-nanjing::test-125000000
+ +-------------------+-----------------------------------------------+
| Format | CSV
+ +-------------------+-----------------------------------------------+
| Account ID | 100000000
+ +-------------------+-----------------------------------------------+
| Prefix | list4
+-----------------+-------------------+-----------------------------------------------+
| |
+-----------------+-------------------+-----------------------------------------------+
Filter | Prefix | myPrefix
+ +-------------------+-----------------------------------------------+
| Tag | age=18
+ +-------------------+-----------------------------------------------+
| Period | 2026-01-18 to 2019-09-17
+-----------------+-------------------+-----------------------------------------------+
| |
+-----------------+-------------------+-----------------------------------------------+
Optional Fields | Field | Size
+ + +-----------------------------------------------+
| | ETag
+ + +-----------------------------------------------+
| | StorageClass
+ + +-----------------------------------------------+
| | IsMultipartUploaded
+ + +-----------------------------------------------+
| | Tag
+ + +-----------------------------------------------+
| | LastModifiedDate
------------------+-------------------+------------------------------------------------
Inventory Configuration Details

バケットインベントリの削除

操作例

バケットエイリアスがexample-aliasのバケットのlist4インベントリタスクを削除します。コマンドは以下の通りです。
./coscli inventory --method delete cos://example-alias --task-id list4

すべてのバケットインベントリの一覧表示

操作例

バケットエイリアスがexample-aliasのすべてのインベントリタスクを一覧表示します。
./coscli inventory --method list cos://example-alias
以下の結果が出力されます。
ID | STATUS | SCHEDULE | INCLUDEDOBJECTVERSIONS | DESTINATION | FILTER | FIELDS
--------+----------+-------------------+------------------------+-------------------------------------------------------+----------------------------------+----------------------
list1 | Enabled | Frequency: Daily | All | Bucket: qcs::cos:ap-nanjing::test-125000000 | Period: 2019-09-17 to 2019-09-17 | Size
| | | | Format: CSV | | ETag
| | | | Account: 1000000000 | | StorageClass
| | | | Prefix: list1 | | IsMultipartUploaded
| | | | | | ReplicationStatus
| | | | | | LastModifiedDate
--------+----------+-------------------+------------------------+-------------------------------------------------------+----------------------------------+----------------------
list3 | Disabled | Frequency: Weekly | All | Bucket: qcs::cos:ap-nanjing::test-125000000 | Period: 2026-01-18 to 2019-09-17 | Size
| | | | Format: CSV | | ETag
| | | | Account: 1000000000 | | StorageClass
| | | | Prefix: list3 | | IsMultipartUploaded
| | | | | | ReplicationStatus
| | | | | | LastModifiedDate
--------+----------+-------------------+------------------------+-------------------------------------------------------+----------------------------------+----------------------
list4 | Disabled | Frequency: Weekly | All | Bucket: qcs::cos:ap-nanjing::test-125000000 | Prefix: myPrefix | Size
| | | | Format: CSV | Tags: age=18 | ETag
| | | | Account: 1000000000 | Period: 2026-01-18 to 2019-09-17 | StorageClass
| | | | Prefix: list4 | | IsMultipartUploaded
| | | | | | Tag
| | | | | | LastModifiedDate
--------+----------+-------------------+------------------------+-------------------------------------------------------+----------------------------------+----------------------
Detailed COS Bucket Inventory Configurations

Total inventory configurations: 3


1回限りのインベントリを開始

操作例

バケットエイリアスexample-aliasに対し、1回限りのインベントリタスクを開始します。コマンドは以下の通りです(具体的な形式については、1回限りのインベントリタスクの開始をご参照ください)。
./coscli inventory --method post cos://example-alias --task-id list4 --configuration "<InventoryConfiguration>...</InventoryConfiguration>"


ヘルプとサポート

この記事はお役に立ちましたか?

フィードバック