impuls/lib/python3.11/site-packages/openstack/network/v2/floating_ip.py

100 lines
4.0 KiB
Python
Raw Normal View History

# 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.common import tag
from openstack.network.v2 import _base
from openstack import resource
class FloatingIP(_base.NetworkResource, tag.TagMixin):
name_attribute = "floating_ip_address"
resource_name = "floating ip"
resource_key = 'floatingip'
resources_key = 'floatingips'
base_path = '/floatingips'
# capabilities
allow_create = True
allow_fetch = True
allow_commit = True
allow_delete = True
allow_list = True
# For backward compatibility include tenant_id as query param
_query_mapping = resource.QueryParameters(
'description',
'fixed_ip_address',
'floating_ip_address',
'floating_network_id',
'port_id',
'router_id',
'status',
'subnet_id',
'project_id',
'tenant_id',
tenant_id='project_id',
**tag.TagMixin._tag_query_parameters
)
# Properties
#: Timestamp at which the floating IP was created.
created_at = resource.Body('created_at')
#: The floating IP description.
description = resource.Body('description')
#: The DNS domain.
dns_domain = resource.Body('dns_domain')
#: The DNS name.
dns_name = resource.Body('dns_name')
#: The fixed IP address associated with the floating IP. If you
#: intend to associate the floating IP with a fixed IP at creation
#: time, then you must indicate the identifier of the internal port.
#: If an internal port has multiple associated IP addresses, the
#: service chooses the first IP unless you explicitly specify the
#: parameter fixed_ip_address to select a specific IP.
fixed_ip_address = resource.Body('fixed_ip_address')
#: The floating IP address.
floating_ip_address = resource.Body('floating_ip_address')
#: Floating IP object doesn't have name attribute, set ip address to name
#: so that user could find floating IP by UUID or IP address using find_ip
name = floating_ip_address
#: The ID of the network associated with the floating IP.
floating_network_id = resource.Body('floating_network_id')
#: Read-only. The details of the port that this floating IP associates
#: with. Present if ``fip-port-details`` extension is loaded.
#: *Type: dict with keys: name, network_id, mac_address, admin_state_up,
#: status, device_id, device_owner*
port_details = resource.Body('port_details', type=dict)
#: The port ID.
port_id = resource.Body('port_id')
#: The ID of the QoS policy attached to the floating IP.
qos_policy_id = resource.Body('qos_policy_id')
#: The ID of the project this floating IP is associated with.
project_id = resource.Body('project_id', alias='tenant_id')
#: Tenant_id (deprecated attribute).
tenant_id = resource.Body('tenant_id', deprecated=True)
#: The ID of an associated router.
router_id = resource.Body('router_id')
#: The floating IP status. Value is ``ACTIVE`` or ``DOWN``.
status = resource.Body('status')
#: Timestamp at which the floating IP was last updated.
updated_at = resource.Body('updated_at')
#: The Subnet ID associated with the floating IP.
subnet_id = resource.Body('subnet_id')
@classmethod
def find_available(cls, session):
# server-side filtering on empty values is not always supported.
# TODO(mordred) Make this check for support for the server-side filter
for ip in cls.list(session):
if not ip.port_id:
return ip
return None