Maintenance: Planio will be observing a scheduled maintenance window this Tuesday, November 5, 2024 from 03:00 UTC until 06:30 UTC to perform urgent network maintenance in our primary data center. Your Planio account will be unavailable during this maintenance window.
Story #5344
Updated by dalley about 5 years ago
Problem Statement: API design for copy and upload has thus far been somewhat haphazard and it would be useful to make it more consistent. Additionally there are some deficiencies in some of the current APIs that need to be addressed. For example, the copy API currently looks something like this <pre> POST /pulp/api/v3/rpm/copy/ types=['package', 'modulemd'] </pre> The problem with this API is that it will be difficult to make it play nicely with filtering, which has yet to be implemented. The filtering use case is essentially "copy units for which metadata matches these filters, e.g. name=walrus and version>1.1.0". However, because different unit types have different metadata fields, allowing the user to specify filters while also allowing more than one type of content to be copied at once would be problematic because there's no good way to determine what filters should apply to what content types. Possibly it could be done, but it would probably not be a good idea. Therefore it is best that the "types" parameter be removed entirely. Sidenote: In various discussions we've mentioned the utility (and possibly necessity) of being able to have a group of tasks that are atomic and transactional together. Something like this could be applied here in order to replace this functionality (however, it is out of scope for this Story). There are 2 different alternative APIs I would like Because we're currently specifying the type to propose: 1. The same API, but with a single type be copied at a time. If "all" is specified as via the type, it types parameter, we would copy everything. This would IMO cover the most important use cases. <pre> POST /pulp/api/v3/rpm/copy/ type='package' </pre> Pros: - More flexible, more similar therefore need to the Pulp 2 API Cons: - Dissimilar switch to having the other API's in Pulp 3 - "type" is going to be the name of a field on the RPM content itself (inherited from core, formerly _type) 2. Make the type to be copied part of the name of the endpoint itself, like so: <pre> POST /pulp/api/v3/rpm/package/copy/ </pre> Pros: - Consistent with other Pulp 3 APIs Cons: - Not as flexible, no way to copy all units at once via this API