Create a symbolic link by using the create-symlink command - Object Storage Service

Un lien symbolique permet d'accéder rapidement aux objets d'un bucket, à l'instar d'un raccourci sous Windows. Une fois le lien symbolique créé avec la commande create-symlink, utilisez-le pour accéder rapidement au fichier objet source.

Remarques sur l'utilisation

Pour créer un lien symbolique, vous devez disposer de l'autorisation oss:PutObject. Pour plus d'informations, consultez 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, sans l'adapter au système d'exploitation. Si votre version d'ossutil est antérieure à la 1.6.16, adaptez le nom binaire selon le système d'exploitation. Pour plus d'informations, consultez la section Référence des commandes ossutil.

Syntaxe de la commande

ossutil create-symlink cloud_url target_object
[--encoding-type <value>] 
[--payer <value>]

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

Élément de configuration

Description

cloud_url

Chemin d'accès complet du bucket contenant le fichier de lien symbolique.

target_object

Chemin d'accès complet de l'objet cible vers lequel pointe le lien symbolique. Le lien symbolique et l'objet cible doivent se trouver dans le même bucket.

--encoding-type

Type d'encodage des noms d'objets dans cloud_url et target_object. Définissez la valeur sur url. Si vous ne spécifiez pas cette option, les noms d'objets ne sont pas encodés.

--payer

Méthode de paiement pour la requête. Pour indiquer que le demandeur prend en charge les frais tels que le trafic et le nombre de requêtes, définissez cette option sur requester.

Exemples

Cette commande ne vérifie pas l'existence de l'objet cible lors de la création d'un lien symbolique. Si l'objet cible existe, vous pouvez y accéder via le lien symbolique. En revanche, si l'objet cible n'existe pas, l'accès via le lien symbolique échouera. Si vous ignorez si l'objet cible existe, exécutez la commande ls pour lister tous les objets du bucket cible.

Les exemples suivants illustrent la création d'un lien symbolique pour un objet existant :

Important

Si le nom du nouveau lien symbolique est identique à celui d'un lien symbolique existant, ce dernier sera écrasé.

Créez un lien symbolique nommé test.jpg dans le répertoire racine du bucket examplebucket, qui pointe vers l'objet exampleobject.jpg situé dans le même répertoire.
```
ossutil create-symlink  oss://examplebucket/test.jpg  oss://examplebucket/exampleobject.jpg
```
Créez un lien symbolique nommé example.jpg dans le répertoire destfolder du bucket examplebucket. Ce lien pointe vers l'objet test.jpg situé dans le répertoire racine du bucket. Les frais sont pris en charge par le demandeur.
```
ossutil create-symlink  oss://examplebucket/destfolder/example.jpg  oss://examplebucket/test.jpg --payer requester
```
La sortie suivante indique que le lien symbolique a été créé.
```
0.106744(s) elapsed
```
Une fois le lien symbolique créé, exécutez la commande read-symlink ou stat pour obtenir des informations sur le lien symbolique, telles que sa valeur ETag et sa date de dernière modification.

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, la commande suivante crée un lien symbolique nommé testobject.png pour l'objet exampleobject.png. L'objet se trouve dans le bucket testbucket, situé dans la région Chine (Shanghai) et appartenant à un autre compte Alibaba Cloud.

ossutil create-symlink  oss://testbucket/testobject.png  oss://testbucket/exampleobject.png -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID  -k yourAccessKeySecret

Options courantes.