Object Storage Service:PrivateLink を介した OSS へのアクセス

ステップ 1: エンドポイントの作成

1. VPC エンドポイント ページに移動し、エンドポイントの作成 をクリックします。このサービスを初めて使用する場合は、画面の指示に従って PrivateLink サービスを有効化してください。

2. 以下のパラメータを設定し、記載されていないオプションはデフォルト値のままにします。

   • [リージョン]：ターゲット OSS バケットが配置されているリージョンを選択します。たとえば、中国 (杭州) です。

   • [エンドポイント名]：privatelink-oss のように、エンドポイントのわかりやすい名前を入力します。

   • [エンドポイントタイプ]: [インターフェイスエンドポイント] を選択します。

   • [エンドポイントサービス]: Alibaba Cloud サービス を選択し、リストから OSS エンドポイントサービス (名前の末尾が oss のエントリ) を選択します。

   • [VPC]：エンドポイントを作成するターゲット VPC を選択します。 利用可能な VPC がない場合は、VPC の作成をクリックして新しい VPC を作成します。

   • [セキュリティグループ]：アクセス許可を制御するために、エンドポイントにバインドするセキュリティグループを選択します。適切なセキュリティグループがない場合は、セキュリティグループの作成をクリックして作成します。

   • [ゾーンと vSwitch]: エンドポイントをデプロイするアベイラビリティゾーンと対応する vSwitch を選択します。 利用可能な vSwitch がない場合は、作成 をクリックして新規作成します。

3. OK をクリックすると、システムによってエンドポイントが自動的に作成されます。作成後、エンドポイント詳細ページで エンドポイントサービスドメイン名 を表示およびコピーできます。このドメイン名を後続の OSS アクセスに使用します。

   エンドポイントサービスのドメイン名は、 ep-<InstanceID>.oss.cn-hangzhou.privatelink.aliyuncs.com の形式です。[エンドポイントサービスのドメイン名] セクションで、[コピー] をクリックして取得します。

ステップ 2: エンドポイントの検証

接続テストとファイルダウンロードを実行して、PrivateLink エンドポイントが正しく設定されていることを確認します。

• ネットワーク接続の検証

  ping コマンドを使用して、エンドポイントドメイン名へのネットワーク接続をテストし、DNS 解決とネットワークパスが正しいことを確認します。

  ping -c 4 ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com

• ファイルダウンロードの検証

  同じリージョンの ECS インスタンスから、ossutil を使用して PrivateLink 接続経由でファイルをダウンロードし、エンドツーエンドでデータ転送が機能することを確認します。

  1. ossutil 2.0 のインストールと設定を行います。

  2. OSS リソースにアクセスするには、エンドポイントドメイン名 (例: ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com) を使用します。 次の例では、example-bucket という名前のバケットから dest.jpg という名前のファイルをダウンロードします。

     ossutil cp oss://example-bucket/dest.jpg /tmp/ -e ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com --addressing-style path

     コマンドが成功すると、ファイルがダウンロードされたことを示す次の出力が表示されます。ダウンロードしたファイルは /tmp ディレクトリで確認できます。

     Success: Total 1 object, size 134102 B, Download done:(1 files, 134102 B), avg 680.112 KiB/s
     0.193189(s) elapsed

ステップ 1: SSL-VPN ゲートウェイの作成とクライアントの設定

SSL-VPN ゲートウェイをデプロイし、クライアント設定を完了し、ローカルデバイスと VPC の間に暗号化された接続を確立します。詳細な設定手順については、「SSL-VPN 接続を使用した PC または Android デバイスの VPC への接続」をご参照ください。

ステップ 2: PrivateLink による OSS アクセスの検証

接続テストとファイルダウンロードを実行して PrivateLink 接続を検証し、プライベートアクセスリンクが機能していることを確認します。

• 接続の検証

  ping コマンドを使用して、エンドポイントドメイン名へのネットワーク接続性をテストし、DNS 解決とネットワークパスが正しいことを確認します。

  ping -c 4 ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com

