All Products
Search

This Product

    Object Storage Service:ListStyle

    Document Center

    Object Storage Service:ListStyle

    Last Updated:Sep 11, 2023

    Queries all image styles of a bucket.

    Usage notes

    By default, an Alibaba Cloud account has the permissions to query all image styles of a bucket. To query image styles of a bucket by using a RAM user or Security Token Service (STS), you must have the oss:ListStyle permission. For more information, see Common examples of RAM policies.

    Request syntax

    GET /?style HTTP/1.1
Date:  GMT Date
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

    Request headers

    All headers in a ListStyle request are common request headers. For more information, see Common HTTP headers.

    Response headers

    All headers in the response to a ListStyle request are common response headers. For more information about common response headers, see Common HTTP headers.

    Response elements

    Element

    Type

    Example

    Description

    StyleList

    Container

    N/A

    The container that was used to query image styles.

    Parent nodes: none

    Child nodes: Style

    Style

    Container

    N/A

    The container that was used to query the content of image styles.

    Parent nodes: StyleList

    Child nodes: Name, Content, CreateTime, and LastModifyTime

    Name

    String

    imagestyle

    The name of the image styles.

    Parent nodes: Style

    Child nodes: none

    Content

    String

    image/resize,p_50

    The content of the image styles.

    Parent nodes: Style

    Child nodes: none

    Category

    String

    image

    The categories of the image styles.

    Parent nodes: Style

    Child nodes: none

    CreateTime

    String

    Wed, 20 May 2020 12:07:15 GMT

    The time when the image styles were created.

    Parent nodes: Style

    Child nodes: none

    LastModifyTime

    String

    Wed, 21 May 2020 12:07:15 GMT

    The time when the image styles were modified.

    Parent nodes: Style

    Child nodes: none

    Examples

    • Sample request

    GET /?style HTTP/1.1
Date: Fri, 04 Mar 2022 05:34:24 GMT
Content-Length: 63
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS qn6qrrqxo2oawuk53otf****:ceOEyZavKY4QcjoUWYSpYbJ3****

    • Sample success response

    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>Wed, 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>Wed, 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>Fri, 13 Mar 2021 06:27:21 GMT</LastModifyTime>
 </Style>
</StyleList>