バケットのすべての画像スタイルを照会します。
注意事項
デフォルトでは、Alibaba Cloud アカウントはバケットのすべての画像スタイルを照会する権限があります。RAM ユーザーまたは Security Token Service (STS) を使用して画像スタイルを照会するには、oss:ListStyle 権限が必要です。詳細については、「RAM ポリシーの一般的な例」をご参照ください。
リクエスト構文
GET /?style HTTP/1.1
Date: GMT Date
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
リクエストヘッダー
ListStyle リクエストには、共通のリクエストヘッダーのみが含まれます。詳細については、「共通の HTTP ヘッダー」をご参照ください。
レスポンスヘッダー
ListStyle リクエストへのレスポンスには、共通のレスポンスヘッダーのみが含まれます。詳細については、「共通の HTTP ヘッダー」をご参照ください。
レスポンス要素
|
要素 |
タイプ |
例 |
説明 |
|
StyleList |
コンテナー |
該当なし |
画像スタイル情報を格納するコンテナーです。 親ノード: なし 子ノード: Style |
|
Style |
コンテナー |
該当なし |
各画像スタイルの詳細情報を格納するコンテナーです。 親ノード: StyleList 子ノード: Name、Content、Category、CreateTime、LastModifyTime |
|
Name |
String |
imagestyle |
画像スタイルの名前です。 親ノード: Style 子ノード: なし |
|
Content |
String |
image/resize,p_50 |
画像スタイルの内容です。 親ノード: Style 子ノード: なし |
|
Category |
String |
image |
画像スタイルのカテゴリーです。 親ノード: Style 子ノード: なし |
|
CreateTime |
String |
Wed, 20 May 2020 12:07:15 GMT |
画像スタイルが作成された時刻です。 親ノード: Style 子ノード: なし |
|
LastModifyTime |
String |
Thu, 21 May 2020 12:07:15 GMT |
画像スタイルが最後に変更された時刻です。 親ノード: Style 子ノード: なし |
例
-
リクエストの例
GET /?style 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 04:43:37 GMT
Content-Type: application/xml
Content-Length: 695
Connection: keep-alive
x-oss-request-id: 622198F90612433336EC66A6
<?xml version="1.0" encoding="UTF-8"?>
<StyleList>
<Style>
<Name>imagestyle</Name>
<Content>image/resize,p_50</Content>
<Category>image</Category>
<CreateTime>Wed, 20 May 2020 12:07:15 GMT</CreateTime>
<LastModifyTime>Thu, 21 May 2020 12:07:15 GMT</LastModifyTime>
</Style>
<Style>
<Name>imagestyle1</Name>
<Content>image/resize,w_200</Content>
<Category>image</Category>
<CreateTime>Wed, 20 May 2020 12:08:04 GMT</CreateTime>
<LastModifyTime>Thu, 21 May 2020 12:08:04 GMT</LastModifyTime>
</Style>
<Style>
<Name>imagestyle2</Name>
<Content>image/resize,w_300</Content>
<Category>image</Category>
<CreateTime>Fri, 12 Mar 2021 06:19:13 GMT</CreateTime>
<LastModifyTime>Sat, 13 Mar 2021 06:27:21 GMT</LastModifyTime>
</Style>
</StyleList>
OSS SDK
OSS SDK for Python を使用して ListStyle API を呼び出すことができます。
ossutil
ListStyle API に対応する ossutil コマンドの詳細については、「list-style」をご参照ください。