MinIO - 39. .NET 클라이언트 API 참조

.NET Client API Reference

.NET 클라이언트 API 참조

Initialize MinIO Client object.

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

MinIO

var minioClient = new MinioClient("play.min.io",
                                       "Q3AM3UQ867SPQQA43P2F",
                                       "zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG"
                                 ).WithSSL();

AWS S3

var s3Client = new MinioClient("s3.amazonaws.com",
                                   "YOUR-ACCESSKEYID",
                                   "YOUR-SECRETACCESSKEY"
                               ).WithSSL();

Bucket operations

버킷 작업

Object operations

객체 작업

Presigned operations

사전 서명된 작업

Bucket Policy Operations

버킷 정책 작업

makeBucket
getObject
presignedGetObject
getBucketPolicy
listBuckets
putObject
presignedPutObject
setBucketPolicy
bucketExists
copyObject
presignedPostPolicy
setBucketNotification
removeBucket
statObject


getBucketNotification
listObjects
removeObject


removeAllBucketNotification
listIncompleteUploads
removeObjects






removeIncompleteUpload

1. Constructors

1. 생성자

public MinioClient(string endpoint, string accessKey = "", string secretKey = "", string region = "", string sessionToken="")

public MinioClient(문자열 엔드포인트, 문자열 accessKey = "", 문자열 secretKey = "", 문자열 영역 = "", 문자열 sessionToken = "")

Creates MinIO client object with given endpoint.

지정된 엔드포인트를 사용하여 MinIO 클라이언트 객체를 생성합니다.

AccessKey, secretKey, region and sessionToken are optional parameters, and can be omitted for anonymous access.

AccessKey, secretKey, region 및 sessionToken은 선택적 매개변수이며 익명 액세스의 경우 생략할 수 있습니다.

The client object uses Http access by default.

클라이언트 객체는 기본적으로 Http 액세스를 사용합니다.

To use Https, chain method WithSSL() to client object to use secure transfer protocol

Https를 사용하려면 WithSSL() 메소드를 클라이언트 객체에 연결하여 보안 전송 프로토콜을 사용합니다.

Parameters

매개변수

Param

Type

Description

설명

endpoint

string

endPoint is an URL, domain name, IPv4 address or IPv6 address.Valid endpoints are listed below:

endPoint는 URL, 도메인 이름, IPv4 주소 또는 IPv6 주소입니다. 유효한 엔드 포인트는 다음과 같습니다.

s3.amazonaws.com




play.min.io




localhost




play.min.io

accessKey

string

accessKey is like user-id that uniquely identifies your account.This field is optional and can be omitted for anonymous access.

accessKey는 귀하의 계정을 고유하게 식별하는 사용자 ID와 같습니다. 이 필드는 선택 사항이며 익명 액세스를 위해 생략할 수 있습니다.

secretKey

string

secretKey is the password to your account.This field is optional and can be omitted for anonymous access.

secretKey는 계정의 패스워드입니다. 이 필드는 선택 사항이며 익명 액세스의 경우 생략할 수 있습니다.

region

string

region to which calls should be made. This field is optional and can be omitted.

호출해야 할 영역. 이 필드는 선택 사항이므로 생략할 수 있습니다.

sessionToken

string

sessionToken needs to be set if temporary access credentials are used.

sessionToken은 임시 액세스 자격 증명을 사용하는 경우 설정해야 합니다.

Secure Access

보안 액세스

Chain .WithSSL() to MinIO Client object to use https instead of http.

http 대신 https를 사용하려면 .WithSSL()을 MinIO 클라이언트 개체에 연결하세요.

Proxy

프록시

Chain .WithProxy(proxyObject) to MinIO Client object to use proxy

프록시를 사용하려면 .WithProxy(proxyObject)를 MinIO 클라이언트 객체에 연결하세요.

Example

예

MinIO

// 1. public MinioClient(String endpoint)

// 1. 공개 MinioClient(문자열 엔드포인트)

MinioClient minioClient = new MinioClient("play.min.io");

// 2. public MinioClient(String endpoint, String accessKey, String secretKey)

// 2. 공개 MinioClient(String 엔드포인트, 문자열 accessKey, 문자열 secretKey)

MinioClient minioClient = new MinioClient("play.min.io",
                                          accessKey:"Q3AM3UQ867SPQQA43P2F",
                                          secretKey:"zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG"
                                          ).WithSSL();

// 3. Initializing minio client with proxy

// 3. 프록시를 사용하여 minio 클라이언트 초기화

IWebProxy proxy = new WebProxy("192.168.0.1", 8000);
MinioClient minioClient = new MinioClient("my-ip-address:9000", "minio", "minio123").WithSSL().WithProxy(proxy);

// 4. Initializing minio client with temporary credentials

// 4. 임시 자격 증명으로 minio 클라이언트 초기화

MinioClient minioClient = new MinioClient("my-ip-address:9000", "tempuserid", "temppasswd", sessionToken:"sessionToken");

AWS S3

// 1. public MinioClient(String endpoint)

// 1. 공개 MinioClient(문자열 엔드포인트)

MinioClient s3Client = new MinioClient("s3.amazonaws.com").WithSSL();

// 2. public MinioClient(String endpoint, String accessKey, String secretKey)

// 2. 공개 MinioClient(String 엔드포인트, 문자열 accessKey, 문자열 secretKey)

MinioClient s3Client = new MinioClient("s3.amazonaws.com:80",
                                       accessKey:"YOUR-ACCESSKEYID",
                                       secretKey:"YOUR-SECRETACCESSKEY").WithSSL();

2. Bucket operations

2. 버킷 작업

MakeBucketAsync(string bucketName, string location = "us-east-1")

MakeBucketAsync(문자열 bucketName, 문자열 위치 = "us-east-1")

Task MakeBucketAsync(string bucketName, string location = "us-east-1", CancellationToken cancellationToken = default(CancellationToken))

Creates a new bucket.

새 버킷을 생성합니다.

Parameters

매개변수

Param

Type

Description

설명

bucketName

string

Name of the bucket

버킷의 이름

region

string

Optional parameter. Defaults to us-east-1 for AWS requests

선택적 매개변수. AWS 요청의 경우 기본값은 us-east-1입니다.

cancellationToken

System.Threading.CancellationToken

Optional parameter. Defaults to default(CancellationToken)

선택적 매개변수. 기본값은 default(CancellationToken)입니다

Return Type

반환 유형

Exceptions

예외

Task

Listed Exceptions:

나열된 예외:

InvalidBucketNameException : upon invalid bucket name

InvalidBucketNameException : 버킷 이름이 잘못된 경우

ConnectionException : upon connection error

ConnectionException : 연결 오류 시

AccessDeniedException : upon access denial

AccessDeniedException : 접근 거부 시

RedirectionException : upon redirection by server

RedirectionException : 서버에 의한 리디렉션 시

InternalClientException : upon internal library error

InternalClientException : 내부 라이브러리 오류 시

Example

예

