동향 및 공지

릴리스 노트

제품 공지

제품 소개

제품 개요

기능 개요

적용 시나리오

제품 장점

기본 개념

리전 및 액세스 도메인

규격 및 제한

제품 요금

과금 개요

과금 방식

과금 항목

프리 티어

과금 예시

청구서 보기 및 다운로드

연체 안내

FAQ

빠른 시작

콘솔 시작하기

COSBrowser 시작하기

사용자 가이드

요청 생성

버킷

객체

데이터 관리

일괄 프로세스

글로벌 가속

모니터링 및 알람

운영 센터

데이터 처리

스마트 툴 박스 사용 가이드

데이터 워크플로

애플리케이션 통합

툴 가이드

툴 개요

환경 설치 및 설정

COSBrowser 툴

COSCLI 툴

COSCMD 툴

COS Migration 툴

FTP Server 툴

Hadoop 툴

COSDistCp 툴

HDFS TO COS 툴

온라인 도구 (Onrain Dogu)

자가 진단 도구

실습 튜토리얼

개요

액세스 제어 및 권한 관리

성능 최적화

AWS S3 SDK를 사용하여 COS에 액세스하기

데이터 재해 복구 백업

도메인 관리 사례

이미지 처리 사례

COS 오디오/비디오 플레이어 사례

데이터 다이렉트 업로드

데이터 보안

데이터 검증

빅 데이터 사례

COS 비용 최적화 솔루션

3rd party 애플리케이션에서 COS 사용

마이그레이션 가이드

로컬 데이터 COS로 마이그레이션

타사 클라우드 스토리지 데이터를 COS로 마이그레이션

URL이 소스 주소인 데이터를 COS로 마이그레이션

COS 간 데이터 마이그레이션

Hadoop 파일 시스템과 COS 간 데이터 마이그레이션

데이터 레이크 스토리지

클라우드 네이티브 데이터 레이크

메타데이터 가속

데이터 레이크 가속기 GooseFS

데이터 처리

데이터 처리 개요

이미지 처리

미디어 처리

콘텐츠 조정

파일 처리

문서 미리보기

장애 처리

RequestId 가져오기

공용 네트워크로 COS에 파일 업로드 시 속도가 느린 문제

COS 액세스 시 403 에러 코드 반환

리소스 액세스 오류

POST Object 자주 발생하는 오류

보안 및 컴플라이언스

데이터 재해 복구

데이터 보안

액세스 관리

자주 묻는 질문

메타데이터 가속 버킷 인벤토리 기능

PDF

포커스 모드

폰트 크기

마지막 업데이트 시간: 2025-11-24 11:44:15

