ansible-core 2.15.4rc1__py3-none-any.whl → 2.16.0b2__py3-none-any.whl

ansible/modules/yum.py

@@ -21,9 +21,9 @@ description:
 options:
   use_backend:
     description:
-      - This module supports C(yum) (as it always has), this is known as C(yum3)/C(YUM3)/C(yum-deprecated) by
+      - This module supports V(yum) (as it always has), this is known as C(yum3)/C(YUM3)/C(yum-deprecated) by
         upstream yum developers. As of Ansible 2.7+, this module also supports C(YUM4), which is the
-        "new yum" and it has an C(dnf) backend. As of ansible-core 2.15+, this module will auto select the backend
+        "new yum" and it has an V(dnf) backend. As of ansible-core 2.15+, this module will auto select the backend
         based on the C(ansible_pkg_mgr) fact.
       - By default, this module will select the backend based on the C(ansible_pkg_mgr) fact.
     default: "auto"
@@ -32,12 +32,12 @@ options:
     version_added: "2.7"
   name:
     description:
-      - A package name or package specifier with version, like C(name-1.0).
-      - Comparison operators for package version are valid here C(>), C(<), C(>=), C(<=). Example - C(name>=1.0)
-      - If a previous version is specified, the task also needs to turn C(allow_downgrade) on.
-        See the C(allow_downgrade) documentation for caveats with downgrading packages.
-      - When using state=latest, this can be C('*') which means run C(yum -y update).
-      - You can also pass a url or a local path to a rpm file (using state=present).
+      - A package name or package specifier with version, like V(name-1.0).
+      - Comparison operators for package version are valid here C(>), C(<), C(>=), C(<=). Example - V(name>=1.0)
+      - If a previous version is specified, the task also needs to turn O(allow_downgrade) on.
+        See the O(allow_downgrade) documentation for caveats with downgrading packages.
+      - When using O(state=latest), this can be V('*') which means run C(yum -y update).
+      - You can also pass a url or a local path to an rpm file (using O(state=present)).
         To operate on several packages this can accept a comma separated string of packages or (as of 2.0) a list of packages.
     aliases: [ pkg ]
     type: list
@@ -53,17 +53,17 @@ options:
   list:
     description:
       - "Package name to run the equivalent of C(yum list --show-duplicates <package>) against. In addition to listing packages,
-        use can also list the following: C(installed), C(updates), C(available) and C(repos)."
-      - This parameter is mutually exclusive with I(name).
+        use can also list the following: V(installed), V(updates), V(available) and V(repos)."
+      - This parameter is mutually exclusive with O(name).
     type: str
   state:
     description:
-      - Whether to install (C(present) or C(installed), C(latest)), or remove (C(absent) or C(removed)) a package.
-      - C(present) and C(installed) will simply ensure that a desired package is installed.
-      - C(latest) will update the specified package if it's not of the latest available version.
-      - C(absent) and C(removed) will remove the specified package.
-      - Default is C(None), however in effect the default action is C(present) unless the C(autoremove) option is
-        enabled for this module, then C(absent) is inferred.
+      - Whether to install (V(present) or V(installed), V(latest)), or remove (V(absent) or V(removed)) a package.
+      - V(present) and V(installed) will simply ensure that a desired package is installed.
+      - V(latest) will update the specified package if it's not of the latest available version.
+      - V(absent) and V(removed) will remove the specified package.
+      - Default is V(None), however in effect the default action is V(present) unless the O(autoremove) option is
+        enabled for this module, then V(absent) is inferred.
     type: str
     choices: [ absent, installed, latest, present, removed ]
   enablerepo:
@@ -96,7 +96,7 @@ options:
   disable_gpg_check:
     description:
       - Whether to disable the GPG checking of signatures of packages being
-        installed. Has an effect only if state is I(present) or I(latest).
+        installed. Has an effect only if O(state) is V(present) or V(latest).
     type: bool
     default: "no"
     version_added: "1.2"
@@ -110,30 +110,30 @@ options:
   update_cache:
     description:
       - Force yum to check if cache is out of date and redownload if needed.
-        Has an effect only if state is I(present) or I(latest).
+        Has an effect only if O(state) is V(present) or V(latest).
     type: bool
     default: "no"
     aliases: [ expire-cache ]
     version_added: "1.9"
   validate_certs:
     description:
-      - This only applies if using a https url as the source of the rpm. e.g. for localinstall. If set to C(false), the SSL certificates will not be validated.
-      - This should only set to C(false) used on personally controlled sites using self-signed certificates as it avoids verifying the source site.
-      - Prior to 2.1 the code worked as if this was set to C(true).
+      - This only applies if using a https url as the source of the rpm. e.g. for localinstall. If set to V(false), the SSL certificates will not be validated.
+      - This should only set to V(false) used on personally controlled sites using self-signed certificates as it avoids verifying the source site.
+      - Prior to 2.1 the code worked as if this was set to V(true).
     type: bool
     default: "yes"
     version_added: "2.1"
   sslverify:
     description:
       - Disables SSL validation of the repository server for this transaction.
-      - This should be set to C(false) if one of the configured repositories is using an untrusted or self-signed certificate.
+      - This should be set to V(false) if one of the configured repositories is using an untrusted or self-signed certificate.
     type: bool
     default: "yes"
     version_added: "2.13"
   update_only:
     description:
       - When using latest, only update installed packages. Do not install packages.
-      - Has an effect only if state is I(latest)
+      - Has an effect only if O(state) is V(latest)
     default: "no"
     type: bool
     version_added: "2.5"
@@ -147,13 +147,13 @@ options:
     version_added: "2.3"
   security:
     description:
-      - If set to C(true), and C(state=latest) then only installs updates that have been marked security related.
+      - If set to V(true), and O(state=latest) then only installs updates that have been marked security related.
     type: bool
     default: "no"
     version_added: "2.4"
   bugfix:
     description:
-      - If set to C(true), and C(state=latest) then only installs updates that have been marked bugfix related.
+      - If set to V(true), and O(state=latest) then only installs updates that have been marked bugfix related.
     default: "no"
     type: bool
     version_added: "2.6"
@@ -194,9 +194,9 @@ options:
     version_added: "2.7"
   autoremove:
     description:
-      - If C(true), removes all "leaf" packages from the system that were originally
+      - If V(true), removes all "leaf" packages from the system that were originally
         installed as dependencies of user-installed packages but which are no longer
-        required by any such package. Should be used alone or when state is I(absent)
+        required by any such package. Should be used alone or when O(state) is V(absent)
       - "NOTE: This feature requires yum >= 3.4.3 (RHEL/CentOS 7+)"
     type: bool
     default: "no"
@@ -204,9 +204,9 @@ options:
   disable_excludes:
     description:
       - Disable the excludes defined in YUM config files.
-      - If set to C(all), disables all excludes.
-      - If set to C(main), disable excludes defined in [main] in yum.conf.
-      - If set to C(repoid), disable excludes defined for given repo id.
+      - If set to V(all), disables all excludes.
+      - If set to V(main), disable excludes defined in [main] in yum.conf.
+      - If set to V(repoid), disable excludes defined for given repo id.
     type: str
     version_added: "2.7"
   download_only:
@@ -232,7 +232,7 @@ options:
   download_dir:
     description:
       - Specifies an alternate directory to store packages.
-      - Has an effect only if I(download_only) is specified.
+      - Has an effect only if O(download_only) is specified.
     type: str
     version_added: "2.8"
   install_repoquery:
@@ -274,7 +274,7 @@ attributes:
         platforms: rhel
 notes:
   - When used with a C(loop:) each package will be processed individually,
-    it is much more efficient to pass the list directly to the I(name) option.
+    it is much more efficient to pass the list directly to the O(name) option.
   - In versions prior to 1.9.2 this module installed and removed each package
     given to the yum module separately. This caused problems when packages
     specified by filename or url had to be installed or removed together. In
