setPassword

将特定用户或默认用户的密码设置为特定值,具体取决于您是否指定了用户句柄。

密码过期日期是可选的。 如果忽略,则密码永不过期。

授权用户类型

注意

** 仅授权 IpsAdmin 用户类型对其他用户运行setPassword调用。

  • IpsAdmin
  • IpsCompanyAdmin
  • IpsUser
  • TrialSiteAdmin
  • TrialSiteUser
  • ImagePortalAdmin
  • ImagePortalContrib
  • ImagePortalContribUser
  • ImagePortalUser

参数

输入(setPasswordParam)

名称

类型

必需

说明

userHandle

xsd:string

用户句柄。

密码

xsd:string

密码.

对所选密码强制执行以下要求:

  • 密码区分大小写。
  • 最小密码长度为8个字符。
  • 密码必须包含以下字符类中的一个或多个字符:
    • 小写英语字符。 例如, a b c d e
    • 大写字母英语字符。 例如, A B C D E 等。
    • 数量. 例如, 1 2 3 4 5 等。
    • 特殊符号字符。 例如,您可以使用以下任一选项: `~ !@ # $ % ^ *(_ + - = { }) | [ ] & \ :" ;' < > ?, /

passwordExpires

xsd:dateTime

确定密码过期日期。

注意: 为时区提供对此字段的请求。 时区将调整为“中央时间”。

输出(setPasswordReturn)

IPS API不会返回此操作的响应。

示例

此代码示例创建用户密码。 密码永不过期,因为passwordExpires被忽略。

请求

<ns1:setPasswordParam xmlns:ns1="http://www.scene7.com/IpsApi/xsd">  
   <ns1:userHandle>3341|juser@scene7.com</ns1:userHandle> 
   <ns1:password>@Do6e$ySt3mz</ns1:password> 
</ns1:setPasswordParam>

响应

无。

在此页面上