try
{

// Create bucket if it doesn't exist.

// 버킷이 없으면 생성합니다.

bool found = await minioClient.BucketExistsAsync("mybucket");
   if (found)
   {

Console.WriteLine("mybucket already exists");

Console.WriteLine("내 버킷이 이미 존재합니다.");

}
   else
   {

// Create bucket 'my-bucketname'.

// 'my-bucketname' 버킷을 생성합니다.

await minioClient.MakeBucketAsync("mybucket");

Console.WriteLine("mybucket is created successfully");

Console.WriteLine("버킷이 성공적으로 생성되었습니다.");

}
}
catch (MinioException e)
{

Console.WriteLine("Error occurred: " + e);

Console.WriteLine("오류가 발생했습니다: " + e);

}

ListBucketsAsync()

Task ListBucketsAsync(CancellationToken cancellationToken = default(CancellationToken))

Lists all buckets.

모든 버킷을 나열합니다.

Param

Type

Description

설명

cancellationToken

System.Threading.CancellationToken

Optional parameter. Defaults to default(CancellationToken)

선택적 매개변수. 기본값은 default(CancellationToken)입니다.

Return Type

반환 유형

Exceptions

예외

Task : Task with List of bucket type.

Task : 버킷 유형 목록이 포함된 작업입니다.

Listed Exceptions:

나열된 예외:

InvalidBucketNameException : upon invalid bucket name

InvalidBucketNameException : 버킷 이름이 잘못된 경우

ConnectionException : upon connection error

ConnectionException : 연결 오류 시

AccessDeniedException : upon access denial

AccessDeniedException : 접근 거부 시

InvalidOperationException: upon unsuccessful deserialization of xml data

InvalidOperationException: 데이터의 역직렬화에 실패한 경우

InvalidOperationException : XML

ErrorResponseException : upon unsuccessful execution

ErrorResponseException : 실행 실패 시

InternalClientException : upon internal library error

InternalClientException : 내부 라이브러리 오류 시

Example

예

try
{

// List buckets that have read access.

// 읽기 권한이 있는 버킷을 나열합니다.

var list = await minioClient.ListBucketsAsync();
    foreach (Bucket bucket in list.Buckets)
    {
        Console.WriteLine(bucket.Name + " " + bucket.CreationDateDateTime);
    }
}
catch (MinioException e)
{

Console.WriteLine("Error occurred: " + e);

Console.WriteLine("오류가 발생했습니다: " + e);

}

BucketExistsAsync(string bucketName)

BucketExistsAsync(문자열 bucketName)

Task BucketExistsAsync(string bucketName, CancellationToken cancellationToken = default(CancellationToken))

Checks if a bucket exists.

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

Parameters

매개변수

Param

Type

Description

설명

bucketName

string

Name of the bucket.

버킷의 이름.

cancellationToken

System.Threading.CancellationToken

Optional parameter. Defaults to default(CancellationToken)

선택적 매개변수. 기본값은 default(CancellationToken)입니다.

Return Type

반환 유형

Exceptions

예외

Task : true if the bucket exists

Task: 버킷이 존재하면 true입니다

Listed Exceptions:

나열된 예외:

InvalidBucketNameException : upon invalid bucket name

InvalidBucketNameException : 버킷 이름이 잘못된 경우

ConnectionException : upon connection error

ConnectionException : 연결 오류시

AccessDeniedException : upon access denial

AccessDeniedException : 접근 거부 시

ErrorResponseException : upon unsuccessful execution

ErrorResponseException : 실행 실패 시

InternalClientException : upon internal library error

InternalClientException : 내부 라이브러리 오류 시

Example

예

try
{

// Check whether 'my-bucketname' exists or not.

// 'my-bucketname'이 존재하는지 확인합니다.

bool found = await minioClient.BucketExistsAsync(bucketName);
   Console.WriteLine("bucket-name " + ((found == true) ? "exists" : "does not exist"));
}
catch (MinioException e)
{
   Console.WriteLine("[Bucket]  Exception: {0}", e);
}

RemoveBucketAsync(string bucketName)

RemoveBucketAsync(문자열 bucketName)

Task RemoveBucketAsync(string bucketName, CancellationToken cancellationToken = default(CancellationToken))

Removes a bucket.

버킷을 제거합니다.

NOTE: - removeBucket does not delete the objects inside the bucket. The objects need to be deleted using the removeObject API.

메모: - removeBucket은 버킷 내부의 객체를 삭제하지 않습니다. removeObject API를 사용하여 객체를 삭제해야 합니다.

Parameters

매개변수

Param

Type

Description

설명

bucketName

string

Name of the bucket

버킷의 이름

cancellationToken

System.Threading.CancellationToken

Optional parameter. Defaults to default(CancellationToken)

선택적 매개변수. 기본값은 default(CancellationToken)입니다.

Return Type

반환 유형

Exceptions

예외

Task

Listed Exceptions:

나열된 예외:

InvalidBucketNameException : upon invalid bucket name

InvalidBucketNameException : 버킷 이름이 잘못된 경우

ConnectionException : upon connection error

ConnectionException : 연결 오류 시

AccessDeniedException : upon access denial

AccessDeniedException : 접근 거부 시

ErrorResponseException : upon unsuccessful execution

ErrorResponseException : 실행 실패 시

InternalClientException : upon internal library error

InternalClientException : 내부 라이브러리 오류 시

BucketNotFoundException : upon missing bucket

BucketNotFoundException : 버킷이 누락된 경우

Example

예

try
{

// Check if my-bucket exists before removing it.

// my-bucket을 제거하기 전에 존재하는지 확인합니다.

bool found = await minioClient.BucketExistsAsync("mybucket");
    if (found)
    {

// Remove bucket my-bucketname. This operation will succeed only if the bucket is empty.

// my-bucketname 버킷을 제거합니다. 이 작업은 버킷이 비어 있는 경우에만 성공합니다.

await minioClient.RemoveBucketAsync("mybucket");
        [@E Console.WriteLine("mybucket is removed successfully"); @E]
        [@K Console.WriteLine("버킷이 성공적으로 제거되었습니다."); @K]
    }
    else
    {

Console.WriteLine("mybucket does not exist");

Console.WriteLine("내 버킷이 존재하지 않습니다.");

}
}
catch(MinioException e)
{

Console.WriteLine("Error occurred: " + e);

Console.WriteLine("오류가 발생했습니다: " + e);

}ListObjectsAsync(string bucketName, string prefix = null, bool recursive = true)

IObservable ListObjectsAsync(string bucketName, string prefix = null, bool recursive = false, CancellationToken cancellationToken = default(CancellationToken))

Lists all objects in a bucket.

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

Parameters

매개변수

Param

Type

Description

설명

bucketName

string

Name of the bucket

버킷의 이름

prefix

string

Prefix string. List objects whose name starts with prefix

접두사 문자열. 이름이 접두사로 시작하는 객체 나열

recursive

bool

when false, emulates a directory structure where each listing returned is either a full object or part of the object's key up to the first '/'. All objects with the same prefix up to the first '/' will be merged into one entry. Defaults to false

