Object Storage Service:Access OSS through PrivateLink

Etapa 1: Crie um endpoint

1. Acesse a página VPC endpoint e clique em Create Endpoint. Se esta for a primeira vez que você utiliza o service, siga as instruções na tela para ativar o service PrivateLink.

2. Configure os parâmetros abaixo e mantenha os valores padrão para as opções não listadas.

   • Region: Selecione a região onde o bucket do OSS de destino está localizado, por exemplo, China (Hangzhou).

   • Endpoint Name: Insira um nome descritivo para o endpoint, como privatelink-oss.

   • Endpoint Type: Selecione Interface Endpoint.

   • Endpoint Service: Selecione Alibaba Cloud Service e escolha o service de endpoint do OSS na lista (a entrada cujo nome termina com oss).

   • VPC: Escolha a VPC de destino onde deseja criar o endpoint. Se nenhuma VPC estiver disponível, clique em Create VPC para criar uma nova.

   • Security Groups: Selecione o grupo de segurança a ser vinculado ao endpoint para controlar as permissões de acesso. Caso não haja um grupo adequado, clique em Create Security Group para criar um.

   • Zone and vSwitch: Defina a zona de disponibilidade e o vSwitch correspondente para a implantação do endpoint. Se nenhum vSwitch estiver disponível, clique em Create vSwitch para criar um novo.

3. Clique em OK. O sistema cria o endpoint automaticamente. Após a criação, visualize e copie o Domain Name of Endpoint Service na página de detalhes do endpoint. Utilize este nome de domínio para o acesso subsequente ao OSS.

   O nome de domínio do service de endpoint segue o formato ep-<InstanceID>.oss.cn-hangzhou.privatelink.aliyuncs.com. Na seção Domain name of endpoint service, clique em Copy para obtê-lo.

Etapa 2: Verifique o endpoint

Execute um teste de conectividade e baixe um arquivo para confirmar se o endpoint do PrivateLink está configurado corretamente.

• Verifique a conectividade de rede

  Utilize o comando ping para testar a conectividade de rede com o nome de domínio do endpoint e confirmar se a resolução de DNS e o caminho de rede estão corretos.

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

• Verifique o download de arquivo

  A partir de uma instância ECS na mesma região, use o ossutil para baixar um arquivo pela conexão PrivateLink e confirme se a transferência de dados funciona de ponta a ponta.

  1. Install and configure ossutil 2.0.

  2. Use o nome de domínio do endpoint (por exemplo, ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com) para acessar os recursos do OSS. O exemplo abaixo baixa um arquivo chamado dest.jpg de um bucket denominado example-bucket:

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

     Um comando bem-sucedido exibe a saída abaixo, indicando que o arquivo foi baixado. Visualize o arquivo baixado no diretório /tmp.

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

Etapa 1: Crie o gateway SSL-VPN e configure o cliente

Implante um gateway SSL-VPN e conclua a configuração do cliente para estabelecer uma conexão criptografada entre seu dispositivo local e a VPC. Para obter etapas detalhadas de configuração, consulte Connect a PC or an Android device to a VPC by using an SSL-VPN connection.

Etapa 2: Verifique o acesso ao OSS via PrivateLink

Valide a conexão do PrivateLink executando um teste de conectividade e baixando um arquivo para garantir que o link de acesso privado esteja funcional.

• Verifique a conectividade

  Utilize o comando ping para testar a conectividade de rede com o nome de domínio do endpoint e verificar se a resolução de DNS e o caminho de rede estão corretos.

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

