バケットに設定された特定のイメージスタイルの情報を照会します。
注意事項
デフォルトでは、Alibaba Cloud アカウントはバケットの特定のイメージスタイルを照会する権限を持っています。RAM ユーザーとして、または Security Token Service (STS) を使用してイメージスタイルを照会する場合は、RAM ユーザーに oss:GetStyle 権限を付与する必要があります。 詳細については、「RAM ポリシーの一般的な例」をご参照ください。
リクエスト構文
バケットに設定された特定のイメージスタイルを照会するには、styleName パラメーターを使用して、GET /?style&styleName=imagestyle HTTP/1.1 のようにスタイル名を指定する必要があります。
GET /?style&styleName=styleName HTTP/1.1
Date: GMT Date
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValueリクエストヘッダー
GetStyle リクエストのヘッダーはすべて、共通リクエストヘッダーです。 詳細については、「共通 HTTP ヘッダー」をご参照ください。
レスポンスヘッダー
GetStyle リクエストのレスポンスにあるヘッダーはすべて、共通レスポンスヘッダーです。 詳細については、「共通 HTTP ヘッダー」をご参照ください。
レスポンス要素
要素 | タイプ | 例 | 説明 |
Style | コンテナー | N/A | スタイル情報を格納するコンテナーです。 親ノード:なし 子ノード:Name、Content、Category、CreateTime、LastModifyTime |
Name | 文字列 | imagestyle | イメージスタイルの名前です。 親ノード:Style 子ノード:なし |
Content | 文字列 | image/resize,p_50 | イメージスタイルの内容です。 親ノード:Style 子ノード:なし |
Category | 文字列 | image | スタイルのカテゴリです。 親ノード:Style 子ノード:なし |
CreateTime | 文字列 | Wed, 20 May 2020 12:07:15 GMT | スタイルが作成された時刻です。 親ノード:Style 子ノード:なし |
LastModifyTime | 文字列 | Wed, 21 May 2020 12:07:15 GMT | イメージスタイルが変更された時刻です。 親ノード:Style 子ノード:なし |
例
サンプルリクエスト
GET /?style&styleName=imagestyle HTTP/1.1
Date: Thu, 17 Apr 2025 05:34:24 GMT
Content-Length: 63
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eサンプルレスポンス
HTTP/1.1 200 OK
Server: AliyunOSS
Date: Fri, 04 Mar 2022 05:28:35 GMT
Content-Type: application/xml
Content-Length: 239
Connection: keep-alive
x-oss-request-id: 6221A383CBD8483439E7****
<?xml version="1.0" encoding="UTF-8"?>
<Style>
<Name>imagestyle</Name>
<Content>image/resize,p_50</Content>
<Category>image</Category>
<CreateTime>Wed, 20 May 2020 12:07:15 GMT</CreateTime>
<LastModifyTime>Wed, 21 May 2020 12:07:15 GMT</LastModifyTime>
</Style>OSS SDK
Python 向けの OSS SDK を使用して GetStyle API を呼び出すことができます。
ossutil
GetStyle API に対応する ossutil コマンドについては、「get-style」をご参照ください。