false 인 경우, 반환된 각 목록이 전체 객체이거나 첫 번째 '/' 까지 객체 키의 일부인 디렉토리 구조를 에뮬레이트합니다. 첫 번째 '/' 까지 동일한 접두어를 가진 모든 객체는 하나의 항목으로 병합됩니다. 기본값은 false입니다.

cancellationToken

System.Threading.CancellationToken

Optional parameter. Defaults to default(CancellationToken)

선택적 매개변수. 기본값은 default(CancellationToken)입니다.

Return Type

반환 유형

Exceptions

예외

IObservable: an Observable of Items.

IObservable: 항목을 관찰할 수 있습니다.

None

없음

Example

예

try
{

// Check whether 'mybucket' exists or not.

// 'mybucket'이 존재하는지 확인합니다.

bool found = minioClient.BucketExistsAsync("mybucket");
    if (found)
    {

// List objects from 'my-bucketname'

// 'my-bucketname'의 객체 나열

IObservable observable = minioClient.ListObjectsAsync("mybucket", "prefix", true);
        IDisposable subscription = observable.Subscribe(
                item => Console.WriteLine("OnNext: {0}", item.Key),
                ex => Console.WriteLine("OnError: {0}", ex.Message),
                () => Console.WriteLine("OnComplete: {0}"));
    }
    else
    {
        Console.WriteLine("mybucket does not exist");
    }
}
catch (MinioException e)
{
    Console.WriteLine("Error occurred: " + e);
}

ListIncompleteUploads(string bucketName, string prefix, bool recursive)

IObservable ListIncompleteUploads(string bucketName, string prefix, bool recursive, CancellationToken cancellationToken = default(CancellationToken))

Lists partially uploaded objects in a bucket.

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

Parameters

매개변수

Param

Type

Description

설명

bucketName

string

Name of the bucket

버킷의 이름

prefix

string

Prefix string. List objects whose name starts with prefix

접두사 문자열. 이름이 접두사로 시작하는 객체 목록

recursive

bool

Prefix string. List objects whose name starts with prefix

접두사 문자열. 이름이 접두사로 시작하는 객체 목록

cancellationToken

System.Threading.CancellationToken

Optional parameter. Defaults to default(CancellationToken)

선택적 매개변수. 기본값은 default(CancellationToken)입니다.

false인 경우, 반환된 각 목록이 전체 객체이거나 첫 번째 '/' 까지 객체 키의 일부인 디렉토리 구조를 에뮬레이트합니다. 첫 번째 '/' 까지 동일한 접두어를 모든 객체는 하나의 항목으로 병합됩니다.

Optional parameter. Defaults to default(CancellationToken)

선택적 매개변수. 기본값은 default(CancellationToken)입니다.

Return Type

반환 유형

Exceptions

예외

IObservable: an Observable of Upload.

IObservable: 관찰할 수 있는 업로드.

None

없음

Example

예

try
{

// Check whether 'mybucket' exist or not.

// 'mybucket'이 존재하는지 확인합니다.

bool found = minioClient.BucketExistsAsync("mybucket");
    if (found)
    {

// List all incomplete multipart upload of objects in 'mybucket'

// 'mybucket'에 있는 객체의 불완전한 멀티파트 업로드를 모두 나열합니다

IObservable observable = minioClient.ListIncompleteUploads("mybucket", "prefix", true);
        IDisposable subscription = observable.Subscribe(
                            item => Console.WriteLine("OnNext: {0}", item.Key),
                            ex => Console.WriteLine("OnError: {0}", ex.Message),
                            () => Console.WriteLine("OnComplete: {0}"));
    }
    else
    {
        Console.WriteLine("mybucket does not exist");
    }
}
catch (MinioException e)
{
    Console.WriteLine("Error occurred: " + e);
}

GetPolicyAsync(string bucketName)Task GetPolicyAsync(string bucketName, CancellationToken cancellationToken = default(CancellationToken))

Get bucket policy.

버킷 정책을 가져옵니다.

Parameters

매개변수

Param

Type

Description

설명

bucketName

string

Name of the bucket.

버킷의 이름.

cancellationToken

System.Threading.CancellationToken

Optional parameter. Defaults to default(CancellationToken)

선택적 매개변수. 기본값은 default(CancellationToken)입니다.

Return Type

반환 유형

Exceptions

예외

Task: The current bucket policy for given bucket as a json string.

Task: 주어진 버킷에 대한 현재 버킷 정책을 json 문자열로 나타냅니다.

Listed Exceptions:

나열된 예외

InvalidBucketNameException : upon invalid bucket name.

InvalidBucketNameException : 버킷 이름이 잘못된 경우

InvalidObjectPrefixException : upon invalid object prefix.

InvalidObjectPrefixException : 객체 접두사가 잘못된 경우.

ConnectionException : upon connection error.

ConnectionException : 연결 오류 시

AccessDeniedException : upon access denial

AccessDeniedException : 접근 거부 시

InternalClientException : upon internal library error.

InternalClientException : 내부 라이브러리 오류 시

BucketNotFoundException : upon missing bucket

BucketNotFoundException : 버킷이 누락된 경우

Example

예

try
{
    String policyJson = await minioClient.GetPolicyAsync("myBucket");
    Console.WriteLine("Current policy: " + policy.GetType().ToString());
}
catch (MinioException e)
{
    Console.WriteLine("Error occurred: " + e);
}

SetPolicyAsync(string bucketName, string policyJson)

Task SetPolicyAsync(string bucketName, string policyJson, CancellationToken cancellationToken = default(CancellationToken))

Set policy on bucket.

버킷에 대한 정책을 설정합니다.

Parameters

매개변수

Param

Type

Description

설명

bucketName

string

Name of the bucket

버킷의 이름

policyJson

string

Policy as a json string

정책을 JSON 문자열로 나타냅니다.

cancellationToken

System.Threading.CancellationToken

Optional parameter. Defaults to default(CancellationToken)

선택적 매개변수. 기본값은 default(CancellationToken)입니다.

Return Type

반환 유형

Exceptions

예외

Task

Listed Exceptions:

나열된 예외

InvalidBucketNameException : upon invalid bucket name

InvalidBucketNameException : 버킷 이름이 잘못된 경우

ConnectionException : upon connection error

ConnectionException : 연결 오류시

InternalClientException : upon internal library error

InternalClientException : 내부 라이브러리 오류시

InvalidBucketNameException : upon invalid bucket name

InvalidBucketNameException : 버킷 이름이 잘못된 경우

InvalidObjectPrefixException : upon invalid object prefix

InvalidObjectPrefixException : 객체 접두사가 잘못된 경우

Example

예

try
{
    await minioClient.SetPolicyAsync("myBucket");
}
catch (MinioException e)
{
    Console.WriteLine("Error occurred: " + e);
}

SetBucketNotificationAsync(string bucketName, BucketNotification notification)

Task SetBucketNotificationAsync(string bucketName, BucketNotification notification, CancellationToken cancellationToken = default(CancellationToken))

Sets notification configuration for a given bucket

특정 버킷에 대한 알림 구성을 설정합니다

Parameters

매개변수

Param

Type

Description

설명

bucketName

string

Name of the bucket

버킷의 이름

notification

