serializers.py 27 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749
  1. from django.contrib.contenttypes.models import ContentType
  2. from drf_yasg.utils import swagger_serializer_method
  3. from rest_framework import serializers
  4. from rest_framework.validators import UniqueTogetherValidator
  5. from taggit_serializer.serializers import TaggitSerializer, TagListSerializerField
  6. from dcim.choices import *
  7. from dcim.constants import *
  8. from dcim.models import (
  9. Cable, ConsolePort, ConsolePortTemplate, ConsoleServerPort, ConsoleServerPortTemplate, Device, DeviceBay,
  10. DeviceBayTemplate, DeviceType, DeviceRole, FrontPort, FrontPortTemplate, Interface, InterfaceTemplate,
  11. Manufacturer, InventoryItem, Platform, PowerFeed, PowerOutlet, PowerOutletTemplate, PowerPanel, PowerPort,
  12. PowerPortTemplate, Rack, RackGroup, RackReservation, RackRole, RearPort, RearPortTemplate, Region, Site,
  13. VirtualChassis,
  14. )
  15. from extras.api.customfields import CustomFieldModelSerializer
  16. from ipam.api.nested_serializers import NestedIPAddressSerializer, NestedVLANSerializer
  17. from ipam.models import VLAN
  18. from tenancy.api.nested_serializers import NestedTenantSerializer
  19. from users.api.nested_serializers import NestedUserSerializer
  20. from utilities.api import (
  21. ChoiceField, ContentTypeField, SerializedPKRelatedField, TimeZoneField, ValidatedModelSerializer,
  22. WritableNestedSerializer, get_serializer_for_model,
  23. )
  24. from virtualization.api.nested_serializers import NestedClusterSerializer
  25. from .nested_serializers import *
  26. class ConnectedEndpointSerializer(ValidatedModelSerializer):
  27. connected_endpoint_type = serializers.SerializerMethodField(read_only=True)
  28. connected_endpoint = serializers.SerializerMethodField(read_only=True)
  29. connection_status = ChoiceField(choices=CONNECTION_STATUS_CHOICES, read_only=True)
  30. def get_connected_endpoint_type(self, obj):
  31. if hasattr(obj, 'connected_endpoint') and obj.connected_endpoint is not None:
  32. return '{}.{}'.format(
  33. obj.connected_endpoint._meta.app_label,
  34. obj.connected_endpoint._meta.model_name
  35. )
  36. return None
  37. @swagger_serializer_method(serializer_or_field=serializers.DictField)
  38. def get_connected_endpoint(self, obj):
  39. """
  40. Return the appropriate serializer for the type of connected object.
  41. """
  42. if getattr(obj, 'connected_endpoint', None) is None:
  43. return None
  44. serializer = get_serializer_for_model(obj.connected_endpoint, prefix='Nested')
  45. context = {'request': self.context['request']}
  46. data = serializer(obj.connected_endpoint, context=context).data
  47. return data
  48. #
  49. # Regions/sites
  50. #
  51. class RegionSerializer(serializers.ModelSerializer):
  52. parent = NestedRegionSerializer(required=False, allow_null=True)
  53. site_count = serializers.IntegerField(read_only=True)
  54. class Meta:
  55. model = Region
  56. fields = ['id', 'name', 'slug', 'parent', 'site_count']
  57. class SiteSerializer(TaggitSerializer, CustomFieldModelSerializer):
  58. status = ChoiceField(choices=SiteStatusChoices, required=False)
  59. region = NestedRegionSerializer(required=False, allow_null=True)
  60. tenant = NestedTenantSerializer(required=False, allow_null=True)
  61. time_zone = TimeZoneField(required=False)
  62. tags = TagListSerializerField(required=False)
  63. circuit_count = serializers.IntegerField(read_only=True)
  64. device_count = serializers.IntegerField(read_only=True)
  65. prefix_count = serializers.IntegerField(read_only=True)
  66. rack_count = serializers.IntegerField(read_only=True)
  67. virtualmachine_count = serializers.IntegerField(read_only=True)
  68. vlan_count = serializers.IntegerField(read_only=True)
  69. class Meta:
  70. model = Site
  71. fields = [
  72. 'id', 'name', 'slug', 'status', 'region', 'tenant', 'facility', 'asn', 'time_zone', 'description',
  73. 'physical_address', 'shipping_address', 'latitude', 'longitude', 'contact_name', 'contact_phone',
  74. 'contact_email', 'comments', 'tags', 'custom_fields', 'created', 'last_updated', 'circuit_count',
  75. 'device_count', 'prefix_count', 'rack_count', 'virtualmachine_count', 'vlan_count',
  76. ]
  77. #
  78. # Racks
  79. #
  80. class RackGroupSerializer(ValidatedModelSerializer):
  81. site = NestedSiteSerializer()
  82. rack_count = serializers.IntegerField(read_only=True)
  83. class Meta:
  84. model = RackGroup
  85. fields = ['id', 'name', 'slug', 'site', 'rack_count']
  86. class RackRoleSerializer(ValidatedModelSerializer):
  87. rack_count = serializers.IntegerField(read_only=True)
  88. class Meta:
  89. model = RackRole
  90. fields = ['id', 'name', 'slug', 'color', 'description', 'rack_count']
  91. class RackSerializer(TaggitSerializer, CustomFieldModelSerializer):
  92. site = NestedSiteSerializer()
  93. group = NestedRackGroupSerializer(required=False, allow_null=True, default=None)
  94. tenant = NestedTenantSerializer(required=False, allow_null=True)
  95. status = ChoiceField(choices=RackStatusChoices, required=False)
  96. role = NestedRackRoleSerializer(required=False, allow_null=True)
  97. type = ChoiceField(choices=RackTypeChoices, required=False, allow_null=True)
  98. width = ChoiceField(choices=RackWidthChoices, required=False)
  99. outer_unit = ChoiceField(choices=RackDimensionUnitChoices, required=False)
  100. tags = TagListSerializerField(required=False)
  101. device_count = serializers.IntegerField(read_only=True)
  102. powerfeed_count = serializers.IntegerField(read_only=True)
  103. class Meta:
  104. model = Rack
  105. fields = [
  106. 'id', 'name', 'facility_id', 'display_name', 'site', 'group', 'tenant', 'status', 'role', 'serial',
  107. 'asset_tag', 'type', 'width', 'u_height', 'desc_units', 'outer_width', 'outer_depth', 'outer_unit',
  108. 'comments', 'tags', 'custom_fields', 'created', 'last_updated', 'device_count', 'powerfeed_count',
  109. ]
  110. # Omit the UniqueTogetherValidator that would be automatically added to validate (group, facility_id). This
  111. # prevents facility_id from being interpreted as a required field.
  112. validators = [
  113. UniqueTogetherValidator(queryset=Rack.objects.all(), fields=('group', 'name'))
  114. ]
  115. def validate(self, data):
  116. # Validate uniqueness of (group, facility_id) since we omitted the automatically-created validator from Meta.
  117. if data.get('facility_id', None):
  118. validator = UniqueTogetherValidator(queryset=Rack.objects.all(), fields=('group', 'facility_id'))
  119. validator.set_context(self)
  120. validator(data)
  121. # Enforce model validation
  122. super().validate(data)
  123. return data
  124. class RackUnitSerializer(serializers.Serializer):
  125. """
  126. A rack unit is an abstraction formed by the set (rack, position, face); it does not exist as a row in the database.
  127. """
  128. id = serializers.IntegerField(read_only=True)
  129. name = serializers.CharField(read_only=True)
  130. face = ChoiceField(choices=DeviceFaceChoices, read_only=True)
  131. device = NestedDeviceSerializer(read_only=True)
  132. class RackReservationSerializer(ValidatedModelSerializer):
  133. rack = NestedRackSerializer()
  134. user = NestedUserSerializer()
  135. tenant = NestedTenantSerializer(required=False, allow_null=True)
  136. class Meta:
  137. model = RackReservation
  138. fields = ['id', 'rack', 'units', 'created', 'user', 'tenant', 'description']
  139. class RackElevationDetailFilterSerializer(serializers.Serializer):
  140. face = serializers.ChoiceField(
  141. choices=DeviceFaceChoices,
  142. default=DeviceFaceChoices.FACE_FRONT
  143. )
  144. render = serializers.ChoiceField(
  145. choices=RackElevationDetailRenderChoices,
  146. default=RackElevationDetailRenderChoices.RENDER_JSON
  147. )
  148. unit_width = serializers.IntegerField(
  149. default=RACK_ELEVATION_UNIT_WIDTH_DEFAULT
  150. )
  151. unit_height = serializers.IntegerField(
  152. default=RACK_ELEVATION_UNIT_HEIGHT_DEFAULT
  153. )
  154. exclude = serializers.IntegerField(
  155. required=False,
  156. default=None
  157. )
  158. expand_devices = serializers.BooleanField(
  159. required=False,
  160. default=True
  161. )
  162. #
  163. # Device types
  164. #
  165. class ManufacturerSerializer(ValidatedModelSerializer):
  166. devicetype_count = serializers.IntegerField(read_only=True)
  167. inventoryitem_count = serializers.IntegerField(read_only=True)
  168. platform_count = serializers.IntegerField(read_only=True)
  169. class Meta:
  170. model = Manufacturer
  171. fields = ['id', 'name', 'slug', 'devicetype_count', 'inventoryitem_count', 'platform_count']
  172. class DeviceTypeSerializer(TaggitSerializer, CustomFieldModelSerializer):
  173. manufacturer = NestedManufacturerSerializer()
  174. subdevice_role = ChoiceField(choices=SubdeviceRoleChoices, required=False, allow_null=True)
  175. tags = TagListSerializerField(required=False)
  176. device_count = serializers.IntegerField(read_only=True)
  177. class Meta:
  178. model = DeviceType
  179. fields = [
  180. 'id', 'manufacturer', 'model', 'slug', 'display_name', 'part_number', 'u_height', 'is_full_depth',
  181. 'subdevice_role', 'comments', 'tags', 'custom_fields', 'created', 'last_updated', 'device_count',
  182. ]
  183. class ConsolePortTemplateSerializer(ValidatedModelSerializer):
  184. device_type = NestedDeviceTypeSerializer()
  185. type = ChoiceField(
  186. choices=ConsolePortTypeChoices,
  187. required=False
  188. )
  189. class Meta:
  190. model = ConsolePortTemplate
  191. fields = ['id', 'device_type', 'name', 'type']
  192. class ConsoleServerPortTemplateSerializer(ValidatedModelSerializer):
  193. device_type = NestedDeviceTypeSerializer()
  194. type = ChoiceField(
  195. choices=ConsolePortTypeChoices,
  196. required=False
  197. )
  198. class Meta:
  199. model = ConsoleServerPortTemplate
  200. fields = ['id', 'device_type', 'name', 'type']
  201. class PowerPortTemplateSerializer(ValidatedModelSerializer):
  202. device_type = NestedDeviceTypeSerializer()
  203. type = ChoiceField(
  204. choices=PowerPortTypeChoices,
  205. required=False
  206. )
  207. class Meta:
  208. model = PowerPortTemplate
  209. fields = ['id', 'device_type', 'name', 'type', 'maximum_draw', 'allocated_draw']
  210. class PowerOutletTemplateSerializer(ValidatedModelSerializer):
  211. device_type = NestedDeviceTypeSerializer()
  212. type = ChoiceField(
  213. choices=PowerOutletTypeChoices,
  214. required=False
  215. )
  216. power_port = PowerPortTemplateSerializer(
  217. required=False
  218. )
  219. feed_leg = ChoiceField(
  220. choices=PowerOutletFeedLegChoices,
  221. required=False,
  222. allow_null=True
  223. )
  224. class Meta:
  225. model = PowerOutletTemplate
  226. fields = ['id', 'device_type', 'name', 'type', 'power_port', 'feed_leg']
  227. class InterfaceTemplateSerializer(ValidatedModelSerializer):
  228. device_type = NestedDeviceTypeSerializer()
  229. type = ChoiceField(choices=InterfaceTypeChoices, required=False)
  230. class Meta:
  231. model = InterfaceTemplate
  232. fields = ['id', 'device_type', 'name', 'type', 'mgmt_only']
  233. class RearPortTemplateSerializer(ValidatedModelSerializer):
  234. device_type = NestedDeviceTypeSerializer()
  235. type = ChoiceField(choices=PortTypeChoices)
  236. class Meta:
  237. model = RearPortTemplate
  238. fields = ['id', 'device_type', 'name', 'type', 'positions']
  239. class FrontPortTemplateSerializer(ValidatedModelSerializer):
  240. device_type = NestedDeviceTypeSerializer()
  241. type = ChoiceField(choices=PortTypeChoices)
  242. rear_port = NestedRearPortTemplateSerializer()
  243. class Meta:
  244. model = FrontPortTemplate
  245. fields = ['id', 'device_type', 'name', 'type', 'rear_port', 'rear_port_position']
  246. class DeviceBayTemplateSerializer(ValidatedModelSerializer):
  247. device_type = NestedDeviceTypeSerializer()
  248. class Meta:
  249. model = DeviceBayTemplate
  250. fields = ['id', 'device_type', 'name']
  251. #
  252. # Devices
  253. #
  254. class DeviceRoleSerializer(ValidatedModelSerializer):
  255. device_count = serializers.IntegerField(read_only=True)
  256. virtualmachine_count = serializers.IntegerField(read_only=True)
  257. class Meta:
  258. model = DeviceRole
  259. fields = [
  260. 'id', 'name', 'slug', 'color', 'vm_role', 'description', 'device_count', 'virtualmachine_count',
  261. ]
  262. class PlatformSerializer(ValidatedModelSerializer):
  263. manufacturer = NestedManufacturerSerializer(required=False, allow_null=True)
  264. device_count = serializers.IntegerField(read_only=True)
  265. virtualmachine_count = serializers.IntegerField(read_only=True)
  266. class Meta:
  267. model = Platform
  268. fields = [
  269. 'id', 'name', 'slug', 'manufacturer', 'napalm_driver', 'napalm_args', 'device_count',
  270. 'virtualmachine_count',
  271. ]
  272. class DeviceSerializer(TaggitSerializer, CustomFieldModelSerializer):
  273. device_type = NestedDeviceTypeSerializer()
  274. device_role = NestedDeviceRoleSerializer()
  275. tenant = NestedTenantSerializer(required=False, allow_null=True)
  276. platform = NestedPlatformSerializer(required=False, allow_null=True)
  277. site = NestedSiteSerializer()
  278. rack = NestedRackSerializer(required=False, allow_null=True)
  279. face = ChoiceField(choices=DeviceFaceChoices, required=False, allow_null=True)
  280. status = ChoiceField(choices=DeviceStatusChoices, required=False)
  281. primary_ip = NestedIPAddressSerializer(read_only=True)
  282. primary_ip4 = NestedIPAddressSerializer(required=False, allow_null=True)
  283. primary_ip6 = NestedIPAddressSerializer(required=False, allow_null=True)
  284. parent_device = serializers.SerializerMethodField()
  285. cluster = NestedClusterSerializer(required=False, allow_null=True)
  286. virtual_chassis = NestedVirtualChassisSerializer(required=False, allow_null=True)
  287. tags = TagListSerializerField(required=False)
  288. class Meta:
  289. model = Device
  290. fields = [
  291. 'id', 'name', 'display_name', 'device_type', 'device_role', 'tenant', 'platform', 'serial', 'asset_tag',
  292. 'site', 'rack', 'position', 'face', 'parent_device', 'status', 'primary_ip', 'primary_ip4', 'primary_ip6',
  293. 'cluster', 'virtual_chassis', 'vc_position', 'vc_priority', 'comments', 'local_context_data', 'tags',
  294. 'custom_fields', 'created', 'last_updated',
  295. ]
  296. validators = []
  297. def validate(self, data):
  298. # Validate uniqueness of (rack, position, face) since we omitted the automatically-created validator from Meta.
  299. if data.get('rack') and data.get('position') and data.get('face'):
  300. validator = UniqueTogetherValidator(queryset=Device.objects.all(), fields=('rack', 'position', 'face'))
  301. validator.set_context(self)
  302. validator(data)
  303. # Enforce model validation
  304. super().validate(data)
  305. return data
  306. @swagger_serializer_method(serializer_or_field=NestedDeviceSerializer)
  307. def get_parent_device(self, obj):
  308. try:
  309. device_bay = obj.parent_bay
  310. except DeviceBay.DoesNotExist:
  311. return None
  312. context = {'request': self.context['request']}
  313. data = NestedDeviceSerializer(instance=device_bay.device, context=context).data
  314. data['device_bay'] = NestedDeviceBaySerializer(instance=device_bay, context=context).data
  315. return data
  316. class DeviceWithConfigContextSerializer(DeviceSerializer):
  317. config_context = serializers.SerializerMethodField()
  318. class Meta(DeviceSerializer.Meta):
  319. fields = [
  320. 'id', 'name', 'display_name', 'device_type', 'device_role', 'tenant', 'platform', 'serial', 'asset_tag',
  321. 'site', 'rack', 'position', 'face', 'parent_device', 'status', 'primary_ip', 'primary_ip4', 'primary_ip6',
  322. 'cluster', 'virtual_chassis', 'vc_position', 'vc_priority', 'comments', 'local_context_data', 'tags',
  323. 'custom_fields', 'config_context', 'created', 'last_updated',
  324. ]
  325. @swagger_serializer_method(serializer_or_field=serializers.DictField)
  326. def get_config_context(self, obj):
  327. return obj.get_config_context()
  328. class DeviceNAPALMSerializer(serializers.Serializer):
  329. method = serializers.DictField()
  330. class ConsoleServerPortSerializer(TaggitSerializer, ConnectedEndpointSerializer):
  331. device = NestedDeviceSerializer()
  332. type = ChoiceField(
  333. choices=ConsolePortTypeChoices,
  334. required=False
  335. )
  336. cable = NestedCableSerializer(read_only=True)
  337. tags = TagListSerializerField(required=False)
  338. class Meta:
  339. model = ConsoleServerPort
  340. fields = [
  341. 'id', 'device', 'name', 'type', 'description', 'connected_endpoint_type', 'connected_endpoint',
  342. 'connection_status', 'cable', 'tags',
  343. ]
  344. class ConsolePortSerializer(TaggitSerializer, ConnectedEndpointSerializer):
  345. device = NestedDeviceSerializer()
  346. type = ChoiceField(
  347. choices=ConsolePortTypeChoices,
  348. required=False
  349. )
  350. cable = NestedCableSerializer(read_only=True)
  351. tags = TagListSerializerField(required=False)
  352. class Meta:
  353. model = ConsolePort
  354. fields = [
  355. 'id', 'device', 'name', 'type', 'description', 'connected_endpoint_type', 'connected_endpoint',
  356. 'connection_status', 'cable', 'tags',
  357. ]
  358. class PowerOutletSerializer(TaggitSerializer, ConnectedEndpointSerializer):
  359. device = NestedDeviceSerializer()
  360. type = ChoiceField(
  361. choices=PowerOutletTypeChoices,
  362. required=False
  363. )
  364. power_port = NestedPowerPortSerializer(
  365. required=False
  366. )
  367. feed_leg = ChoiceField(
  368. choices=PowerOutletFeedLegChoices,
  369. required=False,
  370. allow_null=True
  371. )
  372. cable = NestedCableSerializer(
  373. read_only=True
  374. )
  375. tags = TagListSerializerField(
  376. required=False
  377. )
  378. class Meta:
  379. model = PowerOutlet
  380. fields = [
  381. 'id', 'device', 'name', 'type', 'power_port', 'feed_leg', 'description', 'connected_endpoint_type',
  382. 'connected_endpoint', 'connection_status', 'cable', 'tags',
  383. ]
  384. class PowerPortSerializer(TaggitSerializer, ConnectedEndpointSerializer):
  385. device = NestedDeviceSerializer()
  386. type = ChoiceField(
  387. choices=PowerPortTypeChoices,
  388. required=False
  389. )
  390. cable = NestedCableSerializer(read_only=True)
  391. tags = TagListSerializerField(required=False)
  392. class Meta:
  393. model = PowerPort
  394. fields = [
  395. 'id', 'device', 'name', 'type', 'maximum_draw', 'allocated_draw', 'description', 'connected_endpoint_type',
  396. 'connected_endpoint', 'connection_status', 'cable', 'tags',
  397. ]
  398. class InterfaceSerializer(TaggitSerializer, ConnectedEndpointSerializer):
  399. device = NestedDeviceSerializer()
  400. type = ChoiceField(choices=InterfaceTypeChoices, required=False)
  401. lag = NestedInterfaceSerializer(required=False, allow_null=True)
  402. mode = ChoiceField(choices=InterfaceModeChoices, required=False, allow_null=True)
  403. untagged_vlan = NestedVLANSerializer(required=False, allow_null=True)
  404. tagged_vlans = SerializedPKRelatedField(
  405. queryset=VLAN.objects.all(),
  406. serializer=NestedVLANSerializer,
  407. required=False,
  408. many=True
  409. )
  410. cable = NestedCableSerializer(read_only=True)
  411. tags = TagListSerializerField(required=False)
  412. class Meta:
  413. model = Interface
  414. fields = [
  415. 'id', 'device', 'name', 'type', 'enabled', 'lag', 'mtu', 'mac_address', 'mgmt_only', 'description',
  416. 'connected_endpoint_type', 'connected_endpoint', 'connection_status', 'cable', 'mode', 'untagged_vlan',
  417. 'tagged_vlans', 'tags', 'count_ipaddresses',
  418. ]
  419. # TODO: This validation should be handled by Interface.clean()
  420. def validate(self, data):
  421. # All associated VLANs be global or assigned to the parent device's site.
  422. device = self.instance.device if self.instance else data.get('device')
  423. untagged_vlan = data.get('untagged_vlan')
  424. if untagged_vlan and untagged_vlan.site not in [device.site, None]:
  425. raise serializers.ValidationError({
  426. 'untagged_vlan': "VLAN {} must belong to the same site as the interface's parent device, or it must be "
  427. "global.".format(untagged_vlan)
  428. })
  429. for vlan in data.get('tagged_vlans', []):
  430. if vlan.site not in [device.site, None]:
  431. raise serializers.ValidationError({
  432. 'tagged_vlans': "VLAN {} must belong to the same site as the interface's parent device, or it must "
  433. "be global.".format(vlan)
  434. })
  435. return super().validate(data)
  436. class RearPortSerializer(TaggitSerializer, ValidatedModelSerializer):
  437. device = NestedDeviceSerializer()
  438. type = ChoiceField(choices=PortTypeChoices)
  439. cable = NestedCableSerializer(read_only=True)
  440. tags = TagListSerializerField(required=False)
  441. class Meta:
  442. model = RearPort
  443. fields = ['id', 'device', 'name', 'type', 'positions', 'description', 'cable', 'tags']
  444. class FrontPortRearPortSerializer(WritableNestedSerializer):
  445. """
  446. NestedRearPortSerializer but with parent device omitted (since front and rear ports must belong to same device)
  447. """
  448. url = serializers.HyperlinkedIdentityField(view_name='dcim-api:rearport-detail')
  449. class Meta:
  450. model = RearPort
  451. fields = ['id', 'url', 'name']
  452. class FrontPortSerializer(TaggitSerializer, ValidatedModelSerializer):
  453. device = NestedDeviceSerializer()
  454. type = ChoiceField(choices=PortTypeChoices)
  455. rear_port = FrontPortRearPortSerializer()
  456. cable = NestedCableSerializer(read_only=True)
  457. tags = TagListSerializerField(required=False)
  458. class Meta:
  459. model = FrontPort
  460. fields = ['id', 'device', 'name', 'type', 'rear_port', 'rear_port_position', 'description', 'cable', 'tags']
  461. class DeviceBaySerializer(TaggitSerializer, ValidatedModelSerializer):
  462. device = NestedDeviceSerializer()
  463. installed_device = NestedDeviceSerializer(required=False, allow_null=True)
  464. tags = TagListSerializerField(required=False)
  465. class Meta:
  466. model = DeviceBay
  467. fields = ['id', 'device', 'name', 'description', 'installed_device', 'tags']
  468. #
  469. # Inventory items
  470. #
  471. class InventoryItemSerializer(TaggitSerializer, ValidatedModelSerializer):
  472. device = NestedDeviceSerializer()
  473. # Provide a default value to satisfy UniqueTogetherValidator
  474. parent = serializers.PrimaryKeyRelatedField(queryset=InventoryItem.objects.all(), allow_null=True, default=None)
  475. manufacturer = NestedManufacturerSerializer(required=False, allow_null=True, default=None)
  476. tags = TagListSerializerField(required=False)
  477. class Meta:
  478. model = InventoryItem
  479. fields = [
  480. 'id', 'device', 'parent', 'name', 'manufacturer', 'part_id', 'serial', 'asset_tag', 'discovered',
  481. 'description', 'tags',
  482. ]
  483. #
  484. # Cables
  485. #
  486. class CableSerializer(ValidatedModelSerializer):
  487. termination_a_type = ContentTypeField(
  488. queryset=ContentType.objects.filter(CABLE_TERMINATION_MODELS)
  489. )
  490. termination_b_type = ContentTypeField(
  491. queryset=ContentType.objects.filter(CABLE_TERMINATION_MODELS)
  492. )
  493. termination_a = serializers.SerializerMethodField(read_only=True)
  494. termination_b = serializers.SerializerMethodField(read_only=True)
  495. status = ChoiceField(choices=CableStatusChoices, required=False)
  496. length_unit = ChoiceField(choices=CableLengthUnitChoices, required=False, allow_null=True)
  497. class Meta:
  498. model = Cable
  499. fields = [
  500. 'id', 'termination_a_type', 'termination_a_id', 'termination_a', 'termination_b_type', 'termination_b_id',
  501. 'termination_b', 'type', 'status', 'label', 'color', 'length', 'length_unit',
  502. ]
  503. def _get_termination(self, obj, side):
  504. """
  505. Serialize a nested representation of a termination.
  506. """
  507. if side.lower() not in ['a', 'b']:
  508. raise ValueError("Termination side must be either A or B.")
  509. termination = getattr(obj, 'termination_{}'.format(side.lower()))
  510. if termination is None:
  511. return None
  512. serializer = get_serializer_for_model(termination, prefix='Nested')
  513. context = {'request': self.context['request']}
  514. data = serializer(termination, context=context).data
  515. return data
  516. @swagger_serializer_method(serializer_or_field=serializers.DictField)
  517. def get_termination_a(self, obj):
  518. return self._get_termination(obj, 'a')
  519. @swagger_serializer_method(serializer_or_field=serializers.DictField)
  520. def get_termination_b(self, obj):
  521. return self._get_termination(obj, 'b')
  522. class TracedCableSerializer(serializers.ModelSerializer):
  523. """
  524. Used only while tracing a cable path.
  525. """
  526. url = serializers.HyperlinkedIdentityField(view_name='dcim-api:cable-detail')
  527. class Meta:
  528. model = Cable
  529. fields = [
  530. 'id', 'url', 'type', 'status', 'label', 'color', 'length', 'length_unit',
  531. ]
  532. #
  533. # Interface connections
  534. #
  535. class InterfaceConnectionSerializer(ValidatedModelSerializer):
  536. interface_a = serializers.SerializerMethodField()
  537. interface_b = NestedInterfaceSerializer(source='connected_endpoint')
  538. connection_status = ChoiceField(choices=CONNECTION_STATUS_CHOICES, required=False)
  539. class Meta:
  540. model = Interface
  541. fields = ['interface_a', 'interface_b', 'connection_status']
  542. @swagger_serializer_method(serializer_or_field=NestedInterfaceSerializer)
  543. def get_interface_a(self, obj):
  544. context = {'request': self.context['request']}
  545. return NestedInterfaceSerializer(instance=obj, context=context).data
  546. #
  547. # Virtual chassis
  548. #
  549. class VirtualChassisSerializer(TaggitSerializer, ValidatedModelSerializer):
  550. master = NestedDeviceSerializer()
  551. tags = TagListSerializerField(required=False)
  552. member_count = serializers.IntegerField(read_only=True)
  553. class Meta:
  554. model = VirtualChassis
  555. fields = ['id', 'master', 'domain', 'tags', 'member_count']
  556. #
  557. # Power panels
  558. #
  559. class PowerPanelSerializer(ValidatedModelSerializer):
  560. site = NestedSiteSerializer()
  561. rack_group = NestedRackGroupSerializer(
  562. required=False,
  563. allow_null=True,
  564. default=None
  565. )
  566. powerfeed_count = serializers.IntegerField(read_only=True)
  567. class Meta:
  568. model = PowerPanel
  569. fields = ['id', 'site', 'rack_group', 'name', 'powerfeed_count']
  570. class PowerFeedSerializer(TaggitSerializer, CustomFieldModelSerializer):
  571. power_panel = NestedPowerPanelSerializer()
  572. rack = NestedRackSerializer(
  573. required=False,
  574. allow_null=True,
  575. default=None
  576. )
  577. type = ChoiceField(
  578. choices=PowerFeedTypeChoices,
  579. default=PowerFeedTypeChoices.TYPE_PRIMARY
  580. )
  581. status = ChoiceField(
  582. choices=PowerFeedStatusChoices,
  583. default=PowerFeedStatusChoices.STATUS_ACTIVE
  584. )
  585. supply = ChoiceField(
  586. choices=PowerFeedSupplyChoices,
  587. default=PowerFeedSupplyChoices.SUPPLY_AC
  588. )
  589. phase = ChoiceField(
  590. choices=PowerFeedPhaseChoices,
  591. default=PowerFeedPhaseChoices.PHASE_SINGLE
  592. )
  593. tags = TagListSerializerField(
  594. required=False
  595. )
  596. class Meta:
  597. model = PowerFeed
  598. fields = [
  599. 'id', 'power_panel', 'rack', 'name', 'status', 'type', 'supply', 'phase', 'voltage', 'amperage',
  600. 'max_utilization', 'comments', 'tags', 'custom_fields', 'created', 'last_updated',
  601. ]