Implement named URL feature.

awx/api/generics.py

@@ -257,6 +257,7 @@ class GenericAPIView(generics.GenericAPIView, APIView):
                 })
             d['serializer_fields'] = self.metadata_class().get_serializer_info(self.get_serializer())
         d['settings'] = settings
+        d['has_named_url'] = self.model in settings.NAMED_URL_GRAPH
         return d
 
 

awx/api/serializers.py

@@ -287,8 +287,21 @@ class BaseSerializer(serializers.ModelSerializer):
     def _get_related(self, obj):
         return {} if obj is None else self.get_related(obj)
 
+    def _generate_named_url(self, url_path, obj, node):
+        url_units = url_path.split('/')
+        named_url = node.generate_named_url(obj)
+        url_units[4] = named_url
+        return '/'.join(url_units)
+
     def get_related(self, obj):
         res = OrderedDict()
+        view = self.context.get('view', None)
+        if view and hasattr(view, 'retrieve') and type(obj) in settings.NAMED_URL_GRAPH:
+            original_url = self.get_url(obj)
+            if not original_url.startswith('/api/v1'):
+                res['named_url'] = self._generate_named_url(
+                    original_url, obj, settings.NAMED_URL_GRAPH[type(obj)]
+                )
         if getattr(obj, 'created_by', None):
             res['created_by'] = self.reverse('api:user_detail', kwargs={'pk': obj.created_by.pk})
         if getattr(obj, 'modified_by', None):

awx/api/templates/api/retrieve_api_view.md

@@ -1,3 +1,7 @@
+{% if has_named_url %}
+### Note: starting from api v2, this resource object can be accessed via its named URL.
+{% endif %}
+
 # Retrieve {{ model_verbose_name|title }}:
 
 Make GET request to this resource to retrieve a single {{ model_verbose_name }}
@@ -6,4 +10,3 @@ record containing the following fields:
 {% include "api/_result_fields_common.md" %}
 
 {% include "api/_new_in_awx.md" %}
-

awx/api/templates/api/retrieve_destroy_api_view.md

@@ -1,3 +1,7 @@
+{% if has_named_url %}
+### Note: starting from api v2, this resource object can be accessed via its named URL.
+{% endif %}
+
 # Retrieve {{ model_verbose_name|title }}:
 
 Make GET request to this resource to retrieve a single {{ model_verbose_name }}

awx/api/templates/api/retrieve_update_api_view.md

@@ -1,3 +1,7 @@
+{% if has_named_url %}
+### Note: starting from api v2, this resource object can be accessed via its named URL.
+{% endif %}
+
 # Retrieve {{ model_verbose_name|title }}:
 
 Make GET request to this resource to retrieve a single {{ model_verbose_name }}

awx/api/templates/api/retrieve_update_destroy_api_view.md

@@ -1,3 +1,7 @@
+{% if has_named_url %}
+### Note: starting from api v2, this resource object can be accessed via its named URL.
+{% endif %}
+
 # Retrieve {{ model_verbose_name|title }}:
 
 Make GET request to this resource to retrieve a single {{ model_verbose_name }}