Object Storage Service:set-meta (Gérer les métadonnées d'objet)

Remarques

• Pour définir les métadonnées d'un seul objet, vous devez disposer des autorisations oss:GetObject, oss:PutObject, oss:GetObjectVersion et oss:GetObjectAcl. Pour définir les métadonnées de plusieurs objets lors d'une opération par lot, vous devez disposer des autorisations oss:GetObject, oss:PutObject, oss:GetObjectVersion et oss:ListObjects. Pour plus d'informations, reportez-vous à la rubrique Attacher une politique d'accès personnalisée à un utilisateur RAM.

• À partir de la version 1.6.16 d'ossutil, utilisez ossutil comme nom binaire dans la ligne de commande. Il n'est pas nécessaire de remplacer le nom binaire en fonction de votre système d'exploitation. Si votre version d'ossutil est antérieure à la 1.6.16, remplacez le nom binaire en fonction de votre système d'exploitation. Pour plus d'informations, reportez-vous à la rubrique Référence des commandes ossutil.

• Après avoir défini ou mis à jour les métadonnées d'un objet à l'aide de la commande set-meta, consultez les métadonnées de l'objet à l'aide de la commande stat. Pour plus d'informations, reportez-vous à la rubrique stat.

Syntaxe de la commande

ossutil set-meta oss://bucketname[/prefix] 
[header:value#header:value...]
[--update]
[--delete] 
[-r, --recursive] 
[-f, --force]
[--object-file <value>]
[--snapshot-path <value>]
[--disable-ignore-error]
[--version-id <value>]
[--include <value>]
[--exclude <value>]

Le tableau suivant décrit les paramètres et options :

Headers:
      Expires(time.RFC3339:2006-01-02T15:04:05Z07:00)
      X-Oss-Object-Acl
      Origin
      X-Oss-Storage-Class
      Content-Encoding
      Cache-Control
      Content-Disposition
      Accept-Encoding
      X-Oss-Server-Side-Encryption
      Content-Type
      and headers that start with X-Oss-Meta-

Définir ou mettre à jour les métadonnées

Dans les exemples suivants qui n'incluent pas l'option --update, si vous ne spécifiez pas l'option header:value#header:value..., seules les métadonnées définies par l'utilisateur commençant par X-Oss-Meta- sont conservées et leurs valeurs ne sont pas modifiées. Pour les en-têtes HTTP, ossutil passe en mode interactif et vous invite à confirmer leur conservation.

• Exemple 1 : Définir ou mettre à jour les métadonnées d'un seul objet

  • Définissez la liste de contrôle d'accès (ACL) de l'objet exampleobject.txt dans le bucket examplebucket sur private.

    ossutil set-meta oss://examplebucket/exampleobject.txt X-Oss-Object-Acl:private 

  • Définissez la classe de stockage d'une version spécifique de l'objet exampleobject.txt dans le bucket examplebucket sur Standard.

    ossutil set-meta oss://examplebucket/exampleobject.txt X-Oss-Storage-Class:Standard --version-id  CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3MDRk

  • Définissez la classe de stockage d'une version spécifique de l'objet exampleobject.txt dans le bucket examplebucket sur Cold Archive.

    ossutil set-meta oss://examplebucket/exampleobject.txt X-Oss-Storage-Class:ColdArchive --version-id  CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3MDRk

    Remarque

    La classe de stockage n'est pas modifiée pendant l'exécution de la commande set-meta. La modification prend effet une fois la commande terminée.

    Pour plus d'informations sur l'obtention des versions d'objets, reportez-vous à la rubrique ls.

  • Mettez à jour l'ACL de l'objet exampleobject.txt dans le bucket examplebucket sur public-read.

    ossutil set-meta oss://examplebucket/exampleobject.txt X-Oss-Object-Acl:public-read --update

    Lorsque vous utilisez l'option --update, seules les métadonnées des en-têtes spécifiés sont mises à jour. Les valeurs de ces en-têtes sont remplacées et toutes les autres métadonnées existantes de l'objet restent inchangées. Par exemple, la commande met uniquement à jour l'ACL de l'objet exampleobject.txt sur public-read. Toutes les autres métadonnées de l'objet sont conservées.

• Exemple 2 : Définir ou mettre à jour les métadonnées de plusieurs objets dans le même dossier lors d'une opération par lot

  Lorsque vous définissez ou modifiez les métadonnées de plusieurs objets lors d'une opération par lot, si une erreur survient pour un objet, ossutil enregistre le message d'erreur correspondant dans un fichier de rapport situé dans le dossier ossutil_output. Les objets traités avec succès ne figurent pas dans le fichier de rapport.

  • Définir les métadonnées des objets correspondant à un préfixe spécifié

    Utilisez l'option -r pour modifier le comportement de mise en cache (Cache-Control) sur no-cache et l'ACL (x-oss-object-acl) sur private pour tous les objets correspondant au préfixe src dans le bucket examplebucket.

    ossutil set-meta oss://examplebucket/src Cache-Control:no-cache#X-Oss-Object-Acl:private -r                             

  • Modifier les métadonnées des objets correspondant à des conditions de filtre spécifiées

    • Utilisez les options -r et -u pour modifier la classe de stockage sur Infrequent Access (IA) pour tous les objets de type .jpg dans le dossier desfolder/ du bucket examplebucket.

      ossutil set-meta oss://examplebucket/desfolder/ X-Oss-Storage-Class:IA --include "*.jpg" -u -r                                        

    • Utilisez les options -r et -u pour modifier la classe de stockage sur Archive Storage pour les objets du dossier desfolder/ du bucket examplebucket si leurs noms de fichier contiennent abc et si leurs types de fichier ne sont ni .jpg ni .txt.

      ossutil set-meta oss://examplebucket/desfolder/ X-Oss-Storage-Class:Archive --include "*abc*" --exclude "*.jpg" --exclude "*.txt" -u -r

    Important

    Lorsque vous utilisez la commande set-meta pour modifier la classe de stockage d'un objet Cold Archive ou Deep Cold Archive de plus de 100 Mo, l'opération peut échouer en raison d'un délai d'expiration du serveur. Pour modifier la classe de stockage de ces objets, utilisez la commande cp.

• Exemple 3 : Définir ou mettre à jour les métadonnées de plusieurs objets dans le même dossier ou dans des dossiers différents

  • Objets dans des dossiers différents

    Pour définir ou mettre à jour les métadonnées de plusieurs objets situés dans différents dossiers d'un bucket, suivez les étapes ci-dessous. Par exemple, exampleobject1.jpg se trouve dans le dossier racine de examplebucket, exampleobject2.png dans le dossier dir1/ et exampleobject3.txt dans le dossier dir2/.

    1. Inscrivez plusieurs objets dans un fichier local nommé localfile.txt afin de définir ou de mettre à jour leurs métadonnées.

       exampleobject1.jpg
       dir1/exampleobject2.png
       dir2/exampleobject3.txt

    2. Définissez ou mettez à jour les métadonnées des objets spécifiés.

       Utilisez l'option --object-file pour modifier le comportement de mise en cache (Cache-Control) sur no-cache et l'ACL (x-oss-object-acl) sur private pour plusieurs objets dans le bucket examplebucket, et activez les instantanés.

       ossutil set-meta oss://examplebucket Cache-Control:no-cache#X-Oss-Object-Acl:private --update --object-file localfile.txt --snapshot-path dir/

  • Objets dans le même dossier

    • Méthode 1

      Reportez-vous à l'exemple précédent pour les objets dans des dossiers différents afin de définir ou de mettre à jour les métadonnées de plusieurs objets dans le même dossier.

    • Méthode 2

      Reportez-vous à l'Exemple 2 afin de définir ou de mettre à jour les métadonnées de plusieurs objets dans le même dossier.

• Sortie d'exemple

  Si l'opération réussit, la sortie affiche le temps écoulé. Voici un exemple de sortie :

  0.106852(s) elapsed

Supprimer les métadonnées personnalisées

• Exemple 1 : Supprimer les métadonnées personnalisées d'un seul objet

  Supprimez les métadonnées personnalisées commençant par X-Oss-Meta- pour l'objet exampleobject.txt dans le bucket examplebucket. La valeur de l'en-tête doit être vide.

  ossutil set-meta oss://examplebucket/exampleobject.txt X-Oss-Meta-Createdby  --delete

• Exemple 2 : Supprimer les métadonnées personnalisées de plusieurs objets lors d'une opération par lot

  Pour supprimer les métadonnées personnalisées de plusieurs objets lors d'une opération par lot, suivez les étapes ci-dessous :

  1. Inscrivez les noms des objets dont vous souhaitez supprimer les métadonnées personnalisées dans un fichier local nommé localfile.txt.

     exampleobject1.jpg
     dir1/exampleobject2.png
     dir2/exampleobject3.txt

  2. Supprimez les métadonnées personnalisées des objets.

     Utilisez l'option --object-file pour supprimer les métadonnées personnalisées commençant par X-Oss-Meta- pour plusieurs objets dans le bucket examplebucket lors d'une opération par lot. La valeur de l'en-tête doit être vide.

     ossutil set-meta oss://examplebucket X-Oss-Meta-Location --delete --object-file localfile.txt --snapshot-path dir/

• Sortie d'exemple

  Si l'opération réussit, la sortie affiche le temps écoulé. Voici un exemple de sortie :

  0.106846(s) elapsed

Options courantes

Pour accéder à un bucket situé dans une autre région, utilisez -e pour spécifier le endpoint. Pour accéder à un bucket appartenant à un autre compte Alibaba Cloud, utilisez -i pour l'AccessKey ID et -k pour l'AccessKey Secret.

ossutil set-meta oss://testbucket/testobject.jpg X-Oss-Object-Acl:private  -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID  -k yourAccessKeySecret

Options courantes.