Create a symbolic link by using the create-symlink command - Object Storage Service: Central de Documentação do Alibaba Cloud

Um link simbólico oferece acesso rápido aos objetos em um bucket e funciona de forma semelhante a um atalho no Windows; crie um link simbólico com o comando create-symlink e use-o para acessar rapidamente o arquivo do objeto source.

Notas de uso

Para criar um link simbólico, você precisa da permissão oss:PutObject. Para mais informações, consulte Attach a custom access policy to a RAM user.

A partir do ossutil 1.6.16, use ossutil como o nome do binário na linha de comando. Não atualize o nome do binário de acordo com o sistema operacional. Caso a sua versão do ossutil seja anterior à 1.6.16, atualize o nome do binário conforme o sistema operacional. Para mais informações, consulte ossutil command reference.

Sintaxe do comando

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

A tabela a seguir descreve os parâmetros e as opções.

Item de configuração	Descrição
cloud_url	O caminho completo do bucket que contém o arquivo de link simbólico.
target_object	O caminho completo do objeto para o qual o link simbólico aponta. O link simbólico e o objeto de destino devem estar no mesmo bucket.
--encoding-type	O tipo de codificação dos nomes dos objetos em `cloud_url` e `target_object`. Defina o valor como url. Caso não especifique essa opção, os nomes dos objetos não serão codificados.
--payer	O método de pagamento da solicitação. Especifique que o solicitante pagará por taxas como tráfego e número de solicitações; defina esta opção como requester.

Exemplos

Este comando não verifica se o objeto de destino existe ao criar um link simbólico. Se o objeto de destino existir, você poderá acessá-lo pelo link simbólico. Caso o objeto de destino não exista, não será possível acessá-lo pelo link simbólico. Se você não tiver certeza se o objeto de destino existe, execute o comando ls para listar todos os objetos no bucket de destino.

Os exemplos a seguir mostram como criar um link simbólico para um objeto existente:

Importante

Se o nome do novo link simbólico for igual ao de um link existente, o sistema substitui o link existente.

Crie um link simbólico chamado test.jpg no diretório raiz do bucket examplebucket que aponte para o objeto exampleobject.jpg no mesmo diretório.
```
ossutil create-symlink  oss://examplebucket/test.jpg  oss://examplebucket/exampleobject.jpg
```
Crie um link simbólico chamado example.jpg no diretório destfolder do bucket examplebucket. O link simbólico aponta para o objeto test.jpg no diretório raiz do bucket. O solicitante paga as taxas.
```
ossutil create-symlink  oss://examplebucket/destfolder/example.jpg  oss://examplebucket/test.jpg --payer requester
```
A saída a seguir confirma a criação do link simbólico.
```
0.106744(s) elapsed
```
Depois de criar o link simbólico, execute o comando read-symlink ou stat para obter informações sobre o link, como o valor do ETag e a hora da última modificação.

Opções comuns

Para acessar um bucket em uma região diferente, especifique o endpoint usando -e. Para acessar um bucket pertencente a uma conta alibaba cloud diferente, use -i para o accesskey (AccessKey ID / AccessKeyID) e -k para o AccessKeySecret.

Por exemplo, o comando a seguir cria um link simbólico chamado testobject.png para o objeto exampleobject.png. O objeto está no bucket testbucket, localizado na região china (Shanghai) e pertence a outra conta alibaba cloud.

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

Common options.