すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:シンボリックリンクの管理

最終更新日:Feb 26, 2024

シンボリックリンクはWindowsのファイルショートカットのように機能し、Object Storage Service (OSS) の関連オブジェクトにすばやくアクセスできます。

使用上の注意

  • このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用します。 OSSと同じリージョンにある他のAlibaba CloudサービスからOSSにアクセスする場合は、内部エンドポイントを使用します。 OSSリージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。

  • このトピックでは、アクセス資格情報は環境変数から取得します。 アクセス資格情報の設定方法の詳細については、「アクセス資格情報の設定」をご参照ください。

  • このトピックでは、OSSエンドポイントを使用してOSSClientインスタンスを作成します。 カスタムドメイン名またはSTS (Security Token Service) を使用してOSSClientインスタンスを作成する場合は、「初期化」をご参照ください。

  • シンボリックリンクを作成するには、oss:PutObject権限が必要です。 シンボリックリンクをクエリするには、oss:GetObject権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

シンボリックリンクの作成

次のサンプルコードは、シンボリックリンクを作成する方法の例を示しています。

# -*-コーディング: utf-8 -*-
oss2のインポート
oss2.credentialsからEnvironmentVariableCredentialsProviderをインポート
# 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。 
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# この例では、中国 (杭州) リージョンのエンドポイントが使用されます。 実際のエンドポイントを指定します。 他のリージョンのエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。 
# バケットの名前を指定します。 例: examplebucket. バケットの命名規則の詳細については、「バケットの命名規則」をご参照ください。 
bucket = oss2.Bucket(auth, 'https:// oss-cn-hangzhou.aliyuncs.com ', 'examplebucket')
# シンボリックリンクを指すオブジェクトの名前を指定します。 例: exampleobject.txt。 // オブジェクトの命名規則の詳細については、「オブジェクトの命名規則」をご参照ください。 
object_name = 'exampleobject.txt'
# シンボリックリンクの名称を指定します。 例: examplesymlick.txt。 
symlink = 'examplesymlick.txt ';

# headers = dict()
# シンボリックリンクと同じ名前のオブジェクトを上書きするかどうかを指定します。 この例では、x-oss-forbid-overwriteをtrueに設定します。 これは、同じ名前のオブジェクトを上書きできないことを示します。 
# headers['x-oss-forbid-overwrite'] = 'true'
# オブジェクトのアクセス制御リスト (ACL) を指定します。 この例では、このパラメーターはOBJECT_ACL_PRIVATEに設定され、オブジェクトのACLがプライベートであることを示します。 オブジェクトに対する読み取りおよび書き込み権限を持つのは、オブジェクトの所有者および許可されたユーザーのみです。 
# headers[OSS_OBJECT_ACL] = oss2.OBJECT_ACL_PRIVATE
# オブジェクトのストレージクラスを指定します。 この例では、ストレージクラスはStandardに設定されています。 
# headers['x-oss-storage-classs'] = oss2.BUCKET_STORAGE_CLASS_STANDARD
# bucket.put_symlink(object_name、symlink、headers=headers)
# シンボリックリンクを作成します。 
bucket.put_symlink(object_name, symlink) 

シンボリックリンクが指すオブジェクトの名前を照会する

シンボリックリンクを照会するには、シンボリックリンクの読み取り権限が必要です。 次のサンプルコードは、シンボリックリンクを照会する方法と、シンボリックリンクが指すオブジェクトの名前の例を示しています。

# -*-コーディング: utf-8 -*-
oss2のインポート
oss2.credentialsからEnvironmentVariableCredentialsProviderをインポート

# 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。 
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# この例では、中国 (杭州) リージョンのエンドポイントが使用されます。 実際のエンドポイントを指定します。 
# バケットの名前を指定します。 例: examplebucket. 
bucket = oss2.Bucket(auth, 'https:// oss-cn-hangzhou.aliyuncs.com ', 'examplebucket')
# シンボリックリンクの名称を指定します。 
symlink = 'examplesymlick.txt ';
# シンボリックリンクとそのシンボリックリンクが指すオブジェクトの名前を照会します。 
bucket.get_symlink(symlink)
result = bucket.get_symlink(symlink)
print(result.tar get_key) 

参考資料

  • シンボリックリンクを作成するために呼び出すことができるAPI操作の詳細については、「PutSymlink」をご参照ください。

  • シンボリックリンクを照会するために呼び出すことができるAPI操作の詳細については、「GetSymlink」をご参照ください。