Manage symbolic links by using 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 acessar rapidamente os objetos associados. Este tópico descreve como usar o OSS SDK for Python para a criação e a obtenção de links simbólicos.

Observações de uso

O código de exemplo neste tópico usa o ID da região cn-hangzhou, referente à região China (Hangzhou). Por padrão, o acesso aos recursos de um bucket utiliza um endpoint público. Para acessar os recursos do bucket a partir de outros serviços da Alibaba Cloud na mesma região do bucket, use um endpoint interno. Para obter mais informações sobre as regiões e os endpoints compatíveis com o OSS, consulte Regions and endpoints.
Para a criação de um link simbólico, você deve ter a permissão oss:PutObject. Para consultar um link simbólico, é necessária a permissão oss:GetObject. Para obter mais informações, consulte Grant custom permissions to a RAM user.

Método

Crie um link simbólico

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

Obtenha um link simbólico

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

Parâmetros da requisição

Parâmetro	Tipo	Descrição
request	PutSymlinkRequest	Os parâmetros da requisição para a criação de um link simbólico. Para obter mais informações, consulte PutSymlinkRequest
request	GetSymlinkRequest	Os parâmetros da requisição para obter um link simbólico. Para obter mais informações, consulte GetSymlinkRequest

Parâmetros de resposta

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

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

Para ver a definição completa do método para obter um link simbólico, consulte get_symlink.

Código de exemplo

Crie um link simbólico

Abaixo está o código de exemplo para a criação de 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()

Obtenha um link simbólico

Abaixo está o código de exemplo para obter um link simbólico e o nome do seu 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 o código de exemplo completo para a criação de um link simbólico, consulte put_symlink.py.
Para o código de exemplo completo para obter um link simbólico, consulte get_symlink.py.