Object Storage Service:PrivateLink 経由での OSS へのアクセス

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

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

2. 以下のパラメーターを設定します。リストにないパラメーターはデフォルト値のままにします。

   • [リージョン]: ターゲットの OSS バケットのリージョン (中国 (杭州) など) を選択します。

   • エンドポイント名: エンドポイントの説明的な名前 (例: privatelink-oss) を入力します。

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

   • エンドポイントサービス: [Alibaba Cloud サービス] を選択します。サービスリストで、OSS エンドポイントサービスを選択します。サービス名は oss で終わります。

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

   • [セキュリティグループ]: エンドポイントにアタッチするセキュリティグループを選択します。セキュリティグループはアクセス権限を制御します。適切なセキュリティグループがない場合は、[セキュリティグループの作成] をクリックします。

   • [ゾーンと VSwitch]: エンドポイントがデプロイされるゾーンと対応する vSwitch を選択します。利用可能な vSwitch がない場合は、[VSwitch の作成] をクリックします。

3. [OK] をクリックします。システムは自動的にエンドポイントを作成します。エンドポイントが作成されたら、その詳細ページに移動して [エンドポイントドメイン名] を表示およびコピーします。このドメイン名は、後続の OSS へのアクセスに使用します。

   

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

ネットワーク接続をテストし、OSS からファイルをダウンロードすることで、エンドポイントの設定を検証できます。これにより、PrivateLink 接続が正しく機能していることを確認できます。

• ネットワーク接続の確認

  ping コマンドを使用して、エンドポイントドメイン名のネットワーク接続をテストできます。これにより、DNS 解決とネットワークパスが機能していることを確認できます。

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

• ファイルダウンロードの確認

  同じリージョン内の ECS インスタンスで ossutil ツールを使用して、OSS からファイルをダウンロードできます。これにより、接続を介してデータを転送できることを確認できます。

  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

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

オンプレミスデバイスと VPC の間に暗号化された接続を確立するには、SSL-VPN Gateway をデプロイし、クライアント構成を完了します。詳細については、「SSL-VPN 接続を介してクライアントから VPC にアクセスする」をご参照ください。

ステップ 2: OSS への PrivateLink アクセスの検証

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

• 接続性の検証

  ping コマンドを使用して、エンドポイントドメイン名のネットワーク接続をテストできます。これにより、DNS 解決とネットワークパスが機能していることを確認できます。

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

• ファイルダウンロードの確認

  ossutil

  同じリージョン内の ECS インスタンスで、ossutil ツールを使用して OSS でファイル操作を実行します。これにより、PrivateLink 接続の機能とデータ転送の安定性が検証されます。

  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) を使用してパス形式のアクセスを有効にします。パブリックインターネット経由で OSS にアクセスする場合は、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);
  
          // V4 署名アルゴリズムの使用を明示的に宣言します。
          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'
      
      # バケットオブジェクトを作成します。
      # 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, 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;
  }