O comando read-symlink lê informações sobre um link simbólico, como o valor de ETag e a hora da última modificação. Essa operação requer permissões de leitura para o link simbólico.
Notas de uso
Para ler um link simbólico, você deve ter a permissão oss:GetObject. Para mais informações, consulte Grant custom policies to a RAM user.
Para o ossutil 1.6.16 e versões posteriores, use ossutil como o nome do binário na linha de comando e não atualize o nome do binário com base no sistema operacional. Para versões do ossutil anteriores à 1.6.16, atualize o nome do binário de acordo com o sistema operacional. Para mais informações, consulte ossutil command reference.
Para mais informações sobre links simbólicos, consulte Symbolic links.
Sintaxe do comando
ossutil read-symlink oss://bucketname/objectname [--encoding-type <value>] [--payer <value>]A tabela a seguir descreve os parâmetros e opções.
|
Parâmetro |
Descrição |
|
bucketname |
O nome do bucket. |
|
objectname |
O nome do link simbólico. |
|
--encoding-type |
O método de codificação para o nome do link simbólico. Defina o valor como url. Caso não especifique esta opção, o nome não será codificado. |
|
--payer |
O método de pagamento para a solicitação. Se você quiser 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 sobre o link simbólico chamado test.jpg no bucket examplebucket.
ossutil read-symlink oss://examplebucket/test.jpgA saída a seguir mostra o valor de ETag, a hora 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) elapsedExecute este comando em um objeto que não seja um link simbólico. O erro NotSymlink será retornado.
Opções comuns
Para acessar um bucket em uma região diferente, use -e e especifique o endpoint. Para acessar um bucket de propriedade de uma conta Alibaba Cloud diferente, use -i para o AccessKeyID e -k para o AccessKeySecret.
Por exemplo, execute o seguinte comando para ler informações sobre o link simbólico chamado testobject.png no bucket testbucket. O bucket está 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