tencent cloud

Cloud Object Storage

인벤토리 - inventory

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2025-10-28 16:08:43
inventory 명령어는 인벤토리 설정, 조회, 삭제, 나열 및 일회성 인벤토리 시작에 사용됩니다.
주의:
인벤토리를 조회하려면 권한 정책 설정 시 action을 cos:GetBucketInventory으로 설정해야 합니다.
인벤토리를 설정하려면 권한 정책 설정 시 action을 cos:PutBucketInventory으로 설정해야 합니다.
인벤토리를 삭제하려면 권한 정책 설정 시 action을 cos:DeleteBucketInventory으로 설정해야 합니다.
인벤토리를 나열하려면 권한 정책 설정 시 action을 cos:GetBucketInventory으로 설정해야 합니다.
일회성 인벤토리를 시작하려면 권한 정책 설정 시 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(일회성 인벤토리 시작) 등 수행할 작업 지정
없음
--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


일회성 인벤토리 시작

작업 예시

버킷 별칭이 example-alias인 버킷의 일회성 인벤토리 작업을 시작합니다. 명령어는 다음과 같습니다(자세한 형식은 일회성 인벤토리 작업 시작 참조).
./coscli inventory --method post cos://example-alias --task-id list4 --configuration "<InventoryConfiguration>...</InventoryConfiguration>"


도움말 및 지원

문제 해결에 도움이 되었나요?

피드백