Object Storage Service:PrivateLink を使用してプライベートネットワーク経由で OSS にアクセス

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

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

2. 以下のパラメーターを設定します。その他のパラメーターはデフォルト値のままにしておいても問題ありません。

   • リージョン：対象の OSS バケットが配置されているリージョン（例：中国 (杭州)）を選択します。

   • エンドポイント名：エンドポイントのわかりやすい名前（例：privatelink-oss）を入力します。

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

   • エンドポイントサービス：Alibaba Cloud サービス を選択し、サービス一覧から OSS エンドポイントサービスを選択します。サービス名は oss で終わります。

     説明

     OSS エンドポイントサービスがサービス一覧に表示されない場合は、テクニカルサポート までご連絡のうえ、有効化をリクエストしてください。

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

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

   • ゾーンと vSwitch：エンドポイントをデプロイする可用性ゾーンおよび対応する vSwitch を選択します。利用可能な vSwitch がない場合は、作成 をクリックして作成します。

3. OK をクリックします。システムが自動的にエンドポイントを作成します。エンドポイント作成後、エンドポイント詳細ページに移動し、OSS にアクセスするために使用するエンドポイントサービスドメイン名を表示・コピーします。

   

手順 2: エンドポイントを確認する

接続テストを実行し、ファイルをダウンロードして、PrivateLink エンドポイントが正常に機能していることを確認します。

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

  ping コマンドを使用してエンドポイントのドメイン名をテストし、DNS 解決およびネットワークパスが正常に動作していることを確認します。

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

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

  同一リージョン内の 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

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

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

ステップ 2：OSS へのプライベートアクセスの検証

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

