最新情報とお知らせ

製品アップデート情報

製品のお知らせ

製品概要

機能概要

応用シナリオ

製品の優位性

基本概念

リージョンとアクセスドメイン名

仕様と制限

製品の課金

課金概要

課金方式

課金項目

無料利用枠

記帳例

請求書の確認とダウンロード

お支払い遅れについて

よくある質問

クイックスタート

コンソールクイックスタート

COSBrowserクイックスタート

ユーザーガイド

リクエストの作成

バケット

オブジェクト

データ管理

バッチ処理

グローバルアクセラレーション

監視とアラーム

運用管理センター

データ処理

インテリジェントツールボックス使用ガイド

データワークフロー

アプリ統合

ツールガイド

ツール概要

環境のインストールと設定

COSBrowserツール

COSCLIツール

COSCMDツール

COS Migrationツール

FTP Serverツール

Hadoopツール

COSDistCpツール

HDFS TO COSツール

オンラインツール (Onrain Tsūru)

セルフ診断ツール

実践チュートリアル

概要

アクセス制御と権限管理

パフォーマンスの最適化

AWS S3 SDKを使用したCOSアクセス

データディザスタリカバリバックアップ

ドメイン名管理の実践

画像処理の実践

COSオーディオビデオプレーヤーの実践

データセキュリティ

データ検証

COSコスト最適化ソリューション

サードパーティアプリケーションでのCOSの使用

移行ガイド

サードパーティクラウドストレージのデータをCOSへ移行

データレークストレージ

クラウドネイティブデータレイク

メタデータアクセラレーション

データアクセラレーター GooseFS

データ処理

データ処理概要

画像処理

メディア処理

コンテンツ審査

ファイル処理

ドキュメントプレビュー

トラブルシューティング

RequestId取得の操作ガイド

パブリックネットワーク経由でのCOSへのファイルアップロード速度の遅さ

COSへのアクセス時に403エラーコードが返される

リソースアクセス異常

POST Objectの一般的な異常

セキュリティとコンプライアンス

データ災害復帰

データセキュリティ

クラウドアクセスマネジメント

よくある質問

よくあるご質問

一般的な問題

従量課金に関するご質問

ドメインコンプライアンスに関するご質問

バケット設定に関する質問

ドメイン名とCDNに関するご質問

ファイル操作に関するご質問

権限管理に関するご質問

データ処理に関するご質問

データセキュリティに関するご質問

署名付きURLに関するご質問

SDKクラスに関するご質問

ツール類に関するご質問

APIクラスに関するご質問

Agreements

Service Level Agreement

プライバシーポリシー

データ処理とセキュリティ契約

連絡先

用語集

メタデータアクセラレーションバケットのインベントリ機能

PDF

フォーカスモード

フォントサイズ

最終更新日: 2025-11-24 11:42:46