BucketNotification

Notifications to apply

신청 알림

cancellationToken

System.Threading.CancellationToken

Optional parameter. Defaults to default(CancellationToken)

선택적 매개변수. 기본값은 default(CancellationToken)입니다.

Return Type

반환 유형

Exceptions

예외

Task

Listed Exceptions:

나열된 예외

ConnectionException : upon connection error

ConnectionException : 연결 오류 시

InternalClientException : upon internal library error

InternalClientException : 내부 라이브러리 오류 시

InvalidBucketNameException : upon invalid bucket name

InvalidBucketNameException : 버킷 이름이 잘못된 경우

InvalidOperationException: upon unsuccessful serialization of notification object

InvalidOperationException : 알림 객체의 직렬화 실패 시

Example

예

try
{
    BucketNotification notification = new BucketNotification();
    Arn topicArn = new Arn("aws", "sns", "us-west-1", "412334153608", "topicminio");

    TopicConfig topicConfiguration = new TopicConfig(topicArn);
    List events = new List(){ EventType.ObjectCreatedPut , EventType.ObjectCreatedCopy };
    topicConfiguration.AddEvents(events);
    topicConfiguration.AddFilterPrefix("images");
    topicConfiguration.AddFilterSuffix("jpg");
    notification.AddTopic(topicConfiguration);

    QueueConfig queueConfiguration = new QueueConfig("arn:aws:sqs:us-west-1:482314153608:testminioqueue1");
    queueConfiguration.AddEvents(new List() { EventType.ObjectCreatedCompleteMultipartUpload });
    notification.AddQueue(queueConfiguration);

    await minio.SetBucketNotificationsAsync(bucketName,
                                        notification);
    Console.WriteLine("Notifications set for the bucket " + bucketName + " successfully");
}
catch (MinioException e)
{
    Console.WriteLine("Error occurred: " + e);
}

GetBucketNotificationAsync(string bucketName)Task GetBucketNotificationAsync(string bucketName, CancellationToken cancellationToken = default(CancellationToken))

Get bucket notification configuration

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

Parameters

매개변수

Param

Type

Description

설명

bucketName

string

Name of the bucket.

버킷의 이름.

cancellationToken

System.Threading.CancellationToken

Optional parameter. Defaults to default(CancellationToken)

선택적 매개변수. 기본값은 default(CancellationToken)입니다.

Return Type

반환 유형

Exceptions

예외

Task: The current notification configuration for the bucket.

Task: 버킷에 대한 현재 알림 구성입니다.

Listed Exceptions:

나열된 예외

InvalidBucketNameException : upon invalid bucket name.

InvalidBucketNameException : 버킷 이름이 잘못된 경우.

ConnectionException : upon connection error.

ConnectionException : 연결 오류 시

AccessDeniedException : upon access denial

AccessDeniedException : 접근 거부 시

InternalClientException : upon internal library error

InternalClientException : 내부 라이브러리 오류 시

BucketNotFoundException : upon missing bucket

BucketNotFoundException : 버킷이 누락된 경우

InvalidOperationException: upon unsuccessful deserialization of xml data

InvalidOperationException : XML 데이터 역직렬화에 실패한 경우

Example

예

try
{
    BucketNotification notifications = await minioClient.GetBucketNotificationAsync(bucketName);
    Console.WriteLine("Notifications is " + notifications.ToXML());
}
catch (MinioException e)
{
    Console.WriteLine("Error occurred: " + e);
}

RemoveAllBucketNotificationsAsync(string bucketName)

Task RemoveAllBucketNotificationsAsync(string bucketName, CancellationToken cancellationToken = default(CancellationToken))

Remove all notification configurations set on the bucket

버킷에 설정된 모든 알림 구성 제거

Parameters

매개변수

Param

Type

Description

설명

bucketName

string

Name of the bucket.

버킷의 이름.

cancellationToken

System.Threading.CancellationToken

Optional parameter. Defaults to default(CancellationToken)

선택적 매개변수. 기본값은 default(CancellationToken)입니다.

Return Type

반환 유형

Exceptions

예외

Task

Listed Exceptions:

나열된 예외

InvalidBucketNameException : upon invalid bucket name.

InvalidBucketNameException : 버킷 이름이 잘못된 경우.

Listed Exceptions:

나열된 예외

InvalidBucketNameException : upon invalid bucket name.

InvalidBucketNameException : 버킷 이름이 잘못된 경우.

ConnectionException : upon connection error.

ConnectionException : 연결 오류 시.

AccessDeniedException : upon access denial

AccessDeniedException : 접근 거부 시

InternalClientException : upon internal library error.

InternalClientException : 내부 라이브러리 오류 시

BucketNotFoundException : upon missing bucket

BucketNotFoundException : 버킷이 누락된 경우

InvalidOperationException: upon unsuccessful serialization of xml data

InvalidOperationException : xml 데이터의 직렬화 실패 시

Example

예

try
{
    await minioClient.RemoveAllBucketNotificationsAsync(bucketName);
    Console.WriteLine("Notifications successfully removed from the bucket " + bucketName);
}
catch (MinioException e)
{
    Console.WriteLine("Error occurred: " + e);
}

3. Object operations

3. 객체 작업

GetObjectAsync(string bucketName, string objectName, Action callback, ServerSideEncryption sse)

Task GetObjectAsync(string bucketName, string objectName, Action callback, ServerSideEncryption sse = null, CancellationToken cancellationToken = default(CancellationToken))

Downloads an object as a stream.

객체를 스트림으로 다운로드합니다.

Parameters

매개변수

Param

Type

Description

설명

bucketName

string

Name of the bucket

버킷의 이름

objectName

string

Object name in the bucket

버킷의 객체 이름

callback

Action

Call back to process stream

프로세스 스트림으로 다시 호출

sse

ServerSideEncryption

Server-side encryption option

서버측 암호화 옵션

cancellationToken

System.Threading.CancellationToken

Optional parameter. Defaults to default(CancellationToken)

선택적 매개변수. 기본값은 default(CancellationToken)입니다.

Return Type

반환 유형

Exceptions

예외

Task: Task callback returns an InputStream containing the object data.

Task: Task 콜백은 객체 데이터가 포함 된 InputStream을 반환합니다.

Listed Exceptions:

나열된 예외

InvalidBucketNameException : upon invalid bucket name.

InvalidBucketNameException : 버킷 이름이 잘못된 경우.

ConnectionException : upon connection error.

ConnectionException : 연결 오류 시

InternalClientException : upon internal library error.

InternalClientException : 내부 라이브러리 오류 시

Example

예

try
{

// Check whether the object exists using statObject().

// statObject()를 이용하여 객체가 존재하는지 확인합니다.

// If the object is not found, statObject() throws an exception, // else it means that the object exists.

// 객체를 찾을 수 없으면 statObject()는 예외를 발생시키고, 그렇지 않으면 객체가 존재한다는 의미입니다.

// Execution is successful.

// 실행이 성공했습니다.

await minioClient.StatObjectAsync("mybucket", "myobject");

// Get input stream to have content of 'my-objectname' from 'my-bucketname'

// 'my-bucketname'에서 'my-objectname' 콘텐츠를 포함하는 입력 스트림을 가져옵니다.

await minioClient.GetObjectAsync("mybucket", "myobject",
                                    (stream) =>
                                    {
                                        stream.CopyTo(Console.OpenStandardOutput());
                                    });
  }
  catch (MinioException e)
  {
      Console.WriteLine("Error occurred: " + e); 
  }