• ファイルダウンロードの検証

  ossutil

  ossutil を使用してファイル操作を実行し、接続を検証します。

  1. ossutil 2.0 のインストールと設定を行います。

  2. エンドポイントドメイン名 (例: ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com) を使用して OSS リソースにアクセスします。 次の例では、example-bucket という名前のバケットから、dest.jpg という名前のファイルをダウンロードします。

     ossutil cp oss://example-bucket/dest.jpg /tmp/ -e ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com --addressing-style path

     コマンドが正常に実行されると、ファイルがダウンロードされたことを示す次の出力が表示されます。ダウンロードされたファイルは /tmp ディレクトリで確認できます。

     Success: Total 1 object, size 134102 B, Download done:(1 files, 134102 B), avg 680.112 KiB/s
     0.193189(s) elapsed

  SDK

  SDK を使用すると、より本番環境に近い状況を再現でき、複雑なビジネスロジックの統合と例外処理をサポートします。以下の SDK は、PrivateLink を介した OSS へのアクセスをサポートしています。

  Java

  PrivateLink 経由で OSS にアクセスする場合は、setSLDEnabled(true) を呼び出してパス形式のアクセスモードを有効にします。パブリックネットワークアクセスの場合は、setSLDEnabled(false) に設定します。

  import com.aliyun.oss.*;
  import com.aliyun.oss.common.auth.*;
  import com.aliyun.oss.common.comm.SignVersion;
  import com.aliyun.oss.model.GetObjectRequest;
  import java.io.File;
  /**
   * OSS PrivateLink アクセスの例
   * PrivateLink を使用して OSS にアクセスし、ファイルをダウンロードする方法を示します
   */
  public class Test {
      public static void main(String[] args) throws Exception {
          // PrivateLink エンドポイントのドメイン名。
          String endpoint = "https://ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com";
          // エンドポイントに対応するリージョンを指定します (例: cn-hangzhou)。
          String region = "cn-hangzhou";
          // 環境変数から認証情報を取得します。
          // 実行前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数を設定してください。
          EnvironmentVariableCredentialsProvider credentialsProvider =
                  CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
          // バケット名を指定します (例: example-bucket)。
          String bucketName = "example-bucket";
          // オブジェクトの完全なパスを指定します (バケット名は除く)。
          String objectName = "dest.jpg";
          // ローカルファイル名を指定します。
          String pathName = "dest.jpg";
          // クライアントパラメータを設定します。
          ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
          // PrivateLink アクセスの場合、パス形式のアクセスを有効にします。バケットのパブリックドメイン名経由でアクセスする場合は false に設定します。
          clientBuilderConfiguration.setSLDEnabled(true);
          // Signature Version 4 アルゴリズムの使用を明示的に宣言します。
          clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
          // OSS クライアントインスタンスを作成します。
          OSS ossClient = OSSClientBuilder.create()
                  .endpoint(endpoint)
                  .credentialsProvider(credentialsProvider)
                  .clientConfiguration(clientBuilderConfiguration)
                  .region(region)
                  .build();
          try {
              // オブジェクトをローカルファイルにダウンロードします。
              // 指定したローカルファイルが存在する場合は上書きされ、存在しない場合は新規作成されます。
              // ローカルパスを指定しない場合、ダウンロードしたファイルはプロジェクトのルートディレクトリに保存されます。
              ossClient.getObject(new GetObjectRequest(bucketName, objectName), new File(pathName));
          } catch (OSSException oe) {
              // OSS サーバー側の例外を処理します。
              System.out.println("Caught an OSSException, which means your request made it to the OSS server, but was rejected with an error response.");
              System.out.println("Error Message: " + oe.getErrorMessage());
              System.out.println("Error Code: " + oe.getErrorCode());
              System.out.println("Request ID: " + oe.getRequestId());
              System.out.println("Host ID: " + oe.getHostId());
          } catch (ClientException ce) {
              // クライアント側の例外を処理します。
              System.out.println("Caught a ClientException, which means the client encountered a serious internal problem while trying to communicate with OSS, " +
                      "such as not being able to access the network.");
              System.out.println("Error Message: " + ce.getMessage());
          } finally {
              // リソースを解放します。
              if (ossClient != null) {
                  ossClient.shutdown();
              }
          }
      }
  }

  Python

  PrivateLink 経由で OSS にアクセスする際は、is_path_style=True を設定してパススタイルのアクセスモードを有効にします。

  # -*- coding: utf-8 -*-
  """
  OSS PrivateLink アクセスの例
  PrivateLink 経由で OSS にアクセスし、ファイルをローカルにダウンロードします。
  """
  import oss2
  from oss2.credentials import EnvironmentVariableCredentialsProvider
  def main():
      """メイン関数: PrivateLink 経由で OSS にアクセスし、ファイルをダウンロードする方法を示します。"""
      # アクセス認証情報を設定します。
      # 注意: Alibaba Cloud アカウントの AccessKey にはすべての API 権限があり、リスクが高いです。
      # API アクセスや日常的な O&M には、RAM ユーザーの作成と使用を強く推奨します。RAM ユーザーを作成するには、RAM コンソールにログインしてください。
      auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
      # PrivateLink エンドポイントのドメイン名。
      endpoint = 'https://ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com'
      # バケット名。
      bucket_name = 'example-bucket'
      # Bucket オブジェクトを作成します。
      # is_path_style=True を設定すると、パス形式のアクセスモードが有効になり、PrivateLink などのシナリオに適しています。
      bucket = oss2.Bucket(auth, endpoint, bucket_name, is_path_style=True)
      # OSS オブジェクトのパス (バケット名を除く完全なパス)。
      object_name = 'dest.jpg'
      # ファイルを保存するローカルパス。
      local_file_path = 'dest.jpg'
      # オブジェクトをローカルファイルにダウンロードします。
      # 指定したローカルファイルが存在する場合は上書きされ、存在しない場合は新規作成されます。
      bucket.get_object_to_file(object_name, local_file_path)
      print(f"File downloaded successfully: {object_name} -> {local_file_path}")
  if __name__ == '__main__':
      main()      

  Go

  PrivateLink 経由で OSS にアクセスする場合、ForcePathStyle(true) を使用してパススタイルのアクセスモードを有効にします。

  package main
  import (
  	"fmt"
  	"os"
  	"github.com/aliyun/aliyun-oss-go-sdk/oss"
  )
  const (
  	// PrivateLink エンドポイントのドメイン名。
  	endpoint = "https://ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com"
  	// バケット名。
  	bucketName = "example-bucket"
  	// OSS オブジェクトのパス (バケット名を除く完全なパス)。
  	objectName = "dest.jpg"
  	// ファイルを保存するローカルパス。
  	localFilePath = "dest.jpg"
  )
  func main() {
  	// アクセス認証情報プロバイダーを初期化します。
  	// 環境変数から認証情報を取得します。
  	// このコード例を実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
  	provider, err := oss.NewEnvironmentVariableCredentialsProvider()
  	if err != nil {
  		fmt.Printf("Failed to initialize credentials provider: %v\n", err)
  		os.Exit(-1)
  	}
  	// OSS クライアントインスタンスを作成します。
  	// oss.ForcePathStyle(true) を使用してパス形式のアクセスモードを有効にします。これは PrivateLink などのシナリオに適しています。
  	client, err := oss.New(
  		endpoint,
  		"", // AccessKeyId は認証情報プロバイダーを通じて取得されます。
  		"", // AccessKeySecret は認証情報プロバイダーを通じて取得されます。
  		oss.SetCredentialsProvider(&provider),
  		oss.ForcePathStyle(true),
  	)
  	if err != nil {
  		fmt.Printf("Failed to create OSS client: %v\n", err)
  		os.Exit(-1)
  	}
  	// Bucket オブジェクトを取得します。
  	bucket, err := client.Bucket(bucketName)
  	if err != nil {
  		fmt.Printf("Failed to get Bucket object: %v\n", err)
  		os.Exit(-1)
  	}
  	// オブジェクトをローカルファイルにダウンロードします。
  	// 指定したローカルファイルが存在する場合は上書きされ、存在しない場合は新規作成されます。
  	// ローカルパスを指定しない場合、ダウンロードしたファイルはプロジェクトのルートディレクトリに保存されます。
  	err = bucket.GetObjectToFile(objectName, localFilePath)
  	if err != nil {
  		fmt.Printf("Failed to download file: %v\n", err)
  		os.Exit(-1)
  	}
  	fmt.Printf("File downloaded successfully: %s -> %s\n", objectName, localFilePath)
  }
  

  C++

  PrivateLink 経由で OSS にアクセスする場合は、conf.isPathStyle = true を設定してパススタイルのアクセスモードを有効にします。

  #include <alibabacloud/oss/OssClient.h>
  #include <memory>
  #include <fstream>
  #include <iostream>
  using namespace AlibabaCloud::OSS;
  int main(void)
  {
      // PrivateLink エンドポイントのドメイン名。
      std::string Endpoint = "https://ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com";
      // バケット名。
      std::string BucketName = "example-bucket";
      // OSS オブジェクトのパス (バケット名を含めないでください)。
      std::string ObjectName = "dest.jpg";
      // ファイルを保存するローカルパス。
      // 指定したローカルファイルが存在する場合は上書きされ、存在しない場合は新規作成されます。
      // ローカルパスを指定しない場合、ダウンロードしたファイルはプロジェクトのルートディレクトリに保存されます。
      std::string FileNametoSave = "dest.jpg";
      // OSS SDK リソースを初期化します。
      InitializeSdk();
      // クライアントパラメータを設定します。
      ClientConfiguration conf;
      // 環境変数から認証情報を取得します。
      // このコード例を実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
      auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
      // パス形式のアクセスモードを有効にします。PrivateLink などのシナリオに適しています。
      conf.isPathStyle = true;
      // OSS クライアントインスタンスを作成します。
      OssClient client(Endpoint, credentialsProvider, conf);
      // GetObject リクエストを構築します。
      GetObjectRequest request(BucketName, ObjectName);
      // レスポンスストリームファクトリを設定してローカルファイルストリームを作成します。
      request.setResponseStreamFactory([=]() {
          return std::make_shared<std::fstream>(
              FileNametoSave, 
              std::ios_base::out | std::ios_base::in | std::ios_base::trunc | std::ios_base::binary
          );
      });
      // ダウンロード操作を実行します。
      auto outcome = client.GetObject(request);
      // ダウンロード結果を処理します。
      if (outcome.isSuccess()) {
          std::cout << "File downloaded successfully. Size: " 
                    << outcome.result().Metadata().ContentLength() 
                    << " bytes" << std::endl;
          std::cout << "File saved to: " << FileNametoSave << std::endl;
      }
      else {
          // エラーを処理します。
          std::cout << "File download failed" << std::endl
                    << "Error code: " << outcome.error().Code() << std::endl
                    << "Error message: " << outcome.error().Message() << std::endl
                    << "Request ID: " << outcome.error().RequestId() << std::endl;
          // リソースを解放し、エラーコードを返します。
          ShutdownSdk();
          return -1;
      }
      // OSS SDK リソースを解放します。
      ShutdownSdk();
      return 0;
  }