# -*- coding: utf-8 -*-
# Copyright 2019 Cohesity Inc.
import logging
from cohesity_management_sdk.api_helper import APIHelper
from cohesity_management_sdk.configuration import Configuration
from cohesity_management_sdk.controllers.base_controller import BaseController
from cohesity_management_sdk.http.auth.auth_manager import AuthManager
from cohesity_management_sdk.exceptions.request_error_error_exception import RequestErrorErrorException
[docs]class TenantsController(BaseController):
"""A Controller to access Endpoints in the cohesity_management_sdk API."""
def __init__(self, config=None, client=None, call_back=None):
super(TenantsController, self).__init__(client, call_back)
self.logger = logging.getLogger(__name__)
self.config = config
[docs] def get_download_tenants_proxy(self,
id=None):
"""Does a GET request to /public/tenants/proxy/image.
Returns the tenant proxy to be downloaded.
Args:
id (string, optional): Specifies the id of the tenant.
Returns:
list of int: Response from the API. Tenants Proxy Download
Response.
Raises:
APIException: When an error occurs while fetching the data from
the remote API. This exception includes the HTTP Response
code, an error message, and the HTTP body that was received in
the request.
"""
try:
self.logger.info('get_download_tenants_proxy called.')
# Prepare query URL
self.logger.info('Preparing query URL for get_download_tenants_proxy.')
_url_path = '/public/tenants/proxy/image'
_query_builder = self.config.get_base_uri()
_query_builder += _url_path
_query_parameters = {
'id': id
}
_query_builder = APIHelper.append_url_with_query_parameters(_query_builder,
_query_parameters, Configuration.array_serialization)
_query_url = APIHelper.clean_url(_query_builder)
# Prepare headers
self.logger.info('Preparing headers for get_download_tenants_proxy.')
_headers = {
'accept': 'application/json'
}
# Prepare and execute request
self.logger.info('Preparing and executing request for get_download_tenants_proxy.')
_request = self.http_client.get(_query_url, headers=_headers)
AuthManager.apply(_request, self.config)
_context = self.execute_request(_request, name = 'get_download_tenants_proxy')
# Endpoint and global error handling using HTTP status codes.
self.logger.info('Validating response for get_download_tenants_proxy.')
if _context.response.status_code == 0:
raise RequestErrorErrorException('Error', _context)
self.validate_response(_context)
# Return appropriate type
return APIHelper.json_deserialize(_context.response.raw_body)
except Exception as e:
self.logger.error(e, exc_info = True)
raise