• 接続性の検証

  ping コマンドを使用してエンドポイントのドメイン名をテストし、DNS 解決およびネットワークパスが正常に動作していることを確認します。

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

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

  ossutil

  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

  SDK

  SDK の使用は、複雑なビジネスロジックや例外処理を可能にするため、本番環境により代表的です。

  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 access example
   * Demonstrates how to access OSS and download a file by using PrivateLink.
   */
  public class Test {
  
      public static void main(String[] args) throws Exception {
          // The PrivateLink endpoint domain.
          String endpoint = "https://ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com";
  
          // Specify the region that corresponds to the endpoint. For example, cn-hangzhou.
          String region = "cn-hangzhou";
  
          // Obtain credentials from environment variables.
          // Before you run this sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
          EnvironmentVariableCredentialsProvider credentialsProvider =
                  CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
  
          // Specify the bucket name. For example, example-bucket.
          String bucketName = "example-bucket";
  
          // Specify the full path of the object. Do not include the bucket name in the full path.
          String objectName = "dest.jpg";
  
          // Specify the local path to save the downloaded file.
          String pathName = "dest.jpg";
  
          // Configure client parameters.
          ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
  
          // Enable path-style access for PrivateLink. Set this parameter to false for public internet access through the bucket's public domain name.
          clientBuilderConfiguration.setSLDEnabled(true);
  
          // Explicitly use Signature Version 4.
          clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
  
          // Create an OSS client instance.
          OSS ossClient = OSSClientBuilder.create()
                  .endpoint(endpoint)
                  .credentialsProvider(credentialsProvider)
                  .clientConfiguration(clientBuilderConfiguration)
                  .region(region)
                  .build();
  
          try {
              // Download the object to a local file.
              // If the specified local file exists, it is overwritten. If it does not exist, it is created.
              // If you do not specify a local path, the file is downloaded to the project's root directory.
              ossClient.getObject(new GetObjectRequest(bucketName, objectName), new File(pathName));
  
          } catch (OSSException oe) {
              // Handle OSS server-side exceptions.
              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) {
              // Handle client-side exceptions.
              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 {
              // Release resources.
              if (ossClient != null) {
                  ossClient.shutdown();
              }
          }
      }
  }

  Python

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

  # -*- coding: utf-8 -*-
  """
  OSS PrivateLink access example
  This sample shows how to access OSS and download a file to a local path over a PrivateLink connection.
  """
  
  import oss2
  from oss2.credentials import EnvironmentVariableCredentialsProvider
  
  
  def main():
      """Main function: Demonstrates how to access OSS and download a file by using PrivateLink."""
      
      # Configure credentials.
      # An Alibaba Cloud account AccessKey pair has full permissions on all API operations. Using these credentials poses a high security risk.
      # We strongly recommend that you create and use a RAM user to call API operations or perform routine O&M.
      auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
      
      # The PrivateLink endpoint domain.
      endpoint = 'https://ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com'
      
      # The bucket name.
      bucket_name = 'example-bucket'
      
      # Create a Bucket object.
      # Set is_path_style=True to enable path-style access, which is required for scenarios like PrivateLink.
      bucket = oss2.Bucket(auth, endpoint, bucket_name, is_path_style=True)
      
      # The path of the OSS object. Do not include the bucket name in the path.
      object_name = 'dest.jpg'
      
      # The local path to save the downloaded file.
      local_file_path = 'dest.jpg'
      
      # Download the object to a local file.
      # If the specified local file exists, it is overwritten. If it does not exist, it is created.
      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 (
  	// The PrivateLink endpoint domain.
  	endpoint = "https://ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com"
  
  	// The bucket name.
  	bucketName = "example-bucket"
  
  	// The path of the OSS object. Do not include the bucket name in the path.
  	objectName = "dest.jpg"
  
  	// The local path to save the downloaded file.
  	localFilePath = "dest.jpg"
  )
  
  func main() {
  	// Initialize the credentials provider.
  	// Obtain credentials from environment variables.
  	// Before you run this sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
  	provider, err := oss.NewEnvironmentVariableCredentialsProvider()
  	if err != nil {
  		fmt.Printf("Failed to initialize the credentials provider: %v\n", err)
  		os.Exit(-1)
  	}
  
  	// Create an OSS client instance.
  	// Use oss.ForcePathStyle(true) to enable path-style access, which is required for scenarios like PrivateLink.
  	client, err := oss.New(
  		endpoint,
  		"", // The AccessKey ID is obtained from the provider and can be left empty here.
  		"", // The AccessKey secret is obtained from the provider and can be left empty here.
  		oss.SetCredentialsProvider(&provider),
  		oss.ForcePathStyle(true),
  	)
  	if err != nil {
  		fmt.Printf("Failed to create the OSS client: %v\n", err)
  		os.Exit(-1)
  	}
  
  	// Obtain the bucket object.
  	bucket, err := client.Bucket(bucketName)
  	if err != nil {
  		fmt.Printf("Failed to obtain the bucket object: %v\n", err)
  		os.Exit(-1)
  	}
  
  	// Download the object to a local file.
  	// If the specified local file exists, it is overwritten. If it does not exist, it is created.
  	// If you do not specify a local path, the file is downloaded to the project's root directory.
  	err = bucket.GetObjectToFile(objectName, localFilePath)
  	if err != nil {
  		fmt.Printf("Failed to download the 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)
  {
      // The PrivateLink endpoint domain.
      std::string Endpoint = "https://ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com";
      
      // The bucket name.
      std::string BucketName = "example-bucket";
      
      // The path of the OSS object. Do not include the bucket name in the path.
      std::string ObjectName = "dest.jpg";
      
      // The local path to save the downloaded file.
      // If the specified local file exists, it is overwritten. If it does not exist, it is created.
      // If you do not specify a local path, the file is downloaded to the project's root directory.
      std::string FileNametoSave = "dest.jpg";
  
      // Initialize OSS SDK resources.
      InitializeSdk();
  
      // Configure client parameters.
      ClientConfiguration conf;
      
      // Obtain credentials from environment variables.
      // Before you run this sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
      auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
      
      // Enable path-style access, which is required for scenarios like PrivateLink.
      conf.isPathStyle = true;
      
      // Create an OSS client instance.
      OssClient client(Endpoint, credentialsProvider, conf);
  
      // Build a request to download the object.
      GetObjectRequest request(BucketName, ObjectName);
      
      // Set a response stream factory to create a local file stream.
      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
          );
      });
  
      // Execute the download operation.
      auto outcome = client.GetObject(request);
  
      // Handle the download result.
      if (outcome.isSuccess()) {
          std::cout << "File downloaded successfully. Size: " 
                    << outcome.result().Metadata().ContentLength() 
                    << " bytes" << std::endl;
          std::cout << "Saved to: " << FileNametoSave << std::endl;
      }
      else {
          // Handle errors.
          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;
          
          // Release resources and return an error code.
          ShutdownSdk();
          return -1;
      }
  
      // Release OSS SDK resources.
      ShutdownSdk();
      return 0;
  }