Add NoArtifactContentViewSet

CHANGES/plugin_api/5086.feature

@@ -0,0 +1 @@
+Added NoArtifactContentViewSet for content creation that does not require a file to be uploaded.

pulpcore/plugin/viewsets/__init__.py

@@ -44,6 +44,7 @@
 from pulpcore.filters import HyperlinkRelatedFilter
 
 from .content import (
+    NoArtifactContentViewSet,
     NoArtifactContentUploadViewSet,
     SingleArtifactContentUploadViewSet,
 )

pulpcore/plugin/viewsets/content.py

@@ -29,6 +29,35 @@ def get_deferred_context(self, request):
         return {}
 
 
+class NoArtifactContentViewSet(DefaultDeferredContextMixin, ContentViewSet):
+    """A ViewSet for content creation that does not require a file to be uploaded."""
+
+    @extend_schema(
+        description="Trigger an asynchronous task to create content,"
+        "optionally create new repository version.",
+        responses={202: AsyncOperationResponseSerializer},
+    )
+    def create(self, request):
+        """Create a content unit."""
+        serializer = self.get_serializer(data=request.data)
+        serializer.is_valid(raise_exception=True)
+
+        exclusive_resources = [
+            item for item in (serializer.validated_data.get(key) for key in ("repository",)) if item
+        ]
+
+        task = dispatch(
+            tasks.base.general_create,
+            exclusive_resources=exclusive_resources,
+            args=(self.queryset.model._meta.app_label, serializer.__class__.__name__),
+            kwargs={
+                "data": {k: v for k, v in request.data.items()},
+                "context": self.get_deferred_context(request),
+            },
+        )
+        return OperationPostponedResponse(task, request)
+
+
 class NoArtifactContentUploadViewSet(DefaultDeferredContextMixin, ContentViewSet):
     """A ViewSet for uploads that do not require to store an uploaded content as an Artifact."""
 

staging_docs/dev/learn/triage-needed!/concepts/subclassing/viewsets.md

@@ -125,6 +125,11 @@ ViewSet, the associated serializer should also subclass `NoArtifactContentUpload
 that by using the aforesaid Serializer and ViewSet, Pulp still loads content of an uploaded file to
 a temporary file. But the file is going to be removed by the end of a created task.
 
+If creating the content does not require any files to be uploaded at all, you can use
+`NoArtifactContentViewSet` along with `NoArtifactContentSerializer`. This is useful if creating the
+content in question requires only a set of required API parameters, but should still use the same
+"add to repository" and/or `retrieve` workflows.
+
 If any additional context needs to be passed from the ViewSet to the creation task, the
 `get_deferred_context` method of the ViewSet might be overwritten. It's return value will then be
 available as `self.context` in the Serializer.