cisco.ise.sponsor_group 模块 – 赞助商组资源模块
注意
此模块是 cisco.ise 集合 (版本 2.9.6) 的一部分。
如果您使用的是 ansible
包,则可能已经安装了此集合。它不包含在 ansible-core
中。要检查它是否已安装,请运行 ansible-galaxy collection list
。
要安装它,请使用:ansible-galaxy collection install cisco.ise
。您需要其他需求才能使用此模块,请参阅 需求 以了解详细信息。
要在剧本中使用它,请指定:cisco.ise.sponsor_group
。
cisco.ise 1.0.0 中的新增功能
概要
管理资源赞助商组的创建、更新和删除操作。
此 API 创建一个赞助商组。
此 API 通过 ID 删除赞助商组。
此 API 允许客户端通过 ID 更新赞助商组。
注意
此模块具有相应的 动作插件。
需求
以下需求是在执行此模块的主机上需要的。
ciscoisesdk >= 2.2.3
python >= 3.5
参数
参数 |
注释 |
---|---|
自动通知标志。 选项
|
|
赞助商组的 createPermissions。 |
|
CanCreateRandomAccounts 标志。 选项
|
|
CanImportMultipleAccounts 标志。 选项
|
|
CanSetFutureStartDate 标志。 选项
|
|
CanSpecifyUsernamePrefix 标志。 选项
|
|
赞助商组的 defaultUsernamePrefix。 |
|
赞助商组的 importBatchSizeLimit。 |
|
赞助商组的 randomBatchSizeLimit。 |
|
赞助商组的 startDateFutureLimitDays。 |
|
赞助商组的描述。 |
|
赞助商组的 guestTypes。 |
|
赞助商组的 ID。 |
|
IsDefaultGroup 标志。 选项
|
|
用于身份服务引擎 SDK 的标志,用于启用调试。 选项
|
|
身份服务引擎主机名。 |
|
用于身份验证的身份服务引擎密码。 |
|
RESTful HTTP 请求的超时(以秒为单位)。 默认: |
|
用于身份验证的身份服务引擎用户名。 |
|
通知 SDK 我们是否将 CSRF 令牌发送到 ISE 的 ERS API 的标志。 如果为 True,则 SDK 假设您的 ISE CSRF 检查已启用。 如果为 True,则假定您需要 SDK 为您自动管理 CSRF 令牌。 选项
|
|
启用或禁用 SSL 证书验证的标志。 选项
|
|
通知 SDK 使用哪个版本的 Identity Services Engine。 默认: |
|
用于身份服务引擎 SDK 的标志,用于启用自动速率限制处理。 选项
|
|
IsEnabled 标志。 选项
|
|
赞助商组的 locations。 |
|
赞助商组的 managePermission。 |
|
赞助商组的 memberGroups。 |
|
赞助商组的名称。 |
|
赞助商组的 otherPermissions。 |
|
CanAccessViaREST 标志。 选项
|
|
CanApproveSelfregGuests 标志。 选项
|
|
CanDeleteGuestAccounts 标志。 选项
|
|
CanExtendGuestAccounts 标志。 选项
|
|
CanReinstateSuspendedAccounts 标志。 选项
|
|
CanResetGuestPasswords 标志。 选项
|
|
CanSendSMSNotifications 标志。 选项
|
|
CanSuspendGuestAccounts 标志。 选项
|
|
CanUpdateGuestContactInfo 标志。 选项
|
|
CanViewGuestPasswords 标志。 选项
|
|
LimitApprovalToSponsorsGuests 标志。 选项
|
|
RequireSuspensionReason 标志。 选项
|
备注
注意
使用的SDK方法包括:sponsor_group.SponsorGroup.create_sponsor_group、sponsor_group.SponsorGroup.delete_sponsor_group_by_id、sponsor_group.SponsorGroup.update_sponsor_group_by_id。
使用的路径包括:post /ers/config/sponsorgroup、delete /ers/config/sponsorgroup/{id}、put /ers/config/sponsorgroup/{id}。
不支持
check_mode
该插件在控制节点上运行,不使用任何Ansible连接插件,而是使用Cisco ISE SDK中的嵌入式连接管理器。
以`ise_`开头的参数由Cisco ISE Python SDK用于建立连接。
示例
- 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: true
createPermissions:
canCreateRandomAccounts: true
canImportMultipleAccounts: true
canSetFutureStartDate: true
canSpecifyUsernamePrefix: true
defaultUsernamePrefix: string
importBatchSizeLimit: 0
randomBatchSizeLimit: 0
startDateFutureLimitDays: 0
description: string
guestTypes:
- string
id: string
isDefaultGroup: true
isEnabled: true
locations:
- string
managePermission: string
memberGroups:
- string
name: string
otherPermissions:
canAccessViaRest: true
canApproveSelfregGuests: true
canDeleteGuestAccounts: true
canExtendGuestAccounts: true
canReinstateSuspendedAccounts: true
canResetGuestPasswords: true
canSendSmsNotifications: true
canSuspendGuestAccounts: true
canUpdateGuestContactInfo: true
canViewGuestPasswords: true
limitApprovalToSponsorsGuests: true
requireSuspensionReason: true
- 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
- 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: true
createPermissions:
canCreateRandomAccounts: true
canImportMultipleAccounts: true
canSetFutureStartDate: true
canSpecifyUsernamePrefix: true
defaultUsernamePrefix: string
importBatchSizeLimit: 0
randomBatchSizeLimit: 0
startDateFutureLimitDays: 0
description: string
guestTypes:
- string
isDefaultGroup: true
isEnabled: true
locations:
- string
managePermission: string
memberGroups:
- string
name: string
otherPermissions:
canAccessViaRest: true
canApproveSelfregGuests: true
canDeleteGuestAccounts: true
canExtendGuestAccounts: true
canReinstateSuspendedAccounts: true
canResetGuestPasswords: true
canSendSmsNotifications: true
canSuspendGuestAccounts: true
canUpdateGuestContactInfo: true
canViewGuestPasswords: true
limitApprovalToSponsorsGuests: true
requireSuspensionReason: true
返回值
常见的返回值已在此处记录,以下是此模块独有的字段:
键 |
描述 |
---|---|
包含Cisco ISE Python SDK返回的响应的字典或列表。 返回值:始终返回 示例: |
|
包含Cisco ISE Python SDK返回的响应的字典或列表。 返回值:始终返回 示例: |