Manage symbolic links by using OSS SDK for Python V2 - Object Storage Service

Object Storage Service (OSS) içindeki sembolik bağlantılar, Windows'taki dosya kısayolları gibi çalışır ve ilişkili nesnelere hızlı erişim sağlar. Bu konuda, Python için OSS SDK kullanarak sembolik bağlantıların nasıl oluşturulacağı ve alınacağı açıklanmaktadır.

Kullanım notları

Bu konudaki örnek kod, Çin (Hangzhou) bölgesinin bölge kimliği olan cn-hangzhou değerini kullanır. Bir paket içindeki kaynaklara erişmek için varsayılan olarak genel bir uç nokta kullanılır. Paketin bulunduğu aynı bölgedeki diğer Alibaba Cloud hizmetlerinden paketteki kaynaklara erişmek istiyorsanız dahili bir uç nokta kullanın. OSS'in desteklediği bölgeler ve uç noktalar hakkında daha fazla bilgi için bkz. Bölgeler ve uç noktalar.
Sembolik bağlantı oluşturmak için oss:PutObject iznine sahip olmanız gerekir. Sembolik bağlantıyı sorgulamak için oss:GetObject iznine sahip olmanız gerekir. Daha fazla bilgi için bkz. RAM kullanıcıya özel izinler atama.

Yöntem

Sembolik bağlantı oluşturma

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

Sembolik bağlantı alma

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

İstek parametreleri

Parametre	Tür	Açıklama
request	PutSymlinkRequest	Sembolik bağlantı oluşturmak için gereken istek parametreleri. Daha fazla bilgi için bkz. PutSymlinkRequest
request	GetSymlinkRequest	Sembolik bağlantı almak için gereken istek parametreleri. Daha fazla bilgi için bkz. GetSymlinkRequest

Yanıt parametreleri

Tür	Açıklama
PutSymlinkResult	Dönüş değeri. Daha fazla bilgi için bkz. PutSymlinkResult
GetSymlinkResult	Dönüş değeri. Daha fazla bilgi için bkz. GetSymlinkResult

Sembolik bağlantı oluşturma yönteminin tam tanımı için bkz. put_symlink.

Sembolik bağlantı alma yönteminin tam tanımı için bkz. get_symlink.

Örnek kod

Sembolik bağlantı oluşturma

Aşağıda sembolik bağlantı oluşturmaya ilişkin örnek kod yer almaktadır.

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()

Sembolik bağlantı alma

Aşağıda sembolik bağlantıyı ve hedef nesnenin adını almaya ilişkin örnek kod yer almaktadır.

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()

Referanslar

Sembolik bağlantı oluşturmaya ilişkin eksiksiz örnek kod için bkz. put_symlink.py.
Sembolik bağlantı almaya ilişkin eksiksiz örnek kod için bkz. get_symlink.py.