Object Storage Service:Access OSS through PrivateLink

Paso 1: Crear un endpoint

1. Vaya a la página del endpoint de VPC y haga clic en Create Endpoint. Si es la primera vez que usa el servicio, siga las indicaciones en pantalla para activar el servicio PrivateLink.

2. Configure los siguientes parámetros y mantenga los valores predeterminados para las opciones que no se mencionen.

   • Region: Seleccione la región donde se encuentra el bucket de OSS de destino, por ejemplo, China (Hangzhou).

   • Endpoint Name: Introduzca un nombre descriptivo para el endpoint, como privatelink-oss.

   • Endpoint Type: Seleccione Interface Endpoint.

   • Endpoint Service: Seleccione Alibaba Cloud Service y luego elija el servicio de endpoint de OSS en la lista (la entrada cuyo nombre termina con oss).

   • VPC: Seleccione la VPC de destino donde desea crear el endpoint. Si no hay ninguna VPC disponible, haga clic en Create VPC para crear una nueva.

   • Security Groups: Seleccione el security group que se vinculará al endpoint para controlar los permisos de acceso. Si no hay ningún security group adecuado, haga clic en Create Security Group para crear uno.

   • Zone and vSwitch: Seleccione la zona de disponibilidad y el vSwitch correspondiente para el despliegue del endpoint. Si no hay ningún vSwitch disponible, haga clic en Create vSwitch para crear uno nuevo.

3. Haga clic en OK. El sistema crea el endpoint automáticamente. Después de la creación, puede consultar y copiar el Domain Name of Endpoint Service en la página de detalles del endpoint. Use este nombre de dominio para el acceso posterior a OSS.

   El nombre de dominio del servicio de endpoint tiene el formato ep-<InstanceID>.oss.cn-hangzhou.privatelink.aliyuncs.com. En la sección Domain name of endpoint service, haga clic en Copy para obtenerlo.

Paso 2: Verificar el endpoint

Ejecute una prueba de conectividad y descargue un archivo para confirmar que el endpoint de PrivateLink esté configurado correctamente.

• Comprobar la conectividad de red

  Use el comando ping para probar la conectividad de red hacia el nombre de dominio del endpoint. Así confirmará que la resolución DNS y la ruta de red son correctas.

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

• Comprobar la descarga de archivos

  Desde una instancia de ECS en la misma región, use ossutil para descargar un archivo a través de la conexión de PrivateLink. De esta manera confirmará que la transferencia de datos funciona de extremo a extremo.

  1. Install and configure ossutil 2.0.

  2. Use el nombre de dominio del endpoint (por ejemplo, ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com) para acceder a los recursos de OSS. En el siguiente ejemplo se descarga un archivo llamado dest.jpg de un bucket denominado example-bucket:

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

     Si el comando se ejecuta correctamente, se muestra la siguiente salida, lo que indica que el archivo se descargó. Puede consultar el archivo descargado en el directorio /tmp.

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

Paso 1: Crear la puerta de enlace SSL-VPN y configurar el cliente

Despliegue una puerta de enlace SSL-VPN y complete la configuración del cliente para establecer una conexión cifrada entre su dispositivo local y la VPC. Para conocer los pasos de configuración detallados, consulte Connect a PC or an Android device to a VPC by using an SSL-VPN connection.

Paso 2: Verificar el acceso a OSS mediante PrivateLink

Compruebe la conexión de PrivateLink mediante una prueba de conectividad y la descarga de un archivo. Así se asegurará de que el enlace de acceso privado funcione correctamente.

• Comprobar la conectividad

  Use el comando ping para probar la conectividad de red hacia el nombre de dominio del endpoint. Así verificará que la resolución DNS y la ruta de red sean correctas.

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

• Comprobar la descarga de archivos

  ossutil

  Use ossutil para comprobar la conexión mediante una operación con archivos.

  1. Install and configure ossutil 2.0.

  2. Use el nombre de dominio del endpoint (por ejemplo, ep-bp1i****************.oss.cn-hangzhou.privatelink.aliyuncs.com) para acceder a los recursos de OSS. En el siguiente ejemplo se descarga un archivo llamado dest.jpg de un bucket denominado example-bucket:

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

     Si el comando se ejecuta correctamente, se muestra la siguiente salida, lo que indica que el archivo se descargó. Puede consultar el archivo descargado en el directorio /tmp.

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

  SDK

  Usar un SDK se asemeja más a un entorno de producción, ya que admite la integración de lógica de negocio compleja y el manejo de excepciones. Los siguientes SDK admiten el acceso a OSS mediante PrivateLink.

  Java

  Cuando acceda a OSS mediante PrivateLink, llame a setSLDEnabled(true) para habilitar el modo de acceso por ruta. Para el acceso a través de la red pública, establézcalo en 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

  Cuando acceda a OSS mediante PrivateLink, establezca is_path_style=True para habilitar el modo de acceso por ruta.

  # -*- 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

  Cuando acceda a OSS mediante PrivateLink, use ForcePathStyle(true) para habilitar el modo de acceso por ruta.

  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++

  Cuando acceda a OSS mediante PrivateLink, establezca conf.isPathStyle = true para habilitar el modo de acceso por ruta.

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