MinIO - 37. MinIO Go 클라이언트 API 참조

목록

MinIO Go Client API Reference

MinIO Go 클라이언트 API 참조

Initialize MinIO Client object.

MinIO 클라이언트 객체를 초기화합니다.

MinIO

Copy

복사

// Use a secure connection.

// 보안 연결을 사용합니다.

// Initialize minio client object.

// minio 클라이언트 객체를 초기화합니다.

AWS S3

Copy

복사

// Use a secure connection.

// 보안 연결을 사용합니다.

// Initialize minio client object.

// minio 클라이언트 객체를 초기화합니다.

1. Constructor

1. 생성자

Initializes a new client object.

새 클라이언트 객체를 초기화합니다.

Parameters

매개변수

NewWithRegion(endpoint, accessKeyID, secretAccessKey string, ssl bool, region string) (*Client, error)

NewWithRegion (엔드포인트, accessKeyID, secretAccessKey 문자열, ssl bool, 영역 문자열) (*클라이언트, 오류)

Initializes minio client, with region configured.

영역이 구성된 minio 클라이언트를 초기화합니다.

Unlike New(), NewWithRegion avoids bucket-location lookup operations and it is slightly faster.

New()와 달리 NewWithRegion은 버킷 위치 조회 작업을 방지하며 약간 더 빠릅니다.

Use this function when your application deals with a single region.

애플리케이션이 단일 영역을 다룰 때 이 기능을 사용하세요.

NewWithOptions(endpoint string, options Options) (Client, error)

NewWithOptions(엔드포인트 문자열, 옵션 옵션)(클라이언트, 오류)

Initializes minio client with options configured.

구성된 옵션으로 minio 클라이언트를 초기화합니다.

Parameters

매개변수

minio.Options

2. Bucket operations

2. 버킷 작업

MakeBucket(bucketName, location string) error

MakeBucket(bucketName, 위치 문자열) 오류

Creates a new bucket.

새 버킷을 생성합니다.

Parameters

매개변수

Example

Copy

복사

ListBuckets() ([]BucketInfo, error)

ListBuckets() ([]BucketInfo, 오류)

Lists all buckets.

모든 버킷을 나열합니다.

minio.BucketInfo

Example

Copy

복사

BucketExists(bucketName string) (found bool, err error)

BucketExists(bucketName string) (부울 발견, 오류 오류)

Checks if a bucket exists.

버킷이 존재하는지 확인합니다.

Parameters

매개변수

Return Values

반환 값

Example

Copy

복사

RemoveBucket(bucketName string) error

RemoveBucket(bucketName 문자열) 오류

Removes a bucket, bucket should be empty to be successfully removed.

버킷을 제거합니다. 성공적으로 제거하려면 버킷이 비어 있어야 합니다.

Parameter

매개변수

Example

Copy

복사

ListObjects(bucketName, prefix string, recursive bool, doneCh chan struct{}) <-chan ObjectInfo

ListObjects(bucketName, 접두사 문자열, 재귀 부울, doneCh chan struct{}) <-chan ObjectInfo

Lists objects in a bucket.

버킷의 객체를 나열합니다.

Parameters

매개변수

Return Value

반환 값

minio.ObjectInfo

Copy

복사

// Create a done channel to control 'ListObjects' go routine.

// 'ListObjects' go 루틴을 제어하기 위해 완료 채널을 만듭니다.

doneCh := make(chan struct{})

// Indicate to our routine to exit cleanly upon return.

// 반환 시 깔끔하게 종료하도록 루틴에 지시합니다.

defer close(doneCh)

ListObjectsV2(bucketName, prefix string, recursive bool, doneCh chan struct{}) <-chan ObjectInfo

ListObjectsV2(bucketName, 접두사 문자열, 재귀 부울, doneCh chan struct{}) <-chan ObjectInfo

Lists objects in a bucket using the recommended listing API v2

권장 목록 API v2를 사용하여 버킷의 객체를 나열합니다.

Parameters

매개변수

Return Value

반환 값

Copy

복사

// Create a done channel to control 'ListObjectsV2' go routine.

// 'ListObjectsV2' go 루틴을 제어하기 위해 완료 채널을 만듭니다.

doneCh := make(chan struct{})

// Indicate to our routine to exit cleanly upon return.

