Todos os produtos
Search
Central de documentação

Object Storage Service:style

Última atualização: Jul 03, 2026

Use o comando style para configure estilos de imagem.

Observações de uso

  • A configuração de um estilo de imagem requer a permissão oss:PutStyle. A consulta requer a permissão oss:GetStyle, e a exclusão exige a permissão oss:DeleteStyle. Para mais informações, consulte Conceder uma política personalizada.

  • No ossutil 1.6.16 ou superior, use diretamente ossutil como nome do binário na linha de comando, sem necessidade de alteração conforme o sistema operacional. Nas versões anteriores à 1.6.16, atualize o nome do binário de acordo com o sistema operacional. Para mais informações, consulte Guia de início rápido da ferramenta de linha de comando ossutil.

  • O comando style é compatível apenas com o ossutil 1.7.16 ou superior.

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 anteriores.

    Parâmetro

    Descrição

    bucketname

    Nome do bucket no qual você deseja configure os estilos de imagem.

    stylename

    Nome do estilo de imagem.

    local_xml_file

    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

      Saída de exemplo:

      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 anteriores.

    Parâmetro

    Descrição

    bucketname

    Nome do bucket cujos estilos de imagem você deseja consultar.

    stylename

    Nome do estilo de imagem.

    local_xml_file

    Nome do arquivo local onde os estilos de imagem serão armazenados, como config.xml.

  • Exemplos

    • Execute o comando a seguir para consultar um estilo de imagem chamado examplestyle configurado em um bucket chamado examplebucket e listar os resultados:

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

      Saída de exemplo:

      <?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
    • Execute o comando a seguir para consultar um estilo de imagem chamado examplestyle configurado em um bucket chamado examplebucket e salvar o resultado em um arquivo local:

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

      Saída de exemplo:

      • Resultado exibido:

        0.214483(s) elapsed
      • Conteúdo do arquivo local.xml:

        <?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 anteriores.

    Parâmetro

    Descrição

    bucketname

    Nome do bucket cujos estilos de imagem você deseja exclua.

    stylename

    Nome do estilo de imagem.

  • Exemplos

    Execute o comando a seguir para exclua um estilo de imagem chamado examplestyle configurado no examplebucket:

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

    Saída 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 anteriores.

    Parâmetro

    Descrição

    bucketname

    Nome do bucket cujos estilos de imagem você deseja listar.

    local_xml_file

    Nome do arquivo local onde os estilos de imagem serão armazenados, como config.xml.

  • Exemplos

    • Execute o comando a seguir para listar os estilos de imagem configurados em um bucket chamado examplebucket e exibir os resultados:

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

      Saída de exemplo:

      <?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 em um bucket chamado examplebucket e salvar os resultados em um arquivo local:

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

      Saída de exemplo:

      • Resultado exibido:

        2.655387(s) elapsed
      • Conteúdo do arquivo local.xml:

        <?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>