GetObjectAsync(string bucketName, string objectName, long offset, long length, Action callback, ServerSideEncryption sse)

Task GetObjectAsync(string bucketName, string objectName, long offset, long length, Action callback, ServerSideEncryption sse = null, CancellationToken cancellationToken = default(CancellationToken))

Downloads the specified range bytes of an object as a stream. Both offset and length are required.

객체의 지정된 범위 바이트를 스트림으로 다운로드합니다. 오프셋과 길이가 모두 필요합니다.

Parameters

매개변수

Param

Type

Description

설명

bucketName

string

Name of the bucket.

버킷의 이름.

objectName

string

Object name in the bucket.

버킷의 객체 이름.

offset

long

Offset of the object from where stream will start

스트림이 시작되는 객체의 오프셋

length

long

Length of the object to read in from the stream

스트림에서 읽어올 객체의 길이

callback

Action

offset

long

Offset of the object from where stream will start

스트림이 시작되는 객체의 오프셋

length

long

Length of the object to read in from the stream

스트림에서 읽어올 객체의 길이

callback

Action

Call back to process stream

프로세스 스트림으로 다시 호출

sse

ServerSideEncryption

Server-side encryption option

서버측 암호화 옵션

cancellationToken

System.Threading.CancellationToken

Optional parameter. Defaults to default(CancellationToken)

선택적 매개 변수. 기본값은 default(CancellationToken)입니다

Return Type

반환 유형

Exceptions

예외

Task: Task callback returns an InputStream containing the object data.

Task: Task 콜백은 객체 데이터가 포함 된 InputStream을 반환합니다.

Listed Exceptions:

나열된 예외

InvalidBucketNameException : upon invalid bucket name.

InvalidBucketNameException : 버킷 이름이 잘못된 경우.

ConnectionException : upon connection error.

ConnectionException : 연결 오류 시

InternalClientException : upon internal library error.

InternalClientException : 내부 라이브러리 오류 시

Example

예

try
{

// Check whether the object exists using statObject().

// statObject()를 이용하여 객체가 존재하는지 확인합니다.

// If the object is not found, statObject() throws an exception, // else it means that the object exists.

// 객체를 찾을 수 없으면 statObject()는 예외를 발생시키고, 그렇지 않으면 객체가 존재한다는 의미입니다.

// Execution is successful.

// 실행이 성공했습니다.

await minioClient.StatObjectAsync("mybucket", "myobject");

// Get input stream to have content of 'my-objectname' from 'my-bucketname'

// 'my-bucketname'에서 'my-objectname' 콘텐츠를 포함하는 입력 스트림을 가져옵니다.

await minioClient.GetObjectAsync("mybucket", "myobject", 1024L, 10L,
                                    (stream) =>
                                    {
                                        stream.CopyTo(Console.OpenStandardOutput());
                                    });
  }
  catch (MinioException e)
  {
    Console.WriteLine("Error occurred: " + e);
  }

GetObjectAsync(String bucketName, String objectName, String fileName, ServerSideEncryption sse)

Task GetObjectAsync(string bucketName, string objectName, string fileName, ServerSideEncryption sse = null, CancellationToken cancellationToken = default(CancellationToken))

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

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

Parameters

매개변수

Param

Type

Description

설명

bucketName

String

Name of the bucket

버킷의 이름

objectName

String

Object name in the bucket

버킷의 객체 이름

fileName

String

File name

파일 이름

sse

ServerSideEncryption

Server-side encryption option

서버측 암호화 옵션

cancellationToken

System.Threading.CancellationToken

Optional parameter. Defaults to default(CancellationToken)

선택적 매개변수. 기본값은 default(CancellationToken)입니다.

Return Type

반환 유형

Exceptions

예외

Task

태스크

Listed Exceptions:

나열된 예외

InvalidBucketNameException : upon invalid bucket name

InvalidBucketNameException : 버킷 이름이 잘못된 경우

ConnectionException : upon connection error

ConnectionException : 연결 오류 시

InternalClientException : upon internal library error

InternalClientException : 내부 라이브러리 오류 시

Example

예

try
{

// Check whether the object exists using statObjectAsync().

// statObjectAsync()를 이용하여 객체가 존재하는지 확인합니다.

// If the object is not found, statObjectAsync() throws an exception, // else it means that the object exists.

// 객체를 찾을 수 없으면 statObjectAsync()는 예외를 발생시키고, 그렇지 않으면 객체가 존재한다는 의미입니다.

// Execution is successful.

// 실행이 성공했습니다.

await minioClient.StatObjectAsync("mybucket", "myobject");

// Gets the object's data and stores it in photo.jpg

// 객체의 데이터를 가져와서 photo.jpg에 저장합니다.

await minioClient.GetObjectAsync("mybucket", "myobject", "photo.jpg");

}
catch (MinioException e)
{
  Console.WriteLine("Error occurred: " + e);
}

PutObjectAsync(string bucketName, string objectName, Stream data, long size, string contentType, ServerSideEncryption sse)

Task PutObjectAsync(string bucketName, string objectName, Stream data, long size, string contentType, Dictionary metaData = null, ServerSideEncryption sse = null, CancellationToken cancellationToken = default(CancellationToken))

Uploads contents from a stream to objectName.

스트림의 콘텐츠를 objectName으로 업로드합니다.

Parameters

매개변수

Param

Type

Description

설명

bucketName

string

Name of the bucket

버킷의 이름

objectName

string

Object name in the bucket

버킷의 객체 이름

data

Stream

Stream to upload

업로드할 스트림

size

long

size of stream

스트림의 크기

contentType

string

Content type of the file. Defaults to "application/octet-stream"

파일의 콘텐츠 유형입니다. 기본값은 "application/octet-stream"입니다.

metaData

Dictionary

Dictionary of metadata headers. Defaults to null.

메타데이터 헤더 사전. 기본값은 null입니다.

sse

ServerSideEncryption

Server-side encryption option

서버측 암호화 옵션

| cancellationToken| System.Threading.CancellationToken | Optional parameter. Defaults to default(CancellationToken) |

| 취소토큰| System.Threading.CancellationToken | 선택적 매개변수. 기본값은 default(CancellationToken) |

Return Type

반환 유형

Exceptions

예외

Task

태스크

Listed Exceptions:

나열된 예외

InvalidBucketNameException : upon invalid bucket name

InvalidBucketNameException : 버킷 이름이 잘못된 경우

ConnectionException : upon connection error

ConnectionException : 연결 오류 시

InternalClientException : upon internal library error

InternalClientException : 내부 라이브러리 오류 시

EntityTooLargeException: upon proposed upload size exceeding max allowed