メタデータアクセラレーションバケットはCOSバケットインベントリ機能を再利用しており、Hadoop OIVツールのようなファイルメタデータのエクスポートを提供します。メタデータアクセラレーションバケットは、ユーザーのインベントリタスク設定に基づき、毎日または毎週、バケット内の指定されたパス配下にあるファイルを定期的にスキャンし、インベントリレポートをCSV形式のファイルとしてユーザー指定のパスに出力します。ファイル分析、監査、ガバナンスなどのシナリオに適しています。
説明：
現在、メタデータアクセラレーションバケットのインベントリ機能はホワイトリスト形式でパブリックベータテスト中です。本記事は、パブリックベータ期間中の説明としてのみ使用されます。インベントリ機能の有効化を申請する必要がある場合は、お問い合わせください。
パブリックベータ期間中、インベントリ機能にCOS管理機能料金は発生しません。将来の課金に関する説明は、サイトの通知および公式サイトのドキュメントの記載に準じます。
利用制限
メタデータアクセラレーションバケットのインベントリは、パブリックベータ期間中、以下の制限がありますのでご了承ください。
1つのCOSメタデータアクセラレーションバケットに設定できるインベントリルールの最大数は5件です。
説明：
通常、バケットのルートパスをインベントリのスキャンパスとして設定することを推奨します。もし5件を超えるルール設定が必要なシナリオの場合は、お問い合わせください。
バケットをまたいだインベントリレポートの配信はサポートしていません。タスク設定におけるターゲットパスは、ソースバケットと一致させる必要があります。
インベントリは現在、カスタムIDをサポートしていません。タスク作成後にタスクIDが自動的に割り当てられます。このIDはList APIで照会可能です。
メタデータアクセラレーションバケットは現在、リアルタイム更新インベントリをサポートしていません。
インベントリレポートの配信について
ユーザーがインベントリタスクを設定すると、COSは設定に基づき、バケット内の指定パス配下にあるファイルを定期的にスキャンし、CSV形式のインベントリレポートを出力します。レポートの配信パスはタスク設定で指定可能で、CSVファイルの具体的なパスは以下の通りです：
destination-prefix/YYYY-MM-DD-HH/Data/8d1048acf48096d17502bd62efc9f8c1.csv
destination-prefix：ユーザーがインベントリ配信タスクで指定した配信パス。
YYYY-MM-DD-HH：タイムスタンプ。インベントリタスクが実行された年、月、日、時刻。
説明：
パス内の「時刻」はタスクが開始された時刻であり、実際の配信時刻とは異なります。COSメタデータアクセラレーションバケットは、日次レベルのタスクのみを設定できます。初回設定時または前回の配信から24時間以内にレポートが1件生成されます。固定時刻でのタスク実行やレポート配信を指定することはできません。
インベントリレポート：CSV形式で配信されます。ファイル名はCOSによって生成されたランダムな値です。
﻿
インベントリタスクは設定ルールに従ってパス配下のファイルをスキャンします。生成されるレポートにはヘッダー情報は含まれません。レポートに出力されるフィールドの順序と説明は以下の通りです。
フィールド
説明
FileName
ファイル名
ATime
ファイルのアクセス日時
説明：
読み書きパフォーマンスを確保するため、メタデータアクセラレーションバケットはデフォルトでATimeの追跡を有効にしていません。ATime機能のご利用が必要な場合は、お問い合わせください。
MTime
ファイル内容の変更日時
CTime
ファイルメタデータの変更日時
Size
ファイルサイズ（単位：Byte）
FileType
ファイルの状態をディレクトリまたはファイルとして出力します。出力形式：DIR（ディレクトリ）またはFILE（ファイル）
ACL
ファイルの権限を数字で出力します。例：755
UserName
ユーザー名。例：hadoop
GroupName
ユーザーグループ名。例：supergroup
StorageClass
現在のファイルのストレージタイプ。以下の値のいずれかになります：
STANDARD（標準ストレージ）
DEGRADE（低頻度ストレージ）
ARCHIVE（アーカイブストレージ）
DEEP_ARCHIVE（ディープアーカイブストレージ）
ARCHIVE+STANDARD（アーカイブストレージが復元済み）
DEEP_ARCHIVE+STANDARD（ディープアーカイブストレージが復元済み）
インベントリの設定方法
現在、COSメタデータアクセラレーションバケットは、コンソールでのインベントリ設定をサポートしていません。API経由でのみ設定可能です。具体的な手順は以下の通りです。
1. COSロールの作成。
2. COSロールへの権限の紐付け。
3. インベントリ機能の有効化。
1. COSロールの作成。
COSロールを作成します。詳細なAPI情報についてはCreateRoleをご参照ください。
ここで、roleNameは、COS_QcsRoleである必要があります。
policyDocumentは以下の通りです。
{
    "version": "2.0",
    "statement": [{
        "action": "name/sts:AssumeRole",
        "effect": "allow",
        "principal": {
            "service": "cos.cloud.tencent.com"
        }
    }]
}
2. COSロールへの権限の紐付け
ロールに権限を紐付けます。詳細なAPI情報についてはAttachRolePolicyをご参照ください。
ここで、policyNameは、QcloudCOSFullAccessを、roleNameは、ステップ1のCOS_QcsRole（またはroleName作成時に返されたroleID）を使用します。
3. インベントリ機能の有効化
APIによるインベントリ機能の有効化。COSメタデータアクセラレーションバケットは、インベントリ機能を再利用しており、COS Inventory APIによるインベントリの設定をサポートしています。メタデータアクセラレーションバケットの特性により、APIの一部のフィールドはCOSインベントリAPIと異なります。具体的な呼び出し方法は、以下のAPI例をご参照ください。
PUT Bucket Inventory
このAPIは、バケット内にインベントリタスクを作成するために使用します。APIのパラメータ説明についてはCOS PUT Inventory APIドキュメントをご参照ください。メタデータアクセラレーションバケットの特性上、APIの一部のフィールドはCOSインベントリAPIと異なります。詳細は以下の通りです。
メタデータアクセラレーションバケットのインベントリは現在、IDの指定をサポートしていません。IDは、タスク作成時にID情報を含める必要がなく、COSによって自動生成されます。
現在、メタデータアクセラレーションバケットは、インベントリレポートのソースバケットへの配信のみをサポートしています。COSBucketDestinationはソースバケットとして設定する必要があります。
現在、インベントリレポートの暗号化設定はサポートしていません。タスク作成時にEncryptionフィールドの設定はサポートされていません。
メタデータアクセラレーションバケットは現在バージョニング機能をサポートしていないため、設定の際にIncludedObjectVersionsフィールドはサポートされていません。
メタデータバケットは、インベントリレポートの出力フィールド指定をサポートしていません。OptionalFieldsフィールドは、以下の例を参考に入力してください。
リクエスト
PUT /?inventory HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
Content-MD5: MD5
﻿
<InventoryConfiguration>
   <IsEnabled>true</IsEnabled>
   <Destination>
    <COSBucketDestination>
     <Format>CSV</Format>
     <AccountId>1000000000</AccountId>
     <Bucket>qcs::cos:ap-beijing::bucketname-100000000</Bucket>
     <Prefix>/testprefix</Prefix>
    </COSBucketDestination>
   </Destination>
   <Schedule>
    <Frequency>Daily</Frequency>
   </Schedule>
   <Filter>
    <Prefix>/my-inventory</Prefix>
   </Filter>
   <OptionalFields>
    <Field>ATime</Field>
    <Field>ACL</Field>
    <Field>MTime</Field>
    <Field>CTime</Field>
    <Field>Size</Field>
    <Field>UserName</Field>
    <Field>GroupName</Field>
    <Field>StorageClass</Field>
    <Field>FileType</Field>
   </OptionalFields>
