MinIO Client Complete Guide
MinIO 클라이언트 전체 가이드
MinIO Client (mc) provides a modern alternative to UNIX commands like ls, cat, cp, mirror, diff etc.
MinIO 클라이언트 (mc)는 ls, cat, cp, mirror, diff 등과 같은 UNIX 명령에 대한 현대적인 대안을 제공합니다.
It supports filesystems and Amazon S3 compatible cloud storage service (AWS Signature v2 and v4).
파일 시스템과 아마존 S3 호환 클라우드 스토리지 서비스 (AWS Signature v2 및 v4)를 지원합니다.
ls list buckets and objects
ls 버킷과 객체를 나열합니다
tree list buckets and objects in a tree format
tree 트리 형식의 버킷 및 객체를 나열합니다
mb make a bucket
mb 버킷을 만듭니다
rb remove a bucket
rb 버킷을 제거합니다
cat display object contents
cat 객체 내용을 표시합니다
head display first 'n' lines of an object
head 객체의 처음 'n' 라인을 표시합니다
pipe stream STDIN to an object
pipe STDIN을 객체로 스트리밍합니다
share generate URL for temporary access to an object
share 객체에 대한 임시 액세스를 위한 생성 URL 공유합니다
cp copy objects
cp 객체를 복사합니다
mirror synchronize objects to a remote site
mirror 원격 사이트에 객체를 동기화합니다
find search for objects
find 객체를 검색합니다
sql run sql queries on objects
sql 객체에 대해 SQL 쿼리를 실행합니다
stat stat contents of objects
stat 객체의 통계 내용
diff list differences in object name, size, and date between buckets
diff 버킷 간 객체 이름, 크기, 데이트의 차이점을 나열합니다
rm remove objects
rm 객체를 제거합니다
event manage object notifications
event 객체 알림을 관리합니다
watch watch for object events
watch 객체 이벤트를 감시합니다
policy manage anonymous access to objects
policy 객체에 대한 익명 액세스를 관리합니다
admin manage MinIO servers
admin MinIO 서버를 관리합니다
session manage saved sessions for cp command
session cp 명령에 대해 저장된 세션을 관리합니다
config manage mc configuration file
config mc 구성 파일을 관리합니다
update check for a new software update
update 새 소프트웨어 업데이트를 확인합니다
version print version info
version 버전 정보를 프린트합니다
1. Download MinIO Client
1. MinIO 클라이언트 다운로드
Docker Stable
도커 안정
docker pull minio/mc
docker run minio/mc ls play
Docker Edge
도커 엣지
docker pull minio/mc:edge
docker run minio/mc:edge ls play
Note: Above examples run mc against MinIO play environment by default. To run mc against other S3 compatible servers, start the container this way
메모: 위의 예에서는 기본적으로 MinIO 플레이 환경에 대해 mc를 실행합니다. 다른 S3 호환 서버에 대해 mc를 실행하려면 다음과 같이 컨테이너를 시작하십시오.
docker run -it --entrypoint=/bin/sh minio/mc
then use the mc config command.
그런 다음 mc config 명령을 사용하십시오.
Homebrew (macOS)
홈브류(macOS)
Install mc packages using Homebrew
Homebrew를 사용하여 mc 패키지 설치
brew install minio/stable/mc
mc --help
Binary Download (GNU/Linux)
바이너리 다운로드 (GNU/Linux)
Platform
Architecture
URL
GNU/Linux
64-bit Intel
https://dl.min.io/client/mc/release/linux-amd64/mc
64-bit PPC
https://dl.min.io/client/mc/release/linux-ppc64le/mc
chmod +x mc
./mc --help
Binary Download (Microsoft Windows)
바이너리 다운로드(Microsoft Windows)
Platform
Architecture
URL
Microsoft Windows
64-bit Intel
https://dl.min.io/client/mc/release/windows-amd64/mc.exe
mc.exe --help
Install from Source
소스에서 설치
Source installation is intended only for developers and advanced users. mc update command does not support update notifications for source based installations.
소스 설치는 개발자와 고급 사용자만을 위한 것입니다. mc update 명령은 소스 기반 설치에 대한 업데이트 알림을 지원하지 않습니다.
Please download official releases from https://min.io/download/#minio-client. If you do not have a working Golang environment, please follow How to install Golang.
https://min.io/download/#minio-client에서 공식 릴리스를 다운로드하세요. 작동하는 Golang 환경이 없다면 Golang 설치 방법을 따르세요.
go get -d github.com/minio/mc
cd ${GOPATH}/src/github.com/minio/mc
make
2. Run MinIO Client
2. MinIO 클라이언트 실행
GNU/Linux
GNU/리눅스
chmod +x mc
./mc --help
macOS
macOS
chmod 755 mc
./mc --help
Microsoft Windows
마이크로소프트 윈도우
mc.exe --help
3. Add a Cloud Storage Service
3. 클라우드 스토리지 서비스 추가
Note: If you are planning to use mc only on POSIX compatible filesystems, you may skip this step and proceed to Step 4.
메모: POSIX 호환 파일 시스템에서만 mc를 사용하려는 경우 이 단계를 건너뛰고 4 단계로 진행할 수 있습니다.
To add one or more Amazon S3 compatible hosts, please follow the instructions below. mc stores all its configuration information in ~/.mc/config.json file.
하나 이상의 Amazon S3 호환 호스트를 추가하려면 아래 지침을 따르십시오. mc는 모든 구성 정보를 ~/.mc/config.json 파일에 저장합니다.
Usage
용법
mc config host add
Alias is simply a short name to your cloud storage service.
별칭은 단순히 클라우드 스토리지 서비스에 대한 짧은 이름입니다.
S3 end-point, access and secret keys are supplied by your cloud storage provider. API signature is an optional argument. By default, it is set to "S3v4".
S3 엔드포인트, 액세스 및 비밀 키는 클라우드 스토리지 공급자가 제공합니다. API 서명은 선택적 인수입니다. 기본적으로 "S3v4"로 설정되어 있습니다.
Example - MinIO Cloud Storage
예 - MinIO 클라우드 스토리지
MinIO server displays URL, access and secret keys.
MinIO 서버는 URL, 액세스 및 비밀 키를 표시합니다.
mc config host add minio http://192.168.1.51 BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12 --api S3v4
Example - Amazon S3 Cloud Storage
예 - 아마존 S3 클라우드 스토리지
Get your AccessKeyID and SecretAccessKey by following AWS Credentials Guide.
AWS 자격 증명 가이드에 따라 AccessKeyID 및 SecretAccessKey를 받으세요.
mc config host add s3 https://s3.amazonaws.com BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12 --api S3v4
Example - Google Cloud Storage
예 - Google 클라우드 스토리지
Get your AccessKeyID and SecretAccessKey by following Google Credentials Guide
Google 자격 증명 가이드에 따라 AccessKeyID 및 SecretAccessKey를 받으세요.
mc config host add gcs https://storage.googleapis.com BKIKJAA5BMMU2RHO6IBB V8f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
Specify host configuration through environment variable
환경 변수를 통해 호스트 구성 지정
export MC_HOST_=https://:@
Example:
예:
export MC_HOST_myalias=https://Q3AM3UQ867SPQQA43P2F:zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG@play.min.io
mc ls myalias
4. Test Your Setup
4. 설정을 테스트
mc is pre-configured with https://play.min.io, aliased as "play". It is a hosted MinIO server for testing and development purpose. To test Amazon S3, simply replace "play" with "s3" or the alias you used at the time of setup.
mc는 https://play.min.io로 사전 구성되어 있으며 별칭은 "play"입니다. 테스트 및 개발 목적으로 호스팅되는 MinIO 서버입니다. Amazon S3를 테스트하려면 "play"를 "s3" 또는 설정 시 사용한 별칭으로 바꾸면 됩니다.
Example:
예:
List all buckets from https://play.min.io
https://play.min.io에서 모든 버킷을 나열합니다
mc ls play
[2016-03-22 19:47:48 PDT] 0B my-bucketname/
[2016-03-22 22:01:07 PDT] 0B mytestbucket/
[2016-03-22 20:04:39 PDT] 0B mybucketname/
[2016-01-28 17:23:11 PST] 0B newbucket/
[2016-03-20 09:08:36 PDT] 0B s3git-test/
5. Everyday Use
5. 일상적인 사용
You may add shell aliases to override your common Unix tools.
일반적인 Unix 도구를 재정의하기 위해 쉘 별칭을 추가할 수 있습니다.
alias ls='mc ls'
alias cp='mc cp'
alias cat='mc cat'
alias mkdir='mc mb'
alias pipe='mc pipe'
alias find='mc find'
alias tree='mc tree'
6. Global Options
6. 글로벌 옵션
Option [--debug]
옵션 [-디버그]
Debug option enables debug output to console.
디버그 옵션을 사용하면 콘솔에 디버그 출력을 활성화할 수 있습니다.
Example: Display verbose debug output for ls command.
예: ls 명령에 대한 자세한 디버그 출력을 표시합니다.
mc --debug ls play
mc: GET / HTTP/1.1
Host: play.min.io
User-Agent: MinIO (darwin; amd64) minio-go/1.0.1 mc/2016-04-01T00:22:11Z
Authorization: AWS4-HMAC-SHA256 Credential=**REDACTED**/20160408/us-east-1/s3/aws4_request, SignedHeaders=expect;host;x-amz-content-sha256;x-amz-date, Signature=**REDACTED**
Expect: 100-continue
X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
X-Amz-Date: 20160408T145236Z
Accept-Encoding: gzip
mc: HTTP/1.1 200 OK
Transfer-Encoding: chunked
Accept-Ranges: bytes
Content-Type: text/xml; charset=utf-8
Date: Fri, 08 Apr 2016 14:54:55 GMT
Server: MinIO/DEVELOPMENT.2016-04-07T18-53-27Z (linux; amd64)
Vary: Origin
X-Amz-Request-Id: HP30I0W2U49BDBIO
mc: Response Time: 1.220112837s
[...]
[2016-04-08 03:56:14 IST] 0B albums/
[2016-04-04 16:11:45 IST] 0B backup/
[2016-04-01 20:10:53 IST] 0B deebucket/
[2016-03-28 21:53:49 IST] 0B guestbucket/
Option [--json]
옵션 [--json]
JSON option enables parseable output in JSON lines format.
JSON 옵션을 사용하면 JSON 라인 형식으로 구문 분석 가능한 출력이 가능합니다.
Example: List all buckets from MinIO play service.
예: MinIO 플레이 서비스의 모든 버킷을 나열합니다.
mc --json ls play
{"status":"success","type":"folder","lastModified":"2016-04-08T03:56:14.577+05:30","size":0,"key":"albums/"}
{"status":"success","type":"folder","lastModified":"2016-04-04T16:11:45.349+05:30","size":0,"key":"backup/"}
{"status":"success","type":"folder","lastModified":"2016-04-01T20:10:53.941+05:30","size":0,"key":"deebucket/"}
{"status":"success","type":"folder","lastModified":"2016-03-28T21:53:49.217+05:30","size":0,"key":"guestbucket/"}
Option [--no-color]
옵션 [--색상 없음]
This option disables the color theme. It is useful for dumb terminals.
이 옵션은 색상 테마를 비활성화합니다. 덤 터미널에 유용합니다.
Option [--quiet]
옵션 [--조용함]
Quiet option suppress chatty console output.
Quiet 옵션은 chatty 콘솔 출력을 억제합니다.
Option [--config-dir]
옵션 [--config-dir]
Use this option to set a custom config path.
사용자 정의 구성 경로를 설정하려면 이 옵션을 사용하십시오.
Option [ --insecure]
옵션 [--안전하지 않음]
Skip SSL certificate verification.
SSL 인증서 확인을 건너뜁니다.
7. Commands
7. 명령
ls - List buckets and objects
ls - 버킷 및 객체 목록
tree - List buckets and objects in a tree format
tree - 버킷 및 객체를 트리 형식으로 나열
mb - Make a bucket
mb - 버킷 만들기
cp - Copy objects
cp - 객체 복사
rb - Remove a bucket
rb - 버킷 제거
pipe - Pipe to an object
pipe - 객체에 파이프
share - Share access
share - 액세스 공유
rm - Remove objects
rm - 객체 제거
find - Find files and objects
find - 파일 및 객체 찾기
diff - Diff buckets
diff - 다른 버킷
mirror - Mirror buckets
mirror - 미러 버킷 (버킷을 반영)
session - Manage saved sessions
session - 저장된 세션 관리
config - Manage config file
config - 구성 파일 관리
policy - Set public policy on bucket or prefix
policy - 버킷 또는 접두사에 퍼블릭 정책 설정
event - Manage events on your buckets
event - 버킷의 이벤트 관리
update - Manage software updates
update - 소프트웨어 업데이트 관리
watch - Watch for events
watch - 이벤트 관찰
stat - Stat contents of objects and folders
stat - 객체 및 폴더의 통계 내용
head - Display first 'n' lines of an object
head - 객체의 첫 번째 'n' 줄을 표시하십시오
version - Show version
version - 버전 표시
sql - Run sql queries on objects
sql - 객체에 대한 SQL 쿼리 실행
Command ls - List Objects
ls 명령 - 객체를 나열
ls command lists files, buckets and objects. Use --incomplete flag to list partially copied content.
ls 명령은 파일, 버킷 및 객체를 나열합니다. 부분적으로 복사된 컨텐츠를 나열하려면 --incomplete 플래그를 사용하세요.
USAGE:
용법
mc ls [FLAGS] TARGET [TARGET ...]
FLAGS:
플래그:
--recursive, -r list recursively
--recursive, -r 재귀적으로 나열
--incomplete, -I list incomplete uploads
--incomplete, -I. 완료되지 않은 업로드를 나열합니다
--help, -h show help
--help, -h 도움말 표시
Example: List all buckets on https://play.min.io.
예: https://play.min.io의 모든 버킷을 나열합니다.
mc ls play
[2016-04-08 03:56:14 IST] 0B albums/
[2016-04-04 16:11:45 IST] 0B backup/
[2016-04-01 20:10:53 IST] 0B deebucket/
[2016-03-28 21:53:49 IST] 0B guestbucket/
[2016-04-08 20:58:18 IST] 0B mybucket/
Command tree - List buckets and directories in a tree format
트리 명령 - 버킷 및 디렉터리를 트리 형식으로 나열합니다
tree command lists buckets and directories in a tree format. Use --files flag to include files/objects in listing.
tree 명령은 버킷과 디렉토리를 트리 형식으로 나열합니다. 목록에 파일/개체를 포함하려면 --files 플래그를 사용하십시오.
USAGE:
용법:
mc tree [FLAGS] TARGET [TARGET ...]
FLAGS:
플래그:
--help, -h show help
--help, -h 도움말을 표시합니다
--files, -f include files in tree
--files, -f 트리에 파일을 포함합니다
--depth, -d set the maximum depth of the tree
--depth, -d 트리의 최대 깊이를 설정합니다
Example: List all buckets on play/test-bucket in a tree format.
예: 플레이/테스트 버킷의 모든 버킷을 트리 형식으로 나열합니다.
mc tree play/test-bucket
play/test-bucket/
├─ dir_a
├─ dir_b
│ └─ dir_bb
└─ dir_x
└─ dir_xx
Command mb - Make a Bucket
mb 명령 - 버킷을 만듭니다
mb command creates a new bucket on an object storage. On a filesystem, it behaves like mkdir -p command.
mb 명령은 객체 스토리지에 새 버킷을 생성합니다. 파일 시스템에서는 mkdir -p 명령처럼 동작합니다.
Bucket is equivalent of a drive or mount point in filesystems and should not be treated as folders. MinIO does not place any limits on the number of buckets created per user.
버킷은 파일 시스템의 드라이브 또는 마운트 지점과 동일하며 폴더로 취급되어서는 안 됩니다. MinIO는 사용자당 생성되는 버킷 수에 제한을 두지 않습니다.
On Amazon S3, each account is limited to 100 buckets. Please refer to Buckets Restrictions and Limitations on S3 for more information.
Amazon S3에서는 각 계정이 100개의 버킷으로 제한됩니다. 자세한 내용은 S3의 버킷 제한 사항을 참조하세요.
USAGE:
용법:
mc mb [FLAGS] TARGET [TARGET...]
FLAGS:
플래그:
--region value specify bucket region; defaults to 'us-east-1' (default: "us-east-1")
--region 값 버킷 지역을 지정합니다. 기본값은 'us-east-1'입니다 (기본값: "us-east-1")
--ignore-existing, -p ignore if bucket/directory already exists
--ignore-existing, -p 버킷/디렉토리가 이미 존재하는 경우 무시
--help, -h show help
--help, -h 도움말 표시
Example: Create a new bucket named "mybucket" on https://play.min.io.
예: https://play.min.io에서 "mybucket"이라는 새 버킷을 생성합니다.
mc mb play/mybucket
Bucket created successfully ‘play/mybucket’.
버킷이 'play/mybucket'을 성공적으로 생성했습니다.
Example: Create a new bucket named "mybucket" on https://s3.amazonaws.com.
예: https://s3.amazonaws.com에서 "mybucket"이라는 새 버킷을 생성합니다.
mc mb s3/mybucket --region=us-west-1
Bucket created successfully ‘s3/mybucket’.
버킷이 's3/mybucket'을 성공적으로 생성했습니다.
Command rb - Remove a Bucket
rb 명령 - 버킷 제거
rb command removes a bucket and all its contents on an object storage. On a filesystem, it behaves like rmdir command.
rb 명령은 객체 스토리지에서 버킷과 해당 콘텐츠를 모두 제거합니다. 파일 시스템에서는 rmdir 명령처럼 동작합니다.
Note that when a bucket is removed all policies associated with the bucket will also be removed. If you would like to just empty the objects in a bucket use rm command.
버킷이 제거되면 버킷과 연결된 모든 정책도 제거됩니다. 버킷의 객체를 비우려면 rm 명령을 사용하세요.
USAGE:
용법:
mc rb [FLAGS] TARGET [TARGET...]
FLAGS:
플래그:
--force allow a recursive remove operation
--force는 재귀적인 제거 작업을 허용합니다.
--dangerous allow site-wide removal of objects
--dangerous는 사이트 전체의 객체 제거를 허용합니다
--help, -h show help
--help, -h 도움말을 표시합니다
Example: Remove a bucket named "mybucket" on https://play.min.io.
예: https://play.min.io에서 "mybucket"이라는 버킷을 제거합니다.
mc rb play/mybucket --force
Bucket removed successfully ‘play/mybucket’.
버킷이 'play/mybucket'을 성공적으로 제거했습니다.
Command cat - Concatenate Objects
명령 cat - 객체 연결
cat command concatenates contents of a file or object to another. You may also use it to simply display the contents to stdout.
cat 명령은 파일 또는 객체의 내용을 다른 내용과 연결합니다. 간단히 표준 출력에 내용을 표시하는 데 사용할 수도 있습니다.
USAGE:
용법:
mc cat [FLAGS] SOURCE [SOURCE...]
FLAGS:
플래그:
--encrypt-key value encrypt/decrypt objects (using server-side encryption with customer provided keys)
--encrypt-key value는 객체 암호화/ 해독 (고객 제공 키로 서버 측 암호화 사용)
--help, -h show help
--help, -h 도움말 표시
ENVIRONMENT VARIABLES:
환경 변수:
MC_ENCRYPT_KEY: list of comma delimited prefix=secret values
MC_ENCRYPT_KEY: 쉼표로 구분된 접두사=비밀 값 목록
Example: Display the contents of a text file myobject.txt
예: 텍스트 파일 myobject.txt의 내용 표시
mc cat play/mybucket/myobject.txt
Hello MinIO!!
안녕하세요 MinIO!!
Example: Display the contents of a server encrypted object myencryptedobject.txt
예: 서버 암호화 객체 myencryptedobject.txt의 콘텐츠 표시
Copy
복사
mc cat --encrypt-key "play/mybucket=32byteslongsecretkeymustbegiven1" play/mybucket/myencryptedobject.txt
Hello MinIO!!
안녕하세요 MinIO!!
Example: Display the contents of a server encrypted object myencryptedobject.txt.
예: 서버 암호화 객체 myencryptedobject.txt의 콘텐츠를 표시합니다.
Pass base64 encoded string if encryption key contains non-printable character like tab
암호화 키에 탭과 같이 인쇄할 수 없는 문자가 포함된 경우 base64로 인코딩된 문자열을 전달합니다
mc cat --encrypt-key "play/mybucket=MzJieXRlc2xvbmdzZWNyZWFiY2RlZmcJZ2l2ZW5uMjE=" play/mybucket/myencryptedobject.txt
Hello MinIO!!
Command sql - Run sql queries on objects
sql 명령 - 객체에 대해 sql 쿼리를 실행합니다
sql run sql queries on objects.
sql은 객체에 대해 SQL 쿼리를 실행합니다.
USAGE:
용법:
mc sql [FLAGS] TARGET [TARGET...]
FLAGS:
플래그:
--query value, -e value sql query expression
--쿼리 값, -e 값 SQL 쿼리 표현식
--recursive, -r sql query recursively
--recursive, -r 재귀적으로 SQL 쿼리
--csv-input value csv input serialization option
--csv 입력 값 csv 입력 직렬화 옵션
--json-input value json input serialization option
--json 입력 값 json 입력 직렬화 옵션
--compression value input compression type
--압축 값 입력 압축 유형
--csv-output value csv output serialization option
--csv-output value는 csv 출력 직렬화 옵션
--json-output value json output serialization option
--json-output value는 json 출력 직렬화 옵션
--encrypt-key value encrypt/decrypt objects (using server-side encryption with customer provided keys)
--encrypt-key value는 객체 암호화/해독 (고객 제공 키로 서버 측 암호화 사용)
--help, -h show help
--help, -h 도움말 표시
ENVIRONMENT VARIABLES:
환경 변수:
MC_ENCRYPT_KEY: list of comma delimited prefix=secret values
MC_ENCRYPT_KEY: 쉼표로 구분된 접두사=비밀 값 목록
INPUT SERIALIZATION
입력 직렬화
--csv-input or --json-input can be used to specify input data format. Format is specified by a string with pattern "key=value,..." for valid key(s).
--csv-input 또는 --json-input을 사용하여 입력 데이터 형식을 지정할 수 있습니다. 형식은 유효한 키에 대해 "key=value,..." 패턴이 있는 문자열로 지정됩니다.
DATA FORMAT:
데이터 형식:
csv: Use --csv-input flag
Valid keys:
유효한 키:
RecordDelimiter (rd)
FieldDelimiter (fd)
QuoteChar (qc)
QuoteEscChar (qec)
FileHeader (fh)
Comments (cc)
QuotedRecordDelimiter (qrd)
json: Use --json-input flag
Valid keys:
유효한 키:
Type
유형
parquet: If object name ends in .parquet, this is automatically interpreted.
parquet: 객체 이름이 .parquet로 끝나면 자동으로 해석됩니다.
OUTPUT SERIALIZATION
출력 직렬화
--csv-output or --json-output can be used to specify output data format. Format is specified by a string with pattern "key=value,..." for valid key(s).
--csv-output 또는 --json-output을 사용하여 출력 데이터 형식을 지정할 수 있습니다. 형식은 유효한 키에 대해 "key=value,..." 패턴이 있는 문자열로 지정됩니다.
DATA FORMAT:
데이터 형식:
csv: Use --csv-output flag
Valid keys:
RecordDelimiter (rd)
FieldDelimiter (fd)
QuoteChar (qc)
QuoteEscChar (qec)
QuoteFields (qf)
json: Use --json-output flag
Valid keys:
RecordDelimiter (rd)
COMPRESSION TYPE
압축 유형
--compression specifies if the queried object is compressed. Valid values: NONE | GZIP | BZIP2
--compression(압축)은 쿼리된 객체가 압축되는지 여부를 지정합니다. 유효한 값: 없음 | GZIP | BZIP2
Example: Select all columns on a set of objects recursively on AWS S3
예: AWS S3에서 객체 세트의 모든 열을 재귀적으로 선택합니다
mc sql --recursive --query "select * from S3Object" s3/personalbucket/my-large-csvs/
Example: Run an aggregation query on an object on MinIO
예: MinIO의 객체에 대해 집계 쿼리를 실행합니다
mc sql --query "select count(s.power) from S3Object" myminio/iot-devices/power-ratio.csv
Example: Run an aggregation query on an encrypted object with customer provided keys
예: 고객이 제공한 키를 사용하여 암호화된 객체에 대해 집계 쿼리를 실행합니다
mc sql --encrypt-key "myminio/iot-devices=32byteslongsecretkeymustbegiven1" \
--query "select count(s.power) from S3Object" myminio/iot-devices/power-ratio-encrypted.csv
For more query examples refer to official AWS S3 documentation here
더 많은 쿼리 예제는 여기에서 공식 AWS S3 문서를 참조하세요
Command head - Display few lines of object
헤드 명령 - 객체의 몇 줄을 표시합니다
head display first 'n' lines of an object
head는 객체의 처음 'n'개 라인을 표시합니다
USAGE:
용법:
mc head [FLAGS] SOURCE [SOURCE...]
FLAGS:
플래그:
-n value, --lines value print the first 'n' lines (default: 10)
-n value, --lines value 처음 'n' 줄을 프린트합니다 (기본값: 10)
--encrypt-key value encrypt/decrypt objects (using server-side encryption with customer provided keys)
--encrypt-key value 객체 암호화/암호 해독 (고객 제공 키로 서버 측 암호화 사용)
--help, -h show help
--help, -h 도움말 표시
ENVIRONMENT VARIABLES:
환경 변수:
MC_ENCRYPT_KEY: list of comma delimited prefix=secret values
MC_ENCRYPT_KEY: 쉼표로 구분된 접두사=비밀 값 목록
Example: Display the first line of a text file myobject.txt
예: myobject.txt 텍스트 파일의 첫 번째 줄을 표시합니다
mc head -n 1 play/mybucket/myobject.txt
Hello!!
Example: Display the first line of a server encrypted object myencryptedobject.txt
예: 서버 암호화 객체 myencryptedobject.txt 의 첫 번째 줄 표시
mc head -n 1 --encrypt-key "play/mybucket=32byteslongsecretkeymustbegiven1" play/mybucket/myencryptedobject.txt
Hello!!
Command pipe - Pipe to Object
파이프 명령 - 객체에 대한 파이프
pipe command copies contents of stdin to a target. When no target is specified, it writes to stdout.
파이프 명령은 stdin의 내용을 대상에 복사합니다. 대상이 지정되지 않으면 stdout에 씁니다.
USAGE:
용법:
mc pipe [FLAGS] [TARGET]
FLAGS:
플래그:
--encrypt value encrypt objects (using server-side encryption with server managed keys)
--encrypt 값 객체 암호화 (서버 관리 키로 서버 측 암호화 사용)
--encrypt-key value encrypt/decrypt objects (using server-side encryption with customer provided keys)
--encrypt-key value 객체 암호화/해독 (고객 제공 키로 서버 측 암호화 사용)
--help, -h show help
--help, -h 도움말 표시
ENVIRONMENT VARIABLES:
환경 변수:
MC_ENCRYPT: list of comma delimited prefix values
MC_ENCRYPT: 쉼표로 구분된 접두사 값 목록
MC_ENCRYPT_KEY: list of comma delimited prefix=secret values
MC_ENCRYPT_KEY: 쉼표로 구분된 접두사=비밀 값 목록
Example: Stream MySQL database dump to Amazon S3 directly.
예: MySQL 데이터베이스 덤프를 Amazon S3로 직접 스트리밍합니다.
mysqldump -u root -p ******* accountsdb | mc pipe s3/sql-backups/backups/accountsdb-oct-9-2015.sql
Command cp - Copy Objects
cp 명령 - 객체 복사
cp command copies data from one or more sources to a target.
cp 명령은 하나 이상의 소스에서 대상으로 데이터를 복사합니다.
All copy operations to object storage are verified with MD5SUM checksums.
객체 스토리지에 대한 모든 복사 작업은 MD5SUM 체크섬으로 확인됩니다.
Interrupted or failed copy operations can be resumed from the point of failure.
중단되거나 실패한 복사 작업은 오류 지점부터 재개될 수 있습니다.
USAGE:
용법:
mc cp [FLAGS] SOURCE [SOURCE...] TARGET
FLAGS:
플래그:
--recursive, -r copy recursively
--recursive, -r 재귀적으로 복사합니다
--older-than value copy object(s) older than N days (default: 0)
--값 보다 오래된 N일 보다 오래된 객체를 복사합니다 (기본값: 0)
--newer-than value copy object(s) newer than N days (default: 0)
-- 값 보다 새로운 N일 보다 새로운 객체를 복사합니다 (기본값: 0)
--storage-class value, --sc value set storage class for new object(s) on target
--storage-class 값, --sc 값은 대상의 새 객체에 대한 스토리지 클래스를 설정합니다
--attr add custom metadata for the object (format: KeyName1=string;KeyName2=string)
--attr 객체에 대한 사용자 정의 메타데이터를 추가합니다 (형식: KeyName1=string;KeyName2=string)
--encrypt value encrypt/decrypt objects (using server-side encryption with server managed keys)
--encrypt value 객체 암호화/해독(서버 관리 키로 서버 측 암호화 사용)
--encrypt-key value encrypt/decrypt objects (using server-side encryption with customer provided keys)
--encrypt-key value 객체 암호화/해독 (고객 제공 키로 서버 측 암호화 사용)
--help, -h show help
--help, -h 도움말 표시
ENVIRONMENT VARIABLES:
환경 변수:
MC_ENCRYPT: list of comma delimited prefixes
MC_ENCRYPT: 쉼표로 구분된 접두사 목록
MC_ENCRYPT_KEY: list of comma delimited prefix=secret values
MC_ENCRYPT_KEY: 쉼표로 구분된 접두사=비밀 값 목록
Example: Copy a text file to an object storage.
예: 텍스트 파일을 객체 스토리지에 복사합니다.
mc cp myobject.txt play/mybucket
myobject.txt: 14 B / 14 B ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 100.00 % 41 B/s 0
Example: Copy a text file to an object storage with specified metadata.
예: 지정된 메타데이터를 사용하여 텍스트 파일을 객체 스토리지에 복사합니다.
mc cp --attr key1=value1;key2=value2 myobject.txt play/mybucket
myobject.txt: 14 B / 14 B ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 100.00 % 41 B/s 0
Example: Copy a folder recursively from MinIO cloud storage to Amazon S3 cloud storage with specified metadata.
예: 지정된 메타데이터를 사용하여 폴더를 MinIO 클라우드 스토리지에서 Amazon S3 클라우드 스토리지로 폴더를 반복적으로 복사합니다.
mc cp --attr Cache-Control=max-age=90000,min-fresh=9000\;key1=value1\;key2=value2 --recursive play/mybucket/burningman2011/ s3/mybucket/
https://play.minio.io:9000/mybucket/myobject.txt: 14 B / 14 B ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 100.00 % 41 B/s 0
Example: Copy a text file to an object storage and assign storage-class REDUCED_REDUNDANCY to the uploaded object.
예: 텍스트 파일을 객체 스토리지에 복사하고 업로드된 객체에 스토리지 클래스 REDUCED_REDUNDANCY를 할당합니다.
mc cp --storage-class REDUCED_REDUNDANCY myobject.txt play/mybucket
myobject.txt: 14 B / 14 B ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 100.00 % 41 B/s 0
Example: Copy a server-side encrypted file to an object storage.
예: 서버측 암호화 파일을 객체 스토리지에 복사합니다.
mc cp --recursive --encrypt-key "s3/documents/=32byteslongsecretkeymustbegiven1 , myminio/documents/=32byteslongsecretkeymustbegiven2" s3/documents/myobject.txt myminio/documents/
myobject.txt: 14 B / 14 B ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 100.00 % 41 B/s 0
Example: Perform key-rotation on a server-side encrypted object
예: 서버측 암호화된 객체에서 키 순환을 수행합니다
mc cp --encrypt-key 'myminio1/mybucket=32byteslongsecretkeymustgenerate , myminio2/mybucket/=32byteslongsecretkeymustgenerat1' myminio1/mybucket/encryptedobject myminio2/mybucket/encryptedobject
encryptedobject: 14 B / 14 B ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 100.00 % 41 B/s 0
Notice that two different aliases myminio1 and myminio2 are used for the same endpoint to provide the old secretkey and the newly rotated key.
두 개의 서로 다른 별칭 myminio1 및 myminio2가 동일한 엔드포인트에 사용되어 이전 비밀 키와 새로 교체된 키를 제공합니다.
Example: Copy a javascript file to object storage and assign Cache-Control header to the uploaded object.
예: 자바스크립트 파일을 객체 스토리지에 복사하고 업로드된 객체에 Cache-Control 헤더를 할당합니다.
mc cp --attr Cache-Control=no-cache myscript.js play/mybucket
myscript.js: 14 B / 14 B ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 100.00 % 41 B/s 0
Command rm - Remove Objects
rm 명령 - 객체 제거
Use rm command to remove file or object
rm 명령을 사용하여 파일 또는 객체를 제거합니다
USAGE:
용법:
mc rm [FLAGS] TARGET [TARGET ...]
FLAGS:
플래그:
--recursive, -r remove recursively
--recursive, -r 재귀적으로 제거합니다
--force allow a recursive remove operation
--force는 재귀적인 제거 작업을 허용합니다
--dangerous allow site-wide removal of objects
--dangerous는 사이트 전체의 객체 제거를 허용합니다
--incomplete, -I remove incomplete uploads
--incomplete, -I 완료되지 않은 업로드를 제거합니다
--fake perform a fake remove operation
--fake 가짜 제거 작업을 수행합니다
--stdin read object names from STDIN
--stdin STDIN에서 객체 이름을 읽습니다
--older-than value remove objects older than L days, M hours and N minutes LMN[d|h|m]. (default: 0)
--값보다 오래된 L일, M시간, N분 LMN[d|h|m]보다 오래된 개체를 제거합니다. (기본값: 0)
--newer-than value remove objects newer than L days, M hours and N minutes LMN[d|h|m]. (default: 0)
--값보다 새로운 L일, M시간, N분 LMN[d|h|m]보다 최신인 객체를 제거합니다. (기본값: 0)
--encrypt-key value encrypt/decrypt objects (using server-side encryption with customer provided keys)
--encrypt-key value 객체 암호화/해독 (고객 제공 키로 서버 측 암호화 사용)
--help, -h show help
--help, -h 도움말 표시
ENVIRONMENT VARIABLES:
환경 변수:
MC_ENCRYPT_KEY: list of comma delimited prefix=secret values
MC_ENCRYPT_KEY: 쉼표로 구분된 접두사=비밀 값 목록
Example: Remove a single object.
예: 단일 객체를 제거합니다.
mc rm play/mybucket/myobject.txt
Removing `play/mybucket/myobject.txt`.
Example: Remove an encrypted object.
예: 암호화된 객체를 제거합니다.
mc rm --encrypt-key "play/mybucket=32byteslongsecretkeymustbegiven1" play/mybucket/myobject.txt
Removing `play/mybucket/myobject.txt`.
Example: Recursively remove a bucket's contents. Since this is a dangerous operation, you must explicitly pass --force option.
예: 버킷의 콘텐츠를 반복적으로 제거합니다. 이는 위험한 작업이므로 --force 옵션을 명시적으로 전달해야 합니다.
mc rm --recursive --force play/mybucket
Removing `play/mybucket/newfile.txt`.
`play/mybucket/newfile.txt`를 제거합니다.
Removing `play/mybucket/otherobject.txt`.
`play/mybucket/otherobject.txt`를 제거합니다.
Example: Remove all uploaded incomplete files for an object.
예: 객체에 대해 업로드된 불완전한 파일을 모두 제거합니다.
mc rm --incomplete play/mybucket/myobject.1gig
Removing `play/mybucket/myobject.1gig`.
`play/mybucket/myobject.1gig`를 제거합니다.
Example: Remove object and output a message only if the object is created older than 1 day, 2 hours and 30 minutes. Otherwise, the command stays quiet and nothing is printed out.
예: 객체를 제거하고 객체가 생성된 지 1일 2시간 30분이 지난 경우에만 메시지를 출력합니다. 그렇지 않으면 명령이 조용하게 유지되고 아무것도 인쇄되지 않습니다.
mc rm -r --force --older-than 1d2h30m myminio/mybucket
Removing `myminio/mybucket/dayOld1.txt`.
Removing `myminio/mybucket/dayOld2.txt`.
Removing `myminio/mybucket/dayOld3.txt`.
Command share - Share Access
명령 공유 - 액세스 공유
share command securely grants upload or download access to object storage.
share 명령은 객체 스토리지에 대한 업로드 또는 다운로드 액세스 권한을 안전하게 부여합니다.
This access is only temporary and it is safe to share with remote users and applications.
이 액세스는 일시적일 뿐이므로 원격 사용자 및 애플리케이션과 공유해도 안전합니다.
If you want to grant permanent access, you may look at mc policy command instead. Generated URL has access credentials encoded in it.
영구 액세스 권한을 부여하려면 대신 mc 정책 명령을 살펴보세요. 생성된 URL에는 인코딩된 액세스 자격 증명이 있습니다.
Any attempt to tamper the URL will invalidate the access. To understand how this mechanism works, please follow Pre-Signed URL technique.
URL을 변경하려고 시도하면 액세스가 무효화됩니다. 이 메커니즘이 어떻게 작동하는지 이해하려면 미리 서명된 URL 기술을 따르십시오.
USAGE:
용법:
mc share [FLAGS] COMMAND
FLAGS:
플래그:
--help, -h show help
--help, -h 도움말을 표시합니다
COMMANDS:
명령:
download generate URLs for download access
download 다운로드 액세스를 위한 URL을 생성합니다
upload generate ‘curl’ command to upload objects without requiring access/secret keys
upload access/secret 키 없이 객체를 업로드업로드하는 'curl' 명령을 생성합니다
list list previously shared objects and folders
list 이전에 공유한 객체 및 폴더 목록입니다
Sub-command share download - Share Download
하위 명령 share upload - 다운로드를 공유합니다
share download command generates URLs to download objects without requiring access and secret keys.
share download 명령은 액세스 및 비밀 키 없이 객체를 다운로드할 수 있는 URL을 생성합니다.
Expiry option sets the maximum validity period (no more than 7 days), beyond which the access is revoked automatically.
만료 옵션은 최대 유효 기간 (7일 이내)을 설정하며 그 이후에는 액세스가 자동으로 취소됩니다.
USAGE:
용법:
mc share download [FLAGS] TARGET [TARGET...]
FLAGS:
플래그:
--recursive, -r share all objects recursively
--recursive, -r 모든 객체를 재귀적으로 공유합니다
--expire value, -E value set expiry in NN[h|m|s] (default: "168h")
--expire 값, -E 값 NN [h|m|s]에 만료 기간을 설정합니다 (기본값: "168h")
--help, -h show help
--help, -h 도움말을 표시합니다
Example: Grant temporary access to an object with 4 hours expiry limit.
예: 만료 제한이 4시간인 객체에 대한 임시 액세스 권한을 부여합니다.
mc share download --expire 4h play/mybucket/myobject.txt
URL: https://play.min.io/mybucket/myobject.txt
Expire: 0 days 4 hours 0 minutes 0 seconds
만료: 0 일 4 시간 0 분 0 초
Share:
공유합니다:
https://play.min.io/mybucket/myobject.txt?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=Q3AM3UQ867SPQQA43P2F%2F20160408%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20160408T182008Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=1527fc8f21a3a7e39ce3c456907a10b389125047adc552bcd86630b9d459b634
Sub-command share upload - Share Upload
서브 명령 share upload - 업로드를 공유합니다
share upload command generates a ‘curl’ command to upload objects without requiring access/secret keys.
share upload 명령은 액세스/비밀 키 없이 객체를 업로드하는 'curl' 명령을 생성합니다.
Expiry option sets the maximum validity period (no more than 7 days), beyond which the access is revoked automatically. Content-type option restricts uploads to only certain type of files.
만료 옵션은 최대 유효 기간 (7일 이내)을 설정하며 그 이후에는 액세스가 자동으로 취소됩니다. 콘텐츠 유형 옵션은 업로드를 특정 유형의 파일로만 업로드를 제한합니다.
USAGE:
용법:
mc share upload [FLAGS] TARGET [TARGET...]
FLAGS:
플래그:
--recursive, -r recursively upload any object matching the prefix
--recursive, -r 접두사와 일치하는 모든 객체를 재귀적으로 업로드합니다
--expire value, -E value set expiry in NN[h|m|s] (default: "168h")
--expire 값, -E 값 NN[h|m|s]에 만료를 설정합니다 (기본값: "168h")
--content-type value, -T value specify a content-type to allow
--content-type value, -T 값 허용할 콘텐츠 유형을 지정합니다
--help, -h show help
--help, -h 도움말을 표시합니다
Example: Generate a curl command to enable upload access to play/mybucket/myotherobject.txt. User replaces
예: play/mybucket/myotherobject.txt에 대한 업로드 액세스를 활성화하는 컬 명령을 생성합니다. 사용자는
mc share upload play/mybucket/myotherobject.txt
URL: https://play.min.io/mybucket/myotherobject.txt
Expire: 7 days 0 hours 0 minutes 0 seconds
Share: curl https://play.min.io/mybucket -F x-amz-date=20160408T182356Z -F x-amz-signature=de343934bd0ba38bda0903813b5738f23dde67b4065ea2ec2e4e52f6389e51e1 -F bucket=mybucket -F policy=eyJleHBpcmF0aW9uIjoiMjAxNi0wNC0xNVQxODoyMzo1NS4wMDdaIiwiY29uZGl0aW9ucyI6W1siZXEiLCIkYnVja2V0IiwibXlidWNrZXQiXSxbImVxIiwiJGtleSIsIm15b3RoZXJvYmplY3QudHh0Il0sWyJlcSIsIiR4LWFtei1kYXRlIiwiMjAxNjA0MDhUMTgyMzU2WiJdLFsiZXEiLCIkeC1hbXotYWxnb3JpdGhtIiwiQVdTNC1ITUFDLVNIQTI1NiJdLFsiZXEiLCIkeC1hbXotY3JlZGVudGlhbCIsIlEzQU0zVVE4NjdTUFFRQTQzUDJGLzIwMTYwNDA4L3VzLWVhc3QtMS9zMy9hd3M0X3JlcXVlc3QiXV19 -F x-amz-algorithm=AWS4-HMAC-SHA256 -F x-amz-credential=Q3AM3UQ867SPQQA43P2F/20160408/us-east-1/s3/aws4_request -F key=myotherobject.txt -F file=@
Sub-command share list - Share List
서브 명령 share list - 목록을 공유합니다
share list command lists unexpired URLs that were previously shared
share list 명령은 이전에 공유된 만료되지 않은 URL을 나열합니다.
USAGE:
용법:
mc share list COMMAND
COMMAND:
명령:
upload: list previously shared access to uploads.
업로드: 업로드에 대해 이전에 공유된 액세스 권한을 나열합니다.
download: list previously shared access to downloads.
다운로드: 다운로드에 대한 이전에 공유된 액세스를 나열합니다.
Command mirror - Mirror Buckets
mirror 명령 - 버킷을 미러링합니다
mirror command is similar to rsync, except it synchronizes contents between filesystems and object storage.
mirror 명령은 파일 시스템과 객체 스토리지 간의 내용을 동기화한다는 점을 제외하면 rsync와 유사합니다.
USAGE:
용법:
mc mirror [FLAGS] SOURCE TARGET
FLAGS:
플래그:
--overwrite overwrite object(s) on target
--overwrite 대상의 객체를 덮어씁니다
--fake perform a fake mirror operation
--fake 가짜 미러 작업을 수행합니다
--watch, -w watch and synchronize changes
--watch, -w 변경 사항 감시 및 동기화
--remove remove extraneous object(s) on target
--remove 대상에서 불필요한 객체를 제거합니다
--region value specify region when creating new bucket(s) on target (default: "us-east-1")
--region 값 대상에 새 버킷을 생성할 때 영역을 지정합니다 (기본값: "us-east-1")
-a preserve bucket policy rules on target bucket(s)
-a 대상 버킷의 버킷 정책 규칙을 보존합니다
--exclude value exclude object(s) that match specified object name pattern
--exclude 값 지정된 객체 이름 패턴과 일치하는 객체를 제외합니다
--older-than value filter object(s) older than N days (default: 0)
--값 보다 오래된 N일보다 오래된 객체를 필터링합니다 (기본값: 0)
--newer-than value filter object(s) newer than N days (default: 0)
--값 보다 새로운 N일보다 새로운 객체를 필터링합니다 (기본값: 0)
--storage-class value, --sc value specify storage class for new object(s) on target
--storage-class 값, --sc 값 대상의 새 객체에 대한 스토리지 클래스를 지정합니다
--encrypt value encrypt/decrypt objects (using server-side encryption with server managed keys)
--암호화 값 객체 암호화/해독 (서버 관리 키로 서버측 암호화 사용)
--encrypt-key value encrypt/decrypt objects (using server-side encryption with customer provided keys)
--encrypt-key value 객체 암호화/해독 (고객 제공 키로 서버측 암호화 사용)
--help, -h show help
--help, -h 도움말을 표시합니다
ENVIRONMENT VARIABLES:
환경 변수:
MC_ENCRYPT: list of comma delimited prefixes
MC_ENCRYPT: 쉼표로 구분된 접두사 목록
MC_ENCRYPT_KEY: list of comma delimited prefix=secret values
MC_ENCRYPT_KEY: 쉼표로 구분된 접두사=비밀 값 목록
Example: Mirror a local directory to 'mybucket' on https://play.min.io.
예: https://play.min.io의 'mybucket'에 로컬 디렉터리를 미러링합니다.
mc mirror localdir/ play/mybucket
localdir/b.txt: 40 B / 40 B ┃▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓┃ 100.00 % 73 B/s 0
Example: Continuously watch for changes on a local directory and mirror the changes to 'mybucket' on https://play.min.io.
예: 로컬 디렉토리의 변경 사항을 지속적으로 관찰하고 변경 사항을 https://play.min.io의 'mybucket'에 미러링합니다.
mc mirror -w localdir play/mybucket
localdir/new.txt: 10 MB / 10 MB ┃▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓┃ 100.00 % 1 MB/s 15s
Command find - Find files and objects
find 명령 - 파일 및 객체를 찾습니다
find command finds files which match the given set of parameters. It only lists the contents which match the given set of criteria.
find 명령은 주어진 매개변수 세트와 일치하는 파일을 찾습니다. 주어진 기준 세트와 일치하는 내용만 나열합니다.
USAGE:
용법:
mc find PATH [FLAGS]
FLAGS:
플래그:
--exec value spawn an external process for each matching object (see FORMAT)
--exec value는 일치하는 각 객체에 대해 외부 프로세스를 생성합니다 (FORMAT 참조).
--ignore value exclude objects matching the wildcard pattern
--ignore 값은 와일드카드 패턴과 일치하는 객체를 제외합니다.
--name value find object names matching wildcard pattern
--name 값은 와일드카드 패턴과 일치하는 객체 이름을 찾습니다.
--newer value match all objects newer than specified time L days, M hours and N minutes
--newer value 지정된 시간 L일, M시간 및 N분보다 최신인 모든 객체와 일치합니다
--older value match all objects older than specified time L days, M hours and N minutes
--older value 지정된 시간 L일, M시간 및 N분 보다 오래된 모든 객체와 일치합니다
--path value match directory names matching wildcard pattern
--path 값 와일드카드 패턴과 일치하는 디렉토리 이름과 일치합니다.
--print value print in custom format to STDOUT (see FORMAT)
--print 값 사용자 정의 형식으로 STDOUT으로 인쇄됩니다(FORMAT 참조)
--regex value match directory and object name with PCRE regex pattern
--regex 값 PCRE 정규식 패턴으로 디렉토리 및 객체 이름을 일치시킵니다
--larger value match all objects larger than specified size in units (see UNITS)
--larger value 단위로 지정된 크기보다 큰 모든 객체와 일치합니다 (UNITS 참조).
--smaller value match all objects smaller than specified size in units (see UNITS)
--smaller value 단위로 지정된 크기보다 작은 모든 객체와 일치합니다 (단위 참조)
--maxdepth value limit directory navigation to specified depth (default: 1)
--maxdepth value 지정된 깊이로 디렉터리 탐색을 제한합니다 (기본값: 1)
--watch monitor a specified path for newly created object(s)
--watch 새로 생성된 객체에 대해 지정된 경로를 모니터링합니다.
...
...
--help, -h show help
--help, -h 도움말을 표시합니다
Example: Find all jpeg images from s3 bucket and copy to MinIO "play/bucket" bucket continuously.
예: s3 버킷에서 모든 jpeg 이미지를 찾아 MinIO "재생/버킷" 버킷에 지속적으로 복사합니다.
mc find s3/bucket --name "*.jpg" --watch --exec "mc cp {} play/bucket"
Command diff - Show Difference
diff 명령 - 차이점을 표시합니다
diff command computes the differences between the two directories. It only lists the contents which are missing or which differ in size.
diff 명령은 두 디렉토리 간의 차이를 계산합니다. 누락되었거나 크기가 다른 내용만 나열합니다.
It DOES NOT compare the contents, so it is possible that the objects which are of same name and of the same size, but have difference in contents are not detected.
내용을 비교하지 않으므로 이름, 크기가 동일하지만 내용에 차이가 있는 객체는 감지되지 않을 수 있습니다.
This way, it can perform high speed comparison on large volumes or between sites.
이를 통해 대용량 또는 사이트 간 고속 비교가 가능합니다.
USAGE:
용법:
mc diff [FLAGS] FIRST SECOND
FLAGS:
플래그:
--config-folder value, -C value Path to configuration folder. (default: "/root/.mc")
--config-folder 값, -C 값 구성 폴더의 경로입니다. (기본값: "/root/.mc")
--quiet, -q Disable progress bar display.
--quiet, -q 진행률 표시줄 표시를 비활성화합니다.
--no-color Disable color theme.
--no-color 색상 테마를 비활성화합니다.
--json Enable JSON formatted output.
--json JSON 형식의 출력을 활성화합니다.
--debug Enable debug output.
--debug 디버그 출력을 활성화합니다.
--insecure Disable SSL certificate verification.
--insecure SSL 인증서 확인을 비활성화합니다.
--help, -h Show help.
--help, -h 도움말을 표시합니다.
LEGEND:
레전드:
< - object is only in source.
< - 객체가 소스에만 있습니다.
> - object is only in destination.
> - 객체가 대상에만 있습니다.
! - newer object is in source.
! - 소스에 최신 개체가 있습니다.
Example: Compare a local directory and a remote object storage.
예: 로컬 디렉토리와 원격 객체 저장소를 비교합니다.
mc diff localdir play/mybucket
‘localdir/notes.txt’ and ‘https://play.min.io/mybucket/notes.txt’ - only in first.
Option [--json]
옵션 [--json]
JSON option enables parseable output in JSON lines format.
JSON 옵션을 사용하면 JSON 라인 형식으로 구문 분석 가능한 출력이 가능합니다.
Example: diff json output.
예: diff json 출력
mc diff minio1/diffbucket minio2/diffbucket --json
{"status":"success","first":"","second":"http://127.0.0.1:9001/diffbucket/file1.png","diff":5}
{"status":"success","first":"http://127.0.0.1:9000/diffbucket/file2.png","second":"","diff":4}
{"status":"success","first":"http://127.0.0.1:9000/diffbucket/file3.png","second":"http://127.0.0.1:9001/diffbucket/file3.png","diff":2}
{"status":"success","first":"http://127.0.0.1:9000/diffbucket/file4.png","second":"http://127.0.0.1:9001/diffbucket/file4.png","diff":1}
Diff values in json output
JSON 출력의 차이 값
Constant
Value
Meaning
differInNone
0
Does not differ
differInSize
1
Differs in size
differInTime
2
Differs in time
differInType
3
Differs in type exfile/directory
differInFirst
4
Only in source (FIRST)
differInSecond
5
Only in target (SECOND)
Command watch - Watch for files and object storage events.
watch 명령 - 파일 및 객체 스토리지 이벤트를 감시합니다.
watch provides a convenient way to watch on various types of event notifications on object storage and filesystem.
watch는 객체 스토리지 및 파일 시스템에 대한 다양한 유형의 이벤트 알림을 감시하는 편리한 방법을 제공합니다.
USAGE:
용법:
mc watch [FLAGS] PATH
FLAGS:
플래그:
--events value filter specific types of events, defaults to all events (default: "put,delete,get")
--events value 특정 유형의 이벤트를 필터링하며 모든 이벤트입니다 (기본값: "put,delete,get")
--prefix value filter events for a prefix
--prefix value 접두사에 대한 이벤트를 필터링합니다
--suffix value filter events for a suffix
-- 접미사 값 접미어에 대한 이벤트를 필터링합니다
--recursive recursively watch for events
--recursive 재귀적으로 이벤트를 감시합니다
--help, -h show help
--help, -h 도움말을 표시합니다
Example: Watch for all events on object storage
예: 객체 스토리지의 모든 이벤트를 감시합니다
mc watch play/testbucket
[2016-08-18T00:51:29.735Z] 2.7KiB ObjectCreated https://play.min.io/testbucket/CONTRIBUTING.md
[2016-08-18T00:51:29.780Z] 1009B ObjectCreated https://play.min.io/testbucket/MAINTAINERS.md
[2016-08-18T00:51:29.839Z] 6.9KiB ObjectCreated https://play.min.io/testbucket/README.md
Example: Watch for all events on local directory
예: 로컬 디렉토리의 모든 이벤트를 감시합니다
mc watch ~/Photos
[2016-08-17T17:54:19.565Z] 3.7MiB ObjectCreated /home/minio/Downloads/tmp/5467026530_a8611b53f9_o.jpg
[2016-08-17T17:54:19.565Z] 3.7MiB ObjectCreated /home/minio/Downloads/tmp/5467026530_a8611b53f9_o.jpg
...
[2016-08-17T17:54:19.565Z] 7.5MiB ObjectCreated /home/minio/Downloads/tmp/8771468997_89b762d104_o.jpg
Command event - Manage bucket event notification.
event 명령 - 버킷 이벤트 알림을 관리합니다.
event provides a convenient way to configure various types of event notifications on a bucket.
이벤트는 버킷에 대한 다양한 유형의 이벤트 알림을 구성하는 편리한 방법을 제공합니다.
MinIO event notification can be configured to use AMQP, Redis, ElasticSearch, NATS and PostgreSQL services.
AMQP, Redis, ElasticSearch, NATS 및 PostgreSQL 서비스를 사용하도록 MinIO 이벤트 알림을 구성할 수 있습니다.
MinIO configuration provides more details on how these services can be configured.
MinIO 구성은 이러한 서비스를 구성하는 방법에 대한 자세한 내용을 제공합니다.
USAGE:
용법:
mc event COMMAND [COMMAND FLAGS | -h] [ARGUMENTS...]
COMMANDS:
명령:
add add a new bucket notification
add 새 버킷 알림을 추가합니다
remove remove a bucket notification. With '--force' can remove all bucket notifications
remove 버킷 알림을 제거합니다. '--force'를 사용하면 모든 버킷 알림을 제거할 수 있습니다
list list bucket notifications
list 버킷 알림 리스트
FLAGS:
플래그:
--ignore-existing, -p ignore if event already exists
--ignore-existing, -p 이벤트가 이미 존재한다면 무시합니다
--help, -h show help
--help, -h 도움말을 표시합니다
Example: List all configured bucket notifications
예: 구성된 모든 버킷 알림을 나열합니다
mc event list play/andoria
MyTopic arn:minio:sns:us-east-1:1:TestTopic s3:ObjectCreated:*,s3:ObjectRemoved:* suffix:.jpg
Example: Add a new 'sqs' notification resource only to notify on ObjectCreated event
예: ObjectCreated 이벤트에 대해서만 알리기 위해 새 'sqs' 알림 리소스를 추가합니다
mc event add play/andoria arn:minio:sqs:us-east-1:1:your-queue --event put
Example: Add a new 'sqs' notification resource with filters
예: 필터를 사용하여 새 'sqs' 알림 리소스를 추가합니다
Add prefix and suffix filtering rules for sqs notification resource.
sqs 알림 리소스에 대한 접두사 및 접미사 필터링 규칙을 추가합니다.
mc event add play/andoria arn:minio:sqs:us-east-1:1:your-queue --prefix photos/ --suffix .jpg
Example: Remove a 'sqs' notification resource
예: 'sqs' 알림 리소스를 제거합니다
mc event remove play/andoria arn:minio:sqs:us-east-1:1:your-queue
Command policy - Manage bucket policies
policy 명령 - 버킷 정책을 관리합니다
Manage anonymous bucket policies to a bucket and its contents
버킷 및 해당 콘텐츠에 대한 익명 버킷 정책을 관리합니다
USAGE:
용법:
mc policy [FLAGS] set PERMISSION TARGET
mc policy [FLAGS] set-json FILE TARGET
mc policy [FLAGS] get TARGET
mc policy [FLAGS] get-json TARGET
mc policy list [FLAGS] TARGET
PERMISSION:
허가:
Allowed policies are: [none, download, upload, public].
허용되는 정책은 [없음, 다운로드, 업로드, 공개]입니다.
FILE:
파일:
A valid S3 policy JSON filepath.
유효한 S3 정책 JSON 파일 경로입니다.
FLAGS:
플래그:
--help, -h show help
--help, -h 도움말을 표시합니다
Example: Show current anonymous bucket policy
예: 현재 익명 버킷 정책을 표시합니다
Show current anonymous bucket policy for mybucket/myphotos/2020/ sub-directory
mybucket/myphotos/2020/ 서브 디렉토리에 대한 현재 익명 버킷 정책을 표시합니다
mc policy get play/mybucket/myphotos/2020/
Access permission for ‘play/mybucket/myphotos/2020/’ is ‘none’
‘play/mybucket/myphotos/2020/’에 대한 접근 권한이 ‘없음’입니다.
Example : Set anonymous bucket policy to download only
예: 다운로드만 가능하도록 익명 버킷 정책을 설정합니다
Set anonymous bucket policy for mybucket/myphotos/2020/ sub-directory and its objects to download only.
mybucket/myphotos/2020/ 하위 디렉토리와 해당 객체에 대한 익명 버킷 정책을 다운로드 전용으로 설정합니다.
Now, objects under the sub-directory are publicly accessible. e.g mybucket/myphotos/2020/yourobjectnameis available at https://play.min.io:9000/mybucket/myphotos/2020/yourobjectname
이제 하위 디렉토리 아래의 객체에 공개적으로 액세스할 수 있습니다. 예: mybucket/myphotos/2020/yourobjectname은 https://play.min.io:9000/mybucket/myphotos/2020/yourobjectname에서 확인할 수 있습니다.
mc policy set download play/mybucket/myphotos/2020/
Access permission for ‘play/mybucket/myphotos/2020/’ is set to 'download'
‘play/mybucket/myphotos/2020/’에 대한 접근 권한이 '다운로드'로 설정되어 있습니다.
Example : Set anonymous bucket policy from a JSON file
예: JSON 파일에서 익명 버킷 정책 설정
Configure bucket policy for mybucket with a policy JSON file.
정책 JSON 파일을 사용하여 mybucket에 대한 버킷 정책을 구성합니다.
mc policy set-json /tmp/policy.json play/mybucket
Access permission for `play/mybucket` is set from `/tmp/policy.json`
`play/mybucket`에 대한 액세스 권한은 `/tmp/policy.json`에서 설정됩니다.
Example : Remove current anonymous bucket policy
예: 현재 익명 버킷 정책 제거
Remove any bucket policy for mybucket/myphotos/2020/ sub-directory.
mybucket/myphotos/2020/ 하위 디렉터리에 대한 버킷 정책을 제거합니다.
mc policy set none play/mybucket/myphotos/2020/
Access permission for ‘play/mybucket/myphotos/2020/’ is set to 'none'
'play/mybucket/myphotos/2020/'에 대한 액세스 권한이 '없음'으로 설정되어 있습니다.
Command admin - Manage MinIO servers
관리자 명령 - MinIO 서버 관리
Please visit here for a more comprehensive admin guide.
보다 포괄적인 관리 가이드를 보려면 여기를 방문하세요.
Command session - Manage Sessions
session 명령 - 세션 관리
session command manages previously saved sessions for cp and mirror operations
session 명령은 cp 및 미러 작업을 위해 이전에 저장된 세션을 관리합니다
USAGE:
용법:
mc session COMMAND [COMMAND FLAGS | -h] [ARGUMENTS...]
COMMANDS:
명령:
list list all previously saved sessions
list 이전에 저장된 모든 세션 목록
clear clear a previously saved session
clear 이전에 저장된 세션 지우기
resume resume a previously saved session
resume 이전에 저장된 세션 재개
FLAGS:
플래그:
--help, -h show help
--help, -h 도움말 표시
Example: List all previously saved sessions.
예: 이전에 저장된 모든 세션을 나열합니다.
mc session list
IXWKjpQM -> [2016-04-08 19:11:14 IST] cp assets.go play/mybucket
ApwAxSwa -> [2016-04-08 01:49:19 IST] mirror miniodoc/ play/mybucket
Example: Resume a previously saved session.
예: 이전에 저장한 세션을 재개합니다.
mc session resume IXWKjpQM
...assets.go: 1.68 KB / 1.68 KB ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 100.00 % 784 B/s 2s
Example: Drop a previously saved session.
예: 이전에 저장한 세션을 삭제합니다.
mc session clear ApwAxSwa
Session ‘ApwAxSwa’ cleared successfully.
세션 'ApwAxSwa'가 성공적으로 지워졌습니다.
Command config - Manage Config File
config 명령 - 구성 파일 관리
config host command provides a convenient way to manage host entries in your config file ~/.mc/config.json. It is also OK to edit the config file manually using a text editor.
config host 명령은 구성 파일 ~/.mc/config.json의 호스트 항목을 관리하는 편리한 방법을 제공합니다. 텍스트 편집기를 사용하여 구성 파일을 수동으로 편집하는 것도 괜찮습니다.
USAGE:
용법:
mc config host COMMAND [COMMAND FLAGS | -h] [ARGUMENTS...]
COMMANDS:
명령:
add, a add a new host to configuration file
add, a 구성 파일에 새 호스트를 추가합니다
remove, rm remove a host from configuration file
remove, rm 구성 파일에서 호스트를 제거합니다
list, ls lists hosts in configuration file
list, ls 구성 파일의 호스트를 나열합니다.
FLAGS:
플래그:
--help, -h show help
--help, -h 도움말을 표시합니다
Example: Manage Config File
예: 구성 파일 관리
Add MinIO server access and secret keys to config file host entry.
구성 파일 호스트 항목에 MinIO 서버 액세스 및 비밀 키를 추가합니다.
Note that, the history feature of your shell may record these keys and pose a security risk.
쉘의 히스토리 기능은 이러한 키를 기록하여 보안 위험을 초래할 수 있습니다.
On bash shell, use set -o and set +o to disable and enable history feature momentarily.
bash 쉘에서는 set -o 및 set +o를 사용하여 기록 기능을 일시적으로 비활성화하거나 활성화합니다.
set +o history
mc config host add myminio http://localhost:9000 OMQAGGOL63D7UNVQFY8X GcY5RHNmnEWvD/1QxD3spEIGj+Vt9L7eHaAaBTkJ
set -o history
Remove the host from the config file.
구성 파일에서 호스트를 제거합니다.
mc config host remove myminio
MC 구성 호스트는 myminio를 제거합니다
List all configured host
구성된 모든 호스트 나열
mc config host list
Command update - Software Updates
update 명령 - 소프트웨어 업데이트
Check for new software updates from https://dl.min.io. Experimental flag checks for unstable experimental releases primarily meant for testing purposes.
https://dl.min.io에서 새로운 소프트웨어 업데이트를 확인하세요. 주로 테스트 목적으로 사용되는 불안정한 실험 릴리스에 대한 실험 플래그 확인입니다.
USAGE:
용법:
mc update [FLAGS]
FLAGS
플래그:
--quiet, -q suppress chatty console output
--quiet, -q는 chatty 콘솔 출력을 억제합니다
--json enable JSON formatted output
--json JSON 형식 출력 활성화
--help, -h show help
--help, -h 도움말을 표시합니다
Example: Check for an update.
예: 업데이트를 확인하세요.
mc update
You are already running the most recent version of ‘mc’.
귀하는 이미 'mc'의 최신 버전을 실행하고 있습니다.
Command version - Display Version
명령 버전 - 버전을 표시합니다
Display the current version of mc installed
설치된 mc의 현재 버전을 표시합니다
USAGE:
용법:
mc version [FLAGS]
FLAGS:
플래그:
--quiet, -q suppress chatty console output
--quiet, -q는 chatty 콘솔 출력을 억제합니다
--json enable JSON formatted output
--json JSON 형식 출력을 활성화합니다
--help, -h show help
--help, -h 도움말을 표시합니다
Example: Print version of mc.
예: mc의 인쇄 버전입니다.
mc version
Version: 2016-04-01T00:22:11Z
Release-tag: RELEASE.2016-04-01T00-22-11Z
Commit-id: 12adf3be326f5b6610cdd1438f72dfd861597fce
Command stat - Stat contents of objects and folders
stat 명령 - 객체 및 폴더의 통계 내용
stat command displays information on objects (with optional prefix) contained in the specified bucket on an object storage. On a filesystem, it behaves like stat command.
stat 명령은 객체 스토리지의 지정된 버킷에 포함된 객체 (선택적 접두사 포함)에 대한 정보를 표시합니다. 파일 시스템에서는 stat 명령처럼 동작합니다.
USAGE:
용법:
mc stat [FLAGS] TARGET
FLAGS:
플래그:
--recursive, -r stat all objects recursively
--recursive, -r 모든 객체를 재귀적으로 통계
--encrypt-key value encrypt/decrypt objects (using server-side encryption with customer provided keys)
--encrypt-key value 객체를 암호화/해독 (고객 제공 키로 서버 측 암호화 사용)
--help, -h show help
--help, -h 도움말을 표시합니다
ENVIRONMENT VARIABLES:
환경 변수:
MC_ENCRYPT_KEY: list of comma delimited prefix=secret values
MC_ENCRYPT_KEY: 쉼표로 구분된 접두사=비밀값 목록
Example: Display information on a bucket named "mybucket" on https://play.min.io.
예: https://play.min.io에서 "mybucket"이라는 버킷에 대한 정보를 표시합니다.
mc stat play/mybucket
Name : mybucket/
Date : 2018-02-06 18:06:51 PST
Size : 0B
Type : folder
Example: Display information on an encrypted object "myobject" in "mybucket" on https://play.min.io.
예: https://play.min.io의 "mybucket"에 있는 암호화된 객체 "myobject"에 대한 정보를 표시합니다.
mc stat play/mybucket/myobject --encrypt-key "play/mybucket=32byteslongsecretkeymustbegiven1"
Name : myobject
Date : 2018-03-02 11:47:13 PST
Size : 132B
ETag : d03ba22cd78282b7aef705bf31b8cded
Type : file
Metadata :
Content-Type : application/octet-stream
X-Amz-Server-Side-Encryption-Customer-Key-Md5 : 4xSRdYsabg+s2nlsHKhgnw==
X-Amz-Server-Side-Encryption-Customer-Algorithm: AES256
Example: Display information on objects contained in the bucket named "mybucket" on https://play.min.io.
예: https://play.min.io의 "mybucket"이라는 버킷에 포함된 객체에 대한 정보를 표시합니다.
mc stat -r play/mybucket
Name : mybucket/META/textfile
Date : 2018-02-06 18:17:38 PST
Size : 1024B
ETag : d41d8cd98f00b204e9800998ecf8427e
Type : file
Metadata :
Content-Type: application/octet-stream
Name : mybucket/emptyfile
Date : 2018-02-06 18:16:14 PST
Size : 100B
ETag : d41d8cd98f00b204e9800998ecf8427e
Type : file
Metadata :
Content-Type: application/octet-stream