mirror of
https://github.com/ansible-collections/community.general.git
synced 2025-04-24 19:31:26 -07:00
a4ae8536d9
* Add NetworkSetFactsModule for retrieving HPE OneView Network Sets - Allow querying for Network Set resources in HPE OneView - Adds unit tests to new module - Updates oneview_module_loader copyright header to short GPL3 version * Adding possibility to pass in credentials as parameters * Removed required false and changed format of filter_by_name declaration * Updated examples in docs to reflect new way to pass in credentials - All examples of the oneview_network_set_facts updated to use credential parameters - All required=False from oneview base module removed - Shared docs updated to bring attention to API version being used
66 lines
2.8 KiB
Python
66 lines
2.8 KiB
Python
# -*- coding: utf-8 -*-
|
|
#
|
|
# Copyright (2016-2017) Hewlett Packard Enterprise Development LP
|
|
#
|
|
# This program is free software: you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License as published by
|
|
# the Free Software Foundation, either version 3 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# This program is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
|
|
class ModuleDocFragment(object):
|
|
|
|
# OneView doc fragment
|
|
DOCUMENTATION = '''
|
|
options:
|
|
config:
|
|
description:
|
|
- Path to a .json configuration file containing the OneView client configuration.
|
|
The configuration file is optional and when used should be present in the host running the ansible commands.
|
|
If the file path is not provided, the configuration will be loaded from environment variables.
|
|
For links to example configuration files or how to use the environment variables verify the notes section.
|
|
|
|
requirements:
|
|
- python >= 2.7.9
|
|
|
|
notes:
|
|
- "A sample configuration file for the config parameter can be found at:
|
|
U(https://github.com/HewlettPackard/oneview-ansible/blob/master/examples/oneview_config-rename.json)"
|
|
- "Check how to use environment variables for configuration at:
|
|
U(https://github.com/HewlettPackard/oneview-ansible#environment-variables)"
|
|
- "Additional Playbooks for the HPE OneView Ansible modules can be found at:
|
|
U(https://github.com/HewlettPackard/oneview-ansible/tree/master/examples)"
|
|
- "The OneView API version used will directly affect returned and expected fields in resources.
|
|
Information on setting the desired API version and can be found at:
|
|
U(https://github.com/HewlettPackard/oneview-ansible#setting-your-oneview-version)"
|
|
'''
|
|
|
|
VALIDATEETAG = '''
|
|
options:
|
|
validate_etag:
|
|
description:
|
|
- When the ETag Validation is enabled, the request will be conditionally processed only if the current ETag
|
|
for the resource matches the ETag provided in the data.
|
|
default: true
|
|
choices: ['true', 'false']
|
|
'''
|
|
|
|
FACTSPARAMS = '''
|
|
options:
|
|
params:
|
|
description:
|
|
- List of params to delimit, filter and sort the list of resources.
|
|
- "params allowed:
|
|
- C(start): The first item to return, using 0-based indexing.
|
|
- C(count): The number of resources to return.
|
|
- C(filter): A general filter/query string to narrow the list of items returned.
|
|
- C(sort): The sort order of the returned data set."
|
|
'''
|