Saltstack module http 详解

Posted 2021-03-03 randomlee

http.query

New in version 2015.5.0

Query a resource, and decode the return data

Passes through all the parameters described in the
:py:func:`utils.http.query function <salt.utils.http.query>`:

.. autofunction:: salt.utils.http.query

raise_error : True
    If ``False``, and if a connection cannot be made, the error will be
    suppressed and the body of the return will simply be ``None``.

CLI Example:

    salt ‘*‘ http.query http://somelink.com/
    salt ‘*‘ http.query http://somelink.com/ method=POST             params=‘key1=val1&key2=val2‘
    salt ‘*‘ http.query http://somelink.com/ method=POST             data=‘<xml>somecontent</xml>‘

http.wait_for_successful_query

Query a resource until a successful response, and decode the return data

CLI Example:

    salt ‘*‘ http.wait_for_successful_query http://somelink.com/ wait_for=160 request_interval=1

http.update_ca_bundle

Update the local CA bundle file from a URL

New in version 2015.5.0

CLI Example:

    salt ‘*‘ http.update_ca_bundle
    salt ‘*‘ http.update_ca_bundle target=/path/to/cacerts.pem
    salt ‘*‘ http.update_ca_bundle source=https://example.com/cacerts.pem

If the ``target`` is not specified, it will be pulled from the ``ca_cert``
configuration variable available to the minion. If it cannot be found there,
it will be placed at ``<<FILE_ROOTS>>/cacerts.pem``.

If the ``source`` is not specified, it will be pulled from the
``ca_cert_url`` configuration variable available to the minion. If it cannot
be found, it will be downloaded from the cURL website, using an http (not
https) URL. USING THE DEFAULT URL SHOULD BE AVOIDED!

``merge_files`` may also be specified, which includes a string or list of
strings representing a file or files to be appended to the end of the CA
bundle, once it is downloaded.

CLI Example:

    salt ‘*‘ http.update_ca_bundle merge_files=/path/to/mycert.pem