Todos os produtos
Search
Central de documentação

Object Storage Service:style

Última atualização: Sep 25, 2026

Use o comando style para configure estilos de imagem.

Notas de uso

  • Para configure um estilo de imagem, você precisa ter a permissão oss:PutStyle. Para consultar um estilo de imagem, você precisa ter a permissão oss:GetStyle. Para exclua um estilo de imagem, você precisa ter a permissão oss:DeleteStyle. Para mais informações, consulte Grant a custom policy.

  • Para o ossutil 1.6.16 e versões posteriores, use diretamente ossutil como o nome do binário na linha de comando. Não é preciso atualize o nome do binário com base no sistema operacional. Para versões do ossutil anteriores à 1.6.16, atualize o nome do binário de acordo com o sistema operacional. Para mais informações, consulte ossutil command reference.

  • Apenas o ossutil 1.7.16 e versões posteriores oferecem suporte ao comando style.

Configure estilos de imagem

  • Sintaxe do comando

    ossutil style --method put oss://bucketname/ stylename local_xml_file

    A tabela a seguir descreve os parâmetros acima.

    Parâmetro

    Descrição

    bucketname

    O nome do bucket para o qual você deseja configurar estilos de imagem.

    stylename

    O nome do estilo de imagem.

    local_xml_file

    O nome do arquivo local usado para configure o estilo de imagem, como config.xml.

  • Exemplos

    1. Configure o estilo de imagem em um arquivo XML local.

      <?xml version="1.0" encoding="UTF-8"?>
      <Style>
       <Content>image/resize,p_50</Content>
      </Style>
    2. Configure um estilo de imagem chamado examplestyle para um bucket chamado examplebucket.

      ossutil style --method put oss://examplebucket/ examplestyle config.xml

      Exemplo de saída:

      0.299514(s) elapsed

Consultar estilos de imagem

  • Sintaxe do comando

    ossutil style --method get oss://bucketname/ stylename local_xml_file

    A tabela a seguir descreve os parâmetros acima.

    Parâmetro

    Descrição

    bucketname

    O nome do bucket cujos estilos de imagem você deseja consultar.

    stylename

    O nome do estilo de imagem.

    local_xml_file

    O nome do arquivo local onde os estilos de imagem são armazenados, como config.xml.

  • Exemplos

    • Execute o seguinte comando para consultar um estilo de imagem chamado examplestyle, configurado para um bucket chamado examplebucket, e listar os resultados da consulta:

      ./ossutil style --method get oss://examplebucket/ examplestyle

      Exemplo de saída:

      <?xml version="1.0" encoding="UTF-8"?>
      <Style>
        <Name>examplestyle</Name>
        <Content>image/resize,p_100</Content>
        <CreateTime>Thu, 22 Dec 2022 13:59:06 GMT</CreateTime>
        <LastModifyTime>Thu, 22 Dec 2022 13:59:06 GMT</LastModifyTime>
      </Style>
      
      0.150473(s) elapsed
    • Para consultar um estilo de imagem chamado examplestyle, configurado para um bucket chamado examplebucket, e armazenar o estilo de imagem em um arquivo local, execute o comando a seguir:

      ./ossutil style --method get oss://examplebucket/ examplestyle local.xml

      Exemplo de saída:

      • O resultado a seguir é exibido:

        0.214483(s) elapsed
      • O arquivo local.xml contém o seguinte conteúdo:

        <?xml version="1.0" encoding="UTF-8"?>
        <Style>
          <Name>examplestyle</Name>
          <Content>image/resize,p_100</Content>
          <CreateTime>Thu, 22 Dec 2022 13:59:06 GMT</CreateTime>
          <LastModifyTime>Thu, 22 Dec 2022 13:59:06 GMT</LastModifyTime>
        </Style>

Exclua estilos de imagem

  • Sintaxe do comando

    ossutil style --method delete oss://bucketname/ stylename 

    A tabela a seguir descreve os parâmetros acima.

    Parâmetro

    Descrição

    bucketname

    O nome do bucket cujos estilos de imagem você deseja excluir.

    stylename

    O nome do estilo de imagem.

  • Exemplos

    Execute o comando abaixo para exclua um estilo de imagem chamado examplestyle, configurado para o examplebucket:

    ./ossutil style --method delete oss://examplebucket examplestyle

    A saída a seguir é retornada:

    0.184183(s) elapsed

Listar estilos de imagem

  • Sintaxe do comando

    ossutil style --method list oss://bucketname/ local_xml_file

    A tabela a seguir descreve os parâmetros acima.

    Parâmetro

    Descrição

    bucketname

    O nome do bucket cujos estilos de imagem você deseja listar.

    local_xml_file

    O nome do arquivo local onde os estilos de imagem são armazenados, como config.xml.

  • Exemplos

    • Para listar os estilos de imagem configurados para um bucket chamado examplebucket e exibir os resultados, execute o seguinte comando:

      ./ossutil style --method list oss://examplebucket/

      Exemplo de saída:

      <?xml version="1.0" encoding="UTF-8"?>
      <StyleList>
        <Style>
          <Name>examplestyle1</Name>
          <Content>image/resize,p_100</Content>
          <CreateTime>Thu, 22 Dec 2022 13:59:06 GMT</CreateTime>
          <LastModifyTime>Thu, 22 Dec 2022 13:59:06 GMT</LastModifyTime>
        </Style>
        <Style>
          <Name>examplestyle2</Name>
          <Content>image/resize,p_100</Content>
          <CreateTime>Thu, 22 Dec 2022 13:59:06 GMT</CreateTime>
          <LastModifyTime>Thu, 22 Dec 2022 13:59:06 GMT</LastModifyTime>
        </Style>
      </StyleList>
      
      0.155333(s) elapsed
    • Execute o comando a seguir para listar os estilos de imagem configurados para um bucket chamado examplebucket e armazená-los em um arquivo local:

      ./ossutil style --method list oss://examplebucket/ local.xml

      Exemplo de saída:

      • O resultado a seguir é exibido:

        2.655387(s) elapsed
      • O arquivo local.xml contém o seguinte conteúdo:

        <?xml version="1.0" encoding="UTF-8"?>
        <StyleList>
          <Style>
            <Name>examplestyle1</Name>
            <Content>image/resize,p_100</Content>
            <CreateTime>Thu, 22 Dec 2022 13:59:06 GMT</CreateTime>
            <LastModifyTime>Thu, 22 Dec 2022 13:59:06 GMT</LastModifyTime>
          </Style>
          <Style>
            <Name>examplestyle2</Name>
            <Content>image/resize,p_100</Content>
            <CreateTime>Thu, 22 Dec 2022 13:59:06 GMT</CreateTime>
            <LastModifyTime>Thu, 22 Dec 2022 13:59:06 GMT</LastModifyTime>
          </Style>
        </StyleList>