EntityTooLargeException: 제안된 업로드 크기가 허용되는 최대 크기를 초과하는 경우

UnexpectedShortReadException: data read was shorter than size of input buffer

UnexpectedShortReadException: 읽은 데이터가 입력 버퍼 크기보다 짧습니다.

ArgumentNullException: upon null input stream

ArgumentNullException: null 입력 스트림 시

Example

예

The maximum size of a single object is limited to 5TB.

단일 객체의 최대 크기는 5TB로 제한됩니다.

putObject transparently uploads objects larger than 5MiB in multiple parts. Uploaded data is carefully verified using MD5SUM signatures.

putObject는 5MiB보다 큰 객체를 여러 부분으로 투명하게 업로드합니다. 업로드된 데이터는 MD5SUM 서명을 사용하여 신중하게 확인됩니다.

try
{
    byte[] bs = File.ReadAllBytes(fileName);
    System.IO.MemoryStream filestream = new System.IO.MemoryStream(bs);

// Specify SSE-C encryption options

// SSE-C 암호화 옵션 지정

Aes aesEncryption = Aes.Create();
    aesEncryption.KeySize = 256;
    aesEncryption.GenerateKey();
    var ssec = new SSEC(aesEncryption.Key);
    await minio.PutObjectAsync("mybucket",
                               "island.jpg",
                                filestream,
                                filestream.Length,
                               "application/octet-stream", ssec);
   Console.WriteLine("island.jpg is uploaded successfully");
}
catch(MinioException e)
{
    Console.WriteLine("Error occurred: " + e);
}

PutObjectAsync(string bucketName, string objectName, string filePath, string contentType=null, ServerSideEncryption sse)

Task PutObjectAsync(string bucketName, string objectName, string filePath, string contentType = null, Dictionary metaData = null, ServerSideEncryption sse = null, CancellationToken cancellationToken = default(CancellationToken))

Uploads contents from a file to objectName.

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

Parameters

매개변수

Param

Type

Description

설명

bucketName

string

Name of the bucket

버킷의 이름

objectName

string

Object name in the bucket

버킷의 객체 이름

fileName

string

File to upload

업로드할 파일

contentType

string

Content type of the file. Defaults to "application/octet-stream"

업로드할 파일의 콘텐츠 유형입니다. 기본값은 "application/octet-stream"입니다.

metadata

Dictionary

Dictionary of metadata headers and their values.Defaults to null.

메타데이터 헤더 및 해당 값의 사전입니다. 기본값은 null입니다.

sse

ServerSideEncryption

Server-side encryption option

서버측 암호화 옵션

Dictionary

Dictionary of metadata headers and their values.Defaults to null.

메타데이터 헤더 및 해당 값의 사전입니다. 기본값은 null입니다.

sse

ServerSideEncryption

Server-side encryption option

서버측 암호화 옵션

| cancellationToken| System.Threading.CancellationToken | Optional parameter. Defaults to default(CancellationToken) |

| 취소토큰| System.Threading.CancellationToken | 선택적 매개변수. 기본값은 default(CancellationToken) |

Return Type

반환 유형

Exceptions

예외

Task

태스크

Listed Exceptions:

나열된 예외

InvalidBucketNameException : upon invalid bucket name

InvalidBucketNameException : 버킷 이름이 잘못된 경우

ConnectionException : upon connection error

ConnectionException : 연결 오류 시

InternalClientException : upon internal library error

InternalClientException : 내부 라이브러리 오류 시

EntityTooLargeException: upon proposed upload size exceeding max allowed

EntityTooLargeException: 제안된 업로드 크기가 허용되는 최대 크기를 초과하는 경우

Example

예

The maximum size of a single object is limited to 5TB.

단일 객체의 최대 크기는 5TB로 제한됩니다.

putObject transparently uploads objects larger than 5MiB in multiple parts. Uploaded data is carefully verified using MD5SUM signatures.

putObject는 5MiB보다 큰 객체를 여러 부분으로 투명하게 업로드합니다. 업로드된 데이터는 MD5SUM 서명을 사용하여 신중하게 확인됩니다.

try
{
    await minio.PutObjectAsync("mybucket", "island.jpg", "/mnt/photos/island.jpg", contentType: "application/octet-stream");
    Console.WriteLine("island.jpg is uploaded successfully");
}
catch(MinioException e)
{
    Console.WriteLine("Error occurred: " + e);
}

StatObjectAsync(string bucketName, string objectName, ServerSideEncryption sse)

Task StatObjectAsync(string bucketName, string objectName, ServerSideEncryption sse = null, CancellationToken cancellationToken = default(CancellationToken))

Gets metadata of an object.

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

Parameters

매개변수

Param

Type

Description

설명

bucketName

string

Name of the bucket

버킷의 이름

objectName

string

Object name in the bucket

버킷의 객체 이름

sse

ServerSideEncryption

Server-side encryption option

서버측 암호화 옵션

cancellationToken

System.Threading.CancellationToken

Optional parameter. Defaults to default(CancellationToken)

선택적 매개변수. 기본값은 default(CancellationToken)입니다.

Return Type

반환 유형

Exceptions

예외

Task

Populated object metadata.

채워진 객체 메타데이터.

Listed Exceptions:

나열된 예외

InvalidBucketNameException : upon invalid bucket name

InvalidBucketNameException : 버킷 이름이 잘못된 경우

ConnectionException : upon connection error

ConnectionException : 연결 오류 시

InternalClientException : upon internal library error

InternalClientException : 내부 라이브러리 오류 시

Example

예

try
{

// Get the metadata of the object.

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

ObjectStat objectStat = await minioClient.StatObjectAsync("mybucket", "myobject");
   Console.WriteLine(objectStat);
}
catch(MinioException e)
{
   Console.WriteLine("Error occurred: " + e);
}

CopyObjectAsync(string bucketName, string objectName, string destBucketName, string destObjectName = null, CopyConditions copyConditions = null, Dictionary metadata = null, ServerSideEncryption sseSrc = null, ServerSideEncryption sseDest = null)

Task CopyObjectAsync(string bucketName, string objectName, string destBucketName, string destObjectName = null, CopyConditions copyConditions = null, Dictionary metadata = null, ServerSideEncryption sseSrc = null, ServerSideEncryption sseDest = null, CancellationToken cancellationToken = default(CancellationToken))

Copies content from objectName to destObjectName.

objectName의 콘텐츠를 destObjectName으로 복사합니다.

Parameters

매개변수

Param

Type

Description

설명

bucketName

string

Name of the source bucket

소스 버킷의 이름

objectName

string

Object name in the source bucket to be copied

복사할 원본 버킷의 객체 이름

destBucketName

string

Destination bucket name

대상 버킷 이름

destObjectName

string

Destination object name to be created, if not provided defaults to source object name

생성될 대상 객체 이름. 제공되지 않은 경우 기본값은 소스 객체 이름입니다

copyConditions

CopyConditions

Map of conditions useful for applying restrictions on copy operation

복사 작업에 대한 제한을 적용하는데 유용한 조건 맵

metadata

Dictionary

Dictionary of metadata headers and their values on the destination side. Defaults to null.