</InventoryConfiguration>
応答
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 0
Date: Mon, 28 Aug 2018 02:53:38 GMT
Server: tencent-cos
x-cos-request-id: NTlhMzg1ZWVfMjQ4OGY3MGFfMWE1NF8****
GET Bucket Inventory
このAPIは、バケット内の具体的なインベントリタスク情報を照会するために使用します。APIのパラメータ説明についてはCOS GET Inventory APIドキュメントをご参照ください。このAPIにはインベントリIDパラメータが必要ですが、このIDはタスク作成時にメタデータアクセラレーションバケットによって自動生成されます。IDを取得するには、List Bucket Inventory Configurations APIを呼び出す必要があります。
リクエスト
GET /?inventory&id=inventory-configuration-ID HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
応答
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 331
Date: Mon, 28 Aug 2018 02:53:39 GMT
Server: tencent-cos
x-cos-request-id: NTlhMzg1ZWVfMjQ4OGY3MGFfMWE1NF84Y2M
<?xml version = "1.0" encoding = "UTF-8">
<InventoryConfiguration xmlns = "http://....">
   <Id>12761</Id>
   <IsEnabled>true</IsEnabled>
   <Destination>
    <COSBucketDestination>
     <Format>CSV</Format>
     <AccountId>1000000000</AccountId>
     <Bucket>qcs::cos:ap-beijing::bucketname-100000000</Bucket>
     <Prefix>/testprefix</Prefix>
    </COSBucketDestination>
   </Destination>
   <Schedule>
    <Frequency>Daily</Frequency>
   </Schedule>
   <Filter>
    <Prefix>/my-inventory</Prefix>
   </Filter>
   <OptionalFields>
    <Field>ATime</Field>
    <Field>ACL</Field>
    <Field>MTime</Field>
    <Field>CTime</Field>
    <Field>Size</Field>
    <Field>UserName</Field>
    <Field>GroupName</Field>
    <Field>StorageClass</Field>
    <Field>FileType</Field>
   </OptionalFields>
  </InventoryConfiguration>
List Bucket Inventory Configurations
このAPIは、バケット内のすべてのインベントリタスクを返すようリクエストするために使用します。APIのパラメータ説明についてはCOS List Bucket Inventory Configurations APIドキュメントをご参照ください。
リクエスト
GET /?inventory HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
応答
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 331
Date: Mon, 28 Aug 2018 02:53:39 GMT
Server: tencent-cos
x-cos-request-id: NTlhMzg1ZWVfMjQ4OGY3MGFfMWE1NF8****
<?xml version = "1.0" encoding = "UTF-8">
<ListInventoryConfigurationResult xmlns = "http://....">
<InventoryConfiguration>
   <Id>12761</Id>
   <IsEnabled>true</IsEnabled>
   <Destination>
    <COSBucketDestination>
     <Format>CSV</Format>
     <AccountId>1000000000</AccountId>
     <Bucket>qcs::cos:ap-beijing::bucketname-100000000</Bucket>
     <Prefix>/testprefix</Prefix>
    </COSBucketDestination>
   </Destination>
   <Schedule>
    <Frequency>Daily</Frequency>
   </Schedule>
   <Filter>
    <Prefix>/my-inventory</Prefix>
   </Filter>
   <OptionalFields>
    <Field>ATime</Field>
    <Field>ACL</Field>
    <Field>MTime</Field>
    <Field>CTime</Field>
    <Field>Size</Field>
    <Field>UserName</Field>
    <Field>GroupName</Field>
    <Field>StorageClass</Field>
    <Field>FileType</Field>
   </OptionalFields>
  </InventoryConfiguration>
