Usando o console

Se você incluir objetos usando o console em uma região suportada, será solicitado que você forneça uma opção para instalar o cliente Aspera Connect. Esse plug-in do navegador fornece o Aspera high-speed transfer para fazer upload de arquivos ou pastas.

Usando o Aspera Transfer SDK

1. Faça o download do Aspera Transfer SDK a partir do IBM API Hub. O SDK é uma coleção de binários (utilitários de linha de comando e um daemon para atender a solicitações de transferência), arquivos de configuração e conectores específicos do idioma...
2. Instale as dependências grpc do gerenciador de pacotes apropriado (pip, maven, gem, etc).
3. Ative o daemon e importe os arquivos do conector de linguagem de programação relevantes para o seu projeto
4. Instancie um cliente Aspera transmitindo a ele a porta local usada pelo daemon.
5. Crie um transfer_spec contendo todas as informações necessárias para a transferência:
   1. icos informações:
      1. Chave de API
      2. ID da instância de serviço
      3. Terminal de destino
      4. Nome do depósito
      5. Direção de transferência.
      6. Host remoto (você encontra isso enviando uma solicitação GET para um depósito com um parâmetro de consulta ?faspConnectionInfo )
      7. Ativos para transferência (basicamente um conjunto de caminhos de arquivo)
6. Passe a especificação de transferência e informações de configuração para uma solicitação de transferência.

A seguir há um exemplo usando Python:

import random
import string

import grpc
import json
import os.path

from urllib3.connectionpool import xrange

import transfer_pb2 as transfer_manager
import transfer_pb2_grpc as transfer_manager_grpc


def run():
    # create a connection to the transfer manager daemon
    client = transfer_manager_grpc.TransferServiceStub(
        grpc.insecure_channel('localhost:55002'))

    # create file
    file_path = generate_source_file()

    # create transfer spec
    transfer_spec = {
        "session_initiation": {
            "icos": {
                "api_key": os.environ.get('IBMCLOUD_API_KEY'),
                "bucket": os.environ.get('IBMCLOUD_BUCKET'),
                "ibm_service_instance_id": os.environ.get('IBMCLOUD_COS_INSTANCE'),
                "ibm_service_endpoint": os.environ.get('IBMCLOUD_COS_ENDPOINT')
            }
        },
        "direction": "send",
        "remote_host": "https://ats-sl-dal.aspera.io:443",
        "title": "strategic",
        "assets": {
            "destination_root": "/aspera/file",
            "paths": [
                {
                    "source": file_path
                }
            ]
        }
    }
    transfer_spec = json.dumps(transfer_spec)

    # create a transfer request
    transfer_request = transfer_manager.TransferRequest(
        transferType=transfer_manager.FILE_REGULAR,
        config=transfer_manager.TransferConfig(),
        transferSpec=transfer_spec)

    # send start transfer request to transfer manager daemon
    transfer_response = client.StartTransfer(transfer_request)
    transfer_id = transfer_response.transferId
    print("transfer started with id {0}".format(transfer_id))

    # monitor transfer status
    for transfer_info in client.MonitorTransfers(
            transfer_manager.RegistrationRequest(
                filters=[transfer_manager.RegistrationFilter(
                    transferId=[transfer_id]
                )])):
        print("transfer info {0}".format(transfer_info))

        # check transfer status in response, and exit if it's done
        status = transfer_info.status
        if status == transfer_manager.FAILED or status == transfer_manager.COMPLETED:
            print("finished {0}".format(status))
            break


def generate_source_file(name='file'):
    with open(name, 'w') as file:
        # file.write('Hello World!')
        file.write(''.join(random.choice(string.ascii_lowercase) for i in xrange(10 ** 10)))
    return os.path.abspath(name)


if __name__ == '__main__':
    run()