대상측의 메타데이터 헤더 및 해당 값에 대한 사전입니다. 기본값은 null입니다.

sseSrc

ServerSideEncryption

Server-side encryption option for source object

소스 객체에 대한 서버측 암호화 옵션

sseDest

ServerSideEncryption

Server-side encryption option for destination object

대상 객체에 대한 서버측 암호화 옵션

cancellationToken

System.Threading.CancellationToken

Optional parameter. Defaults to default(CancellationToken)

선택적 매개변수. 기본값은 default(CancellationToken)입니다.

Return Type

반환 유형

Exceptions

예외

Task

태스크

Listed Exceptions:

나열된 예외

InvalidBucketNameException : upon invalid bucket name

InvalidBucketNameException : 버킷 이름이 잘못된 경우

ConnectionException : upon connection error

ConnectionException : 연결 오류 시

InternalClientException : upon internal library error

InternalClientException : 내부 라이브러리 오류 시

ArgumentException : upon missing bucket/object names

ArgumentException : 버킷/객체 이름이 누락된 경우

Example

예

This API performs a Server-side copy operation from a given source object to destination object.

이 API는 지정된 원본 객체에서 대상 객체로 서버측 복사 작업을 수행합니다.

try
{
   CopyConditions copyConditions = new CopyConditions();
   copyConditions.setMatchETagNone("TestETag");
   ServerSideEncryption sseSrc, sseDst;

// Uncomment to specify source and destination Server-side encryption options

// 원본 및 대상 서버측 암호화 옵션을 지정하려면 주석 처리를 해제하세요

/*
    Aes aesEncryption = Aes.Create();
    aesEncryption.KeySize = 256;
    aesEncryption.GenerateKey();
    sseSrc = new SSEC(aesEncryption.Key);
    sseDst = new SSES3();
   */
   await minioClient.CopyObjectAsync("mybucket",  "island.jpg", "mydestbucket", "processed.png", copyConditions, sseSrc:sseSrc, sseDest:sseDst);
   Console.WriteLine("island.jpg is uploaded successfully");
}
catch(MinioException e)
{
   Console.WriteLine("Error occurred: " + e);
}

RemoveObjectAsync(string bucketName, string objectName)

Task RemoveObjectAsync(string bucketName, string objectName, CancellationToken cancellationToken = default(CancellationToken))

Removes an object.

객체를 제거합니다.

Parameters

매개변수

Param

Type

Description

설명

bucketName

string