• Verifique o download de arquivo

  ossutil

  Use o ossutil para validar a conexão realizando uma operação de arquivo.

  1. Install and configure ossutil 2.0.

  2. Utilize o nome de domínio do endpoint (por exemplo, ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com) para acessar os recursos do OSS. O exemplo abaixo baixa um arquivo chamado dest.jpg de um bucket denominado example-bucket:

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

     Um comando bem-sucedido exibe a saída abaixo, indicando que o arquivo foi baixado. Visualize o arquivo baixado no diretório /tmp.

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

  SDK

  O uso de um sdk assemelha-se mais a um ambiente de produção, com suporte à integração de lógica de negócios complexa e tratamento de exceções. Os sdks a seguir oferecem suporte ao acesso ao OSS por meio do PrivateLink.

  Java

  Ao acessar o OSS via PrivateLink, chame setSLDEnabled(true) para ativar o modo de acesso estilo caminho. Para acesso via rede pública, defina como 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 {
          // PrivateLink endpoint domain name.
          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 running, set the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables.
          EnvironmentVariableCredentialsProvider credentialsProvider =
                  CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
          // Specify the bucket name, for example, example-bucket.
          String bucketName = "example-bucket";
          // Specify the full path of the object, excluding the bucket name.
          String objectName = "dest.jpg";
          // Specify the local file name.
          String pathName = "dest.jpg";
          // Configure client parameters.
          ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
          // Enable path-style access for PrivateLink access. Set to false for public access via the bucket's internet domain name.
          clientBuilderConfiguration.setSLDEnabled(true);
          // Explicitly declare the use of the Signature Version 4 algorithm.
          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 will be overwritten. If not, it will be created.
              // If no local path is specified, the downloaded file is saved by default 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

  Ao acessar o OSS via PrivateLink, defina is_path_style=True para ativar o modo de acesso estilo caminho.

  # -*- coding: utf-8 -*-
  """
  OSS PrivateLink access example
  Accesses OSS via PrivateLink and downloads a file locally.
  """
  import oss2
  from oss2.credentials import EnvironmentVariableCredentialsProvider
  def main():
      """Main function: Demonstrates accessing OSS and downloading a file via PrivateLink."""
      # Configure access credentials.
      # Note: An Alibaba Cloud account's AccessKey has all API permissions and carries high risk.
      # We strongly recommend creating and using a RAM user for API access or daily O&M. Log in to the RAM console to create a RAM user.
      auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
      # PrivateLink endpoint domain name.
      endpoint = 'https://ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com'
      # Bucket name.
      bucket_name = 'example-bucket'
      # Create a Bucket object.
      # is_path_style=True enables path-style access mode, which is suitable for scenarios like PrivateLink.
      bucket = oss2.Bucket(auth, endpoint, bucket_name, is_path_style=True)
      # OSS object path (full path excluding the bucket name).
      object_name = 'dest.jpg'
      # Local path to save the file.
      local_file_path = 'dest.jpg'
      # Download the object to a local file.
      # If the specified local file exists, it will be overwritten. If not, a new file will be 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

  Ao acessar o OSS via PrivateLink, use ForcePathStyle(true) para ativar o modo de acesso estilo caminho.

  package main
  import (
  	"fmt"
  	"os"
  	"github.com/aliyun/aliyun-oss-go-sdk/oss"
  )
  const (
  	// PrivateLink endpoint domain name.
  	endpoint = "https://ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com"
  	// Bucket name.
  	bucketName = "example-bucket"
  	// OSS object path (full path excluding the bucket name).
  	objectName = "dest.jpg"
  	// Local path to save the file.
  	localFilePath = "dest.jpg"
  )
  func main() {
  	// Initialize the access credentials provider.
  	// Obtain credentials from environment variables.
  	// Before running this code example, make sure 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 credentials provider: %v\n", err)
  		os.Exit(-1)
  	}
  	// Create an OSS client instance.
  	// oss.ForcePathStyle(true) enables path-style access mode, which is suitable for scenarios like PrivateLink.
  	client, err := oss.New(
  		endpoint,
  		"", // AccessKeyId is obtained through the credentials provider.
  		"", // AccessKeySecret is obtained through the credentials provider.
  		oss.SetCredentialsProvider(&provider),
  		oss.ForcePathStyle(true),
  	)
  	if err != nil {
  		fmt.Printf("Failed to create OSS client: %v\n", err)
  		os.Exit(-1)
  	}
  	// Get the Bucket object.
  	bucket, err := client.Bucket(bucketName)
  	if err != nil {
  		fmt.Printf("Failed to get Bucket object: %v\n", err)
  		os.Exit(-1)
  	}
  	// Download the object to a local file.
  	// If the specified local file exists, it will be overwritten. If not, a new file will be created.
  	// If no local path is specified, the downloaded file is saved by default to the project's root directory.
  	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++

  Ao acessar o OSS via PrivateLink, defina conf.isPathStyle = true para ativar o modo de acesso estilo caminho.

  #include <alibabacloud/oss/OssClient.h>
  #include <memory>
  #include <fstream>
  #include <iostream>
  using namespace AlibabaCloud::OSS;
  int main(void)
  {
      // PrivateLink endpoint domain name.
      std::string Endpoint = "https://ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com";
      // Bucket name.
      std::string BucketName = "example-bucket";
      // OSS object path (must not include the bucket name).
      std::string ObjectName = "dest.jpg";
      // Local path to save the file.
      // If the specified local file exists, it will be overwritten. If not, a new file will be created.
      // If no local path is specified, the downloaded file is saved by default 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 running this code example, make sure the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
      auto credentialsProvider = std::make_shared<EnvironmentVariableCredentialsProvider>();
      // Enable path-style access mode, which is suitable for scenarios like PrivateLink.
      conf.isPathStyle = true;
      // Create an OSS client instance.
      OssClient client(Endpoint, credentialsProvider, conf);
      // Build the GetObject request.
      GetObjectRequest request(BucketName, ObjectName);
      // Set the 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);
      // Process the download result.
      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 {
          // Handle errors.
          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;
          // Release resources and return an error code.
          ShutdownSdk();
          return -1;
      }
      // Release OSS SDK resources.
      ShutdownSdk();
      return 0;
  }