Object Storage Service:クイックスタート (C# SDK V1)

RAM ユーザーの AccessKey ペアの作成

次のいずれかの方法を使用して、OSS の管理権限を持つ RAM ユーザーの AccessKey ペアを作成します。

• RAM コンソール — 手順については、「OSS の管理権限を持つ RAM ユーザーの AccessKey ペアを作成する」をご参照ください。

• ROS テンプレート — Resource Orchestration Service (ROS) テンプレートを使用して、OSS の管理権限を持つ RAM ユーザーの AccessKey ペアを迅速に作成します。ROS コンソールの [スタックの作成] ページで、[セキュリティの確認] の下にあるチェックボックスをオンにし、[作成] をクリックします。スタックが作成されたら、[出力] から作成された AccessKey ペアをコピーします。

環境変数の設定

RAM ユーザーの AccessKey ペアを使用して、開発環境のオペレーティングシステムで環境変数を設定します。

echo "export OSS_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.bashrc
echo "export OSS_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.bashrc

source ~/.bashrc

echo $OSS_ACCESS_KEY_ID
echo $OSS_ACCESS_KEY_SECRET

echo $SHELL

echo "export OSS_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.zshrc
echo "export OSS_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.zshrc

source ~/.zshrc

echo $OSS_ACCESS_KEY_ID
echo $OSS_ACCESS_KEY_SECRET

echo "export OSS_ACCESS_KEY_ID='YOUR_ACCESS_KEY_ID'" >> ~/.bash_profile
echo "export OSS_ACCESS_KEY_SECRET='YOUR_ACCESS_KEY_SECRET'" >> ~/.bash_profile

source ~/.bash_profile

echo $OSS_ACCESS_KEY_ID
echo $OSS_ACCESS_KEY_SECRET

setx OSS_ACCESS_KEY_ID "YOUR_ACCESS_KEY_ID"
setx OSS_ACCESS_KEY_SECRET "YOUR_ACCESS_KEY_SECRET"

echo %OSS_ACCESS_KEY_ID%
echo %OSS_ACCESS_KEY_SECRET%

[Environment]::SetEnvironmentVariable("OSS_ACCESS_KEY_ID", "YOUR_ACCESS_KEY_ID", [EnvironmentVariableTarget]::User)
[Environment]::SetEnvironmentVariable("OSS_ACCESS_KEY_SECRET", "YOUR_ACCESS_KEY_SECRET", [EnvironmentVariableTarget]::User)

[Environment]::GetEnvironmentVariable("OSS_ACCESS_KEY_ID", [EnvironmentVariableTarget]::User)
[Environment]::GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET", [EnvironmentVariableTarget]::User)

上記のようにシステム環境変数を変更した後、IDE、コマンドラインインターフェイス、その他のデスクトップアプリケーション、バックグラウンドサービスなど、ビルド環境と実行環境を再起動またはリフレッシュして、最新のシステム環境変数がロードされるようにしてください。

バケットの作成

次のサンプルコードは、バケットを作成します。

using Aliyun.OSS;
// バケットが配置されているリージョンのエンドポイントに yourEndpoint を設定します。
var endpoint = "yourEndpoint";
// バケットが配置されているリージョンの ID に yourRegion を設定します。
var region = "yourRegion";
// 環境変数からアクセス認証情報を取得します。
var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID");
var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET");
// バケットの名前を指定します。
var bucketName = "yourBucketName";
// ClientConfiguration インスタンスを作成し、必要に応じてデフォルトのパラメーターを変更します。
var conf = new ClientConfiguration();
// V4 署名アルゴリズムを指定します。
conf.SignatureVersion = SignatureVersion.V4;
// OssClient インスタンスを作成します。
var client = new OssClient(endpoint, accessKeyId, accessKeySecret, conf);
client.SetRegion(region);
try
{
    // バケットを作成します。
    var bucket = client.CreateBucket(bucketName);
    Console.WriteLine("Create bucket succeeded, {0} ", bucket.Name);
}
catch (Exception ex)
{
    Console.WriteLine("Create bucket failed, {0}", ex.Message);
}

バケットが作成されると、プログラムは Create bucket succeeded とバケット名を出力します。

オブジェクトのアップロード

次のサンプルコードは、ローカルファイルをオブジェクトとしてバケットにアップロードします。

using Aliyun.OSS;
// バケットが配置されているリージョンのエンドポイントに yourEndpoint を設定します。
var endpoint = "yourEndpoint";
// バケットが配置されているリージョンの ID に yourRegion を設定します。
var region = "yourRegion";
// 環境変数からアクセス認証情報を取得します。
var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID");
var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET");
// バケットの名前を指定します。
var bucketName = "examplebucket";
// オブジェクトの完全なパスを指定します。バケット名を含めることはできません。
var objectName = "exampledir/exampleobject.txt";
// アップロードするローカルファイルの完全なパスを指定します。
var localFilename = "D:\\localpath\\examplefile.txt";
// ClientConfiguration インスタンスを作成し、必要に応じてデフォルトのパラメーターを変更します。
var conf = new ClientConfiguration();
// V4 署名アルゴリズムを指定します。
conf.SignatureVersion = SignatureVersion.V4;
// OssClient インスタンスを作成します。
var client = new OssClient(endpoint, accessKeyId, accessKeySecret, conf);
client.SetRegion(region);
try
{
    // オブジェクトをアップロードします。
    var result = client.PutObject(bucketName, objectName, localFilename);
    Console.WriteLine("Put object succeeded, ETag: {0} ", result.ETag);
}
catch (Exception ex)
{
    Console.WriteLine("Put object failed, {0}", ex.Message);
}

オブジェクトがアップロードされると、プログラムは Put object succeeded とオブジェクトの ETag を出力します。

オブジェクトのダウンロード

次のサンプルコードは、オブジェクトをローカルファイルにダウンロードします。

using Aliyun.OSS;
using Aliyun.OSS.Common;
// バケットが配置されているリージョンのエンドポイントに yourEndpoint を設定します。
var endpoint = "yourEndpoint";
// バケットが配置されているリージョンの ID に yourRegion を設定します。
var region = "yourRegion";
// 環境変数からアクセス認証情報を取得します。
var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID");
var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET");
// バケットの名前を指定します。
var bucketName = "examplebucket";
// オブジェクトの完全なパスを指定します。バケット名を含めることはできません。
var objectName = "exampledir/exampleobject.txt";
// オブジェクトをダウンロードするローカルファイルの完全なパスを指定します。
var downloadFilename = "D:\\localpath\\examplefile.txt";
// ClientConfiguration インスタンスを作成し、必要に応じてデフォルトのパラメーターを変更します。
var conf = new ClientConfiguration();
// V4 署名アルゴリズムを指定します。
conf.SignatureVersion = SignatureVersion.V4;
// OssClient インスタンスを作成します。
var client = new OssClient(endpoint, accessKeyId, accessKeySecret, conf);
client.SetRegion(region);
try
{   
    // オブジェクトをダウンロードします。
    var result = client.GetObject(bucketName, objectName);
    using (var requestStream = result.Content)
    {
        using (var fs = File.Open(downloadFilename, FileMode.OpenOrCreate))
        {
            int length = 4 * 1024;
            var buf = new byte[length];
            do
            {
                length = requestStream.Read(buf, 0, length);
                fs.Write(buf, 0, length);
            } while (length != 0);
        }
    }
    Console.WriteLine("Get object succeeded");
}
catch (OssException ex)
{
    Console.WriteLine("Failed with error code: {0}; Error info: {1}. \nRequestID:{2}\tHostID:{3}",
        ex.ErrorCode, ex.Message, ex.RequestId, ex.HostId);
}
catch (Exception ex)
{
    Console.WriteLine("Failed with error info: {0}", ex.Message);
}

オブジェクトがダウンロードされると、プログラムは Get object succeeded を出力し、オブジェクトのコンテンツがローカルファイルに書き込まれます。

オブジェクトのリスト表示

次のサンプルコードは、バケット内のオブジェクトをリスト表示します。

using Aliyun.OSS;
using Aliyun.OSS.Common;
// バケットが配置されているリージョンのエンドポイントに yourEndpoint を設定します。
var endpoint = "yourEndpoint";
// バケットが配置されているリージョンの ID に yourRegion を設定します。
var region = "yourRegion";
// 環境変数からアクセス認証情報を取得します。
var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID");
var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET");
// バケットの名前を指定します。
var bucketName = "examplebucket";
// ClientConfiguration インスタンスを作成し、必要に応じてデフォルトのパラメーターを変更します。
var conf = new ClientConfiguration();
// V4 署名アルゴリズムを指定します。
conf.SignatureVersion = SignatureVersion.V4;
// OssClient インスタンスを作成します。
var client = new OssClient(endpoint, accessKeyId, accessKeySecret, conf);
client.SetRegion(region);
try
{
    var objects = new List<string>();
    ObjectListing result = null;
    string nextMarker = string.Empty;
    do
    {
        var listObjectsRequest = new ListObjectsRequest(bucketName)
        {
            Marker = nextMarker,
        };
        // オブジェクトをリスト表示します。
        result = client.ListObjects(listObjectsRequest);
        foreach (var summary in result.ObjectSummaries)
        {
            Console.WriteLine(summary.Key);
            objects.Add(summary.Key);
        }
        nextMarker = result.NextMarker;
    } while (result.IsTruncated);
    Console.WriteLine("List objects of bucket:{0} succeeded ", bucketName);
}
catch (OssException ex)
{
    Console.WriteLine("Failed with error code: {0}; Error info: {1}. \nRequestID:{2}\tHostID:{3}",
        ex.ErrorCode, ex.Message, ex.RequestId, ex.HostId);
}
catch (Exception ex)
{
    Console.WriteLine("Failed with error info: {0}", ex.Message);
}

オブジェクトがリスト表示されると、プログラムは各オブジェクトの名前を出力し、次に List objects of bucket とバケット名を出力します。

オブジェクトの削除

次のサンプルコードは、バケットからオブジェクトを削除します。

using Aliyun.OSS;
// バケットが配置されているリージョンのエンドポイントに yourEndpoint を設定します。
var endpoint = "yourEndpoint";
// バケットが配置されているリージョンの ID に yourRegion を設定します。
var region = "yourRegion";
// 環境変数からアクセス認証情報を取得します。
var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID");
var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET");
// バケットの名前を指定します。
var bucketName = "examplebucket";
// オブジェクトの完全なパスを指定します。バケット名を含めることはできません。
var objectName = "exampledir/exampleobject.txt";
// ClientConfiguration インスタンスを作成し、必要に応じてデフォルトのパラメーターを変更します。
var conf = new ClientConfiguration();
// V4 署名アルゴリズムを指定します。
conf.SignatureVersion = SignatureVersion.V4;
// OssClient インスタンスを作成します。
var client = new OssClient(endpoint, accessKeyId, accessKeySecret, conf);
client.SetRegion(region);
try
{
    // オブジェクトを削除します。
    client.DeleteObject(bucketName, objectName);
    Console.WriteLine("Delete object succeeded");
}
catch (Exception ex)
{
    Console.WriteLine("Delete object failed, {0}", ex.Message);
}

オブジェクトが削除されると、プログラムは Delete object succeeded を出力します。