PaloAltoNetworks / PaloAltoNetworks/pan.dev

Issue/Help with "Initiate a Configuration Upload"

Open Beginner friendly
#1,327 4 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

documentation
Dominant language
MDX
Stars
78
Forks
88
Avg merge
5d 17h
Merged PRs (30d)
18

Description

Documentation link

https://pan.dev/scm/api/config/posture-management/initiate-config-upload/

Describe the problem

  • Documentation specifies Content-Type: plain/text, but recently now expects Content-Type: text/plain
  • Documentation specifies Content-Encoding: gzip, but recently now requires an unzipped .xml file. The endpoint still requires the Content-Encoding: gzip header despite gzip files resulting in processing failed.

Suggested fix

  • Update documentation accordingly to Content-type: text/plain
  • Remove Content-Encoding: gzip requirement on the endpoint and update documents accordingly.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the linked “Initiate a Configuration Upload” documentation page and compare its Content-Type and Content-Encoding requirements with the behavior described in the issue. Update the page so the documented headers and XML upload requirements match the endpoint’s current expectations, then verify the resulting instructions are internally consistent.

Written by the indexing model from the issue text.

Assessment

Domain
api, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
68/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.