Server IP : 85.214.239.14 / Your IP : 3.23.101.75 Web Server : Apache/2.4.62 (Debian) System : Linux h2886529.stratoserver.net 4.9.0 #1 SMP Tue Jan 9 19:45:01 MSK 2024 x86_64 User : www-data ( 33) PHP Version : 7.4.18 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, MySQL : OFF | cURL : OFF | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : OFF Directory : /proc/3/cwd/proc/3/root/lib/python3/dist-packages/libcloud/common/ |
Upload File : |
# Licensed to the Apache Software Foundation (ASF) under one or more # contributor license agreements. See the NOTICE file distributed with # this work for additional information regarding copyright ownership. # The ASF licenses this file to You under the Apache License, Version 2.0 # (the "License"); you may not use this file except in compliance with # the License. You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. from typing import Dict, Optional, Any from libcloud.common.base import ConnectionKey, JsonResponse from libcloud.compute.base import VolumeSnapshot from libcloud.utils.py3 import httplib __all__ = [ 'API_HOST', 'VultrConnection', 'VultrException', 'VultrResponse', 'DEFAULT_API_VERSION', 'VultrResponseV2', 'VultrConnectionV2', 'VultrNetwork', 'VultrNodeSnapshot', ] # Endpoint for the Vultr API API_HOST = 'api.vultr.com' DEFAULT_API_VERSION = '2' class VultrResponse(JsonResponse): objects = None error_dict = {} # type: Dict[str, str] errors = None ERROR_CODE_MAP = { 400: "Invalid API location. Check the URL that you are using.", 403: "Invalid or missing API key. Check that your API key is present" + " and matches your assigned key.", 405: "Invalid HTTP method. Check that the method (POST|GET) matches" + " what the documentation indicates.", 412: "Request failed. Check the response body for a more detailed" + " description.", 500: "Internal server error. Try again at a later time.", 503: "Rate limit hit. API requests are limited to an average of 1/s." + " Try your request again later.", } def __init__(self, response, connection): self.errors = [] super(VultrResponse, self).__init__(response=response, connection=connection) self.objects, self.errors = self.parse_body_and_errors() if not self.success(): raise self._make_excp(self.errors[0]) def parse_body_and_errors(self): """ Returns JSON data in a python list. """ json_objects = [] errors = [] if self.status in self.ERROR_CODE_MAP: self.error_dict['ERRORCODE'] = self.status self.error_dict['ERRORMESSAGE'] = self.ERROR_CODE_MAP[self.status] errors.append(self.error_dict) js = super(VultrResponse, self).parse_body() if isinstance(js, dict): js = [js] json_objects.append(js) return (json_objects, errors) def _make_excp(self, error): """ Convert API error to a VultrException instance """ return VultrException(error['ERRORCODE'], error['ERRORMESSAGE']) def success(self): return len(self.errors) == 0 class VultrConnection(ConnectionKey): """ A connection to the Vultr API """ host = API_HOST responseCls = VultrResponse def add_default_params(self, params): """ Returns default params such as api_key which is needed to perform an action.Returns a dictionary. Example:/v1/server/upgrade_plan?api_key=self.key """ params['api_key'] = self.key return params def add_default_headers(self, headers): """ Returns default headers such as content-type. Returns a dictionary. """ headers["Content-Type"] = "application/x-www-form-urlencoded" headers["Accept"] = "text/plain" return headers def set_path(self): self.path = '/v/' return self.path class VultrResponseV2(JsonResponse): valid_response_codes = [ httplib.OK, httplib.CREATED, httplib.ACCEPTED, httplib.NO_CONTENT ] def parse_error(self): """ Parse the error body and raise the appropriate exception """ status = self.status data = self.parse_body() error_msg = data.get('error', '') raise VultrException( code=status, message=error_msg ) def success(self): """Check the response for success :return: ``bool`` indicating a successful request """ return self.status in self.valid_response_codes class VultrConnectionV2(ConnectionKey): """ A connection to the Vultr API v2 """ host = API_HOST responseCls = VultrResponseV2 def add_default_headers(self, headers): headers['Authorization'] = 'Bearer %s' % (self.key) headers['Content-Type'] = 'application/json' return headers def add_default_params(self, params): params['per_page'] = 500 return params class VultrException(Exception): """ Error originating from the Vultr API """ def __init__(self, code, message): self.code = code self.message = message self.args = (code, message) def __str__(self): return "(%u) %s" % (self.code, self.message) def __repr__(self): return "VultrException code %u '%s'" % (self.code, self.message) class VultrNetwork: """ Represents information about a Vultr private network. """ def __init__(self, id: str, cidr_block: str, location: str, extra: Optional[Dict[str, Any]] = None ) -> None: self.id = id self.cidr_block = cidr_block self.location = location self.extra = extra or {} def __repr__(self): return ('<Vultrnetwork: id=%s cidr_block=%s location=%s>' % (self.id, self.cidr_block, self.location)) class VultrNodeSnapshot(VolumeSnapshot): def __repr__(self): return ('<VultrNodeSnapshot id=%s size=%s driver=%s state=%s>' % (self.id, self.size, self.driver.name, self.state))