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 の作成] をクリックして作成します。

1. [OK] をクリックします。システムが自動的にエンドポイントを作成します。エンドポイントの詳細ページで、[エンドポイントサービスのドメイン名] をコピーします。このドメイン名を使用して OSS にアクセスします。

   

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

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

• 接続性の検証

  ping を使用してエンドポイントのドメイン名をテストし、DNS 名前解決とネットワークパスが正しく機能していることを確認します。

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

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

  同じリージョン内の ECS インスタンスから、ossutil を使用して 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

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

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

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

接続性テストとファイルのダウンロードを実行して、ローカルデバイスから PrivateLink 接続が正しく機能していることを確認します。

• 接続性の検証

  ping を使用してエンドポイントのドメイン名をテストし、DNS 名前解決とネットワークパスが正しく機能していることを確認します。

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

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

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

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

        0.193189(s) elapsed

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

              // 署名バージョン 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: the request reached OSS but was rejected.");
                  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) {
                  // クライアントが OSS と通信できなかった
                  System.out.println("Caught a ClientException: the client encountered a serious internal problem, " +
                          "such as a network failure.");
                  System.out.println("Error message: " + ce.getMessage());

              } finally {
                  // リソースの解放
                  if (ossClient != null) {
                      ossClient.shutdown();
                  }
              }
          }
      }

  # -*- coding: utf-8 -*-
      """
      OSS PrivateLink アクセスの例
      PrivateLink プライベートネットワーク接続を介して OSS からファイルをダウンロードします
      """

      import oss2
      from oss2.credentials import EnvironmentVariableCredentialsProvider

      def main():
          """PrivateLink を介して OSS からファイルをダウンロードします。"""

          # 認証情報の設定
          # 注：Alibaba Cloud アカウントの AccessKey は完全な API アクセス権を持ち、高いリスクを伴います。
          # API アクセスや日常的な操作には 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()

  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: %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)
      }
    

  #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);

          // ダウンロードリクエストの構築
          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 << "Saved to: " << FileNametoSave << std::endl;
          }
          else {
              // エラー処理
              std::cout << "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;
      }