// 반환 시 깔끔하게 종료하도록 루틴에 지시합니다.

defer close(doneCh)

ListIncompleteUploads(bucketName, prefix string, recursive bool, doneCh chan struct{}) <- chan ObjectMultipartInfo

ListIncompleteUploads(bucketName, 접두사 문자열, 재귀 부울, doneCh chan struct{}) <- chan ObjectMultipartInfo

Lists partially uploaded objects in a bucket.

버킷에 부분적으로 업로드된 객체를 나열합니다.

Parameters

매개변수

Return Value

반환 값

minio.ObjectMultipartInfo

Example

Copy

복사

// Create a done channel to control 'ListObjects' go routine.

// 'ListObjects' go 루틴을 제어하기 위해 완료 채널을 만듭니다.

doneCh := make(chan struct{})

// Indicate to our routine to exit cleanly upon return.

// 반환 시 깔끔하게 종료하도록 루틴에 지시합니다.

defer close(doneCh)

3. Object operations

3. 객체 작업

GetObject(bucketName, objectName string, opts GetObjectOptions) (*Object, error)

GetObject(bucketName, objectName string, opts GetObjectOptions) (*객체, 오류)

Returns a stream of the object data. Most of the common errors occur when reading the stream.

객체 데이터의 스트림을 반환합니다. 대부분의 일반적인 오류는 스트림을 읽을 때 발생합니다.

Parameters

매개변수

minio.GetObjectOptions

Return Value

반환 값

Example

Copy

복사

FGetObject(bucketName, objectName, filePath string, opts GetObjectOptions) error

FGetObject(bucketName, objectName, filePath 문자열, GetObjectOptions 선택) 오류

Downloads and saves the object as a file in the local filesystem.

객체를 다운로드하여 로컬 파일 시스템에 파일로 저장합니다.

Parameters

매개변수

Example

Copy

복사

GetObjectWithContext(ctx context.Context, bucketName, objectName string, opts GetObjectOptions) (*Object, error)

GetObjectWithContext(ctx context.Context, bucketName, objectName 문자열, GetObjectOptions 선택) (*Object, 오류)

Identical to GetObject operation, but accepts a context for request cancellation.

GetObject 작업과 동일하지만 요청 취소를 위한 컨텍스트를 허용합니다.

Parameters

매개변수

Return Value

반환 값

Example

Copy

복사

FGetObjectWithContext(ctx context.Context, bucketName, objectName, filePath string, opts GetObjectOptions) error

FGetObjectWithContext(ctx context.Context, bucketName, objectName, filePath 문자열, GetObjectOptions 선택) 오류

Identical to FGetObject operation, but allows request cancellation.

FGetObject 작업과 동일하지만 요청 취소를 허용합니다.

Parameters

매개변수

Example

Copy

복사

PutObject(bucketName, objectName string, reader io.Reader, objectSize int64,opts PutObjectOptions) (n int, err error)

PutObject(bucketName, objectName 문자열, 리더 io.Reader, objectSize int64,opts PutObjectOptions) (n int, 오류 오류)

Uploads objects that are less than 128MiB in a single PUT operation.

단일 PUT 작업으로 128MiB 미만의 객체를 업로드합니다.

For objects that are greater than 128MiB in size, PutObject seamlessly uploads the object as parts of 128MiB or more depending on the actual file size. The max upload size for an object is 5TB.

크기가 128MiB보다 큰 객체의 경우 PutObject는 실제 파일 크기에 따라 객체를 128MiB 이상의 일부로 원활하게 업로드합니다. 객체의 최대 업로드 크기는 5TB입니다.

Parameters

매개변수

minio.PutObjectOptions

Example

Copy

복사

API methods PutObjectWithSize, PutObjectWithMetadata, PutObjectStreaming, and PutObjectWithProgress available in minio-go SDK release v3.0.3 are replaced by the new PutObject call variant that accepts a pointer to PutObjectOptions struct.

minio-go SDK 릴리스 v3.0.3에서 사용할 수 있는 API 메서드 PutObjectWithSize, PutObjectWithMetadata, PutObjectStreaming 및 PutObjectWithProgress는 PutObjectOptions 구조체에 대한 포인터를 허용하는 새로운 PutObject 호출 변형으로 대체되었습니다.

PutObjectWithContext(ctx context.Context, bucketName, objectName string, reader io.Reader, objectSize int64, opts PutObjectOptions) (n int, err error)

