Name	Size	Mode	Actions
resource.py	2435	0644	editdlrm
resource.pyc	1398	0644	editdlrm
stack.py	5326	0644	editdlrm
stack.pyc	4419	0644	editdlrm
_proxy.py	5995	0644	editdlrm
_proxy.pyc	6301	0644	editdlrm
__init__.py	0	0644	editdlrm
__init__.pyc	160	0644	editdlrm

# 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. from openstack import exceptions from openstack.orchestration.v1 import resource as _resource from openstack.orchestration.v1 import stack as _stack from openstack import proxy class Proxy(proxy.BaseProxy): def create_stack(self, preview=False, **attrs): """Create a new stack from attributes :param bool perview: When ``True``, returns :class:`~openstack.orchestration.v1.stack.StackPreview` objects, otherwise :class:`~openstack.orchestration.v1.stack.Stack`. *Default: ``False``* :param dict attrs: Keyword arguments which will be used to create a :class:`~openstack.orchestration.v1.stack.Stack`, comprised of the properties on the Stack class. :returns: The results of stack creation :rtype: :class:`~openstack.orchestration.v1.stack.Stack` """ stk = _stack.StackPreview if preview else _stack.Stack return self._create(stk, **attrs) def find_stack(self, name_or_id, ignore_missing=True): """Find a single stack :param name_or_id: The name or ID of a stack. :param bool ignore_missing: When set to ``False`` :class:`~openstack.exceptions.ResourceNotFound` will be raised when the resource does not exist. When set to ``True``, None will be returned when attempting to find a nonexistent resource. :returns: One :class:`~openstack.orchestration.v1.stack.Stack` or None """ return self._find(_stack.Stack, name_or_id, ignore_missing=ignore_missing) def stacks(self, **query): """Return a generator of stacks :param kwargs \*\*query: Optional query parameters to be sent to limit the resources being returned. :returns: A generator of stack objects :rtype: :class:`~openstack.orchestration.v1.stack.Stack` """ return self._list(_stack.Stack, paginated=False, **query) def get_stack(self, stack): """Get a single stack :param stack: The value can be the ID of a stack or a :class:`~openstack.orchestration.v1.stack.Stack` instance. :returns: One :class:`~openstack.orchestration.v1.stack.Stack` :raises: :class:`~openstack.exceptions.ResourceNotFound` when no resource can be found. """ return self._get(_stack.Stack, stack) def update_stack(self, stack, **attrs): """Update a stack :param stack: The value can be the ID of a stack or a :class:`~openstack.orchestration.v1.stack.Stack` instance. :param kwargs \*\*attrs: The attributes to update on the stack represented by ``value``. :returns: The updated stack :rtype: :class:`~openstack.orchestration.v1.stack.Stack` :raises: :class:`~openstack.exceptions.ResourceNotFound` when no resource can be found. """ return self._update(_stack.Stack, stack, **attrs) def delete_stack(self, stack, ignore_missing=True): """Delete a stack :param stack: The value can be either the ID of a stack or a :class:`~openstack.orchestration.v1.stack.Stack` instance. :param bool ignore_missing: When set to ``False`` :class:`~openstack.exceptions.ResourceNotFound` will be raised when the stack does not exist. When set to ``True``, no exception will be set when attempting to delete a nonexistent server. :returns: ``None`` """ self._delete(_stack.Stack, stack, ignore_missing=ignore_missing) def resources(self, stack, **query): """Return a generator of resources :param stack: This can be a stack object, or the name of a stack for which the resources are to be listed. :param kwargs \*\*query: Optional query parameters to be sent to limit the resources being returned. :returns: A generator of resource objects if the stack exists and there are resources in it. If the stack cannot be found, an exception is thrown. :rtype: A generator of :class:`~openstack.orchestration.v1.resource.Resource` :raises: :class:`~openstack.exceptions.ResourceNotFound` when the stack cannot be found. """ # first try treat the value as a stack object or an ID try: stk = _stack.Stack.from_id(stack) except ValueError: raise exceptions.ResourceNotFound( "No stack found for %(v)s" % {'v': stack}) # if stack object doesn't contain a valid name, it means the object # was created on the fly so we need to retrieve its name if not stk.name: stk = self.find_stack(stack) if stk is None: raise exceptions.ResourceNotFound( "No stack found for %(v)s" % {'v': stack}) path_args = { 'stack_name': stk.name, 'stack_id': stk.id, } return self._list(_resource.Resource, paginated=False, path_args=path_args, **query)