Repository Membership¶

Add Repositories to a Group¶

One or more repositories can be added to an existing group. The repositories to be added are specified using a search criteria document. This call is idempotent; if a repository is already a member of the group, no changes are made and no error is raised.

Method: POST
Path: /pulp/api/v2/repo_groups/<group_id>/actions/associate/
Permission: execute
Request Body Contents: 

criteria (object) - a unit association search criteria document

Response Codes:

200 - if the associate was successfully performed
400 - if the criteria document is invalid
404 - if the group cannot be found

Return: array of repository IDs for all repositories in the group

Sample Request:

{
 "criteria": {
   "filters": {
     "id": {"$in": ["dest-1", "dest-2"]}
   }
 }
}

Sample 200 Response Body:

["dest-2", "dest-1"]

Remove Repositories from a Group¶

In the same fashion as adding repositories to a group, repositories to remove are specified through a search criteria document. The repositories themselves are unaffected; this call simply removes the association to the given group.

Path: /pulp/api/v2/repo_groups/<group_id>/actions/unassociate/
Permission: execute
Request Body Contents: 

criteria (object) - a unit association search criteria document

Response Codes:

200 - if the removal was successfully performed
400 - if the criteria document is invalid
404 - if the group cannot be found

Return: array of repository IDs for all repositories in the group

Sample Request:

{
 "criteria": {
   "filters": {
     "id": "dest-1"
   }
 }
}

Sample 200 Response Body:

["dest-2", "dest-1"]