mirror of
https://github.com/minio/docs.git
synced 2025-07-21 12:02:14 +03:00
213 lines
9.1 KiB
Markdown
213 lines
9.1 KiB
Markdown
# MinIO Client SDK for .NET [](https://slack.min.io)
|
|
|
|
MinIO Client SDK provides higher level APIs for MinIO and Amazon S3 compatible cloud storage services.For a complete list of APIs and examples, please take a look at the [Dotnet Client API Reference](https://docs.min.io/docs/dotnet-client-api-reference).This document assumes that you have a working VisualStudio development environment.
|
|
|
|
## Minimum Requirements
|
|
* .NET 5.0
|
|
* Visual Studio 2017
|
|
|
|
## Install from NuGet
|
|
|
|
To install [MinIO .NET package](https://www.nuget.org/packages/Minio/), run the following command in Nuget Package Manager Console.
|
|
```powershell
|
|
PM> Install-Package Minio
|
|
```
|
|
## MinIO Client Example
|
|
To connect to an Amazon S3 compatible cloud storage service, you will need to specify the following parameters.
|
|
|
|
| Parameter | Description|
|
|
| :--- | :--- |
|
|
| endpoint | URL to object storage service. |
|
|
| accessKey | Access key is the user ID that uniquely identifies your account. |
|
|
| secretKey | Secret key is the password to your account. |
|
|
| secure | Enable/Disable HTTPS support. |
|
|
|
|
The following examples uses a freely hosted public MinIO service 'play.min.io' for development purposes.
|
|
|
|
```cs
|
|
using Minio;
|
|
|
|
// Initialize the client with access credentials.
|
|
private static MinioClient minio = new MinioClient()
|
|
.WithEndpoint("play.min.io")
|
|
.WithCredentials("Q3AM3UQ867SPQQA43P2F",
|
|
"zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG")
|
|
.WithSSL()
|
|
.Build();
|
|
|
|
// Create an async task for listing buckets.
|
|
var getListBucketsTask = minio.ListBucketsAsync();
|
|
|
|
// Iterate over the list of buckets.
|
|
foreach (Bucket bucket in getListBucketsTask.Result.Buckets)
|
|
{
|
|
Console.WriteLine(bucket.Name + " " + bucket.CreationDateDateTime);
|
|
}
|
|
|
|
```
|
|
## Complete _File Uploader_ Example
|
|
|
|
This example program connects to an object storage server, creates a bucket and uploads a file to the bucket.
|
|
To run the following example, click on [Link] and start the project
|
|
```cs
|
|
using System;
|
|
using Minio;
|
|
using Minio.Exceptions;
|
|
using Minio.DataModel;
|
|
using System.Threading.Tasks;
|
|
|
|
namespace FileUploader
|
|
{
|
|
class FileUpload
|
|
{
|
|
static void Main(string[] args)
|
|
{
|
|
var endpoint = "play.min.io";
|
|
var accessKey = "Q3AM3UQ867SPQQA43P2F";
|
|
var secretKey = "zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG";
|
|
try
|
|
{
|
|
var minio = new MinioClient()
|
|
.WithEndpoint(endpoint)
|
|
.WithCredentials(accessKey,
|
|
secretKey)
|
|
.WithSSL()
|
|
.Build();
|
|
FileUpload.Run(minio).Wait();
|
|
}
|
|
catch (Exception ex)
|
|
{
|
|
Console.WriteLine(ex.Message);
|
|
}
|
|
Console.ReadLine();
|
|
}
|
|
|
|
// File uploader task.
|
|
private async static Task Run(MinioClient minio)
|
|
{
|
|
var bucketName = "mymusic";
|
|
var location = "us-east-1";
|
|
var objectName = "golden-oldies.zip";
|
|
var filePath = "C:\\Users\\username\\Downloads\\golden_oldies.mp3";
|
|
var contentType = "application/zip";
|
|
|
|
try
|
|
{
|
|
// Make a bucket on the server, if not already present.
|
|
bool found = await minio.BucketExistsAsync(bucketName);
|
|
if (!found)
|
|
{
|
|
await minio.MakeBucketAsync(bucketName, location);
|
|
}
|
|
// Upload a file to bucket.
|
|
await minio.PutObjectAsync(bucketName, objectName, filePath, contentType);
|
|
Console.WriteLine("Successfully uploaded " + objectName );
|
|
}
|
|
catch (MinioException e)
|
|
{
|
|
Console.WriteLine("File Upload Error: {0}", e.Message);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## Running MinIO Client Examples
|
|
#### On Windows
|
|
* Clone this repository and open the Minio.Sln in Visual Studio 2017.
|
|
|
|
* Enter your credentials and bucket name, object name etc.in Minio.Examples/Program.cs
|
|
Uncomment the example test cases such as below in Program.cs to run an example.
|
|
```cs
|
|
//Cases.MakeBucket.Run(minioClient, bucketName).Wait();
|
|
```
|
|
* Run the Minio.Client.Examples project from Visual Studio
|
|
#### On Linux
|
|
|
|
##### Setting .NET SDK on Linux (Ubuntu 21.10)
|
|
<blockquote> NOTE: minio-dotnet requires .NET 5.x SDK to build on Linux. </blockquote>
|
|
|
|
* Install [.Net SDK](https://docs.microsoft.com/en-us/dotnet/core/install/linux?WT.mc_id=dotnet-35129-website)
|
|
|
|
```
|
|
wget https://packages.microsoft.com/config/ubuntu/21.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
|
|
sudo dpkg -i packages-microsoft-prod.deb
|
|
rm packages-microsoft-prod.deb
|
|
```
|
|
|
|
```
|
|
sudo apt-get update; \
|
|
sudo apt-get install -y apt-transport-https && \
|
|
sudo apt-get update && \
|
|
sudo apt-get install -y dotnet-sdk-5.0
|
|
```
|
|
|
|
##### Running Minio.Examples
|
|
* Clone this project.
|
|
|
|
```
|
|
$ git clone https://github.com/minio/minio-dotnet && cd minio-dotnet
|
|
```
|
|
|
|
* Enter your credentials and bucket name, object name etc. in Minio.Examples/Program.cs
|
|
Uncomment the example test cases such as below in Program.cs to run an example.
|
|
```cs
|
|
//Cases.MakeBucket.Run(minioClient, bucketName).Wait();
|
|
```
|
|
|
|
```
|
|
dotnet build --configuration Release --no-restore
|
|
dotnet pack ./Minio/Minio.csproj --no-build --configuration Release --output ./artifacts
|
|
dotnet test ./Minio.Tests/Minio.Tests.csproj
|
|
```
|
|
|
|
#### Bucket Operations
|
|
|
|
* [MakeBucket.cs](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Cases/MakeBucket.cs)
|
|
* [ListBuckets.cs](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Cases/ListBuckets.cs)
|
|
* [BucketExists.cs](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Cases/BucketExists.cs)
|
|
* [RemoveBucket.cs](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Cases/RemoveBucket.cs)
|
|
* [ListObjects.cs](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Cases/ListObjects.cs)
|
|
* [ListIncompleteUploads.cs](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Cases/ListIncompleteUploads.cs)
|
|
* [ListenBucketNotifications.cs](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Cases/ListenBucketNotifications.cs)
|
|
|
|
#### Bucket policy Operations
|
|
* [GetPolicy.cs](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Cases/GetBucketPolicy.cs)
|
|
* [SetPolicy.cs](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Cases/SetBucketPolicy.cs)
|
|
|
|
#### Bucket notification Operations
|
|
* [GetBucketNotification.cs](/Minio.Examples/Cases/GetBucketNotification.cs)
|
|
* [SetBucketNotification.cs](/Minio.Examples/Cases/SetBucketNotification.cs)
|
|
* [RemoveAllBucketNotifications.cs](/Minio.Examples/Cases/RemoveAllBucketNotifications.cs)
|
|
|
|
#### File Object Operations
|
|
* [FGetObject.cs](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Cases/FGetObject.cs)
|
|
* [FPutObject.cs](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Cases/FPutObject.cs)
|
|
|
|
#### Object Operations
|
|
* [GetObject.cs](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Cases/GetObject.cs)
|
|
* [GetPartialObject.cs](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Cases/GetPartialObject.cs)
|
|
* [SelectObjectContent.cs](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Cases/SelectObjectContent.cs)
|
|
|
|
* [PutObject.cs](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Cases/PutObject.cs)
|
|
* [StatObject.cs](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Cases/StatObject.cs)
|
|
* [RemoveObject.cs](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Cases/RemoveObject.cs)
|
|
* [RemoveObjects.cs](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Cases/RemoveObjects.cs)
|
|
* [CopyObject.cs](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Cases/CopyObject.cs)
|
|
* [CopyObject.cs](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Cases/CopyObjectMetadata.cs)
|
|
* [RemoveIncompleteUpload.cs](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Cases/RemoveIncompleteUpload.cs)
|
|
|
|
#### Presigned Operations
|
|
* [PresignedGetObject.cs](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Cases/PresignedGetObject.cs)
|
|
* [PresignedPutObject.cs](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Cases/PresignedPutObject.cs)
|
|
* [PresignedPostPolicy.cs](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Cases/PresignedPostPolicy.cs)
|
|
|
|
#### Client Custom Settings
|
|
* [SetAppInfo](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Program.cs)
|
|
* [SetTraceOn](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Program.cs)
|
|
* [SetTraceOff](https://github.com/minio/minio-dotnet/blob/master/Minio.Examples/Program.cs)
|
|
|
|
## Explore Further
|
|
* [Complete Documentation](https://docs.min.io)
|
|
* [MinIO .NET SDK API Reference](https://docs.min.io/docs/dotnet-client-api-reference)
|