neutron_lib.exceptions package¶

Submodules¶

neutron_lib.exceptions.address_scope module¶

exception neutron_lib.exceptions.address_scope.AddressScopeInUse(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

message = u'Unable to complete operation on address scope %(address_scope_id)s. There are one or more subnet pools in use on the address scope.'¶

exception neutron_lib.exceptions.address_scope.AddressScopeNotFound(**kwargs)¶

Bases: neutron_lib.exceptions.NotFound

message = u'Address scope %(address_scope_id)s could not be found.'¶

exception neutron_lib.exceptions.address_scope.AddressScopeUpdateError(**kwargs)¶

Bases: neutron_lib.exceptions.BadRequest

message = u'Unable to update address scope %(address_scope_id)s : %(reason)s.'¶

neutron_lib.exceptions.agent module¶

exception neutron_lib.exceptions.agent.AgentNotFound(**kwargs)¶

Bases: neutron_lib.exceptions.NotFound

message = u'Agent %(id)s could not be found.'¶

exception neutron_lib.exceptions.agent.AgentNotFoundByTypeHost(**kwargs)¶

Bases: neutron_lib.exceptions.NotFound

message = u'Agent with agent_type=%(agent_type)s and host=%(host)s could not be found.'¶

exception neutron_lib.exceptions.agent.MultipleAgentFoundByTypeHost(**kwargs)¶

Bases: neutron_lib.exceptions.Conflict

message = u'Multiple agents with agent_type=%(agent_type)s and host=%(host)s found.'¶

neutron_lib.exceptions.dns module¶

exception neutron_lib.exceptions.dns.DNSDomainNotFound(**kwargs)¶

Bases: neutron_lib.exceptions.NotFound

message = u'Domain %(dns_domain)s not found in the external DNS service'¶

exception neutron_lib.exceptions.dns.DuplicateRecordSet(**kwargs)¶

Bases: neutron_lib.exceptions.Conflict

message = u'Name %(dns_name)s is duplicated in the external DNS service'¶

exception neutron_lib.exceptions.dns.ExternalDNSDriverNotFound(**kwargs)¶

Bases: neutron_lib.exceptions.NotFound

message = u'External DNS driver %(driver)s could not be found.'¶

exception neutron_lib.exceptions.dns.InvalidPTRZoneConfiguration(**kwargs)¶

Bases: neutron_lib.exceptions.Conflict

message = u'Value of %(parameter)s has to be multiple of %(number)s, with maximum value of %(maximum)s and minimum value of %(minimum)s'¶

neutron_lib.exceptions.firewall_v1 module¶

exception neutron_lib.exceptions.firewall_v1.FirewallInPendingState(**kwargs)¶

Bases: neutron_lib.exceptions.Conflict

message = u'Operation cannot be performed since associated firewall %(firewall_id)s is in %(pending_state)s.'¶

exception neutron_lib.exceptions.firewall_v1.FirewallInUse(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

message = u'Firewall %(firewall_id)s is still active.'¶

exception neutron_lib.exceptions.firewall_v1.FirewallInternalDriverError(**kwargs)¶

Bases: neutron_lib.exceptions.NeutronException

FWaaS exception for all driver errors

On any failure or exception in the driver, driver should log it and raise this exception to the agent.

message = u'%(driver)s: Internal driver error.'¶

exception neutron_lib.exceptions.firewall_v1.FirewallIpAddressConflict(**kwargs)¶

Bases: neutron_lib.exceptions.InvalidInput

message = u'Invalid input - IP addresses do not agree with IP Version.'¶

exception neutron_lib.exceptions.firewall_v1.FirewallNotFound(**kwargs)¶

Bases: neutron_lib.exceptions.NotFound

message = u'Firewall %(firewall_id)s could not be found.'¶

exception neutron_lib.exceptions.firewall_v1.FirewallPolicyConflict(**kwargs)¶

Bases: neutron_lib.exceptions.Conflict

FWaaS exception raised for firewall policy conflict

Raised when user tries to use another project’s unshared policy.

message = u'Operation cannot be performed since firewall policy %(firewall_policy_id)s is not shared and does not belong to your project.'¶

exception neutron_lib.exceptions.firewall_v1.FirewallPolicyInUse(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

message = u'Firewall policy %(firewall_policy_id)s is being used.'¶

exception neutron_lib.exceptions.firewall_v1.FirewallPolicyNotFound(**kwargs)¶

Bases: neutron_lib.exceptions.NotFound

message = u'Firewall policy %(firewall_policy_id)s could not be found.'¶

exception neutron_lib.exceptions.firewall_v1.FirewallPolicySharingConflict(**kwargs)¶

Bases: neutron_lib.exceptions.Conflict

FWaaS exception raised for shared policies

Raised if policy is shared without sharing its rules.

message = u'Operation cannot be performed. Before sharing firewall policy %(firewall_policy_id)s, share associated firewall rule %(firewall_rule_id)s.'¶

exception neutron_lib.exceptions.firewall_v1.FirewallRouterInUse(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

message = u'Router(s) %(router_ids)s provided already associated with other firewall(s).'¶

exception neutron_lib.exceptions.firewall_v1.FirewallRuleConflict(**kwargs)¶

Bases: neutron_lib.exceptions.Conflict

FWaaS rule conflict exception

Occurs when admin policy tries to use another project’s rule that is not shared.

message = u'Operation cannot be performed since firewall rule %(firewall_rule_id)s is not shared and belongs to another project %(project_id)s.'¶

exception neutron_lib.exceptions.firewall_v1.FirewallRuleInUse(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

message = u'Firewall rule %(firewall_rule_id)s is being used.'¶

exception neutron_lib.exceptions.firewall_v1.FirewallRuleInfoMissing(**kwargs)¶

Bases: neutron_lib.exceptions.InvalidInput

message = u'Missing rule info argument for insert/remove rule operation.'¶

exception neutron_lib.exceptions.firewall_v1.FirewallRuleInvalidAction(**kwargs)¶

Bases: neutron_lib.exceptions.InvalidInput

message = u'Firewall rule action %(action)s is not supported. Only action values %(values)s are supported.'¶

exception neutron_lib.exceptions.firewall_v1.FirewallRuleInvalidICMPParameter(**kwargs)¶

Bases: neutron_lib.exceptions.InvalidInput

message = u'%(param)s are not allowed when protocol is set to ICMP.'¶

exception neutron_lib.exceptions.firewall_v1.FirewallRuleInvalidPortValue(**kwargs)¶

Bases: neutron_lib.exceptions.InvalidInput

message = u'Invalid value for port %(port)s.'¶

exception neutron_lib.exceptions.firewall_v1.FirewallRuleInvalidProtocol(**kwargs)¶

Bases: neutron_lib.exceptions.InvalidInput

message = u'Firewall rule protocol %(protocol)s is not supported. Only protocol values %(values)s and their integer representation (0 to 255) are supported.'¶

exception neutron_lib.exceptions.firewall_v1.FirewallRuleNotAssociatedWithPolicy(**kwargs)¶

Bases: neutron_lib.exceptions.InvalidInput

message = u'Firewall rule %(firewall_rule_id)s is not associated with firewall policy %(firewall_policy_id)s.'¶

exception neutron_lib.exceptions.firewall_v1.FirewallRuleNotFound(**kwargs)¶

Bases: neutron_lib.exceptions.NotFound

message = u'Firewall rule %(firewall_rule_id)s could not be found.'¶

exception neutron_lib.exceptions.firewall_v1.FirewallRuleSharingConflict(**kwargs)¶

Bases: neutron_lib.exceptions.Conflict

FWaaS exception raised for conflict with shared rules

Raised if shared policy is created/updated with unshared rules.

message = u'Operation cannot be performed since firewall policy %(firewall_policy_id)s is shared but firewall rule %(firewall_rule_id)s is not shared.'¶

exception neutron_lib.exceptions.firewall_v1.FirewallRuleWithPortWithoutProtocolInvalid(**kwargs)¶

Bases: neutron_lib.exceptions.InvalidInput

message = u'Source/destination port requires a protocol.'¶

neutron_lib.exceptions.firewall_v2 module¶

exception neutron_lib.exceptions.firewall_v2.FirewallGroupCannotRemoveDefault(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

message = u'Deleting default firewall group not allowed.'¶

exception neutron_lib.exceptions.firewall_v2.FirewallGroupCannotUpdateDefault(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

message = u'Updating default firewall group not allowed.'¶

exception neutron_lib.exceptions.firewall_v2.FirewallGroupDefaultAlreadyExists(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

Default firewall group conflict exception

Occurs when a user creates firewall group named ‘default’.

message = u"Default firewall group already exists. 'default' is the reserved name for firewall group."¶

exception neutron_lib.exceptions.firewall_v2.FirewallGroupInPendingState(**kwargs)¶

Bases: neutron_lib.exceptions.Conflict

message = u'Operation cannot be performed since associated firewall group %(firewall_id)s is in %(pending_state)s.'¶

exception neutron_lib.exceptions.firewall_v2.FirewallGroupInUse(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

message = u'Firewall group %(firewall_id)s is still active.'¶

exception neutron_lib.exceptions.firewall_v2.FirewallGroupNotFound(**kwargs)¶

Bases: neutron_lib.exceptions.NotFound

message = u'Firewall group %(firewall_id)s could not be found.'¶

exception neutron_lib.exceptions.firewall_v2.FirewallGroupPortInUse(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

message = u'Port(s) %(port_ids)s provided already associated with other firewall group(s).'¶

exception neutron_lib.exceptions.firewall_v2.FirewallGroupPortInvalid(**kwargs)¶

Bases: neutron_lib.exceptions.Conflict

message = u'Port %(port_id)s of firewall group is invalid.'¶

exception neutron_lib.exceptions.firewall_v2.FirewallGroupPortInvalidProject(**kwargs)¶

Bases: neutron_lib.exceptions.Conflict

message = u'Operation cannot be performed as port %(port_id)s is in an invalid project %(project_id)s.'¶

exception neutron_lib.exceptions.firewall_v2.FirewallInternalDriverError(**kwargs)¶

Bases: neutron_lib.exceptions.NeutronException

FWaaS exception for all driver errors

On any failure or exception in the driver, driver should log it and raise this exception to the agent

message = u'%(driver)s: Internal driver error.'¶

exception neutron_lib.exceptions.firewall_v2.FirewallIpAddressConflict(**kwargs)¶

Bases: neutron_lib.exceptions.InvalidInput

message = u'Invalid input - IP addresses do not agree with IP Version.'¶

exception neutron_lib.exceptions.firewall_v2.FirewallPolicyConflict(**kwargs)¶

Bases: neutron_lib.exceptions.NotFound

FWaaS exception raised for firewall policy conflict

Raised when user tries to use another project’s unshared policy.

message = u'Operation cannot be performed since firewall policy %(firewall_policy_id)s for your project could not be found. Please confirm if the firewall policy exists and is shared.'¶

exception neutron_lib.exceptions.firewall_v2.FirewallPolicyInUse(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

message = u'Firewall policy %(firewall_policy_id)s is being used.'¶

exception neutron_lib.exceptions.firewall_v2.FirewallPolicyNotFound(**kwargs)¶

Bases: neutron_lib.exceptions.NotFound

message = u'Firewall policy %(firewall_policy_id)s could not be found.'¶

exception neutron_lib.exceptions.firewall_v2.FirewallPolicySharingConflict(**kwargs)¶

Bases: neutron_lib.exceptions.Conflict

FWaaS exception raised for sharing policies

Raised if policy is ‘shared’ but its associated rules are not.

message = u'Operation cannot be performed. Before sharing firewall policy %(firewall_policy_id)s, share associated firewall rule %(firewall_rule_id)s.'¶

exception neutron_lib.exceptions.firewall_v2.FirewallRuleAlreadyAssociated(**kwargs)¶

Bases: neutron_lib.exceptions.Conflict

FWaaS exception for an already associated rule

Occurs when there is an attempt to assign a rule to a policy that the rule is already associated with.

message = u'Operation cannot be performed since firewall rule %(firewall_rule_id)s is already associated with firewallpolicy %(firewall_policy_id)s.'¶

exception neutron_lib.exceptions.firewall_v2.FirewallRuleConflict(**kwargs)¶

Bases: neutron_lib.exceptions.Conflict

FWaaS rule conflict exception

Occurs when admin policy tries to use another project’s rule that is not shared.

message = u'Operation cannot be performed since firewall rule %(firewall_rule_id)s is not shared and belongs to another project %(project_id)s.'¶

exception neutron_lib.exceptions.firewall_v2.FirewallRuleInUse(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

message = u'Firewall rule %(firewall_rule_id)s is being used.'¶

exception neutron_lib.exceptions.firewall_v2.FirewallRuleInfoMissing(**kwargs)¶

Bases: neutron_lib.exceptions.InvalidInput

message = u'Missing rule info argument for insert/remove rule operation.'¶

exception neutron_lib.exceptions.firewall_v2.FirewallRuleInvalidAction(**kwargs)¶

Bases: neutron_lib.exceptions.InvalidInput

message = u'Action %(action)s is not supported. Only action values %(values)s are supported.'¶

exception neutron_lib.exceptions.firewall_v2.FirewallRuleInvalidICMPParameter(**kwargs)¶

Bases: neutron_lib.exceptions.InvalidInput

message = u'%(param)s are not allowed when protocol is set to ICMP.'¶

exception neutron_lib.exceptions.firewall_v2.FirewallRuleInvalidPortValue(**kwargs)¶

Bases: neutron_lib.exceptions.InvalidInput

message = u'Invalid value for port %(port)s.'¶

exception neutron_lib.exceptions.firewall_v2.FirewallRuleInvalidProtocol(**kwargs)¶

Bases: neutron_lib.exceptions.InvalidInput

message = u'Protocol %(protocol)s is not supported. Only protocol values %(values)s and their integer representation (0 to 255) are supported.'¶

exception neutron_lib.exceptions.firewall_v2.FirewallRuleNotAssociatedWithPolicy(**kwargs)¶

Bases: neutron_lib.exceptions.InvalidInput

message = u'Firewall rule %(firewall_rule_id)s is not associated with firewall policy %(firewall_policy_id)s.'¶

exception neutron_lib.exceptions.firewall_v2.FirewallRuleNotFound(**kwargs)¶

Bases: neutron_lib.exceptions.NotFound

message = u'Firewall rule %(firewall_rule_id)s could not be found.'¶

exception neutron_lib.exceptions.firewall_v2.FirewallRuleSharingConflict(**kwargs)¶

Bases: neutron_lib.exceptions.NotFound

FWaaS exception for sharing policies

Raised when shared policy uses unshared rules.

message = u'Operation cannot be performed since firewall policy %(firewall_policy_id)s could not find the firewall rule %(firewall_rule_id)s. Please confirm if the firewall ruleexists and is shared.'¶

exception neutron_lib.exceptions.firewall_v2.FirewallRuleWithPortWithoutProtocolInvalid(**kwargs)¶

Bases: neutron_lib.exceptions.InvalidInput

message = u'Source/destination port requires a protocol.'¶

neutron_lib.exceptions.l3 module¶

exception neutron_lib.exceptions.l3.ExternalGatewayForFloatingIPNotFound(**kwargs)¶

Bases: neutron_lib.exceptions.NotFound

message = u'External network %(external_network_id)s is not reachable from subnet %(subnet_id)s. Therefore, cannot associate Port %(port_id)s with a Floating IP.'¶

exception neutron_lib.exceptions.l3.FloatingIPNotFound(**kwargs)¶

Bases: neutron_lib.exceptions.NotFound

message = u'Floating IP %(floatingip_id)s could not be found'¶

exception neutron_lib.exceptions.l3.FloatingIPPortAlreadyAssociated(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

message = u'Cannot associate floating IP %(floating_ip_address)s (%(fip_id)s) with port %(port_id)s using fixed IP %(fixed_ip)s, as that fixed IP already has a floating IP on external network %(net_id)s.'¶

exception neutron_lib.exceptions.l3.RouterExternalGatewayInUseByFloatingIp(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

message = u'Gateway cannot be updated for router %(router_id)s, since a gateway to external network %(net_id)s is required by one or more floating IPs.'¶

exception neutron_lib.exceptions.l3.RouterInUse(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

message = u'Router %(router_id)s %(reason)s'¶

exception neutron_lib.exceptions.l3.RouterInterfaceAttachmentConflict(**kwargs)¶

Bases: neutron_lib.exceptions.Conflict

message = u'Error %(reason)s while attempting the operation.'¶

exception neutron_lib.exceptions.l3.RouterInterfaceInUseByFloatingIP(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

message = u'Router interface for subnet %(subnet_id)s on router %(router_id)s cannot be deleted, as it is required by one or more floating IPs.'¶

exception neutron_lib.exceptions.l3.RouterInterfaceNotFound(**kwargs)¶

Bases: neutron_lib.exceptions.NotFound

message = u'Router %(router_id)s does not have an interface with id %(port_id)s'¶

exception neutron_lib.exceptions.l3.RouterInterfaceNotFoundForSubnet(**kwargs)¶

Bases: neutron_lib.exceptions.NotFound

message = u'Router %(router_id)s has no interface on subnet %(subnet_id)s'¶

exception neutron_lib.exceptions.l3.RouterNotFound(**kwargs)¶

Bases: neutron_lib.exceptions.NotFound

message = u'Router %(router_id)s could not be found'¶

neutron_lib.exceptions.port_security module¶

exception neutron_lib.exceptions.port_security.PortSecurityAndIPRequiredForSecurityGroups(**kwargs)¶

Bases: neutron_lib.exceptions.InvalidInput

message = u'Port security must be enabled and port must have an IP address in order to use security groups.'¶

exception neutron_lib.exceptions.port_security.PortSecurityPortHasSecurityGroup(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

message = u'Port has security group associated. Cannot disable port security or IP address until security group is removed.'¶

Module contents¶

Neutron base exception handling.

exception neutron_lib.exceptions.AdminRequired(**kwargs)¶

Bases: neutron_lib.exceptions.NotAuthorized

A not authorized exception indicating an admin is required.

A specialization of the NotAuthorized exception that indicates and admin is required to carry out the operation or access a resource.

Parameters:	reason – A message indicating additional details on why admin is required for the operation access.

message = u'User does not have admin privileges: %(reason)s.'¶

exception neutron_lib.exceptions.BadRequest(**kwargs)¶

Bases: neutron_lib.exceptions.NeutronException

An exception indicating a generic bad request for a said resource.

A generic exception indicating a bad request for a specified resource.

Parameters:	resource – The resource requested. msg – A message indicating why the request is bad.

message = u'Bad %(resource)s request: %(msg)s.'¶

exception neutron_lib.exceptions.Conflict(**kwargs)¶

Bases: neutron_lib.exceptions.NeutronException

A generic conflict exception.

exception neutron_lib.exceptions.DeviceNotFoundError(**kwargs)¶

Bases: neutron_lib.exceptions.NotFound

An exception for a requested device that’s not found.

A specialization of the NotFound exception indicating a requested device could not be found.

Parameters:	device_name – The name of the (not found) device that was requested.

message = u"Device '%(device_name)s' does not exist."¶

exception neutron_lib.exceptions.ExternalIpAddressExhausted(**kwargs)¶

Bases: neutron_lib.exceptions.BadRequest

An error due to not finding IP addresses on an external network.

A specialization of the BadRequest exception indicating no IP addresses can be found on a network.

Parameters:	net_id – The UUID of the network.

message = u'Unable to find any IP address on external network %(net_id)s.'¶

exception neutron_lib.exceptions.InUse(**kwargs)¶

Bases: neutron_lib.exceptions.NeutronException

A generic exception indicating a resource is already in use.

message = u'The resource is in use.'¶

exception neutron_lib.exceptions.Invalid(message=None)¶

Bases: neutron_lib.exceptions.NeutronException

A generic base class for invalid errors.

exception neutron_lib.exceptions.InvalidConfigurationOption(**kwargs)¶

Bases: neutron_lib.exceptions.NeutronException

An error due to an invalid configuration option value.

Parameters:	opt_name – The name of the configuration option that has an invalid value. opt_value – The value that’s invalid for the configuration option.

message = u'An invalid value was provided for %(opt_name)s: %(opt_value)s.'¶

exception neutron_lib.exceptions.InvalidContentType(**kwargs)¶

Bases: neutron_lib.exceptions.NeutronException

An error due to invalid content type.

Parameters:	content_type – The invalid content type.

message = u'Invalid content type %(content_type)s.'¶

exception neutron_lib.exceptions.InvalidInput(**kwargs)¶

Bases: neutron_lib.exceptions.BadRequest

A bad request due to invalid input.

A specialization of the BadRequest error indicating bad input was specified.

Parameters:	error_message – Details on the operation that failed due to bad input.

message = u'Invalid input for operation: %(error_message)s.'¶

exception neutron_lib.exceptions.InvalidIpForNetwork(**kwargs)¶

Bases: neutron_lib.exceptions.BadRequest

An exception indicating an invalid IP was specified for a network.

A specialization of the BadRequest exception indicating a specified IP address is invalid for a network.

Parameters:	ip_address – The IP address that’s invalid on the network.

message = u'IP address %(ip_address)s is not a valid IP for any of the subnets on the specified network.'¶

exception neutron_lib.exceptions.InvalidIpForSubnet(**kwargs)¶

Bases: neutron_lib.exceptions.BadRequest

An exception indicating an invalid IP was specified for a subnet.

A specialization of the BadRequest exception indicating a specified IP address is invalid for a subnet.

Parameters:	ip_address – The IP address that’s invalid on the subnet.

message = u'IP address %(ip_address)s is not a valid IP for the specified subnet.'¶

exception neutron_lib.exceptions.IpAddressGenerationFailure(**kwargs)¶

Bases: neutron_lib.exceptions.Conflict

A conflict error due to no more IP addresses on a said network.

Parameters:	net_id – The UUID of the network that has no more IP addresses.

message = u'No more IP addresses available on network %(net_id)s.'¶

exception neutron_lib.exceptions.IpAddressInUse(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

An network operational error indicating an IP address is already in use.

A specialization of the InUse exception indicating an operation can’t complete because an IP address is in use.

Parameters:	net_id – The UUID of the network. ip_address – The IP address that’s already in use on the network.

message = u'Unable to complete operation for network %(net_id)s. The IP address %(ip_address)s is in use.'¶

exception neutron_lib.exceptions.MacAddressInUse(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

An network operational error indicating a MAC address is already in use.

A specialization of the InUse exception indicating an operation failed on a network because a specified MAC address is already in use on that network.

Parameters:	net_id – The UUID of the network. mac – The requested MAC address that’s already in use.

message = u'Unable to complete operation for network %(net_id)s. The mac address %(mac)s is in use.'¶

exception neutron_lib.exceptions.MultipleExceptions(exceptions, *args, **kwargs)¶

Bases: exceptions.Exception

Container for multiple exceptions encountered.

The API layer of Neutron will automatically unpack, translate, filter, and combine the inner exceptions in any exception derived from this class.

exception neutron_lib.exceptions.NetworkInUse(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

An operational error indicating the network still has ports in use.

A specialization of the InUse exception indicating a network operation was requested, but failed because there are still ports in use on the said network.

Parameters:	net_id – The UUID of the network requested.

message = u'Unable to complete operation on network %(net_id)s. There are one or more ports still in use on the network.'¶

exception neutron_lib.exceptions.NetworkNotFound(**kwargs)¶

Bases: neutron_lib.exceptions.NotFound

An exception indicating a network was not found.

A specialization of the NotFound exception indicating a requested network could not be found.

Parameters:	net_id – The UUID of the (not found) network requested.

message = u'Network %(net_id)s could not be found.'¶

exception neutron_lib.exceptions.NetworkTunnelRangeError(**kwargs)¶

Bases: neutron_lib.exceptions.NeutronException

An error due to an invalid network tunnel range.

An exception indicating an invalid network tunnel range was specified.

Parameters:	tunnel_range – The invalid tunnel range. If specified in the start:end’ format, they will be converted automatically. error – Additional details on why the range is invalid.

message = u"Invalid network tunnel range: '%(tunnel_range)s' - %(error)s."¶

exception neutron_lib.exceptions.NeutronException(**kwargs)¶

Bases: exceptions.Exception

Base Neutron Exception.

To correctly use this class, inherit from it and define a ‘message’ property. That message will get printf’d with the keyword arguments provided to the constructor.

message = u'An unknown exception occurred.'¶

use_fatal_exceptions()¶

Is the instance using fatal exceptions.

Returns:	Always returns False.

exception neutron_lib.exceptions.NoNetworkAvailable(**kwargs)¶

Bases: neutron_lib.exceptions.ResourceExhausted

A failure to create a network due to no tenant networks for allocation.

A specialization of the ResourceExhausted exception indicating network creation failed because no tenant network are available for allocation.

message = u'Unable to create the network. No tenant network is available for allocation.'¶

exception neutron_lib.exceptions.NotAuthorized(**kwargs)¶

Bases: neutron_lib.exceptions.NeutronException

A generic not authorized exception.

message = u'Not authorized.'¶

exception neutron_lib.exceptions.NotFound(**kwargs)¶

Bases: neutron_lib.exceptions.NeutronException

A generic not found exception.

exception neutron_lib.exceptions.ObjectNotFound(**kwargs)¶

Bases: neutron_lib.exceptions.NotFound

A not found exception indicating an identifiable object isn’t found.

A specialization of the NotFound exception indicating an object with a said ID doesn’t exist.

Parameters:	id – The ID of the (not found) object.

message = u'Object %(id)s not found.'¶

exception neutron_lib.exceptions.OverQuota(**kwargs)¶

Bases: neutron_lib.exceptions.Conflict

A error due to exceeding quota limits.

A specialization of the Conflict exception indicating quota has been exceeded.

Parameters:	overs – The resources that have exceeded quota.

message = u'Quota exceeded for resources: %(overs)s.'¶

exception neutron_lib.exceptions.PolicyCheckError(**kwargs)¶

Bases: neutron_lib.exceptions.NeutronException

An error due to a policy check failure.

Parameters:	policy – The policy that failed to check. reason – Additional details on the failure.

message = u'Failed to check policy %(policy)s because %(reason)s.'¶

exception neutron_lib.exceptions.PolicyInitError(**kwargs)¶

Bases: neutron_lib.exceptions.NeutronException

An error due to policy initialization failure.

Parameters:	policy – The policy that failed to initialize. reason – Details on why the policy failed to initialize.

message = u'Failed to initialize policy %(policy)s because %(reason)s.'¶

exception neutron_lib.exceptions.PortBound(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

An operational error indicating a port is already bound.

A specialization of the InUse exception indicating an operation can’t complete because the port is already bound.

Parameters:	port_id – The UUID of the port requested. vif_type – The VIF type associated with the bound port. old_mac – The old MAC address of the port. net_mac – The new MAC address of the port.

message = u'Unable to complete operation on port %(port_id)s, port is already bound, port type: %(vif_type)s, old_mac %(old_mac)s, new_mac %(new_mac)s.'¶

exception neutron_lib.exceptions.PortInUse(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

An operational error indicating a requested port is already attached.

A specialization of the InUse exception indicating an operation failed on a port because it already has an attached device.

Parameters:	port_id – The UUID of the port requested. net_id – The UUID of the requested port’s network. device_id – The UUID of the device already attached to the port.

message = u'Unable to complete operation on port %(port_id)s for network %(net_id)s. Port already has an attached device %(device_id)s.'¶

exception neutron_lib.exceptions.PortNotFound(**kwargs)¶

Bases: neutron_lib.exceptions.NotFound

An exception for a requested port that’s not found.

A specialization of the NotFound exception indicating a requested port could not be found.

Parameters:	port_id – The UUID of the (not found) port that was requested.

message = u'Port %(port_id)s could not be found.'¶

exception neutron_lib.exceptions.PortNotFoundOnNetwork(**kwargs)¶

Bases: neutron_lib.exceptions.NotFound

An exception for a requested port on a network that’s not found.

A specialization of the NotFound exception that indicates a specified port on a specified network doesn’t exist.

Parameters:	port_id – The UUID of the (not found) port that was requested. net_id – The UUID of the network that was requested for the port.

message = u'Port %(port_id)s could not be found on network %(net_id)s.'¶

exception neutron_lib.exceptions.PreexistingDeviceFailure(**kwargs)¶

Bases: neutron_lib.exceptions.NeutronException

A creation error due to an already existing device.

An exception indication creation failed due to an already existing device.

Parameters:	dev_name – The device name that already exists.

message = u'Creation failed. %(dev_name)s already exists.'¶

exception neutron_lib.exceptions.ResourceExhausted(**kwargs)¶

Bases: neutron_lib.exceptions.ServiceUnavailable

A service unavailable error indicating a resource is exhausted.

exception neutron_lib.exceptions.ServicePortInUse(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

An error indicating a service port can’t be deleted.

A specialization of the InUse exception indicating a requested service port can’t be deleted via the APIs.

Parameters:	port_id – The UUID of the port requested. reason – Details on why the operation failed.

message = u'Port %(port_id)s cannot be deleted directly via the port API: %(reason)s.'¶

exception neutron_lib.exceptions.ServiceUnavailable(**kwargs)¶

Bases: neutron_lib.exceptions.NeutronException

A generic service unavailable exception.

message = u'The service is unavailable.'¶

exception neutron_lib.exceptions.SubnetInUse(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

An operational error indicating a subnet is still in use.

A specialization of the InUse exception indicating an operation failed on a subnet because the subnet is still in use.

Parameters:	subnet_id – The UUID of the subnet requested. reason – Details on why the operation failed. If None, a default reason is used indicating one or more ports still have IP allocations on the subnet.

message = u'Unable to complete operation on subnet %(subnet_id)s: %(reason)s.'¶

exception neutron_lib.exceptions.SubnetMismatchForPort(**kwargs)¶

Bases: neutron_lib.exceptions.BadRequest

A bad request error indicating a specified subnet isn’t on a port.

A specialization of the BadRequest exception indicating a subnet on a port doesn’t match a specified subnet.

Parameters:	port_id – The UUID of the port. subnet_id – The UUID of the requested subnet.

message = u'Subnet on port %(port_id)s does not match the requested subnet %(subnet_id)s.'¶

exception neutron_lib.exceptions.SubnetNotFound(**kwargs)¶

Bases: neutron_lib.exceptions.NotFound

An exception for a requested subnet that’s not found.

A specialization of the NotFound exception indicating a requested subnet could not be found.

Parameters:	subnet_id – The UUID of the (not found) subnet that was requested.

message = u'Subnet %(subnet_id)s could not be found.'¶

exception neutron_lib.exceptions.SubnetPoolInUse(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

An operational error indicating a subnet pool is still in use.

A specialization of the InUse exception indicating an operation failed on a subnet pool because it’s still in use.

Parameters:	subnet_pool_id – The UUID of the subnet pool requested. reason – Details on why the operation failed. If None a default reason is used indicating two or more concurrent subnets are allocated.

message = u'Unable to complete operation on subnet pool %(subnet_pool_id)s. %(reason)s.'¶

exception neutron_lib.exceptions.TooManyExternalNetworks(**kwargs)¶

Bases: neutron_lib.exceptions.NeutronException

An error due to more than one external networks existing.

message = u'More than one external network exists.'¶

exception neutron_lib.exceptions.TunnelIdInUse(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

A network creation failure due to tunnel ID already in use.

A specialization of the InUse exception indicating network creation failed because a said tunnel ID is already in use.

Parameters:	tunnel_id – The ID of the tunnel that’s already in use.

message = u'Unable to create the network. The tunnel ID %(tunnel_id)s is in use.'¶

exception neutron_lib.exceptions.VlanIdInUse(**kwargs)¶

Bases: neutron_lib.exceptions.InUse

An exception indicating VLAN creation failed because it’s already in use.

A specialization of the InUse exception indicating network creation failed because a specified VLAN is already in use on the physical network.

Parameters:	vlan_id – The LVAN ID. physical_network – The physical network.

message = u'Unable to create the network. The VLAN %(vlan_id)s on physical network %(physical_network)s is in use.'¶