cisco.ise.sponsor_group – Resource module for Sponsor Group

Note

This plugin is part of the cisco.ise collection (version 0.0.9).

To install it use: ansible-galaxy collection install cisco.ise.

To use it in a playbook, specify: cisco.ise.sponsor_group.

New in version 1.0.0: of cisco.ise

Synopsis

• Manage operations create, update and delete of the resource Sponsor Group.

Note

This module has a corresponding action plugin.

Requirements

The below requirements are needed on the host that executes this module.

• ciscoisesdk

Parameters

Parameter		Choices/Defaults	Comments
autoNotification boolean		Choices: no yes	AutoNotification flag.
createPermissions dictionary			Sponsor Group's createPermissions.
	canCreateRandomAccounts boolean	Choices: no yes	CanCreateRandomAccounts flag.
	canImportMultipleAccounts boolean	Choices: no yes	CanImportMultipleAccounts flag.
	canSetFutureStartDate boolean	Choices: no yes	CanSetFutureStartDate flag.
	canSpecifyUsernamePrefix boolean	Choices: no yes	CanSpecifyUsernamePrefix flag.
	defaultUsernamePrefix string		Sponsor Group's defaultUsernamePrefix.
	importBatchSizeLimit integer		Sponsor Group's importBatchSizeLimit.
	randomBatchSizeLimit integer		Sponsor Group's randomBatchSizeLimit.
	startDateFutureLimitDays integer		Sponsor Group's startDateFutureLimitDays.
description string			Sponsor Group's description.
guestTypes list / elements=string			Sponsor Group's guestTypes.
id string			Sponsor Group's id.
isDefaultGroup boolean		Choices: no yes	IsDefaultGroup flag.
isEnabled boolean		Choices: no yes	IsEnabled flag.
locations list / elements=string			Sponsor Group's locations.
managePermission string			Sponsor Group's managePermission.
memberGroups list / elements=string			Sponsor Group's memberGroups.
name string			Sponsor Group's name.
otherPermissions dictionary			Sponsor Group's otherPermissions.
	canAccessViaRest boolean	Choices: no yes	CanAccessViaRest flag.
	canApproveSelfregGuests boolean	Choices: no yes	CanApproveSelfregGuests flag.
	canDeleteGuestAccounts boolean	Choices: no yes	CanDeleteGuestAccounts flag.
	canExtendGuestAccounts boolean	Choices: no yes	CanExtendGuestAccounts flag.
	canReinstateSuspendedAccounts boolean	Choices: no yes	CanReinstateSuspendedAccounts flag.
	canResetGuestPasswords boolean	Choices: no yes	CanResetGuestPasswords flag.
	canSendSmsNotifications boolean	Choices: no yes	CanSendSmsNotifications flag.
	canSuspendGuestAccounts boolean	Choices: no yes	CanSuspendGuestAccounts flag.
	canUpdateGuestContactInfo boolean	Choices: no yes	CanUpdateGuestContactInfo flag.
	canViewGuestPasswords boolean	Choices: no yes	CanViewGuestPasswords flag.
	limitApprovalToSponsorsGuests boolean	Choices: no yes	LimitApprovalToSponsorsGuests flag.
	requireSuspensionReason boolean	Choices: no yes	RequireSuspensionReason flag.

See Also

See also

cisco.ise.plugins.module_utils.definitions.sponsor_group

The official documentation on the cisco.ise.plugins.module_utils.definitions.sponsor_group module.

Sponsor Group reference

Complete reference of the Sponsor Group object model.

Examples

- name: Create
  cisco.ise.sponsor_group:
    ise_hostname: "{{ise_hostname}}"
    ise_username: "{{ise_username}}"
    ise_password: "{{ise_password}}"
    ise_verify: "{{ise_verify}}"
    state: present
    autoNotification: false
    createPermissions:
      canCreateRandomAccounts: true
      canImportMultipleAccounts: true
      canSetFutureStartDate: false
      canSpecifyUsernamePrefix: false
      defaultUsernamePrefix: ''
      importBatchSizeLimit: 20
      randomBatchSizeLimit: 30
      startDateFutureLimitDays: 10
    description: description
    guestTypes:
    - Contractor (default)
    - Daily (default)
    - Weekly (default)
    id: id
    isDefaultGroup: false
    isEnabled: true
    locations:
    - San Jose
    managePermission: ALLACCOUNTS
    memberGroups:
    - ALL_ACCOUNTS (default)
    name: name
    otherPermissions:
      canAccessViaRest: false
      canApproveSelfregGuests: false
      canDeleteGuestAccounts: false
      canExtendGuestAccounts: false
      canReinstateSuspendedAccounts: false
      canResetGuestPasswords: false
      canSendSmsNotifications: false
      canSuspendGuestAccounts: false
      canUpdateGuestContactInfo: false
      canViewGuestPasswords: false
      limitApprovalToSponsorsGuests: false
      requireSuspensionReason: false

- name: Update by id
  cisco.ise.sponsor_group:
    ise_hostname: "{{ise_hostname}}"
    ise_username: "{{ise_username}}"
    ise_password: "{{ise_password}}"
    ise_verify: "{{ise_verify}}"
    state: present
    autoNotification: false
    createPermissions:
      canCreateRandomAccounts: true
      canImportMultipleAccounts: true
      canSetFutureStartDate: false
      canSpecifyUsernamePrefix: false
      defaultUsernamePrefix: ''
      importBatchSizeLimit: 20
      randomBatchSizeLimit: 30
      startDateFutureLimitDays: 10
    description: description
    guestTypes:
    - Contractor (default)
    - Daily (default)
    - Weekly (default)
    id: id
    isDefaultGroup: false
    isEnabled: true
    locations:
    - San Jose
    managePermission: ALLACCOUNTS
    memberGroups:
    - ALL_ACCOUNTS (default)
    name: name
    otherPermissions:
      canAccessViaRest: false
      canApproveSelfregGuests: false
      canDeleteGuestAccounts: false
      canExtendGuestAccounts: false
      canReinstateSuspendedAccounts: false
      canResetGuestPasswords: false
      canSendSmsNotifications: false
      canSuspendGuestAccounts: false
      canUpdateGuestContactInfo: false
      canViewGuestPasswords: false
      limitApprovalToSponsorsGuests: false
      requireSuspensionReason: false

- name: Delete by id
  cisco.ise.sponsor_group:
    ise_hostname: "{{ise_hostname}}"
    ise_username: "{{ise_username}}"
    ise_password: "{{ise_password}}"
    ise_verify: "{{ise_verify}}"
    state: absent
    id: string

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key	Returned	Description
ise_response dictionary	always	A dictionary or list with the response returned by the Cisco ISE Python SDK Sample: {}

Authors

• Rafael Campos (@racampos)