Warning

This document is for an old release of Galaxy. You can alternatively view this page in the latest release if it exists or view the top of the latest release's documentation.

Source code for galaxy.webapps.galaxy.api.cloud

"""
API operations on Cloud-based storages, such as Amazon Simple Storage Service (S3).
"""

import logging

from galaxy import exceptions
from galaxy.exceptions import ActionInputError
from galaxy.managers import (
    cloud,
    datasets
)
from galaxy.structured_app import StructuredApp
from galaxy.web import expose_api
from . import BaseGalaxyAPIController

log = logging.getLogger(__name__)


[docs]class CloudController(BaseGalaxyAPIController): """ RESTfull controller for interaction with Amazon S3. """
[docs] def __init__(self, app: StructuredApp, cloud_manager: cloud.CloudManager, datasets_serializer: datasets.DatasetSerializer): super().__init__(app) self.cloud_manager = cloud_manager self.datasets_serializer = datasets_serializer
[docs] @expose_api def index(self, trans, **kwargs): """ GET /api/cloud/storage Lists cloud-based buckets (e.g., S3 bucket, Azure blob) user has defined. :return: A list of cloud-based buckets user has defined. """ # TODO: This can be implemented leveraging PluggedMedia objects (part of the user-based object store project) trans.response.status = 501 return 'Not Implemented'
[docs] @expose_api def get(self, trans, payload, **kwargs): """ POST /api/cloud/storage/get gets given objects from a given cloud-based bucket to a Galaxy history. :type trans: galaxy.webapps.base.webapp.GalaxyWebTransaction :param trans: Galaxy web transaction :type payload: dict :param payload: A dictionary structure containing the following keys: * history_id: the (encoded) id of history to which the object should be received to. * bucket: the name of a bucket from which data should be fetched from (e.g., a bucket name on AWS S3). * objects: a list of the names of objects to be fetched. * authz_id: the encoded ID of CloudAuthz to be used for authorizing access to the resource provider. You may get a list of the defined authorizations via `/api/cloud/authz`. Also, you can use `/api/cloud/authz/create` to define a new authorization. * input_args [Optional; default value is an empty dict] a dictionary containing the following keys: ** `dbkey`: [Optional; default value: is `?`] Sets the genome (e.g., `hg19`) of the objects being fetched to Galaxy. ** `file_type`: [Optional; default value is `auto`] Sets the Galaxy datatype (e.g., `bam`) for the objects being fetched to Galaxy. See the following link for a complete list of Galaxy data types: https://galaxyproject.org/learn/datatypes/ ** `space_to_tab`: [Optional; default value is `False`] A boolean value ("true" or "false") that sets if spaces should be converted to tab in the objects being fetched to Galaxy. Applicable only if `to_posix_lines` is True ** `to_posix_lines`: [Optional; default value is `Yes`] A boolean value ("true" or "false"); if "Yes", converts universal line endings to POSIX line endings. Set to "False" if you upload a gzip, bz2 or zip archive containing a binary file. :param kwargs: :rtype: dictionary :return: a dictionary containing a `summary` view of the datasets copied from the given cloud-based storage. """ if not isinstance(payload, dict): raise ActionInputError('Invalid payload data type. The payload is expected to be a dictionary, ' 'but received data of type `{}`.'.format(str(type(payload)))) missing_arguments = [] encoded_history_id = payload.get("history_id", None) if encoded_history_id is None: missing_arguments.append("history_id") bucket = payload.get("bucket", None) if bucket is None: missing_arguments.append("bucket") objects = payload.get("objects", None) if objects is None: missing_arguments.append("objects") encoded_authz_id = payload.get("authz_id", None) if encoded_authz_id is None: missing_arguments.append("authz_id") if len(missing_arguments) > 0: raise ActionInputError(f"The following required arguments are missing in the payload: {missing_arguments}") try: history_id = self.decode_id(encoded_history_id) except exceptions.MalformedId as e: raise ActionInputError(f'Invalid history ID. {e}') try: authz_id = self.decode_id(encoded_authz_id) except exceptions.MalformedId as e: raise ActionInputError(f'Invalid authz ID. {e}') if not isinstance(objects, list): raise ActionInputError('The `objects` should be a list, but received an object of type {} instead.'.format( type(objects))) datasets = self.cloud_manager.get(trans=trans, history_id=history_id, bucket_name=bucket, objects=objects, authz_id=authz_id, input_args=payload.get("input_args", None)) rtv = [] for dataset in datasets: rtv.append(self.datasets_serializer.serialize_to_view(dataset, view='summary')) return rtv
[docs] @expose_api def send(self, trans, payload, **kwargs): """ POST /api/cloud/storage/send Sends given dataset(s) in a given history to a given cloud-based bucket. Each dataset is named using the label assigned to the dataset in the given history (see `HistoryDatasetAssociation.name`). If no dataset ID is given, this API sends all the datasets belonging to a given history to a given cloud-based bucket. :type trans: galaxy.webapps.base.webapp.GalaxyWebTransaction :param trans: Galaxy web transaction :type payload: dictionary :param payload: A dictionary structure containing the following keys: * history_id the (encoded) id of history from which the object should be downloaed. * bucket: the name of a bucket to which data should be sent (e.g., a bucket name on AWS S3). * authz_id: the encoded ID of CloudAuthz to be used for authorizing access to the resource provider. You may get a list of the defined authorizations via `/api/cloud/authz`. Also, you can use `/api/cloud/authz/create` to define a new authorization. * dataset_ids: [Optional; default: None] A list of encoded dataset IDs belonging to the specified history that should be sent to the given bucket. If not provided, Galaxy sends all the datasets belonging the specified history. * overwrite_existing: [Optional; default: False] A boolean value. If set to "True", and an object with same name of the dataset to be sent already exist in the bucket, Galaxy replaces the existing object with the dataset to be sent. If set to "False", Galaxy appends datetime to the dataset name to prevent overwriting an existing object. :rtype: dictionary :return: Information about the (un)successfully submitted dataset send jobs, containing the following keys: * `bucket_name`: The name of bucket to which the listed datasets are queued to be sent. * `sent_dataset_labels`: A list of JSON objects with the following key-value pair: ** `object`: The name of object is queued to be created. ** `job_id`: The id of the queued send job. * `failed_dataset_labels`: A list of JSON objects with the following key-value pair representing the datasets Galaxy failed to create (and queue) send job for: ** `object`: The name of object is queued to be created. ** `error`: A descriptive error message. """ missing_arguments = [] encoded_history_id = payload.get("history_id", None) if encoded_history_id is None: missing_arguments.append("history_id") bucket = payload.get("bucket", None) if bucket is None: missing_arguments.append("bucket") encoded_authz_id = payload.get("authz_id", None) if encoded_authz_id is None: missing_arguments.append("authz_id") if len(missing_arguments) > 0: raise ActionInputError(f"The following required arguments are missing in the payload: {missing_arguments}") try: history_id = self.decode_id(encoded_history_id) except exceptions.MalformedId as e: raise ActionInputError(f'Invalid history ID. {e}') try: authz_id = self.decode_id(encoded_authz_id) except exceptions.MalformedId as e: raise ActionInputError(f'Invalid authz ID. {e}') encoded_dataset_ids = payload.get("dataset_ids", None) if encoded_dataset_ids is None: dataset_ids = None else: dataset_ids = set() invalid_dataset_ids = [] for encoded_id in encoded_dataset_ids: try: dataset_ids.add(self.decode_id(encoded_id)) except exceptions.MalformedId: invalid_dataset_ids.append(encoded_id) if len(invalid_dataset_ids) > 0: raise ActionInputError("The following provided dataset IDs are invalid, please correct them and retry. " "{}".format(invalid_dataset_ids)) log.info(msg="Received api/send request for `{}` datasets using authnz with id `{}`, and history `{}`." "".format("all the dataset in the given history" if not dataset_ids else len(dataset_ids), authz_id, history_id)) sent, failed = self.cloud_manager.send(trans=trans, history_id=history_id, bucket_name=bucket, authz_id=authz_id, dataset_ids=dataset_ids, overwrite_existing=payload.get("overwrite_existing", False)) return {'sent_dataset_labels': sent, 'failed_dataset_labels': failed, 'bucket_name': bucket}