Bug 2068453

Document URL: 
https://access.redhat.com/documentation/en-us/red_hat_satellite/6.10/html-single/api_guide/index#sect-API_Guide-Uploading_Content_to_the_Satellite_Server


Section Number and Name: 
5.3. Uploading Content to the Satellite Server


Describe the issue: 
The commands there have several parameters wrong/extra/missing, which makes either command wrong there.


Suggestions for improvement: 
1) In argument

--header "Accept:application/json,version=2"

the ",version=2" is superfluous and makes the request invalid. Please remove it in *all* the three curl commands.


2) In "Create the upload request.", "size" argument is (newly?) mandatory, also per apidoc. So update

--data {}

to

--data "{\"size\": 12345}"

(where 12345 is the content file size in bytes)


3) The same parameter is mandatory in "Upload your content." step also. Please add there curl option:

--data-urlencode size=12345


4) "uploads" argument is wrong:

--data "{\"uploads\":[\"0be156b1-f373-4cad-89d0-924f8f4491d2\"]}"

must be (per apidoc):

--data "{\"uploads\":[{\"id\": \"0be156b1-f373-4cad-89d0-924f8f4491d2\" }]}"

BUT two more parameters the Sat6.10 do require:

--data "{\"uploads\":[{\"id\": \"0be156b1-f373-4cad-89d0-924f8f4491d2\", \"checksum\": \"sha256sum\", \"name\": \"filename\"}]}"



Additional information: 
There is also some other (product) bug (I will refer it once filed) behind the "BUT two more parameters" bit. Please consult with the developer of the other bug if these are really mandatory or not.