La commande read-symlink permet de lire les informations relatives à un lien symbolique, telles que sa valeur ETag et sa date de dernière modification. Cette opération nécessite des autorisations de lecture pour le lien symbolique.
Notes d'utilisation
Pour lire un lien symbolique, vous devez disposer de l'autorisation oss:GetObject. Pour plus d'informations, consultez la rubrique Accorder des stratégies personnalisées à un utilisateur RAM.
À partir de la version 1.6.16 d'ossutil, vous pouvez utiliser ossutil comme nom binaire dans la ligne de commande. Il n'est pas nécessaire de modifier le nom binaire en fonction du système d'exploitation. Pour les versions antérieures à la 1.6.16, vous devez adapter le nom binaire au système d'exploitation utilisé. Pour plus d'informations, consultez la rubrique Référence des commandes ossutil.
Pour plus d'informations sur les liens symboliques, consultez la rubrique Liens symboliques.
Syntaxe de la commande
ossutil read-symlink oss://bucketname/objectname [--encoding-type <value>] [--payer <value>]Le tableau suivant décrit les paramètres et les options.
|
Paramètre |
Description |
|
bucketname |
Nom du bucket. |
|
objectname |
Nom du lien symbolique. |
|
--encoding-type |
Méthode d'encodage du nom du lien symbolique. Définissez la valeur sur url. Si vous ne spécifiez pas cette option, le nom n'est pas encodé. |
|
--payer |
Mode de paiement de la requête. Si vous souhaitez que le demandeur qui accède aux ressources du chemin spécifié prenne en charge les frais (trafic et requêtes), définissez la valeur de cette option sur requester. |
Exemples
L'exemple suivant montre comment lire les informations du lien symbolique nommé test.jpg dans le bucket examplebucket.
ossutil read-symlink oss://examplebucket/test.jpgLa sortie suivante affiche la valeur ETag, la date de dernière modification (Last-Modified) et le fichier cible (X-Oss-Symlink-Target) du lien symbolique test.jpg. Le fichier cible est example.jpg.
Etag : 938F26218CE422CBEEE0B6543A2B2D
Last-Modified : 2021-04-21 18:00:13 +0800 CST
X-Oss-Symlink-Target : example.jpg
0.217317(s) elapsedSi vous exécutez cette commande sur un objet qui n'est pas un lien symbolique, l'erreur NotSymlink est renvoyée.
Options courantes
Pour accéder à un bucket situé dans une autre région, utilisez l'option -e afin de spécifier l'endpoint. Pour accéder à un bucket appartenant à un autre compte Alibaba Cloud, utilisez l'option -i pour l'AccessKey ID et l'option -k pour l'AccessKey Secret.
Par exemple, exécutez la commande suivante pour lire les informations du lien symbolique nommé testobject.png dans le bucket testbucket. Ce bucket se trouve dans la région Chine (Shanghai) et appartient à un autre compte Alibaba Cloud.
ossutil read-symlink oss://testbucket/testobject.png -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret