openstack.block_storage.v3.service

The Service Class

The Service class inherits from Resource.

class openstack.block_storage.v3.service.Service(_synchronized=False, connection=None, **attrs)

The base resource

Parameters
  • _synchronized (bool) – This is not intended to be used directly. See new() and existing().

  • connection (openstack.connection.Connection) – Reference to the Connection being used. Defaults to None to allow Resource objects to be used without an active Connection, such as in unit tests. Use of self._connection in Resource code should protect itself with a check for None.

active_backend_id

The ID of active storage backend (cinder-volume services only)

availability_zone

The availability zone of service

backend_state

The state of storage backend (cinder-volume services only)

binary

Binary name of service

cluster

The cluster name (since 3.7)

disabled_reason

Disabled reason of service

host

The name of the host where service runs

name

Service name

replication_status

The volume service replication status (cinder-volume services only)

state

State of service

status

Status of service

updated_at

The date and time when the resource was updated

classmethod find(session, name_or_id, ignore_missing=True, **params)

Find a resource by its name or id.

Parameters
  • session (Adapter) – The session to use for making this request.

  • name_or_id – This resource’s identifier, if needed by the request. The default is None.

  • ignore_missing (bool) – When set to False 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.

  • list_base_path (str) – base_path to be used when need listing resources.

  • microversion (str) – API version to override the negotiated one.

  • params (dict) – Any additional parameters to be passed into underlying methods, such as to existing() in order to pass on URI parameters.

Returns

The Resource object matching the given name or id or None if nothing matches.

Raises

openstack.exceptions.DuplicateResource if more than one resource is found for this request.

Raises

openstack.exceptions.ResourceNotFound if nothing is found and ignore_missing is False.

commit(session, prepend_key=False, **kwargs)

Commit the state of the instance to the remote resource.

Parameters
  • session (Adapter) – The session to use for making this request.

  • prepend_key – A boolean indicating whether the resource_key should be prepended in a resource update request. Default to True.

  • retry_on_conflict (bool) – Whether to enable retries on HTTP CONFLICT (409). Value of None leaves the Adapter defaults.

  • base_path (str) – Base part of the URI for modifying resources, if different from base_path.

  • microversion (str) – API version to override the negotiated one.

  • kwargs (dict) – Parameters that will be passed to _prepare_request()

Returns

This Resource instance.

Raises

MethodNotSupported if Resource.allow_commit is not set to True.

enable(session)

Enable service.

disable(session, *, reason=None)

Disable service.

failover(session, *, cluster=None, backend_id=None)

Failover a service

Only applies to replicating cinder-volume services.