get-object - Object Storage Service - Centre de documentation Alibaba Cloud

Télécharge un objet depuis un bucket.

Remarques d'utilisation

Par défaut, vous pouvez accéder à l'opération API GetObject via HTTP et HTTPS. Pour restreindre l'accès exclusivement à HTTPS, utilisez une Bucket Policy. Pour plus d'informations, consultez la rubrique Configure bucket policies to authorize other users to access OSS resources.
Si un objet appartient à la classe de stockage Archive, vous devez d'abord le restaurer en envoyant une requête RestoreObject. Assurez-vous que la requête n'expire pas.

Permissions

Par défaut, un compte Alibaba Cloud dispose de toutes les permissions. Les utilisateurs RAM ou les rôles RAM associés à un compte Alibaba Cloud ne disposent d'aucune permission par défaut. Le compte Alibaba Cloud ou l'administrateur du compte doit accorder les permissions d'opération via des RAM policies ou une Bucket Policy.

API	Action	Description
GetObject	`oss:GetObject`	Télécharge un objet.
	`oss:GetObjectVersion`	Lors du téléchargement d'un objet, si vous spécifiez la version de l'objet via versionId, cette permission est requise.
	`kms:Decrypt`	Lors du téléchargement d'un objet, si les métadonnées de l'objet contiennent X-Oss-Server-Side-Encryption: KMS, cette permission est requise.

Syntaxe de la commande

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

Paramètre

Type

Description

--accept-encoding

string

Spécifie le type d'encodage du client.

--bucket

string

Nom du bucket.

--if-match

string

Si l'ETag spécifié correspond à l'ETag de l'objet, OSS renvoie les métadonnées de l'objet et un code d'état 200 OK. Sinon, il renvoie une erreur 412 Precondition Failed.

--if-modified-since

string

Si l'heure spécifiée est antérieure à la dernière date de modification de l'objet, OSS renvoie les métadonnées de l'objet et un code d'état 200 OK. Sinon, il renvoie un code d'état 304 Not Modified.

--if-none-match

string

Si l'ETag spécifié ne correspond pas à l'ETag de l'objet, OSS renvoie les métadonnées de l'objet et un code d'état 200 OK. Sinon, il renvoie un code d'état 304 Not Modified.

--if-unmodified-since

string

Si l'heure spécifiée est identique ou postérieure à la dernière date de modification de l'objet, OSS renvoie les métadonnées de l'objet et un code d'état 200 OK. Sinon, il renvoie une erreur 412 Precondition Failed.

--key

string

Chemin complet de l'objet.

--range

stringArray

Plage d'octets de l'objet à récupérer.

--response-cache-control

string

En-tête Cache-Control à renvoyer dans la réponse.

--response-content-disposition

string

En-tête Content-Disposition à renvoyer dans la réponse.

--response-content-encoding

string

En-tête Content-Encoding à renvoyer dans la réponse.

--response-content-language

string

En-tête Content-Language à renvoyer dans la réponse.

--response-expires

string

En-tête Expires à renvoyer dans la réponse.

--version-id

string

ID de version de l'objet à récupérer.

Remarque

La commande get-object s'appuie sur l'opération API GetObject. Pour plus d'informations sur les paramètres de l'opération API, consultez la rubrique GetObject.
Pour connaître les options de ligne de commande globales prises en charge, consultez la rubrique Global command-line options.

Exemples

Récupérez l'objet exampleobject depuis le bucket examplebucket.

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

Récupérez l'objet exampleobject avec l'ID de version 123 depuis le bucket examplebucket.
```
ossutil api get-object --bucket examplebucket --key exampleobject --version-id 123
```
Récupérez une plage spécifique de l'objet exampleobject depuis le bucket examplebucket.
```
ossutil api get-object --bucket examplebucket --key exampleobject --range bytes=1-10
```
Récupérez l'objet exampleobject depuis le bucket examplebucket si la date de modification de exampleobject est postérieure au 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"
```
Récupérez exampleobject depuis le bucket examplebucket. L'objet est renvoyé si l'ETag de exampleobject est égal à 123.
```
ossutil api get-object --bucket examplebucket --key exampleobject --if-match 123
```
Récupérez exampleobject depuis le bucket examplebucket et transférez la réponse avec une compression Gzip.
```
ossutil api get-object --bucket examplebucket --key exampleobject --accept-encoding gzip
```

Référence API

Cette commande s'appuie sur l'API RESTful GetObject. Pour une personnalisation plus poussée, vous pouvez effectuer des appels API directs, ce qui nécessite d'écrire du code pour calculer la signature. Pour plus d'informations, consultez la rubrique GetObject.