Name of the bucket @K] [@K 버킷의 이름 @K] [@E objectName

objectName

string @K] [@E Object name in the bucket @K] [@K 버킷의 객체 이름 @K] [@E cancellationToken

cancellationToken

System.Threading.CancellationToken

Optional parameter. Defaults to default(CancellationToken)

선택적 매개변수. 기본값은 default(CancellationToken)입니다

Return Type

반환 유형

Exceptions

예외

Task

태스크

Listed Exceptions:

나열된 예외

InvalidBucketNameException : upon invalid bucket name

InvalidBucketNameException : 버킷 이름이 잘못된 경우

ConnectionException : upon connection error

ConnectionException : 연결 오류 시

InternalClientException : upon internal library error

InternalClientException : 내부 라이브러리 오류 시

Example

예

try
{

// Remove objectname from the bucket my-bucketname.

// my-bucketname 버킷에서 objectname을 제거합니다.

await minioClient.RemoveObjectAsync("mybucket", "myobject");
    Console.WriteLine("successfully removed mybucket/myobject");
}
catch (MinioException e)
{
    Console.WriteLine("Error: " + e);
}

RemoveObjectAsync(string bucketName, IEnumerable objectsList)

Task> RemoveObjectAsync(string bucketName, IEnumerable objectsList, CancellationToken cancellationToken = default(CancellationToken))

Removes a list of objects.

객체 목록을 제거합니다.

Parameters

매개변수

Param

Type

Description

설명

bucketName

string

Name of the bucket @K] [@K 버킷의 이름 @K] [@E objectsList

objectsList

IEnumerable

IEnumerable of Object names

cancellationToken

System.Threading.CancellationToken

Optional parameter. Defaults to default(CancellationToken)

선택적 매개 변수. 기본값은 default(CancellationToken)입니다

Return Type

반환 유형

Exceptions

예외

Task

태스크

Listed Exceptions:

나열된 예외

InvalidBucketNameException : upon invalid bucket name

InvalidBucketNameException : 버킷 이름이 잘못된 경우

ConnectionException : upon connection error

ConnectionException : 연결 오류 시

InternalClientException : upon internal library error

InternalClientException : 내부 라이브러리 오류 시

Example

예

try
{
    List objectNames = new LinkedList();
    objectNames.add("my-objectname1");
    objectNames.add("my-objectname2");
    objectNames.add("my-objectname3");

// Remove list of objects in objectNames from the bucket bucketName.

// bucketName 버킷에서 objectNames의 객체 목록을 제거합니다.

IObservable observable = await minio.RemoveObjectAsync(bucketName, objectNames);
    IDisposable subscription = observable.Subscribe(
        deleteError => Console.WriteLine("Object: {0}", deleteError.Key),
        ex => Console.WriteLine("OnError: {0}", ex),
        () =>
        {
            Console.WriteLine("Listed all delete errors for remove objects on  " + bucketName + "\n");
        });
}
catch (MinioException e)
{
    Console.WriteLine("Error: " + e);
}

RemoveIncompleteUploadAsync(string bucketName, string objectName)

Task RemoveIncompleteUploadAsync(string bucketName, string objectName, CancellationToken cancellationToken = default(CancellationToken))

Removes a partially uploaded object.

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

Parameters

매개변수

Param

Type

Description

설명

bucketName

string

Name of the bucket @K] [@K 버킷의 이름 @K] [@E objectName

objectName

string

Object name in the bucket @K] [@K 버킷의 객체 이름 @K] [@E cancellationToken

cancellationToken

System.Threading.CancellationToken

Optional parameter. Defaults to default(CancellationToken)

선택적 매개변수. 기본값은 default(CancellationToken)입니다

Return Type

반환 유형

Exceptions

예외

Task

태스크

Listed Exceptions:

나열된 예외

InvalidBucketNameException : upon invalid bucket name

InvalidBucketNameException : 버킷 이름이 잘못된 경우

ConnectionException : upon connection error

ConnectionException : 연결 오류 시

InternalClientException : upon internal library error

InternalClientException : 내부 라이브러리 오류 시

Example

예

try
{
    [@E // Removes partially uploaded objects from buckets. @E]
    [@K // 부분적으로 업로드된 객체를 버킷에서 제거합니다. @K]
[@C
    await minioClient.RemoveIncompleteUploadAsync("mybucket", "myobject");
    Console.WriteLine("successfully removed all incomplete upload session of my-bucketname/my-objectname");
}
catch(MinioException e)
{
    Console.WriteLine("Error occurred: " + e);
}

4. Presigned operations

4. 사전 서명된 작업

PresignedGetObjectAsync(string bucketName, string objectName, int expiresInt, Dictionary reqParams = null, DateTime? reqDate = null);

Task PresignedGetObjectAsync(string bucketName, string objectName, int expiresInt, Dictionary reqParams = null, DateTime? reqDate = null)

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

매개변수

Param

Type

Description

설명

bucketName

String

Name of the bucket @K] [@K 버킷의 이름 @K] [@E objectName

objectName

String

Object name in the bucket @K] [@K 버킷의 객체 이름 @K] [@E expiresInt

expiresInt

Integer

Expiry in seconds. Default expiry is set to 7 days. @K] [@K 초 안에 만료됩니다. 기본 만료일은 7일로 설정되어 있습니다. @K] [@E reqParams

reqParams

Dictionary

Additional response header overrides supports response-expires, response-content-type, response-cache-control, response-content-disposition. @K] [@K 추가 응답 헤더 재정의는 응답 만료, 응답 콘텐츠 유형, 응답 캐시 제어, 응답 콘텐츠 처리를 지원합니다. @K] [@E reqDate

reqDate

DateTime?

Optional request date and time. Defaults to DateTime.UtcNow if unset. @K] [@K 선택적 요청 날짜 및 시간입니다. 설정되지 않은 경우 기본값은 DateTime.UtcNow입니다. @K] [@E Return Type

반환 유형

Exceptions

예외

Task

string contains URL to download the object @K] [@K 문자열에 객체를 다운로드하기 위한 URL이 포함되어 있습니다. @K] [@E Listed Exceptions: @K] [@K 나열된 예외 @K] [@E InvalidBucketNameException : upon invalid bucket name

InvalidBucketNameException : 버킷 이름이 잘못된 경우

ConnectionException : upon connection error

ConnectionException : 연결 오류 시

InvalidExpiryRangeException : upon invalid expiry range.

InvalidExpiryRangeException : 유효하지 않은 만료 범위 시.

Example

예

try
{
    String url = await minioClient.PresignedGetObjectAsync("mybucket", "myobject", 60 * 60 * 24);
    Console.WriteLine(url);
}
catch(MinioException e)
{
    Console.WriteLine("Error occurred: " + e);
}

PresignedPutObjectAsync(string bucketName, string objectName, int expiresInt)Task PresignedPutObjectAsync(string bucketName, string objectName, int expiresInt)

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일로 설정되어 있습니다.

Parameters

매개변수

Param

Type

Description

설명

bucketName

string

Name of the bucket @K] [@K 버킷의 이름 @K] [@E objectName

objectName

string

Object name in the bucket @K] [@K 버킷의 객체 이름 @K] [@E expiresInt

expiresInt

int

Expiry in seconds. Default expiry is set to 7 days. @K] [@K 초 안에 만료됩니다. 기본 만료일은 7일로 설정되어 있습니다. @K] [@E Return Type

반환 유형

Exceptions

예외

Task

string contains URL to upload the object @K] [@K 문자열에 객체를 업로드할 URL이 포함되어 있습니다. @K] [@E Listed Exceptions: @K] [@K 나열된 예외 @K] 나열된 예외 [@E InvalidBucketNameException : upon invalid bucket name

InvalidBucketNameException : 버킷 이름이 잘못된 경우

InvalidKeyException : upon an invalid access key or secret key

InvalidKeyException : 잘못된 액세스 키 또는 비밀 키가 있는 경우

ConnectionException : upon connection error

ConnectionException : 연결 오류 시

InvalidExpiryRangeException : upon invalid expiry range.

InvalidExpiryRangeException : 유효하지 않은 만료 범위 시.

Example

예

try
{
    String url = await minioClient.PresignedPutObjectAsync("mybucket", "myobject", 60 * 60 * 24);
    Console.WriteLine(url);
}
catch(MinioException e)
{
    Console.WriteLine("Error occurred: " + e);
}

PresignedPostPolicy(PostPolicy policy)Task> PresignedPostPolicyAsync(PostPolicy policy)

Allows setting policy conditions to a presigned URL for POST operations.

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

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

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

Parameters

매개변수

Param

Type

Description

설명

PostPolicy

Post policy of an object. @K] [@K 객체의 게시 정책. @K] [@E Return Type

반환 유형

Exceptions

예외

Task>: Map of strings to construct form-data.

Task>: 양식 데이터를 구성하기 위한 문자열 맵입니다.

Listed Exceptions:

나열된 예외

InvalidBucketNameException : upon invalid bucket name

InvalidBucketNameException : 버킷 이름이 잘못된 경우

ConnectionException : upon connection error

ConnectionException : 연결 오류시

NoSuchAlgorithmException : upon requested algorithm was not found during signature calculation.

NoSuchAlgorithmException : 요청 시 서명 계산 중에 알고리즘을 찾을 수 없습니다.

Example

예

try
{
    PostPolicy policy = new PostPolicy();
    policy.SetContentType("image/png");
    policy.SetUserMetadata("custom", "user");
    DateTime expiration = DateTime.UtcNow;
    policy.SetExpires(expiration.AddDays(10));
    policy.SetKey("my-objectname");
    policy.SetBucket("my-bucketname");

    Dictionary formData = minioClient.Api.PresignedPostPolicy(policy);
    string curlCommand = "curl ";
    foreach (KeyValuePair pair in formData)
    {
        curlCommand = curlCommand + " -F " + pair.Key + "=" + pair.Value;
    }
    curlCommand = curlCommand + " -F file=@/etc/bashrc https://s3.amazonaws.com/my-bucketname";
    Console.WriteLine(curlCommand);
}
catch(MinioException e)
{
    Console.WriteLine("Error occurred: " + e);
}

Client Custom Settings

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

SetAppInfo(string appName, string appVersion)

Adds application details to User-Agent.

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

Parameters

매개변수

Param

Type

Description

설명

appName

string

Name of the application performing the API requests @K] [@K API 요청을 수행하는 애플리케이션의 이름 @K] [@E appVersion

appVersion

string

Version of the application performing the API requests @K] [@K API 요청을 수행하는 애플리케이션 버전 @K] [@E Example

예

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

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

minioClient.SetAppInfo("myCloudApp", "1.0.0")SetTraceOn(IRequestLogger logger = null)

Enables HTTP tracing. The trace is written to the stdout.

HTTP 추적을 활성화합니다. 추적은 stdout에 기록됩니다.

Parameters

매개변수

Param

Type

Description

설명

logger

IRequestLogger

Implementation of interface Minio.IRequestLogger for serialization models for trace HTTP

HTTP 추적을 위한 직렬화 모델을 위한 Minio.IRequestLogger 인터페이스 구현

Example

예

// Set HTTP tracing on with default trace logger.

// 기본 추적 로거를 사용하여 HTTP 추적을 설정합니다.

minioClient.SetTraceOn()

// Set custom logger for HTTP trace

// HTTP 추적을 위한 사용자 정의 로거 설정

minioClient.SetTraceOn(new JsonNetLogger())SetTraceOff()

Disables HTTP tracing.

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

Example

예

// Sets HTTP tracing off.

// HTTP 추적을 끄도록 설정합니다.

minioClient.SetTraceOff()