Gerencie links simbólicos usando o OSS SDK for Python V2 - Object Storage Service: Central de Documentação do Alibaba Cloud

Os links simbólicos no Object Storage Service (OSS) funcionam como atalhos de arquivo no Windows e permitem acesso rápido aos objetos associados. Este tópico descreve como usar o OSS SDK for Python para criar e recuperar links simbólicos.

Observações de uso

O código de exemplo neste tópico usa o ID da região cn-hangzhou, correspondente à região China (Hangzhou). Por padrão, o acesso aos recursos em um bucket ocorre por um endpoint público. Para acessar os recursos do bucket a partir de outros serviços da Alibaba Cloud na mesma região, use um endpoint interno. Para mais informações sobre as regiões e endpoints compatíveis com o OSS, consulte Regiões e endpoints.
A criação de um link simbólico exige a permissão oss:PutObject. A consulta exige a permissão oss:GetObject. Para mais detalhes, consulte Conceder permissões personalizadas a um usuário RAM.

Método

Criar um link simbólico

put_symlink(request: PutSymlinkRequest, **kwargs) → PutSymlinkResult

Obter um link simbólico

get_symlink(request: GetSymlinkRequest, **kwargs) → GetSymlinkResult

Parâmetros da solicitação

Parâmetro	Tipo	Descrição
request	PutSymlinkRequest	Parâmetros da solicitação para criar um link simbólico. Para mais informações, consulte PutSymlinkRequest
request	GetSymlinkRequest	Parâmetros da solicitação para obter um link simbólico. Para mais informações, consulte GetSymlinkRequest

Parâmetros de resposta

Tipo	Descrição
PutSymlinkResult	Valor de retorno. Para mais informações, consulte PutSymlinkResult
GetSymlinkResult	Valor de retorno. Para mais informações, consulte GetSymlinkResult

Para a definição completa do método de criação de link simbólico, consulte put_symlink.

Para a definição completa do método de obtenção de link simbólico, consulte get_symlink.

Código de exemplo

Crie um link simbólico

Veja abaixo o código de exemplo para criar um link simbólico.

import argparse
import alibabacloud_oss_v2 as oss

# Create a command-line argument parser
parser = argparse.ArgumentParser(description="put symlink sample")
# Add command-line arguments
parser.add_argument('--region', help='The region in which the bucket is located.', required=True)
parser.add_argument('--bucket', help='The name of the bucket.', required=True)
parser.add_argument('--endpoint', help='The domain names that other services can use to access OSS')
parser.add_argument('--key', help='The name of the object.', required=True)
parser.add_argument('--target', help='The destination object to which the symbolic link points.', required=True)

def main():
    # Parse command-line arguments
    args = parser.parse_args()

    # Load credentials from environment variables
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # Use the default configurations of the SDK
    cfg = oss.config.load_default()
    # Set the credential provider
    cfg.credentials_provider = credentials_provider
    # Set the region
    cfg.region = args.region
    # If an endpoint is provided, set the endpoint
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # Create an OSS client
    client = oss.Client(cfg)

    # Create a request to create a symbolic link
    result = client.put_symlink(oss.PutSymlinkRequest(
        bucket=args.bucket,  # Specify the bucket name
        key=args.key,        # Specify the object name
        target=args.target,  # Specify the target object
    ))

    # Print the result
    print(f'status code: {result.status_code},'
          f' request id: {result.request_id},'
          f' version id: {result.version_id},'
    )

# If the script is run directly, call the main function
if __name__ == "__main__":
    main()

Obter um link simbólico

Veja abaixo o código de exemplo para obter um link simbólico e o nome do objeto de destino.

import argparse
import alibabacloud_oss_v2 as oss

# Create an ArgumentParser object to parse command-line arguments
parser = argparse.ArgumentParser(description="get symlink sample")
# Add command-line arguments
parser.add_argument('--region', help='The region in which the bucket is located.', required=True)
parser.add_argument('--bucket', help='The name of the bucket.', required=True)
parser.add_argument('--endpoint', help='The domain names that other services can use to access OSS')
parser.add_argument('--key', help='The name of the object.', required=True)

def main():
    # Parse command-line arguments
    args = parser.parse_args()

    # Load credentials from environment variables
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # Use the default configurations of the SDK
    cfg = oss.config.load_default()
    # Set the credential provider
    cfg.credentials_provider = credentials_provider
    # Set the region
    cfg.region = args.region
    # If an endpoint is provided, set the endpoint
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # Create an OSS client
    client = oss.Client(cfg)

    # Send a request to obtain the symbolic link
    result = client.get_symlink(oss.GetSymlinkRequest(
        bucket=args.bucket,
        key=args.key,
    ))

    # Print the result
    print(f'status code: {result.status_code},'
          f' request id: {result.request_id},'
          f' version id: {result.version_id},'
          f' target: {result.target},'
          f' etag: {result.etag},'
    )

# If the script is run directly, call the main function
if __name__ == "__main__":
    main()

Referências

Para acessar o código de exemplo completo sobre criação de links simbólicos, consulte put_symlink.py.
O código de exemplo completo para obtenção de links simbólicos está disponível em get_symlink.py.