get-object - Object Storage Service: Central de Documentação do Alibaba Cloud

Baixa um objeto de um bucket.

Notas de uso

Por padrão, você pode acessar a operação da API GetObject por HTTP e HTTPS. Para impor o acesso somente por HTTPS, use uma Bucket Policy. Para mais informações, consulte Configure bucket policies to authorize other users to access OSS resources.
Se um objeto estiver na classe de armazenamento Archive, você deve primeiro restaurá-lo enviando uma solicitação RestoreObject. Certifique-se de que a solicitação não expire.

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões completas. Usuários RAM ou funções RAM sob uma conta Alibaba Cloud não têm nenhuma permissão por padrão. A conta Alibaba Cloud ou o administrador da conta deve conceder permissões de operação por meio de RAM policies ou Bucket Policy.

API	Ação	Descrição
GetObject	`oss:GetObject`	Baixa um objeto.
	`oss:GetObjectVersion`	Ao baixar um objeto, se você especificar a versão do objeto por meio de versionId, esta permissão é necessária.
	`kms:Decrypt`	Ao baixar um objeto, se os metadados do objeto contiverem X-Oss-Server-Side-Encryption: KMS, esta permissão é necessária.

Sintaxe do comando

ossutil api get-object --bucket value --key value [flags]

Parâmetro	Tipo	Descrição
--accept-encoding	string	Especifica o tipo de codificação do cliente.
--bucket	string	O nome do bucket.
--if-match	string	Se o ETag especificado corresponder ao ETag do objeto, o OSS retorna os metadados do objeto e um código de status `200 OK`. Caso contrário, retorna um erro `412 Precondition Failed`.
--if-modified-since	string	Se o horário especificado for anterior à última modificação do objeto, o OSS retorna os metadados do objeto e um código de status `200 OK`. Caso contrário, retorna um código de status `304 Not Modified`.
--if-none-match	string	Se o ETag especificado não corresponder ao ETag do objeto, o OSS retorna os metadados do objeto e um código de status `200 OK`. Caso contrário, retorna um código de status `304 Not Modified`.
--if-unmodified-since	string	Se o horário especificado for o mesmo ou posterior à última modificação do objeto, o OSS retorna os metadados do objeto e um código de status `200 OK`. Caso contrário, retorna um erro `412 Precondition Failed`.
--key	string	O caminho completo do objeto.
--range	stringArray	O intervalo de bytes do objeto a ser recuperado.
--response-cache-control	string	O cabeçalho `Cache-Control` a ser retornado na resposta.
--response-content-disposition	string	O cabeçalho `Content-Disposition` a ser retornado na resposta.
--response-content-encoding	string	O cabeçalho `Content-Encoding` a ser retornado na resposta.
--response-content-language	string	O cabeçalho `Content-Language` a ser retornado na resposta.
--response-expires	string	O cabeçalho `Expires` a ser retornado na resposta.
--version-id	string	O ID da versão do objeto a ser recuperado.

Nota

O comando get-object é baseado na operação da API GetObject. Para mais informações sobre os parâmetros da operação da API, consulte GetObject.
Para opções globais de linha de comando suportadas, consulte Global command-line options.

Exemplos

Recupere o objeto exampleobject do bucket examplebucket.

ossutil api get-object --bucket examplebucket --key exampleobject

Recupere o objeto exampleobject com o ID de versão 123 do bucket examplebucket.

ossutil api get-object --bucket examplebucket --key exampleobject --version-id 123

Recupere um intervalo especificado do objeto exampleobject do bucket examplebucket.

ossutil api get-object --bucket examplebucket --key exampleobject --range bytes=1-10

Recupere o objeto exampleobject do bucket examplebucket se o horário de modificação de exampleobject for posterior a Mon, 11 May 2020 08:16:23 GMT.
```
ossutil api get-object --bucket examplebucket --key exampleobject --if-modified-since "Mon, 11 May 2020 08:16:23 GMT"
```
Recupere exampleobject do bucket examplebucket. O objeto é retornado se o ETag de exampleobject for igual a 123.
```
ossutil api get-object --bucket examplebucket --key exampleobject --if-match 123
```

Recupere exampleobject do bucket examplebucket e transfira a resposta com compressão Gzip.

ossutil api get-object --bucket examplebucket --key exampleobject --accept-encoding gzip

Referência da API

Este comando é baseado na API RESTful GetObject. Para mais personalização, você pode fazer solicitações diretas à API, o que requer que você escreva código para calcular a assinatura. Para mais informações, consulte GetObject.