PutObjectWithContext(ctx context.Context, bucketName, objectName 문자열, 리더 io.Reader, objectSize int64, opts PutObjectOptions) (n int, 오류 오류)

Identical to PutObject operation, but allows request cancellation.

PutObject 작업과 동일하지만 요청 취소를 허용합니다.

Parameters

매개변수

Example

Copy

복사

CopyObject(dst DestinationInfo, src SourceInfo) error

CopyObject(dst DestinationInfo, src SourceInfo) 오류

Create or replace an object through server-side copying of an existing object.

기존 객체의 서버 측 복사를 통해 객체를 생성하거나 교체합니다.

It supports conditional copying, copying a part of an object and server-side encryption of destination and decryption of source.

조건부 복사, 객체의 일부 복사, 대상의 서버 측 암호화 및 소스의 암호 해독을 지원합니다.

See the SourceInfo and DestinationInfo types for further details.

자세한 내용은 SourceInfo 및 DestinationInfo 유형을 참조하세요.

To copy multiple source objects into a single destination object see the ComposeObject API.

여러 소스 객체를 단일 대상 객체에 복사하려면 ComposeObject API를 참조하세요.

Parameters

매개변수

Example

Copy

복사

// Use-case 1: Simple copy object with no conditions.

// 사용 사례 1: 조건이 없는 단순 복사 객체입니다.

// Source object

// 소스 객체

// Destination object

// 대상 객체

// Copy object call

// 객체 호출 복사

Copy

복사

// Use-case 2:

// 사용-사례 2:

// Copy object with copy-conditions, and copying only part of the source object.

// 복사 조건을 사용하여 객체를 복사하고 소스 객체의 일부만 복사합니다.

// 1. that matches a given ETag

// 1. 지정된 ETag와 일치

// 2. and modified after 1st April 2014

// 2. 2014년 4월 1일 이후 수정됨

// 3. but unmodified since 23rd April 2014

// 3. 2014년 4월 23일 이후 수정되지 않음

// 4. copy only first 1MiB of object.

// 4. 객체의 처음 1MiB만 복사합니다.

// Source object

// 소스 객체

// Set matching ETag condition, copy object which matches the following ETag.

// 일치하는 ETag 조건을 설정하고 다음 ETag와 일치하는 객체를 복사합니다.

// Set modified condition, copy object modified since 2014 April 1.

// 수정된 조건을 설정하고 2014년 4월 1일 이후 수정된 객체를 복사합니다.

// Set unmodified condition, copy object unmodified since 2014 April 23.

// 수정되지 않은 조건을 설정하고 2014년 4월 23일 이후 수정되지 않은 객체를 복사합니다.

// Set copy-range of only first 1MiB of file.

// 파일의 첫 1MiB만 복사 범위를 설정합니다.

// Destination object

// 대상 객체

// Copy object call

// 객체 호출 복사

ComposeObject(dst minio.DestinationInfo, srcs []minio.SourceInfo) error

ComposeObject(dst minio.DestinationInfo, srcs []minio.SourceInfo) 오류

Create an object by concatenating a list of source objects using server-side copying.

서버 측 복사를 사용하여 소스 객체 목록을 연결하여 객체를 만듭니다.

Parameters

매개변수

Example

Copy

복사

// Prepare source decryption key (here we assume same key to // decrypt all source objects.)

// 소스 암호 해독 키 준비 (여기서는 모든 소스 객체를 암호 해독화하기 위해 동일한 키를 가정합니다.)

// Source objects to concatenate. We also specify decryption // key for each

// 연결할 소스 객체입니다. 또한 각각에 대해 암호 해독 키를 지정합니다.

// Create slice of sources.

// 소스 조각을 만듭니다.

// Prepare destination encryption key

// 대상 암호화 키를 준비

// Create destination info

// 대상 정보를 생성합니다

// Compose object call by concatenating multiple source files.

// 여러 소스 파일을 연결하여 객체 호출을 작성합니다.

NewSourceInfo(bucket, object string, decryptSSEC *SSEInfo) Source Info

NewSourceInfo(버킷, 객체 문자열, decryptSSEC *SSEInfo) Source info

Construct a SourceInfo object that can be used as the source for server-side copying operations like CopyObject and ComposeObject.

