すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:IMG

最終更新日:Feb 22, 2024

Image Processing (IMG) は、大量のデータを処理するのに役立つObject Storage service (OSS) が提供する、安全で費用対効果の高い信頼性の高い画像処理サービスです。 ソース画像をOSSにアップロードした後、RESTful APIを呼び出して、いつでもどこでもインターネットに接続されているデバイスで画像を処理できます。

使用上の注意

  • このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用します。 OSSと同じリージョンにある他のAlibaba CloudサービスからOSSにアクセスする場合は、内部エンドポイントを使用します。 OSSリージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。

  • このトピックでは、OSSエンドポイントを使用してOSSClientインスタンスを作成します。 カスタムドメイン名またはSTS (Security Token Service) を使用してOSSClientインスタンスを作成する場合は、「初期化」をご参照ください。

IMGパラメータを使用した画像の処理

  • 単一のIMGパラメータを使用してイメージを処理し、ローカルコンピュータにイメージを保存する

    システムを使用して;
    System.IOを使用する。Aliyun.OSSを使用します。Aliyun.OSS.Common; を使用
    Aliyun.OSS.Utilを使用します。名前空間サンプル
    {
        公共クラスプログラム
        {
            public static voidメイン (string[] args)
            {
                // バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 
                var endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
                // 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。  
                var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID");
                var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET");
                // ソースイメージが保存されているバケットの名前を指定します。 例: examplebucket. 
                var bucketName = "examplebucket";
                // ソースイメージの名前を指定します。 ソースイメージがバケットのルートディレクトリに保存されていない場合は、イメージオブジェクトのフルパスを指定する必要があります。 例: exampledir/example.jpg 
                var objectName = "exampledir/example.jpg";
                // ソースイメージのローカルパスを指定します。 
                var localImageFilename = "D :\\ localpath\\example.jpg";
                // Create an OSSClient instance. 
                var client = new OssClient(endpoint, accessKeyId, accessKeySecret);
                try
                {
                    // 画像のサイズを100 × 100ピクセルに変更します。 
                    var process = "image/resize,m_fixed,w_100,h_100";
                    var ossObject = client.GetObject(new GetObjectRequest(bucketName, objectName, process));
                    // 処理されたイメージの名前を指定します。 
                    WriteToFile(localImageFilename, ossObject.Content);
                }
                catch (OssException ex)
                {
                    Console.WriteLine("Failed with error code: {0}; エラー情報: {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);
                }
            }
            private static void WriteToFile(string filePath, Stream stream)
            {
                using (var requestStream = stream)
                {
                    using (var fs = File.Open(filePath, FileMode.OpenOrCreate))
                    {
                        IoUtils.WriteTo(stream, fs);
                    }
                }
            }
        }
    }

  • 異なるIMGパラメータを使用して画像を処理し、画像をローカルコンピュータに個別に保存する

    システムを使用して;
    System.IOを使用する。Aliyun.OSSを使用します。Aliyun.OSS.Common; を使用
    Aliyun.OSS.Utilを使用します。名前空間サンプル
    {
        公共クラスプログラム
        {
            public static voidメイン (string[] args)
            {
                // バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 
                var endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
                // 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。  
                var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID");
                var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET");
                // ソースイメージが保存されているバケットの名前を指定します。 例: examplebucket. 
                var bucketName = "examplebucket";
                // ソースイメージの名前を指定します。 ソースイメージがバケットのルートディレクトリに保存されていない場合は、イメージオブジェクトのフルパスを指定する必要があります。 例: exampledir/example.jpg 
                var objectName = "exampledir/example.jpg";
                // ソースイメージのローカルパスを指定します。 
                var localImageFilename = "D :\\ localpath\\example.jpg";
           
                // Create an OSSClient instance. 
                var client = new OssClient(endpoint, accessKeyId, accessKeySecret);
                try
                {
                    // 画像が指定されたバケットに存在しない場合は、画像をバケットにアップロードします。    
                    // client.PutObject(bucketName, objectName, localImageFilename);
                    // 画像のサイズを100 × 100ピクセルに変更します。 
                    var process = "image/resize,m_fixed,w_100,h_100";
                    var ossObject = client.GetObject(new GetObjectRequest(bucketName, objectName, process));
                    // 処理されたイメージの名前を指定します。 
                    WriteToFile(localImageFilename, ossObject.Content);
                    // 座標ペアで指定された位置から100 × 100ピクセルに画像をトリミングします (100、100) 。 
                    process = "image/crop,w_100,h_100,x_100,y_100";
                    ossObject = client.GetObject(new GetObjectRequest(bucketName, objectName, process));
                    WriteToFile(localImageFilename , ossObject.Content);
                    // 画像を90度回転させます。 
                    process = "image/rotate,90";
                    ossObject = client.GetObject(new GetObjectRequest(bucketName, objectName, process));
                    WriteToFile(localImageFilename , ossObject.Content);
                }
                catch (OssException ex)
                {
                    Console.WriteLine("Failed with error code: {0}; エラー情報: {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);
                }
            }
            private static void WriteToFile(string filePath, Stream stream)
            {
                using (var requestStream = stream)
                {
                    using (var fs = File.Open(filePath, FileMode.OpenOrCreate))
                    {
                        IoUtils.WriteTo(stream, fs);
                    }
                }
            }
        }
    }
  • 複数のIMGパラメータを使用して画像を処理し、画像をローカルコンピュータに保存する

    次のコードでは、複数のIMGパラメーターを使用してイメージを処理する方法の例を示します。 IMGパラメータは、スラッシュ (/) で区切られます。

    システムを使用して;
    System.IOを使用する。Aliyun.OSSを使用します。Aliyun.OSS.Common; を使用
    Aliyun.OSS.Utilを使用します。名前空間ImageProcessCascade
    {
        class Program
        {
            static void Main(string[] args)
            {
                Program.ImageProcessCascade();
                Console.ReadKey();
            }
            public static void ImageProcessCascade()
            {
                // バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 
                var endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
                // 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。  
                var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID");
                var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET");
                // ソースイメージが保存されているバケットの名前を指定します。 例: examplebucket. 
                var bucketName = "examplebucket";
                // ソースイメージの名前を指定します。 ソースイメージがバケットのルートディレクトリに保存されていない場合は、イメージオブジェクトのフルパスを指定する必要があります。 例: exampledir/example.jpg 
                var objectName = "exampledir/example.jpg";
                // ソースイメージのローカルパスを指定します。 
               var localImageFilename = "D :\\ localpath\\example.jpg";
                // Create an OSSClient instance. 
                var client = new OssClient(endpoint, accessKeyId, accessKeySecret);
                try
                {
                    // ソースイメージが指定されたバケットに存在しない場合は、イメージをバケットにアップロードします。    
                    // client.PutObject(bucketName, objectName, localImageFilename);
                    // 画像のサイズを100 × 100ピクセルに変更した後、画像を90度回転させます。 
                    var process = "image/resize,m_fixed,w_100,h_100/rotate,90";
                    var ossObject = client.GetObject(new GetObjectRequest(bucketName, objectName, process));
                    // 処理されたイメージの名前を指定します。 
                    WriteToFile(localImageFilename, ossObject.Content);
                    Console.WriteLine("Get Object:{0} with process:{1} succeeded ", objectName, process);
                }
                catch (OssException ex)
                {
                    Console.WriteLine("Failed with error code: {0}; エラー情報: {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);
                }
            }
            private static void WriteToFile(string filePath, Stream stream)
            {
                using (var requestStream = stream)
                {
                    using (var fs = File.Open(filePath, FileMode.OpenOrCreate))
                    {
                        IoUtils.WriteTo(stream, fs);
                    }
                }
            }
        }
    }

イメージスタイルを使用してイメージを処理する

スタイル内に複数のIMGパラメータをカプセル化し、そのスタイルを使用してイメージを処理できます。 詳細については、「イメージスタイル」をご参照ください。 次のコードは、イメージスタイルを使用してイメージを処理する方法の例を示しています。

システムを使用して;
System.IOを使用する。Aliyun.OSSを使用します。Aliyun.OSS.Common; を使用
Aliyun.OSS.Utilを使用します。名前空間ImageProcessCustom
{
    class Program
    {
        static void Main(string[] args)
        {
            Program.ImageProcessCustomStyle();
            Console.ReadKey();
        }
        public static void ImageProcessCustomStyle()
        {
            // バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 
            var endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
            // 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。  
            var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID");
            var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET");
            // ソースイメージが保存されているバケットの名前を指定します。 例: examplebucket. 
            var bucketName = "examplebucket";
            // ソースイメージの名前を指定します。 ソースイメージがバケットのルートディレクトリに保存されていない場合は、イメージオブジェクトのフルパスを指定する必要があります。 例: exampledir/example.jpg 
            var objectName = "exampledir/example.jpg";
            // ソースイメージのローカルパスを指定します。 
            var localImageFilename = "D :\\ localpath\\example.jpg";
            // Create an OSSClient instance. 
            var client = new OssClient(endpoint, accessKeyId, accessKeySecret);
            try
            {
                // ソースイメージが指定されたバケットに存在しない場合は、イメージをバケットにアップロードします。    
                // client.PutObject(bucketName, objectName, localImageFilename);
                // イメージスタイルを使用してイメージを処理します。 この例では、yourCustomStyleNameをOSSコンソールで作成したイメージスタイルの名前に置き換えます。 
                var process = "style/yourCustomStyleName";
                var ossObject = client.GetObject(new GetObjectRequest(bucketName, objectName, process));
                // 処理されたイメージの名前を指定します。             
                WriteToFile(localImageFilename, ossObject.Content);
                Console.WriteLine("Get Object:{0} with process:{1} succeeded ", objectName, process);
            }
            catch (OssException ex)
            {
                Console.WriteLine("Failed with error code: {0}; エラー情報: {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);
            }
        }
        private static void WriteToFile(string filePath, Stream stream)
        {
            using (var requestStream = stream)
            {
                using (var fs = File.Open(filePath, FileMode.OpenOrCreate))
                {
                    IoUtils.WriteTo(stream, fs);
                }
            }
        }
    }
}

IMGパラメータを含む署名付きオブジェクトURLを生成する

プライベートオブジェクトのURLに署名する必要があります。 署名付きURLの末尾にIMGパラメーターを直接追加することはできません。 プライベートイメージオブジェクトを処理する場合は、署名にIMGパラメータを追加します。 次のコードは、署名にIMGパラメーターを追加する方法の例を示しています。

Aliyun.OSSを使用した

Aliyun.OSS.Common; を使用

// バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 
var endpoint = "yourEndpoint";
// 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。  
var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID");
var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET");
// ソースイメージが保存されているバケットの名前を指定します。 例: examplebucket. 
var bucketName = "examplebucket";
// ソースイメージの名前を指定します。 イメージがバケットのルートディレクトリに保存されていない場合は、イメージのフルパスを指定する必要があります。 例: exampledir/example.jpg 
var objectName = "exampledir/exampledir.jpg";
// OSSClientインスタンスを作成します。 
var client = new OssClient (エンドポイント、accessKeyId、accessKeySecret);
トライ
{
    // 画像のサイズを100 × 100ピクセルに変更します。 
    var process = "image/resize,m_fixed,w_100,h_100";
    var req = new GeneratePresignedUriRequest(bucketName, objectName, SignHttpMethod.Get)
    {
        Expiration = DateTime.Now.AddHours(1),
        Process = process
    };
    // 署名付きURLを生成します。 
    var uri = client.GeneratePresignedUri(req);
    Console.WriteLine("Generate Presigned Uri:{0} with process:{1} successed", uri, process);
}
キャッチ (OssException ex)
{
    Console.WriteLine("Failed with error code: {0}; エラー情報: {1} 。 \nRequestID:{2}\tHostID:{3}"、
        ex.ErrorCode, ex.Message, ex.RequestId, ex.HostId);
}
キャッチ (例外ex)
{
    Console.WriteLine("Failed with error info: {0}" 、メッセージなど);
} 

参考資料

  • IMGの完全なサンプルコードについては、『GitHub』をご参照ください。

  • サポートされるIMGパラメーターの詳細については、「IMGパラメーター」をご参照ください。