Inicialización (SDK de Ruby) - Object Storage Service - Centro de documentación de Alibaba Cloud

OSSClient funciona como el cliente del SDK de Object Storage Service (OSS) para Ruby y permite gestionar recursos de OSS, como buckets y objetos. Antes de usar el SDK de OSS para Ruby para iniciar una solicitud de API, debe crear una instancia de OSSClient y modificar la configuración predeterminada de OSSClient según sea necesario.

Crear una instancia de OSSClient

Puede utilizar uno de los siguientes métodos para crear una instancia de OSSClient:

Crear una instancia de OSSClient con un endpoint de OSS

A continuación se muestra un ejemplo de código para crear una instancia de OSSClient mediante un endpoint de OSS:

require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
  # The endpoint is set to China (Hangzhou) in this example. Specify the actual endpoint for your region.
  endpoint: 'https://oss-cn-hangzhou.aliyuncs.com',
  # Obtain access credentials from environment variables. Before you run this code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
  access_key_id: ENV['OSS_ACCESS_KEY_ID'],
  access_key_secret: ENV['OSS_ACCESS_KEY_SECRET']
)

Crear una instancia de OSSClient con STS

A continuación se muestra un ejemplo de código para crear una instancia de OSSClient mediante Security Token Service (STS):

require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
  # The endpoint is set to China (Hangzhou) in this example. Specify the actual endpoint for your region.
  endpoint: 'https://oss-cn-hangzhou.aliyuncs.com',
  # The temporary AccessKey ID and AccessKey secret obtained from STS.
  access_key_id: 'AccessKeyId',
  access_key_secret: 'AccessKeySecret',
  # The security token obtained from STS.
  sts_token: 'SecurityToken')

Crear una instancia de OSSClient con un nombre de dominio personalizado

A continuación se muestra un ejemplo de código para crear una instancia de OSSClient mediante un nombre de dominio personalizado.

require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
  # Use a custom domain name as the endpoint.
  endpoint: 'http://example.com',
  # Obtain access credentials from environment variables. Before you run this code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
  access_key_id: ENV['OSS_ACCESS_KEY_ID'],
  access_key_secret: ENV['OSS_ACCESS_KEY_SECRET'],
  cname: true
)

Configurar una instancia de OSSClient

Una instancia de OSSClient admite los siguientes parámetros.

Parámetro	Descripción
cname	Especifica si se puede usar CNAME como endpoint. true: Se puede usar un CNAME como endpoint. false (valor predeterminado): No se puede usar un nombre canónico (CNAME) como endpoint.
download_crc_enable	Especifica si se habilita CRC-64 al descargar objetos. true: Habilita la verificación de redundancia cíclica (CRC) durante las descargas de archivos. false (valor predeterminado): Deshabilita la verificación de redundancia cíclica durante las descargas de archivos.
upload_crc_enable	Especifica si se habilita CRC-64 al cargar objetos. true (valor predeterminado): Habilita la verificación de redundancia cíclica para las cargas de archivos. false: Deshabilita la verificación de redundancia cíclica para las cargas de archivos.
open_timeout	El periodo de tiempo de espera para establecer una conexión. Unidad: segundos. Valor predeterminado: 10.
read_timeout	El periodo de tiempo de espera para recibir una respuesta. Unidad: segundos. Valor predeterminado: 120.