how to initialize ruby sdk - Object Storage Service: Central de Documentação do Alibaba Cloud

O OSSClient atua como o cliente do SDK do Object Storage Service (OSS) para Ruby e permite gerenciar recursos do OSS, como buckets e objetos. Antes de usar o SDK do OSS para Ruby e iniciar uma solicitação de API, crie uma instância do OSSClient e modifique as configurações padrão conforme necessário.

Crie uma instância do OSSClient

Use um dos seguintes métodos para criar uma instância do OSSClient:

Crie uma instância do OSSClient usando um endpoint do OSS

O código abaixo mostra um exemplo de como criar uma instância do OSSClient usando um endpoint do 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']
)

Crie uma instância do OSSClient usando o STS

O código abaixo mostra um exemplo de como criar uma instância do OSSClient usando o 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')

Crie uma instância do OSSClient usando um nome de domínio personalizado

O código abaixo mostra um exemplo de como criar uma instância do OSSClient usando um nome de domínio 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
)

Configure uma instância do OSSClient

Uma instância do OSSClient aceita os seguintes parâmetros.

Parâmetro	Descrição
cname	Especifique se o CNAME pode ser usado como endpoint. true: ative o uso do CNAME como endpoint. false (valor padrão): desative o uso do CNAME como endpoint.
download_crc_enable	Especifique se o CRC-64 deve ser ativado ao baixar objetos. true: ative a verificação de redundância cíclica (CRC) ao baixar arquivos. false (padrão): desative a verificação de redundância cíclica ao baixar arquivos.
upload_crc_enable	Especifique se o CRC-64 deve ser ativado ao enviar objetos. true (padrão): ative a verificação de redundância cíclica ao enviar arquivos. false: desative a verificação de redundância cíclica ao enviar arquivos.
open_timeout	O tempo limite para estabelecer uma conexão. Unidade: segundos. Valor padrão: 10.
read_timeout	O tempo limite para aguardar uma resposta. Unidade: segundos. Valor padrão: 120.