OSS に保存されているイメージに対して、サイズ変更、トリミング、回転、ウォーターマークの追加などの一連の操作を実行するには、イメージスタイルを作成します。イメージスタイルを使用すると、複数の画像処理操作を定義できます。このスタイルをバケット内のイメージに適用することで、イメージを迅速に処理および変換できます。
注意事項
イメージスタイルがサポートする画像処理パラメーターの詳細については、「画像処理」をご参照ください。
このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用します。OSS と同じリージョンにある他の Alibaba Cloud サービスから OSS にアクセスする場合は、内部エンドポイントを使用します。OSS のリージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。
このトピックでは、アクセス認証情報は環境変数から取得します。アクセス認証情報の設定方法の詳細については、「アクセス認証情報の設定」をご参照ください。
このトピックでは、OSS エンドポイントを使用して OSSClient インスタンスを作成します。カスタムドメイン名またはセキュリティトークンサービス (STS) を使用して OSSClient インスタンスを作成する場合は、「クライアントの設定 (Go SDK V1)」をご参照ください。
デフォルトでは、Alibaba Cloud アカウントには、イメージスタイル操作に必要な権限が付与されています。Resource Access Management (RAM) ユーザーまたは STS を使用してイメージスタイル操作を実行する場合は、次の権限が必要です：
イメージスタイルを作成するには、
oss:PutStyle権限が必要です。バケット内の特定のイメージスタイルの情報をクエリするには、
oss:GetStyle権限が必要です。バケット内に作成されたすべてのイメージスタイルをクエリするには、
oss:ListStyle権限が必要です。バケットから特定のイメージスタイルを削除するには、
oss:DeleteStyle権限が必要です。
詳細については、「RAM ユーザーへのカスタムアクセスポリシーの付与」をご参照ください。
イメージスタイルの作成
バケットには最大 50 個のイメージスタイルを設定できます。次のコードは、イメージスタイルの作成方法の例を示しています。
package main
import (
"fmt"
"os"
"github.com/aliyun/aliyun-oss-go-sdk/oss"
)
func main() {
// 環境変数からアクセス認証情報を取得します。このサンプルコードを実行する前に、環境変数 OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET が設定されていることを確認してください。
provider, err := oss.NewEnvironmentVariableCredentialsProvider()
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// OSSClient インスタンスを作成します。
// yourEndpoint をバケットのエンドポイントに設定します。たとえば、中国 (杭州) リージョンの場合、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。他のリージョンの場合は、実際のエンドポイントを使用します。
// yourRegion をバケットが配置されているリージョンに設定します。たとえば、中国 (杭州) リージョンの場合、リージョンを cn-hangzhou に設定します。他のリージョンの場合は、実際のリージョンを使用します。
clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
clientOptions = append(clientOptions, oss.Region("yourRegion"))
// 署名バージョンを設定します。
clientOptions = append(clientOptions, oss.AuthVersion(oss.AuthV4))
client, err := oss.New("yourEndpoint", "", "", clientOptions...)
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// バケット名を指定します (例: examplebucket)。
bucketName := "examplebucket"
// イメージスタイルの画像操作を設定します。たとえば、イメージを元のサイズの 63% にサイズ変更し、相対品質を 90% に設定します。
styleContent := "image/resize,p_63/quality,q_90"
// イメージスタイル名を設定します (例: imagestyle)。
styleName := "imagestyle"
err = client.PutBucketStyle(bucketName, styleName, styleContent)
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
fmt.Println("Bucket Style Set Success!")
}
特定のイメージスタイルのクエリ
次のコードは、バケット内の特定のイメージスタイルに関する情報をクエリする方法の例を示しています。
package main
import (
"fmt"
"os"
"github.com/aliyun/aliyun-oss-go-sdk/oss"
)
func main() {
// 環境変数からアクセス認証情報を取得します。このサンプルコードを実行する前に、環境変数 OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET が設定されていることを確認してください。
provider, err := oss.NewEnvironmentVariableCredentialsProvider()
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// OSSClient インスタンスを作成します。
// yourEndpoint をバケットのエンドポイントに設定します。たとえば、中国 (杭州) リージョンの場合、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。他のリージョンの場合は、実際のエンドポイントを使用します。
// yourRegion をバケットが配置されているリージョンに設定します。たとえば、中国 (杭州) リージョンの場合、リージョンを cn-hangzhou に設定します。他のリージョンの場合は、実際のリージョンを使用します。
clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
clientOptions = append(clientOptions, oss.Region("yourRegion"))
// 署名バージョンを設定します。
clientOptions = append(clientOptions, oss.AuthVersion(oss.AuthV4))
client, err := oss.New("yourEndpoint", "", "", clientOptions...)
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// バケット名を指定します (例: examplebucket)。
bucketName := "examplebucket"
// イメージスタイル名を指定します (例: imagestyle)。
styleName := "imagestyle"
// examplebucket 内の指定されたイメージスタイルの情報をクエリします。
style, err := client.GetBucketStyle(bucketName, styleName)
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
fmt.Printf("Style Name:%s\n", style.Name)
fmt.Printf("Style Content:%s\n", style.Content)
fmt.Printf("Style Create Time:%s\n", style.CreateTime)
fmt.Printf("Style Last Modify Time:%s\n", style.LastModifyTime)
}
すべてのイメージスタイルのクエリ
次のコードは、バケット内に作成されたすべてのイメージスタイルをクエリする方法の例を示しています。
package main
import (
"fmt"
"os"
"github.com/aliyun/aliyun-oss-go-sdk/oss"
)
func main() {
// 環境変数からアクセス認証情報を取得します。このサンプルコードを実行する前に、環境変数 OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET が設定されていることを確認してください。
provider, err := oss.NewEnvironmentVariableCredentialsProvider()
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// OSSClient インスタンスを作成します。
// yourEndpoint をバケットのエンドポイントに設定します。たとえば、中国 (杭州) リージョンの場合、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。他のリージョンの場合は、実際のエンドポイントを使用します。
// yourRegion をバケットが配置されているリージョンに設定します。たとえば、中国 (杭州) リージョンの場合、リージョンを cn-hangzhou に設定します。他のリージョンの場合は、実際のリージョンを使用します。
clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
clientOptions = append(clientOptions, oss.Region("yourRegion"))
// 署名バージョンを設定します。
clientOptions = append(clientOptions, oss.AuthVersion(oss.AuthV4))
client, err := oss.New("yourEndpoint", "", "", clientOptions...)
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// バケット名を指定します (例: examplebucket)。
bucketName := "examplebucket"
// examplebucket 内に作成されたすべてのイメージスタイルをクエリします。
list, err := client.ListBucketStyle(bucketName)
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
for _, style := range list.Style {
fmt.Printf("Style Name:%s\n", style.Name)
fmt.Printf("Style Content:%s\n", style.Content)
fmt.Printf("Style Create Time:%s\n", style.CreateTime)
fmt.Printf("Style Last Modify Time:%s\n", style.LastModifyTime)
}
}
特定のイメージスタイルの削除
次のコードは、バケットから特定のイメージスタイルを削除する方法の例を示しています。
package main
import (
"fmt"
"os"
"github.com/aliyun/aliyun-oss-go-sdk/oss"
)
func main() {
// 環境変数からアクセス認証情報を取得します。このサンプルコードを実行する前に、環境変数 OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET が設定されていることを確認してください。
provider, err := oss.NewEnvironmentVariableCredentialsProvider()
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// OSSClient インスタンスを作成します。
// yourEndpoint をバケットのエンドポイントに設定します。たとえば、中国 (杭州) リージョンの場合、エンドポイントを https://oss-cn-hangzhou.aliyuncs.com に設定します。他のリージョンの場合は、実際のエンドポイントを使用します。
// yourRegion をバケットが配置されているリージョンに設定します。たとえば、中国 (杭州) リージョンの場合、リージョンを cn-hangzhou に設定します。他のリージョンの場合は、実際のリージョンを使用します。
clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
clientOptions = append(clientOptions, oss.Region("yourRegion"))
// 署名バージョンを設定します。
clientOptions = append(clientOptions, oss.AuthVersion(oss.AuthV4))
client, err := oss.New("yourEndpoint", "", "", clientOptions...)
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// バケット名を指定します (例: examplebucket)。
bucketName := "examplebucket"
// イメージスタイル名を指定します (例: imagestyle)。
styleName := "imagestyle"
// 指定されたイメージスタイルを削除します。
err = client.DeleteBucketStyle(bucketName, styleName)
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
fmt.Println("Bucket Style Delete Success!")
}
関連ドキュメント
イメージスタイルを作成する API 操作の詳細については、「PutStyle」をご参照ください。
バケット内の特定のイメージスタイルをクエリする API 操作の詳細については、「GetStyle」をご参照ください。
バケット内に作成されたすべてのイメージスタイルをクエリする API 操作の詳細については、「ListStyle」をご参照ください。
バケットから特定のイメージスタイルを削除する API 操作の詳細については、「DeleteStyle」をご参照ください。