# salt.states.keystone_role

## Management of OpenStack Keystone Roles

Added in version 2018.3.0.

depends:

  shade

configuration:

  see `salt.modules.keystoneng` for setup instructions

Example States

    create role:
      keystone_role.present:
        - name: role1

    delete role:
      keystone_role.absent:
        - name: role1

    create role with optional params:
      keystone_role.present:
        - name: role1
        - description: 'my group'

salt.states.keystone_role.absent(name, auth=None, **kwargs)

  Ensure role does not exist

  name

    Name of the role

salt.states.keystone_role.present(name, auth=None, **kwargs)

  Ensure an role exists

  name

    Name of the role

  description

    An arbitrary description of the role