ossutil presign - generate signed URLs for OSS objects - Object Storage Service: Central de Documentação do Alibaba Cloud

Gera uma URL assinada para acessar objetos do OSS.

Sintaxe do comando

ossutil presign oss://bucket[/prefix] [flags]

Parâmetro	Tipo	Descrição
-d, --dirs	/	Lista objetos e subdiretórios no diretório atual sem percorrer os subdiretórios recursivamente.
--encoding-type	string	Codificação para nomes de objetos ou arquivos. Valor válido: URL.
--end-with	string	Retorna objetos cujos nomes precedem alfabeticamente ou correspondem ao valor especificado.
--exclude	stringArray	Regra de exclusão para caminhos ou nomes de objetos.
--exclude-from	stringArray	Lê regras de exclusão de um arquivo.
--expires-date	Time	Data e hora de expiração da URL assinada.
--expires-duration	Duration	Período de validade da URL assinada. Intervalo: de 1 segundo a 1 semana. Padrão: 15m0s.
--files-from	stringArray	Lê os nomes dos objetos de source de um arquivo. Linhas vazias e comentários são ignorados.
--files-from-raw	stringArray	Lê os nomes dos objetos de source diretamente de um arquivo.
--filter	stringArray	Regra de filtro para caminhos ou nomes de objetos.
--filter-from	stringArray	Lê regras de filtro de um arquivo.
-f, --force	/	Força a execução da operação sem solicitar confirmação.
--include	stringArray	Regra de inclusão para caminhos ou nomes de objetos.
--include-from	stringArray	Lê regras de inclusão de um arquivo.
--limited-num	int	Número máximo de resultados a retornar.
--list-objects	/	Lista objetos usando a operação ListObjects.
--min-age	Duration	Processa apenas arquivos modificados antes do intervalo de tempo especificado. Unidade padrão: segundos. Aceita sufixos de unidade, como 1h para uma hora. Nota `--min-age 1h` indica que somente arquivos modificados há pelo menos 1 hora serão processados.
--max-age	Duration	Processa apenas arquivos modificados dentro do intervalo de tempo especificado. Unidade padrão: segundos. Aceita sufixos de unidade, como 1h para uma hora. Nota `--max-age 1h` indica que somente arquivos modificados na última hora serão processados.
--min-mtime	Time	Processa apenas arquivos modificados após o horário especificado. Formato: UTC, por exemplo, 2006-01-02T15:04:05. Nota `--min-mtime "2006-01-02T15:04:05"` indica que somente arquivos modificados após 2 de janeiro de 2006, às 15:04:05, serão processados.
--max-mtime	Time	Processa apenas arquivos modificados antes do horário especificado. Formato: UTC, por exemplo, 2006-01-02T15:04:05.
--max-size	SizeSuffix	Tamanho máximo transferível de arquivo. Unidade padrão: bytes (B). Suporta unidades baseadas em 1024: B, K, M, G, T, P.
--metadata-exclude	stringArray	Regra de exclusão para metadados de objetos.
--metadata-filter	stringArray	Regra de filtro para metadados de objetos.
--metadata-filter-from	stringArray	Lê regras de filtro de metadados de um arquivo.
--metadata-include	stringArray	Regra de inclusão para metadados de objetos.
--min-size	SizeSuffix	Tamanho mínimo transferível de arquivo. Unidade padrão: bytes (B). Suporta unidades baseadas em 1024: B, K, M, G, T, P.
--page-size	int	Quantidade máxima de objetos listados por página durante o processamento em lote. Padrão: 1000. Valores válidos: 1 a 1000.
--query-param	stringArray	Parâmetros de consulta na requisição.
-r, --recursive	/	Executa a operação recursivamente em todos os objetos correspondentes no bucket. Sem essa flag, apenas os objetos no caminho especificado são afetados.
--request-payer	string	Pagador da requisição. Defina como requester se o pagamento por solicitante estiver ativado no bucket.
--start-after	string	Retorna objetos cujos nomes precedem alfabeticamente ou correspondem ao valor de --end-with.
--traffic-limit	int	Limite de largura de banda por conexão. Valores válidos: 819200 a 838860800.
--version-id	string	ID da versão do objeto.

Nota

Para mais informações, consulte Opções de linha de comando.

Exemplos

Gere uma URL assinada para example.txt em examplebucket com o período de validade padrão de 15 minutos.
```
ossutil presign oss://examplebucket/example.txt
```
Gere uma URL assinada para example.txt em examplebucket com validade de 1 hora.
```
ossutil presign oss://examplebucket/example.txt --expires-duration 1h
```
Gere uma URL assinada para example.txt em examplebucket válida até 2024-06-01T12:00:00 (UTC).
```
ossutil presign oss://examplebucket/example.txt --expires-date 2024-06-01T12:00:00
```

Gere uma URL assinada para example.txt em examplebucket com parâmetros de processamento de imagem.

ossutil presign oss://examplebucket/example.txt --query-param x-oss-process=image/resize,m_fixed,w_100,h_100/rotate,90

Gere uma URL assinada para a versão "123" de example.txt em examplebucket.
```
ossutil presign oss://examplebucket/example.txt --version-id 123
```
Gere URLs assinadas para todos os objetos em examplebucket/folder/ com o período de validade padrão de 15 minutos.
```
ossutil presign oss://examplebucket/folder/ -r
```
Gere URLs assinadas para arquivos .txt em examplebucket/folder/ com o período de validade padrão de 15 minutos.
```
ossutil presign oss://examplebucket/folder/ -r --include "*.txt"
```