e1cd39fa41
This patch obsoletes CLI for Legacy APIs excluding VIM feature. Implements: blueprint deprecate-legacy-apis Change-Id: I9be376a660c6f7c34c0abe7e327dec7a91d49ee2
1048 lines
39 KiB
Python
1048 lines
39 KiB
Python
# Copyright 2012 OpenStack Foundation.
|
|
# Copyright 2015 Hewlett-Packard Development Company, L.P.
|
|
# All Rights Reserved
|
|
#
|
|
# Licensed 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.
|
|
#
|
|
|
|
import logging
|
|
import re
|
|
import time
|
|
|
|
import requests
|
|
from urllib import parse as urlparse
|
|
|
|
from tackerclient import client
|
|
from tackerclient.common import exceptions
|
|
from tackerclient.common import serializer
|
|
from tackerclient.common import utils
|
|
from tackerclient.i18n import _
|
|
|
|
_logger = logging.getLogger(__name__)
|
|
DEFAULT_DESC_LENGTH = 25
|
|
DEFAULT_ERROR_REASON_LENGTH = 100
|
|
STATUS_CODE_MAP = {
|
|
400: "badRequest",
|
|
401: "unauthorized",
|
|
403: "forbidden",
|
|
404: "itemNotFound",
|
|
405: "badMethod",
|
|
409: "conflictingRequest",
|
|
413: "overLimit",
|
|
415: "badMediaType",
|
|
429: "overLimit",
|
|
501: "notImplemented",
|
|
503: "serviceUnavailable"}
|
|
|
|
|
|
def exception_handler_v10(status_code, error_content):
|
|
"""Exception handler for API v1.0 client.
|
|
|
|
This routine generates the appropriate Tacker exception according to
|
|
the contents of the response body.
|
|
|
|
:param status_code: HTTP error status code
|
|
:param error_content: deserialized body of error response
|
|
"""
|
|
etsi_error_content = error_content
|
|
error_dict = None
|
|
if isinstance(error_content, dict):
|
|
error_dict = error_content.get('TackerError')
|
|
if not error_dict:
|
|
error_content = error_content.get(STATUS_CODE_MAP.get(status_code),
|
|
'tackerFault')
|
|
# Find real error type
|
|
bad_tacker_error_flag = False
|
|
if error_dict:
|
|
# If Tacker key is found, it will definitely contain
|
|
# a 'message' and 'type' keys?
|
|
try:
|
|
error_type = error_dict['type']
|
|
error_message = error_dict['message']
|
|
if error_dict['detail']:
|
|
error_message += "\n" + error_dict['detail']
|
|
except Exception:
|
|
bad_tacker_error_flag = True
|
|
if not bad_tacker_error_flag:
|
|
# If corresponding exception is defined, use it.
|
|
client_exc = getattr(exceptions, '%sClient' % error_type, None)
|
|
# Otherwise look up per status-code client exception
|
|
if not client_exc:
|
|
client_exc = exceptions.HTTP_EXCEPTION_MAP.get(status_code)
|
|
if client_exc:
|
|
raise client_exc(message=error_message,
|
|
status_code=status_code)
|
|
else:
|
|
raise exceptions.TackerClientException(
|
|
status_code=status_code, message=error_message)
|
|
else:
|
|
raise exceptions.TackerClientException(status_code=status_code,
|
|
message=error_dict)
|
|
else:
|
|
message = None
|
|
if isinstance(error_content, dict):
|
|
message = error_content.get('message')
|
|
if message:
|
|
raise exceptions.TackerClientException(status_code=status_code,
|
|
message=message)
|
|
# ETSI error response
|
|
if isinstance(etsi_error_content, dict):
|
|
if etsi_error_content.get('status') and \
|
|
etsi_error_content.get('detail'):
|
|
message = etsi_error_content.get('detail')
|
|
raise exceptions.TackerClientException(status_code=status_code,
|
|
message=message)
|
|
|
|
# If we end up here the exception was not a tacker error
|
|
msg = "%s-%s" % (status_code, error_content)
|
|
raise exceptions.TackerClientException(status_code=status_code,
|
|
message=msg)
|
|
|
|
|
|
class APIParamsCall(object):
|
|
"""A Decorator to support formating and tenant overriding and filters."""
|
|
|
|
def __init__(self, function):
|
|
self.function = function
|
|
|
|
def __get__(self, instance, owner):
|
|
def with_params(*args, **kwargs):
|
|
_format = instance.format
|
|
if 'format' in kwargs:
|
|
instance.format = kwargs['format']
|
|
ret = self.function(instance, *args, **kwargs)
|
|
instance.format = _format
|
|
return ret
|
|
return with_params
|
|
|
|
|
|
class ClientBase(object):
|
|
"""Client for the OpenStack Tacker v1.0 API.
|
|
|
|
:param string username: Username for authentication. (optional)
|
|
:param string user_id: User ID for authentication. (optional)
|
|
:param string password: Password for authentication. (optional)
|
|
:param string token: Token for authentication. (optional)
|
|
:param string tenant_name: Tenant name. (optional)
|
|
:param string tenant_id: Tenant id. (optional)
|
|
:param string auth_strategy: 'keystone' by default, 'noauth' for no
|
|
authentication against keystone. (optional)
|
|
:param string auth_url: Keystone service endpoint for authorization.
|
|
:param string service_type: Network service type to pull from the
|
|
keystone catalog (e.g. 'network') (optional)
|
|
:param string endpoint_type: Network service endpoint type to pull from the
|
|
keystone catalog (e.g. 'publicURL',
|
|
'internalURL', or 'adminURL') (optional)
|
|
:param string region_name: Name of a region to select when choosing an
|
|
endpoint from the service catalog.
|
|
:param string endpoint_url: A user-supplied endpoint URL for the tacker
|
|
service. Lazy-authentication is possible for API
|
|
service calls if endpoint is set at
|
|
instantiation.(optional)
|
|
:param integer timeout: Allows customization of the timeout for client
|
|
http requests. (optional)
|
|
:param bool insecure: SSL certificate validation. (optional)
|
|
:param bool log_credentials: Allow for logging of passwords or not.
|
|
Defaults to False. (optional)
|
|
:param string ca_cert: SSL CA bundle file to use. (optional)
|
|
:param integer retries: How many times idempotent (GET, PUT, DELETE)
|
|
requests to Tacker server should be retried if
|
|
they fail (default: 0).
|
|
:param bool raise_errors: If True then exceptions caused by connection
|
|
failure are propagated to the caller.
|
|
(default: True)
|
|
:param session: Keystone client auth session to use. (optional)
|
|
:param auth: Keystone auth plugin to use. (optional)
|
|
|
|
"""
|
|
|
|
# API has no way to report plurals, so we have to hard code them
|
|
# This variable should be overridden by a child class.
|
|
EXTED_PLURALS = {}
|
|
|
|
def __init__(self, **kwargs):
|
|
"""Initialize a new client for the Tacker v1.0 API."""
|
|
super(ClientBase, self).__init__()
|
|
self.retries = kwargs.pop('retries', 0)
|
|
self.raise_errors = kwargs.pop('raise_errors', True)
|
|
self.httpclient = client.construct_http_client(**kwargs)
|
|
self.version = '1.0'
|
|
self.format = 'json'
|
|
self.action_prefix = "/v%s" % (self.version)
|
|
self.retry_interval = 1
|
|
self.rel = None
|
|
self.params = None
|
|
|
|
def _handle_fault_response(self, status_code, response_body):
|
|
# Create exception with HTTP status code and message
|
|
_logger.debug("Error message: %s", response_body)
|
|
# Add deserialized error message to exception arguments
|
|
try:
|
|
des_error_body = self.deserialize(response_body, status_code)
|
|
except Exception:
|
|
# If unable to deserialized body it is probably not a
|
|
# Tacker error
|
|
des_error_body = {'message': response_body}
|
|
# Raise the appropriate exception
|
|
exception_handler_v10(status_code, des_error_body)
|
|
|
|
def build_action(self, action):
|
|
action += ".%s" % self.format
|
|
action = self.action_prefix + action
|
|
return action
|
|
|
|
def _build_params_query(self, params=None):
|
|
flag_params = []
|
|
keyval_params = {}
|
|
for key, value in params.items():
|
|
if value is None:
|
|
flag_params.append(key)
|
|
else:
|
|
keyval_params[key] = value
|
|
|
|
flags_encoded = utils.safe_encode_list(flag_params) \
|
|
if flag_params else ""
|
|
keyval_encoded = utils.safe_encode_dict(keyval_params) \
|
|
if keyval_params else ""
|
|
|
|
query = ""
|
|
for flag in flags_encoded:
|
|
query = query + urlparse.quote_plus(flag) + '&'
|
|
query = query + urlparse.urlencode(keyval_encoded, doseq=1)
|
|
return query.strip('&')
|
|
|
|
def do_request(self, method, action, body=None, headers=None, params=None):
|
|
action = self.build_action(action)
|
|
# Add format and tenant_id
|
|
if type(params) is dict and params:
|
|
query = self._build_params_query(params)
|
|
action += '?' + query
|
|
|
|
if body or body == {}:
|
|
body = self.serialize(body)
|
|
|
|
if headers is None:
|
|
# self.httpclient.do_request is not accept 'headers=None'.
|
|
headers = {}
|
|
|
|
resp, replybody = self.httpclient.do_request(
|
|
action, method, body=body, headers=headers,
|
|
content_type=self.content_type())
|
|
|
|
if 'application/zip' == resp.headers.get('Content-Type'):
|
|
self.format = 'zip'
|
|
elif 'text/plain' == resp.headers.get('Content-Type'):
|
|
self.format = 'text'
|
|
elif 'artifacts' in action:
|
|
self.format = 'any'
|
|
else:
|
|
self.format = 'json'
|
|
|
|
url = None
|
|
rel = None
|
|
|
|
link = resp.headers.get('Link', None)
|
|
if link is not None:
|
|
url = re.findall('<(.*)>', link)[0]
|
|
rel = re.findall('rel="(.*)"', link)[0]
|
|
|
|
if rel == 'next':
|
|
self.rel = 'next'
|
|
query_str = urlparse.urlparse(url).query
|
|
self.params = urlparse.parse_qs(query_str)
|
|
|
|
status_code = resp.status_code
|
|
if status_code in (requests.codes.ok,
|
|
requests.codes.created,
|
|
requests.codes.accepted,
|
|
requests.codes.no_content):
|
|
return self.deserialize(replybody, status_code)
|
|
else:
|
|
if not replybody:
|
|
replybody = resp.reason
|
|
self._handle_fault_response(status_code, replybody)
|
|
|
|
def get_auth_info(self):
|
|
return self.httpclient.get_auth_info()
|
|
|
|
def serialize(self, data):
|
|
"""Serializes a dictionary JSON.
|
|
|
|
A dictionary with a single key can be passed and it can contain any
|
|
structure.
|
|
"""
|
|
if data is None:
|
|
return None
|
|
elif self.format in ('zip', 'text'):
|
|
return data
|
|
elif type(data) is dict:
|
|
return serializer.Serializer().serialize(data, 'application/json')
|
|
else:
|
|
raise Exception(_("Unable to serialize object of type = '%s'") %
|
|
type(data))
|
|
|
|
def deserialize(self, data, status_code):
|
|
"""Deserializes an JSON string into a dictionary."""
|
|
if status_code in (204, 202) or self.format in ('zip', 'text', 'any'):
|
|
return data
|
|
return serializer.Serializer().deserialize(
|
|
data, 'application/json')['body']
|
|
|
|
def content_type(self, _format=None):
|
|
"""Returns the mime-type for either 'json, 'text', or 'zip'.
|
|
|
|
Defaults to the currently set format.
|
|
"""
|
|
_format = _format or self.format
|
|
if self.format == 'text':
|
|
return "text/plain"
|
|
elif self.format == 'both':
|
|
return "text/plain,application/zip"
|
|
else:
|
|
return "application/%s" % (_format)
|
|
|
|
def retry_request(self, method, action, body=None,
|
|
headers=None, params=None):
|
|
"""Call do_request with the default retry configuration.
|
|
|
|
Only idempotent requests should retry failed connection attempts.
|
|
:raises ConnectionFailed: if the maximum # of retries is exceeded
|
|
"""
|
|
max_attempts = self.retries + 1
|
|
for i in range(max_attempts):
|
|
try:
|
|
return self.do_request(method, action, body=body,
|
|
headers=headers, params=params)
|
|
except exceptions.ConnectionFailed:
|
|
# Exception has already been logged by do_request()
|
|
if i < self.retries:
|
|
_logger.debug('Retrying connection to Tacker service')
|
|
time.sleep(self.retry_interval)
|
|
elif self.raise_errors:
|
|
raise
|
|
|
|
if self.retries:
|
|
msg = (_("Failed to connect to Tacker server after %d attempts")
|
|
% max_attempts)
|
|
else:
|
|
msg = _("Failed to connect Tacker server")
|
|
|
|
raise exceptions.ConnectionFailed(reason=msg)
|
|
|
|
def delete(self, action, body=None, headers=None, params=None):
|
|
return self.retry_request("DELETE", action, body=body,
|
|
headers=headers, params=params)
|
|
|
|
def get(self, action, body=None, headers=None, params=None):
|
|
return self.retry_request("GET", action, body=body,
|
|
headers=headers, params=params)
|
|
|
|
def post(self, action, body=None, headers=None, params=None):
|
|
# Do not retry POST requests to avoid the orphan objects problem.
|
|
return self.do_request("POST", action, body=body,
|
|
headers=headers, params=params)
|
|
|
|
def put(self, action, body=None, headers=None, params=None):
|
|
return self.retry_request("PUT", action, body=body,
|
|
headers=headers, params=params)
|
|
|
|
def patch(self, action, body=None, headers=None, params=None):
|
|
return self.retry_request("PATCH", action, body=body,
|
|
headers=headers, params=params)
|
|
|
|
def list(self, collection, path, retrieve_all=True, headers=None,
|
|
**params):
|
|
if retrieve_all:
|
|
res = []
|
|
for r in self._pagination(collection, path, headers, **params):
|
|
if type(r) is list:
|
|
res.extend(r)
|
|
else:
|
|
res.extend(r[collection])
|
|
return {collection: res} if collection else res
|
|
else:
|
|
return self._pagination(collection, path, headers, **params)
|
|
|
|
def _pagination(self, collection, path, headers, **params):
|
|
if params.get('page_reverse', False):
|
|
linkrel = 'previous'
|
|
else:
|
|
linkrel = 'next'
|
|
next = True
|
|
while next:
|
|
self.rel = None
|
|
res = self.get(path, headers=headers, params=params)
|
|
yield res
|
|
next = False
|
|
try:
|
|
if type(res) is list:
|
|
if self.rel == 'next':
|
|
params = self.params
|
|
next = True
|
|
|
|
else:
|
|
for link in res['%s_links' % collection]:
|
|
if link['rel'] == linkrel:
|
|
query_str = urlparse.urlparse(link['href']).query
|
|
params = urlparse.parse_qs(query_str)
|
|
next = True
|
|
break
|
|
except KeyError:
|
|
break
|
|
|
|
|
|
class LegacyClient(ClientBase):
|
|
|
|
vims_path = '/vims'
|
|
vim_path = '/vims/%s'
|
|
|
|
# API has no way to report plurals, so we have to hard code them
|
|
# EXTED_PLURALS = {}
|
|
|
|
@APIParamsCall
|
|
def show_vim(self, vim, **_params):
|
|
return self.get(self.vim_path % vim, params=_params)
|
|
|
|
_VIM = "vim"
|
|
|
|
@APIParamsCall
|
|
def create_vim(self, body):
|
|
return self.post(self.vims_path, body=body)
|
|
|
|
@APIParamsCall
|
|
def delete_vim(self, vim):
|
|
return self.delete(self.vim_path % vim)
|
|
|
|
@APIParamsCall
|
|
def update_vim(self, vim, body):
|
|
return self.put(self.vim_path % vim, body=body)
|
|
|
|
@APIParamsCall
|
|
def list_vims(self, retrieve_all=True, **_params):
|
|
return self.list('vims', self.vims_path, retrieve_all, **_params)
|
|
|
|
|
|
class VnfPackageClient(ClientBase):
|
|
"""Client for vnfpackage APIs.
|
|
|
|
Purpose of this class is to create required request url for vnfpackage
|
|
APIs.
|
|
"""
|
|
|
|
vnfpackages_path = '/vnfpkgm/v1/vnf_packages'
|
|
vnfpackage_path = '/vnfpkgm/v1/vnf_packages/%s'
|
|
vnfpackage_vnfd_path = '/vnfpkgm/v1/vnf_packages/%s/vnfd'
|
|
vnfpackage_download_path = '/vnfpkgm/v1/vnf_packages/%s/package_content'
|
|
vnfpakcage_artifact_path = '/vnfpkgm/v1/vnf_packages/%(id)s/artifacts/' \
|
|
'%(artifact_path)s'
|
|
|
|
def build_action(self, action):
|
|
return action
|
|
|
|
@APIParamsCall
|
|
def create_vnf_package(self, body):
|
|
return self.post(self.vnfpackages_path, body=body)
|
|
|
|
@APIParamsCall
|
|
def list_vnf_packages(self, retrieve_all=True, **_params):
|
|
vnf_packages = self.list("vnf_packages", self.vnfpackages_path,
|
|
retrieve_all, **_params)
|
|
return vnf_packages
|
|
|
|
@APIParamsCall
|
|
def show_vnf_package(self, vnf_package, **_params):
|
|
return self.get(self.vnfpackage_path % vnf_package, params=_params)
|
|
|
|
@APIParamsCall
|
|
def delete_vnf_package(self, vnf_package):
|
|
return self.delete(self.vnfpackage_path % vnf_package)
|
|
|
|
@APIParamsCall
|
|
def upload_vnf_package(self, vnf_package, file_data=None, **attrs):
|
|
if attrs.get('url'):
|
|
json = {'addressInformation': attrs.get('url')}
|
|
for key in ['userName', 'password']:
|
|
if attrs.get(key):
|
|
json.update({key: attrs.get(key)})
|
|
return self.post(
|
|
'{base_path}/{id}/package_content/upload_from_uri'.format(
|
|
id=vnf_package, base_path=self.vnfpackages_path),
|
|
body=json)
|
|
else:
|
|
self.format = 'zip'
|
|
return self.put('{base_path}/{id}/package_content'.format(
|
|
id=vnf_package,
|
|
base_path=self.vnfpackages_path),
|
|
body=file_data)
|
|
|
|
@APIParamsCall
|
|
def download_vnf_package(self, vnf_package):
|
|
self.format = 'zip'
|
|
return self.get(self.vnfpackage_download_path % vnf_package)
|
|
|
|
@APIParamsCall
|
|
def download_vnfd_from_vnf_package(self, vnf_package, accept):
|
|
"""Read VNFD of an on-boarded VNF Package.
|
|
|
|
:param vnf_package: The value can be either the ID of a vnf package
|
|
or a :class:`~openstack.nfv_orchestration.v1.
|
|
vnf_package` instance.
|
|
:param accept: Valid values are 'text/plain', 'application/zip' and
|
|
'both'. According to these values 'Accept' header will
|
|
be set as 'text/plain', 'application/zip',
|
|
'text/plain,application/zip' respectively.
|
|
|
|
:returns: If the VNFD is implemented in the form of multiple files,
|
|
a ZIP file embedding these files shall be returned.
|
|
If the VNFD is implemented as a single file, either that
|
|
file or a ZIP file embedding that file shall be returned.
|
|
"""
|
|
if accept == 'text/plain':
|
|
self.format = 'text'
|
|
elif accept == 'application/zip':
|
|
self.format = 'zip'
|
|
else:
|
|
self.format = 'both'
|
|
return self.get(self.vnfpackage_vnfd_path % vnf_package)
|
|
|
|
@APIParamsCall
|
|
def download_artifact_from_vnf_package(self, vnf_package, artifact_path):
|
|
return self.get(self.vnfpakcage_artifact_path %
|
|
{'id': vnf_package, 'artifact_path': artifact_path})
|
|
|
|
@APIParamsCall
|
|
def update_vnf_package(self, vnf_package, body):
|
|
return self.patch(self.vnfpackage_path % vnf_package, body=body)
|
|
|
|
|
|
class VnfLCMClient(ClientBase):
|
|
"""Client for vnflcm APIs.
|
|
|
|
Purpose of this class is to create required request url for vnflcm
|
|
APIs.
|
|
"""
|
|
|
|
def __init__(self, api_version, **kwargs):
|
|
super(VnfLCMClient, self).__init__(**kwargs)
|
|
self.headers = {'Version': '1.3.0'}
|
|
sol_api_version = 'v1'
|
|
if api_version == '2':
|
|
self.headers = {'Version': '2.0.0'}
|
|
sol_api_version = 'v2'
|
|
|
|
self.vnf_instances_path = (
|
|
'/vnflcm/{}/vnf_instances'.format(sol_api_version))
|
|
self.vnf_instance_path = (
|
|
'/vnflcm/{}/vnf_instances/%s'.format(sol_api_version))
|
|
self.vnf_lcm_op_occurrences_path = (
|
|
'/vnflcm/{}/vnf_lcm_op_occs'.format(sol_api_version))
|
|
self.vnf_lcm_op_occs_path = (
|
|
'/vnflcm/{}/vnf_lcm_op_occs/%s'.format(sol_api_version))
|
|
self.lccn_subscriptions_path = (
|
|
'/vnflcm/{}/subscriptions'.format(sol_api_version))
|
|
self.lccn_subscription_path = (
|
|
'/vnflcm/{}/subscriptions/%s'.format(sol_api_version))
|
|
|
|
def build_action(self, action):
|
|
return action
|
|
|
|
@APIParamsCall
|
|
def create_vnf_instance(self, body):
|
|
return self.post(self.vnf_instances_path, body=body,
|
|
headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def show_vnf_instance(self, vnf_id, **_params):
|
|
return self.get(self.vnf_instance_path % vnf_id,
|
|
headers=self.headers, params=_params)
|
|
|
|
@APIParamsCall
|
|
def list_vnf_instances(self, retrieve_all=True, **_params):
|
|
vnf_instances = self.list(None, self.vnf_instances_path,
|
|
retrieve_all, headers=self.headers,
|
|
**_params)
|
|
return vnf_instances
|
|
|
|
@APIParamsCall
|
|
def instantiate_vnf_instance(self, vnf_id, body):
|
|
return self.post((self.vnf_instance_path + "/instantiate") % vnf_id,
|
|
body=body, headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def heal_vnf_instance(self, vnf_id, body):
|
|
return self.post((self.vnf_instance_path + "/heal") % vnf_id,
|
|
body=body, headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def terminate_vnf_instance(self, vnf_id, body):
|
|
return self.post((self.vnf_instance_path + "/terminate") % vnf_id,
|
|
body=body, headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def delete_vnf_instance(self, vnf_id):
|
|
return self.delete(self.vnf_instance_path % vnf_id,
|
|
headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def update_vnf_instance(self, vnf_id, body):
|
|
return self.patch(self.vnf_instance_path % vnf_id, body=body,
|
|
headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def scale_vnf_instance(self, vnf_id, body):
|
|
return self.post((self.vnf_instance_path + "/scale") % vnf_id,
|
|
body=body, headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def rollback_vnf_instance(self, occ_id):
|
|
return self.post((self.vnf_lcm_op_occs_path + "/rollback") % occ_id,
|
|
headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def cancel_vnf_instance(self, occ_id, body):
|
|
return self.post((self.vnf_lcm_op_occs_path + "/cancel") % occ_id,
|
|
body=body)
|
|
|
|
@APIParamsCall
|
|
def fail_vnf_instance(self, occ_id):
|
|
return self.post((self.vnf_lcm_op_occs_path + "/fail") % occ_id,
|
|
headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def change_ext_conn_vnf_instance(self, vnf_id, body):
|
|
return self.post((self.vnf_instance_path + "/change_ext_conn") %
|
|
vnf_id, body=body, headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def change_vnfpkg_vnf_instance(self, vnf_id, body):
|
|
# NOTE: it is only supported by V2-API.
|
|
if self.vnf_instance_path.split('/')[2] == 'v2':
|
|
return self.post((self.vnf_instance_path + "/change_vnfpkg") %
|
|
vnf_id, body=body, headers=self.headers)
|
|
else:
|
|
raise exceptions.UnsupportedCommandVersion(version='1')
|
|
|
|
@APIParamsCall
|
|
def retry_vnf_instance(self, occ_id):
|
|
return self.post((self.vnf_lcm_op_occs_path + "/retry") % occ_id,
|
|
headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def list_vnf_lcm_op_occs(self, retrieve_all=True, **_params):
|
|
vnf_lcm_op_occs = self.list(None, self.vnf_lcm_op_occurrences_path,
|
|
retrieve_all, headers=self.headers,
|
|
**_params)
|
|
return vnf_lcm_op_occs
|
|
|
|
@APIParamsCall
|
|
def show_vnf_lcm_op_occs(self, occ_id):
|
|
return self.get(self.vnf_lcm_op_occs_path % occ_id,
|
|
headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def create_lccn_subscription(self, body):
|
|
return self.post(self.lccn_subscriptions_path, body=body,
|
|
headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def delete_lccn_subscription(self, subsc_id):
|
|
return self.delete(self.lccn_subscription_path % subsc_id,
|
|
headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def list_lccn_subscriptions(self, retrieve_all=True, **_params):
|
|
subscriptions = self.list(None, self.lccn_subscriptions_path,
|
|
retrieve_all, headers=self.headers,
|
|
**_params)
|
|
return subscriptions
|
|
|
|
@APIParamsCall
|
|
def show_lccn_subscription(self, subsc_id):
|
|
return self.get(self.lccn_subscription_path % subsc_id,
|
|
headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def show_vnf_lcm_versions(self, major_version):
|
|
if major_version is None:
|
|
path = "/vnflcm/api_versions"
|
|
else:
|
|
path = "/vnflcm/{}/api_versions".format(major_version)
|
|
# NOTE: This may be called with any combination of
|
|
# --os-tacker-api-verson:[1, 2] and major_version:[None, 1, 2].
|
|
# Specifying "headers={'Version': '2.0.0'}" is most simple to
|
|
# make all cases OK.
|
|
return self.get(path, headers={'Version': '2.0.0'})
|
|
|
|
|
|
class VnfFMClient(ClientBase):
|
|
headers = {'Version': '1.3.0'}
|
|
vnf_fm_alarms_path = '/vnffm/v1/alarms'
|
|
vnf_fm_alarm_path = '/vnffm/v1/alarms/%s'
|
|
vnf_fm_subs_path = '/vnffm/v1/subscriptions'
|
|
vnf_fm_sub_path = '/vnffm/v1/subscriptions/%s'
|
|
|
|
def build_action(self, action):
|
|
return action
|
|
|
|
@APIParamsCall
|
|
def list_vnf_fm_alarms(self, retrieve_all=True, **_params):
|
|
vnf_fm_alarms = self.list(
|
|
"vnf_fm_alarms", self.vnf_fm_alarms_path, retrieve_all,
|
|
headers=self.headers, **_params)
|
|
return vnf_fm_alarms
|
|
|
|
@APIParamsCall
|
|
def show_vnf_fm_alarm(self, vnf_fm_alarm_id):
|
|
return self.get(
|
|
self.vnf_fm_alarm_path % vnf_fm_alarm_id, headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def update_vnf_fm_alarm(self, vnf_fm_alarm_id, body):
|
|
return self.patch(
|
|
self.vnf_fm_alarm_path % vnf_fm_alarm_id, body=body,
|
|
headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def create_vnf_fm_sub(self, body):
|
|
return self.post(
|
|
self.vnf_fm_subs_path, body=body, headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def list_vnf_fm_subs(self, retrieve_all=True, **_params):
|
|
vnf_fm_subs = self.list("vnf_fm_subs", self.vnf_fm_subs_path,
|
|
retrieve_all, headers=self.headers, **_params)
|
|
return vnf_fm_subs
|
|
|
|
@APIParamsCall
|
|
def show_vnf_fm_sub(self, vnf_fm_sub_id):
|
|
return self.get(
|
|
self.vnf_fm_sub_path % vnf_fm_sub_id, headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def delete_vnf_fm_sub(self, vnf_fm_sub_id):
|
|
return self.delete(
|
|
self.vnf_fm_sub_path % vnf_fm_sub_id, headers=self.headers)
|
|
|
|
|
|
class VnfPMClient(ClientBase):
|
|
headers = {'Version': '2.1.0'}
|
|
vnf_pm_jobs_path = '/vnfpm/v2/pm_jobs'
|
|
vnf_pm_job_path = '/vnfpm/v2/pm_jobs/%s'
|
|
vnf_pm_reports_path = '/vnfpm/v2/pm_jobs/%(job_id)s/reports/%(report_id)s'
|
|
vnf_pm_thresholds_path = '/vnfpm/v2/thresholds'
|
|
vnf_pm_threshold_path = '/vnfpm/v2/thresholds/%s'
|
|
|
|
def build_action(self, action):
|
|
return action
|
|
|
|
@APIParamsCall
|
|
def create_vnf_pm_job(self, body):
|
|
return self.post(
|
|
self.vnf_pm_jobs_path, body=body, headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def list_vnf_pm_jobs(self, retrieve_all=True, **_params):
|
|
vnf_pm_jobs = self.list(
|
|
"vnf_pm_jobs", self.vnf_pm_jobs_path, retrieve_all,
|
|
headers=self.headers, **_params)
|
|
return vnf_pm_jobs
|
|
|
|
@APIParamsCall
|
|
def show_vnf_pm_job(self, vnf_pm_job_id):
|
|
return self.get(
|
|
self.vnf_pm_job_path % vnf_pm_job_id, headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def update_vnf_pm_job(self, vnf_pm_job_id, body):
|
|
return self.patch(
|
|
self.vnf_pm_job_path % vnf_pm_job_id, body=body,
|
|
headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def delete_vnf_pm_job(self, vnf_pm_job_id):
|
|
return self.delete(
|
|
self.vnf_pm_job_path % vnf_pm_job_id, headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def show_vnf_pm_report(self, vnf_pm_job_id, vnf_pm_report_id):
|
|
return self.get(
|
|
self.vnf_pm_reports_path % {
|
|
'job_id': vnf_pm_job_id, 'report_id': vnf_pm_report_id
|
|
}, headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def create_vnf_pm_threshold(self, body):
|
|
return self.post(
|
|
self.vnf_pm_thresholds_path, body=body, headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def list_vnf_pm_thresholds(self, retrieve_all=True, **_params):
|
|
return self.list(
|
|
"vnf_pm_thresholds", self.vnf_pm_thresholds_path, retrieve_all,
|
|
headers=self.headers, **_params)
|
|
|
|
@APIParamsCall
|
|
def show_vnf_pm_threshold(self, vnf_pm_threshold_id):
|
|
return self.get(
|
|
self.vnf_pm_threshold_path % vnf_pm_threshold_id,
|
|
headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def update_vnf_pm_threshold(self, vnf_pm_threshold_id, body):
|
|
return self.patch(
|
|
self.vnf_pm_threshold_path % vnf_pm_threshold_id, body=body,
|
|
headers=self.headers)
|
|
|
|
@APIParamsCall
|
|
def delete_vnf_pm_threshold(self, vnf_pm_threshold_id):
|
|
return self.delete(
|
|
self.vnf_pm_threshold_path % vnf_pm_threshold_id,
|
|
headers=self.headers)
|
|
|
|
|
|
class Client(object):
|
|
"""Unified interface to interact with multiple applications of tacker service.
|
|
|
|
This class is a single entry point to interact with legacy tacker apis and
|
|
vnf packages apis.
|
|
|
|
Example::
|
|
|
|
from tackerclient.v1_0 import client
|
|
tacker = client.Client(username=USER,
|
|
password=PASS,
|
|
tenant_name=TENANT_NAME,
|
|
auth_url=KEYSTONE_URL)
|
|
|
|
vnf_package = tacker.create_vnf_package(...)
|
|
nsd = tacker.create_nsd(...)
|
|
|
|
"""
|
|
|
|
def __init__(self, **kwargs):
|
|
api_version = kwargs.pop('api_version', '1')
|
|
self.vnf_lcm_client = VnfLCMClient(api_version, **kwargs)
|
|
self.vnf_fm_client = VnfFMClient(**kwargs)
|
|
self.vnf_pm_client = VnfPMClient(**kwargs)
|
|
self.vnf_package_client = VnfPackageClient(**kwargs)
|
|
self.legacy_client = LegacyClient(**kwargs)
|
|
|
|
# LegacyClient methods
|
|
|
|
def delete(self, action, body=None, headers=None, params=None):
|
|
return self.legacy_client.delete(action, body=body, headers=headers,
|
|
params=params)
|
|
|
|
def get(self, action, body=None, headers=None, params=None):
|
|
return self.legacy_client.get(action, body=body, headers=headers,
|
|
params=params)
|
|
|
|
def post(self, action, body=None, headers=None, params=None):
|
|
return self.legacy_client.post(action, body=body, headers=headers,
|
|
params=params)
|
|
|
|
def put(self, action, body=None, headers=None, params=None):
|
|
return self.legacy_client.put(action, body=body, headers=headers,
|
|
params=params)
|
|
|
|
def list(self, collection, path, retrieve_all=True, **params):
|
|
return self.legacy_client.list(collection, path,
|
|
retrieve_all=retrieve_all, **params)
|
|
|
|
def show_vim(self, vim, **_params):
|
|
return self.legacy_client.show_vim(vim, **_params)
|
|
|
|
def create_vim(self, body):
|
|
return self.legacy_client.create_vim(body)
|
|
|
|
def delete_vim(self, vim):
|
|
return self.legacy_client.delete_vim(vim)
|
|
|
|
def update_vim(self, vim, body):
|
|
return self.legacy_client.update_vim(vim, body)
|
|
|
|
def list_vims(self, retrieve_all=True, **_params):
|
|
return self.legacy_client.list_vims(retrieve_all=retrieve_all,
|
|
**_params)
|
|
|
|
# VnfPackageClient methods
|
|
|
|
def create_vnf_package(self, body):
|
|
return self.vnf_package_client.create_vnf_package(body)
|
|
|
|
def list_vnf_packages(self, retrieve_all=True, query_parameter=None,
|
|
**_params):
|
|
return self.vnf_package_client.list_vnf_packages(
|
|
retrieve_all=retrieve_all, **_params)
|
|
|
|
def show_vnf_package(self, vnf_package, **_params):
|
|
return self.vnf_package_client.show_vnf_package(vnf_package, **_params)
|
|
|
|
def upload_vnf_package(self, vnf_package, file_data=None, **_params):
|
|
return self.vnf_package_client.upload_vnf_package(
|
|
vnf_package, file_data=file_data, **_params)
|
|
|
|
def delete_vnf_package(self, vnf_package):
|
|
return self.vnf_package_client.delete_vnf_package(vnf_package)
|
|
|
|
# VnfLCMClient methods.
|
|
|
|
def create_vnf_instance(self, body):
|
|
return self.vnf_lcm_client.create_vnf_instance(body)
|
|
|
|
def show_vnf_instance(self, vnf_instance, **_params):
|
|
return self.vnf_lcm_client.show_vnf_instance(vnf_instance,
|
|
**_params)
|
|
|
|
def list_vnf_instances(self, retrieve_all=True, **_params):
|
|
return self.vnf_lcm_client.list_vnf_instances(
|
|
retrieve_all=retrieve_all, **_params)
|
|
|
|
def instantiate_vnf_instance(self, vnf_id, body):
|
|
return self.vnf_lcm_client.instantiate_vnf_instance(vnf_id, body)
|
|
|
|
def heal_vnf_instance(self, vnf_id, body):
|
|
return self.vnf_lcm_client.heal_vnf_instance(vnf_id, body)
|
|
|
|
def terminate_vnf_instance(self, vnf_id, body):
|
|
return self.vnf_lcm_client.terminate_vnf_instance(vnf_id, body)
|
|
|
|
def scale_vnf_instance(self, vnf_id, body):
|
|
return self.vnf_lcm_client.scale_vnf_instance(vnf_id, body)
|
|
|
|
def change_ext_conn_vnf_instance(self, vnf_id, body):
|
|
return self.vnf_lcm_client.change_ext_conn_vnf_instance(vnf_id, body)
|
|
|
|
def change_vnfpkg_vnf_instance(self, vnf_id, body):
|
|
return self.vnf_lcm_client.change_vnfpkg_vnf_instance(vnf_id, body)
|
|
|
|
def delete_vnf_instance(self, vnf_id):
|
|
return self.vnf_lcm_client.delete_vnf_instance(vnf_id)
|
|
|
|
def update_vnf_instance(self, vnf_id, body):
|
|
return self.vnf_lcm_client.update_vnf_instance(vnf_id, body)
|
|
|
|
def rollback_vnf_instance(self, occ_id):
|
|
return self.vnf_lcm_client.rollback_vnf_instance(occ_id)
|
|
|
|
def cancel_vnf_instance(self, occ_id, body):
|
|
return self.vnf_lcm_client.cancel_vnf_instance(occ_id, body)
|
|
|
|
def fail_vnf_instance(self, occ_id):
|
|
return self.vnf_lcm_client.fail_vnf_instance(occ_id)
|
|
|
|
def retry_vnf_instance(self, occ_id):
|
|
return self.vnf_lcm_client.retry_vnf_instance(occ_id)
|
|
|
|
def update_vnf_package(self, vnf_package, body):
|
|
return self.vnf_package_client.update_vnf_package(vnf_package, body)
|
|
|
|
def download_vnfd_from_vnf_package(self, vnf_package, accept):
|
|
return self.vnf_package_client.download_vnfd_from_vnf_package(
|
|
vnf_package, accept)
|
|
|
|
def download_artifact_from_vnf_package(self, vnf_package, artifact_path):
|
|
return self.vnf_package_client.download_artifact_from_vnf_package(
|
|
vnf_package, artifact_path
|
|
)
|
|
|
|
def download_vnf_package(self, vnf_package):
|
|
return self.vnf_package_client.download_vnf_package(vnf_package)
|
|
|
|
def list_vnf_lcm_op_occs(self, retrieve_all=True, **_params):
|
|
return self.vnf_lcm_client.list_vnf_lcm_op_occs(
|
|
retrieve_all=retrieve_all, **_params)
|
|
|
|
def show_vnf_lcm_op_occs(self, occ_id):
|
|
return self.vnf_lcm_client.show_vnf_lcm_op_occs(occ_id)
|
|
|
|
def create_lccn_subscription(self, body):
|
|
return self.vnf_lcm_client.create_lccn_subscription(body)
|
|
|
|
def delete_lccn_subscription(self, subsc_id):
|
|
return self.vnf_lcm_client.delete_lccn_subscription(subsc_id)
|
|
|
|
def list_lccn_subscriptions(self, retrieve_all=True, **_params):
|
|
return self.vnf_lcm_client.list_lccn_subscriptions(
|
|
retrieve_all=retrieve_all, **_params)
|
|
|
|
def show_lccn_subscription(self, subsc_id):
|
|
return self.vnf_lcm_client.show_lccn_subscription(subsc_id)
|
|
|
|
def show_vnf_lcm_versions(self, major_version):
|
|
return self.vnf_lcm_client.show_vnf_lcm_versions(major_version)
|
|
|
|
# VnfFMClient methods.
|
|
|
|
def list_vnf_fm_alarms(self, retrieve_all=True, **_params):
|
|
return self.vnf_fm_client.list_vnf_fm_alarms(
|
|
retrieve_all=retrieve_all, **_params)
|
|
|
|
def show_vnf_fm_alarm(self, vnf_fm_alarm_id):
|
|
return self.vnf_fm_client.show_vnf_fm_alarm(vnf_fm_alarm_id)
|
|
|
|
def update_vnf_fm_alarm(self, vnf_fm_alarm_id, body):
|
|
return self.vnf_fm_client.update_vnf_fm_alarm(vnf_fm_alarm_id, body)
|
|
|
|
def create_vnf_fm_sub(self, body):
|
|
return self.vnf_fm_client.create_vnf_fm_sub(body)
|
|
|
|
def list_vnf_fm_subs(self, retrieve_all=True, **_params):
|
|
return self.vnf_fm_client.list_vnf_fm_subs(
|
|
retrieve_all=retrieve_all, **_params)
|
|
|
|
def show_vnf_fm_sub(self, vnf_fm_sub_id):
|
|
return self.vnf_fm_client.show_vnf_fm_sub(vnf_fm_sub_id)
|
|
|
|
def delete_vnf_fm_sub(self, vnf_fm_sub_id):
|
|
return self.vnf_fm_client.delete_vnf_fm_sub(vnf_fm_sub_id)
|
|
|
|
# VnfPMClient methods.
|
|
|
|
def create_vnf_pm_job(self, body):
|
|
return self.vnf_pm_client.create_vnf_pm_job(body)
|
|
|
|
def list_vnf_pm_jobs(self, retrieve_all=True, **_params):
|
|
return self.vnf_pm_client.list_vnf_pm_jobs(
|
|
retrieve_all=retrieve_all, **_params)
|
|
|
|
def show_vnf_pm_job(self, vnf_pm_job_id):
|
|
return self.vnf_pm_client.show_vnf_pm_job(vnf_pm_job_id)
|
|
|
|
def update_vnf_pm_job(self, vnf_pm_job_id, body):
|
|
return self.vnf_pm_client.update_vnf_pm_job(vnf_pm_job_id, body)
|
|
|
|
def delete_vnf_pm_job(self, vnf_pm_job_id):
|
|
return self.vnf_pm_client.delete_vnf_pm_job(vnf_pm_job_id)
|
|
|
|
def show_vnf_pm_report(self, vnf_pm_job_id, vnf_pm_report_id):
|
|
return self.vnf_pm_client.show_vnf_pm_report(
|
|
vnf_pm_job_id, vnf_pm_report_id)
|
|
|
|
def create_vnf_pm_threshold(self, body):
|
|
return self.vnf_pm_client.create_vnf_pm_threshold(body)
|
|
|
|
def list_vnf_pm_thresholds(self, retrieve_all=True, **_params):
|
|
return self.vnf_pm_client.list_vnf_pm_thresholds(
|
|
retrieve_all=retrieve_all, **_params)
|
|
|
|
def show_vnf_pm_threshold(self, vnf_pm_threshold_id):
|
|
return self.vnf_pm_client.show_vnf_pm_threshold(vnf_pm_threshold_id)
|
|
|
|
def update_vnf_pm_threshold(self, vnf_pm_threshold_id, body):
|
|
return self.vnf_pm_client.update_vnf_pm_threshold(
|
|
vnf_pm_threshold_id, body)
|
|
|
|
def delete_vnf_pm_threshold(self, vnf_pm_threshold_id):
|
|
return self.vnf_pm_client.delete_vnf_pm_threshold(vnf_pm_threshold_id)
|