메타데이터 가속 버킷은 COS 버킷 인벤토리 기능을 사용하여 Hadoop OIV 도구와 유사한 파일 메타데이터 내보내기 기능을 제공합니다. 메타데이터 가속 버킷은 사용자의 인벤토리 작업 설정에 따라 매일 또는 매주 지정된 경로의 파일을 스캔하고 CSV 형식의 인벤토리 보고서를 생성하여 사용자가 지정한 경로에 저장합니다. 이 기능은 파일 분석, 감사, 관리 등의 시나리오에 적합합니다.
설명:
현재 메타데이터 가속 버킷 인벤토리 기능은 화이트리스트 공개 테스트 중이며, 본 문서는 공개 테스트 기간 동안의 설명 문서입니다. 인벤토리 기능을 신청하려면 문의하시기 바랍니다.
공개 테스트 기간 동안 인벤토리 기능은 COS 관리 요금이 부과되지 않으며, 이후 요금 설명은 사이트 내 메시지 및 공식 문서에 따릅니다.
사용 제한
메타데이터 가속 버킷 인벤토리 기능은 공개 테스트 기간 동안 다음과 같은 제한이 있습니다.
단일 COS 메타데이터 가속 버킷에 구성 가능한 인벤토리 규칙은 최대 5개입니다.
설명:
일반적으로 버킷 루트 경로를 인벤토리 스캔 경로로 설정하는 것을 권장합니다. 5개 이상의 규칙을 구성해야 하는 경우 문의하시기 바랍니다.
버킷 간 인벤토리 보고서 전달은 지원되지 않으며, 작업 구성에서 대상 경로는 소스 버킷과 일치해야 합니다.
인벤토리는 현재 사용자 정의 ID를 지원하지 않으며, 작업 생성 후 자동으로 작업 ID가 지정됩니다. 해당 ID는 List 인터페이스를 통해 조회할 수 있습니다.
메타데이터 가속 버킷은 현재 실시간 인벤토리를 지원하지 않습니다.
인벤토리 보고서 전달 안내
사용자가 인벤토리 작업을 구성하면 COS는 구성에 따라 사용자 버킷 내 지정된 경로의 파일을 정기적으로 스캔하고 CSV 형식의 인벤토리 보고서를 출력합니다. 인벤토리 보고서 전달 경로는 작업 구성에서 지정할 수 있으며, CSV 파일의 구체적인 경로는 다음과 같습니다.
destination-prefix/YYYY-MM-DD-HH/Data/8d1048acf48096d17502bd62efc9f8c1.csv
destination-prefix: 사용자가 인벤토리 전달 작업에서 지정한 전달 경로.
YYYY-MM-DD-HH: 타임스탬프, 인벤토리 작업이 실행된 년, 월, 일, 시간.
설명:
경로의 시간은 작업 시작 시간이며, 실제 전달 시간과 일치하지 않습니다. COS 메타데이터 가속 버킷은 일 단위 작업 구성만 지원하며, 처음 구성하거나 전달한 후 24시간 이내에 인벤토리 보고서가 생성됩니다. 특정 시간에 인벤토리 작업을 실행하거나 인벤토리 보고서를 전달하도록 설정할 수 없습니다.
인벤토리 보고서: CSV 형식으로 전달되며, 파일 이름은 COS에서 생성된 임의 이름입니다.
﻿
인벤토리 작업은 구성 규칙에 따라 경로 내 파일을 스캔하며, 생성된 보고서에는 헤더 정보가 포함되지 않습니다. 보고서의 필드 출력 순서 및 설명은 다음과 같습니다.
필드
설명
FileName
파일명
ATime
파일의 접근 시간
설명:
읽기 및 쓰기 성능을 최적화하기 위해 메타데이터 가속 버킷은 기본적으로 ATime 추적을 활성화하지 않습니다. ATime 기능을 사용하려면 문의하시기 바랍니다.
MTime
파일 내용의 변경 시간
CTime
파일 메타데이터의 변경 시간
Size
파일 크기(단위: Byte)
FileType
디렉터리 또는 파일로 출력된 파일 상태, 출력 형식은 DIR(디렉터리) 또는 FILE(파일).
ACL
숫자로 출력 파일 권한 표시. 예: 755
UserName
사용자 이름, 예: hadoop
GroupName
사용자 그룹 이름, 예: supergroup
StorageClass
현재 파일의 스토리지 유형. 가능한 값:
STANDARD
DEGRADE(즉 STANDARD_IA)
ARCHIVE
DEEP_ARCHIVE
ARCHIVE+STANDARD(ARCHIVE 복구됨)
DEEP_ARCHIVE+STANDARD(DEEP_ARCHIVE 복구됨)
인벤토리 구성 방법
현재 COS 메타데이터 가속 버킷은 콘솔을 통한 인벤토리 구성을 지원하지 않으며, API를 통해서만 구성할 수 있습니다. 구체적인 적업은 다음과 같습니다.
1. COS 역할 생성.
2. COS 역할 권한 바인딩.
3. 인벤토리 기능 활성화.
1. COS 역할 생성
COS 역할을 생성합니다. 구체적인 인터페이스 정보는 CreateRole을 참고하십시오.
여기서 roleName은 반드시 COS_QcsRole이어야 합니다.
policyDocument:
{
    "version": "2.0",
    "statement": [{
        "action": "name/sts:AssumeRole",
        "effect": "allow",
        "principal": {
            "service": "cos.cloud.tencent.com"
        }
    }]
}
2. COS 역할 권한 바인딩
역할에 권한을 바인딩합니다. 구체적인 인터페이스 정보는 AttachRolePolicy을 참고하십시오.
여기서 policyName은 QcloudCOSFullAccess이고, roleName은 1단계의 COS_QcsRole이나 roleName 생성 시 반환된 roleID를 사용할 수 있습니다.
3. 인벤토리 기능 활성화
인터페이스를 호출하여 인벤토리 기능을 활성화합니다. 메타데이터 가속 버킷은 COS 인벤토리 기능을 사용하며, COS Inventory 인터페이스를 사용하여 인벤토리 구성을 활성화할 수 있습니다. 메타데이터 가속 버킷의 특성으로 인해 API의 일부 필드는 COS 인벤토리 인터페이스와 차이가 있으며, 구체적인 호출 방법은 다음과 같은 인터페이스 예제를 참조하십시오.
PUT Bucket Inventory
이 인터페이스는 버킷에서 인벤토리 작업을 생성하는 데 사용되며, 인터페이스 매개변수 설명은 COS PUT Inventory 인터페이스 문서를 참고하십시오. 메타데이터 가속 버킷의 특성으로 인해 API의 일부 필드는 COS 인벤토리 인터페이스와 차이가 있으며, 구체적인 설명은 다음과 같습니다.
메타데이터 가속 버킷 인벤토리는 현재 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
이 인터페이스는 버킷에서 특정 인벤토리 작업 정보를 조회하는 데 사용되며, 인터페이스 매개변수 설명은 COS GET Inventory 인터페이스 문서를 참고하십시오. 이 인터페이스는 인벤토리 ID 매개변수가 필요하며, 이 매개변수는 작업 생성 시 메타데이터 가속 버킷에 의해 자동 생성됩니다. 해당 ID를 가져오려면 List Bucket Inventory Configurations 인터페이스를 호출하십시오.
요청
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
이 인터페이스는 버킷 내 모든 인벤토리 작업 리스트를 요청하는 데 사용되며, 매개변수 설명은 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
이 인터페이스는 버킷에서 지정한 인벤토리 작업을 삭제하는 데 사용되며, 인터페이스 매개변수 설명은 COS DELETE Bucket Inventory 인터페이스 문서를 참고하십시오. 이 인터페이스는 인벤토리 ID 매개변수가 필요하며, 이 매개변수는 작업 생성 시 메타데이터 가속 버킷에 의해 자동 생성됩니다. 해당 ID를 가져오려면 List Bucket Inventory Configurations 인터페이스를 호출하십시오.
요청
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(즉 STANDARD_IA) ARCHIVE DEEP_ARCHIVE ARCHIVE+STANDARD(ARCHIVE 복구됨) DEEP_ARCHIVE+STANDARD(DEEP_ARCHIVE 복구됨)