O comando read-symlink lê informações sobre um link simbólico, como o valor ETag e a data da última modificação. Essa operação exige permissões de leitura no link simbólico.
Observações de uso
Para ler um link simbólico, você precisa ter a permissão oss:GetObject. Para mais informações, consulte Conceder políticas personalizadas a um usuário RAM.
No ossutil 1.6.16 e versões posteriores, use ossutil como nome do binário na linha de comando. Não é necessário alterar o nome do binário conforme o sistema operacional. Nas versões anteriores à 1.6.16, atualize o nome do binário de acordo com o sistema operacional. Para mais detalhes, consulte Referência de comandos do ossutil.
Para obter mais informações sobre links simbólicos, consulte Links simbólicos.
Sintaxe do comando
ossutil read-symlink oss://bucketname/objectname [--encoding-type <value>] [--payer <value>]A tabela a seguir descreve os parâmetros e as opções.
|
Parâmetro |
Descrição |
|
bucketname |
Nome do bucket. |
|
objectname |
Nome do link simbólico. |
|
--encoding-type |
Método de codificação para o nome do link simbólico. Defina o valor como url. Se você não especificar essa opção, o nome não será codificado. |
|
--payer |
Método de pagamento da solicitação. Para que o solicitante que acessa os recursos no caminho especificado pague pelas taxas, como tráfego e solicitações, defina o valor desta opção como requester. |
Exemplos
O exemplo a seguir mostra como ler informações do link simbólico chamado test.jpg no bucket examplebucket.
ossutil read-symlink oss://examplebucket/test.jpgA saída abaixo exibe o valor ETag, a data da última modificação (Last-Modified) e o arquivo de destino (X-Oss-Symlink-Target) do link simbólico test.jpg. O arquivo de destino é example.jpg.
Etag : 938F26218CE422CBEEE0B6543A2B2D
Last-Modified : 2021-04-21 18:00:13 +0800 CST
X-Oss-Symlink-Target : example.jpg
0.217317(s) elapsedSe você executar esse comando em um objeto que não seja um link simbólico, o sistema retornará o erro NotSymlink.
Opções comuns
Para acessar um bucket em outra região, use -e para especificar o endpoint. Para acessar um bucket pertencente a uma conta Alibaba Cloud diferente, use -i para o AccessKey ID e -k para o AccessKey secret.
Por exemplo, execute o comando abaixo para ler informações do link simbólico chamado testobject.png no bucket testbucket. Esse bucket está localizado na região China (Shanghai) e pertence a outra conta Alibaba Cloud.
ossutil read-symlink oss://testbucket/testobject.png -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret