Clarify docs/examples of attribute removal (#35872)
If values="somestring" is specified then this module normalizes it to ["somestring"]. This means that passing name="foo", values="", state=exact results in the ldap entry having a single attribute called foo="". To delete all attributes "foo", regardless of their values, it is necessary to pass name="foo", values=[], state="exact".
This commit is contained in:
parent
149aa767ff
commit
490c7e7b35
1 changed files with 3 additions and 3 deletions
|
@ -54,7 +54,7 @@ options:
|
||||||
values will be added if they're missing. If C(absent), all given
|
values will be added if they're missing. If C(absent), all given
|
||||||
values will be removed if present. If C(exact), the set of values
|
values will be removed if present. If C(exact), the set of values
|
||||||
will be forced to exactly those provided and no others. If
|
will be forced to exactly those provided and no others. If
|
||||||
I(state=exact) and I(value) is empty, all values for this
|
I(state=exact) and I(value) is an empty list, all values for this
|
||||||
attribute will be removed.
|
attribute will be removed.
|
||||||
choices: [present, absent, exact]
|
choices: [present, absent, exact]
|
||||||
default: present
|
default: present
|
||||||
|
@ -117,7 +117,7 @@ EXAMPLES = """
|
||||||
ldap_attr:
|
ldap_attr:
|
||||||
dn: uid=jdoe,ou=people,dc=example,dc=com
|
dn: uid=jdoe,ou=people,dc=example,dc=com
|
||||||
name: shadowExpire
|
name: shadowExpire
|
||||||
values: ""
|
values: []
|
||||||
state: exact
|
state: exact
|
||||||
server_uri: ldap://localhost/
|
server_uri: ldap://localhost/
|
||||||
bind_dn: cn=admin,dc=example,dc=com
|
bind_dn: cn=admin,dc=example,dc=com
|
||||||
|
@ -135,7 +135,7 @@ EXAMPLES = """
|
||||||
ldap_attr:
|
ldap_attr:
|
||||||
dn: uid=jdoe,ou=people,dc=example,dc=com
|
dn: uid=jdoe,ou=people,dc=example,dc=com
|
||||||
name: shadowExpire
|
name: shadowExpire
|
||||||
values: ""
|
values: []
|
||||||
state: exact
|
state: exact
|
||||||
params: "{{ ldap_auth }}"
|
params: "{{ ldap_auth }}"
|
||||||
"""
|
"""
|
||||||
|
|
Loading…
Reference in a new issue