Vmware Local Role Manager

4 min

Parâmetros

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
action	string	add remove set	Esse parâmetro é válido somente enquanto estiiver fazendo um update de uma role existente com privilegios. ADDirá adicionar um privilegio para uma lista existente. REMOVE irá remover um privilegio pde uma lista existente. SET will irá substituir um privilegio por um privilegio existente com um usuário definido por uma lista de privilegios.
force_remove	boolean	no yes	Se definido como FALSE previne que uma role seja removida se algume permissão está usando-a.
local_privilege_ids	list / elements=string	[]	Lista de privilegio que uma role precisa ter. Por favor veja em: https://docs.vmware.com/en/VMware-vSphere/6.0/com.vmware.vsphere.security.doc/GUID-ED56F3C4-77D0-49E3-88B6-B99B8B437B62.html
local_role_name	string		Nome da role local a ser gerenciada
state	string	present absent	Indica o estado desejado da role. Se a role já existir quando o STATE=PRESENT, a info da role sofrerá um update.

Notas

Observação

Testado em ESXi 7.0.2
Todos os módulos requerem acesso de gravação API e, portanto, não são suportados em uma licença ESXi gratuita.

Exemplos

- name: Add local role to ESXi
  community.vmware.vmware_local_role_manager:
    hostname: '{{ esxi_hostname }}'
    username: '{{ esxi_username }}'
    password: '{{ esxi_password }}'
    local_role_name: vmware_qa
    state: present
  delegate_to: localhost

- name: Add local role with privileges to ESXi
  community.vmware.vmware_local_role_manager:
    hostname: '{{ esxi_hostname }}'
    username: '{{ esxi_username }}'
    password: '{{ esxi_password }}'
    local_role_name: vmware_qa
    local_privilege_ids: [ 'Folder.Create', 'Folder.Delete']
    state: present
  delegate_to: localhost

- name: Remove local role from ESXi
  community.vmware.vmware_local_role_manager:
    hostname: '{{ esxi_hostname }}'
    username: '{{ esxi_username }}'
    password: '{{ esxi_password }}'
    local_role_name: vmware_qa
    state: absent
  delegate_to: localhost

- name: Add a privilege to an existing local role
  community.vmware.vmware_local_role_manager:
    hostname: '{{ esxi_hostname }}'
    username: '{{ esxi_username }}'
    password: '{{ esxi_password }}'
    local_role_name: vmware_qa
    local_privilege_ids: [ 'Folder.Create' ]
    action: add
  delegate_to: localhost

- name: Remove a privilege to an existing local role
  community.vmware.vmware_local_role_manager:
    hostname: '{{ esxi_hostname }}'
    username: '{{ esxi_username }}'
    password: '{{ esxi_password }}'
    local_role_name: vmware_qa
    local_privilege_ids: [ 'Folder.Create' ]
    action: remove
  delegate_to: localhost

- name: Set a privilege to an existing local role
  community.vmware.vmware_local_role_manager:
    hostname: '{{ esxi_hostname }}'
    username: '{{ esxi_username }}'
    password: '{{ esxi_password }}'
    local_role_name: vmware_qa
    local_privilege_ids: [ 'Folder.Create' ]
    action: set
  delegate_to: localhost

Valores Retornados

Chave	Tipo	Retornado quando	Descrição
local_role_name	string	sempre	Nome do role local
new_privileges	list / elements=string	sempre	Lista de privilegios
old_privileges	list / elements=string	no update	Lista de privilegios antes do update
privileges	list / elements=string	sempre	Lista de privilegios
privileges_previous	list / elements=string	no update	Lista de privilegios antes do update
role_id	integer	sempre	ESXi gerado pelo id do role local
role_name	string	sempre	Nome do role local