aaaChangeSelfPassword
The aaaChangeSelfPassword method changes the user's own password. The user supplies the old password for authentication, the new password, and a confirmation of the new password. If the user is authenticated successfully with the old password, the new password becomes effective.
Note |
Cisco UCS Manager Release 4.1(3a) onwards, users can reset their expired password using "null" in cookie. |
Request Syntax
<xs:element name="aaaChangeSelfPassword" type="aaaChangeSelfPassword"
substitutionGroup="externalMethod"/>
<xs:complexType name="aaaChangeSelfPassword" mixed="true">
<xs:attribute name="inUserName">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:pattern value="[\-\.:_a-zA-Z0-9]{0,16}"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="inOldPassword">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="0"/>
<xs:maxLength value="510"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="inNewPassword">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="0"/>
<xs:maxLength value="510"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="inConfirmNewPassword">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:minLength value="0"/>
<xs:maxLength value="510"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="cookie" type="xs:string"/>
<xs:attribute name="response" type="YesOrNo"/>
</xs:complexType>
Response Syntax
<xs:element name="aaaChangeSelfPassword" type="aaaChangeSelfPassword"
substitutionGroup="externalMethod"/>
<xs:complexType name="aaaChangeSelfPassword" mixed="true">
<xs:attribute name="outStatus">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="success"/>
<xs:enumeration value="failure"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="cookie" type="xs:string"/>
<xs:attribute name="response" type="YesOrNo"/>
<xs:attribute name="errorCode" type="xs:unsignedInt"/>
<xs:attribute name="errorDescr" type="xs:string"/>
<xs:attribute name="invocationResult" type="xs:string"/>
</xs:complexType>
Example 1
Request
<aaaChangeSelfPassword
cookie="<real_cookie>"
inUserName="admin"
inOldPassword="Nbv12345"
inNewPassword="Mbv12345"
inConfirmNewPassword="Mbv12345" />
Response
<aaaChangeSelfPassword
cookie="<real_cookie>"
response="yes"
outStatus="success">
</aaaChangeSelfPassword>
Example 2
The following example shows how to reset the expired password.
Request
<aaaChangeSelfPassword
cookie="null"
inUserName="admin"
inOldPassword="Nbv12345"
inNewPassword="Mbv12345"
inConfirmNewPassword="Mbv12345" />
Response
<aaaChangeSelfPassword
cookie="<real_cookie>"
response="yes"
outStatus="success">
</aaaChangeSelfPassword>