@@ -408,7 +408,7 @@ EXAMPLES = '''
 from ansible.module_utils.basic import AnsibleModule
 from ansible.module_utils.common.locale import get_best_parsable_locale
 from ansible.module_utils.common.respawn import has_respawned, respawn_module
-from ansible.module_utils._text import to_native, to_text
+from ansible.module_utils.common.text.converters import to_native, to_text
 from ansible.module_utils.yumdnf import YumDnf, yumdnf_argument_spec
 
 import errno
@@ -618,7 +618,7 @@ class YumModule(YumDnf):
         if not repoq:
             pkgs = []
             try:
-                e, m, _ = self.yum_base.rpmdb.matchPackageNames([pkgspec])
+                e, m, dummy = self.yum_base.rpmdb.matchPackageNames([pkgspec])
                 pkgs = e + m
                 if not pkgs and not is_pkg:
                     pkgs.extend(self.yum_base.returnInstalledPackagesByDep(pkgspec))
@@ -670,7 +670,7 @@ class YumModule(YumDnf):
 
             pkgs = []
             try:
-                e, m, _ = self.yum_base.pkgSack.matchPackageNames([pkgspec])
+                e, m, dummy = self.yum_base.pkgSack.matchPackageNames([pkgspec])
                 pkgs = e + m
                 if not pkgs:
                     pkgs.extend(self.yum_base.returnPackagesByDep(pkgspec))
@@ -710,7 +710,7 @@ class YumModule(YumDnf):
                 pkgs = self.yum_base.returnPackagesByDep(pkgspec) + \
                     self.yum_base.returnInstalledPackagesByDep(pkgspec)
                 if not pkgs:
-                    e, m, _ = self.yum_base.pkgSack.matchPackageNames([pkgspec])
+                    e, m, dummy = self.yum_base.pkgSack.matchPackageNames([pkgspec])
                     pkgs = e + m
                 updates = self.yum_base.doPackageLists(pkgnarrow='updates').updates
             except Exception as e:
@@ -928,7 +928,7 @@ class YumModule(YumDnf):
         cmd = repoq + ["--qf", qf, "-a"]
         if self.releasever:
             cmd.extend(['--releasever=%s' % self.releasever])
-        rc, out, _ = self.module.run_command(cmd)
+        rc, out, err = self.module.run_command(cmd)
         if rc == 0:
             return set(p for p in out.split('\n') if p.strip())
         else:
@@ -1419,7 +1419,7 @@ class YumModule(YumDnf):
                     # this contains the full NVR and spec could contain wildcards
                     # or virtual provides (like "python-*" or "smtp-daemon") while
                     # updates contains name only.
-                    pkgname, _, _, _, _ = splitFilename(pkg)
+                    (pkgname, ver, rel, epoch, arch) = splitFilename(pkg)
                     if spec in pkgs['update'] and pkgname in updates:
                         nothing_to_do = False
                         will_update.add(spec)

ansible/modules/yum_repository.py

@@ -21,9 +21,9 @@ description:
 options:
   async:
     description:
-      - If set to C(true) Yum will download packages and metadata from this
+      - If set to V(true) Yum will download packages and metadata from this
         repo in parallel, if possible.
-      - In ansible-core 2.11, 2.12, and 2.13 the default value is C(true).
+      - In ansible-core 2.11, 2.12, and 2.13 the default value is V(true).
       - This option has been deprecated in RHEL 8. If you're using one of the
         versions listed above, you can set this option to None to avoid passing an
         unknown configuration option.
@@ -31,20 +31,19 @@ options:
   bandwidth:
     description:
       - Maximum available network bandwidth in bytes/second. Used with the
-        I(throttle) option.
-      - If I(throttle) is a percentage and bandwidth is C(0) then bandwidth
-        throttling will be disabled. If I(throttle) is expressed as a data rate
-        (bytes/sec) then this option is ignored. Default is C(0) (no bandwidth
+        O(throttle) option.
+      - If O(throttle) is a percentage and bandwidth is V(0) then bandwidth
+        throttling will be disabled. If O(throttle) is expressed as a data rate
+        (bytes/sec) then this option is ignored. Default is V(0) (no bandwidth
         throttling).
     type: str
-    default: '0'
   baseurl:
     description:
       - URL to the directory where the yum repository's 'repodata' directory
         lives.
       - It can also be a list of multiple URLs.
-      - This, the I(metalink) or I(mirrorlist) parameters are required if I(state) is set to
-        C(present).
+      - This, the O(metalink) or O(mirrorlist) parameters are required if O(state) is set to
+        V(present).
     type: list
     elements: str
   cost:
@@ -52,61 +51,57 @@ options:
       - Relative cost of accessing this repository. Useful for weighing one
         repo's packages as greater/less than any other.
     type: str
-    default: '1000'
   deltarpm_metadata_percentage:
     description:
       - When the relative size of deltarpm metadata vs pkgs is larger than
         this, deltarpm metadata is not downloaded from the repo. Note that you
-        can give values over C(100), so C(200) means that the metadata is
-        required to be half the size of the packages. Use C(0) to turn off
+        can give values over V(100), so V(200) means that the metadata is
+        required to be half the size of the packages. Use V(0) to turn off
         this check, and always download metadata.
     type: str
-    default: '100'
   deltarpm_percentage:
     description:
       - When the relative size of delta vs pkg is larger than this, delta is
-        not used. Use C(0) to turn off delta rpm processing. Local repositories
-        (with file:// I(baseurl)) have delta rpms turned off by default.
+        not used. Use V(0) to turn off delta rpm processing. Local repositories
+        (with file://O(baseurl)) have delta rpms turned off by default.
     type: str
-    default: '75'
   description:
     description:
       - A human readable string describing the repository. This option corresponds to the "name" property in the repo file.
-      - This parameter is only required if I(state) is set to C(present).
+      - This parameter is only required if O(state) is set to V(present).
     type: str
   enabled:
     description:
       - This tells yum whether or not use this repository.
-      - Yum default value is C(true).
+      - Yum default value is V(true).
     type: bool
   enablegroups:
     description:
       - Determines whether yum will allow the use of package groups for this
         repository.
-      - Yum default value is C(true).
+      - Yum default value is V(true).
     type: bool
   exclude:
     description:
       - List of packages to exclude from updates or installs. This should be a
-        space separated list. Shell globs using wildcards (eg. C(*) and C(?))
+        space separated list. Shell globs using wildcards (for example V(*) and V(?))
         are allowed.
       - The list can also be a regular YAML array.
     type: list
     elements: str
   failovermethod:
     choices: [roundrobin, priority]
-    default: roundrobin
     description:
-      - C(roundrobin) randomly selects a URL out of the list of URLs to start
+      - V(roundrobin) randomly selects a URL out of the list of URLs to start
         with and proceeds through each of them as it encounters a failure
         contacting the host.
-      - C(priority) starts from the first I(baseurl) listed and reads through
+      - V(priority) starts from the first O(baseurl) listed and reads through
         them sequentially.
     type: str
   file:
     description:
       - File name without the C(.repo) extension to save the repo in. Defaults
-        to the value of I(name).
+        to the value of O(name).
     type: str
   gpgcakey:
     description:
@@ -117,7 +112,7 @@ options:
       - Tells yum whether or not it should perform a GPG signature check on
         packages.
       - No default setting. If the value is not set, the system setting from
-        C(/etc/yum.conf) or system default of C(false) will be used.
+        C(/etc/yum.conf) or system default of V(false) will be used.
     type: bool
   gpgkey:
     description:
@@ -128,32 +123,31 @@ options:
   module_hotfixes:
     description:
       - Disable module RPM filtering and make all RPMs from the repository
-        available. The default is C(None).
+        available. The default is V(None).
     version_added: '2.11'
     type: bool
   http_caching:
     description:
       - Determines how upstream HTTP caches are instructed to handle any HTTP
         downloads that Yum does.
-      - C(all) means that all HTTP downloads should be cached.
-      - C(packages) means that only RPM package downloads should be cached (but
+      - V(all) means that all HTTP downloads should be cached.
+      - V(packages) means that only RPM package downloads should be cached (but
          not repository metadata downloads).
-      - C(none) means that no HTTP downloads should be cached.
+      - V(none) means that no HTTP downloads should be cached.
     choices: [all, packages, none]
     type: str
-    default: all
   include:
     description:
       - Include external configuration file. Both, local path and URL is
         supported. Configuration file will be inserted at the position of the
-        I(include=) line. Included files may contain further include lines.
+        C(include=) line. Included files may contain further include lines.
         Yum will abort with an error if an inclusion loop is detected.
     type: str
   includepkgs:
     description:
       - List of packages you want to only use from a repository. This should be
-        a space separated list. Shell globs using wildcards (eg. C(*) and C(?))
-        are allowed. Substitution variables (e.g. C($releasever)) are honored
+        a space separated list. Shell globs using wildcards (for example V(*) and V(?))
+        are allowed. Substitution variables (for example V($releasever)) are honored
         here.
       - The list can also be a regular YAML array.
     type: list
@@ -161,65 +155,61 @@ options:
   ip_resolve:
     description:
       - Determines how yum resolves host names.
-      - C(4) or C(IPv4) - resolve to IPv4 addresses only.
-      - C(6) or C(IPv6) - resolve to IPv6 addresses only.
+      - V(4) or V(IPv4) - resolve to IPv4 addresses only.
+      - V(6) or V(IPv6) - resolve to IPv6 addresses only.
     choices: ['4', '6', IPv4, IPv6, whatever]
     type: str
-    default: whatever
   keepalive:
     description:
       - This tells yum whether or not HTTP/1.1 keepalive should be used with
         this repository. This can improve transfer speeds by using one
         connection when downloading multiple files from a repository.
     type: bool
-    default: 'no'
   keepcache:
     description:
-      - Either C(1) or C(0). Determines whether or not yum keeps the cache of
+      - Either V(1) or V(0). Determines whether or not yum keeps the cache of
         headers and packages after successful installation.
+      - This parameter is deprecated and will be removed in version 2.20.
     choices: ['0', '1']
     type: str
-    default: '1'
   metadata_expire:
     description:
       - Time (in seconds) after which the metadata will expire.
       - Default value is 6 hours.
     type: str
-    default: '21600'
   metadata_expire_filter:
     description:
-      - Filter the I(metadata_expire) time, allowing a trade of speed for
+      - Filter the O(metadata_expire) time, allowing a trade of speed for
         accuracy if a command doesn't require it. Each yum command can specify
         that it requires a certain level of timeliness quality from the remote
         repos. from "I'm about to install/upgrade, so this better be current"
         to "Anything that's available is good enough".
-      - C(never) - Nothing is filtered, always obey I(metadata_expire).
-      - C(read-only:past) - Commands that only care about past information are
-        filtered from metadata expiring. Eg. I(yum history) info (if history
+      - V(never) - Nothing is filtered, always obey O(metadata_expire).
+      - V(read-only:past) - Commands that only care about past information are
+        filtered from metadata expiring. Eg. C(yum history) info (if history
         needs to lookup anything about a previous transaction, then by
         definition the remote package was available in the past).
-      - C(read-only:present) - Commands that are balanced between past and
-        future. Eg. I(yum list yum).
-      - C(read-only:future) - Commands that are likely to result in running
+      - V(read-only:present) - Commands that are balanced between past and
+        future. Eg. C(yum list yum).
+      - V(read-only:future) - Commands that are likely to result in running
         other commands which will require the latest metadata. Eg.
-        I(yum check-update).
+        C(yum check-update).
       - Note that this option does not override "yum clean expire-cache".
     choices: [never, 'read-only:past', 'read-only:present', 'read-only:future']
     type: str
-    default: 'read-only:present'
   metalink:
     description:
       - Specifies a URL to a metalink file for the repomd.xml, a list of
         mirrors for the entire repository are generated by converting the
-        mirrors for the repomd.xml file to a I(baseurl).
-      - This, the I(baseurl) or I(mirrorlist) parameters are required if I(state) is set to
-        C(present).
+        mirrors for the repomd.xml file to a O(baseurl).
+      - This, the O(baseurl) or O(mirrorlist) parameters are required if O(state) is set to
+        V(present).
     type: str
   mirrorlist:
     description:
       - Specifies a URL to a file containing a list of baseurls.
-      - This, the I(baseurl) or I(metalink) parameters are required if I(state) is set to
-        C(present).
+      - This, the O(baseurl) or O(metalink) parameters are required if O(state) is set to
+        V(present).
     type: str
   mirrorlist_expire:
     description:
@@ -227,12 +217,11 @@ options:
         expire.
       - Default value is 6 hours.
     type: str
-    default: '21600'
   name:
     description:
       - Unique repository ID. This option builds the section name of the repository in the repo file.
-      - This parameter is only required if I(state) is set to C(present) or
-        C(absent).
+      - This parameter is only required if O(state) is set to V(present) or
+        V(absent).
     type: str
     required: true
   password:
@@ -245,15 +234,13 @@ options:
         from 1 to 99.
       - This option only works if the YUM Priorities plugin is installed.
     type: str
-    default: '99'
   protect:
     description:
       - Protect packages from updates from other repositories.
     type: bool
-    default: 'no'
   proxy:
     description:
-      - URL to the proxy server that yum should use. Set to C(_none_) to
+      - URL to the proxy server that yum should use. Set to V(_none_) to
         disable the global proxy setting.
     type: str
   proxy_password:
@@ -269,7 +256,6 @@ options:
       - This tells yum whether or not it should perform a GPG signature check
         on the repodata from this repository.
     type: bool
-    default: 'no'
   reposdir:
     description:
       - Directory where the C(.repo) files will be stored.
@@ -278,32 +264,28 @@ options:
   retries:
     description:
       - Set the number of times any attempt to retrieve a file should retry
-        before returning an error. Setting this to C(0) makes yum try forever.
+        before returning an error. Setting this to V(0) makes yum try forever.
     type: str
-    default: '10'
   s3_enabled:
     description:
       - Enables support for S3 repositories.
       - This option only works if the YUM S3 plugin is installed.
     type: bool
-    default: 'no'
   skip_if_unavailable:
     description:
-      - If set to C(true) yum will continue running if this repository cannot be
+      - If set to V(true) yum will continue running if this repository cannot be
         contacted for any reason. This should be set carefully as all repos are
         consulted for any given command.
     type: bool
-    default: 'no'
   ssl_check_cert_permissions:
     description:
       - Whether yum should check the permissions on the paths for the
         certificates on the repository (both remote and local).
       - If we can't read any of the files then yum will force
-        I(skip_if_unavailable) to be C(true). This is most useful for non-root
+        O(skip_if_unavailable) to be V(true). This is most useful for non-root
         processes which use yum on repos that have client cert files which are
         readable only by root.
     type: bool
-    default: 'no'
   sslcacert:
     description:
       - Path to the directory containing the databases of the certificate
@@ -326,7 +308,6 @@ options:
     description:
       - Defines whether yum should verify SSL certificates/hosts at all.
     type: bool
-    default: 'yes'
     aliases: [ validate_certs ]
   state:
     description:
@@ -344,14 +325,12 @@ options:
     description:
       - Number of seconds to wait for a connection before timing out.
     type: str
-    default: '30'
   ui_repoid_vars:
     description:
       - When a repository id is displayed, append these yum variables to the
-        string if they are used in the I(baseurl)/etc. Variables are appended
+        string if they are used in the O(baseurl)/etc. Variables are appended
         in the order listed (and found).
     type: str
-    default: releasever basearch
   username:
     description:
       - Username to use for basic authentication to a repo or really any url.
@@ -375,7 +354,7 @@ notes:
   - The repo file will be automatically deleted if it contains no repository.
   - When removing a repository, beware that the metadata cache may still remain
     on disk until you run C(yum clean all). Use a notification handler for this.
-  - "The C(params) parameter was removed in Ansible 2.5 due to circumventing Ansible's parameter
+  - "The O(ignore:params) parameter was removed in Ansible 2.5 due to circumventing Ansible's parameter
     handling"
 '''
 
