add suboptions in ovirt docs (#53934)

* add suboptions in doc_fragments/ovirt

* update ovirt doc fragment module docs

* add ovirt docs_fragment to BOTMETA.yml
This commit is contained in:
Martin Nečas 2019-03-25 16:43:08 +01:00 committed by Alicia Cozine
parent 5ff1ce28d4
commit 0f199ef58a
2 changed files with 51 additions and 19 deletions

2
.github/BOTMETA.yml vendored
View file

@ -1096,6 +1096,8 @@ files:
$plugins/doc_fragments/proxysql.py: *mysql
$plugins/doc_fragments/ucs.py: *ucs
$plugins/doc_fragments/vultr.py: *vultr
$plugins/doc_fragments/ovirt.py: *ovirt
$plugins/doc_fragments/ovirt_facts.py: *ovirt
$plugins/doc_fragments/xenserver.py:
maintainers: bvitnik
$plugins/doc_fragments/hpe3par.py: *hpe3par

View file

@ -30,25 +30,55 @@ options:
auth:
description:
- "Dictionary with values needed to create HTTP/HTTPS connection to oVirt:"
- C(username)[I(required)] - The name of the user, something like I(admin@internal).
Default value is set by I(OVIRT_USERNAME) environment variable.
- "C(password)[I(required)] - The password of the user. Default value is set by I(OVIRT_PASSWORD) environment variable."
- "C(url) - A string containing the API URL of the server, usually
something like `I(https://server.example.com/ovirt-engine/api)`. Default value is set by I(OVIRT_URL) environment variable.
Either C(url) or C(hostname) is required."
- "C(hostname) - A string containing the hostname of the server, usually
something like `I(server.example.com)`. Default value is set by I(OVIRT_HOSTNAME) environment variable.
Either C(url) or C(hostname) is required."
- "C(token) - Token to be used instead of login with username/password. Default value is set by I(OVIRT_TOKEN) environment variable."
- "C(insecure) - A boolean flag that indicates if the server TLS
certificate and host name should be checked."
- "C(ca_file) - A PEM file containing the trusted CA certificates. The
certificate presented by the server will be verified using these CA
certificates. If `C(ca_file)` parameter is not set, system wide
CA certificate store is used. Default value is set by I(OVIRT_CAFILE) environment variable."
- "C(kerberos) - A boolean flag indicating if Kerberos authentication
should be used instead of the default basic authentication."
- "C(headers) - Dictionary of HTTP headers to be added to each API call."
suboptions:
username:
description:
- The name of the user, something like I(admin@internal).
- Default value is set by C(OVIRT_USERNAME) environment variable.
type: str
required: true
password:
description:
- The password of the user.
- Default value is set by C(OVIRT_PASSWORD) environment variable.
type: str
required: true
url:
description:
- A string containing the API URL of the server, usually something like `I(https://server.example.com/ovirt-engine/api)`.
- Default value is set by C(OVIRT_URL) environment variable.
- Either C(url) or C(hostname) is required.
type: str
hostname:
description:
- A string containing the hostname of the server, usually something like `I(server.example.com)`.
- Default value is set by C(OVIRT_HOSTNAME) environment variable.
- Either C(url) or C(hostname) is required.
type: str
token:
description:
- Token to be used instead of login with username/password.
- Default value is set by C(OVIRT_TOKEN) environment variable.
type: str
insecure:
description:
- A boolean flag that indicates if the server TLS certificate and host name should be checked.
type: bool
ca_file:
description:
- A PEM file containing the trusted CA certificates.
- The certificate presented by the server will be verified using these CA certificates.
- If C(ca_file) parameter is not set, system wide CA certificate store is used.
- Default value is set by C(OVIRT_CAFILE) environment variable.
type: str
kerberos:
description:
- A boolean flag indicating if Kerberos authentication should be used instead of the default basic authentication.
type: bool
headers:
description:
- Dictionary of HTTP headers to be added to each API call.
type: dict
type: dict
required: true
timeout: