get-object - Object Storage Service - Centro de documentación de Alibaba Cloud

Descarga un objeto de un bucket.

Notas de uso

De forma predeterminada, puede acceder a la operación de API GetObject mediante HTTP y HTTPS. Para restringir el acceso exclusivamente a HTTPS, utilice una Bucket Policy. Para obtener más información, consulte Configure bucket policies to authorize other users to access OSS resources.
Si un objeto pertenece a la clase de almacenamiento Archive, primero debe restaurarlo mediante una solicitud RestoreObject. Asegúrese de que la solicitud no agote el tiempo de espera.

Permisos

De forma predeterminada, una cuenta de Alibaba Cloud cuenta con todos los permisos. Los usuarios de RAM o los roles de RAM bajo una cuenta de Alibaba Cloud no tienen ningún permiso asignado por defecto. La cuenta de Alibaba Cloud o el administrador de la cuenta deben otorgar los permisos de operación correspondientes mediante RAM policies o Bucket Policy.

API	Action	Descripción
GetObject	`oss:GetObject`	Descarga un objeto.
	`oss:GetObjectVersion`	Este permiso es obligatorio al descargar un objeto si se especifica su versión mediante versionId.
	`kms:Decrypt`	Este permiso es obligatorio al descargar un objeto si sus metadatos incluyen X-Oss-Server-Side-Encryption: KMS.

Sintaxis del comando

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

Parámetro	Tipo	Descripción
--accept-encoding	string	Especifica el tipo de codificación del cliente.
--bucket	string	El nombre del bucket.
--if-match	string	Si el ETag especificado coincide con el ETag del objeto, OSS devuelve los metadatos del objeto y el código de estado `200 OK`. De lo contrario, devuelve un error `412 Precondition Failed`.
--if-modified-since	string	Si la hora especificada es anterior a la última modificación del objeto, OSS devuelve los metadatos del objeto y el código de estado `200 OK`. En caso contrario, devuelve el código de estado `304 Not Modified`.
--if-none-match	string	Si el ETag especificado no coincide con el ETag del objeto, OSS devuelve los metadatos del objeto y el código de estado `200 OK`. En caso contrario, devuelve el código de estado `304 Not Modified`.
--if-unmodified-since	string	Si la hora especificada es igual o posterior a la última modificación del objeto, OSS devuelve los metadatos del objeto y el código de estado `200 OK`. De lo contrario, devuelve un error `412 Precondition Failed`.
--key	string	La ruta completa del objeto.
--range	stringArray	El rango de bytes del objeto que se desea recuperar.
--response-cache-control	string	El encabezado `Cache-Control` que se devolverá en la respuesta.
--response-content-disposition	string	El encabezado `Content-Disposition` que se devolverá en la respuesta.
--response-content-encoding	string	El encabezado `Content-Encoding` que se devolverá en la respuesta.
--response-content-language	string	El encabezado `Content-Language` que se devolverá en la respuesta.
--response-expires	string	El encabezado `Expires` que se devolverá en la respuesta.
--version-id	string	El ID de versión del objeto que se desea recuperar.

Nota

El comando get-object se basa en la operación de API GetObject. Para obtener más información sobre los parámetros de esta operación de API, consulte GetObject.
Para consultar las opciones globales de línea de comandos compatibles, consulte Global command-line options.

Ejemplos

Recupere el objeto exampleobject del bucket examplebucket.

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

Recupere el objeto exampleobject con el ID de versión 123 del bucket examplebucket.

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

Recupere un rango específico del objeto exampleobject del bucket examplebucket.

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

Recupere el objeto exampleobject del bucket examplebucket si la fecha de modificación de exampleobject es 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 del bucket examplebucket. El objeto se devuelve únicamente si el ETag de exampleobject es igual a 123.
```
ossutil api get-object --bucket examplebucket --key exampleobject --if-match 123
```
Recupere exampleobject del bucket examplebucket y transfiera la respuesta con compresión Gzip.
```
ossutil api get-object --bucket examplebucket --key exampleobject --accept-encoding gzip
```

Referencia de API

Este comando se basa en la API RESTful GetObject. Para mayor personalización, puede realizar solicitudes directas a la API, lo cual requiere escribir código para calcular la firma. Para obtener más información, consulte GetObject.