@@ -438,7 +417,7 @@ import os
 
 from ansible.module_utils.basic import AnsibleModule
 from ansible.module_utils.six.moves import configparser
-from ansible.module_utils._text import to_native
+from ansible.module_utils.common.text.converters import to_native
 
 
 class YumRepo(object):
@@ -549,6 +528,11 @@ class YumRepo(object):
 
             # Set the value only if it was defined (default is None)
             if value is not None and key in self.allowed_params:
+                if key == 'keepcache':
+                    self.module.deprecate(
+                        "'keepcache' parameter is deprecated.",
+                        version='2.20'
+                    )
                 self.repofile.set(self.section, key, value)
 
     def save(self):
@@ -627,7 +611,6 @@ def main():
         mirrorlist=dict(),
         mirrorlist_expire=dict(),
         name=dict(required=True),
-        params=dict(type='dict'),
         password=dict(no_log=True),
         priority=dict(),
         protect=dict(type='bool'),
@@ -659,11 +642,6 @@ def main():
         supports_check_mode=True,
     )
 
-    # Params was removed
-    # https://meetbot.fedoraproject.org/ansible-meeting/2017-09-28/ansible_dev_meeting.2017-09-28-15.00.log.html
-    if module.params['params']:
-        module.fail_json(msg="The params option to yum_repository was removed in Ansible 2.5 since it circumvents Ansible's option handling")
-
     name = module.params['name']
     state = module.params['state']