CopyObject 및 ComposeObject와 같은 서버 측 복사 작업의 소스로 사용할 수 있는 SourceInfo 객체를 생성합니다.

This object can be used to set copy-conditions on the source.

이 객체는 소스에 대한 복사 조건을 설정하는 데 사용할 수 있습니다. [@E Parameters @E] [@K 매개변수

Example

Copy

복사

// No decryption parameter.

// 암호 해독 매개변수가 없습니다.

// Destination object

// 대상 객체

// Copy object call

// 객체 호출 복사

Copy

복사

// With decryption parameter.

// 암호 해독 매개변수 포함.

// Destination object

// 대상 객체

// Copy object call

// 객체 호출 복사

NewDestinationInfo(bucket, object string, encryptSSEC *SSEInfo, userMeta map[string]string) (DestinationInfo, error)

NewDestinationInfo(버킷, 객체 문자열, encryptSSEC *SSEInfo, userMeta map[string]string) (DestinationInfo, 오류)

Construct a DestinationInfo object that can be used as the destination object for server-side copying operations like CopyObject and ComposeObject.

CopyObject 및 ComposeObject와 같은 서버측 복사 작업의 대상 객체로 사용할 수 있는 DestinationInfo 객체를 생성합니다.

Parameters

매개변수

Example

Copy

복사

// No encryption parameter.

// 암호화 매개변수가 없습니다.

// Copy object call

// 객체 호출 복사

Copy

복사

// With encryption parameter.

// 암호화 매개변수 포함.

// Copy object call

// 객체 호출 복사

FPutObject(bucketName, objectName, filePath, opts PutObjectOptions) (length int64, err error)

FPutObject(bucketName, objectName, filePath, optObject PutObjectOptions)(길이 int64, 오류 오류)

Uploads contents from a file to objectName.

파일의 내용을 objectName으로 업로드합니다.

FPutObject uploads objects that are less than 128MiB in a single PUT operation.

FPutObject는 단일 PUT 작업에서 128MiB 미만의 객체를 업로드합니다.

For objects that are greater than the 128MiB in size, FPutObject seamlessly uploads the object in chunks of 128MiB or more depending on the actual file size.

크기가 128MiB보다 큰 객체의 경우, FPutObject는 실제 파일 크기에 따라 128MiB 이상의 청크로 객체를 원활하게 업로드합니다.

The max upload size for an object is 5TB.

객체의 최대 업로드 크기는 5TB입니다.

Parameters

매개변수

Example

Copy

복사

FPutObjectWithContext(ctx context.Context, bucketName, objectName, filePath, opts PutObjectOptions) (length int64, err error)

FPutObjectWithContext(ctx context.Context, bucketName, objectName, filePath, optObject PutObjectOptions)(길이 int64, 오류 오류)

Identical to FPutObject operation, but allows request cancellation.

FPutObject 조작과 동일하지만 요청 취소를 허용합니다.

Parameters

매개변수

Example

Copy

복사

StatObject(bucketName, objectName string, opts StatObjectOptions) (ObjectInfo, error)

StatObject(bucketName, objectName string, opts StatObjectOptions) (ObjectInfo, 오류)

Fetch metadata of an object.

객체의 메타데이터를 가져옵니다.

Parameters

매개변수

Return Value

반환 값

minio.ObjectInfo

Example

Copy

복사

RemoveObject(bucketName, objectName string) error

RemoveObject(bucketName, objectName 문자열) 오류

Removes an object.

객체를 제거합니다.

Parameters

매개변수

Copy

복사

RemoveObjects(bucketName string, objectsCh chan string) (errorCh <-chan RemoveObjectError)

RemoveObjects(bucketName 문자열, objectCh chan 문자열) (errorCh <-chan RemoveObjectError)

Removes a list of objects obtained from an input channel.

입력 채널에서 얻은 객체 목록을 제거합니다.

The call sends a delete request to the server up to 1000 objects at a time. The errors observed are sent over the error channel.

이 호출은 한 번에 최대 1000개의 객체 삭제 요청을 서버에 보냅니다. 관찰된 오류는 오류 채널을 통해 전송됩니다.

Parameters

매개변수

Return Values

반환 값

Copy

복사

// Send object names that are needed to be removed to objectsCh

// 제거해야 하는 객체 이름을 objectCh로 보냅니다

// List all objects from a bucket-name with a matching prefix.

// 일치하는 접두사가 있는 버킷 이름의 모든 객체를 나열합니다.

RemoveObjectsWithContext(ctx context.Context, bucketName string, objectsCh chan string) (errorCh <-chan RemoveObjectError)

RemoveObjectsWithContext(ctx context.Context, bucketName 문자열, objectCh chan 문자열) (errorCh <-chan RemoveObjectError)

Identical to RemoveObjects operation, but accepts a context for request cancellation.

RemoveObjects 작업과 동일하지만 요청 취소를 위한 컨텍스트를 허용합니다.

Parameters

매개변수

Return Values

반환 값

Copy

복사

// Send object names that are needed to be removed to objectsCh

// 제거해야 하는 객체 이름을 objectCh로 보냅니다

// List all objects from a bucket-name with a matching prefix.

// 일치하는 접두사가 있는 버킷 이름의 모든 객체를 나열합니다.

SelectObjectContent(ctx context.Context, bucketName string, objectsName string, expression string, options SelectObjectOptions) *SelectResults

SelectObjectContent(ctx context.Context, bucketName 문자열, objectName 문자열, 표현식 문자열, 옵션 SelectObjectOptions) *SelectResults

Parameters

매개변수

Return Values

반환 값

Copy

복사

// Initialize minio client object.

// minio 클라이언트 객체를 초기화합니다.

RemoveIncompleteUpload(bucketName, objectName string) error

RemoveIncompleteUpload(bucketName, objectName 문자열) 오류

Removes a partially uploaded object.

부분적으로 업로드된 객체를 제거합니다.

Parameters

매개변수

Example

Copy

복사

5. Presigned operations

5. 사전 서명된 작업

PresignedGetObject(bucketName, objectName string, expiry time.Duration, reqParams url.Values) (*url.URL, error)

PresignedGetObject(bucketName, objectName string, 만료 time.Duration, reqParams url.Values) (*url.URL, 오류)

Generates a presigned URL for HTTP GET operations.

HTTP GET 작업을 위해 미리 서명된 URL을 생성합니다.

Browsers/Mobile clients may point to this URL to directly download objects even if the bucket is private.

브라우저/모바일 클라이언트는 버킷이 비공개인 경우에도 객체를 직접 다운로드하기 위해 이 URL을 가리킬 수 있습니다.

This presigned URL can have an associated expiration time in seconds after which it is no longer operational. The default expiry is set to 7 days.

이 사전 서명된 URL은 더 이상 작동하지 않는 만료 시간(초)을 가질 수 있습니다. 기본 만료일은 7일로 설정되어 있습니다.

Parameters

매개변수

Example

Copy

복사

// Set request parameters for content-disposition.

// 콘텐츠 처리에 대한 요청 매개변수를 설정합니다.

// Generates a presigned url which expires in a day.

// 하루 안에 만료되는 사전 서명된 URL을 생성합니다.

PresignedPutObject(bucketName, objectName string, expiry time.Duration) (*url.URL, error)

PresignedPutObject(bucketName, objectName string, 만료 time.Duration) (*url.URL, 오류)

Generates a presigned URL for HTTP PUT operations.

HTTP PUT 작업을 위해 사전 서명된 URL을 생성합니다.

Browsers/Mobile clients may point to this URL to upload objects directly to a bucket even if it is private.

브라우저/모바일 클라이언트는 이 URL을 가리켜 비공개인 경우에도 버킷에 직접 객체를 업로드할 수 있습니다.

This presigned URL can have an associated expiration time in seconds after which it is no longer operational. The default expiry is set to 7 days.

이 사전 서명된 URL은 더 이상 작동하지 않는 만료 시간(초)을 가질 수 있습니다. 기본 만료일은 7일로 설정되어 있습니다.

NOTE: you can upload to S3 only with specified object name.

메모: 지정된 객체 이름으로만 S3에 업로드할 수 있습니다.

Parameters

매개변수

Example

Copy

복사

// Generates a url which expires in a day.

// 하루 안에 만료되는 URL을 생성합니다.

PresignedHeadObject(bucketName, objectName string, expiry time.Duration, reqParams url.Values) (*url.URL, error)

PresignedHeadObject(bucketName, objectName string, 만료 time.Duration, reqParams url.Values) (*url.URL, 오류)

Generates a presigned URL for HTTP HEAD operations.

HTTP HEAD 작업을 위해 사전 서명된 URL을 생성합니다.

Browsers/Mobile clients may point to this URL to directly get metadata from objects even if the bucket is private.

브라우저/모바일 클라이언트는 버킷이 비공개인 경우에도 객체에서 메타데이터를 직접 가져오기 위해 이 URL을 가리킬 수 있습니다.

This presigned URL can have an associated expiration time in seconds after which it is no longer operational. The default expiry is set to 7 days.

이 사전 서명된 URL은 더 이상 작동하지 않는 만료 시간(초)을 가질 수 있습니다. 기본 만료일은 7일로 설정되어 있습니다.

Parameters

매개변수

Example

Copy

복사

// Set request parameters for content-disposition.

// 콘텐츠 처리에 대한 요청 매개변수를 설정합니다.

// Generates a presigned url which expires in a day.

// 하루 안에 만료되는 사전 서명된 URL을 생성합니다.

PresignedPostPolicy(PostPolicy) (*url.URL, map[string]string, error)

PresignedPostPolicy(PostPolicy) (*url.URL, 지도[문자열]문자열, 오류)

Allows setting policy conditions to a pre-signed URL for POST operations.

POST 작업을 위해 사전 서명된 URL에 정책 조건을 설정할 수 있습니다.

Policies such as bucket name to receive object uploads, key name prefixes, expiry policy may be set.

객체 업로드를 수신하기 위한 버킷 이름, 키 이름 접두사, 만료 정책과 같은 정책을 설정할 수 있습니다.

Copy

복사

// Initialize policy condition config.

// 정책 조건 구성을 초기화합니다.

// Apply upload policy restrictions:

// 업로드 정책 제한을 적용합니다:

// Only allow 'png' images.

// 'png' 이미지만 허용합니다.

policy.SetContentType("image/png")

// Only allow content size in range 1KB to 1MB.

// 1KB ~ 1MB 범위의 콘텐츠 크기만 허용합니다.

// Add a user metadata using the key "custom" and value "user"

// "custom" 키와 "user" 값을 사용하여 사용자 메타데이터를 추가합니다

// Get the POST form key/value object:

// POST 양식 키/값 객체를 가져옵니다:

// POST your content from the command line using `curl`

// `curl`을 사용하여 명령줄에서 내용을 게시합니다

6. Bucket policy/notification operations

6. 버킷 정책/알림 작업

SetBucketPolicy(bucketname, policy string) error

SetBucketPolicy(bucketname, 정책 문자열) 오류

Set access permissions on bucket or an object prefix.

버킷 또는 객체 접두사에 대한 액세스 권한을 설정합니다.

Parameters

매개변수

Return Values

반환 값

Example

Copy

복사

GetBucketPolicy(bucketName) (policy string, error)

GetBucketPolicy(bucketName) (정책 문자열, 오류)

Get access permissions on a bucket or a prefix.

버킷 또는 접두사에 대한 액세스 권한을 얻습니다.

Parameters

매개변수

Return Values

반환 값

Example

Copy

복사

GetBucketNotification(bucketName string) (BucketNotification, error)

GetBucketNotification(bucketName 문자열)(BucketNotification, 오류)

Get notification configuration on a bucket.

버킷에서 알림 구성을 가져옵니다.

Parameters

매개변수

Return Values

반환 값

Example

Copy

복사

SetBucketNotification(bucketName string, bucketNotification BucketNotification) error

SetBucketNotification(bucketName 문자열, bucketNotification BucketNotification) 오류

Set a new bucket notification on a bucket.

버킷에 새 버킷 알림을 설정합니다.

Parameters

매개변수

Return Values

반환 값

Example

Copy

복사

RemoveAllBucketNotification(bucketName string) error

RemoveAllBucketNotification(bucketName 문자열) 오류

Remove all configured bucket notifications on a bucket.

버킷에서 구성된 모든 버킷 알림을 제거합니다.

Parameters

매개변수

Return Values

반환 값

Example

Copy

복사

ListenBucketNotification(bucketName, prefix, suffix string, events []string, doneCh <-chan struct{}) <-chan NotificationInfo

ListenBucketNotification(bucketName, 접두사, 접미사 문자열, 이벤트 []string, doneCh <-chan struct{}) <-chanNotificationInfo

ListenBucketNotification API receives bucket notification events through the notification channel. The returned notification channel has two fields 'Records' and 'Err'.

ListenBucketNotification API는 알림 채널을 통해 버킷 알림 이벤트를 수신합니다. 반환된 알림 채널에는 'Records'와 'Err'라는 두 개의 필드가 있습니다.

'Records' holds the notifications received from the server.

'레코드'는 서버에서 수신한 알림을 보관합니다.

'Err' indicates any error while processing the received notifications.

'Err'는 수신된 알림을 처리하는 동안 오류가 발생했음을 나타냅니다.

NOTE: Notification channel is closed at the first occurrence of an error.

메모: 오류가 처음 발생하면 알림 채널이 닫힙니다.

Parameters

매개변수

Return Values

반환 값

minio.NotificationInfo

Example

Copy

복사

// Create a done channel to control 'ListenBucketNotification' go routine.

// 'ListenBucketNotification' 루틴을 제어하기 위해 완료 채널을 만듭니다. [@E doneCh := make(chan struct{}) @E] [@E // Indicate a background go-routine to exit cleanly upon return. @E] [@K // 반환 시 깔끔하게 종료되도록 백그라운드 이동 루틴을 나타냅니다.

defer close(doneCh)

// Listen for bucket notifications on "mybucket" filtered by prefix, suffix and events.

// 접두사, 접미사 및 이벤트로 필터링된 "mybucket"에 대한 버킷 알림을 수신합니다.

SetBucketLifecycle(bucketname, lifecycle string) error

SetBucketLifecycle(bucketname, 수명 주기 문자열) 오류

Set lifecycle on bucket or an object prefix.

버킷 또는 객체 접두사에 수명주기를 설정합니다.

Parameters

매개변수

Return Values

반환 값

Example

Copy

복사

GetBucketLifecycle(bucketName) (lifecycle string, error)

GetBucketLifecycle(bucketName)(수명 주기 문자열, 오류)

Get lifecycle on a bucket or a prefix.

버킷 또는 접두사에 대한 수명 주기를 가져옵니다.

Parameters

매개변수

Return Values

반환 값

Example

Copy

복사

7. Client custom settings

7. 클라이언트 사용자 정의 설정

SetAppInfo(appName, appVersion string)

SetAppInfo(appName, appVersion 문자열)

Add custom application details to User-Agent.

User-Agent에 사용자 정의 애플리케이션 세부 정보를 추가합니다.

Parameters

매개변수

Example

Copy

복사

// Set Application name and version to be used in subsequent API requests.

// 후속 API 요청에 사용할 애플리케이션 이름과 버전을 설정합니다.

minioClient.SetAppInfo("myCloudApp", "1.0.0")

SetCustomTransport(customHTTPTransport http.RoundTripper)

Overrides default HTTP transport. This is usually needed for debugging or for adding custom TLS certificates.

기본 HTTP 전송을

Parameters

매개변수 Param Type Description 설명 customHTTPTransport http.RoundTripper Custom transport e.g, to trace API requests and responses for debugging purposes. 디버깅 목적으로 API 요청 및 응답을 추적하는 등의 사용자 지정 전송입니다. [@E TraceOn(outputStream io.Writer) @E] [@E Enables HTTP tracing. The trace is written to the io.Writer provided. If outputStream is nil, trace is written to os.Stdout. @E] [@K HTTP 추적을 활성화합니다. 추적은 제공된 io.Writer에 기록됩니다. outputStream이 nil이면 추적이 os.Stdout에 기록됩니다.

Parameters

매개변수

TraceOff()

Disables HTTP tracing.

HTTP 추적을 비활성화합니다.

SetS3TransferAccelerate(acceleratedEndpoint string)

SetS3TransferAccelerate(acceleratedEndpoint 문자열)

Set AWS S3 transfer acceleration endpoint for all API requests hereafter.

이후 모든 API 요청에 대해 AWS S3 Transfer Acceleration 엔드포인트를 설정합니다.

NOTE: This API applies only to AWS S3 and is a no operation for S3 compatible object storage services.

노트: 이 API는 AWS S3에만 적용되며 S3 호환 객체 스토리지 서비스에는 작동하지 않습니다.

Parameters

매개변수