Todos os produtos
Search
Central de documentação

Object Storage Service:put-style

Última atualização: Sep 22, 2026

Cria um estilo de imagem. Um estilo de imagem contém um ou mais parâmetros de processamento de imagem.

Observações de uso

Por padrão, uma conta Alibaba Cloud tem permissão para processar imagens nos buckets de sua propriedade. Para processar imagens como um usuário RAM ou usando credenciais de acesso fornecidas pelo Security Token Service (STS), você deve ter a permissão oss:PutStyle. Para mais informações, consulte Attach a custom policy to a RAM user.

Sintaxe do comando

ossutil api put-style --bucket value --style-name value --style value [flags]

Parâmetro

Tipo

Descrição

--bucket

string

O nome do bucket.

--style

string

O contêiner que armazena as configurações do estilo de imagem.

--style-name

string

O nome do estilo de imagem.

Nota

O comando put-style é equivalente à operação PutStyle. Para mais informações sobre a operação de API, consulte PutStyle.

--style

O parâmetro --style aceita os formatos XML e JSON. Se o valor do parâmetro começar com "file://", o comando carrega as configurações a partir do arquivo especificado.

  • Formato XML:

    <Style>
     <Content>string</Content>
    </Style>
  • Sintaxe JSON:

    {
      "Content": "string"
    }
Nota

Para mais informações sobre as opções globais de linha de comando compatíveis, consulte Global command-line options.

Exemplos

Crie um estilo de imagem chamado imageStyle para um bucket chamado examplebucket.

  • Use um arquivo de configuração XML (style.xml neste exemplo)

    <?xml version="1.0" encoding="UTF-8"?>
    <Style>
      <Content>image/resize,p_50</Content>
    </Style>

    Comando de exemplo:

    ossutil api put-style --bucket examplebucket --style-name imageStyle --style file://style.xml
  • Use um arquivo de configuração JSON (style.json neste exemplo)

    {
      "Content": "image/resize,p_50"
    }

    Comando de exemplo:

    ossutil api put-style --bucket examplebucket --style-name imageStyle --style file://style.json
  • Use parâmetros JSON na linha de comando

    ossutil api put-style --bucket examplebucket --style-name imageStyle --style "{\"Content\":\"image/resize,p_50\"}"