Bug 752803

Summary: API Documentation Repositories: Unclear which fields are editable after initializing a repository
Product: [Retired] Pulp Reporter: Peter Meier <peter.meier>
Component: documentationAssignee: Jason Connor <jconnor>
Status: CLOSED CURRENTRELEASE QA Contact: Preethi Thomas <pthomas>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 1.0.0CC: mmccune, skarmark
Target Milestone: ---Keywords: Triaged
Target Release: Sprint 30   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Peter Meier 2011-11-10 13:12:55 UTC 
Description of problem:

The API documentation is unclear about what kind of fields are editable, once the repository have been created.

https://fedorahosted.org/pulp/wiki/UGREST-Repositories#UpdateARepository mentions that "parameters: any field of a Repo object except id " can be passed and which are editable.

However, testing in reality (and reading the API code) shows that only a small subset of fields can actually be updated. To my knowledge, only

arch, name, sync_schedule

can be directly be updated.

While the feed_url/feed_type can be updated via the feed param, feed_(cert|ca|key) via feed_cert_data dictionary and the same for consumer_(cert|ca|key) via consumer_cert_data.

The API documentation should be more explicit about which fields can be updated and which special parameters can be used to update a set of fields.
Comment 1 Jason Connor 2011-12-13 01:48:02 UTC 
updated the wiki docs in code, re-ran restapi.py, and published new repositories rest api page
fix pushed in: 1d2ec8c80f27f228cabc8a017c57132356dba239
Comment 2 Jeff Ortel 2011-12-15 20:18:03 UTC 
build: 0.255
Comment 3 Preethi Thomas 2012-01-04 16:32:46 UTC 
verified
https://fedorahosted.org/pulp/wiki/UGREST-Repositories#UpdateARepository
Comment 4 Preethi Thomas 2012-02-24 20:17:25 UTC 
Pulp v1.0 is released
Closed Current Release.
Comment 5 Preethi Thomas 2012-02-24 20:18:27 UTC 
Pulp v1.0 is released.