Todos os produtos
Search
Central de documentação

Object Storage Service:put-style

Última atualização: Jul 03, 2026

Crie 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 em buckets pertencentes à própria conta. Para processar imagens como usuário RAM ou com credenciais de acesso fornecidas pelo Security Token Service (STS), você precisa da permissão oss:PutStyle. Para mais informações, consulte Anexar uma política personalizada a um usuário RAM.

Sintaxe do comando

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

Parâmetro

Tipo

Descrição

--bucket

string

Nome do bucket.

--style

string

Contêiner que armazena as configurações de estilo de imagem.

--style-name

string

Nome do estilo de imagem.

Nota

O comando put-style equivale à operação PutStyle. Para mais detalhes sobre essa operação da API, consulte PutStyle.

--style

O parâmetro --style aceita os formatos XML e JSON. Se o valor começar com "file://", as configurações serão carregadas 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 Opções globais de linha de comando.

Exemplos

Crie um estilo de imagem chamado imageStyle para um bucket denominado 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
  • Especifique parâmetros JSON diretamente na linha de comando:

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