<InventoryConfiguration>
   <Id>12762</Id>
   <IsEnabled>true</IsEnabled>
   <Destination>
    <COSBucketDestination>
     <Format>CSV</Format>
     <AccountId>1000000000</AccountId>
     <Bucket>qcs::cos:ap-beijing::bucketname-100000000</Bucket>
     <Prefix>/testprefix</Prefix>
    </COSBucketDestination>
   </Destination>
   <Schedule>
    <Frequency>Daily</Frequency>
   </Schedule>
   <Filter>
    <Prefix>/my-inventory2</Prefix>
   </Filter>
   <OptionalFields>
    <Field>ATime</Field>
    <Field>ACL</Field>
    <Field>MTime</Field>
    <Field>CTime</Field>
    <Field>Size</Field>
    <Field>UserName</Field>
    <Field>GroupName</Field>
    <Field>StorageClass</Field>
    <Field>FileType</Field>
   </OptionalFields>
  </InventoryConfiguration>
  <IsTruncated>false</IsTruncated>
 </ListInventoryConfigurationResult>
DELETE Bucket Inventory
このAPIは、バケット内の指定されたインベントリタスクを削除するために使用します。APIのパラメータ説明についてはCOS DELETE Bucket Inventory APIドキュメントをご参照ください。このAPIにはインベントリIDパラメータが必要ですが、このIDはタスク作成時にメタデータアクセラレーションバケットによって自動生成されます。IDを取得するには、List Bucket Inventory Configurations APIを呼び出す必要があります。
リクエスト
DELETE /?inventory&id=inventory-configuration-id HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
応答
HTTP/1.1 204 No Content 
Server: tencent-cos
Date: Mon, 28 Aug 2018 02:53:40 GMT
x-cos-id-2:0dfafa/DAPDIFdafdsfDdfSFFfdfKKJdafasiuKJK2
x-cos-request-id: NTlhM2I3M2JfMjQ4OGY3MGFfMWE1NF84****
﻿
﻿

ヘルプとサポート

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

営業担当者にお問い合わせいただくかチケットを提出してサポートを求めることができます。

フィードバック

tencent cloud

Cloud Object Storage

メタデータアクセラレーションバケットのインベントリ機能

利用制限

インベントリレポートの配信について

インベントリの設定方法

1. COSロールの作成。

2. COSロールへの権限の紐付け

3. インベントリ機能の有効化

PUT Bucket Inventory

リクエスト

応答

GET Bucket Inventory

リクエスト

応答

List Bucket Inventory Configurations

リクエスト

応答

DELETE Bucket Inventory

リクエスト

応答

ヘルプとサポート

フィールド	説明
FileName	ファイル名
ATime	ファイルのアクセス日時説明：読み書きパフォーマンスを確保するため、メタデータアクセラレーションバケットはデフォルトでATimeの追跡を有効にしていません。ATime機能のご利用が必要な場合は、お問い合わせください。
MTime	ファイル内容の変更日時
CTime	ファイルメタデータの変更日時
Size	ファイルサイズ（単位：Byte）
FileType	ファイルの状態をディレクトリまたはファイルとして出力します。出力形式：DIR（ディレクトリ）またはFILE（ファイル）
ACL	ファイルの権限を数字で出力します。例：755
UserName	ユーザー名。例：hadoop
GroupName	ユーザーグループ名。例：supergroup
StorageClass	現在のファイルのストレージタイプ。以下の値のいずれかになります： STANDARD（標準ストレージ） DEGRADE（低頻度ストレージ） ARCHIVE（アーカイブストレージ） DEEP_ARCHIVE（ディープアーカイブストレージ） ARCHIVE+STANDARD（アーカイブストレージが復元済み） DEEP_ARCHIVE+STANDARD（ディープアーカイブストレージが復元済み）

tencent cloud

Cloud Object Storage

メタデータアクセラレーションバケットのインベントリ機能

利用制限

インベントリレポートの配信について

インベントリの設定方法

1. COSロールの作成。

2. COSロールへの権限の紐付け

3. インベントリ機能の有効化

PUT Bucket Inventory

リクエスト

応答

GET Bucket Inventory

リクエスト

応答

List Bucket Inventory Configurations

リクエスト

応答

DELETE Bucket Inventory

リクエスト

応答

﻿

ヘルプとサポート